@chestnutlabs/gcode-preview-react 0.18.0 → 0.20.0

package/README.md

@@ -26,12 +26,19 @@ function Viewer({ file }: { file: File | null }) {
 }
 ```
 
-That is a complete viewer (StrictMode-safe). The full surface is optional props with sensible
-defaults — `source`, `parseOptions`, `buildVolume` (consumer-wins bed precedence), `quality`,
-`colorMode`, `layerRange`, `scrub`, `showTravel`, `progress` (DD-006 observation), `createWorker`
-— with matching callbacks (`onReady`, `onParseError`, `onBuildComplete`, `onQualityFallback`,
+That is a complete viewer (StrictMode-safe). The full surface is ~24 optional props with sensible
+defaults — `source`, `parseOptions`, `buildVolume` (consumer-wins bed precedence), `quality` /
+`qualityMode`, `colorMode`, `theme`, `cameraMode` / `view` / `frameContent`, `layerRange`, `scrub`,
+`showTravel` / `showRetractions` / `showWipe`, `hiddenFeatureRoles` (hide feature roles like Skirt or
+Brim; gate on `capabilities.featureRoles`), `progress` (DD-006 observation), `createWorker` — with
+matching callbacks (`onReady`, `onCameraChange`, `onParseError`, `onParseCancelled`,
+`onParseProgress`, `onStage`, `onBuildComplete`, `onQualityFallback`,
 `onMachineGeometryMismatch`/`Discovered`, `onProgressPresentationChanged`, `onDisclosure`,
-`onError`). The full handle is reachable via `ref`.
+`onError`). The full handle is reachable via `ref`; its `controls` reach the imperative surface —
+`getRenderStats()` (render diagnostics), `pickSegment(ndcX, ndcY, threshold?)` (source-mapping /
+picking), `isColorModeAvailable(mode)`, and `capture(opts?)` (image `Blob`, also `handle.capture`).
+The handle `state` carries capability-aware UI data (`availableColorModes`, `hasRetractions`,
+`hasColorChanges`).
 
 ## Headless hook (build your own controls)
 
@@ -54,7 +61,45 @@ The batteries default (all dialect adapters + `.gcode.3mf`) needs zero setup und
 `@chestnutlabs/gcode-preview-vue` README for the shared worker documentation — the options are
 identical across adapters by design.
 
-## Example
+## Model viewing (Prepare side)
 
-`tools/example-react` in the repository is a complete Vite + React app (corpus load, layer/scrub,
-simulated live progress) running under `<StrictMode>`.
+The `/model` subpath ships a `<ModelViewer>` — the **Prepare**-side counterpart to `<GcodePreview>`.
+Where `<GcodePreview>` draws the toolpath (how a print runs), `<ModelViewer>` draws the **source
+model** (an `.stl` / `.3mf` mesh) — the object before slicing.
+
+```tsx
+import { ModelViewer } from '@chestnutlabs/gcode-preview-react/model';
+
+function ModelPreview({ bytes }: { bytes: Uint8Array }) {
+  return (
+    <div style={{ height: '70vh' }}>
+      <ModelViewer
+        source={{ kind: '3mf', bytes }}
+        onReady={(info) => console.log(info.objectCount, info.materials)}
+      />
+    </div>
+  );
+}
+```
+
+`onReady(info)` carries the honest material-colour tier: `info.materials` is `'known'` /
+`'approximated'` when the file declared colours the render used, and `'unavailable'` when it declared
+none (a neutral default was drawn, never faked). The declarative props, callbacks, and the
+`useModelViewer` hook mirror the toolpath component. See
+[`docs/manual/adapters.md`](../../docs/manual/adapters.md) "Two viewers: Preview and Prepare" for the
+cross-adapter tour, and `tools/example-react/model.html` for a runnable minimal page.
+
+## Examples
+
+`tools/example-react` in the repository is a Vite app with two tiers, both driving this published
+package (no raw renderer or parser imports):
+
+- **`minimal.html`** — the smallest real integration: `<GcodePreview source>` plus a fixture picker
+  and a layer slider. One short file to copy when getting started.
+- **`showcase.html`** — the full declarative surface: capability-gated color modes (a mode greys out
+  with a plain-language reason when the file can't support it), declarative `hiddenFeatureRoles`,
+  camera, and `getRenderStats()`/`pickSegment()` diagnostics through the `ref` handle. Uses the
+  `useGcodePreview` hook for render-subscribed reactive state.
+
+Run it with `npm install --prefix tools/example-react && npm run dev --prefix tools/example-react`
+(port 5201).

package/dist/gcode-preview-component.d.ts

@@ -1,5 +1,5 @@
 import type { BuildVolumeDef, CameraMode, CameraState, CameraView, ColorMode, ProgressivePreview, PreparationStage, QualityMode, QualityPolicy, Theme, TubeOptions } from '@chestnutlabs/gcode-renderer-three';
-import type { MachineGeometry, ProgressObservation } from '@chestnutlabs/toolpath-core';
+import type { FeatureRoleValue, MachineGeometry, ProgressObservation } from '@chestnutlabs/toolpath-core';
 import type { WireParseOptions, WorkerLike } from '@chestnutlabs/gcode-parser';
 import { type GcodePreviewHandle, type RendererMode, type UseGcodePreviewOptions } from './use-gcode-preview.js';
 export type GcodePreviewSource = Uint8Array | ArrayBuffer | File | null;
@@ -48,6 +48,9 @@ export interface GcodePreviewProps {
     showRetractions?: boolean;
     /** #306/#6: show the build-volume wireframe cage (independent of the bed/plate). Default true. */
     showVolumeCage?: boolean;
+    /** DD-031 G3: feature roles to hide (e.g. `[FeatureRole.Skirt, FeatureRole.Brim]`). Declarative form
+     *  of `controls.setFeatureRoleVisible`; gate on `capabilities.featureRoles`. */
+    hiddenFeatureRoles?: FeatureRoleValue[];
     /** DD-006 live progress observation; null hides the overlay. */
     progress?: ProgressObservation | null;
     /** Worker factory escape hatch (DD-005 slim/custom entries; D2). */

package/dist/gcode-preview-component.d.ts.map

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

package/dist/gcode-preview-component.js

@@ -36,6 +36,8 @@ function GcodePreviewImpl(props, ref) {
     // Callbacks live in a ref so the event subscription is stable across renders.
     const cbRef = useRef(props);
     cbRef.current = props;
+    // Tracks which roles THIS prop last hid, so we diff prev→next and don't disturb roles hidden elsewhere.
+    const prevHiddenRef = useRef([]);
     useEffect(() => {
         return preview.onEvent((e) => {
             const p = cbRef.current;
@@ -90,7 +92,7 @@ function GcodePreviewImpl(props, ref) {
         });
     }, []);
     // ---- prop wiring: each prop is a thin call into the hook (D1 shell rule) ----
-    const { source, layerRange, scrub, scrubTime, showTravel, showWipe, showRetractions, showVolumeCage, colorMode, quality, qualityMode, progressivePreview, cameraMode, frameContent, interactionQuality, view, cameraState, theme, buildVolume, progress } = props;
+    const { source, layerRange, scrub, scrubTime, showTravel, showWipe, showRetractions, showVolumeCage, colorMode, quality, qualityMode, progressivePreview, cameraMode, frameContent, interactionQuality, view, cameraState, theme, buildVolume, hiddenFeatureRoles, progress } = props;
     useEffect(() => {
         if (source !== null && source !== undefined)
             void preview.parse(source, cbRef.current.parseOptions);
@@ -163,6 +165,18 @@ function GcodePreviewImpl(props, ref) {
         if (buildVolume !== undefined && 'bed' in buildVolume)
             preview.controls.setBuildVolume(buildVolume);
     }, [buildVolume]);
+    useEffect(() => {
+        // Feature-role visibility (DD-031 G3): diff prev→next so we only toggle roles this prop owns.
+        const next = hiddenFeatureRoles ?? [];
+        const prev = prevHiddenRef.current;
+        for (const role of prev)
+            if (!next.includes(role))
+                preview.controls.setFeatureRoleVisible(role, true);
+        for (const role of next)
+            if (!prev.includes(role))
+                preview.controls.setFeatureRoleVisible(role, false);
+        prevHiddenRef.current = [...next];
+    }, [hiddenFeatureRoles]);
     useEffect(() => {
         if (progress === null || progress === undefined)
             preview.clearProgress();

package/dist/model/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @chestnutlabs/gcode-preview-react/model — the React integration for interactive **source-model**
+ * viewing (STL / 3MF), the Prepare-side counterpart to the toolpath `<GcodePreview>` (DD-031).
+ * `useModelViewer` hook + `<ModelViewer>` component, both thin reactivity bridges over
+ * `createModelPreviewController` — never a separate viewer. Shared contracts pass through from the
+ * controller (the D1 drift firewall).
+ */
+export { useModelViewer } from './use-model-viewer.js';
+export type { ModelViewerHandle, UseModelViewerOptions, ModelPreviewControls, ModelPreviewState, ModelViewerEvent, ModelReadyInfo } from './use-model-viewer.js';
+export { ModelViewer } from './model-viewer-component.js';
+export type { ModelViewerProps, ModelViewerSource } from './model-viewer-component.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/model/index.js

@@ -0,0 +1,9 @@
+/**
+ * @chestnutlabs/gcode-preview-react/model — the React integration for interactive **source-model**
+ * viewing (STL / 3MF), the Prepare-side counterpart to the toolpath `<GcodePreview>` (DD-031).
+ * `useModelViewer` hook + `<ModelViewer>` component, both thin reactivity bridges over
+ * `createModelPreviewController` — never a separate viewer. Shared contracts pass through from the
+ * controller (the D1 drift firewall).
+ */
+export { useModelViewer } from './use-model-viewer.js';
+export { ModelViewer } from './model-viewer-component.js';

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

@@ -0,0 +1,44 @@
+import type { CameraMode, CameraState, CameraView, GLRendererLike, InteractiveStageOptions, LoadProgress, RenderTargetCanvas } from '@chestnutlabs/gcode-renderer-three';
+import type { ModelBackground, ModelLimits, ModelLoader, ModelReadyInfo, ModelSourceInput, PresentationView, RenderScope } from '@chestnutlabs/gcode-model-renderer';
+import { type ModelViewerHandle } from './use-model-viewer.js';
+export type ModelViewerSource = ModelSourceInput | null;
+export interface ModelViewerProps {
+    /** The one prop needed in practice: the source model. Changing it re-parses. */
+    source?: ModelViewerSource;
+    /** Snap to a preset orientation (shared vocabulary with the toolpath camera). */
+    view?: PresentationView | CameraView;
+    /** Restore a saved camera pose. Pair with `onCameraChange` for a two-way binding. */
+    cameraState?: CameraState | null;
+    /** `'transparent'` (default) | CSS colour | `0xRRGGBB`. */
+    background?: ModelBackground;
+    /** DD-020 interaction-aware quality; default `'auto'`. */
+    interactionQuality?: 'off' | 'auto';
+    /** Initial camera projection; default `'perspective'`. */
+    cameraMode?: CameraMode;
+    /** Render only a subset: `{ plateId }` / `{ objectIds }` / `{ instanceFilter }`; null = whole source. */
+    renderScope?: RenderScope | null;
+    /** Source-model triangle / byte caps. */
+    limits?: ModelLimits;
+    /** 3MF `paint_color` palette override (hex per 0-based slot). */
+    filamentPalette?: readonly (string | undefined)[];
+    /** Loader registry (open `kind`). Default: STL + 3MF. */
+    loaders?: readonly ModelLoader[];
+    /** Advanced/test: inject GL / orbit controls. */
+    createRenderer?: (canvas: RenderTargetCanvas) => GLRendererLike;
+    createControls?: NonNullable<InteractiveStageOptions['createControls']>;
+    onReady?: (info: ModelReadyInfo) => void;
+    onCameraChange?: (state: CameraState) => void;
+    onError?: (e: {
+        code: string;
+        message: string;
+    }) => void;
+    onRendererUnsupported?: (e: {
+        feature: string;
+        message: string;
+    }) => void;
+    onContextLost?: () => void;
+    onContextRestored?: () => void;
+    onProgress?: (progress: LoadProgress) => void;
+}
+export declare const ModelViewer: import("react").ForwardRefExoticComponent<ModelViewerProps & import("react").RefAttributes<ModelViewerHandle>>;
+//# sourceMappingURL=model-viewer-component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-viewer-component.d.ts","sourceRoot":"","sources":["../../src/model/model-viewer-component.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,EACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,EAEhB,gBAAgB,EAChB,WAAW,EACZ,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,IAAI,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,iFAAiF;IACjF,IAAI,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAAC;IACrC,qFAAqF;IACrF,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACpC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,yGAAyG;IACzG,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,yCAAyC;IACzC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iEAAiE;IACjE,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAClD,yDAAyD;IACzD,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,iDAAiD;IACjD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,cAAc,CAAC;IAChE,cAAc,CAAC,EAAE,WAAW,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACzC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACzD,qBAAqB,CAAC,EAAE,CAAC,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1E,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;CAC/C;AA8FD,eAAO,MAAM,WAAW,gHAA8B,CAAC"}

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

@@ -0,0 +1,89 @@
+/**
+ * <ModelViewer> — the ready-to-use React component for interactive source-model viewing (STL / 3MF),
+ * the Prepare-side counterpart to <GcodePreview> (DD-031). A SHELL over `useModelViewer`: every prop
+ * maps to a controls call, every callback re-fires a controller event, and the full handle is reachable
+ * via `ref`. `<ModelViewer source={file} />` alone is a working viewer.
+ *
+ * createElement (no JSX) on purpose — the template is a single full-size <canvas>.
+ */
+import { createElement, forwardRef, useEffect, useImperativeHandle, useRef } from 'react';
+import { useModelViewer } from './use-model-viewer.js';
+function ModelViewerImpl(props, ref) {
+    const { source = null, view, cameraState, background, interactionQuality, cameraMode, renderScope, limits, filamentPalette, loaders, createRenderer, createControls } = props;
+    // Construction-time options (stable for the controller's lifetime).
+    const viewer = useModelViewer({
+        ...(background !== undefined ? { background } : {}),
+        ...(interactionQuality !== undefined ? { interactionQuality } : {}),
+        ...(cameraMode !== undefined ? { cameraMode } : {}),
+        ...(limits !== undefined ? { limits } : {}),
+        ...(filamentPalette !== undefined ? { filamentPalette } : {}),
+        ...(loaders !== undefined ? { loaders } : {}),
+        ...(renderScope != null ? { renderScope } : {}),
+        ...(createRenderer !== undefined ? { createRenderer } : {}),
+        ...(createControls !== undefined ? { createControls } : {}),
+        onProgress: (p) => cbRef.current.onProgress?.(p)
+    });
+    useImperativeHandle(ref, () => viewer, [viewer]);
+    // Latest callbacks without re-subscribing the event bridge.
+    const cbRef = useRef(props);
+    cbRef.current = props;
+    useEffect(() => {
+        return viewer.onEvent((e) => {
+            const cb = cbRef.current;
+            switch (e.type) {
+                case 'ready':
+                    cb.onReady?.(e.info);
+                    break;
+                case 'camera-changed':
+                    cb.onCameraChange?.(e.state);
+                    break;
+                case 'error':
+                    cb.onError?.({ code: e.code, message: e.message });
+                    break;
+                case 'renderer-unsupported':
+                    cb.onRendererUnsupported?.({ feature: e.feature, message: e.message });
+                    break;
+                case 'context-lost':
+                    cb.onContextLost?.();
+                    break;
+                case 'context-restored':
+                    cb.onContextRestored?.();
+                    break;
+                default:
+                    break;
+            }
+        });
+    }, [viewer]);
+    // ---- runtime prop wiring (each a thin controls call) ----
+    useEffect(() => {
+        if (source !== null && source !== undefined)
+            void viewer.controls.setSource(source);
+    }, [viewer, source]);
+    useEffect(() => {
+        if (view !== undefined)
+            viewer.controls.setView(view);
+    }, [viewer, view]);
+    useEffect(() => {
+        if (cameraState !== undefined && cameraState !== null)
+            viewer.controls.setCameraState(cameraState);
+    }, [viewer, cameraState]);
+    useEffect(() => {
+        if (background !== undefined)
+            viewer.controls.setBackground(background);
+    }, [viewer, background]);
+    useEffect(() => {
+        if (interactionQuality !== undefined)
+            viewer.controls.setInteractionQuality(interactionQuality);
+    }, [viewer, interactionQuality]);
+    useEffect(() => {
+        if (renderScope !== undefined)
+            viewer.controls.setRenderScope(renderScope);
+    }, [viewer, renderScope]);
+    return createElement('canvas', {
+        ref: viewer.canvasRef,
+        style: { width: '100%', height: '100%', display: 'block', touchAction: 'none' },
+        tabIndex: 0,
+        'aria-label': '3D source-model preview'
+    });
+}
+export const ModelViewer = forwardRef(ModelViewerImpl);

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

@@ -0,0 +1,22 @@
+import { type ModelPreviewControllerOptions, type ModelPreviewControls, type ModelPreviewState, type ModelViewer, type ModelViewerEvent, type ModelReadyInfo } from '@chestnutlabs/gcode-model-renderer';
+import type { CaptureOptions } from '@chestnutlabs/gcode-renderer-three';
+export type { ModelPreviewControls, ModelPreviewState, ModelViewerEvent, ModelReadyInfo };
+export type UseModelViewerOptions = ModelPreviewControllerOptions;
+export interface ModelViewerHandle {
+    /** Attach as `<canvas ref={viewer.canvasRef} />`; null detaches safely. */
+    canvasRef: (el: HTMLCanvasElement | null) => void;
+    /** Parse → build → frame → `ready`. Also reachable as `controls.setSource`. */
+    setSource: ModelPreviewControls['setSource'];
+    /** Capture the current view as an image `Blob` (also `controls.capture`). */
+    capture(opts?: CaptureOptions): Promise<Blob>;
+    /** Render-subscribed state snapshot (via useSyncExternalStore). */
+    state: ModelPreviewState;
+    controls: ModelPreviewControls;
+    raw: {
+        viewer: () => ModelViewer | null;
+    };
+    onEvent(cb: (e: ModelViewerEvent) => void): () => void;
+    dispose(): void;
+}
+export declare function useModelViewer(options?: UseModelViewerOptions): ModelViewerHandle;
+//# sourceMappingURL=use-model-viewer.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,51 @@
+/**
+ * `useModelViewer` — the React hook for interactive **source-model** viewing (the Prepare side),
+ * the analogue of `useGcodePreview` for the toolpath/Preview side (DD-031). A thin reactivity bridge
+ * over the framework-neutral `createModelPreviewController` from `@chestnutlabs/gcode-model-renderer`
+ * — 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 { createModelPreviewController } from '@chestnutlabs/gcode-model-renderer';
+export function useModelViewer(options = {}) {
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const slot = useRef({ controller: null, disposed: false, canvas: null });
+    const ensure = useCallback(() => {
+        const s = slot.current;
+        if (s.controller === null || s.disposed) {
+            s.controller = createModelPreviewController(optionsRef.current);
+            s.disposed = false;
+            if (s.canvas !== null)
+                s.controller.bindCanvas(s.canvas);
+        }
+        return s.controller;
+    }, []);
+    const subscribe = useCallback((cb) => ensure().onStateChange(() => cb()), [ensure]);
+    const getSnapshot = useCallback(() => ensure().getState(), [ensure]);
+    const state = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    const stateRef = useRef(state);
+    stateRef.current = state;
+    return useMemo(() => ({
+        canvasRef: (el) => {
+            slot.current.canvas = el;
+            ensure().bindCanvas(el);
+        },
+        setSource: (input) => ensure().controls.setSource(input),
+        capture: (opts) => ensure().controls.capture(opts),
+        get state() {
+            return stateRef.current;
+        },
+        get controls() {
+            return ensure().controls;
+        },
+        get raw() {
+            return ensure().raw;
+        },
+        onEvent: (cb) => ensure().onEvent(cb),
+        dispose: () => {
+            slot.current.controller?.dispose();
+            slot.current.disposed = true;
+        }
+    }), [ensure]);
+}

package/dist/use-gcode-preview.d.ts

@@ -1,6 +1,6 @@
 import type { GcodeParseSession, WireParseOptions } from '@chestnutlabs/gcode-parser';
 import type { MappedProgress, ProgressObservation } from '@chestnutlabs/toolpath-core';
-import { type GcodePreviewControls, type GcodePreviewState, type ParseOutcome, type PreviewControllerOptions, type PreviewEvent, type PreviewRenderer } from '@chestnutlabs/gcode-preview-core';
+import { type CaptureOptions, type GcodePreviewControls, type GcodePreviewState, type ParseOutcome, type PreviewControllerOptions, type PreviewEvent, type PreviewRenderer } from '@chestnutlabs/gcode-preview-core';
 export type { GcodePreviewControls, GcodePreviewState, ParseOutcome, PreviewEvent, PreviewRenderer, RendererMode } from '@chestnutlabs/gcode-preview-core';
 /** React-facing options — identical to the controller's (the alias is the public name). */
 export type UseGcodePreviewOptions = PreviewControllerOptions;
@@ -12,6 +12,9 @@ export interface GcodePreviewHandle {
     observeProgress(obs: ProgressObservation): MappedProgress | null;
     tickProgress(nowMs: number): MappedProgress | null;
     clearProgress(): void;
+    /** Capture the current view as an image `Blob` (DD-030 D1, DD-031 G5) — handle-level parity with the
+     *  Web Component's `capture()`. Also reachable as `controls.capture`. Rejects on the 2D renderer. */
+    capture(opts?: CaptureOptions): Promise<Blob>;
     /** Current state snapshot — render-subscribed via useSyncExternalStore. */
     state: GcodePreviewState;
     controls: GcodePreviewControls;

package/dist/use-gcode-preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-gcode-preview.d.ts","sourceRoot":"","sources":["../src/use-gcode-preview.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAEjB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,kCAAkC,CAAC;AAG1C,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,YAAY,EACb,MAAM,kCAAkC,CAAC;AAE1C,2FAA2F;AAC3F,MAAM,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,SAAS,EAAE,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9F,MAAM,IAAI,IAAI,CAAC;IACf,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,cAAc,GAAG,IAAI,CAAC;IACjE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACnD,aAAa,IAAI,IAAI,CAAC;IACtB,2EAA2E;IAC3E,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,GAAG,EAAE;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,QAAQ,EAAE,MAAM,eAAe,GAAG,IAAI,CAAA;KAAE,CAAC;IAC5E,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnD,OAAO,IAAI,IAAI,CAAC;CACjB;AAUD,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,kBAAkB,CAiExF"}
+{"version":3,"file":"use-gcode-preview.d.ts","sourceRoot":"","sources":["../src/use-gcode-preview.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAEjB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,kCAAkC,CAAC;AAG1C,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,YAAY,EACb,MAAM,kCAAkC,CAAC;AAE1C,2FAA2F;AAC3F,MAAM,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,SAAS,EAAE,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9F,MAAM,IAAI,IAAI,CAAC;IACf,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,cAAc,GAAG,IAAI,CAAC;IACjE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACnD,aAAa,IAAI,IAAI,CAAC;IACtB;yGACqG;IACrG,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,2EAA2E;IAC3E,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,GAAG,EAAE;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,QAAQ,EAAE,MAAM,eAAe,GAAG,IAAI,CAAA;KAAE,CAAC;IAC5E,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnD,OAAO,IAAI,IAAI,CAAC;CACjB;AAUD,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,kBAAkB,CAkExF"}

package/dist/use-gcode-preview.js

@@ -56,6 +56,7 @@ export function useGcodePreview(options = {}) {
         observeProgress: (obs) => slot.current.controller?.observeProgress(obs) ?? null,
         tickProgress: (nowMs) => slot.current.controller?.tickProgress(nowMs) ?? null,
         clearProgress: () => slot.current.controller?.clearProgress(),
+        capture: (opts) => ensure().controls.capture(opts),
         get state() {
             return stateRef.current;
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chestnutlabs/gcode-preview-react",
-  "version": "0.18.0",
+  "version": "0.20.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",
@@ -35,6 +35,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./model": {
+      "types": "./dist/model/index.d.ts",
+      "import": "./dist/model/index.js"
     }
   },
   "files": [
@@ -49,10 +53,11 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@chestnutlabs/gcode-parser": "0.18.0",
-    "@chestnutlabs/gcode-preview-core": "0.18.0",
-    "@chestnutlabs/gcode-renderer-three": "0.18.0",
-    "@chestnutlabs/toolpath-core": "0.18.0"
+    "@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"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"