@spec convert_media_types(Regc.Mutate.Image.t(), :oci | :docker, keyword()) ::
  {:ok, Regc.Mutate.Image.t()} | {:error, Regc.Error.t()}

Converts OCI image/index descriptor media types to Docker schema 2, or the reverse.

Docker schema 2 cannot represent OCI subjects, artifact types, annotations, inline descriptor data, or artifact manifests. OCI-only fields therefore cause a :lossy_conversion error unless allow_lossy: true is supplied. Artifact manifests are never converted to Docker.

Converting an index also requires a :child_descriptors map keyed by each source child digest whose media type changes. Values may be finalized mutation results, mutation states, descriptors, or descriptor maps. This prevents relabeling a child while retaining a digest for different bytes.

@spec delete_annotation(Regc.Mutate.Image.t(), String.t()) ::
  {:ok, Regc.Mutate.Image.t()} | {:error, Regc.Error.t()}

Removes an OCI annotation.

@spec put_annotation(Regc.Mutate.Image.t(), String.t(), String.t() | nil) ::
  {:ok, Regc.Mutate.Image.t()} | {:error, Regc.Error.t()}

Sets an OCI annotation. A nil value removes the annotation.

@spec put_base(Regc.Mutate.Image.t(), String.t(), String.t()) ::
  {:ok, Regc.Mutate.Image.t()} | {:error, Regc.Error.t()}

Records the OCI base-image name and digest annotations used by rebasing.