xmp

type AgentName struct {
	V string
	Q
}

type AlternativeArray[E Value] struct {
	V []E
	Q
}

type Basic struct {

	// CreateDate is the date and time the resource was originally created.
	CreateDate Date

	// CreatorTool is the name of the first known tool used to create the
	// resource.
	CreatorTool AgentName

	// Identifier is an unambiguous reference to the resource within a given
	// context.  An array item may be qualified with xmpidq:Scheme to specify
	// the identification system for that item.
	Identifier UnorderedArray[Text]

	// Label is a word or short phrase that identifies a resource within a
	// local context.
	Label Text

	// MetadataDate is the date and time that any metadata for this resource was
	// last modified.
	MetadataDate Date

	// ModifyDate is the date and time the resource was last modified.
	ModifyDate Date

	// Rating is a user-assigned rating for this resource.
	//
	// The value must be -1 (rejected), 0 (unrated) or a rating in the range
	// (0, 5].
	Rating Real
	// contains filtered or unexported fields
}

type Date struct {
	V time.Time

	// NumOmitted can be used to reduce the precision of the date
	// when serializing it to XMP.  The value is a number between 0 and 5:
	// 1=omit nano, 2=omit sec, 3=omit time, 4=omit day, 5=month.
	NumOmitted int

	Q
}

type DublinCore struct {

	// Contributor is a list of contributors to the resource.
	// This should not include names listed in the Creator field.
	Contributor UnorderedArray[ProperName] `xmp:"contributor"`

	// Coverage is the extent or scope of the resource.
	Coverage Text `xmp:"coverage"`

	// Creator is a list of the creators of the resource.  Entities should be
	// listed in order of decreasing precedence, if such order is significant.
	Creator OrderedArray[ProperName] `xmp:"creator"`

	// Date is a point or period of time associated with an event in the life
	// cycle of the resource.
	Date OrderedArray[Date] `xmp:"date"`

	// Description is a textual description of the content of the resource.
	Description Localized `xmp:"description"`

	// Format is the media type of the resource.
	Format MimeType `xmp:"format"`

	// Identifier is an unambiguous reference for the resource.
	Identifier Text `xmp:"identifier"`

	// Language is a list of languages used in the content of the resource.
	Language UnorderedArray[Locale] `xmp:"language"`

	// Publisher is a list of publishers of the resource.
	Publisher UnorderedArray[ProperName] `xmp:"publisher"`

	// Relation is a list of related resources.
	Relation UnorderedArray[Text] `xmp:"relation"`

	// Rights is an informal rights statement for the resource.
	Rights Localized `xmp:"rights"`

	// Source is a reference to a resource from which the present resource is
	// derived, either in whole or in part.
	Source Text `xmp:"source"`

	// Subject is a list of descriptive phrases or keywords that specify the
	// content of the resource.
	Subject UnorderedArray[Text] `xmp:"subject"`

	// Title is the title or name of the resource.
	Title Localized `xmp:"title"`

	// Type is the nature or genre of the resource.
	Type UnorderedArray[Text] `xmp:"type"`
	// contains filtered or unexported fields
}

type GUID struct {
	V string
	Q
}

type Locale struct {
	V language.Tag
	Q
}

type Localized struct {
	V map[language.Tag]Text

	// Default (optional) is the default value for the property.
	// If Value is non-empty, the text contents of Default must coincide with
	// the text contents of one of the values in the map.
	Default Text

	Q
}

type MediaManagement struct {

	// DerivedFrom is a reference to a resource from which the present resource
	// is derived, either in whole or in part.  Missing fields are assumed to
	// be unchanged from the source.
	DerivedFrom ResourceRef

	// DocumentID is a unique identifier for the document.
	DocumentID Text

	// InstanceID is a unique identifier for the document instance.
	InstanceID Text

	// OriginalDocumentID is a unique identifier for the original document.
	OriginalDocumentID Text

	// RenditionClass is a rendition class name for this resource.
	RenditionClass Text

	// RenditionParams can be used to provide additional rendition parameters
	RenditionParams Text
	// contains filtered or unexported fields
}

type MimeType struct {
	V     string
	Param map[string]string
	Q
}

type Namespace struct{}

type OptionalBool struct {
	V int // 0 = unset, 1 = false, 2 = true
	Q
}

type OrderedArray[E Value] struct {
	V []E
	Q
}

type Packet struct {
	// Properties represents the properties stored in the XMP packet.
	// The key consists of the namespace and the property name,
	// the value is the low-level representation of the property.
	// Use the GetValue function to access values with known types.
	Properties map[xml.Name]Raw

	// About (optional) is the URL of the resource described by the XMP packet.
	About *url.URL
	// contains filtered or unexported fields
}

type PacketOptions struct {
	Pretty bool
}

type Prefix struct{}

type ProperName struct {
	V string
	Q
}

type Q []Qualifier

type Qualifier struct {
	Name  xml.Name
	Value Raw
}

type Raw interface {
	// contains filtered or unexported methods
}

type RawArray struct {
	Value []Raw
	Kind  RawArrayType
	Q
}

type RawArrayType int

type RawStruct struct {
	Value map[xml.Name]Raw
	Q
}

type Real struct {
	V float64
	Q
}

type RenditionClass struct {
	V string
	Q
}

type ResourceRef struct {
	// DocumentID is the document ID of the referenced resource,
	// as found in the xmpMM:DocumentID field.
	DocumentID GUID

	// FilePath is the file path or URL of the referenced resource.
	FilePath URL

	// InstanceID is the instance ID of the referenced resource,
	// as found in the xmpMM:InstanceID field.
	InstanceID GUID

	RenditionClass RenditionClass

	RenditionParams Text

	Q
}

type RightsManagement struct {

	// Certificate is a reference to a digital certificate that can be used to
	// verify the rights management information.
	//
	// For historical reasons, this field has type Text instead of URL.
	Certificate Text

	// Marked is true if the document has been marked as copyrighted.
	Marked OptionalBool

	// Owner is a list of legal owners of the resource.
	Owner UnorderedArray[ProperName]

	// UsageTerms is a statement that specifies the terms and conditions under
	// which the document can be used.
	UsageTerms Localized

	// WebStatement is a URL that can be used to access a rights management
	// information statement.
	//
	// For historical reasons, this field has type Text instead of URL.
	WebStatement Text
	// contains filtered or unexported fields
}

type Text struct {
	V string
	Q
}

type URL struct {
	V *url.URL
	Q
}

type UnorderedArray[E Value] struct {
	V []E
	Q
}

type Value interface {
	// IsZero returns true if the value is the zero value of its type, and
	// if the value has no qualifiers.
	IsZero() bool

	// EncodeXMP returns the low-lecel XMP representation of a value.
	EncodeXMP(*Packet) Raw

	// DecodeAnother converts a low-level XMP representation into a [Value].
	// The resulting Value must have the same concrete type as the receiver.
	// The receiver is not used otherwise.  If the input is not a valid
	// representation of the concrete type, the error ErrInvalid is returned.
	DecodeAnother(Raw) (Value, error)
}