@chestnutlabs/gcode-model-renderer 0.20.1 → 0.21.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017-2025 Remco Veldkamp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,46 @@
+# NOTICE — Attribution & Provenance
+
+This file summarizes attribution and provenance for **ChestnutLabs/gcode-preview**. It complements,
+and does not replace, the [`LICENSE`](LICENSE) file and the full
+[Upstream, Fork, License & Contribution Policy](docs/03_UPSTREAM_FORK_LICENSE_AND_CONTRIBUTION_POLICY.md).
+
+## Upstream origin
+
+- **This repository is a public GitHub fork of** [`xyz-tools/gcode-preview`](https://github.com/xyz-tools/gcode-preview)
+  (project identity `remcoder/gcode-preview`; npm package `gcode-preview`).
+- **Chestnut founding baseline:** branch `develop` at commit
+  `15375e56129f5a57aebc099ed7bfb5a092dcfb9e` (2026-06-08).
+- The inherited Git history and the upstream fork relationship are preserved. Chestnut Labs maintains
+  its own roadmap, governance, release cadence, and package APIs.
+
+## Copyright
+
+- Inherited code: **Copyright (c) 2017–2025 Remco Veldkamp** and the `xyz-tools/gcode-preview`
+  contributors, licensed under the MIT License (see [`LICENSE`](LICENSE)).
+- Chestnut Labs additions and modifications: **Copyright (c) 2026 Chestnut Labs**, also under the MIT
+  License.
+
+The upstream copyright notice and MIT permission notice are retained in [`LICENSE`](LICENSE) and must
+not be removed. Chestnut notices are added **alongside** — never in place of — upstream notices.
+
+## License
+
+MIT for both the inherited fork and Chestnut Labs additions, unless a later, explicit
+legal/governance decision changes the license for an independently separable new package. See the
+fork/license policy for the full rationale, including how an MIT package may be consumed by a
+GPL-3.0 application (e.g., AnyBridge) without altering the package's MIT notice obligations.
+
+## Derived vs. independently replaced code
+
+Chestnut Labs does **not** claim a clean-room implementation. Subsystem provenance (inherited /
+modified / replaced / original) is tracked in
+[`docs/UPSTREAM_PROVENANCE.md`](docs/UPSTREAM_PROVENANCE.md). Replacing every line of an inherited
+file does not by itself establish clean-room status; the ledger exists for honesty, maintenance, and
+license review.
+
+## Third-party code
+
+Bundled and dependency notices are tracked in [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md).
+Reference implementations studied for behavior (Sindarius/Mainsail, Fluidd, PrusaSlicer/libvgcode,
+BambuBuddy, and others) are **not** incorporated as source unless their license is compatible and the
+incorporation is recorded per policy.

package/README.md

@@ -88,6 +88,13 @@ restore a pose (the same serializable `CameraState` as the toolpath renderer), `
 source formats become viewable by registering a `ModelLoader` for a new `kind`, with no change to the
 viewer's API (design: [DD-021](../../docs/design/DD-021-interactive-model-viewer.md)).
 
+The first frame and `frame()` (a "Reset view" button) fit the model's bounding box to the canvas: a
+wide, flat part fills a wide canvas and still fits a narrow 375 px panel, centered with a small margin.
+Until the user orbits, zooms, or pans, each `resize(w, h)` re-fits the model, so a sidebar collapse
+or a window resize never leaves it cropped. After the user moves the camera, `resize` keeps their
+view, and `frame()` hands framing back to the viewer. Pass `autoFrameOnResize: false` to keep the
+first framing across resizes. The `camera-changed` event fires only when a user gesture settles.
+
 Prefer to build your own scene? `parseStl` / `parse3mf` return a three-free `ModelScene`, and both the
 still and the viewer accept a pre-built `ModelScene` directly.
 

package/dist/model-content.d.ts

@@ -15,6 +15,9 @@ import type { ModelScene, RGB } from './scene-model.js';
 export interface ModelFraming {
     center: Vector3;
     radius: number;
+    /** The model bounds as a scene-space (Y-up) box, for an aspect-aware fit. */
+    sceneMin: Vector3;
+    sceneMax: Vector3;
 }
 /**
  * Adds the model root + studio rig to a provided `Scene` and builds meshes into it. The root carries the

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;;;;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"}
+{"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;IACf,6EAA6E;IAC7E,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;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;IAiBpE,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

@@ -52,7 +52,10 @@ export class ModelContent {
         const [maxX, maxY, maxZ] = scene.bounds.max;
         const center = new Vector3((minX + maxX) / 2, (minY + maxY) / 2, (minZ + maxZ) / 2);
         const radius = Math.max(1e-3, center.distanceTo(new Vector3(minX, minY, minZ)));
-        this.framedModel = { center, radius };
+        // Model Z-up → scene Y-up: (x, y, z) → (x, z, −y), matching the root rotation.
+        const sceneMin = new Vector3(minX, minZ, -maxY);
+        const sceneMax = new Vector3(maxX, maxZ, -minY);
+        this.framedModel = { center, radius, sceneMin, sceneMax };
     }
     /** The framing of the last-set scene (`null` before the first {@link setScene}). */
     get framing() {

package/dist/model-preview.d.ts

@@ -46,6 +46,8 @@ export interface ModelPreviewControllerOptions {
     createRenderer?: (canvas: RenderTargetCanvas) => GLRendererLike;
     /** Injected orbit controls (tests). */
     createControls?: NonNullable<InteractiveStageOptions['createControls']>;
+    /** Re-fit the model on canvas resize until the user moves the camera (default `true`). */
+    autoFrameOnResize?: boolean;
 }
 /** Reactive snapshot of the model viewer, derived from engine events. Immutable — every change replaces it. */
 export interface ModelPreviewState {

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

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

package/dist/model-preview.js

@@ -47,6 +47,7 @@ export function createModelPreviewController(options = {}) {
         ...(options.renderScope ? { renderScope: options.renderScope } : {}),
         ...(options.createRenderer ? { createRenderer: options.createRenderer } : {}),
         ...(options.createControls ? { createControls: options.createControls } : {}),
+        ...(options.autoFrameOnResize !== undefined ? { autoFrameOnResize: options.autoFrameOnResize } : {}),
         // Fold progress into state, then hand it to the consumer's callback.
         onProgress: (p) => {
             mutate({ progress: p, loading: p.stage !== 'ready' });
@@ -88,9 +89,43 @@ export function createModelPreviewController(options = {}) {
             emit(e);
         });
     };
+    /** Detaches the bound canvas's size tracking (ResizeObserver + window-resize fallback). */
+    let unsizeCanvas = null;
+    /**
+     * Keep the engine sized to a DOM canvas's CSS box, mirroring the toolpath controller: an initial fit,
+     * a ResizeObserver, and a window-resize fallback (observers may never fire in embedded panes). A
+     * zero-sized (hidden) canvas is skipped. OffscreenCanvas hosts size themselves via `controls.resize`.
+     */
+    const trackCanvasSize = (canvas, v) => {
+        const el = canvas;
+        if (typeof el.getBoundingClientRect !== 'function')
+            return;
+        const fit = () => {
+            const w = el.clientWidth ?? 0;
+            const h = el.clientHeight ?? 0;
+            if (w > 0 && h > 0)
+                v.resize(w, h);
+        };
+        fit();
+        let ro = null;
+        if (typeof ResizeObserver !== 'undefined') {
+            ro = new ResizeObserver(fit);
+            ro.observe(canvas);
+        }
+        const hasWindow = typeof window !== 'undefined';
+        if (hasWindow)
+            window.addEventListener('resize', fit);
+        unsizeCanvas = () => {
+            ro?.disconnect();
+            if (hasWindow)
+                window.removeEventListener('resize', fit);
+        };
+    };
     function bindCanvas(canvas) {
         if (disposed || canvas === boundCanvas)
             return;
+        unsizeCanvas?.();
+        unsizeCanvas = null;
         // Tear down the engine bound to the previous canvas.
         if (engine !== null) {
             unsubEngine?.();
@@ -104,6 +139,7 @@ export function createModelPreviewController(options = {}) {
         const v = createModelViewer(canvas, engineOptions);
         engine = v;
         wire(v);
+        trackCanvasSize(canvas, v);
         for (const op of pendingOps)
             op(v);
         pendingOps.length = 0;
@@ -187,6 +223,8 @@ export function createModelPreviewController(options = {}) {
         if (disposed)
             return;
         disposed = true;
+        unsizeCanvas?.();
+        unsizeCanvas = null;
         unsubEngine?.();
         unsubEngine = null;
         engine?.dispose();

package/dist/model-viewer.d.ts

@@ -29,6 +29,12 @@ export interface ModelViewerOptions {
      * consumer owns all wording/i18n. Events from a superseded load are not emitted.
      */
     onProgress?: (progress: LoadProgress) => void;
+    /**
+     * Re-fit the camera to the model when the canvas is resized (`resize()`), until the user moves the
+     * camera (orbit/zoom/pan or `setCameraState`); after that their view is kept. `frame()` (Reset view),
+     * a new source, or a render-scope change resumes auto-framing. Default `true`.
+     */
+    autoFrameOnResize?: boolean;
 }
 /** What the source actually carried, surfaced on `ready` (never fabricated — DD-001). */
 export interface ModelReadyInfo {
@@ -59,7 +65,9 @@ export interface ModelReadyInfo {
 export type ModelViewerEvent = {
     type: 'ready';
     info: ModelReadyInfo;
-} | {
+}
+/** Fires once per user camera gesture (orbit/zoom/pan) after it settles — never for programmatic moves. */
+ | {
     type: 'camera-changed';
     state: CameraState;
 } | {
@@ -86,7 +94,10 @@ export interface ModelViewer {
     setBackground(bg: ModelBackground): void;
     setInteractionQuality(mode: 'off' | 'auto'): void;
     resize(width: number, height: number): void;
-    /** Re-fit the camera to the current model bounds. */
+    /**
+     * Re-fit the camera to the current model bounds (the default 3/4 view), fitting the bounding box to
+     * the canvas aspect and field of view. Also resumes auto-framing on resize.
+     */
     frame(): void;
     /**
      * Render only a subset of the current source (DD-030 D2): `{ plateId }`, `{ objectIds }`, or an

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

@@ -55,7 +55,17 @@ export function createModelViewer(canvas, options = {}) {
     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;
+    const autoFrameOnResize = options.autoFrameOnResize ?? true;
+    // True while the camera is library-framed; a user gesture (or setCameraState) hands it to the user.
+    let autoFraming = true;
     let stage = null;
+    /** Fit the current model's box to the viewport (aspect + FOV aware); `keepDirection` keeps the view angle. */
+    const fit = (keepDirection = false) => {
+        const f = content.framing;
+        if (f === null || stage === null)
+            return;
+        stage.fitBox(f.sceneMin, f.sceneMax, keepDirection ? { direction: stage.viewDirection() } : {});
+    };
     try {
         stage = new InteractiveStage({
             canvas,
@@ -65,6 +75,9 @@ export function createModelViewer(canvas, options = {}) {
             createRenderer: options.createRenderer ?? ((c) => createDefaultGLRenderer(c, { alpha: true })),
             ...(options.createControls ? { createControls: options.createControls } : {}),
             onCameraChanged: (state) => emit({ type: 'camera-changed', state }),
+            onInteractionStart: () => {
+                autoFraming = false;
+            },
             onContextLost: () => emit({ type: 'context-lost' }),
             onContextRestored: () => {
                 // GPU resources are gone; rebuild meshes from the retained scene and reframe, mirroring the
@@ -72,9 +85,8 @@ export function createModelViewer(canvas, options = {}) {
                 const shown = scopedScene();
                 if (shown !== null && stage !== null) {
                     content.setScene(shown);
-                    const f = content.framing;
-                    if (f !== null)
-                        stage.frameTo(f.center, f.radius);
+                    if (autoFraming)
+                        fit(true);
                 }
                 emit({ type: 'context-restored' });
             }
@@ -124,9 +136,8 @@ export function createModelViewer(canvas, options = {}) {
             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);
+            autoFraming = true;
+            fit();
             progress({ stage: 'ready' });
             emit({ type: 'ready', info });
             return info;
@@ -144,11 +155,15 @@ export function createModelViewer(canvas, options = {}) {
         setSource,
         setView(view) {
             stage?.setView(view);
+            // While library-framed, a preset view is fitted too (and stays fitted across resizes).
+            if (autoFraming)
+                fit(true);
         },
         getCameraState() {
             return stage ? stage.getCameraState() : null;
         },
         setCameraState(state) {
+            autoFraming = false;
             stage?.setCameraState(state);
         },
         setBackground(bg) {
@@ -160,11 +175,13 @@ export function createModelViewer(canvas, options = {}) {
         },
         resize(width, height) {
             stage?.resize(width, height);
+            // A hidden (0×0) canvas has no aspect to fit; keep the pose and re-fit on the next real size.
+            if (autoFrameOnResize && autoFraming && width > 0 && height > 0)
+                fit(true);
         },
         frame() {
-            const f = content.framing;
-            if (f !== null)
-                stage?.frameTo(f.center, f.radius);
+            autoFraming = true;
+            fit();
         },
         setRenderScope(scope) {
             currentScope = scope;
@@ -172,10 +189,8 @@ export function createModelViewer(canvas, options = {}) {
             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();
+            autoFraming = true;
+            fit();
         },
         capture(opts) {
             if (stage === null) {

package/dist/stl.d.ts

@@ -2,4 +2,10 @@ import { type ModelScene } from './scene-model.js';
 import { type ModelLimits } from './limits.js';
 /** Parse STL bytes into a single-object {@link ModelScene}. Throws {@link ModelParseError} on failure. */
 export declare function parseStl(source: Uint8Array | ArrayBuffer, limits?: ModelLimits): ModelScene;
+/**
+ * STL facet normals are advisory and many exporters write `0 0 0` (or garbage). A zero/non-finite normal
+ * lights the facet black, so replace each degenerate one with the face normal from its winding; valid
+ * file normals are kept. A triangle with no area keeps a zero normal (it covers no pixels).
+ */
+export declare function repairFacetNormals(positions: Float32Array, normals: Float32Array): Float32Array;
 //# sourceMappingURL=stl.d.ts.map

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,CAyD3F"}
+{"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,CA4D3F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CA+B/F"}

package/dist/stl.js

@@ -54,7 +54,9 @@ export function parseStl(source, limits) {
     }
     const positions = new Float32Array(posAttr.array);
     const normAttr = geom.getAttribute('normal');
-    const normals = normAttr !== undefined ? new Float32Array(normAttr.array) : undefined;
+    const normals = normAttr !== undefined
+        ? repairFacetNormals(positions, new Float32Array(normAttr.array))
+        : undefined;
     const bounds = boundsOf(positions);
     geom.dispose();
     const geometry = normals !== undefined ? { positions, normals } : { positions };
@@ -70,6 +72,45 @@ export function parseStl(source, limits) {
         }
     };
 }
+/**
+ * STL facet normals are advisory and many exporters write `0 0 0` (or garbage). A zero/non-finite normal
+ * lights the facet black, so replace each degenerate one with the face normal from its winding; valid
+ * file normals are kept. A triangle with no area keeps a zero normal (it covers no pixels).
+ */
+export function repairFacetNormals(positions, normals) {
+    for (let t = 0; t + 8 < normals.length && t + 8 < positions.length; t += 9) {
+        const nx = normals[t];
+        const ny = normals[t + 1];
+        const nz = normals[t + 2];
+        const len = Math.hypot(nx, ny, nz);
+        if (Number.isFinite(len) && len > 1e-6)
+            continue;
+        const ax = positions[t + 3] - positions[t];
+        const ay = positions[t + 4] - positions[t + 1];
+        const az = positions[t + 5] - positions[t + 2];
+        const bx = positions[t + 6] - positions[t];
+        const by = positions[t + 7] - positions[t + 1];
+        const bz = positions[t + 8] - positions[t + 2];
+        let cx = ay * bz - az * by;
+        let cy = az * bx - ax * bz;
+        let cz = ax * by - ay * bx;
+        const cl = Math.hypot(cx, cy, cz);
+        if (cl > 0) {
+            cx /= cl;
+            cy /= cl;
+            cz /= cl;
+        }
+        else {
+            cx = cy = cz = 0;
+        }
+        for (let v = 0; v < 9; v += 3) {
+            normals[t + v] = cx;
+            normals[t + v + 1] = cy;
+            normals[t + v + 2] = cz;
+        }
+    }
+    return normals;
+}
 function boundsOf(positions) {
     let minX = Infinity;
     let minY = Infinity;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chestnutlabs/gcode-model-renderer",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "description": "Three.js presentation renderer for source models (STL/3MF) — clean thumbnails/cards, distinct from toolpath inspection (DD-018).",
   "keywords": [
     "3d-printing",
@@ -44,7 +44,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE",
+    "NOTICE.md"
   ],
   "publishConfig": {
     "access": "public"
@@ -55,9 +57,9 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@chestnutlabs/gcode-containers": "0.20.1",
-    "@chestnutlabs/gcode-renderer-three": "0.20.1",
-    "@chestnutlabs/toolpath-core": "0.20.1"
+    "@chestnutlabs/gcode-containers": "0.21.0",
+    "@chestnutlabs/gcode-renderer-three": "0.21.0",
+    "@chestnutlabs/toolpath-core": "0.21.0"
   },
   "devDependencies": {
     "@types/three": "0.178.0"