ldr 0.17.0 → 0.19.0

package/dist/node/promote.d.ts

@@ -9,3 +9,28 @@ export declare function promoteFlexParts(text: string): {
     text: string;
     promoted: string[];
 };
+export type DecimateFlexOptions = {
+    /** Merge every pair of adjacent ring quads (default true → 16-gon becomes 8-gon). */
+    halveRings?: boolean;
+    /** Minimum quads in a closed ring (default 8). */
+    minRing?: number;
+    /** Drop type-5 conditional lines in decimated parts (default true). */
+    dropCond?: boolean;
+    /** Drop type-4 quads not in a detected tube ring (rib fillet detail; default true). */
+    dropNonRing?: boolean;
+};
+/** Decimate tube rings in promoted flex `Unofficial_Part` files: 16→8 sides and drop non-ring rib detail. */
+export declare function decimateFlexGeometry(text: string, opts?: DecimateFlexOptions): {
+    text: string;
+    decimated: string[];
+    quadsIn: number;
+    quadsOut: number;
+};
+/** Promote LDCad flex files to embedded parts, then decimate tube rings (Round 35 + 37). */
+export declare function prepareFlexParts(text: string, decimate?: DecimateFlexOptions | false): {
+    text: string;
+    promoted: string[];
+    decimated: string[];
+    quadsIn: number;
+    quadsOut: number;
+};

package/dist/parts-cdn.d.ts

@@ -47,6 +47,10 @@ export interface PrepareOptions extends LoadPartsOptions {
     name?: string;
     /** Instruction-booklet step order for repeated submodels (see `FlattenOptions.callouts`). Default false. */
     callouts?: boolean;
+    /** Abort after parts are merged when full-detail body triangles exceed this (phones: avoid OOM). See `BudgetError`. */
+    maxBodyTris?: number;
+    /** Abort when the merged parts pack byte length exceeds this. See `BudgetError`. */
+    maxPackBytes?: number;
 }
 export interface PreparedModel {
     insts: PartInstance[];
@@ -62,5 +66,21 @@ export interface PreparedModel {
     };
     cull?: CullResult;
 }
+/** Full-detail body triangles across all instances that have a pack entry (sum of `part.body.tris`). */
+export declare function bodyTriangles(insts: PartInstance[], pack: Pack): number;
+/** Thrown by `prepareModel` / `loadModel` when `maxBodyTris` or `maxPackBytes` is set and the prepared model exceeds it. */
+export declare class BudgetError extends Error {
+    readonly code: "ldr-budget";
+    readonly bodyTris: number;
+    readonly packBytes: number;
+    readonly maxBodyTris?: number;
+    readonly maxPackBytes?: number;
+    constructor(m: {
+        bodyTris: number;
+        packBytes: number;
+        maxBodyTris?: number;
+        maxPackBytes?: number;
+    });
+}
 /** Everything in `loadModel` before three.js: fetch + parse the model, fetch + inflate + merge its parts. No DOM/three (runs in a Worker). */
 export declare function prepareModel(source: string, o?: PrepareOptions): Promise<PreparedModel>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ldr",
-  "version": "0.17.0",
+  "version": "0.19.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",