@sienci/gviewer 0.1.29 → 0.1.32

package/dist/react.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const V=require("react"),F=require("./GCodeSVGRenderer-cfCcKFfP.cjs");function C(a){const d=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(a){for(const s in a)if(s!=="default"){const i=Object.getOwnPropertyDescriptor(a,s);Object.defineProperty(d,s,i.get?i:{enumerable:!0,get:()=>a[s]})}}return d.default=a,Object.freeze(d)}const o=C(V),G=o.forwardRef(function(d,s){const{id:i,options:l,callbacks:c,className:p,style:m}=d,u=o.useRef(null),r=o.useRef(null);return o.useEffect(()=>{const e=u.current;if(!e)return;const f=new F.GCodeViewer({id:i,container:e,options:l,callbacks:c});return r.current=f,()=>{r.current=null,f.dispose()}},[i]),o.useEffect(()=>{var e;(e=r.current)==null||e.setOptions(l??{})},[l]),o.useEffect(()=>{var e;(e=r.current)==null||e.setCallbacks(c??{})},[c]),o.useImperativeHandle(s,()=>{const e=()=>{const t=r.current;if(!t)throw new Error("GCodeViewer is not ready.");return t};return{get id(){return i},setCallbacks(t){e().setCallbacks(t)},snapCameraToView(t,n){e().snapCameraToView(t,n)},setRotateEnabled(t){e().setRotateEnabled(t)},setCameraFollowEnabled(t){e().setCameraFollowEnabled(t)},screenToWorld(t,n,w){return e().screenToWorld(t,n,w)},worldToScreen(t,n,w){return e().worldToScreen(t,n,w)},setBitPosition(t,n){e().setBitPosition(t,n)},setBitVisible(t){e().setBitVisible(t)},setBitSpinning(t){e().setBitSpinning(t)},setToolpathRotationA(t){e().setToolpathRotationA(t)},hideUntilLine(t,n){e().hideUntilLine(t,n)},seekToLine(t,n){e().seekToLine(t,n)},showAll(){e().showAll()},resetColors(){e().resetColors()},loadFromUrl(t,n){return e().loadFromUrl(t,n)},loadFromFile(t){return e().loadFromFile(t)},loadFromText(t){return e().loadFromText(t)},loadFromLines(t){return e().loadFromLines(t)},loadFromWorkerData(t){return e().loadFromWorkerData(t)},unload(){e().unload()},setOptions(t){e().setOptions(t)},getOptions(){return e().getOptions()},resize(){e().resize()},focusToModel(){e().focusToModel()},resetCamera(){e().resetCamera()},getBounds(){return e().getBounds()},dispose(){e().dispose()}}},[i]),o.createElement("div",{ref:u,className:p,style:m})}),b=o.forwardRef(function(d,s){const{id:i,options:l,className:c,style:p}=d,m=o.useRef(null),u=o.useRef(null);return o.useEffect(()=>{const r=m.current;if(!r)return;const e=new F.GCodeSVGRenderer(r,l);return u.current=e,()=>{u.current=null,e.dispose()}},[]),o.useEffect(()=>{var r;l&&((r=u.current)==null||r.setOptions(l))},[l]),o.useImperativeHandle(s,()=>{const r=()=>{const e=u.current;if(!e)throw new Error("GCodeSVGRenderer is not ready.");return e};return{loadFromLines:e=>r().loadFromLines(e),loadFromFile:e=>r().loadFromFile(e),loadFromText:e=>r().loadFromText(e),loadFromWorkerData:e=>r().loadFromWorkerData(e),loadFromPrecomputedGroups:(e,f)=>r().loadFromPrecomputedGroups(e,f),clear:()=>r().clear(),resetView:()=>r().resetView(),setOptions:e=>r().setOptions(e),setProjectionMode:e=>r().setProjectionMode(e),setBitPosition:e=>r().setBitPosition(e),setBitVisible:e=>r().setBitVisible(e),getSVGElement:()=>r().getSVGElement(),dispose:()=>r().dispose()}},[]),o.createElement("div",{ref:m,className:c,style:{width:"100%",height:"100%",...p}})});exports.GCodeSVGVisualizer=b;exports.GCodeVisualizer=G;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const F=require("react"),C=require("./GCodeSVGRenderer-i9duYU8q.cjs");function V(l){const d=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(l){for(const s in l)if(s!=="default"){const i=Object.getOwnPropertyDescriptor(l,s);Object.defineProperty(d,s,i.get?i:{enumerable:!0,get:()=>l[s]})}}return d.default=l,Object.freeze(d)}const o=V(F),g=o.forwardRef(function(d,s){const{id:i,options:a,callbacks:u,className:p,style:f}=d,c=o.useRef(null),r=o.useRef(null);return o.useEffect(()=>{const e=c.current;if(!e)return;const m=new C.GCodeViewer({id:i,container:e,options:a,callbacks:u});return r.current=m,()=>{r.current=null,m.dispose()}},[i]),o.useEffect(()=>{var e;(e=r.current)==null||e.setOptions(a??{})},[a]),o.useEffect(()=>{var e;(e=r.current)==null||e.setCallbacks(u??{})},[u]),o.useImperativeHandle(s,()=>{const e=()=>{const t=r.current;if(!t)throw new Error("GCodeViewer is not ready.");return t};return{get id(){return i},setCallbacks(t){e().setCallbacks(t)},snapCameraToView(t,n){e().snapCameraToView(t,n)},setCameraProjection(t){e().setCameraProjection(t)},getCameraProjection(){return e().getCameraProjection()},setRotateEnabled(t){e().setRotateEnabled(t)},setCameraFollowEnabled(t){e().setCameraFollowEnabled(t)},screenToWorld(t,n,w){return e().screenToWorld(t,n,w)},worldToScreen(t,n,w){return e().worldToScreen(t,n,w)},setBitPosition(t,n){e().setBitPosition(t,n)},setBitVisible(t){e().setBitVisible(t)},setBitSpinning(t){e().setBitSpinning(t)},setToolpathRotationA(t){e().setToolpathRotationA(t)},hideUntilLine(t,n){e().hideUntilLine(t,n)},seekToLine(t,n){e().seekToLine(t,n)},showAll(){e().showAll()},resetColors(){e().resetColors()},loadFromUrl(t,n){return e().loadFromUrl(t,n)},loadFromFile(t){return e().loadFromFile(t)},loadFromText(t){return e().loadFromText(t)},loadFromLines(t){return e().loadFromLines(t)},loadFromWorkerData(t){return e().loadFromWorkerData(t)},unload(){e().unload()},setOptions(t){e().setOptions(t)},getOptions(){return e().getOptions()},resize(){e().resize()},focusToModel(){e().focusToModel()},resetCamera(){e().resetCamera()},getBounds(){return e().getBounds()},dispose(){e().dispose()}}},[i]),o.createElement("div",{ref:c,className:p,style:f})}),G=o.forwardRef(function(d,s){const{id:i,options:a,className:u,style:p}=d,f=o.useRef(null),c=o.useRef(null);return o.useEffect(()=>{const r=f.current;if(!r)return;const e=new C.GCodeSVGRenderer(r,a);return c.current=e,()=>{c.current=null,e.dispose()}},[]),o.useEffect(()=>{var r;a&&((r=c.current)==null||r.setOptions(a))},[a]),o.useImperativeHandle(s,()=>{const r=()=>{const e=c.current;if(!e)throw new Error("GCodeSVGRenderer is not ready.");return e};return{loadFromLines:e=>r().loadFromLines(e),loadFromFile:e=>r().loadFromFile(e),loadFromText:e=>r().loadFromText(e),loadFromWorkerData:e=>r().loadFromWorkerData(e),loadFromPrecomputedGroups:(e,m)=>r().loadFromPrecomputedGroups(e,m),clear:()=>r().clear(),resetView:()=>r().resetView(),setOptions:e=>r().setOptions(e),setProjectionMode:e=>r().setProjectionMode(e),setBitPosition:e=>r().setBitPosition(e),setBitVisible:e=>r().setBitVisible(e),getSVGElement:()=>r().getSVGElement(),dispose:()=>r().dispose()}},[]),o.createElement("div",{ref:f,className:u,style:{width:"100%",height:"100%",...p}})});exports.GCodeSVGVisualizer=G;exports.GCodeVisualizer=g;

package/dist/react.js

@@ -1,23 +1,23 @@
 import * as o from "react";
-import { a as w, G as V } from "./GCodeSVGRenderer-BezIPixY.js";
+import { a as w, G as C } from "./GCodeSVGRenderer-D4QGoHWJ.js";
 const G = o.forwardRef(
-  function(c, m) {
-    const { id: l, options: n, callbacks: a, className: f, style: u } = c, i = o.useRef(null), t = o.useRef(null);
+  function(u, m) {
+    const { id: a, options: s, callbacks: l, className: f, style: c } = u, i = o.useRef(null), t = o.useRef(null);
     return o.useEffect(() => {
       const e = i.current;
       if (!e)
         return;
-      const d = new w({ id: l, container: e, options: n, callbacks: a });
+      const d = new w({ id: a, container: e, options: s, callbacks: l });
       return t.current = d, () => {
         t.current = null, d.dispose();
       };
-    }, [l]), o.useEffect(() => {
+    }, [a]), o.useEffect(() => {
       var e;
-      (e = t.current) == null || e.setOptions(n ?? {});
-    }, [n]), o.useEffect(() => {
+      (e = t.current) == null || e.setOptions(s ?? {});
+    }, [s]), o.useEffect(() => {
       var e;
-      (e = t.current) == null || e.setCallbacks(a ?? {});
-    }, [a]), o.useImperativeHandle(
+      (e = t.current) == null || e.setCallbacks(l ?? {});
+    }, [l]), o.useImperativeHandle(
       m,
       () => {
         const e = () => {
@@ -28,13 +28,19 @@ const G = o.forwardRef(
         };
         return {
           get id() {
-            return l;
+            return a;
           },
           setCallbacks(r) {
             e().setCallbacks(r);
           },
-          snapCameraToView(r, s) {
-            e().snapCameraToView(r, s);
+          snapCameraToView(r, n) {
+            e().snapCameraToView(r, n);
+          },
+          setCameraProjection(r) {
+            e().setCameraProjection(r);
+          },
+          getCameraProjection() {
+            return e().getCameraProjection();
           },
           setRotateEnabled(r) {
             e().setRotateEnabled(r);
@@ -42,14 +48,14 @@ const G = o.forwardRef(
           setCameraFollowEnabled(r) {
             e().setCameraFollowEnabled(r);
           },
-          screenToWorld(r, s, p) {
-            return e().screenToWorld(r, s, p);
+          screenToWorld(r, n, p) {
+            return e().screenToWorld(r, n, p);
           },
-          worldToScreen(r, s, p) {
-            return e().worldToScreen(r, s, p);
+          worldToScreen(r, n, p) {
+            return e().worldToScreen(r, n, p);
           },
-          setBitPosition(r, s) {
-            e().setBitPosition(r, s);
+          setBitPosition(r, n) {
+            e().setBitPosition(r, n);
           },
           setBitVisible(r) {
             e().setBitVisible(r);
@@ -60,11 +66,11 @@ const G = o.forwardRef(
           setToolpathRotationA(r) {
             e().setToolpathRotationA(r);
           },
-          hideUntilLine(r, s) {
-            e().hideUntilLine(r, s);
+          hideUntilLine(r, n) {
+            e().hideUntilLine(r, n);
           },
-          seekToLine(r, s) {
-            e().seekToLine(r, s);
+          seekToLine(r, n) {
+            e().seekToLine(r, n);
           },
           showAll() {
             e().showAll();
@@ -72,8 +78,8 @@ const G = o.forwardRef(
           resetColors() {
             e().resetColors();
           },
-          loadFromUrl(r, s) {
-            return e().loadFromUrl(r, s);
+          loadFromUrl(r, n) {
+            return e().loadFromUrl(r, n);
           },
           loadFromFile(r) {
             return e().loadFromFile(r);
@@ -113,23 +119,23 @@ const G = o.forwardRef(
           }
         };
       },
-      [l]
-    ), o.createElement("div", { ref: i, className: f, style: u });
+      [a]
+    ), o.createElement("div", { ref: i, className: f, style: c });
   }
 ), R = o.forwardRef(
-  function(c, m) {
-    const { id: l, options: n, className: a, style: f } = c, u = o.useRef(null), i = o.useRef(null);
+  function(u, m) {
+    const { id: a, options: s, className: l, style: f } = u, c = o.useRef(null), i = o.useRef(null);
     return o.useEffect(() => {
-      const t = u.current;
+      const t = c.current;
       if (!t) return;
-      const e = new V(t, n);
+      const e = new C(t, s);
       return i.current = e, () => {
         i.current = null, e.dispose();
       };
     }, []), o.useEffect(() => {
       var t;
-      n && ((t = i.current) == null || t.setOptions(n));
-    }, [n]), o.useImperativeHandle(m, () => {
+      s && ((t = i.current) == null || t.setOptions(s));
+    }, [s]), o.useImperativeHandle(m, () => {
       const t = () => {
         const e = i.current;
         if (!e) throw new Error("GCodeSVGRenderer is not ready.");
@@ -151,8 +157,8 @@ const G = o.forwardRef(
         dispose: () => t().dispose()
       };
     }, []), o.createElement("div", {
-      ref: u,
-      className: a,
+      ref: c,
+      className: l,
       style: { width: "100%", height: "100%", ...f }
     });
   }

package/dist/types/geometry.d.ts

@@ -1,4 +1,4 @@
-import { ArcMoveCallback, LinearMoveCallback, Position, WorkerGeometryData } from "./types";
+import { ArcMoveCallback, LinearMoveCallback, Position, WorkerGeometryData, LoadWorkerDataOptions } from "./types";
 export type VertexCollector = {
     onLinearMove?: (args: Parameters<LinearMoveCallback>[0], vertices: number[]) => void;
     onArcMove?: (args: Parameters<ArcMoveCallback>[0], vertices: number[]) => void;
@@ -101,13 +101,18 @@ export type WorkerToolpathStream = {
     positions: Float32Array;
     colors: Float32Array;
     prefixEndVertex: Int32Array;
+    /**
+     * Index into the `lineGroups` this stream was built for, or null for the
+     * catch-all stream holding lines that fell in no group.
+     */
+    lineGroupIndex: number | null;
 };
 export type WorkerToolpathStreams = {
-    rapid: WorkerToolpathStream;
-    cut: WorkerToolpathStream;
+    rapids: WorkerToolpathStream[];
+    cuts: WorkerToolpathStream[];
 };
 /**
- * Builds two line-ordered toolpath streams (rapid + cut) from worker geometry,
+ * Builds line-ordered toolpath streams (rapid + cut) from worker geometry,
  * preserving per-vertex colours and producing per-stream `prefixEndVertex`
  * arrays (indexed by source line) so `hideUntilLine`/progress greying works on
  * the worker-data path.
@@ -115,5 +120,18 @@ export type WorkerToolpathStreams = {
  * Unlike `buildWorkerSegmentGroups`, segments are appended in source-line order
  * (driven by `frames`) rather than grouped by colour, which is what the
  * cumulative `prefixEndVertex` cursor requires.
+ *
+ * With no `lineGroups`, the result is exactly one rapid stream and one cut
+ * stream, both with a null `lineGroupIndex`. Passing `lineGroups` splits both by
+ * source-line range instead - one rapid and one cut stream per group, plus a
+ * trailing pair for the lines in no group - so a host can hide an interior span
+ * by flipping those streams' visibility, which a single contiguous draw range
+ * (all `hideUntilLine` can offer) cannot express. Each group keeps its own
+ * carry-forward `prefixEndVertex`, so progress greying stays correct within
+ * every stream.
+ *
+ * Grouping costs an `Int32Array(framesLen)` per stream, so memory grows with
+ * lines x groups. It is meant for interactive review of a file already held in
+ * memory, not for the live job path.
  */
-export declare function buildWorkerToolpathStreams(data: WorkerGeometryData): WorkerToolpathStreams;
+export declare function buildWorkerToolpathStreams(data: WorkerGeometryData, options?: LoadWorkerDataOptions): WorkerToolpathStreams;

package/dist/types/types.d.ts

@@ -81,3 +81,26 @@ export type WorkerGeometryData = {
     isLaser?: boolean;
     toolchangeCount?: number;
 };
+/**
+ * An inclusive range of source lines the host wants to show or hide as a unit,
+ * e.g. everything cut with one tool.
+ *
+ * Indices are 0-based and match `hideUntilLine`/`seekToLine` — the same source
+ * line indexing used by `prefixEndVertex` — not 1-based editor line numbers.
+ */
+export type LineRangeGroup = {
+    start: number;
+    end: number;
+};
+export type LoadWorkerDataOptions = {
+    /**
+     * Split the toolpath into separately hideable streams by source-line range,
+     * so `setLineGroupVisible` can hide an interior span. Without this the
+     * toolpath is one rapid stream plus one cut stream, and only a *prefix* can
+     * be hidden (via `hideUntilLine`, which sets a single contiguous draw range).
+     *
+     * Groups are matched in order, so where ranges overlap the first one wins.
+     * Lines in no group land in an always-visible stream.
+     */
+    lineGroups?: readonly LineRangeGroup[];
+};

package/dist/types/viewer/GCodeViewer.d.ts

@@ -1,5 +1,5 @@
-import type { WorkerGeometryData } from "../types";
-import { GCodeViewerCameraView, GCodeViewerBounds, GCodeViewerCallbacks, GCodeViewerCreateArgs, GCodeViewerHandle, GCodeViewerBitPosition, GCodeViewerOptions } from "./types";
+import type { LoadWorkerDataOptions, WorkerGeometryData } from "../types";
+import { GCodeViewerCameraProjection, GCodeViewerCameraView, GCodeViewerBounds, GCodeViewerCallbacks, GCodeViewerCreateArgs, GCodeViewerHandle, GCodeViewerBitPosition, GCodeViewerOptions } from "./types";
 export declare class GCodeViewer implements GCodeViewerHandle {
     readonly id: string;
     private readonly container;
@@ -7,7 +7,10 @@ export declare class GCodeViewer implements GCodeViewerHandle {
     private readonly renderer;
     private readonly scene;
     private readonly toolpathRoot;
-    private readonly camera;
+    private readonly perspectiveCamera;
+    private readonly orthographicCamera;
+    private camera;
+    private readonly orthoViewHeight;
     private readonly controls;
     private viewCube;
     private readonly viewCubeCorrection;
@@ -56,7 +59,35 @@ export declare class GCodeViewer implements GCodeViewerHandle {
     hideUntilLine(lineIndex: number, mode?: "hide" | "grey"): void;
     seekToLine(lineIndex: number, mode?: "hide" | "grey"): void;
     showAll(): void;
+    /**
+     * Show or hide one of the `lineGroups` the toolpath was loaded with.
+     *
+     * This is deliberately independent of `showAll()`, `hideUntilLine()` and
+     * `resetColors()`, which are all about *progress*: they move draw ranges and
+     * colors, while this flips object visibility. So the two compose in either
+     * order - but note a hidden group therefore stays hidden across a `showAll()`,
+     * which looks surprising if you expect "show all" to mean everything. Call
+     * `showAllLineGroups()` for that.
+     *
+     * A no-op when the load passed no `lineGroups`, or for the catch-all stream of
+     * lines outside every group, which has no index and is always visible.
+     */
+    setLineGroupVisible(groupIndex: number, visible: boolean): void;
+    showAllLineGroups(): void;
     resetColors(): void;
+    /**
+     * Swap the projection the viewer renders through, preserving the current
+     * framing and view direction. Delegates through setOptions so getOptions()
+     * stays the single source of truth for the active projection.
+     */
+    setCameraProjection(projection: GCodeViewerCameraProjection): void;
+    getCameraProjection(): GCodeViewerCameraProjection;
+    /**
+     * `options.distance` is the camera standoff, which only affects framing under
+     * a perspective camera; an orthographic camera frames by frustum height, so
+     * the value moves the camera without changing how much of the model is
+     * visible. Use focusToModel() to reframe in either projection.
+     */
     snapCameraToView(view: GCodeViewerCameraView, options?: {
         durationMs?: number;
         distance?: number;
@@ -100,14 +131,31 @@ export declare class GCodeViewer implements GCodeViewerHandle {
      * and mapped back onto the laid-out canvas rect, so overlays drawn in fixed
      * (viewport) coordinates line up with picked scene points and track pan/zoom.
      *
-     * `z` is the point's height in scene space (default 0); it changes the
-     * projected pixel under the perspective camera, so callers placing markers
-     * off the Z=0 plane should pass it. Returns null when the canvas has no layout.
+     * `z` is the point's height in scene space (default 0). It changes the
+     * projected pixel under the perspective camera (though not under an
+     * orthographic one, which has no divide-by-z), so callers placing markers off
+     * the Z=0 plane should pass it. Returns null when the canvas has no layout.
      */
     worldToScreen(x: number, y: number, z?: number): {
         x: number;
         y: number;
     } | null;
+    private isPerspectiveActive;
+    private viewportAspect;
+    /** Ortho zoom that frames `height` world units vertically. */
+    private orthoZoomForHeight;
+    /** World units the ortho camera currently frames vertically. */
+    private orthoFramedHeight;
+    private applyCameraDepthRange;
+    /**
+     * Swap the active camera, preserving view direction and apparent framing.
+     *
+     * The two projections are bridged by the vertical extent visible at the orbit
+     * target: an ortho frustum of that height shows the same content the
+     * perspective camera showed at that standoff. Going back the other way, the
+     * framed height determines the standoff to restore.
+     */
+    private setActiveProjection;
     private startSnapToView;
     private startCameraLerp;
     loadFromUrl(url: string, args?: {
@@ -116,7 +164,13 @@ export declare class GCodeViewer implements GCodeViewerHandle {
     loadFromFile(file: File): Promise<void>;
     loadFromText(gcode: string): Promise<void>;
     loadFromLines(lines: readonly string[]): Promise<void>;
-    loadFromWorkerData(data: WorkerGeometryData): Promise<void>;
+    /**
+     * Pass `options.lineGroups` to split the toolpath into separately hideable
+     * streams by source-line range; `setLineGroupVisible` then shows or hides a
+     * group. Without it the toolpath is one rapid + one cut stream, exactly as
+     * before, and only a prefix can be hidden (`hideUntilLine`).
+     */
+    loadFromWorkerData(data: WorkerGeometryData, options?: LoadWorkerDataOptions): Promise<void>;
     unload(): void;
     setOptions(next: Partial<GCodeViewerOptions>): void;
     getOptions(): Readonly<GCodeViewerOptions>;

package/dist/types/viewer/camera/camera.d.ts

@@ -1,5 +1,11 @@
 import * as THREE from "three";
+import { OrbitControls } from "three/examples/jsm/controls/OrbitControls.js";
 import type { GCodeViewerCameraView } from "../types";
+/** Either projection the viewer can render through. */
+export type GCodeViewerCameraLike = THREE.PerspectiveCamera | THREE.OrthographicCamera;
+export declare class VerticalInvertOrbitControls extends OrbitControls {
+    _rotateUp(angle: number): void;
+}
 export declare function ensureContainerOverlayLayout(container: HTMLElement): void;
 export declare function easeInOutCubic(t: number): number;
 export declare function viewDirection(view: GCodeViewerCameraView): THREE.Vector3;
@@ -13,9 +19,61 @@ export declare function dominantCameraFace(cameraPosition: {
     z: number;
 }): "front" | "back" | "left" | "right" | "top" | "bottom";
 export declare function orbitCameraByPixels(args: {
-    camera: THREE.PerspectiveCamera;
+    camera: GCodeViewerCameraLike;
     target: THREE.Vector3;
     deltaX: number;
     deltaY: number;
     speed?: number;
 }): void;
+/**
+ * Vertical world-space extent visible at `distance` under a perspective camera
+ * of vertical field of view `fovDeg`. The bridge between the two projections:
+ * an orthographic frustum of this height frames the same content as the
+ * perspective camera does at that distance.
+ */
+export declare function frustumHeightAtDistance(distance: number, fovDeg: number): number;
+/** Inverse of frustumHeightAtDistance: the standoff that frames `height`. */
+export declare function distanceForFrustumHeight(height: number, fovDeg: number): number;
+/**
+ * How far back to sit to frame a model of the given size. `size.z` is added
+ * rather than folded into the fit because the camera generally looks down at
+ * the model from above, so the model's height eats into the standoff.
+ */
+export declare function fitDistanceForBounds(size: {
+    x: number;
+    y: number;
+    z: number;
+}, fovDeg: number, margin?: number): number;
+/** Symmetric orthographic frustum framing `height` world units vertically. */
+export declare function orthoFrustumFor(height: number, aspect: number): {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+};
+/** Perspective near/far for a model of extent `maxDim`. */
+export declare function perspectiveDepthRange(maxDim: number): {
+    near: number;
+    far: number;
+};
+/**
+ * Orthographic near/far. Ortho depth is linear — there's no divide-by-z eating
+ * precision near the camera — so a negative near costs nothing and guarantees
+ * geometry behind the camera plane still draws, which matters because an ortho
+ * camera is routinely positioned inside or below the model it is framing.
+ */
+export declare function orthoDepthRange(distance: number, maxDim: number): {
+    near: number;
+    far: number;
+};
+/**
+ * Intersect a ray with the horizontal plane at `planeZ`.
+ *
+ * THREE.Ray.intersectPlane rejects hits behind the ray origin. Under a
+ * perspective camera that origin is the eye, and a backward hit really is a
+ * miss. Under ortho the origin sits on the camera plane, but the negative near
+ * from orthoDepthRange means geometry *behind* that plane is still on screen —
+ * so a pick plane above a camera dollied down into the model is a legitimate
+ * hit that intersectPlane would silently drop. Hence `allowBehind`.
+ */
+export declare function intersectRayWithZPlane(origin: THREE.Vector3, direction: THREE.Vector3, planeZ: number, allowBehind: boolean): THREE.Vector3 | null;

package/dist/types/viewer/index.d.ts

@@ -5,4 +5,4 @@ export type { GCodeViewerThemePresetName } from "./themes";
 export * from "./types";
 export { GCodeSVGRenderer } from "./svg/GCodeSVGRenderer";
 export type { GCodeSVGOptions } from "./svg/types";
-export type { WorkerGeometryData } from "../types";
+export type { LineRangeGroup, LoadWorkerDataOptions, WorkerGeometryData } from "../types";

package/dist/types/viewer/toolpath/streams.d.ts

@@ -10,6 +10,9 @@ export type ToolpathStreamState = {
     greyCursorVertex: number;
     kind: ToolpathStreamKind;
     cutBucketIndex: number | null;
+    /** Which of the load's `lineGroups` this stream holds, or null for the always-visible
+     *  catch-all and for ungrouped loads. Drives setLineGroupVisible. */
+    lineGroupIndex: number | null;
     /** Set when colors came from the worker's pre-baked colorArrayBuffer (e.g. toolchange palette).
      *  refreshToolpathStreamColors skips these streams so theme changes don't flatten per-tool colors. */
     workerColors?: Float32Array;
@@ -17,6 +20,7 @@ export type ToolpathStreamState = {
 export type ToolpathStreamSpec = {
     kind: ToolpathStreamKind;
     cutBucketIndex: number | null;
+    lineGroupIndex?: number | null;
     positions: Float32Array;
     prefixEndVertex: Int32Array;
     opacity: number;

package/dist/types/viewer/types.d.ts

@@ -109,6 +109,13 @@ export type GCodeViewerOptions = {
         theme: GCodeViewerTheme;
     };
     camera: {
+        /**
+         * Perspective is the default. Orthographic removes the divide-by-z, so
+         * toolpath segments sharing X/Y but differing in Z land on the same pixel
+         * in an axis-aligned view instead of splaying apart away from the centre.
+         */
+        projection: GCodeViewerCameraProjection;
+        /** Perspective vertical FOV. Also seeds ortho framing when projections swap. */
         fov: number;
         focusDurationMs: number;
         orbit: {
@@ -174,6 +181,8 @@ export type GCodeViewerHandle = {
         durationMs?: number;
         distance?: number;
     }): void;
+    setCameraProjection(projection: GCodeViewerCameraProjection): void;
+    getCameraProjection(): GCodeViewerCameraProjection;
     setRotateEnabled(enabled: boolean): void;
     setCameraFollowEnabled(enabled: boolean): void;
     screenToWorld(clientX: number, clientY: number, options?: {
@@ -219,4 +228,5 @@ export type GCodeViewerCreateArgs = {
     options?: Partial<GCodeViewerOptions>;
     callbacks?: GCodeViewerCallbacks;
 };
+export type GCodeViewerCameraProjection = "perspective" | "orthographic";
 export type GCodeViewerCameraView = "front" | "back" | "left" | "right" | "top" | "bottom" | "front-top-left" | "front-top-right" | "front-bottom-left" | "front-bottom-right" | "back-top-left" | "back-top-right" | "back-bottom-left" | "back-bottom-right";

package/dist/viewcube.css

@@ -53,6 +53,40 @@
 .gViewer-viewcube__face--top{ transform: rotateX(-90deg) translateZ(42px); }
 .gViewer-viewcube__face--bottom{ transform: rotateX(90deg) translateZ(42px); }
 
+.gViewer-viewcube__corner{
+  position:absolute;
+  width:20px;
+  height:20px;
+  top:32px;
+  left:32px;
+  border-radius:50%;
+  background:rgba(12,16,20,0.45);
+  border:1px solid rgba(120,140,160,0.30);
+  cursor:pointer;
+  padding:0;
+  user-select:none;
+}
+
+.gViewer-viewcube__corner:hover{
+  background:rgba(12,16,20,0.75);
+  border-color:rgba(160,190,220,0.65);
+}
+
+.gViewer-viewcube__corner.is-active{
+  border-color: rgba(96,165,250,0.95);
+  box-shadow: 0 0 0 1px rgba(96,165,250,0.35);
+}
+
+.gViewer-viewcube__corner--front-top-right{ transform: rotateY(45deg) rotateX(-35.264deg) translateZ(72.746px); }
+/* front-top-left is the restored gSender iso view; 35.264deg = atan(1/sqrt2), the tilt that points a face-oriented marker straight through a cube vertex */
+.gViewer-viewcube__corner--front-top-left{ transform: rotateY(-45deg) rotateX(-35.264deg) translateZ(72.746px); }
+.gViewer-viewcube__corner--front-bottom-right{ transform: rotateY(45deg) rotateX(35.264deg) translateZ(72.746px); }
+.gViewer-viewcube__corner--front-bottom-left{ transform: rotateY(-45deg) rotateX(35.264deg) translateZ(72.746px); }
+.gViewer-viewcube__corner--back-top-right{ transform: rotateY(135deg) rotateX(-35.264deg) translateZ(72.746px); }
+.gViewer-viewcube__corner--back-top-left{ transform: rotateY(-135deg) rotateX(-35.264deg) translateZ(72.746px); }
+.gViewer-viewcube__corner--back-bottom-right{ transform: rotateY(135deg) rotateX(35.264deg) translateZ(72.746px); }
+.gViewer-viewcube__corner--back-bottom-left{ transform: rotateY(-135deg) rotateX(35.264deg) translateZ(72.746px); }
+
 @media (orientation: portrait){
   .gViewer-viewcube{
     left:60px;
@@ -72,4 +106,20 @@
   .gViewer-viewcube__face--right{ transform: rotateY(90deg) translateZ(32px); }
   .gViewer-viewcube__face--top{ transform: rotateX(-90deg) translateZ(32px); }
   .gViewer-viewcube__face--bottom{ transform: rotateX(90deg) translateZ(32px); }
+
+  .gViewer-viewcube__corner{
+    width:15px;
+    height:15px;
+    top:24.5px;
+    left:24.5px;
+  }
+
+  .gViewer-viewcube__corner--front-top-right{ transform: rotateY(45deg) rotateX(-35.264deg) translateZ(55.426px); }
+  .gViewer-viewcube__corner--front-top-left{ transform: rotateY(-45deg) rotateX(-35.264deg) translateZ(55.426px); }
+  .gViewer-viewcube__corner--front-bottom-right{ transform: rotateY(45deg) rotateX(35.264deg) translateZ(55.426px); }
+  .gViewer-viewcube__corner--front-bottom-left{ transform: rotateY(-45deg) rotateX(35.264deg) translateZ(55.426px); }
+  .gViewer-viewcube__corner--back-top-right{ transform: rotateY(135deg) rotateX(-35.264deg) translateZ(55.426px); }
+  .gViewer-viewcube__corner--back-top-left{ transform: rotateY(-135deg) rotateX(-35.264deg) translateZ(55.426px); }
+  .gViewer-viewcube__corner--back-bottom-right{ transform: rotateY(135deg) rotateX(35.264deg) translateZ(55.426px); }
+  .gViewer-viewcube__corner--back-bottom-left{ transform: rotateY(-135deg) rotateX(35.264deg) translateZ(55.426px); }
 }

package/dist/viewer.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./GCodeSVGRenderer-cfCcKFfP.cjs"),a={dark:{background:"#111827",opacity:.9,rapidOpacity:.3,colors:{rapid:"#0ef6ae",cutting:"#3e85c7",laser:"#a855f7",processed:"#6b7280",boundingBox:"#e2e8f0",machineBed:"#f5a623",machineBedKeepout:"#df3b3b",grid:{major:"#77a9d7",minor:"#3e6e9e"},axes:{x:"#df3b3b",y:"#06b881",z:"#295d8d"}}},light:{background:"#e5e7eb",opacity:.9,rapidOpacity:.3,colors:{rapid:"#295d8d",cutting:"#111827",laser:"#FF0000",processed:"#9ca3af",boundingBox:"#4b5563",machineBed:"#b45309",machineBedKeepout:"#df3b3b",grid:{major:"#295d8d",minor:"#5191cc"},axes:{x:"#df3b3b",y:"#06b881",z:"#295d8d"}}},"flexoki-dark":{background:"#100f0f",opacity:.9,rapidOpacity:.3,colors:{rapid:"#DA702C",cutting:"#3AA99F",laser:"#8B7EC8",processed:"#6f6e69",boundingBox:"#cecdc3",machineBed:"#ffcc66",machineBedKeepout:"#d14d41",grid:{major:"#a89984",minor:"#6f6e69"},axes:{x:"#d14d41",y:"#879a39",z:"#4385be"}}},"tokyo-night":{background:"#1a1b26",opacity:.9,rapidOpacity:.3,colors:{rapid:"#ff9e64",cutting:"#7dcfff",laser:"#bb9af7",processed:"#565f89",boundingBox:"#c0caf5",machineBed:"#e0af68",machineBedKeepout:"#f7768e",grid:{major:"#7aa2f7",minor:"#414868"},axes:{x:"#f7768e",y:"#9ece6a",z:"#7aa2f7"}}},"gruvbox-light":{background:"#fbf1c7",opacity:.9,rapidOpacity:.3,colors:{rapid:"#d65d0e",cutting:"#3c3836",laser:"#b16286",processed:"#928374",boundingBox:"#7c6f64",machineBed:"#d79921",machineBedKeepout:"#cc241d",grid:{major:"#7c6f64",minor:"#a89984"},axes:{x:"#cc241d",y:"#98971a",z:"#458588"}}},"ayu-dark":{background:"#0b0e14",opacity:.9,rapidOpacity:.3,colors:{rapid:"#FFA659",cutting:"#73D0FF",laser:"#DFBFFF",processed:"#6E7C8F",boundingBox:"#CBCCC6",machineBed:"#FFD173",machineBedKeepout:"#F28779",grid:{major:"#77a9d7",minor:"#3e6590"},axes:{x:"#F28779",y:"#D5FF80",z:"#5CCFE6"}}},"ayu-light":{background:"#fafafa",opacity:.9,rapidOpacity:.3,colors:{rapid:"#FA8D3E",cutting:"#22A4E6",laser:"#A37ACC",processed:"#ADAEB1",boundingBox:"#5C6773",machineBed:"#F2AE49",machineBedKeepout:"#F07171",grid:{major:"#5c6773",minor:"#9aacba"},axes:{x:"#F07171",y:"#86B300",z:"#55B4D4"}}}};exports.GCodeSVGRenderer=e.GCodeSVGRenderer;exports.GCodeViewer=e.GCodeViewer;exports.ViewCube=e.ViewCube;exports.defaultGCodeViewerOptions=e.defaultGCodeViewerOptions;exports.defaultGCodeViewerTheme=e.defaultGCodeViewerTheme;exports.gCodeViewerThemePresets=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./GCodeSVGRenderer-i9duYU8q.cjs"),a={dark:{background:"#111827",opacity:.9,rapidOpacity:.3,colors:{rapid:"#0ef6ae",cutting:"#3e85c7",laser:"#a855f7",processed:"#6b7280",boundingBox:"#e2e8f0",machineBed:"#f5a623",machineBedKeepout:"#df3b3b",grid:{major:"#77a9d7",minor:"#3e6e9e"},axes:{x:"#df3b3b",y:"#06b881",z:"#295d8d"}}},light:{background:"#e5e7eb",opacity:.9,rapidOpacity:.3,colors:{rapid:"#295d8d",cutting:"#111827",laser:"#FF0000",processed:"#9ca3af",boundingBox:"#4b5563",machineBed:"#b45309",machineBedKeepout:"#df3b3b",grid:{major:"#295d8d",minor:"#5191cc"},axes:{x:"#df3b3b",y:"#06b881",z:"#295d8d"}}},"flexoki-dark":{background:"#100f0f",opacity:.9,rapidOpacity:.3,colors:{rapid:"#DA702C",cutting:"#3AA99F",laser:"#8B7EC8",processed:"#6f6e69",boundingBox:"#cecdc3",machineBed:"#ffcc66",machineBedKeepout:"#d14d41",grid:{major:"#a89984",minor:"#6f6e69"},axes:{x:"#d14d41",y:"#879a39",z:"#4385be"}}},"tokyo-night":{background:"#1a1b26",opacity:.9,rapidOpacity:.3,colors:{rapid:"#ff9e64",cutting:"#7dcfff",laser:"#bb9af7",processed:"#565f89",boundingBox:"#c0caf5",machineBed:"#e0af68",machineBedKeepout:"#f7768e",grid:{major:"#7aa2f7",minor:"#414868"},axes:{x:"#f7768e",y:"#9ece6a",z:"#7aa2f7"}}},"gruvbox-light":{background:"#fbf1c7",opacity:.9,rapidOpacity:.3,colors:{rapid:"#d65d0e",cutting:"#3c3836",laser:"#b16286",processed:"#928374",boundingBox:"#7c6f64",machineBed:"#d79921",machineBedKeepout:"#cc241d",grid:{major:"#7c6f64",minor:"#a89984"},axes:{x:"#cc241d",y:"#98971a",z:"#458588"}}},"ayu-dark":{background:"#0b0e14",opacity:.9,rapidOpacity:.3,colors:{rapid:"#FFA659",cutting:"#73D0FF",laser:"#DFBFFF",processed:"#6E7C8F",boundingBox:"#CBCCC6",machineBed:"#FFD173",machineBedKeepout:"#F28779",grid:{major:"#77a9d7",minor:"#3e6590"},axes:{x:"#F28779",y:"#D5FF80",z:"#5CCFE6"}}},"ayu-light":{background:"#fafafa",opacity:.9,rapidOpacity:.3,colors:{rapid:"#FA8D3E",cutting:"#22A4E6",laser:"#A37ACC",processed:"#ADAEB1",boundingBox:"#5C6773",machineBed:"#F2AE49",machineBedKeepout:"#F07171",grid:{major:"#5c6773",minor:"#9aacba"},axes:{x:"#F07171",y:"#86B300",z:"#55B4D4"}}}};exports.GCodeSVGRenderer=e.GCodeSVGRenderer;exports.GCodeViewer=e.GCodeViewer;exports.ViewCube=e.ViewCube;exports.defaultGCodeViewerOptions=e.defaultGCodeViewerOptions;exports.defaultGCodeViewerTheme=e.defaultGCodeViewerTheme;exports.gCodeViewerThemePresets=a;

package/dist/viewer.js

@@ -1,4 +1,4 @@
-import { G as o, a as i, V as c, d as r, b as n } from "./GCodeSVGRenderer-BezIPixY.js";
+import { G as o, a as i, V as c, d as r, b as n } from "./GCodeSVGRenderer-D4QGoHWJ.js";
 const e = {
   dark: {
     background: "#111827",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sienci/gviewer",
-  "version": "0.1.29",
+  "version": "0.1.32",
   "description": "GCode visualization library using Three.js",
   "repository": {
     "type": "git",