ldr 0.14.0 → 0.15.0

package/dist/scene.d.ts

@@ -51,6 +51,10 @@ export interface LdrObjectOptions {
     /** LOD: skip undersides that can't be seen: while the camera is behind every bottom face of a cluster's (same-orientation) parts and
      *  studs are under 4 px, or where the body is drawn as its closed bounding box. Default true. */
     lodUnder?: boolean;
+    /** Progressive build (createLdrObjectAsync / loadModel): soft cap on contiguous main-thread work between yields, ms. Default 8. */
+    sliceMs?: number;
+    /** Progressive build: called after each yield; the live object already holds finished batches — render for TTFP. */
+    onSlice?: () => void | Promise<void>;
 }
 export interface LdrStats {
     instances: number;
@@ -61,6 +65,10 @@ export interface LdrStats {
     undersTotal: number;
     undersHidden: number;
     buildMs: number;
+    /** Progressive build: longest contiguous main-thread slice (ms). */
+    longestSliceMs?: number;
+    /** Progressive build: number of yields during scene construction. */
+    buildYields?: number;
     /** Conditional-line batches (draw calls) created; 0 for packs without conditional lines. */
     condBatches?: number;
     /** Textured batches (one per part x texture) and distinct textures; 0 for packs without textures. */
@@ -97,8 +105,18 @@ export interface LdrObject {
     getBox(target?: THREE.Box3): THREE.Box3;
     dispose(): void;
 }
+/**
+ * Build a three.js object for a flattened model using a parts pack.
+ * Instances whose part is not in the pack are skipped and listed in `stats.missing`.
+ */
 /**
  * Build a three.js object for a flattened model using a parts pack.
  * Instances whose part is not in the pack are skipped and listed in `stats.missing`.
  */
 export declare function createLdrObject(instances: PartInstance[], pack: Pack, options?: LdrObjectOptions): LdrObject;
+/**
+ * Progressive/async variant of `createLdrObject`: yields about every `sliceMs` (default 8) so the main thread stays responsive.
+ * Meshes land on `object` as batches finish; pass `onSlice` to render for a fast time-to-first-pixel.
+ * Final visuals and stats match the sync path (same generator).
+ */
+export declare function createLdrObjectAsync(instances: PartInstance[], pack: Pack, options?: LdrObjectOptions): Promise<LdrObject>;

package/package.json

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