@liquidcars/atlas 0.1.49 → 0.1.51

package/README.md

@@ -191,6 +191,7 @@ generar el archivo.
 - `palette`: mapa de nombres de color a valores CSS/hex.
 - `theme` (opcional): configuración de `background`, `lighting`, `panel`, `toolbar`, `breadcrumbs`, `hint` y `ui`. `ui` permite mostrar u ocultar `panel`, `toolbar`, `breadcrumbs` y `hint`.
 - `render.camera` (opcional): vista inicial con `position`, `target` y `zoom`. Las coordenadas pertenecen al espacio del modelo; `zoom` conserva el encuadre relativo entre tamaños de visor.
+- `render.initialMode`: `2d` o `3d`. `render.views."2d".theme` admite `auto` (hereda el fondo del documento), `light` o `dark`; `render.views."2d".grid` activa o desactiva los puntos (por defecto, `true`). `render.views."2d".background` permite un color CSS concreto. `render.ui.toolbar` acepta `true`, `false` o una lista como `[mode, zoom, fit]` para mostrar solo esos controles.
 - `render.focus` (opcional): filtrado visual por selección. `mode` acepta `all` o `connected`, `effect` acepta `dim` o `hide`, y `layout` distingue posiciones estables (`preserve`) de una proyección recompilada (`reflow`).
 - `render.relationMarker` (opcional): forma de los indicadores animados de relación. Admite `cone` (por defecto, conserva el sentido en capturas estáticas) o `ring`.
 - `style.label.anchor` (opcional): posición predeterminada de las etiquetas de los elementos (`auto`, `top`, `bottom`, `left` o `right`). Si se omite, los elementos usan `bottom`; una entidad puede sobrescribirlo con su propio `style.label.anchor`. Los títulos de contenedores mantienen su colocación automática salvo override explícito.
@@ -471,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.