@chestnutlabs/gcode-model-renderer 0.10.0 → 0.12.0

package/dist/limits.d.ts

@@ -9,11 +9,19 @@ export interface ModelLimits {
     maxObjects?: number;
     /** Max source bytes accepted before parsing. Default 256 MiB. */
     maxSourceBytes?: number;
+    /**
+     * Max total instance placements across the scene (DD-022): a source 3MF that reuses meshes via
+     * production-extension components / repeated build items is bounded on placement count, so an "instance
+     * bomb" (a tiny master referenced millions of times) is rejected cheaply from the structure — before any
+     * large geometry part is decompressed. Default 50,000.
+     */
+    maxInstances?: number;
 }
 export interface ResolvedLimits {
     maxTriangles: number;
     maxObjects: number;
     maxSourceBytes: number;
+    maxInstances: number;
 }
 export declare const DEFAULT_LIMITS: ResolvedLimits;
 export declare function resolveLimits(limits?: ModelLimits): ResolvedLimits;

package/dist/limits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,cAAc,EAAE,cAI5B,CAAC;AAEF,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAMlE;AAED,6DAA6D;AAC7D,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C"}
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,cAAc,EAAE,cAK5B,CAAC;AAEF,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAOlE;AAED,6DAA6D;AAC7D,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C"}

package/dist/limits.js

@@ -1,13 +1,15 @@
 export const DEFAULT_LIMITS = {
     maxTriangles: 5_000_000,
     maxObjects: 10_000,
-    maxSourceBytes: 256 * 1024 * 1024
+    maxSourceBytes: 256 * 1024 * 1024,
+    maxInstances: 50_000
 };
 export function resolveLimits(limits) {
     return {
         maxTriangles: limits?.maxTriangles ?? DEFAULT_LIMITS.maxTriangles,
         maxObjects: limits?.maxObjects ?? DEFAULT_LIMITS.maxObjects,
-        maxSourceBytes: limits?.maxSourceBytes ?? DEFAULT_LIMITS.maxSourceBytes
+        maxSourceBytes: limits?.maxSourceBytes ?? DEFAULT_LIMITS.maxSourceBytes,
+        maxInstances: limits?.maxInstances ?? DEFAULT_LIMITS.maxInstances
     };
 }
 /** A bounded, structured model-parse failure (DD-018 §6). */

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,EAQL,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;IAwBjB,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,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"}

package/dist/model-content.js

@@ -9,7 +9,7 @@
  * DD-021) build meshes and lighting through **one** path instead of parallel copies. The still keeps its
  * own GL + camera; the viewer drives the shared `InteractiveStage`. Both hand this class a `Scene`.
  */
-import { BufferAttribute, BufferGeometry, DirectionalLight, Group, HemisphereLight, Mesh, MeshStandardMaterial, Vector3 } from 'three';
+import { BufferAttribute, BufferGeometry, DirectionalLight, Group, HemisphereLight, InstancedMesh, Matrix4, Mesh, MeshStandardMaterial, Vector3 } from 'three';
 /** Neutral default surface when the source declares no material (never a fabricated source color). */
 const NEUTRAL_COLOR = [0.8, 0.8, 0.82];
 /**
@@ -71,10 +71,21 @@ export class ModelContent {
             const color = obj.material?.color ?? NEUTRAL_COLOR;
             mat.color.setRGB(color[0], color[1], color[2]);
         }
+        this.disposables.push(g, mat);
+        // A master reused across placements (DD-022) → one geometry upload, drawn once per instance matrix.
+        if (obj.instances !== undefined && obj.instances.length > 1) {
+            const inst = new InstancedMesh(g, mat, obj.instances.length);
+            const m = new Matrix4();
+            for (let i = 0; i < obj.instances.length; i++) {
+                inst.setMatrixAt(i, m.fromArray(obj.instances[i]));
+            }
+            inst.instanceMatrix.needsUpdate = true;
+            this.disposables.push(inst);
+            return inst;
+        }
         const mesh = new Mesh(g, mat);
         mesh.matrixAutoUpdate = false;
         mesh.matrix.fromArray(obj.transform);
-        this.disposables.push(g, mat);
         return mesh;
     }
     clearMeshes() {

package/dist/model-viewer.d.ts

@@ -3,7 +3,7 @@ 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 } from './scene-model.js';
 export interface ModelViewerOptions {
     /** Loader registry (open `kind`). Default: `[stlLoader, threeMfLoader]`. */
     loaders?: readonly ModelLoader[];
@@ -27,6 +27,17 @@ export interface ModelReadyInfo {
     objectCount: number;
     materials: Confidence;
     bounds: ModelBounds;
+    /**
+     * Total instance placements drawn (DD-022): > `objectCount` when the source reused geometry, for an "N
+     * copies" badge. 1 per object when nothing is reused.
+     */
+    instancedCount: number;
+    /**
+     * Every-Nth-triangle decimation applied to fit the LOD budget (1 = none). Field-parallel to the toolpath
+     * `decimationApplied` so a card badges "simplified for size" the same way. Always 1 until model LOD lands
+     * (DD-022 Phase 2); reserved so the field is stable.
+     */
+    decimationApplied: 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

@@ -17,6 +17,7 @@ import { InteractiveStage, createDefaultGLRenderer } from '@chestnutlabs/gcode-r
 import { ModelContent } from './model-content.js';
 import { DEFAULT_MODEL_LOADERS, resolveModelScene } from './loaders.js';
 import { ModelParseError } from './limits.js';
+import { sceneInstanceCount } from './scene-model.js';
 function backgroundColor(bg) {
     return bg === 'transparent' ? null : new Color(bg);
 }
@@ -93,7 +94,9 @@ export function createModelViewer(canvas, options = {}) {
             const info = {
                 objectCount: parsed.objects.length,
                 materials: parsed.capabilities.materials,
-                bounds: parsed.bounds
+                bounds: parsed.bounds,
+                instancedCount: sceneInstanceCount(parsed),
+                decimationApplied: 1
             };
             // Last-wins: a newer setSource (or a dispose) superseded this one — discard without mutating.
             if (my !== sourceToken || disposed || stage === null)

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 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
@@ -53,6 +53,17 @@ export interface RenderModelStillResult {
     objectCount: number;
     /** Whether source colors/materials were real — `'unavailable'` means the neutral default was used. */
     materials: Confidence;
+    /**
+     * Total instance placements drawn (DD-022): > `objectCount` when the source reused geometry (a
+     * full-sheet plate of repeated copies), for an "N copies" badge. 1 per object when nothing is reused.
+     */
+    instancedCount: number;
+    /**
+     * Every-Nth-triangle decimation applied to fit the LOD budget (1 = none, layer/geometry detail full).
+     * Field-parallel to the toolpath `RenderStillResult.decimationApplied` so a card badges "simplified for
+     * size" the same way. Always 1 until model LOD lands (DD-022 Phase 2); reserved so the field is stable.
+     */
+    decimationApplied: 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,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,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,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,CAiCjC"}
+{"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"}

package/dist/render-model-still.js

@@ -1,5 +1,6 @@
 import { ModelRenderer } from './model-renderer.js';
 import { isModelScene, resolveModelScene } from './loaders.js';
+import { sceneInstanceCount } from './scene-model.js';
 import { computeCacheKey } from './cache-key.js';
 async function toScene(source, limits, filamentPalette) {
     if (isModelScene(source)) {
@@ -42,6 +43,8 @@ export async function renderModelStill(source, options) {
             height,
             objectCount: scene.objects.length,
             materials: scene.capabilities.materials,
+            instancedCount: sceneInstanceCount(scene),
+            decimationApplied: 1,
             cacheKey
         };
     }

package/dist/scene-model.d.ts

@@ -45,9 +45,21 @@ export interface ModelObject {
     id: string;
     /** Source-declared object name when present. */
     name?: string;
+    /**
+     * Geometry in the object's own local space when {@link instances} is present (the placements position
+     * it); otherwise positioned by {@link transform}. A bare STL / single-placement object leaves it as the
+     * source geometry.
+     */
     geometry: MeshGeometry;
-    /** Object→scene transform (identity for STL). */
+    /** Object→scene transform (identity for STL). For an instanced master, equals `instances[0]`. */
     transform: Mat4;
+    /**
+     * All scene-space placements of this master mesh — production-extension components / repeated build
+     * items that reuse the same geometry (DD-022). Present only when the source reused the mesh (length ≥ 2);
+     * absent ⇒ a single placement at {@link transform}. A renderer draws one geometry upload across these
+     * transforms (GPU instancing), so memory scales with unique geometry, not copy count.
+     */
+    instances?: Mat4[];
     /** Omitted ⇒ no source material ⇒ neutral default render + `capabilities.materials: 'unavailable'`. */
     material?: ModelMaterial;
 }
@@ -63,8 +75,17 @@ export interface ModelScene {
         transforms: Confidence;
         /** `'known'` when the source declared more than one object. */
         multiObject: Confidence;
+        /** `'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;
     };
 }
 /** The identity transform (column-major), for single-object sources. */
 export declare const IDENTITY_MAT4: Mat4;
+/**
+ * Total placements drawn across a scene (DD-022): the sum of each object's instance count (a reused
+ * master counts its `instances`, a single-placement object counts 1). Reported on `ready` / the still
+ * result so a consumer can badge "N copies".
+ */
+export declare function sceneInstanceCount(scene: ModelScene): number;
 //# sourceMappingURL=scene-model.d.ts.map

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,QAAQ,EAAE,YAAY,CAAC;IACvB,iDAAiD;IACjD,SAAS,EAAE,IAAI,CAAC;IAChB,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;KACzB,CAAC;CACH;AAED,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE,IAAuD,CAAC"}
+{"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"}

package/dist/scene-model.js

@@ -1,2 +1,13 @@
 /** The identity transform (column-major), for single-object sources. */
 export const IDENTITY_MAT4 = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+/**
+ * Total placements drawn across a scene (DD-022): the sum of each object's instance count (a reused
+ * master counts its `instances`, a single-placement object counts 1). Reported on `ready` / the still
+ * result so a consumer can badge "N copies".
+ */
+export function sceneInstanceCount(scene) {
+    let n = 0;
+    for (const o of scene.objects)
+        n += o.instances?.length ?? 1;
+    return n;
+}

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,CAmD3F"}
+{"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"}

package/dist/stl.js

@@ -61,7 +61,12 @@ export function parseStl(source, limits) {
     return {
         objects: [{ id: 'stl', geometry, transform: IDENTITY_MAT4 }],
         bounds,
-        capabilities: { materials: 'unavailable', transforms: 'unavailable', multiObject: 'unavailable' }
+        capabilities: {
+            materials: 'unavailable',
+            transforms: 'unavailable',
+            multiObject: 'unavailable',
+            instanced: 'unavailable'
+        }
     };
 }
 function boundsOf(positions) {

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,EAKL,KAAK,UAAU,EAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAkC,KAAK,WAAW,EAAuB,MAAM,aAAa,CAAC;AA4VpG,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;CACnD;AAKD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,GAAG,WAAW,EAChC,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC,UAAU,CAAC,CAwJrB"}
+{"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;AA4GD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,GAAG,WAAW,EAChC,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC,UAAU,CAAC,CAyKrB"}

package/dist/three-mf.js

@@ -139,12 +139,64 @@ function applyTransform(v, x, y, z) {
         v[2] * x + v[5] * y + v[8] * z + v[11]
     ];
 }
-/** Apply a chain of transforms in order (innermost first): comp → … → build item. */
-function applyChain(chain, x, y, z) {
-    let p = [x, y, z];
-    for (const t of chain)
-        p = applyTransform(t, p[0], p[1], p[2]);
-    return p;
+/** The identity 3MF row-vector affine (12 values). */
+const IDENTITY_AFFINE = [1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0];
+/**
+ * Compose two 3MF affines so the result applies `inner` first, then `outer`:
+ * `compose(outer, inner)(p) = outer(inner(p))`. Used to fold a component transform into the running
+ * placement matrix while descending the assembly tree, without baking vertices (DD-022 instancing).
+ */
+function composeAffine(outer, inner) {
+    const lin = (x, y, z) => [
+        outer[0] * x + outer[3] * y + outer[6] * z,
+        outer[1] * x + outer[4] * y + outer[7] * z,
+        outer[2] * x + outer[5] * y + outer[8] * z
+    ];
+    const c0 = lin(inner[0], inner[1], inner[2]);
+    const c1 = lin(inner[3], inner[4], inner[5]);
+    const c2 = lin(inner[6], inner[7], inner[8]);
+    const t = lin(inner[9], inner[10], inner[11]);
+    return [
+        c0[0],
+        c0[1],
+        c0[2],
+        c1[0],
+        c1[1],
+        c1[2],
+        c2[0],
+        c2[1],
+        c2[2],
+        t[0] + outer[9],
+        t[1] + outer[10],
+        t[2] + outer[11]
+    ];
+}
+/** A 3MF row-vector affine (12 values), or null = identity, → a column-major {@link Mat4} (three layout). */
+function affineToMat4(v) {
+    if (v === null)
+        return IDENTITY_MAT4;
+    return [v[0], v[1], v[2], 0, v[3], v[4], v[5], 0, v[6], v[7], v[8], 0, v[9], v[10], v[11], 1];
+}
+/** Expand `st.min`/`st.max` by a local AABB [min,max] transformed by `affine` (its 8 corners). */
+function expandBoundsByBox(st, bmin, bmax, affine) {
+    for (let c = 0; c < 8; c++) {
+        const x = (c & 1) === 0 ? bmin[0] : bmax[0];
+        const y = (c & 2) === 0 ? bmin[1] : bmax[1];
+        const z = (c & 4) === 0 ? bmin[2] : bmax[2];
+        const [wx, wy, wz] = applyTransform(affine, x, y, z);
+        if (wx < st.min[0])
+            st.min[0] = wx;
+        if (wy < st.min[1])
+            st.min[1] = wy;
+        if (wz < st.min[2])
+            st.min[2] = wz;
+        if (wx > st.max[0])
+            st.max[0] = wx;
+        if (wy > st.max[1])
+            st.max[1] = wy;
+        if (wz > st.max[2])
+            st.max[2] = wz;
+    }
 }
 /** Parse ONE model part's XML into objects/palettes/items (no cross-part resolution). */
 function parseModelPart(xml, lim) {
@@ -263,8 +315,22 @@ function parseModelPart(xml, lim) {
     }
     return { objects, palettes, unitScale, items };
 }
-/** Bake one mesh object (its own triangles) into a `ModelObject`, applying the transform chain. */
-function bakeMesh(obj, part, chain, id, st, lim) {
+/**
+ * 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 —
+ * records the placement `matrix` as an instance and expands the scene bounds by the master's local AABB
+ * transformed by that matrix. So memory + the triangle budget scale with unique geometry, not copy count.
+ */
+function placeMaster(obj, part, matrix, key, st, lim) {
+    const affine = matrix ?? IDENTITY_AFFINE;
+    const mat4 = affineToMat4(matrix);
+    const existing = st.masters.get(key);
+    if (existing !== undefined) {
+        existing.instances.push(mat4);
+        st.totalInstances++;
+        expandBoundsByBox(st, existing.localMin, existing.localMax, affine);
+        return;
+    }
     const triCount = obj.tris.length / 3;
     st.totalTris += triCount;
     if (st.totalTris > lim.maxTriangles) {
@@ -273,6 +339,8 @@ function bakeMesh(obj, part, chain, id, st, lim) {
     const positions = new Float32Array(triCount * 9);
     let colors = null;
     let objHasColor = false;
+    const localMin = [Infinity, Infinity, Infinity];
+    const localMax = [-Infinity, -Infinity, -Infinity];
     // A mesh painted with Bambu/Orca `paint_color` (only meaningful when we have a filament palette).
     const objHasPaint = st.paintPalette.length > 0 && obj.triPaint.some((p) => p !== null);
     for (let ti = 0; ti < triCount; ti++) {
@@ -298,23 +366,26 @@ function bakeMesh(obj, part, chain, id, st, lim) {
         const cidx = obj.triColorIdx[ti];
         for (let k = 0; k < 3; k++) {
             const vi = obj.tris[ti * 3 + k] * 3;
-            const [x, y, z] = applyChain(chain, obj.vertices[vi] * part.unitScale, obj.vertices[vi + 1] * part.unitScale, obj.vertices[vi + 2] * part.unitScale);
+            // LOCAL geometry: unit scale only — the placement matrix (an instance transform) does the rest.
+            const x = obj.vertices[vi] * part.unitScale;
+            const y = obj.vertices[vi + 1] * part.unitScale;
+            const z = obj.vertices[vi + 2] * part.unitScale;
             const o = (ti * 3 + k) * 3;
             positions[o] = x;
             positions[o + 1] = y;
             positions[o + 2] = z;
-            if (x < st.min[0])
-                st.min[0] = x;
-            if (y < st.min[1])
-                st.min[1] = y;
-            if (z < st.min[2])
-                st.min[2] = z;
-            if (x > st.max[0])
-                st.max[0] = x;
-            if (y > st.max[1])
-                st.max[1] = y;
-            if (z > st.max[2])
-                st.max[2] = z;
+            if (x < localMin[0])
+                localMin[0] = x;
+            if (y < localMin[1])
+                localMin[1] = y;
+            if (z < localMin[2])
+                localMin[2] = z;
+            if (x > localMax[0])
+                localMax[0] = x;
+            if (y > localMax[1])
+                localMax[1] = y;
+            if (z > localMax[2])
+                localMax[2] = z;
             const col = paintCol ?? (palette !== undefined && cidx !== null ? (palette[cidx[k]] ?? palette[0]) : undefined);
             if (col !== undefined) {
                 if (colors === null)
@@ -329,12 +400,101 @@ function bakeMesh(obj, part, chain, id, st, lim) {
     if (objHasColor)
         st.anyColor = true;
     const geometry = colors !== null ? { positions, colors } : { positions };
-    const built = { id, geometry, transform: IDENTITY_MAT4 };
+    const object = { id: key, geometry, transform: mat4 };
     if (obj.name !== undefined)
-        built.name = obj.name;
-    st.built.push(built);
+        object.name = obj.name;
+    st.masters.set(key, { object, instances: [mat4], localMin, localMax });
+    st.built.push(object);
+    st.totalInstances++;
+    expandBoundsByBox(st, 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]));
+/**
+ * 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
+ * triangle count (DD-022 §5/§13). Deliberately generous so the estimate never *over*-counts triangles and
+ * so never false-rejects a file that would actually fit; a file only fast-rejects when even this
+ * under-count exceeds the budget. Borderline files fall through to the exact parse.
+ */
+const EST_MAX_BYTES_PER_TRIANGLE = 256;
+/**
+ * Safety margin on the byte estimate (DD-022 §13): only *fast*-reject when the estimate is comfortably
+ * over the triangle budget, so a `.model` part padded with non-triangle bytes (comments/metadata) is not
+ * false-rejected. A file estimated between 1× and this multiple of the budget falls through to the exact
+ * per-triangle parse, which enforces the real limit. Genuinely oversize plates (many × a large master)
+ * are far past this and still reject in sub-second time.
+ */
+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 **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;
+        const obj = part.objects.get(objectid);
+        if (obj === undefined)
+            return;
+        if (obj.tris.length > 0) {
+            instanceCount++;
+            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 norm = comp.path.replace(/^\//, '').toLowerCase();
+                const entry = entryByName(norm);
+                if (entry !== undefined) {
+                    instanceCount++;
+                    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)
+            }
+        }
+    };
+    const roots = mainPart.items.length > 0
+        ? mainPart.items
+        : [...mainPart.objects.keys()].map((objectid) => ({ objectid, transform: null }));
+    for (const inst of roots)
+        visit(mainPart, inst.objectid, 0);
+    if (instanceCount > lim.maxInstances) {
+        throw new ModelParseError('E_MODEL_TOO_MANY_INSTANCES', `3MF declares more than ${lim.maxInstances} instance placements`);
+    }
+    if (estTriangles > lim.maxTriangles * EST_REJECT_MARGIN) {
+        throw new ModelParseError('E_MODEL_TOO_MANY_TRIANGLES', `3MF's estimated ${Math.round(estTriangles)} triangles exceed the limit ${lim.maxTriangles}`);
+    }
+}
 export async function parse3mf(source, limits, opts) {
     const lim = resolveLimits(limits);
     const bytes = source instanceof Uint8Array ? source : new Uint8Array(source);
@@ -393,6 +553,10 @@ export async function parse3mf(source, limits, opts) {
             throw e;
         throw new ModelParseError('E_MODEL_PARSE', `3MF unzip failed: ${e.message}`);
     }
+    // Fast structural cost estimate (DD-022 Phase 0): reject a clear instance-bomb / oversize plate now,
+    // from the main part's structure + the ZIP directory, BEFORE decompressing any large external geometry
+    // part in `resolve` — sub-second instead of ~10 s of decompress-and-bake.
+    estimateSceneCost(mainPart, entryByName, lim);
     // Source-model filament palette for Bambu/Orca `paint_color`: it lives in `project_settings.config`
     // (`filament_colour`), NOT the model XML, so the render is self-contained and needs no slicer output.
     let paintPalette = [];
@@ -432,6 +596,7 @@ export async function parse3mf(source, limits, opts) {
     }
     const st = {
         built: [],
+        masters: new Map(),
         anyColor: false,
         anyTransform: false,
         anyApprox: false,
@@ -439,41 +604,50 @@ export async function parse3mf(source, limits, opts) {
         defaultExtruderIdx,
         min: [Infinity, Infinity, Infinity],
         max: [-Infinity, -Infinity, -Infinity],
-        totalTris: 0
+        totalTris: 0,
+        totalInstances: 0
     };
-    // Resolve an object (mesh and/or components) within `part`, applying the transform chain.
-    const resolve = async (part, objectid, chain, id, depth) => {
+    // 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
+    // same `${partKey}#${objectid}` master, reached via different placements, is instanced not copied.
+    const resolve = async (part, objectid, matrix, partKey, depth) => {
         if (depth > MAX_DEPTH)
             return;
         const obj = part.objects.get(objectid);
         if (obj === undefined)
             return;
         if (obj.tris.length > 0)
-            bakeMesh(obj, part, chain, id, st, lim);
-        for (let ci = 0; ci < obj.components.length; ci++) {
-            const comp = obj.components[ci];
+            placeMaster(obj, part, matrix, `${partKey}#${objectid}`, st, lim);
+        for (const comp of obj.components) {
             const targetPart = comp.path !== undefined ? await getPartByPath(comp.path) : part;
             if (targetPart === null)
                 continue;
-            // Apply the component transform FIRST (child space → this object), then the existing chain.
-            const childChain = comp.transform !== null ? [comp.transform, ...chain] : chain;
+            // Fold the component transform (child → this object) into the placement, then descend.
+            const childMatrix = comp.transform !== null ? composeAffine(matrix ?? IDENTITY_AFFINE, comp.transform) : matrix;
             if (comp.transform !== null)
                 st.anyTransform = true;
-            await resolve(targetPart, comp.objectid, childChain, `${id}.${ci}`, depth + 1);
+            const childKey = comp.path !== undefined ? comp.path.replace(/^\//, '').toLowerCase() : partKey;
+            await resolve(targetPart, comp.objectid, childMatrix, childKey, depth + 1);
         }
     };
     // With no <build>, resolve every declared object at identity (some minimal 3MFs omit build).
-    const instances = mainPart.items.length > 0
+    const mainKey = mainEntry.name.toLowerCase();
+    const roots = mainPart.items.length > 0
         ? mainPart.items
         : [...mainPart.objects.keys()].map((objectid) => ({ objectid, transform: null }));
-    for (const inst of instances) {
-        const chain = inst.transform !== null ? [inst.transform] : [];
+    for (const inst of roots) {
         if (inst.transform !== null)
             st.anyTransform = true;
-        await resolve(mainPart, inst.objectid, chain, inst.objectid, 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).
+    for (const rec of st.masters.values()) {
+        if (rec.instances.length > 1)
+            rec.object.instances = rec.instances;
+    }
     const bounds = { min: st.min, max: st.max };
     return {
         objects: st.built,
@@ -482,7 +656,9 @@ export async function parse3mf(source, limits, opts) {
             // `approximated` when any colour came from flattening a subdivided `paint_color` facet.
             materials: st.anyApprox ? 'approximated' : st.anyColor ? 'known' : 'unavailable',
             transforms: st.anyTransform ? 'known' : 'unavailable',
-            multiObject: st.built.length > 1 ? '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'
         }
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chestnutlabs/gcode-model-renderer",
-  "version": "0.10.0",
+  "version": "0.12.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.10.0",
-    "@chestnutlabs/gcode-renderer-three": "0.10.0",
-    "@chestnutlabs/toolpath-core": "0.10.0"
+    "@chestnutlabs/gcode-containers": "0.12.0",
+    "@chestnutlabs/gcode-renderer-three": "0.12.0",
+    "@chestnutlabs/toolpath-core": "0.12.0"
   },
   "devDependencies": {
     "@types/three": "0.178.0"