@chestnutlabs/gcode-preview-svelte 0.18.0 → 0.20.0

package/README.md

@@ -25,14 +25,20 @@ it automatically; pnpm/yarn users add it explicitly. See the
 </div>
 ```
 
-That is a complete viewer. The component ships as a **raw `.svelte` file** (standard Svelte
-library packaging — your bundler's svelte plugin compiles it via the `svelte` export condition).
-Full defaulted prop surface: `source`, `parseOptions`, `buildVolume` (consumer-wins bed
-precedence), `quality`, `colorMode`, `layerRange`, `scrub`, `showTravel`, `progress` (DD-006
-observation), `createWorker`. Events: `ready`, `parseerror`, `parsecancelled`, `parseprogress`,
-`buildcomplete`, `qualityfallback`, `machinegeometrymismatch`/`discovered`,
-`progresspresentationchanged`, `disclosure`, `error`. The full handle is exported as `preview`
-(`bind:this` then `.preview`).
+That is a complete viewer. The component ships from the `/GcodePreview.svelte` subpath as a **raw
+`.svelte` file** (standard Svelte library packaging — your bundler's svelte plugin compiles it via
+the `svelte` export condition), not from the package index. The ~24-prop defaulted surface covers
+`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), and `createWorker`. Events (13):
+`ready`, `camerachange`, `parseerror`, `parsecancelled`, `parseprogress`, `stage`, `buildcomplete`,
+`qualityfallback`, `machinegeometrymismatch`/`discovered`, `progresspresentationchanged`,
+`disclosure`, `error`. The full handle is exported as `preview` (`bind:this` then `.preview`); its
+`controls` reach the imperative surface — `getRenderStats()` (render diagnostics),
+`pickSegment(ndcX, ndcY, threshold?)` (source-mapping / picking), `isColorModeAvailable(mode)`, and
+`capture(opts?)` (image `Blob`, also `preview.capture`). The handle `state` carries capability-aware
+UI data (`availableColorModes`, `hasRetractions`, `hasColorChanges`).
 
 ## Store/action API (build your own controls)
 
@@ -61,7 +67,44 @@ Batteries default (all dialect adapters + `.gcode.3mf`) needs zero setup under V
 identical across all three framework adapters by design (see the Vue README for the shared worker
 documentation).
 
-## Example
+## Model viewing (Prepare side)
 
-`tools/example-svelte` in the repository is a complete Vite + Svelte app (corpus load,
-layer/scrub, simulated live progress) compiling the raw component through the export condition.
+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.
+
+```svelte
+<script>
+  import ModelViewer from '@chestnutlabs/gcode-preview-svelte/model/ModelViewer.svelte';
+  export let bytes;
+</script>
+
+<div style="height: 70vh">
+  <ModelViewer
+    source={{ kind: '3mf', bytes }}
+    on:ready={(e) => console.log(e.detail.objectCount, e.detail.materials)}
+  />
+</div>
+```
+
+`on:ready` (detail-wrapped, like the other Svelte events) carries the honest material-colour tier:
+`e.detail.materials` is `'known'` / `'approximated'` when the file declared colours the render used,
+and `'unavailable'` when it declared none (a neutral default, never faked). The `createModelViewer`
+store handle mirrors 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-svelte/model.html` for a runnable minimal page.
+
+## Examples
+
+`tools/example-svelte` in the repository is a Vite app with two tiers, both driving this published
+package through the `.svelte` export condition (no raw renderer or parser imports):
+
+- **`minimal.html`** — the smallest real integration: `<GcodePreview {source}>` plus a fixture
+  picker and a layer slider. One short component 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 `bind:this` handle
+  (`viewer.preview.controls`); the handle's store-contract `state` supplies the reactive UI data.
+
+Run it with `npm install --prefix tools/example-svelte && npm run dev --prefix tools/example-svelte`
+(port 5202).

package/dist/GcodePreview.svelte

@@ -51,6 +51,9 @@
   export let showRetractions = false;
   /** #306/#6: show the build-volume wireframe cage (independent of the bed/plate). Default true. */
   export let showVolumeCage = true;
+  /** DD-031 G3: feature roles to hide (e.g. `[FeatureRole.Skirt, FeatureRole.Brim]`). Declarative
+   *  form of `controls.setFeatureRoleVisible`; gate on `capabilities.featureRoles`. */
+  export let hiddenFeatureRoles = undefined;
   /** DD-006 live progress observation; null hides the overlay. */
   export let progress = null;
   /** Worker factory escape hatch (DD-005 slim/custom entries; D2). */
@@ -166,6 +169,18 @@
   $: if (progress === null || progress === undefined) preview.clearProgress();
   else preview.observeProgress(progress);
 
+  // Feature-role visibility (DD-031 G3): diff prev→next so we only toggle roles this prop owns.
+  // `roleState` is a plain object (property mutation isn't Svelte-tracked) so the reactive block
+  // depends only on `hiddenFeatureRoles` and can't loop on its own bookkeeping.
+  const roleState = { prev: [] };
+  function applyHiddenRoles(roles) {
+    const next = roles ?? [];
+    for (const role of roleState.prev) if (!next.includes(role)) preview.controls.setFeatureRoleVisible(role, true);
+    for (const role of next) if (!roleState.prev.includes(role)) preview.controls.setFeatureRoleVisible(role, false);
+    roleState.prev = [...next];
+  }
+  $: applyHiddenRoles(hiddenFeatureRoles);
+
   onDestroy(() => preview.dispose());
 </script>
 

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

@@ -10,7 +10,7 @@
  */
 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';
 /** Svelte-facing options — identical to the controller's (the alias is the public name). */
 export type CreateGcodePreviewOptions = PreviewControllerOptions;
@@ -34,6 +34,9 @@ export interface SvelteGcodePreview {
     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>;
     controls: GcodePreviewControls;
     raw: {
         session: GcodeParseSession;

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

@@ -1 +1 @@
-{"version":3,"file":"create-gcode-preview.d.ts","sourceRoot":"","sources":["../src/create-gcode-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,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,EACjB,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,4FAA4F;AAC5F,MAAM,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAEjE;4EAC4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAChE;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC;yEACqE;IACrE,KAAK,EAAE,aAAa,CAAC;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,EAAE,iBAAiB,GAAG,kBAAkB,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,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;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,kBAAkB,CAuB9F"}
+{"version":3,"file":"create-gcode-preview.d.ts","sourceRoot":"","sources":["../src/create-gcode-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,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,EACjB,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,4FAA4F;AAC5F,MAAM,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAEjE;4EAC4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAChE;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC;yEACqE;IACrE,KAAK,EAAE,aAAa,CAAC;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,EAAE,iBAAiB,GAAG,kBAAkB,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,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;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,kBAAkB,CAwB9F"}

package/dist/create-gcode-preview.js

@@ -17,6 +17,7 @@ export function createGcodePreview(options = {}) {
         observeProgress: controller.observeProgress,
         tickProgress: controller.tickProgress,
         clearProgress: controller.clearProgress,
+        capture: controller.controls.capture,
         controls: controller.controls,
         raw: controller.raw,
         onEvent: controller.onEvent,

package/dist/model/ModelViewer.svelte

@@ -0,0 +1,96 @@
+<script>
+  /**
+   * <ModelViewer> — the ready-to-use Svelte component for interactive source-model viewing (STL / 3MF),
+   * the Prepare-side counterpart to <GcodePreview> (DD-031). A SHELL over `createModelViewer` (the
+   * Svelte store/action handle): every prop is a reactive statement into the handle, every dispatched
+   * event re-fires a controller event, and the handle is exported for bind:this access (`viewer`).
+   * `<ModelViewer source={file} />` alone is a working viewer.
+   *
+   * Shipped RAW — the consumer's bundler compiles it via the "svelte" export condition.
+   */
+  import { createEventDispatcher, onDestroy } from 'svelte';
+  import { createModelViewer } from './create-model-viewer.js';
+
+  /** The source model. Changing it re-parses. */
+  export let source = null;
+  /** Snap to a preset orientation (shared vocabulary with the toolpath camera). */
+  export let view = undefined;
+  /** Restore a saved camera pose. Pair with the `camerachange` event for two-way binding. */
+  export let cameraState = undefined;
+  /** 'transparent' (default) | CSS colour | 0xRRGGBB. */
+  export let background = undefined;
+  /** DD-020 interaction-aware quality; default 'auto'. */
+  export let interactionQuality = undefined;
+  /** Initial camera projection; default 'perspective'. */
+  export let cameraMode = undefined;
+  /** Render only a subset: { plateId } / { objectIds } / { instanceFilter }; null = whole source. */
+  export let renderScope = undefined;
+  /** Source-model triangle / byte caps. */
+  export let limits = undefined;
+  /** 3MF paint_color palette override (hex per 0-based slot). */
+  export let filamentPalette = undefined;
+  /** Loader registry (open kind). Default: STL + 3MF. */
+  export let loaders = undefined;
+  /** Advanced/test: inject GL / orbit controls. */
+  export let createRenderer = undefined;
+  export let createControls = undefined;
+
+  const dispatch = createEventDispatcher();
+
+  /** The full store/action handle — reachable via bind:this={c} then c.viewer. */
+  export const viewer = createModelViewer({
+    background,
+    interactionQuality,
+    cameraMode,
+    limits,
+    filamentPalette,
+    loaders,
+    renderScope,
+    createRenderer,
+    createControls,
+    onProgress: (p) => dispatch('progress', p)
+  });
+
+  viewer.onEvent((e) => {
+    switch (e.type) {
+      case 'ready':
+        dispatch('ready', e.info);
+        break;
+      case 'camera-changed':
+        dispatch('camerachange', e.state);
+        break;
+      case 'error':
+        dispatch('error', { code: e.code, message: e.message });
+        break;
+      case 'renderer-unsupported':
+        dispatch('rendererunsupported', { feature: e.feature, message: e.message });
+        break;
+      case 'context-lost':
+        dispatch('contextlost');
+        break;
+      case 'context-restored':
+        dispatch('contextrestored');
+        break;
+      default:
+        break;
+    }
+  });
+
+  // ---- prop wiring: each prop is a thin reactive call into the handle (D1 shell rule) ----
+  $: if (source !== null && source !== undefined) void viewer.controls.setSource(source);
+  $: if (view !== undefined) viewer.controls.setView(view);
+  $: if (cameraState !== undefined && cameraState !== null) viewer.controls.setCameraState(cameraState);
+  $: if (background !== undefined) viewer.controls.setBackground(background);
+  $: if (interactionQuality !== undefined) viewer.controls.setInteractionQuality(interactionQuality);
+  $: if (renderScope !== undefined) viewer.controls.setRenderScope(renderScope);
+
+  onDestroy(() => viewer.dispose());
+</script>
+
+<!-- tabindex makes the canvas focusable → keyboard camera (DD-004 a11y) -->
+<canvas
+  use:viewer.canvas
+  tabindex="0"
+  style="width: 100%; height: 100%; display: block; touch-action: none;"
+  aria-label="3D source-model preview"
+></canvas>

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

@@ -0,0 +1,38 @@
+/**
+ * createModelViewer — the Svelte reactivity bridge for interactive **source-model** viewing (the
+ * Prepare side), the analogue of `createGcodePreview` for the toolpath/Preview side (DD-031). Owns
+ * only the Svelte-isms: a store-contract `state` (subscribe receiving controller snapshots) and a
+ * `use:` action for the canvas. Engine/state/contracts live in `@chestnutlabs/gcode-model-renderer`
+ * and are re-exported, never redeclared (the D1 drift firewall).
+ *
+ * Named `createModelViewer` to parallel `createGcodePreview`; the underlying engine factory of the same
+ * name is imported here under an alias.
+ */
+import { type ModelPreviewControllerOptions, type ModelPreviewControls, type ModelPreviewState, type ModelViewer as ModelViewerEngine, type ModelViewerEvent, type ModelReadyInfo } from '@chestnutlabs/gcode-model-renderer';
+import type { CaptureOptions } from '@chestnutlabs/gcode-renderer-three';
+export type { ModelPreviewControls, ModelPreviewState, ModelViewerEvent, ModelReadyInfo };
+/** Svelte-facing options — identical to the controller's (the alias is the public name). */
+export type CreateModelViewerOptions = ModelPreviewControllerOptions;
+/** Minimal svelte/store Readable contract — declared structurally so the shipped JS never imports 'svelte'. */
+export interface ReadableModelState {
+    subscribe(run: (state: ModelPreviewState) => void): () => void;
+}
+export interface CanvasActionResult {
+    destroy(): void;
+}
+export interface SvelteModelViewer {
+    /** Store-contract state: subscribers get the current snapshot immediately, then every replacement. */
+    state: ReadableModelState;
+    /** Canvas binding as a Svelte action: `<canvas use:viewer.canvas />`. */
+    canvas(el: HTMLCanvasElement): CanvasActionResult;
+    setSource: ModelPreviewControls['setSource'];
+    capture(opts?: CaptureOptions): Promise<Blob>;
+    controls: ModelPreviewControls;
+    raw: {
+        viewer: () => ModelViewerEngine | null;
+    };
+    onEvent(cb: (e: ModelViewerEvent) => void): () => void;
+    dispose(): void;
+}
+export declare function createModelViewer(options?: CreateModelViewerOptions): SvelteModelViewer;
+//# sourceMappingURL=create-model-viewer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-model-viewer.d.ts","sourceRoot":"","sources":["../../src/model/create-model-viewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,WAAW,IAAI,iBAAiB,EACrC,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,4FAA4F;AAC5F,MAAM,MAAM,wBAAwB,GAAG,6BAA6B,CAAC;AAErE,+GAA+G;AAC/G,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAChE;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,sGAAsG;IACtG,KAAK,EAAE,kBAAkB,CAAC;IAC1B,yEAAyE;IACzE,MAAM,CAAC,EAAE,EAAE,iBAAiB,GAAG,kBAAkB,CAAC;IAClD,SAAS,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,iBAAiB,GAAG,IAAI,CAAA;KAAE,CAAC;IAChD,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,iBAAiB,CAoB3F"}

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

@@ -0,0 +1,32 @@
+/**
+ * createModelViewer — the Svelte reactivity bridge for interactive **source-model** viewing (the
+ * Prepare side), the analogue of `createGcodePreview` for the toolpath/Preview side (DD-031). Owns
+ * only the Svelte-isms: a store-contract `state` (subscribe receiving controller snapshots) and a
+ * `use:` action for the canvas. Engine/state/contracts live in `@chestnutlabs/gcode-model-renderer`
+ * and are re-exported, never redeclared (the D1 drift firewall).
+ *
+ * Named `createModelViewer` to parallel `createGcodePreview`; the underlying engine factory of the same
+ * name is imported here under an alias.
+ */
+import { createModelPreviewController } from '@chestnutlabs/gcode-model-renderer';
+export function createModelViewer(options = {}) {
+    const controller = createModelPreviewController(options);
+    return {
+        state: {
+            subscribe(run) {
+                run(controller.getState()); // store contract: immediate emission
+                return controller.onStateChange(run);
+            }
+        },
+        canvas: (el) => {
+            controller.bindCanvas(el);
+            return { destroy: () => controller.bindCanvas(null) };
+        },
+        setSource: controller.controls.setSource,
+        capture: controller.controls.capture,
+        controls: controller.controls,
+        raw: controller.raw,
+        onEvent: controller.onEvent,
+        dispose: controller.dispose
+    };
+}

package/dist/model/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @chestnutlabs/gcode-preview-svelte/model — the Svelte integration for interactive **source-model**
+ * viewing (STL / 3MF), the Prepare-side counterpart to the toolpath API (DD-031). `createModelViewer`
+ * store/action handle + the raw `ModelViewer.svelte` component (import from
+ * '@chestnutlabs/gcode-preview-svelte/model/ModelViewer.svelte'). Both are thin bridges over
+ * `createModelPreviewController` — never a separate viewer.
+ */
+export * from './create-model-viewer.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,cAAc,0BAA0B,CAAC"}

package/dist/model/index.js

@@ -0,0 +1,8 @@
+/**
+ * @chestnutlabs/gcode-preview-svelte/model — the Svelte integration for interactive **source-model**
+ * viewing (STL / 3MF), the Prepare-side counterpart to the toolpath API (DD-031). `createModelViewer`
+ * store/action handle + the raw `ModelViewer.svelte` component (import from
+ * '@chestnutlabs/gcode-preview-svelte/model/ModelViewer.svelte'). Both are thin bridges over
+ * `createModelPreviewController` — never a separate viewer.
+ */
+export * from './create-model-viewer.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chestnutlabs/gcode-preview-svelte",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Thin Svelte integration for the Chestnut Labs G-code viewer (DD-007 D1 amendment): createGcodePreview store/action API + GcodePreview component as a reactivity bridge over @chestnutlabs/gcode-preview-core.",
   "keywords": [
     "gcode",
@@ -41,6 +41,15 @@
     "./GcodePreview.svelte": {
       "svelte": "./dist/GcodePreview.svelte",
       "import": "./dist/GcodePreview.svelte"
+    },
+    "./model": {
+      "types": "./dist/model/index.d.ts",
+      "svelte": "./dist/model/index.js",
+      "import": "./dist/model/index.js"
+    },
+    "./model/ModelViewer.svelte": {
+      "svelte": "./dist/model/ModelViewer.svelte",
+      "import": "./dist/model/ModelViewer.svelte"
     }
   },
   "files": [
@@ -55,10 +64,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": {
     "svelte": "^4.0.0 || ^5.0.0"