editor

type Diff struct {
	Added   []string `json:"added"`
	Removed []string `json:"removed"`
}

type FieldValue struct {
	V    string `json:"v"`
	Lang string `json:"lang,omitempty"`
	// Datatype preserves a literal's explicit datatype IRI.
	Datatype string `json:"datatype,omitempty"`
	// IRI marks an entity-valued field (V is the IRI).
	IRI bool `json:"iri,omitempty"`
	// Prov is the named graph the value came from ("feed:overdrive",
	// "editorial:", "enrichment:locsh").
	Prov string `json:"prov"`
	// Overridden marks feed values shadowed by an lcat:overrides marker
	//.
	Overridden bool `json:"overridden,omitempty"`
	// Annotation is the field's display-only qualifier resolved from the
	// value's structure node (e.g. a heading's bf:source label, a
	// contribution's bf:role label). Its quads stay in passthrough; ToGrain
	// ignores it.
	Annotation string `json:"annotation,omitempty"`
	// Primary marks a chained value whose structure head is typed
	// bflc:PrimaryContribution -- the author sorts before the
	// narrator. Display-only; ToGrain ignores it.
	Primary bool `json:"primary,omitempty"`
	// Node is the value's subject term in N-Quads syntax -- the resource
	// node for direct fields, the intermediate node for chained fields.
	// Reconstruction metadata; clients treat it as opaque.
	Node string `json:"node"`
}

type LabelResolver func(iri string) (scheme string, labels map[string]string, ok bool)

type Mapper struct {
	// WorkProfile shapes the Work fields; InstanceProfile the Instances'.
	WorkProfile     *profiles.Profile
	InstanceProfile *profiles.Profile
}

type Op struct {
	// Resource is "work", an Instance id, or ResourceItems.
	Resource string `json:"resource"`
	// Path names the profile field, or an item field for ResourceItems.
	Path string `json:"path"`
	// Action: "add" one value, "remove" one matching value, "set" the whole
	// value set, "clear" every value.
	Action string    `json:"action"`
	Value  *OpValue  `json:"value,omitempty"`  // add / remove
	Values []OpValue `json:"values,omitempty"` // set
	// Where guards a ResourceItems op: only items whose current value at Path
	// is exactly this string are edited. Meaningless on the other resources.
	Where *string `json:"where,omitempty"`
}

type OpValue struct {
	V    string `json:"v"`
	Lang string `json:"lang,omitempty"`
	IRI  bool   `json:"iri,omitempty"`
}

type Patch struct {
	Add    []Statement `json:"add,omitempty"`
	Remove []Statement `json:"remove,omitempty"`
}

type ResourceDoc struct {
	ID     string                  `json:"id"`
	Fields map[string][]FieldValue `json:"fields"`
}

type Statement struct {
	S string `json:"s"`
	P string `json:"p"`
	O Term   `json:"o"`
}

type Term struct {
	// Kind is "iri" or "literal".
	Kind  string `json:"kind"`
	Value string `json:"value"`
	Lang  string `json:"lang,omitempty"`
	// Datatype is the literal datatype IRI, when not a plain/lang string.
	Datatype string `json:"datatype,omitempty"`
}

type WorkDoc struct {
	WorkID string `json:"workId"`
	// ProfileID shapes the Work fields; InstanceProfileID the Instances' --
	// exposed so the editor can drive each form from the deployment's profile
	// rather than a hardcoded field list. Empty when no
	// instance profile is configured.
	ProfileID         string        `json:"profileId"`
	InstanceProfileID string        `json:"instanceProfileId,omitempty"`
	Work              ResourceDoc   `json:"work"`
	Instances         []ResourceDoc `json:"instances"`
	// Passthrough holds the unclaimed statements as raw N-Quads lines.
	Passthrough []string `json:"passthrough"`
}