@liquidcars/atlas 0.1.34 → 0.1.37

package/README.md

@@ -54,11 +54,14 @@ 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"
 atlas.setPanelVisible(true);   // también se puede usar panel="on" | "off"
+atlas.setItemFacing('camera'); // valor por defecto; usa 'model' para conservar la orientación original
 atlas.zoomIn();
 atlas.zoomOut();
 atlas.panBy(-1.5, 0); // desplazamiento horizontal/vertical en el plano de cámara
@@ -111,7 +114,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`, `lc-focus-change`, `lc-print-ready`, `lc-print-error`,
+`lc-relation-mode`, `lc-item-facing-change`, `lc-focus-change`, `lc-print-ready`, `lc-print-error`,
 `lc-print-restored` 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`
@@ -126,6 +129,19 @@ 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
+  itemFacing: model # opt-out; camera es el valor por defecto
+```
+
 ## Impresión
 
 Atlas prepara automáticamente una representación WYSIWYG al entrar en el modo
@@ -223,9 +239,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
@@ -234,7 +251,7 @@ 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()`, `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.
+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()`, `setItemFacing()`, `toggleItemFacing()`, `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