@chestnutlabs/gcode-model-renderer 0.17.0 → 0.18.0

package/dist/index.d.ts

@@ -20,6 +20,6 @@ export type { ModelLoader, ModelLoadOptions, ModelSourceInput } from './loaders.
 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, ModelPlateSummary, MeshGeometry, ModelBounds, RGB, Mat4 } from './scene-model.js';
+export { IDENTITY_MAT4, applyRenderScope } from './scene-model.js';
+export type { ModelScene, ModelObject, ModelMaterial, ModelPlateSummary, MeshGeometry, ModelBounds, RenderScope, 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,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,GAAG,EACH,IAAI,EACL,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,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,GAAG,EACH,IAAI,EACL,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -14,4 +14,4 @@ export { parse3mf } from './three-mf.js';
 export { stlLoader, threeMfLoader, DEFAULT_MODEL_LOADERS, isModelScene, resolveModelScene } from './loaders.js';
 export { computeCacheKey, defaultEnvId } from './cache-key.js';
 export { DEFAULT_LIMITS, resolveLimits, ModelParseError } from './limits.js';
-export { IDENTITY_MAT4 } from './scene-model.js';
+export { IDENTITY_MAT4, applyRenderScope } from './scene-model.js';

package/dist/model-viewer.d.ts

@@ -1,9 +1,9 @@
-import { type CameraMode, type CameraState, type CameraView, type GLRendererLike, type InteractiveStageOptions, type LoadProgress, type RenderTargetCanvas } from '@chestnutlabs/gcode-renderer-three';
+import { type CameraMode, type CameraState, type CameraView, type CaptureOptions, 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, type ModelPlateSummary } from './scene-model.js';
+import { type ModelBounds, type ModelPlateSummary, type RenderScope } from './scene-model.js';
 export interface ModelViewerOptions {
     /** Loader registry (open `kind`). Default: `[stlLoader, threeMfLoader]`. */
     loaders?: readonly ModelLoader[];
@@ -21,6 +21,8 @@ export interface ModelViewerOptions {
     createRenderer?: (canvas: RenderTargetCanvas) => GLRendererLike;
     /** Injected orbit controls (tests). Default: three `OrbitControls` via the stage. */
     createControls?: NonNullable<InteractiveStageOptions['createControls']>;
+    /** Initial render scope (DD-030 D2) — e.g. `{ plateId: 3 }`. Omit to render the whole source. */
+    renderScope?: RenderScope;
     /**
      * 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
@@ -86,6 +88,17 @@ export interface ModelViewer {
     resize(width: number, height: number): void;
     /** Re-fit the camera to the current model bounds. */
     frame(): void;
+    /**
+     * Render only a subset of the current source (DD-030 D2): `{ plateId }`, `{ objectIds }`, or an
+     * `{ instanceFilter }`; `null` restores the whole source. Rebuilds and reframes to the subset. Gate a
+     * `{ plateId }` on the ready info's `plates` being present — an unmatched scope renders empty.
+     */
+    setRenderScope(scope: RenderScope | null): void;
+    /**
+     * Capture the current view as an image `Blob` (DD-030 D1) — for an operator-selected thumbnail or a
+     * large-file fallback. Rejects with `E_CAPTURE_UNSUPPORTED` when the renderer is unavailable.
+     */
+    capture(opts?: CaptureOptions): Promise<Blob>;
     onEvent(cb: (e: ModelViewerEvent) => void): () => void;
     dispose(): void;
 }

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

@@ -13,11 +13,11 @@
  * Interactive is a browser concern — headless/offscreen stills stay `renderModelStill` (DD-018 §4.3).
  */
 import { Color, Scene } from 'three';
-import { InteractiveStage, createDefaultGLRenderer } from '@chestnutlabs/gcode-renderer-three';
+import { CaptureUnsupportedError, InteractiveStage, createDefaultGLRenderer } from '@chestnutlabs/gcode-renderer-three';
 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';
+import { applyRenderScope, sceneInstanceCount } from './scene-model.js';
 function backgroundColor(bg) {
     return bg === 'transparent' ? null : new Color(bg);
 }
@@ -48,7 +48,11 @@ export function createModelViewer(canvas, options = {}) {
     const content = new ModelContent(scene);
     // Retained so context-loss recovery can rebuild meshes from the last-set scene.
     let currentScene = null;
+    // Active render scope (DD-030 D2); applied to `currentScene` on build/reframe/restore. Null = whole source.
+    let currentScope = options.renderScope ?? null;
     let disposed = false;
+    /** The scene to actually build/render = the full source narrowed by the active scope. */
+    const scopedScene = () => currentScene === null ? null : currentScope ? applyRenderScope(currentScene, currentScope) : currentScene;
     // Monotonic token for last-wins overlapping setSource (stale async results are discarded).
     let sourceToken = 0;
     let stage = null;
@@ -65,8 +69,9 @@ export function createModelViewer(canvas, options = {}) {
             onContextRestored: () => {
                 // GPU resources are gone; rebuild meshes from the retained scene and reframe, mirroring the
                 // toolpath renderer's recovery.
-                if (currentScene !== null && stage !== null) {
-                    content.setScene(currentScene);
+                const shown = scopedScene();
+                if (shown !== null && stage !== null) {
+                    content.setScene(shown);
                     const f = content.framing;
                     if (f !== null)
                         stage.frameTo(f.center, f.radius);
@@ -114,10 +119,11 @@ export function createModelViewer(canvas, options = {}) {
             // Last-wins: a newer setSource (or a dispose) superseded this one — discard without mutating.
             if (my !== sourceToken || disposed || stage === null)
                 return info;
-            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 shown = scopedScene(); // parsed just set → non-null
+            const total = shown.objects.length;
+            progress({ stage: 'building-geometry', done: 0, total, unit: 'objects' });
+            content.setScene(shown, (done) => progress({ stage: 'building-geometry', done, total, unit: 'objects' }));
             const f = content.framing;
             if (f !== null)
                 stage.frameTo(f.center, f.radius);
@@ -160,6 +166,23 @@ export function createModelViewer(canvas, options = {}) {
             if (f !== null)
                 stage?.frameTo(f.center, f.radius);
         },
+        setRenderScope(scope) {
+            currentScope = scope;
+            const shown = scopedScene();
+            if (shown === null || stage === null)
+                return; // no source yet — applied on the next setSource
+            content.setScene(shown);
+            const f = content.framing;
+            if (f !== null)
+                stage.frameTo(f.center, f.radius);
+            stage.render();
+        },
+        capture(opts) {
+            if (stage === null) {
+                return Promise.reject(new CaptureUnsupportedError('model viewer renderer unavailable'));
+            }
+            return stage.capture(opts);
+        },
         onEvent(cb) {
             listeners.add(cb);
             if (pending.length > 0) {

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 ModelPlateSummary, type ModelScene } from './scene-model.js';
+import { type ModelPlateSummary, type ModelScene, type RenderScope } 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
@@ -45,6 +45,13 @@ export interface RenderModelStillOptions {
     filamentPalette?: readonly (string | undefined)[];
     /** Override the environment id folded into the cache key (default: the `three` revision). */
     envId?: string;
+    /**
+     * Render only a subset of a multi-plate / multi-object source (DD-030 D2) — e.g. `{ plateId: 3 }` to
+     * render just plate 3 of a project, framed to that plate. Omit to render the whole project (default).
+     * `{ plateId }` is meaningful only when the source declares plates (`plates: 'known'`); on a source
+     * without plate structure it matches nothing and renders empty (the honest result).
+     */
+    renderScope?: RenderScope;
 }
 export interface RenderModelStillResult {
     canvas: RenderTargetCanvas;
@@ -76,10 +83,5 @@ export interface RenderModelStillResult {
     /** Stable identity for caching: `hash(source) + options + envId`. */
     cacheKey: string;
 }
-/**
- * Render one presentation still. Async because the 3MF path unzips with the container reader
- * (`DecompressionStream`); the STL and pre-built-`ModelScene` paths resolve promptly. Mirrors the
- * async `renderStill` on the toolpath side.
- */
 export declare function renderModelStill(source: ModelSource, options: RenderModelStillOptions): Promise<RenderModelStillResult>;
 //# sourceMappingURL=render-model-still.d.ts.map

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,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"}
+{"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,EAGL,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAE1B,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;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;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;AAkCD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CA+CjC"}

package/dist/render-model-still.js

@@ -1,6 +1,6 @@
 import { ModelRenderer } from './model-renderer.js';
 import { isModelScene, resolveModelScene } from './loaders.js';
-import { sceneInstanceCount } from './scene-model.js';
+import { applyRenderScope, sceneInstanceCount } from './scene-model.js';
 import { computeCacheKey } from './cache-key.js';
 async function toScene(source, limits, filamentPalette) {
     if (isModelScene(source)) {
@@ -18,13 +18,27 @@ async function toScene(source, limits, filamentPalette) {
  * (`DecompressionStream`); the STL and pre-built-`ModelScene` paths resolve promptly. Mirrors the
  * async `renderStill` on the toolpath side.
  */
+/** Counter that makes an opaque `instanceFilter` scope's cache key unique (never a false cache hit). */
+let scopeKeyCounter = 0;
+/** A stable, serializable cache-key fragment for a render scope (DD-030 D2). */
+function scopeCacheKey(scope) {
+    if (!scope)
+        return undefined;
+    if ('plateId' in scope)
+        return { p: scope.plateId };
+    if ('objectIds' in scope)
+        return { o: [...scope.objectIds].sort() };
+    return { fn: ++scopeKeyCounter }; // opaque predicate → non-cacheable, unique each call
+}
 export async function renderModelStill(source, options) {
     const { canvas } = options;
     const width = options.width ?? canvas.width;
     const height = options.height ?? canvas.height;
     const background = options.background ?? 'transparent';
     const view = options.view ?? 'iso';
-    const { scene, sourceBytes } = await toScene(source, options.limits, options.filamentPalette);
+    const { scene: fullScene, sourceBytes } = await toScene(source, options.limits, options.filamentPalette);
+    // DD-030 D2: narrow to the requested plate/object subset (framing follows the filtered bounds).
+    const scene = options.renderScope ? applyRenderScope(fullScene, options.renderScope) : fullScene;
     const renderer = new ModelRenderer({
         canvas,
         background,
@@ -35,7 +49,16 @@ export async function renderModelStill(source, options) {
         renderer.resize(width, height);
         renderer.setScene(scene);
         renderer.render();
-        const optionsJson = JSON.stringify({ width, height, background, view, palette: options.filamentPalette });
+        const optionsJson = JSON.stringify({
+            width,
+            height,
+            background,
+            view,
+            palette: options.filamentPalette,
+            // Fold the scope so plate-1 and plate-2 thumbnails key distinctly. An opaque `instanceFilter` can't
+            // be serialized — such a still is marked non-cacheable (consumers should not reuse it by key).
+            scope: scopeCacheKey(options.renderScope)
+        });
         const cacheKey = computeCacheKey(sourceBytes, optionsJson, options.envId);
         return {
             canvas,

package/dist/scene-model.d.ts

@@ -118,6 +118,29 @@ export interface ModelScene {
         plates: Confidence;
     };
 }
+/**
+ * A render-scope selector (DD-030 D2): which objects/placements of a scene to render. Generic and
+ * vendor-neutral — a plate is one way to derive the subset. `{plateId}` is sugar over the placement's
+ * {@link ModelObject.plateIds} (meaningful only when `capabilities.plates === 'known'`; on a scene with
+ * no plate structure it matches nothing → an empty scene, the honest result of selecting a plate that
+ * isn't declared). `{objectIds}` and `{instanceFilter}` need no capability (ids are always known).
+ */
+export type RenderScope = {
+    objectIds: string[];
+} | {
+    plateId: number;
+} | {
+    instanceFilter: (objectId: string, placementIndex: number) => boolean;
+};
+/**
+ * Return a filtered copy of `scene` containing only the objects/placements the scope selects, with
+ * `bounds` recomputed from the kept placements (so a consumer frames just the selected plate/subset).
+ * Pure and three-free. Objects with no kept placement are dropped; an empty result (nothing matched) is
+ * a valid, honest scene — a `{plateId}` that matches nothing renders empty by design (gate on
+ * `capabilities.plates === 'known'`). `scene.plates`/`capabilities` are preserved (the source's declared
+ * structure is unchanged; only what is *rendered* is narrowed).
+ */
+export declare function applyRenderScope(scene: ModelScene, scope: RenderScope): ModelScene;
 /** The identity transform (column-major), for single-object sources. */
 export declare const IDENTITY_MAT4: Mat4;
 /**

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;;;;;;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"}
+{"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;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GACvB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,CAAC;AA6C9E;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,UAAU,CAyBlF;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,3 +1,87 @@
+/** Local axis-aligned bounds of a geometry's positions. */
+function geometryAABB(positions) {
+    const min = [Infinity, Infinity, Infinity];
+    const max = [-Infinity, -Infinity, -Infinity];
+    for (let i = 0; i + 2 < positions.length; i += 3) {
+        for (let a = 0; a < 3; a++) {
+            const v = positions[i + a];
+            if (v < min[a])
+                min[a] = v;
+            if (v > max[a])
+                max[a] = v;
+        }
+    }
+    return { min, max };
+}
+/** Transform a point by a column-major (three `Matrix4.elements`) affine Mat4. */
+function applyMat4(m, x, y, z) {
+    return [
+        m[0] * x + m[4] * y + m[8] * z + m[12],
+        m[1] * x + m[5] * y + m[9] * z + m[13],
+        m[2] * x + m[6] * y + m[10] * z + m[14]
+    ];
+}
+/** Union of the world AABBs of the given placements of an object's geometry, into `acc`. */
+function accumulatePlacementBounds(geom, placements, acc) {
+    const { min: lmin, max: lmax } = geometryAABB(geom.positions);
+    if (lmin[0] > lmax[0])
+        return; // empty geometry
+    const mut = acc;
+    for (const m of placements) {
+        for (let cx = 0; cx < 2; cx++) {
+            for (let cy = 0; cy < 2; cy++) {
+                for (let cz = 0; cz < 2; cz++) {
+                    const w = applyMat4(m, cx ? lmax[0] : lmin[0], cy ? lmax[1] : lmin[1], cz ? lmax[2] : lmin[2]);
+                    for (let a = 0; a < 3; a++) {
+                        if (w[a] < mut.min[a])
+                            mut.min[a] = w[a];
+                        if (w[a] > mut.max[a])
+                            mut.max[a] = w[a];
+                    }
+                }
+            }
+        }
+    }
+}
+/**
+ * Return a filtered copy of `scene` containing only the objects/placements the scope selects, with
+ * `bounds` recomputed from the kept placements (so a consumer frames just the selected plate/subset).
+ * Pure and three-free. Objects with no kept placement are dropped; an empty result (nothing matched) is
+ * a valid, honest scene — a `{plateId}` that matches nothing renders empty by design (gate on
+ * `capabilities.plates === 'known'`). `scene.plates`/`capabilities` are preserved (the source's declared
+ * structure is unchanged; only what is *rendered* is narrowed).
+ */
+export function applyRenderScope(scene, scope) {
+    const matches = (o, i) => {
+        if ('objectIds' in scope)
+            return scope.objectIds.includes(o.id);
+        if ('plateId' in scope)
+            return o.plateIds?.[i] === scope.plateId;
+        return scope.instanceFilter(o.id, i);
+    };
+    const objects = [];
+    const bounds = { min: [Infinity, Infinity, Infinity], max: [-Infinity, -Infinity, -Infinity] };
+    for (const o of scene.objects) {
+        const placements = o.instances ?? [o.transform];
+        const kept = [];
+        for (let i = 0; i < placements.length; i++)
+            if (matches(o, i))
+                kept.push(i);
+        if (kept.length === 0)
+            continue;
+        const keptPlacements = kept.map((i) => placements[i]);
+        const next = {
+            ...o,
+            transform: keptPlacements[0],
+            instances: keptPlacements.length > 1 ? keptPlacements.slice() : undefined,
+            plateIds: o.plateIds ? kept.map((i) => o.plateIds[i]) : undefined
+        };
+        objects.push(next);
+        accumulatePlacementBounds(o.geometry, keptPlacements, bounds);
+    }
+    const finalBounds = objects.length === 0 ? { min: [0, 0, 0], max: [0, 0, 0] } : bounds;
+    return { ...scene, objects, bounds: finalBounds };
+}
 /** 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];
 /**

package/package.json

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