ldr 0.6.0 → 0.8.0

package/dist/parts-cdn.d.ts

@@ -45,6 +45,8 @@ export interface PrepareOptions extends LoadPartsOptions {
     text?: boolean;
     /** File name used for the main model (MPD resolution). Default: last URL segment. */
     name?: string;
+    /** Instruction-booklet step order for repeated submodels (see `FlattenOptions.callouts`). Default false. */
+    callouts?: boolean;
 }
 export interface PreparedModel {
     insts: PartInstance[];

package/dist/render.d.ts

@@ -75,7 +75,7 @@ export declare function buildLdrScene(insts: Inst[], pack: Pack, P: LdrParams, c
     setEdges: (v: boolean) => void;
     setCond: (v: boolean) => void;
     setLod: (on: boolean) => void;
-    setStep: (s: number | null) => {
+    setStep: (s: number | null, mask?: ArrayLike<number | boolean> | null) => {
         studsTotal: number;
         studsHidden: number;
         undersTotal: number;

package/dist/scene.d.ts

@@ -79,8 +79,9 @@ export interface LdrObject {
      *  `stepViewMatrix(view, yourDefaultView)`; in three.js terms rotate the model by it inside the object's -Y-up flip. */
     stepViews: (StepView | null)[];
     /** Show instances up to and including `step` (null = all). No rebuild: instance buffers are compacted, and culling is step-aware
-     *  (a stud covered only by a later step's part stays visible). `stats` reflect the shown step. */
-    setStep(step: number | null): void;
+     *  (a stud covered only by a later step's part stays visible). `stats` reflect the shown step. With `mask` (per instance), only the
+     *  instances whose entry is truthy are shown, e.g. a sub-assembly on its own (an instruction callout; see `planStepViews`). */
+    setStep(step: number | null, mask?: ArrayLike<number | boolean> | null): void;
     setEdges(on: boolean): void;
     /** Resolves when the pack's textures (if any) are decoded and ready to render. */
     texturesReady: Promise<void>;

package/dist/spec.d.ts

@@ -126,6 +126,13 @@ export declare function texmapUV(map: TexMap, p: number[]): {
 export declare function texmapTriangleUV(map: TexMap, pts: number[][]): number[];
 /** Transform a TexMap's points by an LDraw matrix (e.g. into part space when the START lives in a subfile). */
 export declare function transformTexMap(map: TexMap, m: M): TexMap;
+/**
+ * "~Moved to" stubs whose own placement of the target breaks the models that use them; these resolve to the target as-is.
+ * 32531.dat (LDraw 2022-05) turns 32531a by 90 degrees, but 32531a is the old 32531 renamed (it carries its history), and
+ * 21 of the 24 OMR models in the demo catalog that use 32531 (76161-1, 10179-1, 10256-1, ...) only fit together without the turn:
+ * with it, each frame sits 3,000-30,000 LDU^3 inside its neighbours.
+ */
+export declare const STUB_OVERRIDES: Record<string, string>;
 export declare function mul(a: M, b: M): M;
 export declare const I: M;
 /** True if color is an LDraw direct color (0x2RRGGBB etc.), not a palette CODE. */

package/package.json

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