ldr 0.24.2 → 0.26.0

package/dist/render.d.ts

@@ -1,12 +1,14 @@
 import * as THREE from 'three';
 import { decodePack, type Pack } from './pack-io.js';
-import { type ColourSurface } from './model.js';
+import { type ColourSurface, type LDrawColor } from './model.js';
 export { decodePack, type Pack };
 /** `edges`: LDraw edge lines, welded + indexed and sharing each batch's instance matrices (`'idx'` is the same as `true`).
  *  `cond`: draw type-5 conditional lines when the pack carries them (pack v2, built with `cond: true`) and edges are on. Default true.
  *  `condStuds`: also draw them on stud batches (stud silhouettes). Default true. Uncertified (no BFC) parts are always double-sided. */
 export type LdrParams = {
     cull?: CullResult;
+    /** Colours of instance colour keys that aren't table codes: model-level `0 !COLOUR` definitions (see `sceneInstances`). */
+    localColours?: Map<string, LDrawColor>;
     cullStuds: boolean;
     cullUnder: boolean;
     edges?: boolean | 'idx';

package/dist/scene.d.ts

@@ -1,7 +1,7 @@
 import * as THREE from "three";
 import { type Pack } from "./render.js";
 import { type CullResult } from "./cull.js";
-import type { PartInstance, LDrawColor } from "./model.js";
+import { type PartInstance, type LDrawColor } from "./model.js";
 import type { StepView } from "./spec.js";
 export type ColorSource = Map<number, string | LDrawColor> | Record<number | string, string | LDrawColor> | ((code: number) => THREE.ColorRepresentation | undefined);
 export interface LdrObjectOptions {

package/dist/spec.d.ts

@@ -87,7 +87,19 @@ export interface Doc {
     data?: Map<string, DataBlock>;
 }
 export declare const norm: (s: string) => string;
-/** Parse LDraw color token: decimal code, or direct color 0x2RRGGBB (and related 0xN…… forms). */
+/** `!COLOUR` identifier (article 299, "Syntax"): a-zA-Z0-9_, first character alphabetic; case-insensitive. */
+export declare const COLOUR_ID_RE: RegExp;
+/**
+ * Number for a named colour code: `0 !COLOUR name CODE x` where x is an identifier instead of 0-511 ("if strict LDraw compatibility
+ * is not required, x is any identifier recognized by a rendering program as a color code", article 299). Identifiers are
+ * case-insensitive, so `MyRed` and `myred` are one code. The number is negative (-1 - 30-bit FNV-1a of the lower-case text), so it
+ * never collides with a real code (0-511, direct colours 0x2RRGGBB...) and is the same in every thread / worker. `colorToken`
+ * turns it back into the identifier.
+ */
+export declare function namedColorCode(id: string): number;
+/** True for a named colour code from `namedColorCode` (negative), not a numeric LDraw code. */
+export declare const isNamedColor: (c: number) => boolean;
+/** Parse LDraw color token: decimal code, direct color 0x2RRGGBB (and related 0xN…… forms), or a `!COLOUR` identifier (see `namedColorCode`). */
 export declare function parseColor(tok: string): number;
 /** Parse the tail of `0 !TEXMAP START|NEXT <method> <params> <png> [GLOSSMAP <png>]`. Returns null when malformed. */
 export declare function parseTexMap(tail: string, next?: boolean): TexMap | null;
@@ -192,7 +204,7 @@ export type FileKind = "part" | "model";
 export declare function fileKind(doc: Doc, name: string): FileKind;
 /** Local steps (as counted by `flatten`) in which a file has its own type 2-5 lines or `0 !:` geometry, ascending. */
 export declare function looseSteps(f: LFile): number[];
-/** LDraw colour token for a colour code: decimal, or `0x2RRGGBB` for direct colours. */
+/** LDraw colour token for a colour code: decimal, `0x2RRGGBB` for direct colours, or the (lower-case) identifier of a named code. */
 export declare const colorToken: (c: number) => string;
 /** Name of the synthetic part holding a model file's own geometry in local step `step`: `<file>#<step>`. */
 export declare const loosePartName: (file: string, step: number) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ldr",
-  "version": "0.24.2",
+  "version": "0.26.0",
   "description": "High-performance LEGO (LDraw) rendering for three.js: instanced parts packs, hidden stud/tube culling, low-detail studs, indexed edges, build steps.",
   "license": "MIT",
   "author": "Evan Bacon",