@liquidcars/atlas 0.1.30 → 0.1.31

package/README.md

@@ -100,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
@@ -119,6 +119,7 @@ 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]`.
@@ -200,18 +201,28 @@ 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()`, `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.