DocumentLocationNEW

DocumentLocation = Readonly<{ documentDigest: string; pointer: string; range?: Readonly<{ begin: number; end: number; }>; }>

A portable location in a saved document.

Locations identify the persisted document model with a SHA-256 digest, and a paragraph with an RFC 6901 JSON Pointer. A range narrows the location to text within that paragraph and uses the same UTF-16 coordinates as the programmatic text API.

Location digests are distinct from canonical saved-file and transaction-report digests. Text, structure, formatting, and resource references affect location identity. Resource bytes and availability do not: replacing bytes under the same resource id leaves locations valid. Creating or resolving locations never loads resources. A location does not guarantee that the document can be saved losslessly.