codec

type Codec interface {
	// Name is the codec's short name, "yaml" or "json".
	Name() string
	// Extension is the file extension a vault uses for this codec's
	// files, with the dot: ".yaml".
	Extension() string
	// Decode parses text into the generic document a schema validates.
	Decode(text []byte) (map[string]any, error)
	// DecodeAll parses a text that may hold several manifests (YAML's
	// "---"), each with its own bytes; a syntax with no such notion
	// returns one. An empty document is skipped, not reported.
	DecodeAll(text []byte) ([]Document, error)
	// DecodeInto parses text into a typed value. Field names follow the
	// value's `yaml` tags, which every typed view in the engine carries;
	// an adapter for another syntax maps its names onto those.
	DecodeInto(text []byte, v any) error
	// Encode writes a document, or a typed value, as canonical text: the
	// form a vault file is saved in, stable across runs.
	Encode(v any) ([]byte, error)
}

type Document struct {
	Doc  map[string]any
	Text []byte
}