@liquidcars/atlas 0.1.33 → 0.1.36

package/README.md

@@ -54,7 +54,9 @@ También se puede cargar el modelo desde JavaScript:
 ```js
 const atlas = document.querySelector('liquidcars-atlas');
 atlas.model = model;
-atlas.select('distribution-agreement');
+atlas.select('distribution-agreement'); // selecciona sin mover la cámara
+atlas.focusSelection();                 // centra y amplía la selección explícitamente
+atlas.setSelectionNavigation('preserve'); // 'preserve' | 'center' | 'fit'
 atlas.selectRelation(0); // también acepta el id de una relación
 atlas.setRelationMode('all'); // 'all' | 'selected' | 'none'
 atlas.setToolbarVisible(true); // también se puede usar toolbar="on" | "off"
@@ -69,6 +71,11 @@ const initialView = atlas.getCameraView();
 atlas.setCameraView(initialView, { animate: false });
 atlas.restoreInitialCamera({ animate: false });
 atlas.setShellLabels(true);
+atlas.setContainerOpen('distribution-agreements', true);
+atlas.toggleContainer('distribution-agreements');
+console.log(atlas.isContainerOpen('distribution-agreements'));
+console.log(atlas.getOpenContainerIds());
+atlas.restoreInitialContainerState();
 atlas.openAllContainers();
 atlas.closeAllContainers();
 atlas.setTheme({
@@ -121,6 +128,18 @@ emite `lc-select` con `source: "pointer"`, pero deja la decisión a la página
 anfitriona. La API equivalente es `setSelectionMode()` (también disponible
 como `setClickBehavior()`).
 
+La selección interna conserva la cámara por defecto. Un doble clic, el botón
+**Enfocar selección** del panel o `focusSelection()` centran y amplían el
+elemento seleccionado. El comportamiento automático puede cambiarse con el
+atributo `selection-navigation="preserve|center|fit"`, mediante
+`setSelectionNavigation()` o declarativamente en el modelo:
+
+```yaml
+render:
+  navigation:
+    onSelect: preserve
+```
+
 ## Impresión
 
 Atlas prepara automáticamente una representación WYSIWYG al entrar en el modo
@@ -148,7 +167,7 @@ componente aplica `break-inside: avoid` durante la impresión.
 - `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`, `url` y opcionalmente `parent`, `geometry`, `radius`, `segments`, `frontLabel`, `anchor` y `ports`. Las URL HTTP(S) se abren en una pestaña nueva desde el panel de información.
+- `entities`: objetos con `id`, `name`, `p`, `s`, `c`, `type`, `text`, `url` y opcionalmente `parent`, `geometry`, `radius`, `segments`, `frontLabel`, `anchor` y `ports`. Un contenedor puede declarar `open: true` para comenzar abierto; el valor predeterminado es cerrado y se omite al serializar. Las URL HTTP(S) se abren en una pestaña nueva desde el panel de información.
 - `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]`.
 - `relations` acepta objetos `{from, to, label, text, url}` o la forma corta `[from, to, label]`. `label` es el título corto de la conexión, `text` su descripción y `url` su documentación externa en el panel de información.
@@ -218,9 +237,10 @@ proporciones canónicas y anchors. Las piezas declarativas admiten primitivas,
 posición, rotación, escala, materiales, iconos de texto o emoji e imágenes por
 URL/data URI; los SVG también pueden proporcionarse inline. Para planos con
 imagen, `imageFit` admite `cover`, `contain` y `stretch`. El renderer mantiene Three.js encapsulado para evitar que los packs
-dependan de su versión interna. Las relaciones parten del centro por defecto;
-`fromAnchor` y `toAnchor` quedan como overrides explícitos para casos
-excepcionales.
+dependan de su versión interna. Las relaciones parten por defecto de la
+superficie orientada hacia el otro extremo. `anchor: center` conserva el
+comportamiento centrado cuando sea necesario, y `fromAnchor` y `toAnchor`
+permiten elegir puertos explícitos declarados por una geometría.
 
 Si un namespace no está registrado, Atlas conserva el modelo renderizable con
 una caja roja de fallback y emite `lc-warning` con el código
@@ -229,11 +249,21 @@ 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()`, `getCameraView()`, `setCameraView()`, `restoreInitialCamera()`, `setShellLabels()`, `toggleShellLabels()`, `setPanelVisible()`, `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.
+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()`, `setPanelVisible()`, `setFocusFilter()`, `clearFocusFilter()`, `getFocusedIds()`, `isContainerOpen()`, `getOpenContainerIds()`, `setContainerOpen()`, `setOpenContainers()`, `toggleContainer()`, `restoreInitialContainerState()`, `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.
+
+Cada cambio del estado vivo emite `lc-container-state-change`. Su detalle contiene
+`openContainers`, `changedContainers`, `changedContainer`, `open` y `source`, de
+modo que el host puede consultar o persistir una interacción sin acceder a
+detalles internos del componente.
 
 Una vista inicial portable puede declararse dentro del modelo:
 
 ```yaml
+entities:
+  - id: distribution-agreements
+    type: container
+    open: true
+    children: []
 render:
   focus:
     mode: connected