@liquidcars/atlas 0.1.43 → 0.1.45

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`
@@ -157,14 +159,23 @@ La misma funcionalidad puede controlarse explícitamente:
 
 ```js
 const atlas = document.querySelector("liquidcars-atlas");
-const frame = atlas.captureFrame(); // canvas 2D con el framebuffer actual
+const transparent = atlas.captureFrame(); // canvas 2D con alfa
+const themed = atlas.captureFrame({ background: "theme" }); // añade el fondo visual del componente
+const white = atlas.captureFrame({ background: "#ffffff" }); // fondo sólido opcional
+const presentation = atlas.captureFrame({ background: "transparent", scale: 2 }); // salida HD
 atlas.prepareForPrint();
 atlas.restoreAfterPrint();
 ```
 
 `captureFrame()` usa `WebGLRenderingContext.readPixels()` para funcionar también
 en navegadores que no permiten copiar directamente un canvas WebGL sin
-`preserveDrawingBuffer`. Para evitar que un bloque se divida entre páginas, el
+`preserveDrawingBuffer`. El framebuffer permanece transparente: el fondo de tema
+se compone en el canvas 2D únicamente cuando se solicita y no recibe luces ni
+sombras de la escena. `scale` vuelve a renderizar temporalmente entre 1× y 4×,
+respetando el límite de framebuffer del navegador, y restaura inmediatamente el
+canvas interactivo. Los colores WebGL semitransparentes se convierten de alfa
+premultiplicado a alfa directo para conservar el tono de los contenedores
+abiertos cuando el PNG se coloca sobre un fondo claro. Para evitar que un bloque se divida entre páginas, el
 componente aplica `break-inside: avoid` durante la impresión.
 
 ## Contrato de datos
@@ -179,6 +190,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 +405,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