@liquidcars/atlas-layout 0.1.7 → 0.1.8

package/README.md

@@ -49,6 +49,21 @@ como alias de compatibilidad. Un contenedor puede no tener geometría o usar una
 primitiva `geo.*`; las geometrías personalizadas de los packs, como `infra.cloud`,
 sólo se permiten en entidades hoja.
 
+La presentación puede conservar una vista inicial sin introducir datos de
+cámara en el algoritmo de layout:
+
+```yaml
+render:
+  camera:
+    position: [12.4, 7.2, 18.6]
+    target: [0, 1.5, 0]
+    zoom: 1.35
+```
+
+Las coordenadas son coordenadas del modelo. `zoom` es un multiplicador de
+encuadre independiente del tamaño del viewport y se conserva al compilar YAML
+o Markdown.
+
 Para compilar una fuente YAML durante el build:
 
 ```js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liquidcars/atlas-layout",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Declarative layout compiler for LiquidCars Atlas models",
   "type": "module",
   "main": "./src/index.js",

package/spec/ATLAS-LAYOUT-SPEC-v1.md

@@ -150,8 +150,11 @@ Optional fields include id, label, fromAnchor, toAnchor, priority and layout.
 ## Rendering
 
 palette maps tokens to CSS colours. style.color or c can reference a token or direct
-CSS colour. render can additionally set relationMode, selectionMode, toolbar and
-shellLabels. theme contains background, lighting and ui settings.
+CSS colour. render can additionally set relationMode, selectionMode, toolbar,
+shellLabels (the text-label contrast outline) and camera. An initial camera snapshot contains model-space
+position and target vectors plus a positive, dimensionless zoom value. Position
+and target determine the viewing direction; zoom preserves the intended framing
+across viewport sizes. theme contains background, lighting and ui settings.
 
 ## Markdown blocks
 

package/src/index.js

@@ -1050,6 +1050,7 @@ export function compileAtlasModel(input, options = {}) {
     relations,
     layout: source.layout || undefined,
     constraints: source.constraints || undefined,
+    render: source.render || undefined,
     diagnostics
   };
   if (options.throwOnFatal && diagnostics.some(item => item.level === "fatal")) throw new Error(diagnostics.filter(item => item.level === "fatal").map(item => item.message).join("\n"));

package/src/spec.js

@@ -136,7 +136,16 @@ export const ATLAS_LAYOUT_SPEC_V1 = freeze({
         relationMode: field("Visible relation set.", ["all", "selected", "none"]),
         selectionMode: field("Selection ownership.", ["internal", "event"]),
         toolbar: field("Built-in toolbar visibility.", [true, false]),
-        shellLabels: field("Container label visibility.", [true, false])
+        shellLabels: field("Text-label contrast outline.", [true, false]),
+        camera: field("Initial camera snapshot in model-space coordinates.", null, { context: "camera" })
+      })
+    }),
+    camera: freeze({
+      label: "Initial camera",
+      properties: freeze({
+        position: field("Camera position in model-space coordinates.", null, { type: "vector", required: true }),
+        target: field("Model-space point observed by the camera.", null, { type: "vector", required: true }),
+        zoom: field("Dimensionless framing multiplier.", null, { type: "number", required: true })
       })
     }),
     span: freeze({
@@ -177,6 +186,7 @@ export function atlasLayoutContextForPath(path = []) {
     ["palette", "palette"],
     ["theme", "theme"],
     ["render", "render"],
+    ["camera", "camera"],
     ["span", "span"],
     ["stagger", "stagger"],
     ["label", "label"],