Module resolver 

NAP Resolver — URI → Manifest, with query and version selectors.

The resolver is the primary interface for reading NAP resources. It handles:

• Full manifest resolution: nap://toystory/character/woody
• Fragment queries: nap://toystory/character/woody#references.appears_in
• Version selectors: branch, commit
• Subtree extraction for efficient AI/application access

Version and branch are NEVER in the URI. They are orthogonal selectors:

URI + Reference + Revision Selector

Structs

HydratedProvenanceBlob

Hydrated readable provenance artifact.

PresignOptions

Options for creating a bearer URL for a committed representation.

PresignedRepresentation

A time-limited public URL for one immutable representation.

ResolveConfig

Resolver configuration — set at construction time.

ResolveEnvelope

Envelope returned when ResolveOptions::provenance is enabled.

ResolveOptions

Options for resolving a NAP URI. All are optional — omitting all causes the resolver to use its ResolveConfig::default_branch (if configured) or fail with NapError::NoDefaultBranch.

ResolveProvenanceEnvelope

Per-resolution provenance metadata.

ResolveProvenanceFile

Provenance for one file participating in an entity resolution.

Resolver

The NAP resolver — resolves URIs to manifests or subtrees.

Enums

ResolveResult

The result of resolving a NAP URI.

ResolveSource

Where repository-backed reads are performed.