@chestnutlabs/gcode-preview-react 0.20.0 → 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/dist/model/use-model-viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-model-viewer.d.ts","sourceRoot":"","sources":["../../src/model/use-model-viewer.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC;AAC1F,MAAM,MAAM,qBAAqB,GAAG,6BAA6B,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,SAAS,EAAE,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,+EAA+E;IAC/E,SAAS,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC7C,6EAA6E;IAC7E,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,mEAAmE;IACnE,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvD,OAAO,IAAI,IAAI,CAAC;CACjB;AAQD,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CA+CrF"}
+{"version":3,"file":"use-model-viewer.d.ts","sourceRoot":"","sources":["../../src/model/use-model-viewer.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC;AAC1F,MAAM,MAAM,qBAAqB,GAAG,6BAA6B,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,SAAS,EAAE,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,+EAA+E;IAC/E,SAAS,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC7C,6EAA6E;IAC7E,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,mEAAmE;IACnE,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvD,OAAO,IAAI,IAAI,CAAC;CACjB;AAQD,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAgErF"}

package/dist/model/use-model-viewer.js

@@ -5,7 +5,7 @@
  * — never a separate viewer implementation (the D1 drift firewall). Shared contracts are re-exported
  * from the controller.
  */
-import { useCallback, useMemo, useRef, useSyncExternalStore } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';
 import { createModelPreviewController } from '@chestnutlabs/gcode-model-renderer';
 export function useModelViewer(options = {}) {
     const optionsRef = useRef(options);
@@ -24,6 +24,22 @@ export function useModelViewer(options = {}) {
     const subscribe = useCallback((cb) => ensure().onStateChange(() => cb()), [ensure]);
     const getSnapshot = useCallback(() => ensure().getState(), [ensure]);
     const state = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    // Own the controller's lifecycle: (re)create on mount (StrictMode's second setup lands here) and
+    // DISPOSE on unmount. Without this the GL engine was freed via the canvas-ref-null path but the
+    // controller was never disposed, so in-flight setSource promises never settled and the controller
+    // leaked — the toolpath hook already does this; the model hook must match.
+    useEffect(() => {
+        const c = ensure();
+        // Refs attach BEFORE StrictMode's dispose/recreate cycle: rebind the delivered canvas to the fresh
+        // controller (refs never re-fire) so it renders again after a remount.
+        if (slot.current.canvas !== null && c.raw.viewer() === null) {
+            c.bindCanvas(slot.current.canvas);
+        }
+        return () => {
+            slot.current.controller?.dispose();
+            slot.current.disposed = true;
+        };
+    }, [ensure]);
     const stateRef = useRef(state);
     stateRef.current = state;
     return useMemo(() => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chestnutlabs/gcode-preview-react",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Thin React integration for the Chestnut Labs G-code viewer (DD-007 D1 amendment): useGcodePreview hook + GcodePreview component as a reactivity bridge over @chestnutlabs/gcode-preview-core.",
   "keywords": [
     "gcode",
@@ -42,7 +42,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE",
+    "NOTICE.md"
   ],
   "publishConfig": {
     "access": "public"
@@ -53,11 +55,11 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@chestnutlabs/gcode-model-renderer": "0.20.0",
-    "@chestnutlabs/gcode-parser": "0.20.0",
-    "@chestnutlabs/gcode-preview-core": "0.20.0",
-    "@chestnutlabs/gcode-renderer-three": "0.20.0",
-    "@chestnutlabs/toolpath-core": "0.20.0"
+    "@chestnutlabs/gcode-model-renderer": "0.21.0",
+    "@chestnutlabs/gcode-parser": "0.21.0",
+    "@chestnutlabs/gcode-preview-core": "0.21.0",
+    "@chestnutlabs/gcode-renderer-three": "0.21.0",
+    "@chestnutlabs/toolpath-core": "0.21.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"