@chestnutlabs/gcode-model-renderer 0.11.0 → 0.13.0

package/dist/index.d.ts

@@ -21,5 +21,5 @@ export { computeCacheKey, defaultEnvId } from './cache-key.js';
 export { DEFAULT_LIMITS, resolveLimits, ModelParseError } from './limits.js';
 export type { ModelLimits, ResolvedLimits } from './limits.js';
 export { IDENTITY_MAT4 } from './scene-model.js';
-export type { ModelScene, ModelObject, ModelMaterial, MeshGeometry, ModelBounds, RGB, Mat4 } from './scene-model.js';
+export type { ModelScene, ModelObject, ModelMaterial, ModelPlateSummary, MeshGeometry, ModelBounds, RGB, Mat4 } from './scene-model.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAChH,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAChH,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,GAAG,EACH,IAAI,EACL,MAAM,kBAAkB,CAAC"}

package/dist/model-content.d.ts

@@ -28,8 +28,12 @@ export declare class ModelContent {
     private readonly disposables;
     private framedModel;
     constructor(scene: Scene);
-    /** Build meshes for the scene and record its framing. Replaces (and disposes) any previous meshes. */
-    setScene(scene: ModelScene): void;
+    /**
+     * Build meshes for the scene and record its framing. Replaces (and disposes) any previous meshes.
+     * `onObject(done)` (DD-024) is invoked after each object's mesh is built, with the running count, for
+     * real `building-geometry` progress.
+     */
+    setScene(scene: ModelScene, onObject?: (done: number) => void): void;
     /** The framing of the last-set scene (`null` before the first {@link setScene}). */
     get framing(): ModelFraming | null;
     private buildMesh;

package/dist/model-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-content.d.ts","sourceRoot":"","sources":["../src/model-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAWL,KAAK,EACL,OAAO,EACR,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAe,UAAU,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAKrE,yGAAyG;AACzG,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,WAAW,CAA6B;gBAEnB,KAAK,EAAE,KAAK;IAezC,sGAAsG;IACtG,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAWjC,oFAAoF;IACpF,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,CAEjC;IAED,OAAO,CAAC,SAAS;IAoCjB,OAAO,CAAC,WAAW;IAMnB,kGAAkG;IAClG,OAAO,IAAI,IAAI;CAGhB;AAED,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,EAAE,GAAmB,CAAC"}
+{"version":3,"file":"model-content.d.ts","sourceRoot":"","sources":["../src/model-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAWL,KAAK,EACL,OAAO,EACR,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAe,UAAU,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAKrE,yGAAyG;AACzG,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,WAAW,CAA6B;gBAEnB,KAAK,EAAE,KAAK;IAezC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAcpE,oFAAoF;IACpF,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,CAEjC;IAED,OAAO,CAAC,SAAS;IAoCjB,OAAO,CAAC,WAAW;IAMnB,kGAAkG;IAClG,OAAO,IAAI,IAAI;CAGhB;AAED,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,EAAE,GAAmB,CAAC"}

package/dist/model-content.js

@@ -37,11 +37,17 @@ export class ModelContent {
         fill.position.set(-0.7, 0.3, -0.5);
         this.scene.add(fill);
     }
-    /** Build meshes for the scene and record its framing. Replaces (and disposes) any previous meshes. */
-    setScene(scene) {
+    /**
+     * Build meshes for the scene and record its framing. Replaces (and disposes) any previous meshes.
+     * `onObject(done)` (DD-024) is invoked after each object's mesh is built, with the running count, for
+     * real `building-geometry` progress.
+     */
+    setScene(scene, onObject) {
         this.clearMeshes();
-        for (const obj of scene.objects)
-            this.root.add(this.buildMesh(obj));
+        for (let i = 0; i < scene.objects.length; i++) {
+            this.root.add(this.buildMesh(scene.objects[i]));
+            onObject?.(i + 1);
+        }
         const [minX, minY, minZ] = scene.bounds.min;
         const [maxX, maxY, maxZ] = scene.bounds.max;
         const center = new Vector3((minX + maxX) / 2, (minY + maxY) / 2, (minZ + maxZ) / 2);

package/dist/model-viewer.d.ts

@@ -1,9 +1,9 @@
-import { type CameraMode, type CameraState, type CameraView, type GLRendererLike, type InteractiveStageOptions, type RenderTargetCanvas } from '@chestnutlabs/gcode-renderer-three';
+import { type CameraMode, type CameraState, type CameraView, type GLRendererLike, type InteractiveStageOptions, type LoadProgress, type RenderTargetCanvas } from '@chestnutlabs/gcode-renderer-three';
 import type { Confidence } from '@chestnutlabs/toolpath-core';
 import { type ModelLoader, type ModelSourceInput } from './loaders.js';
 import { type ModelLimits } from './limits.js';
 import type { ModelBackground, PresentationView } from './model-renderer.js';
-import { type ModelBounds } from './scene-model.js';
+import { type ModelBounds, type ModelPlateSummary } from './scene-model.js';
 export interface ModelViewerOptions {
     /** Loader registry (open `kind`). Default: `[stlLoader, threeMfLoader]`. */
     loaders?: readonly ModelLoader[];
@@ -21,6 +21,12 @@ export interface ModelViewerOptions {
     createRenderer?: (canvas: RenderTargetCanvas) => GLRendererLike;
     /** Injected orbit controls (tests). Default: three `OrbitControls` via the stage. */
     createControls?: NonNullable<InteractiveStageOptions['createControls']>;
+    /**
+     * Staged loading-progress callback (DD-024): typed `stage`/`done`/`total`/`unit` events (no human copy),
+     * each tagged with the load `generation` so a consumer drops events from a superseded `setSource`. The
+     * consumer owns all wording/i18n. Events from a superseded load are not emitted.
+     */
+    onProgress?: (progress: LoadProgress) => void;
 }
 /** What the source actually carried, surfaced on `ready` (never fabricated — DD-001). */
 export interface ModelReadyInfo {
@@ -38,6 +44,15 @@ export interface ModelReadyInfo {
      * (DD-022 Phase 2); reserved so the field is stable.
      */
     decimationApplied: number;
+    /**
+     * Declared plate structure (DD-025), present only when the source explicitly declares plates
+     * (`capabilities.plates === 'known'`). A consumer builds a plate selector from `plates.list`; absent for a
+     * single/plate-less source. `active` is the source's declared active plate id when present.
+     */
+    plates?: {
+        list: ModelPlateSummary[];
+        active?: number;
+    };
 }
 export type ModelViewerEvent = {
     type: 'ready';

package/dist/model-viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-viewer.d.ts","sourceRoot":"","sources":["../src/model-viewer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model-viewer.d.ts","sourceRoot":"","sources":["../src/model-viewer.ts"],"names":[],"mappings":"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"}

package/dist/model-viewer.js

@@ -84,12 +84,23 @@ export function createModelViewer(canvas, options = {}) {
     }
     async function setSource(input) {
         const my = ++sourceToken;
+        // Progress is generation-scoped (DD-024 §4 D5): only emit while THIS load is current, so a superseded
+        // load can never advance the next load's progress. Typed fields only — no human copy.
+        const onProgress = options.onProgress;
+        const progress = (p) => {
+            if (onProgress !== undefined && my === sourceToken && !disposed)
+                onProgress({ ...p, generation: my });
+        };
         if (stage === null || disposed) {
             const message = disposed ? 'model viewer is disposed' : 'WebGL renderer unavailable';
             emit({ type: 'error', code: 'E_MODEL_RENDERER_UNAVAILABLE', message });
             throw new ModelParseError('E_MODEL_RENDERER_UNAVAILABLE', message);
         }
         try {
+            // Parse/resolve is a single opaque async step here (unzip + XML parse); its total is unknown ⇒ honest
+            // indeterminate, not a fabricated bar. Finer parse-stage counts are a later phase (threading into the
+            // loader/parser); Phase A closes the biggest gap — the model renderer had NO progress at all.
+            progress({ stage: 'parsing', indeterminate: true });
             const parsed = await resolveModelScene(input, loaders, limits, filamentPalette ? { filamentPalette } : undefined);
             const info = {
                 objectCount: parsed.objects.length,
@@ -98,14 +109,19 @@ export function createModelViewer(canvas, options = {}) {
                 instancedCount: sceneInstanceCount(parsed),
                 decimationApplied: 1
             };
+            if (parsed.plates !== undefined)
+                info.plates = parsed.plates;
             // Last-wins: a newer setSource (or a dispose) superseded this one — discard without mutating.
             if (my !== sourceToken || disposed || stage === null)
                 return info;
-            content.setScene(parsed);
+            const total = parsed.objects.length;
+            progress({ stage: 'building-geometry', done: 0, total, unit: 'objects' });
+            content.setScene(parsed, (done) => progress({ stage: 'building-geometry', done, total, unit: 'objects' }));
             currentScene = parsed;
             const f = content.framing;
             if (f !== null)
                 stage.frameTo(f.center, f.radius);
+            progress({ stage: 'ready' });
             emit({ type: 'ready', info });
             return info;
         }

package/dist/render-model-still.d.ts

@@ -13,7 +13,7 @@
 import type { Confidence } from '@chestnutlabs/toolpath-core';
 import type { GLRendererLike, RenderTargetCanvas } from '@chestnutlabs/gcode-renderer-three';
 import { type ModelBackground, type PresentationView } from './model-renderer.js';
-import { type ModelScene } from './scene-model.js';
+import { type ModelPlateSummary, type ModelScene } from './scene-model.js';
 import type { ModelLimits } from './limits.js';
 /**
  * A source model: STL bytes, 3MF bytes, or a pre-built `ModelScene`. This concrete union is the
@@ -64,6 +64,15 @@ export interface RenderModelStillResult {
      * size" the same way. Always 1 until model LOD lands (DD-022 Phase 2); reserved so the field is stable.
      */
     decimationApplied: number;
+    /**
+     * Declared plate structure (DD-025), present only when the source explicitly declares plates
+     * (`capabilities.plates === 'known'`); absent for a single/plate-less source. `active` is the source's
+     * declared active plate id when present.
+     */
+    plates?: {
+        list: ModelPlateSummary[];
+        active?: number;
+    };
     /** Stable identity for caching: `hash(source) + options + envId`. */
     cacheKey: string;
 }

package/dist/render-model-still.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-model-still.d.ts","sourceRoot":"","sources":["../src/render-model-still.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7F,OAAO,EAAiB,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEjG,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAAA;CAAE,GAChD,UAAU,CAAC;AAEf,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,qCAAqC;IACrC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,cAAc,CAAC;IAChE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAClD,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,SAAS,EAAE,UAAU,CAAC;IACtB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAkBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAmCjC"}
+{"version":3,"file":"render-model-still.d.ts","sourceRoot":"","sources":["../src/render-model-still.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7F,OAAO,EAAiB,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEjG,OAAO,EAAsB,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAAA;CAAE,GAChD,UAAU,CAAC;AAEf,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,qCAAqC;IACrC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,cAAc,CAAC;IAChE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAClD,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,SAAS,EAAE,UAAU,CAAC;IACtB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAkBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAoCjC"}

package/dist/render-model-still.js

@@ -45,6 +45,7 @@ export async function renderModelStill(source, options) {
             materials: scene.capabilities.materials,
             instancedCount: sceneInstanceCount(scene),
             decimationApplied: 1,
+            ...(scene.plates !== undefined ? { plates: scene.plates } : {}),
             cacheKey
         };
     }

package/dist/scene-model.d.ts

@@ -60,13 +60,48 @@ export interface ModelObject {
      * transforms (GPU instancing), so memory scales with unique geometry, not copy count.
      */
     instances?: Mat4[];
+    /**
+     * Per-**placement** plate membership (DD-025): `plateIds[i]` is the {@link ModelPlateSummary.id} (plater
+     * id) of placement `i` — aligned with {@link instances} when present, else index 0 is the single placement at
+     * {@link transform}. Plate membership lives on the placement, not the master, because the same reused
+     * master can be instantiated on more than one plate. Absent ⇒ the source declared no plate structure
+     * (`capabilities.plates: 'unavailable'`), never fabricated.
+     */
+    plateIds?: number[];
     /** Omitted ⇒ no source material ⇒ neutral default render + `capabilities.materials: 'unavailable'`. */
     material?: ModelMaterial;
 }
+/**
+ * One declared plate in a multi-plate source (DD-025), paralleling the toolpath-side `PlateSummary`.
+ * Present only when the source **explicitly** declares plate structure (Bambu/Orca
+ * `Metadata/model_settings.config`); an undeclared/implicit single plate is not summarized here.
+ */
+export interface ModelPlateSummary {
+    /** The source's plater id (`plater_id`), stable within the scene. */
+    id: number;
+    /** Source-declared plate name when present and non-empty. */
+    name?: string;
+    /** Distinct master objects referenced by this plate's placements (a master shared across plates counts in each). */
+    objectCount: number;
+    /** Placements assigned to this plate. */
+    instanceCount: number;
+    /** Axis-aligned bounds of this plate's placements, in scene units. */
+    bounds: ModelBounds;
+}
 /** A presentation scene: one or more objects plus capability honesty about what the source carried. */
 export interface ModelScene {
     objects: ModelObject[];
     bounds: ModelBounds;
+    /**
+     * Declared plate structure (DD-025). Present only when the source **explicitly** declares plates; a
+     * consumer shows a plate selector only when `capabilities.plates === 'known'`. `active` is the source's
+     * active/default plate id when declared (a consumer's natural initial selection — the renderer never
+     * forces all-plates).
+     */
+    plates?: {
+        list: ModelPlateSummary[];
+        active?: number;
+    };
     /** What the source actually carried (DD-001 ethos — never fabricated). */
     capabilities: {
         /** `'known'` when the source assigned colors/materials, else `'unavailable'`. */
@@ -78,6 +113,9 @@ export interface ModelScene {
         /** `'known'` when the source reused geometry via instances (more placements than unique masters), so
          *  the scene preserved it as GPU instancing (DD-022); `'unavailable'` otherwise. */
         instanced: Confidence;
+        /** `'known'` when the source **explicitly** declares plate structure (incl. an explicit single plate);
+         *  `'unavailable'` for undeclared/implicit plate structure (DD-025). */
+        plates: Confidence;
     };
 }
 /** The identity transform (column-major), for single-object sources. */

package/dist/scene-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-model.d.ts","sourceRoot":"","sources":["../src/scene-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,0BAA0B;AAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,iGAAiG;AACjG,MAAM,MAAM,IAAI,GAAG,SAAS,MAAM,EAAE,CAAC;AAErC,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,wGAAwG;AACxG,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,SAAS,EAAE,YAAY,CAAC;IACxB,kFAAkF;IAClF,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,iEAAiE;IACjE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,gGAAgG;AAChG,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,QAAQ,EAAE,YAAY,CAAC;IACvB,iGAAiG;IACjG,SAAS,EAAE,IAAI,CAAC;IAChB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACnB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,0EAA0E;IAC1E,YAAY,EAAE;QACZ,iFAAiF;QACjF,SAAS,EAAE,UAAU,CAAC;QACtB,sFAAsF;QACtF,UAAU,EAAE,UAAU,CAAC;QACvB,+DAA+D;QAC/D,WAAW,EAAE,UAAU,CAAC;QACxB;4FACoF;QACpF,SAAS,EAAE,UAAU,CAAC;KACvB,CAAC;CACH;AAED,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE,IAAuD,CAAC;AAEpF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAI5D"}
+{"version":3,"file":"scene-model.d.ts","sourceRoot":"","sources":["../src/scene-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,0BAA0B;AAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,iGAAiG;AACjG,MAAM,MAAM,IAAI,GAAG,SAAS,MAAM,EAAE,CAAC;AAErC,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,wGAAwG;AACxG,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,SAAS,EAAE,YAAY,CAAC;IACxB,kFAAkF;IAClF,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,iEAAiE;IACjE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,gGAAgG;AAChG,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,QAAQ,EAAE,YAAY,CAAC;IACvB,iGAAiG;IACjG,SAAS,EAAE,IAAI,CAAC;IAChB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oHAAoH;IACpH,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB;;;;;OAKG;IACH,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,0EAA0E;IAC1E,YAAY,EAAE;QACZ,iFAAiF;QACjF,SAAS,EAAE,UAAU,CAAC;QACtB,sFAAsF;QACtF,UAAU,EAAE,UAAU,CAAC;QACvB,+DAA+D;QAC/D,WAAW,EAAE,UAAU,CAAC;QACxB;4FACoF;QACpF,SAAS,EAAE,UAAU,CAAC;QACtB;gFACwE;QACxE,MAAM,EAAE,UAAU,CAAC;KACpB,CAAC;CACH;AAED,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE,IAAuD,CAAC;AAEpF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAI5D"}

package/dist/stl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stl.d.ts","sourceRoot":"","sources":["../src/stl.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsD,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB/E,0GAA0G;AAC1G,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,CAwD3F"}
+{"version":3,"file":"stl.d.ts","sourceRoot":"","sources":["../src/stl.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsD,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB/E,0GAA0G;AAC1G,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,CAyD3F"}

package/dist/stl.js

@@ -65,7 +65,8 @@ export function parseStl(source, limits) {
             materials: 'unavailable',
             transforms: 'unavailable',
             multiObject: 'unavailable',
-            instanced: 'unavailable'
+            instanced: 'unavailable',
+            plates: 'unavailable'
         }
     };
 }

package/dist/three-mf.d.ts

@@ -9,5 +9,34 @@ export interface Parse3mfOptions {
      */
     filamentPalette?: readonly (string | undefined)[];
 }
+/** Declared plate structure parsed from `Metadata/model_settings.config` (Bambu/Orca) — DD-025. */
+interface PlateConfig {
+    /** `${object_id}#${instance_id}` → plater_id, mapping each declared model-instance to its plate. */
+    membership: Map<string, number>;
+    /** plater_id → declared plate name (only non-empty names). */
+    names: Map<number, string>;
+    /** Declared plater_ids in source order. */
+    order: number[];
+}
+/**
+ * Parse the `<plate>` elements of a Bambu/Orca `Metadata/model_settings.config` (DD-025). Each `<plate>`
+ * carries a `plater_id` and a list of `<model_instance>` (`object_id` + `instance_id`) assigning the Nth
+ * placement of a build-item object to that plate. Clean-room from the observed format (parity with the
+ * RR-005 `paint_color` approach); tolerant scan — a malformed/absent config yields an empty result so the
+ * scene honestly reports `capabilities.plates: 'unavailable'` rather than a fabricated split.
+ *
+ * Returns `null` when no `<plate>` is declared (⇒ implicit single plate, `'unavailable'`).
+ */
+export declare function parsePlateConfig(xml: string): PlateConfig | null;
+/**
+ * Parse per-object / per-part extruder assignments from `Metadata/model_settings.config` (Bambu/Orca) — a
+ * source-model colour convention where each object/part is solid-coloured by its assigned filament
+ * (`<object id="X">…<metadata key="extruder" value="N"/>`, and the same on nested `<part id="Y">`),
+ * 1-based into the `filament_colour` palette. Returns a map of id → 1-based extruder. Each object/part's own
+ * extruder is the FIRST `key="extruder"` in the window from its header to the next object/part header (so a
+ * part's extruder overrides its parent object's default). Empty map ⇒ no assignments declared.
+ */
+export declare function parseObjectExtruders(xml: string): Map<string, number>;
 export declare function parse3mf(source: Uint8Array | ArrayBuffer, limits?: ModelLimits, opts?: Parse3mfOptions): Promise<ModelScene>;
+export {};
 //# sourceMappingURL=three-mf.d.ts.map

package/dist/three-mf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"three-mf.d.ts","sourceRoot":"","sources":["../src/three-mf.ts"],"names":[],"mappings":"AAqBA,OAAO,EAML,KAAK,UAAU,EAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAkC,KAAK,WAAW,EAAuB,MAAM,aAAa,CAAC;AAkbpG,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;CACnD;AA0FD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,GAAG,WAAW,EAChC,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC,UAAU,CAAC,CAyKrB"}
+{"version":3,"file":"three-mf.d.ts","sourceRoot":"","sources":["../src/three-mf.ts"],"names":[],"mappings":"AAqBA,OAAO,EAOL,KAAK,UAAU,EAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAkC,KAAK,WAAW,EAAuB,MAAM,aAAa,CAAC;AAofpG,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;CACnD;AAKD,mGAAmG;AACnG,UAAU,WAAW;IACnB,oGAAoG;IACpG,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,8DAA8D;IAC9D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAuBhE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAarE;AAyGD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,GAAG,WAAW,EAChC,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC,UAAU,CAAC,CAsNrB"}

package/dist/three-mf.js

@@ -315,6 +315,29 @@ function parseModelPart(xml, lim) {
     }
     return { objects, palettes, unitScale, items };
 }
+/**
+ * Record a placement's plate membership (DD-025): bump the plate's instance count, note the master it
+ * references (distinct-object count), and expand the plate's bounds by this placement's transformed AABB.
+ * A no-op when no plate is active (source declares no plates).
+ */
+function recordPlacementPlate(st, masterKey, localMin, localMax, affine) {
+    const p = st.currentPlateId;
+    if (p === undefined)
+        return;
+    st.plateInstanceCount.set(p, (st.plateInstanceCount.get(p) ?? 0) + 1);
+    let objs = st.plateObjects.get(p);
+    if (objs === undefined) {
+        objs = new Set();
+        st.plateObjects.set(p, objs);
+    }
+    objs.add(masterKey);
+    let b = st.plateBounds.get(p);
+    if (b === undefined) {
+        b = { min: [Infinity, Infinity, Infinity], max: [-Infinity, -Infinity, -Infinity] };
+        st.plateBounds.set(p, b);
+    }
+    expandBoundsByBox(b, localMin, localMax, affine);
+}
 /**
  * Place one mesh object (DD-022 instancing). The FIRST time a master `${partKey}#${objectid}` is reached
  * its geometry is built once in LOCAL space (unit-scaled, un-baked); every reach — first and repeats —
@@ -327,8 +350,11 @@ function placeMaster(obj, part, matrix, key, st, lim) {
     const existing = st.masters.get(key);
     if (existing !== undefined) {
         existing.instances.push(mat4);
+        if (st.currentPlateId !== undefined)
+            existing.plates.push(st.currentPlateId);
         st.totalInstances++;
         expandBoundsByBox(st, existing.localMin, existing.localMax, affine);
+        recordPlacementPlate(st, key, existing.localMin, existing.localMax, affine);
         return;
     }
     const triCount = obj.tris.length / 3;
@@ -403,12 +429,96 @@ function placeMaster(obj, part, matrix, key, st, lim) {
     const object = { id: key, geometry, transform: mat4 };
     if (obj.name !== undefined)
         object.name = obj.name;
-    st.masters.set(key, { object, instances: [mat4], localMin, localMax });
+    // Bambu/Orca per-object/part extruder solid colour (maintainer-approved): when the object declares no
+    // basematerials/colorgroup/paint colour, but the source assigns it an extruder and the project's
+    // `filament_colour` palette has that slot, colour the whole object with `palette[extruder - 1]` (a solid
+    // material colour). Honesty preserved: only when the source actually declares the mapping AND the palette
+    // resolves — otherwise the object stays neutral (`materials: 'unavailable'`). Never guessed.
+    if (!objHasColor && st.paintPalette.length > 0) {
+        const oid = key.substring(key.lastIndexOf('#') + 1);
+        const extruder = st.objectExtruders.get(oid);
+        if (extruder !== undefined) {
+            const col = st.paintPalette[extruder - 1];
+            if (col !== undefined) {
+                object.material = { color: col };
+                st.anyColor = true;
+            }
+        }
+    }
+    st.masters.set(key, {
+        object,
+        instances: [mat4],
+        plates: st.currentPlateId !== undefined ? [st.currentPlateId] : [],
+        localMin,
+        localMax
+    });
     st.built.push(object);
     st.totalInstances++;
     expandBoundsByBox(st, localMin, localMax, affine);
+    recordPlacementPlate(st, key, localMin, localMax, affine);
 }
 const hexPaletteToLinear = (hexes) => hexes.map((hex) => (hex !== undefined ? (srgbHexToLinear(hex) ?? [0.8, 0.8, 0.82]) : [0.8, 0.8, 0.82]));
+/**
+ * Parse the `<plate>` elements of a Bambu/Orca `Metadata/model_settings.config` (DD-025). Each `<plate>`
+ * carries a `plater_id` and a list of `<model_instance>` (`object_id` + `instance_id`) assigning the Nth
+ * placement of a build-item object to that plate. Clean-room from the observed format (parity with the
+ * RR-005 `paint_color` approach); tolerant scan — a malformed/absent config yields an empty result so the
+ * scene honestly reports `capabilities.plates: 'unavailable'` rather than a fabricated split.
+ *
+ * Returns `null` when no `<plate>` is declared (⇒ implicit single plate, `'unavailable'`).
+ */
+export function parsePlateConfig(xml) {
+    const plateBlocks = xml.match(/<plate\b[\s\S]*?<\/plate>/gi);
+    if (plateBlocks === null || plateBlocks.length === 0)
+        return null;
+    const membership = new Map();
+    const names = new Map();
+    const order = [];
+    for (const block of plateBlocks) {
+        const idM = /key="plater_id"\s+value="(\d+)"/i.exec(block);
+        if (idM === null)
+            continue;
+        const plateId = parseInt(idM[1], 10);
+        if (!Number.isFinite(plateId))
+            continue;
+        order.push(plateId);
+        const nameM = /key="plater_name"\s+value="([^"]*)"/i.exec(block);
+        if (nameM !== null && nameM[1].length > 0)
+            names.set(plateId, nameM[1]);
+        // Each <model_instance> declares object_id + instance_id (both required to key a placement).
+        for (const inst of block.match(/<model_instance\b[\s\S]*?<\/model_instance>/gi) ?? []) {
+            const objM = /key="object_id"\s+value="(\d+)"/i.exec(inst);
+            const insM = /key="instance_id"\s+value="(\d+)"/i.exec(inst);
+            if (objM === null || insM === null)
+                continue;
+            membership.set(`${objM[1]}#${insM[1]}`, plateId);
+        }
+    }
+    return order.length > 0 ? { membership, names, order } : null;
+}
+/**
+ * Parse per-object / per-part extruder assignments from `Metadata/model_settings.config` (Bambu/Orca) — a
+ * source-model colour convention where each object/part is solid-coloured by its assigned filament
+ * (`<object id="X">…<metadata key="extruder" value="N"/>`, and the same on nested `<part id="Y">`),
+ * 1-based into the `filament_colour` palette. Returns a map of id → 1-based extruder. Each object/part's own
+ * extruder is the FIRST `key="extruder"` in the window from its header to the next object/part header (so a
+ * part's extruder overrides its parent object's default). Empty map ⇒ no assignments declared.
+ */
+export function parseObjectExtruders(xml) {
+    const map = new Map();
+    const headerRe = /<(?:object|part)\s+id="(\d+)"[^>]*>([\s\S]*?)(?=<(?:object|part)\s+id="|<\/config>|$)/g;
+    let m;
+    while ((m = headerRe.exec(xml)) !== null) {
+        const id = m[1];
+        const ext = /key="extruder"\s+value="(\d+)"/i.exec(m[2]);
+        if (ext !== null) {
+            const n = parseInt(ext[1], 10);
+            if (Number.isFinite(n) && n >= 1)
+                map.set(id, n);
+        }
+    }
+    return map;
+}
 /**
  * Conservative UPPER bound on the XML bytes a single 3MF triangle (plus its amortized share of a shared
  * vertex) occupies — used to turn an external part's uncompressed byte size into a LOWER bound on its
@@ -428,17 +538,27 @@ const EST_REJECT_MARGIN = 2;
 /**
  * Fast structural cost estimate (DD-022 Phase 0), run after the (tiny, for production-extension files)
  * main part is parsed but BEFORE any large external geometry part is decompressed. Walks the build-item /
- * component tree counting instance placements and a lower-bound triangle estimate:
- *   - a mesh object's own triangles are counted exactly (already parsed);
- *   - an external `p:path` component is estimated from its ZIP-directory uncompressed size / the
- *     conservative bytes-per-triangle bound, and treated as a leaf (not recursed) — a safe under-count.
- * Throws {@link ModelParseError} for a clear instance-bomb / oversize file so it rejects in sub-second
- * time instead of ~10 s of decompress-and-bake. Files near the budget do not reject here — the exact
- * per-triangle limit in the real parse still applies.
+ * component tree counting **placements** (all of them) and a lower-bound **unique**-triangle estimate:
+ *   - a mesh master's triangles are counted **once per unique master** (already parsed), NOT per placement;
+ *   - an external `p:path` part is estimated from its ZIP-directory uncompressed size / the conservative
+ *     bytes-per-triangle bound, counted **once per unique path** (a safe under-count), treated as a leaf.
+ * Because instancing renders each master once (DD-022 Phase 1), the triangle estimate must be UNIQUE — a
+ * full-sheet plate of ~40 copies costs its ~1 master, not ~40× baked, so it is NOT rejected here. The
+ * placement count still guards an instance bomb (`maxInstances`). Throws {@link ModelParseError} for a
+ * clear instance-bomb / oversize file so it rejects in sub-second time instead of ~10 s of decompress-and-
+ * bake; files near the budget fall through to the exact per-triangle parse.
  */
 function estimateSceneCost(mainPart, entryByName, lim) {
     let instanceCount = 0;
     let estTriangles = 0;
+    // Unique masters already counted toward the triangle estimate (keyed by objectid / external path), so a
+    // reused master is counted once — matching the instanced render, not the old per-placement bake.
+    const countedMasters = new Set();
+    const checkInstances = () => {
+        if (instanceCount > lim.maxInstances) {
+            throw new ModelParseError('E_MODEL_TOO_MANY_INSTANCES', `3MF declares more than ${lim.maxInstances} instance placements`);
+        }
+    };
     const visit = (part, objectid, depth) => {
         if (depth > MAX_DEPTH)
             return;
@@ -447,23 +567,30 @@ function estimateSceneCost(mainPart, entryByName, lim) {
             return;
         if (obj.tris.length > 0) {
             instanceCount++;
-            estTriangles += obj.tris.length / 3;
+            const key = `local:${objectid}`;
+            if (!countedMasters.has(key)) {
+                countedMasters.add(key);
+                estTriangles += obj.tris.length / 3;
+            }
+            checkInstances();
         }
         for (const comp of obj.components) {
             if (comp.path !== undefined) {
                 // External production-extension part: estimate from its directory size WITHOUT decompressing it.
-                const entry = entryByName(comp.path.replace(/^\//, '').toLowerCase());
+                const norm = comp.path.replace(/^\//, '').toLowerCase();
+                const entry = entryByName(norm);
                 if (entry !== undefined) {
                     instanceCount++;
-                    estTriangles += entry.uncompressedSize / EST_MAX_BYTES_PER_TRIANGLE;
+                    if (!countedMasters.has(norm)) {
+                        countedMasters.add(norm);
+                        estTriangles += entry.uncompressedSize / EST_MAX_BYTES_PER_TRIANGLE;
+                    }
+                    checkInstances();
                 }
             }
             else {
                 visit(part, comp.objectid, depth + 1); // local sub-object (already-parsed geometry)
             }
-            if (instanceCount > lim.maxInstances) {
-                throw new ModelParseError('E_MODEL_TOO_MANY_INSTANCES', `3MF declares more than ${lim.maxInstances} instance placements`);
-            }
         }
     };
     const roots = mainPart.items.length > 0
@@ -562,8 +689,11 @@ export async function parse3mf(source, limits, opts) {
             }
         }
     }
-    // Default extruder (1-based) for a painted mesh's unpainted facets; from `model_settings.config`, else 1.
+    // `model_settings.config` (Bambu/Orca) carries both the default extruder for unpainted facets AND the
+    // declared plate structure (DD-025) — read once.
     let defaultExtruderIdx = 0;
+    let plateConfig = null;
+    let objectExtruders = new Map();
     const modelSettingsEntry = entryByName('metadata/model_settings.config');
     if (modelSettingsEntry !== undefined) {
         try {
@@ -572,9 +702,13 @@ export async function parse3mf(source, limits, opts) {
             const n = m !== null ? parseInt(m[1], 10) : NaN;
             if (Number.isFinite(n) && n >= 1)
                 defaultExtruderIdx = n - 1;
+            plateConfig = parsePlateConfig(xml);
+            objectExtruders = parseObjectExtruders(xml);
         }
         catch {
             defaultExtruderIdx = 0;
+            plateConfig = null;
+            objectExtruders = new Map();
         }
     }
     const st = {
@@ -588,7 +722,13 @@ export async function parse3mf(source, limits, opts) {
         min: [Infinity, Infinity, Infinity],
         max: [-Infinity, -Infinity, -Infinity],
         totalTris: 0,
-        totalInstances: 0
+        totalInstances: 0,
+        plateConfig,
+        objectExtruders,
+        currentPlateId: undefined,
+        plateBounds: new Map(),
+        plateInstanceCount: new Map(),
+        plateObjects: new Map()
     };
     // Resolve an object (mesh and/or components) within `part`, folding component transforms into the
     // running placement `matrix` (DD-022) instead of baking vertices. `partKey` identifies the part so the
@@ -618,21 +758,33 @@ export async function parse3mf(source, limits, opts) {
     const roots = mainPart.items.length > 0
         ? mainPart.items
         : [...mainPart.objects.keys()].map((objectid) => ({ objectid, transform: null }));
+    // Per-object-id ordinal so the Nth build item of object X maps to plate `X#N` (DD-025).
+    const rootOrdinals = new Map();
     for (const inst of roots) {
         if (inst.transform !== null)
             st.anyTransform = true;
+        if (st.plateConfig !== null) {
+            const ord = rootOrdinals.get(inst.objectid) ?? 0;
+            rootOrdinals.set(inst.objectid, ord + 1);
+            // Unmapped placement (declared plates but this one not listed) → the first declared plate, so
+            // plateIds stay complete and aligned; never fabricated silently beyond that fallback.
+            st.currentPlateId = st.plateConfig.membership.get(`${inst.objectid}#${ord}`) ?? st.plateConfig.order[0];
+        }
         await resolve(mainPart, inst.objectid, inst.transform, mainKey, 0);
     }
     if (st.built.length === 0)
         throw new ModelParseError('E_MODEL_EMPTY', '3MF contains no renderable geometry');
     // Attach the instance list to any master reached more than once (a single placement keeps its
-    // `transform` and omits `instances`, per the contract).
+    // `transform` and omits `instances`, per the contract). Plate ids (DD-025) attach per placement,
+    // aligned with `instances` when present, else the single placement.
     for (const rec of st.masters.values()) {
         if (rec.instances.length > 1)
             rec.object.instances = rec.instances;
+        if (rec.plates.length > 0)
+            rec.object.plateIds = rec.plates;
     }
     const bounds = { min: st.min, max: st.max };
-    return {
+    const scene = {
         objects: st.built,
         bounds,
         capabilities: {
@@ -641,7 +793,27 @@ export async function parse3mf(source, limits, opts) {
             transforms: st.anyTransform ? 'known' : 'unavailable',
             multiObject: st.built.length > 1 ? 'known' : 'unavailable',
             // Instancing preserved when there are more placements than unique masters.
-            instanced: st.totalInstances > st.masters.size ? 'known' : 'unavailable'
+            instanced: st.totalInstances > st.masters.size ? 'known' : 'unavailable',
+            // Plate structure is `known` only when the source explicitly declared plates (DD-025).
+            plates: st.plateConfig !== null ? 'known' : 'unavailable'
         }
     };
+    const pc = st.plateConfig;
+    if (pc !== null) {
+        const list = pc.order.map((id) => {
+            const b = st.plateBounds.get(id);
+            const summary = {
+                id,
+                objectCount: st.plateObjects.get(id)?.size ?? 0,
+                instanceCount: st.plateInstanceCount.get(id) ?? 0,
+                bounds: b !== undefined ? { min: b.min, max: b.max } : { min: [0, 0, 0], max: [0, 0, 0] }
+            };
+            const name = pc.names.get(id);
+            if (name !== undefined)
+                summary.name = name;
+            return summary;
+        });
+        scene.plates = { list };
+    }
+    return scene;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chestnutlabs/gcode-model-renderer",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Three.js presentation renderer for source models (STL/3MF) — clean thumbnails/cards, distinct from toolpath inspection (DD-018).",
   "keywords": [
     "3d-printing",
@@ -51,9 +51,9 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@chestnutlabs/gcode-containers": "0.11.0",
-    "@chestnutlabs/gcode-renderer-three": "0.11.0",
-    "@chestnutlabs/toolpath-core": "0.11.0"
+    "@chestnutlabs/gcode-containers": "0.13.0",
+    "@chestnutlabs/gcode-renderer-three": "0.13.0",
+    "@chestnutlabs/toolpath-core": "0.13.0"
   },
   "devDependencies": {
     "@types/three": "0.178.0"