@liquidcars/atlas 0.1.37 → 0.1.39

package/README.md

@@ -187,37 +187,59 @@ para mantener el contraste sobre geometrías tanto claras como oscuras.
 ## Geometry packs
 
 Las geometrías pueden distribuirse en paquetes independientes. El componente
-expone `registerGeometryPack()`, `unregisterGeometryPack()` y
-`getGeometryCatalog()`; los mismos métodos están disponibles como estáticos en
-`LiquidCarsAtlas`. Los identificadores usan un namespace (`infra.server`,
-`architecture.application`, etc.) y las primitivas integradas también se
-publican como `geo.box`, `geo.sphere`, etc. Los nombres históricos sin
-namespace siguen siendo compatibles.
+expone `registerGeometryPack()`, `unregisterGeometryPack()`,
+`getGeometryCatalog()` y `getGeometryPackCatalog()`; los mismos métodos están
+disponibles como estáticos en `LiquidCarsAtlas`. Los identificadores usan un
+namespace (`infra.server`, `emoji-fluent.robot`, `architecture.hexagonal.port`, etc.) y las primitivas
+integradas también se publican como `geo.box`, `geo.sphere`, etc. Los nombres
+históricos sin namespace siguen siendo compatibles. Los namespaces pueden contener segmentos separados por puntos, de modo que packs especializados como `architecture.hexagonal` convivan con `architecture`.
+
+`getGeometryCatalog()` conserva el catálogo operativo de geometrías.
+`getGeometryPackCatalog()` describe las librerías registradas, incluyendo
+autoría, licencia, procedencia y recursos, sin duplicar estos datos en cada
+geometría.
+
+El módulo exporta también `ATLAS_VERSION`, y la clase registrada expone la
+misma versión mediante `customElements.get("liquidcars-atlas").version`. Esta
+segunda forma identifica la implementación que el navegador utiliza realmente
+si accidentalmente se cargan varias versiones del core.
 
 ```js
 import { registerGeometryPack } from "@liquidcars/atlas";
 
+const robotImage = new URL("./assets/robot.svg", import.meta.url).href;
+
 registerGeometryPack({
-  namespace: "infra",
-  name: "Infrastructure",
+  namespace: "example",
+  name: "Example visual assets",
   version: "0.1.0",
-  palette: { chassis: "#587386", accent: "#72dbc9" },
+  authors: [{ name: "Example Studio", url: "https://example.com" }],
+  license: { spdx: "MIT", url: "https://opensource.org/license/mit" },
+  sources: [{
+    id: "example-artwork",
+    name: "Example artwork",
+    authors: ["Example Studio"],
+    license: "MIT"
+  }],
+  resources: [{
+    id: "robot",
+    kind: "image",
+    mimeType: "image/svg+xml",
+    path: "./assets/robot.svg",
+    url: robotImage,
+    source: "example-artwork"
+  }],
+  palette: { backplate: "#193142", image: "#ffffff" },
   geometries: [{
-    id: "server",
-    name: "Server",
-    canonicalSize: [2.7, 1.8, 2.2],
-    parameters: {
-      units: { type: "number", min: 1, max: 8, default: 3 },
-      icon: { type: "icon", default: "⚙" },
-      image: { type: "image", default: "" }
-    },
-    anchors: { input: [-1, 0, 0], output: [1, 0, 0], network: [0, 0, 1] },
-    create({ parameters }) {
+    id: "robot",
+    canonicalSize: [2.4, 2.4, .5],
+    resource: "robot",
+    create({ resources }) {
       return { parts: [
-        { shape: "box", size: [1, 1, 1], color: "chassis" },
-        { shape: "plane", size: [.42, .42, 1], position: [0, 0, .51],
-          color: "accent", icon: parameters.icon, image: parameters.image,
-          edges: false, doubleSided: true }
+        { shape: "box", size: [.92, .92, .12], color: "backplate", radius: .16 },
+        { shape: "plane", size: [.84, .84, 1], position: [0, 0, .07],
+          color: "image", image: resources.robot.url, imageFit: "contain",
+          transparent: true, edges: false }
       ] };
     }
   }]
@@ -228,17 +250,22 @@ El modelo configura cada instancia sin conocer la implementación del paquete:
 
 ```json
 {
-  "geometry": "infra.server",
-  "geometryOptions": { "units": 4, "icon": "DB" },
-  "geometryPalette": { "accent": "#ffd166" }
+  "geometry": "example.robot",
+  "geometryPalette": { "backplate": "#284b63" }
 }
 ```
 
 Cada definición puede declarar parámetros tipados, una paleta local,
-proporciones canónicas y anchors. Las piezas declarativas admiten primitivas,
-posición, rotación, escala, materiales, iconos de texto o emoji e imágenes por
-URL/data URI; los SVG también pueden proporcionarse inline. Para planos con
-imagen, `imageFit` admite `cover`, `contain` y `stretch`. El renderer mantiene Three.js encapsulado para evitar que los packs
+proporciones canónicas y anchors. Los recursos declarados por el pack se
+entregan a `create({ resources })` indexados por `id`; pueden estar
+empaquetados mediante `new URL("./assets/...", import.meta.url)`, ser data URIs
+o apuntar a un recurso remoto. `sources` permite atribuir una colección de
+terceros una sola vez y cada recurso puede sobrescribir `authors` o `license`.
+
+Las piezas declarativas admiten primitivas, posición, rotación, escala,
+materiales e imágenes por URL/data URI; los SVG también pueden proporcionarse
+inline. Para planos con imagen, `imageFit` admite `cover`, `contain` y
+`stretch`. El renderer mantiene Three.js encapsulado para evitar que los packs
 dependan de su versión interna. Las relaciones parten por defecto de la
 superficie orientada hacia el otro extremo. `anchor: center` conserva el
 comportamiento centrado cuando sea necesario, y `fromAnchor` y `toAnchor`
@@ -314,12 +341,12 @@ 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.28.tgz
+npm install ./liquidcars-atlas-0.1.39.tgz
 ```
 
 ## Estado
 
-`0.1.28` rasteriza explícitamente los SVG sobre un canvas antes de subirlos a
+`0.1.39` incorpora metadatos normalizados de autoría, licencia, procedencia y recursos para los geometry packs, añade `getGeometryPackCatalog()` y entrega los recursos declarados a `create({ resources })`. Se mantiene intacto `getGeometryCatalog()` para conservar la compatibilidad. `0.1.28` rasteriza explícitamente los SVG sobre un canvas antes de subirlos a
 WebGL y emite diagnósticos cuando falla la carga o la conversión. `0.1.27` añade carga automática de imágenes SVG remotas, SVG mediante data URI
 y SVG inline, manteniendo las mismas opciones de cara y ajuste que las imágenes
 raster. `0.1.26` mantiene el centro como anclaje implícito de toda relación y utiliza
@@ -327,7 +354,7 @@ los puertos de geometrías externas únicamente cuando el modelo los solicita.
 También evita recorrer los materiales de geometrías compuestas en cada frame,
 refuerza la liberación de recursos y expone `getRenderStats()`.
 `0.1.24` incorporó geometry packs independientes, namespaces, parámetros
-personalizados, paletas locales, anchors e imágenes/iconos declarativos. La
+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