ldr 0.25.0 → 0.26.1

package/README.md

@@ -93,7 +93,7 @@ Light the scene (or set `scene.environment`) as you would for any `MeshStandardM
 | `looseSteps` / `looseFile` / `looseSource` / `loosePartName` | A model's own type 2–5 geometry, per step, as synthetic parts named `<file>#<step>`. |
 | `rotStepMatrix` / `stepViewMatrix` / `fileStepViews` | ROTSTEP views, following MLCad: `REL`, `ADD`, `ABS`, `END`. A ROTSTEP ends its step. |
 | `parseTexMap` / `texmapUV` / `texmapTriangleUV` / `transformTexMap` / `resolveTexture` / `texWrapper` | `!TEXMAP` support (`PLANAR`, `CYLINDRICAL`, `SPHERICAL`). UV conventions follow LDView: v = 0 is the image's top row. |
-| `parseColor`, `isDirectColor`, `colorToken`, `mul`, `invert`, `IDENTITY`, `norm`, `smoothNormals`, `hash32` | Low-level helpers. |
+| `parseColor`, `isDirectColor`, `namedColorCode`, `isNamedColor`, `colorToken`, `mul`, `invert`, `IDENTITY`, `norm`, `smoothNormals`, `hash32` | Low-level helpers. |
 
 `FlattenOptions`:
 
@@ -211,6 +211,7 @@ Reproduce: `cd bench && bun run setup && bun run perf` (regression gate) or `bun
 - `!TEXMAP` `START`/`NEXT`/`FALLBACK`/`END`, with `PLANAR`, `CYLINDRICAL` and `SPHERICAL` projections (orientation matches LDView), `GLOSSMAP` (alpha = gloss amount, same UVs), and model-level `!TEXMAP` around part references.
 - Colours: LDConfig `!COLOUR`, edge colours, main/edge colour inheritance (16/24), and direct colours (`0x2RRGGBB`).
 - `!COLOUR` lines in a model follow the spec's scope rule. A definition applies from its line to the end of its file and to the files that file references, and it never leaks back to the parent. It sets the instance colour and finish. Colours hard-coded inside parts (printed parts, MPD-embedded parts) always come from LDConfig, because parts are precompiled.
+- Named colour codes: a `!COLOUR` CODE may be an identifier instead of a number (`0 !COLOUR My_Red CODE MyRed VALUE #FF0000 EDGE #333333`, then `1 myred ...`), which the spec allows outside strict LDraw compatibility. Identifiers are case-insensitive and follow the same scope rule. `parseColor` turns one into a stable negative code (`namedColorCode`, `isNamedColor`), and `colorToken` turns it back into the identifier. A named code with no definition in scope draws the fallback colour.
 - Blended colour codes 256-511 that LDConfig doesn't define (used by old models, e.g. 382 in Datsville) render as the spec's average of two ldraw.exe colours instead of the fallback grey.
 - Case-insensitive, backslash-normalized file lookup; `~Moved to` alias parts.
 

package/dist/cli.js

@@ -1,20 +1,38 @@
 #!/usr/bin/env node
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/cli.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/cli.ts
 import fs4 from "node:fs";
 import zlib from "node:zlib";
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/node/build-pack.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/node/build-pack.ts
 import fs3 from "node:fs";
 import path3 from "node:path";
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/node/resolver.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/node/resolver.ts
 import fs from "node:fs";
 import path from "node:path";
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/spec.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/spec.ts
 var norm = (s) => s.trim().toLowerCase().replace(/\\/g, "/").replace(/\/+/g, "/");
+var COLOUR_ID_RE = /^[A-Za-z][A-Za-z0-9_]*$/;
+var namedCodes = new Map;
+function namedColorCode(id) {
+  const s = id.toLowerCase();
+  let h = 2166136261;
+  for (let i = 0;i < s.length; i++) {
+    h ^= s.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  const c = -1 - (h >>> 0 & 1073741823);
+  if (!namedCodes.has(c))
+    namedCodes.set(c, s);
+  return c;
+}
+var isNamedColor = (c) => c < 0 && Number.isInteger(c);
 function parseColor(tok) {
+  const c0 = tok.charCodeAt(0) | 32;
+  if (c0 >= 97 && c0 <= 122 && COLOUR_ID_RE.test(tok))
+    return namedColorCode(tok);
   if (/^0x/i.test(tok))
     return parseInt(tok, 16);
   return +tok;
@@ -590,7 +608,7 @@ function looseSteps(f) {
   looseMemo.set(f, r);
   return r;
 }
-var colorToken = (c) => c > 16777215 ? "0x" + c.toString(16).toUpperCase() : String(c);
+var colorToken = (c) => c > 16777215 ? "0x" + c.toString(16).toUpperCase() : c < 0 ? namedCodes.get(c) ?? String(c) : String(c);
 var lineOf = (c) => c.t === 0 ? "0 " + c.text : c.t === 1 ? `1 ${colorToken(c.color)} ${c.m.join(" ")} ${c.file}` : c.src ? c.src : `${c.t} ${colorToken(c.color)} ${c.p.join(" ")}`;
 var loosePartName = (file, step) => `${norm(file)}#${step}`;
 function looseFile(f, step) {
@@ -705,7 +723,7 @@ function fileStepViews(f) {
   return out;
 }
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/model.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/model.ts
 var CALLOUT_END = 999999;
 var stepKey = (steps) => steps.map((x) => String(x).padStart(6, "0")).join(".") + "~";
 function flatten(doc, opts = {}) {
@@ -917,14 +935,14 @@ function parseColourLine(line) {
   if (tokens.length < 2)
     return null;
   const name = tokens[0];
-  let code = -1, hex = "#FF00FF", edge = "#333333", alpha = 255, luminance = 0;
+  let code = NaN, hex = "#FF00FF", edge = "#333333", alpha = 255, luminance = 0;
   let finish = { type: "default" };
   let i = 1;
   while (i < tokens.length) {
     const t = tokens[i].toUpperCase();
     const n = tokens[i + 1];
     if (t === "CODE") {
-      code = +n;
+      code = n !== undefined && COLOUR_ID_RE.test(n) ? namedColorCode(n) : n !== undefined && /^\d+$/.test(n) ? +n : NaN;
       i += 2;
     } else if (t === "VALUE") {
       const h = parseHexColor(n);
@@ -979,7 +997,7 @@ function parseColourLine(line) {
     } else
       i += 1;
   }
-  if (code < 0 || !hex)
+  if (Number.isNaN(code) || !hex)
     return null;
   return { code, name, hex, edge, alpha: Number.isFinite(alpha) ? alpha : 255, luminance: Number.isFinite(luminance) ? luminance : 0, finish };
 }
@@ -1088,7 +1106,7 @@ function blendedColourHex(code) {
   return "#" + [0, 1, 2].map((k) => (a[k] + b[k] >> 1).toString(16).padStart(2, "0")).join("").toUpperCase();
 }
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/node/resolver.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/node/resolver.ts
 var TOP_STUD_RE = /^(stud|studa|stud2|stud2a|stud6|stud6a|stud10|stud15|stud2s|stud2s2|stud-logo\d*|stud2-logo\d*)\.dat$/i;
 var UNDER_STUD_RE = /^(stud3|stud3a|stud4.*|stud12|stud16.*|stud18a)\.dat$/i;
 var norm2 = (ref) => ref.trim().replace(/\\/g, "/").toLowerCase();
@@ -1358,11 +1376,11 @@ function collectDeps(lib, refs) {
   return out;
 }
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/node/compile.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/node/compile.ts
 import fs2 from "node:fs";
 import path2 from "node:path";
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/node/lod.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/node/lod.ts
 import { MeshoptSimplifier, MeshoptEncoder } from "meshoptimizer";
 await Promise.all([MeshoptSimplifier.ready, MeshoptEncoder.ready]);
 function reorderMesh(P, N, C, I) {
@@ -1554,7 +1572,7 @@ function lodChain(P, C, I) {
   return out;
 }
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/node/compile.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/node/compile.ts
 function loadColors(root) {
   const map = new Map;
   for (const l of fs2.readFileSync(path2.join(root, "LDConfig.ldr"), "latin1").split(/\r?\n/)) {
@@ -2191,7 +2209,7 @@ function encodePack(parts, studKinds, weld, extra, options = {}) {
   return Buffer.concat([head, ...chunks.map((c) => new Uint8Array(c.buffer, c.byteOffset, c.byteLength))]);
 }
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/node/build-pack.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/node/build-pack.ts
 function buildPack(o) {
   const lib = new Library(o.ldrawRoot);
   const refs = new Map;
@@ -2259,7 +2277,7 @@ function buildPack(o) {
   return { data: encodePack(parts, kinds, comp.opts.weld, extra, { texture, lod: o.lod !== false, reorder: !!o.reorder }), parts: parts.size, studKinds: kinds.size, missing: [...missing], ...warnings.length ? { warnings } : {} };
 }
 
-// ../../../../../../../tmp/ldr-build-sxbVKM/src/cli.ts
+// ../../../../../../../tmp/ldr-build-NA1V7v/src/cli.ts
 var HELP = `ldr pack — build a parts pack for the ldr three.js renderer
 
 Usage:

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { parse, parseColor, isDirectColor, mul, I as IDENTITY, norm, smoothNormals, parseTexMap, texmapUV, texmapTriangleUV, transformTexMap, resolveTexture, fileKind, looseSteps, looseSource, looseFile, loosePartName, texWrapper, invert, hash32, colorToken, rotStepMatrix, stepViewMatrix, fileStepViews } from "./spec.js";
+export { parse, parseColor, isDirectColor, namedColorCode, isNamedColor, mul, I as IDENTITY, norm, smoothNormals, parseTexMap, texmapUV, texmapTriangleUV, transformTexMap, resolveTexture, fileKind, looseSteps, looseSource, looseFile, loosePartName, texWrapper, invert, hash32, colorToken, rotStepMatrix, stepViewMatrix, fileStepViews } from "./spec.js";
 export type { M as Matrix12, Doc, LFile, Cmd, RotStep, BufExchg, TexMap, TexMapCmd, TexMapMethod, TexAnno, DataBlock, PartMesh, FileKind, StepView } from "./spec.js";
 export { flatten, parseModel, sequenceSteps, stepKey, parseLDConfig, parseColourLine, colourSurface, colourMaterialKey, blendedColourHex, CALLOUT_END } from "./model.js";
 export { planStepViews, isolateMask, viewDir, instanceBoxes, MIN_VIS, REORIENT } from "./instructions.js";