@liquidcars/atlas 0.1.16 → 0.1.18

package/README.md

@@ -65,6 +65,7 @@ atlas.setTheme({
   ui: { breadcrumbs: true, panel: true, toolbar: true, hint: false }
 });
 atlas.setPalette({ channels: '#58b6ec', offers: '#48c8b0', connection: '#f4edba' });
+atlas.setSelectionMode('event'); // el clic emite lc-select sin navegar internamente
 
 // El componente se puede modificar sin volver a crearlo.
 atlas.addEntity({ id: 'service', name: 'Service', geometry: 'cone', p: [4, 0, 0], s: [2, 2, 2] });
@@ -95,6 +96,12 @@ null`. Los eventos de selección y cambios de modelo son `bubbles` y
 `composed`, por lo que funcionan también al integrar el componente en otras
 capas de Web Components.
 
+El comportamiento del clic se puede elegir con `selection-mode="internal"`
+(por defecto) o `selection-mode="event"`. En el segundo caso el componente
+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()`).
+
 ## Contrato de datos
 
 - `palette`: mapa de nombres de color a valores CSS/hex.
@@ -105,8 +112,8 @@ capas de Web Components.
 - `relations` acepta objetos `{from, to, label}` o la forma corta `[from, to, label]`.
   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 el tubo aparece
-  interrumpido en su punto medio.
+  circulan en ambos sentidos por el mismo tubo; en modo broken los dos tramos
+  aparecen en rojo, con una X y un anillo detenido en el punto de interrupción.
 
 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.
 
@@ -134,9 +141,9 @@ Una vez publicado, los consumidores podrán instalarlo con `npm install @liquidc
 Para probar el paquete sin publicarlo, basta con instalar el tarball generado:
 
 ```bash
-npm install ./liquidcars-atlas-0.1.15.tgz
+npm install ./liquidcars-atlas-0.1.18.tgz
 ```
 
 ## Estado
 
-`0.1.16` mantiene la corrección del desplazamiento interno del texto y ancla las etiquetas a las dimensiones reales de las geometrías redondeadas. Además fija un margen superior absoluto para las etiquetas secundarias de contenedores abiertos, situado dentro del frontal del contenedor y sin depender de sus dimensiones. También corrige los sólidos truncados, normaliza sus dimensiones finales, refuerza la visibilidad de la toolbar con el atributo `toolbar="on"`/`"off"` y `setToolbarVisible()`, desacopla la paleta por defecto de nombres de dominio, añade actualización programática de la paleta con `setPalette`, expone las acciones de navegación para controles externos y mantiene siempre visibles las ayudas de interacción dentro del viewport. Esta versión añade edición en caliente de entidades y relaciones, eventos compuestos de selección y los modos de relación `directed`, `bidirectional` y `broken`.
+`0.1.18` mantiene la corrección del desplazamiento interno del texto y ancla las etiquetas a las dimensiones reales de las geometrías redondeadas. Además fija un margen superior absoluto para las etiquetas secundarias de contenedores abiertos, situado dentro del frontal del contenedor y sin depender de sus dimensiones. También corrige los sólidos truncados, normaliza sus dimensiones finales, refuerza la visibilidad de la toolbar con el atributo `toolbar="on"`/`"off"` y `setToolbarVisible()`, desacopla la paleta por defecto de nombres de dominio, añade actualización programática de la paleta con `setPalette`, expone las acciones de navegación para controles externos y mantiene siempre visibles las ayudas de interacción dentro del viewport. Esta versión añade edición en caliente de entidades y relaciones, eventos compuestos de selección y los modos de relación `directed`, `bidirectional` y `broken`.

package/demo/index.html

@@ -14,12 +14,12 @@
     liquidcars-atlas { display: block; width: 100%; max-width: 1480px; margin: 0 auto; }
     code { color: #85e5d3; }
   </style>
-  <script type="module" src="../dist/liquidcars-atlas.js?v=0.1.15"></script>
+  <script type="module" src="../dist/liquidcars-atlas.js?v=0.1.18"></script>
 </head>
 <body>
   <header>
     <h1>LiquidCars Atlas</h1>
-    <p>Prueba de distribución del componente <code>&lt;liquidcars-atlas&gt;</code> · v0.1.15</p>
+    <p>Prueba de distribución del componente <code>&lt;liquidcars-atlas&gt;</code> · v0.1.18</p>
   </header>
   <main>
     <liquidcars-atlas id="atlas" height="720" relation-mode="selected" shell-labels="on"></liquidcars-atlas>

package/dist/liquidcars-atlas.js

@@ -1,4 +1,4 @@
-/*! LiquidCars Atlas 0.1.16 | MIT */
+/*! LiquidCars Atlas 0.1.18 | MIT */
 
 // src/three.core.js
 /**
@@ -29578,7 +29578,7 @@ function makeLabel(text, color, dimensions, type = "") {
 }
 var LiquidCarsAtlas = class extends HTMLElement {
   static get observedAttributes() {
-    return ["height", "relation-mode", "shell-labels", "toolbar"];
+    return ["height", "relation-mode", "shell-labels", "toolbar", "selection-mode"];
   }
   constructor() {
     super();
@@ -29598,6 +29598,7 @@ var LiquidCarsAtlas = class extends HTMLElement {
     this.modelData = null;
     this.theme = normalizeTheme();
     this.relationMode = this.getAttribute("relation-mode") || "selected";
+    this.selectionMode = this.getAttribute("selection-mode") || "internal";
     this.showShellLabels = this.getAttribute("shell-labels") !== "false";
     this.yaw = 0.37;
     this.pitch = 0.22;
@@ -29639,6 +29640,7 @@ var LiquidCarsAtlas = class extends HTMLElement {
       this._toolbarVisible = value !== "off";
       if (this.ready) this._applyTheme();
     }
+    if (name === "selection-mode") this.selectionMode = ["internal", "event"].includes(value) ? value : "internal";
   }
   get model() {
     return this.modelData;
@@ -29649,6 +29651,17 @@ var LiquidCarsAtlas = class extends HTMLElement {
   get selectedId() {
     return this.selected?.id || null;
   }
+  get clickBehavior() {
+    return this.selectionMode;
+  }
+  setClickBehavior(value) {
+    return this.setSelectionMode(value);
+  }
+  setSelectionMode(mode = "internal") {
+    this.selectionMode = mode === "event" || mode === "external" ? "event" : "internal";
+    this.setAttribute("selection-mode", this.selectionMode);
+    return this;
+  }
   _emit(type, detail = {}) {
     this.dispatchEvent(new CustomEvent(type, { detail, bubbles: true, composed: true }));
   }
@@ -30101,17 +30114,32 @@ var LiquidCarsAtlas = class extends HTMLElement {
       const delta = end.clone().sub(start);
       if (delta.lengthSq() < 0.01) continue;
       const visualMode = relationVisualMode(relation);
-      const makeTube = (from2, to2, opacity = 0.82) => {
-        const tube = new Mesh(new TubeGeometry(new LineCurve3(from2, to2), 10, 0.045, 6, false), new MeshBasicMaterial({ color, transparent: true, opacity }));
+      const makeTube = (from2, to2, opacity = 0.82, tubeColor = color, tubeRadius = 0.045) => {
+        const tube = new Mesh(new TubeGeometry(new LineCurve3(from2, to2), 10, tubeRadius, 6, false), new MeshBasicMaterial({ color: tubeColor, transparent: true, opacity }));
         tube.userData.relationIndex = index;
         this.relationGroup.add(tube);
       };
       if (visualMode === "broken") {
+        const brokenColor = new Color(0xe45b63);
         const direction = delta.clone().normalize();
         const midpoint = start.clone().lerp(end, 0.5);
         const gap = Math.min(delta.length() * 0.16, 0.72);
-        makeTube(start, midpoint.clone().sub(direction.clone().multiplyScalar(gap / 2)), 0.55);
-        makeTube(midpoint.clone().add(direction.clone().multiplyScalar(gap / 2)), end, 0.55);
+        makeTube(start, midpoint.clone().sub(direction.clone().multiplyScalar(gap / 2)), 0.86, brokenColor, 0.055);
+        makeTube(midpoint.clone().add(direction.clone().multiplyScalar(gap / 2)), end, 0.86, brokenColor, 0.055);
+        // Mark the interruption with a red X in a plane perpendicular to
+        // the communication line.  The two arms are fixed at the midpoint,
+        // making the broken state visible from every camera angle.
+        const reference = Math.abs(direction.y) < 0.9 ? new Vector3(0, 1, 0) : new Vector3(1, 0, 0);
+        const axisA = new Vector3().crossVectors(direction, reference).normalize();
+        const axisB = new Vector3().crossVectors(direction, axisA).normalize();
+        const arm = Math.min(0.52, Math.max(0.28, delta.length() * 0.07));
+        makeTube(midpoint.clone().addScaledVector(axisA, -arm), midpoint.clone().addScaledVector(axisA, arm), 1, brokenColor, 0.065);
+        makeTube(midpoint.clone().addScaledVector(axisB, -arm), midpoint.clone().addScaledVector(axisB, arm), 1, brokenColor, 0.065);
+        const stoppedRing = new Mesh(new TorusGeometry(0.09, 0.025, 8, 20), new MeshBasicMaterial({ color: brokenColor, transparent: true, opacity: 1 }));
+        stoppedRing.userData.start = midpoint.clone();
+        stoppedRing.userData.end = midpoint.clone();
+        stoppedRing.quaternion.setFromUnitVectors(new Vector3(0, 0, 1), direction);
+        this.relationGroup.add(stoppedRing);
         continue;
       }
       makeTube(start, end);
@@ -30377,7 +30405,10 @@ var LiquidCarsAtlas = class extends HTMLElement {
       this.canvas.style.cursor = "grab";
       if (drag && !drag.moved) {
         const node = this._pick(event);
-        if (node) this.select(node.id, { source: "pointer" });
+        if (node) {
+          if (this.selectionMode === "event") this._emit("lc-select", { id: node.id, entity: this._publicEntity(node.id), source: "pointer" });
+          else this.select(node.id, { source: "pointer" });
+        }
       }
       this.invalidate();
     });

package/index.html

@@ -14,12 +14,12 @@
     liquidcars-atlas { display: block; width: 100%; max-width: 1480px; margin: 0 auto; }
     code { color: #85e5d3; }
   </style>
-  <script type="module" src="./dist/liquidcars-atlas.js?v=0.1.15"></script>
+  <script type="module" src="./dist/liquidcars-atlas.js?v=0.1.18"></script>
 </head>
 <body>
   <header>
     <h1>LiquidCars Atlas</h1>
-    <p>Prueba de distribución del componente <code>&lt;liquidcars-atlas&gt;</code> · v0.1.15</p>
+    <p>Prueba de distribución del componente <code>&lt;liquidcars-atlas&gt;</code> · v0.1.18</p>
   </header>
   <main>
     <liquidcars-atlas id="atlas" height="720" relation-mode="selected" shell-labels="on"></liquidcars-atlas>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liquidcars/atlas",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Reusable 3D conceptual atlas Web Component for LiquidCars-style models",
   "type": "module",
   "main": "./dist/liquidcars-atlas.js",