Converts finite historical AST input once; callers retain originals and the identity mapping.

Imports finite historical XML once and records exact identity attribute changes for the existing CRDT owner.

Finite saved publication conversion; optional source must be the same immutable released body.

Imports finite historical source using the same grammar and identity migration. Originals remain caller-owned evidence.

Normalize authored semantics while preserving all block/option IDs and envelope metadata.

Imports CommonMark/directives or the exact relaymark-ast source declaration.

@spec parse_entity_reference_source(binary()) :: {:ok, map()} | :error

Parses the bounded authored source of an canonical EntityRef atom.

Derives readable Markdown and safe static HTML through one strict preparation.

Projects readable Markdown; this projection is never a second writable body.

@spec project_manifest(map(), [map()]) :: map()

Projects a canonical RelayMark document map into its portable manifest.

Hosts should use this function instead of maintaining a parallel manifest projector so newly added portable directives remain consistent everywhere.

Renders authored semantics; host hydration and authorization remain outside.

Writes exact source interchange, retaining identities and authored metadata.

@spec validate_document(map(), map()) :: :ok | {:error, [RelayMark.Diagnostic.t()]}

Validates a canonical, JSON-keyed RelayMark document map.

Structural validation is compiled from the canonical JSON Schema 2020-12 document schema. Semantic validation applies the same directive, evidence, lifecycle, comparison, and identity rules as the reference runtime.

@spec validate_document!(map(), map()) :: map()

Validates and returns a canonical RelayMark document, raising on failure.

@spec validate_manifest(term()) :: :ok | {:error, [RelayMark.Diagnostic.t()]}

Validates a canonical, JSON-keyed RelayMark projection manifest map.

Structural validation is compiled from the canonical JSON Schema 2020-12 manifest and diagnostic schemas bundled in the package.

@spec validate_transported_agent_answer_pair(binary(), binary(), map()) ::
  {:ok, RelayMark.AgentAnswer.validated_pair()}
  | {:error, [RelayMark.Diagnostic.t()]}

Validates one exact transported Agent Answer document/manifest JSON pair.

Success returns decoded value models plus SHA-256 digests of the exact input bytes. Any semantic or canonical projection mismatch is rejected.