@liquidcars/atlas 0.1.43 → 0.1.44

package/README.md

@@ -58,8 +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.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
@@ -115,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-relation-marker-change`, `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`
@@ -179,6 +181,7 @@ componente aplica `break-inside: avoid` durante la impresió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
@@ -393,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