@liquidcars/atlas-geometry-math 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Atlas contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,57 @@
-# Temporary Holding Version
+# @liquidcars/atlas-geometry-math
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Matemáticas en vóxeles para LiquidCars Atlas. Primera versión: `0.1.0`.
+
+## Uso en Atlas
+
+```js
+import '@liquidcars/atlas';
+import '@liquidcars/atlas-geometry-math';
+```
+
+```yaml
+- id: example
+  name: Hito del conocimiento
+  geometry: math.euclid-elements
+  geometryOptions:
+    accent: "#8bbce7"
+```
+
+El punto de entrada raíz registra automáticamente el paquete mediante `registerGeometryPack`. Incluye catálogo, etiquetas, tamaños canónicos, parámetros y un `showcase`. Compatible y probado con `@liquidcars/atlas` **0.1.52**; la dependencia par se limita a la serie 0.1. La dependencia es opcional para consumidores de descriptores, pero Atlas debe estar instalado cuando se importa la raíz que registra el paquete.
+
+## Uso sin Atlas ni Three.js
+
+```js
+import {mathGeometryPack} from '@liquidcars/atlas-geometry-math/catalog';
+const geometry = mathGeometryPack.geometries.find(g => g.id === 'euclid-elements');
+const {parts} = geometry.create({parameters: {accent: '#8bbce7'}});
+```
+
+El catálogo es ESM y no necesita DOM, WebGL ni un motor 3D. Cada pieza declara `shape: box`, `size`, `position`, `rotation` (Euler XYZ en radianes), `color` y propiedades de material. Cada llamada crea datos independientes. El juego agrupa estas piezas mediante `InstancedMesh`; Atlas consume el mismo descriptor.
+
+`accent` está disponible en las figuras que utilizan un color principal configurable. Las demás conservan su paleta representativa.
+
+`canonicalSize` mantiene las proporciones de la figura, incluido su pedestal predeterminado. Las geometrías son interpretaciones visuales originales: no reconstrucciones exactas, reproducciones de pinturas ni afirmaciones de autoría histórica. Las fichas, fechas, preguntas y premios pertenecen a la aplicación consumidora.
+
+## Desarrollo
+
+Desde la raíz del repositorio:
+
+```sh
+npm ci
+npm test
+npm run build:geometry
+npm pack --workspace=@liquidcars/atlas-geometry-math
+```
+
+La publicación se hace desde el workspace, después de decidir visibilidad y validar el tarball. Los archivos construidos contienen los auxiliares comunes; no dependen de un tercer paquete interno ni de rutas del repositorio. Licencia MIT.
+
+## Catálogo
+
+| Identificador | Nombre |
+|---|---|
+| `math.plimpton-tablet` | Triángulos en arcilla |
+| `math.rhind-papyrus` | Problemas sobre papiro |
+| `math.pythagoras-triangle` | Triángulo rectángulo |
+| `math.euclid-elements` | Elementos de Euclides |
+| `math.apollonius-conics` | Cónicas de Apolonio |

package/catalog.js

@@ -0,0 +1,205 @@
+// packages/shared/voxel-parts.js
+function voxelBuilder(accent = "#8bbce7") {
+  const parts = [], ivory = "#eee9d0", metal = "#bd9c66", blue = "#85cee4", red = "#e58b82", green = "#8bc88c", gold = "#f1cd75", dark = "#30465c";
+  const block = (w, h, d, color, x, y, z, rotation = [0, 0, 0]) => parts.push({ shape: "box", size: [w, h, d], position: [x, y, z], rotation, color, edges: false, roughness: 0.72 });
+  function rod(a, b, size, color) {
+    const delta = b.map((v, i) => v - a[i]), length = Math.hypot(...delta);
+    if (!length) return;
+    const [dx, dy, dz] = delta.map((v) => v / length);
+    let x = dz, y = 0, z = -dx, w = 1 + dy;
+    if (w < 1e-12) {
+      x = 0;
+      y = 0;
+      z = 1;
+      w = 0;
+    }
+    const n = Math.hypot(x, y, z, w);
+    x /= n;
+    y /= n;
+    z /= n;
+    w /= n;
+    const m13 = 2 * (x * z + y * w), pitch = Math.asin(Math.max(-1, Math.min(1, m13)));
+    const rotation = Math.abs(m13) < 0.9999999 ? [Math.atan2(-2 * (y * z - x * w), 1 - 2 * (x * x + y * y)), pitch, Math.atan2(-2 * (x * y - z * w), 1 - 2 * (y * y + z * z))] : [Math.atan2(2 * (y * z + x * w), 1 - 2 * (x * x + z * z)), pitch, 0];
+    const c = a.map((v, i) => (v + b[i]) / 2);
+    block(size, length, size, color, ...c, rotation);
+  }
+  function loop(cx, cy, cz, rx, ry, color, plane = "xz", steps = 20) {
+    for (let i = 0; i < steps; i++) {
+      const a = i * Math.PI * 2 / steps, u = Math.cos(a) * rx, v = Math.sin(a) * ry;
+      block(0.095, 0.095, 0.095, color, cx + u, cy + (plane === "xy" ? v : 0), cz + (plane === "xz" ? v : 0));
+    }
+  }
+  function ball(x, y, z, color, r = 0.26) {
+    const step = 0.16;
+    for (let i = -2; i <= 2; i++) for (let j = -2; j <= 2; j++) for (let k = -2; k <= 2; k++) if (Math.hypot(i * step, j * step, k * step) <= r + 0.025) block(step * 0.93, step * 0.93, step * 0.93, color, x + i * step, y + j * step, z + k * step);
+  }
+  function book(x = 0, y = 0.52, z = 0) {
+    block(1.45, 0.13, 1.05, accent, x, y - 0.06, z);
+    block(0.66, 0.14, 0.93, ivory, x - 0.35, y + 0.06, z);
+    block(0.66, 0.14, 0.93, ivory, x + 0.35, y + 0.06, z);
+    block(0.04, 0.18, 0.98, metal, x, y + 0.07, z);
+  }
+  function flask(x, y, z, color = blue) {
+    for (const [yy, w] of [[0, 0.65], [0.2, 0.86], [0.4, 0.65]]) {
+      block(0.1, 0.23, 0.55, color, x - w / 2, y + yy, z);
+      block(0.1, 0.23, 0.55, color, x + w / 2, y + yy, z);
+    }
+    block(0.68, 0.1, 0.55, color, x, y - 0.1, z);
+    block(0.5, 0.22, 0.45, gold, x, y + 0.04, z);
+  }
+  block(2.65, 0.18, 2.2, dark, 0, 0.22, 0);
+  return { parts, block, rod, loop, ball, book, flask, accent, ivory, metal, blue, red, green, gold, dark };
+}
+function partsSize(parts) {
+  const min = [Infinity, Infinity, Infinity], max = [-Infinity, -Infinity, -Infinity];
+  for (const p of parts) {
+    const [rx, ry, rz] = p.rotation || [0, 0, 0], cx = Math.cos(rx), sx = Math.sin(rx), cy = Math.cos(ry), sy = Math.sin(ry), cz = Math.cos(rz), sz = Math.sin(rz);
+    for (const a of [-1, 1]) for (const b of [-1, 1]) for (const c of [-1, 1]) {
+      const [x, y, z] = [p.size[0] * a / 2, p.size[1] * b / 2, p.size[2] * c / 2];
+      const x1 = cz * x - sz * y, y1 = sz * x + cz * y;
+      const x2 = cy * x1 + sy * z, z2 = -sy * x1 + cy * z;
+      const v = [x2, cx * y1 - sx * z2, sx * y1 + cx * z2].map((n, i) => n + p.position[i]);
+      for (let i = 0; i < 3; i++) {
+        min[i] = Math.min(min[i], v[i]);
+        max[i] = Math.max(max[i], v[i]);
+      }
+    }
+  }
+  return max.map((v, i) => v - min[i]);
+}
+function defineVoxelGeometry(build, { id, kind, name, description, tags = [], accent = "#8bbce7", collection = "Conceptos" }) {
+  const initial = build(kind, { accent }), usesAccent = initial.some((part) => part.color === accent);
+  return {
+    id,
+    name,
+    description,
+    tags,
+    collection,
+    canonicalSize: partsSize(initial),
+    parameters: usesAccent ? { accent: { type: "color", label: "Color principal", default: accent } } : {},
+    create({ parameters = {}, colors = {} } = {}) {
+      return { parts: build(kind, { accent: parameters.accent || colors.accent || accent }) };
+    }
+  };
+}
+
+// packages/atlas-geometry-math/src/catalog.js
+function buildMathParts(kind, { accent = "#8bbce7" } = {}) {
+  const { parts, block, rod, loop, ball, book, ivory, metal, blue, red, green, gold, dark } = voxelBuilder(accent);
+  switch (kind) {
+    case "tablet": {
+      block(1.9, 1.35, 0.3, metal, 0, 1.12, 0);
+      for (let row = 0; row < 4; row++) for (let col = 0; col < 5; col++) {
+        block(0.15, 0.045, 0.05, dark, -0.7 + col * 0.33, 0.67 + row * 0.28, 0.18);
+        block(0.04, 0.12, 0.05, ivory, -0.66 + col * 0.33, 0.69 + row * 0.28, 0.19);
+      }
+      break;
+    }
+    case "scroll": {
+      block(1.6, 0.1, 1.25, ivory, 0, 0.5, 0);
+      for (const x of [-0.85, 0.85]) rod([x, 0.65, -0.7], [x, 0.65, 0.7], 0.25, gold);
+      for (let i = 0; i < 6; i++) block(0.9, 0.04, 0.045, metal, 0, 0.57, -0.45 + i * 0.18);
+      break;
+    }
+    case "triangles": {
+      rod([-0.9, 0.5, 0], [-0.9, 2, 0], 0.12, blue);
+      rod([-0.9, 0.5, 0], [0.9, 0.5, 0], 0.12, gold);
+      rod([-0.9, 2, 0], [0.9, 0.5, 0], 0.12, accent);
+      block(0.25, 0.07, 0.1, ivory, -0.75, 0.75, 0);
+      block(0.07, 0.25, 0.1, ivory, -0.62, 0.62, 0);
+      break;
+    }
+    case "geometry": {
+      loop(0, 1.2, 0, 0.92, 0.92, accent, "xy", 28);
+      rod([-0.92, 1.2, 0], [0.92, 1.2, 0], 0.09, gold);
+      rod([0, 0.4, 0.5], [0.5, 1.7, 0.5], 0.1, metal);
+      rod([0.5, 1.7, 0.5], [0.95, 0.4, 0.5], 0.1, metal);
+      break;
+    }
+    case "conics": {
+      for (let i = 0; i < 7; i++) {
+        const radius = 0.82 - i * 0.1;
+        loop(0, 0.6 + i * 0.21, 0, radius, radius, i === 3 ? accent : ivory, "xz", 16);
+      }
+      loop(0, 1.23, 0, 0.62, 0.32, gold, "xz", 20);
+      break;
+    }
+    default:
+      throw new RangeError("Unknown math geometry: " + kind);
+  }
+  return parts;
+}
+var entries = [
+  {
+    "id": "plimpton-tablet",
+    "kind": "tablet",
+    "name": "Tri\xE1ngulos en arcilla",
+    "description": "Tablilla matem\xE1tica de la tradici\xF3n babil\xF3nica.",
+    "tags": [
+      "matem\xE1ticas",
+      "Babilonia",
+      "tablillas"
+    ],
+    "accent": "#8bbce7",
+    "collection": "Hitos del conocimiento"
+  },
+  {
+    "id": "rhind-papyrus",
+    "kind": "scroll",
+    "name": "Problemas sobre papiro",
+    "description": "Papiro de la tradici\xF3n matem\xE1tica egipcia.",
+    "tags": [
+      "matem\xE1ticas",
+      "Egipto",
+      "papiros"
+    ],
+    "accent": "#8bbce7",
+    "collection": "Hitos del conocimiento"
+  },
+  {
+    "id": "pythagoras-triangle",
+    "kind": "triangles",
+    "name": "Tri\xE1ngulo rect\xE1ngulo",
+    "description": "Tri\xE1ngulo y comparaci\xF3n de sus lados.",
+    "tags": [
+      "matem\xE1ticas",
+      "geometr\xEDa",
+      "Pit\xE1goras"
+    ],
+    "accent": "#8bbce7",
+    "collection": "Hitos del conocimiento"
+  },
+  {
+    "id": "euclid-elements",
+    "kind": "geometry",
+    "name": "Elementos de Euclides",
+    "description": "C\xEDrculo, di\xE1metro y comp\xE1s geom\xE9trico.",
+    "tags": [
+      "matem\xE1ticas",
+      "geometr\xEDa",
+      "Euclides"
+    ],
+    "accent": "#8bbce7",
+    "collection": "Hitos del conocimiento"
+  },
+  {
+    "id": "apollonius-conics",
+    "kind": "conics",
+    "name": "C\xF3nicas de Apolonio",
+    "description": "Cono y sus secciones curvas.",
+    "tags": [
+      "matem\xE1ticas",
+      "geometr\xEDa",
+      "Apolonio"
+    ],
+    "accent": "#8bbce7",
+    "collection": "Hitos del conocimiento"
+  }
+];
+var mathGeometryPack = { namespace: "math", name: "Matem\xE1ticas en v\xF3xeles", version: "0.1.0", category: "Matem\xE1ticas", palette: { accent: "#8bbce7" }, showcase: { groups: [{ id: "knowledge", name: "Hitos del conocimiento", items: entries.map((e) => ({ id: e.id, name: e.name, geometry: e.id })) }] }, geometries: entries.map((entry) => defineVoxelGeometry(buildMathParts, entry)) };
+var mathModelIds = Object.freeze(Object.fromEntries(entries.map(({ kind, id }) => [kind, id])));
+export {
+  buildMathParts,
+  mathGeometryPack,
+  mathModelIds
+};

package/index.js

@@ -0,0 +1,9 @@
+// packages/atlas-geometry-math/src/index.js
+import { registerGeometryPack } from "@liquidcars/atlas";
+import { mathGeometryPack } from "./catalog.js";
+export * from "./catalog.js";
+registerGeometryPack(mathGeometryPack);
+var index_default = mathGeometryPack;
+export {
+  index_default as default
+};

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@liquidcars/atlas-geometry-math",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Mathematics voxel geometry pack for LiquidCars Atlas",
+  "type": "module",
+  "main": "./index.js",
+  "module": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./catalog": "./catalog.js"
+  },
+  "files": [
+    "index.js",
+    "catalog.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "./index.js"
+  ],
+  "peerDependencies": {
+    "@liquidcars/atlas": ">=0.1.52 <0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@liquidcars/atlas": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-geometry-packs.mjs",
+    "prepack": "node ../../scripts/build-geometry-packs.mjs"
+  },
+  "keywords": [
+    "liquidcars",
+    "atlas",
+    "3d",
+    "geometry-pack",
+    "math",
+    "voxel"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gaelibus/atlas-game.git",
+    "directory": "packages/atlas-geometry-math"
+  },
+  "homepage": "https://github.com/gaelibus/atlas-game#readme",
+  "bugs": {
+    "url": "https://github.com/gaelibus/atlas-game/issues"
+  }
+}