@liquidcars/atlas 0.1.50 → 0.1.51

package/README.md

@@ -472,3 +472,35 @@ In that fallback, Save opens a picker or downloads a copy because the selected
 files cannot be written in place.
 See `examples/hyperlinks` for two linked documents and an external Markdown
 information file.
+
+### Named models and cloud destinations
+
+The optional `model` selector identifies a technical model key within the
+destination document. Titles may change without changing the reference:
+
+| Destination | Reference |
+| --- | --- |
+| Current document | `atlas:?model=process` |
+| Local collection | `atlas:actors/dealer.atlas.md?model=inventory` |
+| Current cloud publication | `atlas://cloud/DOCUMENT_ID@published?model=process` |
+| Fixed cloud revision | `atlas://cloud/DOCUMENT_ID@r3?model=process` |
+| Authorized cloud Draft | `atlas://cloud/DOCUMENT_ID@draft?model=process` |
+
+Append `#entityId` to select an entity. URI-encode model keys and fragments.
+Omitting `model` uses the destination document's `defaultModel`. A cloud origin
+cannot resolve local document or content paths; a local origin may open cloud
+documents through its host resolver.
+
+The exported `atlasReferenceTarget(reference, from)` parses the document kind,
+version and model selector. The resolver may return `context` alongside `uri`
+and `model`; the runtime carries that context in history and navigation events.
+Return a canonical revision URI when resolving `@published` to pin the visit.
+Cloud history visits invoke the resolver again so the host can recheck access.
+The runtime does not grant authorization or contact a cloud deployment itself.
+
+Use `setNavigationGuard(async () => { ... })` to finish pending saves before
+navigation. Resolution errors, missing models and missing entity fragments leave
+the origin active. History retains 2D/3D mode, camera, diagram zoom and scroll,
+selection, open containers and filters. Hosts that rebuild the component can use
+`restoreNavigationState(state, { restorePresentation: true })` to restore its
+presentation as well as its history.