@liquidcars/atlas 0.1.29 → 0.1.31

package/README.md

@@ -32,7 +32,7 @@ Después abre <http://localhost:4173/> (o <http://localhost:4173/demo/>). La dem
         "p": [0, -3, 0],
         "s": [11, 3.4, 5],
         "c": "#48c8b0",
-        "type": "shell",
+        "type": "container",
         "text": "..."
       }
     ],
@@ -59,6 +59,9 @@ atlas.panBy(-1.5, 0); // desplazamiento horizontal/vertical en el plano de cáma
 atlas.panTo(0, 0, 0); // centra la cámara en un punto del mundo
 atlas.fit();
 atlas.frontView();
+const initialView = atlas.getCameraView();
+atlas.setCameraView(initialView, { animate: false });
+atlas.restoreInitialCamera({ animate: false });
 atlas.setShellLabels(true);
 atlas.openAllContainers();
 atlas.closeAllContainers();
@@ -97,7 +100,7 @@ por lo que una aplicación puede adaptar la apariencia sin modificar el bundle.
 Las propiedades `atlas.theme` y `atlas.styles` son alias prácticos de esta configuración.
 
 Eventos disponibles: `lc-ready`, `lc-error`, `lc-warning`, `lc-select`, `lc-model-change`,
-`lc-relation-mode` y `lc-disconnect`. `lc-select` usa un detalle discriminado:
+`lc-relation-mode`, `lc-focus-change` y `lc-disconnect`. `lc-select` usa un detalle discriminado:
 las entidades incluyen `{ kind: 'entity', id, entity, source }` y las relaciones
 `{ kind: 'relation', id, index, relation, source }`. Los campos históricos `id`
 y `entity` se conservan para las selecciones de entidad. Al volver a la vista
@@ -115,6 +118,8 @@ como `setClickBehavior()`).
 
 - `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.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`).
 - `entities`: objetos con `id`, `name`, `p`, `s`, `c`, `type`, `text` y opcionalmente `parent`, `geometry`, `radius`, `segments`, `frontLabel`, `anchor` y `ports`.
 - `p` es la posición local respecto a `parent`; una entidad sin `parent` usa coordenadas de escena.
 - `s` son dimensiones absolutas locales `[x, y, z]`.
@@ -127,6 +132,9 @@ como `setClickBehavior()`).
 
 Geometrías incluidas en esta primera versión: `box`, `cylinder`, `sphere`, `cone`, `frustum-cone`, `frustum-pyramid`, `frustum-triangle`, `prism`, `pyramid-square`, `pyramid-triangle`, `octahedron`, `dodecahedron` e `icosahedron`. Las variantes `frustum-*` son sólidos truncados con dos caras finitas paralelas; las dimensiones `s` se aplican sobre su caja final normalizada.
 
+Las etiquetas se rasterizan con relleno claro y un contorno oscuro proporcional
+para mantener el contraste sobre geometrías tanto claras como oscuras.
+
 ## Geometry packs
 
 Las geometrías pueden distribuirse en paquetes independientes. El componente
@@ -193,7 +201,31 @@ una caja roja de fallback y emite `lc-warning` con el código
 
 La paleta puede cambiarse después de cargar el modelo mediante `atlas.setPalette({ nombre: color })` o asignando `atlas.palette = { ... }`. El cambio actualiza las piezas, aristas y relaciones sin reconstruir el modelo.
 
-Las acciones de navegación y exploración también están disponibles para la página anfitriona: `zoomIn()`, `zoomOut()`, `panBy()`, `panTo()`, `fit()`, `frontView()`, `setShellLabels()`, `toggleShellLabels()`, `openAllContainers()` y `closeAllContainers()`. El usuario puede desplazar la vista con el botón derecho, con `Shift` + arrastre o mediante dos dedos en una pantalla táctil. Así se puede construir una barra de controles propia sin depender de la toolbar interna.
+Las acciones de navegación y exploración también están disponibles para la página anfitriona: `zoomIn()`, `zoomOut()`, `panBy()`, `panTo()`, `fit()`, `frontView()`, `getCameraView()`, `setCameraView()`, `restoreInitialCamera()`, `setShellLabels()`, `toggleShellLabels()`, `setFocusFilter()`, `clearFocusFilter()`, `getFocusedIds()`, `openAllContainers()` y `closeAllContainers()`. El usuario puede desplazar la vista con el botón derecho, con `Shift` + arrastre o mediante dos dedos en una pantalla táctil. Así se puede construir una barra de controles propia sin depender de la toolbar interna.
+
+Una vista inicial portable puede declararse dentro del modelo:
+
+```yaml
+render:
+  focus:
+    mode: connected
+    effect: dim
+    layout: preserve
+    opacity: 0.12
+  camera:
+    position: [12.4, 7.2, 18.6]
+    target: [0, 1.5, 0]
+    zoom: 1.35
+```
+
+La API equivalente es `setFocusFilter({ mode, effect, layout, opacity })`.
+`getFocusedIds()` devuelve la selección, sus vecinos directos y los contenedores
+ancestros necesarios. El evento `lc-focus-change` permite que un host conectado a
+`@liquidcars/atlas-layout` recompile una proyección cuando `layout` es `reflow`.
+
+`position` y `target` fijan la dirección observada. Cuando existe `zoom`, éste
+prevalece para calcular la distancia final y mantener el encuadre; si se omite,
+Atlas lo deriva de la distancia declarada.
 
 La escena también se puede editar en caliente. `updateModel(patch)` reemplaza
 las secciones indicadas; `addEntity`, `updateEntity` y `removeEntity` gestionan

package/demo/model.json

@@ -28,7 +28,7 @@
         5
       ],
       "c": "offers",
-      "type": "shell",
+      "type": "container",
       "text": "La base del modelo contiene inventarios, ofertas y servicios. El dealer aporta la Base Offer, que referencia el vehículo físico; el proveedor aporta el servicio asociado."
     },
     {
@@ -46,7 +46,7 @@
         5
       ],
       "c": "ole",
-      "type": "shell",
+      "type": "container",
       "text": "El Offer Listing Engine aplica revenue management, etiquetas y condiciones de distribución para calcular la oferta que observa cada canal."
     },
     {
@@ -64,7 +64,7 @@
         5
       ],
       "c": "agreements",
-      "type": "shell",
+      "type": "container",
       "text": "Agrupa el acuerdo de distribución y sus ámbitos funcionales: atribución, reservas y pedidos. El acuerdo vincula las ofertas y servicios con su distribución autorizada."
     },
     {
@@ -82,7 +82,7 @@
         5
       ],
       "c": "channels",
-      "type": "shell",
+      "type": "container",
       "text": "Agrupa los canales de distribución. Cada CHANNEL está contenido en CHANNELS y contiene la oferta de canal que presenta al comprador."
     },
     {
@@ -101,7 +101,7 @@
         3.9
       ],
       "c": "offers",
-      "type": "shell",
+      "type": "container",
       "text": "Colección de ofertas alimentada directamente por el dealer o su sistema de stock. Contiene la Base Offer y propaga sus actualizaciones."
     },
     {
@@ -160,7 +160,7 @@
         3.9
       ],
       "c": "offers",
-      "type": "shell",
+      "type": "container",
       "text": "Vista calculada de un inventario mediante filtros y reglas. Está apoyada sobre el inventario físico para expresar su dependencia; no duplica el vehículo."
     },
     {
@@ -220,7 +220,7 @@
         3.8
       ],
       "c": "ole",
-      "type": "shell",
+      "type": "container",
       "text": "Etiquetas estáticas o dinámicas, activas o inactivas, que alimentan las reglas de selección, precio y disponibilidad. Su efecto procede de las fórmulas donde se utilizan."
     },
     {
@@ -365,7 +365,7 @@
         3.8
       ],
       "c": "ole",
-      "type": "shell",
+      "type": "container",
       "text": "Aplica las reglas comerciales autorizadas al contexto de distribución. Contiene la Channel Offer calculada; el sistema ejecuta las decisiones de las partes."
     },
     {
@@ -546,7 +546,7 @@
         4.3
       ],
       "c": "channels",
-      "type": "shell",
+      "type": "container",
       "text": "Representa un canal de distribución dentro de CHANNELS: un marketplace, la web del dealer u otro canal autorizado. Contiene la oferta de canal presentada al comprador."
     },
     {