@sienci/gviewer 0.1.29 → 0.1.31

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 V=require("react"),F=require("./GCodeSVGRenderer-HssywtI7.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;

package/dist/react.js

@@ -1,5 +1,5 @@
 import * as o from "react";
-import { a as w, G as V } from "./GCodeSVGRenderer-BezIPixY.js";
+import { a as w, G as V } from "./GCodeSVGRenderer-BeeQVu4r.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);

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,4 +1,4 @@
-import type { WorkerGeometryData } from "../types";
+import type { LoadWorkerDataOptions, WorkerGeometryData } from "../types";
 import { GCodeViewerCameraView, GCodeViewerBounds, GCodeViewerCallbacks, GCodeViewerCreateArgs, GCodeViewerHandle, GCodeViewerBitPosition, GCodeViewerOptions } from "./types";
 export declare class GCodeViewer implements GCodeViewerHandle {
     readonly id: string;
@@ -56,6 +56,21 @@ 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;
     snapCameraToView(view: GCodeViewerCameraView, options?: {
         durationMs?: number;
@@ -116,7 +131,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/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/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-HssywtI7.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-BeeQVu4r.js";
 const e = {
   dark: {
     background: "#111827",

package/package.json

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