ldr 0.33.1 → 0.33.3

package/dist/node/library.d.ts

@@ -1,5 +1,7 @@
 import { type FlattenOptions, type LDrawColor } from "../model.js";
 import { type Doc, type PartMesh, type Instance } from "../spec.js";
+/** Most subfile placements + triangles one `mesh` may expand to (a few lines can nest subfiles that each place the next twice). */
+export declare const MESH_WORK_LIMIT = 1000000;
 export declare class Library {
     root: string;
     unofficialRoot?: string | undefined;
@@ -43,6 +45,14 @@ export declare class Library {
     /** Texture PNG bytes for a !TEXMAP name: an MPD `!DATA` block in `doc` first, then the LDraw search path with a
      *  `textures/` prefix (parts/, p/, models/, official then unofficial), then without it. Case-insensitive. */
     texture(name: string, doc?: Doc): Uint8Array | null;
+    /** Files being expanded by `emit` (a reference back to one is a cycle, which LDraw doesn't allow: ignored) and `emit`'s work so far. */
+    private open;
+    private work;
+    /** subfile walks + triangles one `mesh` may take before it throws `ModelLimitError` */
+    workLimit: number;
+    /** Every point of file `fname` of `doc` (type 2-5 lines, through its subfiles) has y = 0 (see `singularFix`). Past a work budget
+     *  (subfiles nested exponentially) the answer is no, so the placement is drawn without culling. */
+    private flatY;
     private emit;
     /** Flatten a model into part instances (see `flatten` in the browser entry for the rules; `models/` library files are walked
      *  as submodels). 24 handled at render (edge color). Alias parts resolve to canonical names. MPD files and synthetic parts

package/dist/spec.d.ts

@@ -101,6 +101,9 @@ export declare function namedColorCode(id: string): number;
 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;
+/** Largest coordinate / matrix entry the library places or draws: an LDraw line or a placement beyond it is out of range and ignored
+ *  (1e15 LDU is 400 million km; products of two such values stay finite in float32, so bounding boxes and GPU data stay finite). */
+export declare const MAX_COORD = 1000000000000000;
 /** 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;
 /** `geometryText`: keep type 2-5 lines as their source text (`src`) with empty `p` instead of parsing their numbers (for tools that
@@ -223,6 +226,19 @@ export declare function looseSource(f: LFile, step: number): string;
 export declare function hash32(s: string): string;
 /** Inverse of an affine LDraw matrix, or null when singular. */
 export declare function invert(m: M): M | null;
+/**
+ * BFC "Degenerate Matrices" (ldraw.org article 415): a subfile placed with a singular (determinant 0) matrix can't be culled.
+ * Returns null for a regular matrix. For a singular one: when the subfile lies in its own XZ plane (`flatY`: every point has y = 0),
+ * the Y column doesn't move any point, so the matrix is repaired the way LDView / L3P / LDGLite do (L3Input heritage, LDView
+ * `LDLModelLine::tryToFixPlanarMatrix`): an all-zero row gets 1 in its Y column (one row at a time), else an all-zero Y column gets 1s
+ * one row at a time; the repaired matrix (same points, determinant != 0) decides the winding and culling stays on. Otherwise culling
+ * is off for the subfile (`cull: false`). "Singular" = |det| at most 1e-9 of the product of the row lengths (the library's own
+ * near-singular references, e.g. 55297's discs at ~1e-6, keep their determinant's sign as before).
+ */
+export declare function singularFix(m: M, flatY: () => boolean): {
+    m: M;
+    cull: boolean;
+} | null;
 /**
  * Synthetic part for a part reference wrapped by a model-level `!TEXMAP` (the map is defined in the model, not in the part file).
  * `map` must already be in the part's own coordinates. The wrapper is a certified file that applies the map to the part, so

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ldr",
-  "version": "0.33.1",
+  "version": "0.33.3",
   "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",
@@ -50,6 +50,7 @@
   ],
   "scripts": {
     "build": "rm -rf dist && bun scripts/gen-worker.ts && bun scripts/build.ts && tsc -p tsconfig.build.json && bun scripts/postbuild.ts && node scripts/check-dist.mjs",
+    "fuzz": "bun fuzz/fuzz.ts",
     "test": "bun test",
     "prepublishOnly": "bun run build && bun test"
   },