@liquidcars/atlas 0.1.42 → 0.1.44

package/README.md

@@ -17,7 +17,7 @@ Después abre <http://localhost:4173/> (o <http://localhost:4173/demo/>). La dem
 ```html
 <script type="module" src="./dist/liquidcars-atlas.js"></script>
 
-<liquidcars-atlas height="720" relation-mode="selected" shell-labels="on" toolbar="on">
+<liquidcars-atlas height="720" relation-mode="selected" relation-marker="cone" shell-labels="on" toolbar="on">
   <script type="application/json">
   {
     "palette": {
@@ -58,7 +58,10 @@ 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.getRelationBundle(); // conexiones A↔B que comparten el tubo de la selección
+atlas.setRelationMode('all'); // 'all' | 'selected' | 'callers' | 'called' | 'none'
+atlas.setRelationMarker('cone'); // 'cone' por defecto; 'ring' conserva el indicador clásico
+atlas.setVisibleRelationGroups(['electric', 'water']); // null vuelve a mostrar todos
 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
@@ -114,7 +117,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-item-facing-change`, `lc-focus-change`, `lc-print-ready`, `lc-print-error`,
+`lc-relation-mode`, `lc-relation-marker-change`, `lc-relation-groups-change`, `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`
@@ -137,6 +140,7 @@ atributo `selection-navigation="preserve|center|fit"`, mediante
 
 ```yaml
 render:
+  relationMarker: cone # ring conserva el indicador circular clásico
   navigation:
     onSelect: preserve
   itemFacing: model # opt-out; camera es el valor por defecto
@@ -148,6 +152,8 @@ Atlas prepara automáticamente una representación WYSIWYG al entrar en el modo
 de impresión del navegador. La captura conserva el ángulo, el zoom, el foco y
 los objetos visibles, pero omite la toolbar, el panel de información y las
 indicaciones de interacción. Al terminar se restaura el canvas WebGL.
+Los conos animados indican el sentido incluso en una captura estática. Un
+modelo puede recuperar los aros clásicos con `render.relationMarker: ring`.
 
 La misma funcionalidad puede controlarse explícitamente:
 
@@ -169,15 +175,17 @@ 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`).
+- `render.relationMarker` (opcional): forma de los indicadores animados de relación. Admite `cone` (por defecto, conserva el sentido en capturas estáticas) o `ring`.
 - `style.label.anchor` (opcional): posición predeterminada de las etiquetas de los elementos (`auto`, `top`, `bottom`, `left` o `right`). Si se omite, los elementos usan `bottom`; una entidad puede sobrescribirlo con su propio `style.label.anchor`. Los títulos de contenedores mantienen su colocación automática salvo override explícito.
 - `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.
+- `relationGroups` declara capas temáticas `{id, label, color, description}` y cada relación puede referenciar una con `group`. `render.visibleRelationGroups` las filtra sin alterar el modo de relaciones. Las conexiones paralelas visibles comparten automáticamente un portador translúcido, pero cada conductor conserva selección, dirección, marcador e inspector propios.
   El campo visual opcional `mode` admite `directed` (por defecto),
   `bidirectional` y `broken`. En modo bidireccional los indicadores animados
   circulan en ambos sentidos por el mismo tubo; en modo broken los dos tramos
-  se sustituyen por un único tubo rojo con tres anillos que vibran localmente,
+  se sustituyen por un único tubo rojo con tres indicadores que vibran localmente.
   distribuidos a lo largo del recorrido.
 
 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.
@@ -302,7 +310,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()`, `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.
+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()`, `setRelationMarker()`, `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
@@ -388,9 +396,10 @@ personalizados, paletas locales, anchors e imágenes declarativas. La
 versión `0.1.23` añadió desplazamiento lateral de cámara mediante ratón, teclado
 modificador y gestos táctiles, además de la API pública `panBy()` y `panTo()`.
 Se conserva la selección contextual de relaciones introducida en `0.1.22`: el usuario puede
-seleccionar un tubo directamente, el componente lo realza, muestra sus extremos
-y modo en el panel y emite el mismo evento `lc-select` con `kind: 'relation'`.
-La API pública añade `selectRelation()`, `selectedRelation` y `selection`, y la
+seleccionar un tubo directamente. Cuando varias conexiones comparten extremos,
+los clics sucesivos recorren sus conductores y el panel enumera el tubo virtual
+completo para permitir una selección precisa. La API pública añade
+`selectRelation()`, `getRelationBundle()`, `selectedRelation` y `selection`, y la
 selección se conserva durante las mutaciones del modelo siempre que el elemento
 siga existiendo. Se mantienen las correcciones de geometría, toolbar, etiquetas,
 paleta externa, edición en caliente y los modos `directed`, `bidirectional` y