copper3d 3.6.2 → 3.6.5

package/dist/index.d.ts

@@ -28,6 +28,6 @@ import { CHANNEL_COLORS, CHANNEL_HEX_COLORS, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_
 import type { LayerId, ChannelValue } from "./Utils/segmentation/core/index";
 import type { AiPromptTool, AiPromptPoint, AiPromptPayload, AiMaskResult } from "./Utils/segmentation/tools/AiAssistTool";
 import "./css/style.css";
-export declare const REVISION = "v3.6.2-beta";
+export declare const REVISION = "v3.6.5";
 export { copperRenderer, copperRendererOnDemond, copperMSceneRenderer, setHDRFilePath, addLabelToScene, convert3DPostoScreenPos, convertScreenPosto3DPos, addBoxHelper, fullScreenListenner, configKiwriousHeart, copperScene, copperSceneOnDemond, copperMScene, CameraViewPoint, kiwrious, NrrdTools, loading, Copper3dTrackballControls, createTexture2D_NRRD, MeshNodeTool, throttle, removeGuiFolderChilden, CHANNEL_COLORS, CHANNEL_HEX_COLORS, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, GaussianSmoother, SurfaceAnnotator, };
 export type { positionType, screenPosType, optsType, nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, IPaintImage, exportPaintImageType, IOptVTKLoader, aligned4DSurfaceType, aligned4DOptsType, Aligned4DController, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates, NrrdState, GuiState, IGuiMeta, ToolMode, IAnnotationCallbacks, LayerId, ChannelValue, AiPromptTool, AiPromptPoint, AiPromptPayload, AiMaskResult, SurfaceAnnotatorOptions, Annotation, AnnotationMode, ExportOptions, };

package/dist/index.js

@@ -22,7 +22,14 @@ import { removeGuiFolderChilden } from "./Utils/segmentation/coreTools/gui";
 import { SurfaceAnnotator } from "./Utils/surfaceAnnotation";
 import { CHANNEL_COLORS, CHANNEL_HEX_COLORS, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss } from "./Utils/segmentation/core/index";
 import "./css/style.css";
-export const REVISION = "v3.6.2-beta";
-console.log(`%cCopper3D Visualisation %cBeta:${REVISION}`, "padding: 3px;color:white; background:#023047", "padding: 3px;color:white; background:#f50a25");
+// __REVISION__ is injected at build time by rollup @rollup/plugin-replace, sourced from package.json version
+export const REVISION = __REVISION__;
+// Expose on global so the version can be read in a production browser console via window.__COPPER3D_VERSION__
+if (typeof window !== "undefined") {
+    window.__COPPER3D_VERSION__ = REVISION;
+}
+if (typeof console !== "undefined") {
+    console.log(`%cCopper3D Visualisation %c${REVISION}`, "padding: 3px;color:white; background:#023047", "padding: 3px;color:white; background:#f50a25");
+}
 export { copperRenderer, copperRendererOnDemond, copperMSceneRenderer, setHDRFilePath, addLabelToScene, convert3DPostoScreenPos, convertScreenPosto3DPos, addBoxHelper, fullScreenListenner, configKiwriousHeart, copperScene, copperSceneOnDemond, copperMScene, CameraViewPoint, kiwrious, NrrdTools, loading, Copper3dTrackballControls, createTexture2D_NRRD, MeshNodeTool, throttle, removeGuiFolderChilden, CHANNEL_COLORS, CHANNEL_HEX_COLORS, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, GaussianSmoother, SurfaceAnnotator, };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EACL,eAAe,EAGf,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAY,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,QAAQ,MAAM,iCAAiC,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,iDAAiD;AAEjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AA0B7D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAS1J,OAAO,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAC;AAEtC,OAAO,CAAC,GAAG,CACT,mCAAmC,QAAQ,EAAE,EAC7C,8CAA8C,EAC9C,8CAA8C,CAC/C,CAAC;AAEF,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,SAAS,EACT,OAAO,EACP,yBAAyB,EACzB,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EACL,eAAe,EAGf,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAY,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,QAAQ,MAAM,iCAAiC,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,iDAAiD;AAEjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AA0B7D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAS1J,OAAO,iBAAiB,CAAC;AAEzB,6GAA6G;AAC7G,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AAErC,8GAA8G;AAC9G,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;IAChC,MAAc,CAAC,oBAAoB,GAAG,QAAQ,CAAC;CACjD;AAED,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE;IAClC,OAAO,CAAC,GAAG,CACT,8BAA8B,QAAQ,EAAE,EACxC,8CAA8C,EAC9C,8CAA8C,CAC/C,CAAC;CACH;AAED,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,SAAS,EACT,OAAO,EACP,yBAAyB,EACzB,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,CAAC"}

package/dist/lib/three-vignette.js

@@ -1,6 +1,12 @@
 import { Color, DoubleSide, Mesh, PlaneGeometry, RawShaderMaterial, Vector2, } from "three";
-import vert from "./three-vignette.vert";
-import frag from "./three-vignette.frag";
+// Loaded as raw strings (?raw). The original copper3d build compiled these via
+// rollup-plugin-glslify; this app has no GLSL/glslify handler, so importing them as modules
+// makes Vite try to parse GLSL as JS ("Unexpected identifier 'vec3'") and the bundle dies.
+// The vignette background is only built for non-alpha scenes and this app always uses
+// alpha:true, so these shaders are never compiled/used — loading them as inert strings is
+// enough to keep the module importable.
+import vert from "./three-vignette.vert?raw";
+import frag from "./three-vignette.frag?raw";
 function createBackground(opt) {
     opt = opt || {};
     let geometry = opt.geometry || new PlaneGeometry(2, 2, 1);

package/dist/lib/three-vignette.js.map

@@ -1 +1 @@
-{"version":3,"file":"three-vignette.js","sourceRoot":"","sources":["../../src/lib/three-vignette.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"three-vignette.js","sourceRoot":"","sources":["../../src/lib/three-vignette.ts"],"names":[],"mappings":"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"}

package/dist/types/Scene/copperScene.d.ts

@@ -24,13 +24,13 @@ export declare class copperScene extends baseScene {
     }): void;
     loadVtk(url: string): void;
     /**
-     * 在给定模型表面创建标注器(画 contour / 放点 / 导出坐标)。
-     * target 可为单个 Mesh,或 Group/Object3D(自动选顶点数最多的 mesh)。
-     * 复用本 scene 的 camera / container / controls;几何非索引时内部自动焊接索引化。
+     * Create an annotator on the surface of a given model (draw contours / place points / export coordinates).
+     * target can be a single Mesh, or a Group/Object3D (the mesh with the most vertices is chosen automatically).
+     * Reuses this scene's camera / container / controls; non-indexed geometry is welded and indexed automatically.
      */
     createSurfaceAnnotator(target: THREE.Mesh | THREE.Object3D, opts?: Omit<SurfaceAnnotatorOptions, "scene" | "camera" | "container" | "controls" | "mesh">): SurfaceAnnotator;
     private pickAnnotatableMesh;
-    /** 释放本 scene 创建的所有标注器(移除事件监听与标注对象)。 */
+    /** Dispose all annotators created on this scene (removes event listeners and annotation objects). */
     disposeSurfaceAnnotators(): void;
     loadVtks(models: Array<vtkModels>): void;
     /**

package/dist/types/Utils/segmentation/NrrdTools.d.ts

@@ -210,16 +210,41 @@ export declare class NrrdTools {
     exitAiAssistMode(): void;
     aiSetPromptTool(tool: AiPromptTool): void;
     aiSetPolarity(label: number): void;
-    /** Set the AI-layer channel (1-8) the predictions paint into. */
-    aiSetChannel(channel: number): void;
+    /** Select the active Segmentation by its label value (the AI paints into it). */
+    aiSetActiveSegment(label: number): void;
+    /** Set a Segmentation's colour (its label's colorMap entry; 2D overlay repaints). */
+    aiSetSegmentColor(label: number, color: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }): void;
+    /** "New segmentation": freeze current regions + switch to a new label. */
+    aiNewSegment(label: number): void;
+    /** Delete a Segmentation: erase all its label's voxels from scratch + committed. */
+    aiClearSegment(label: number): void;
     /** Set the scribble brush radius (px). */
     aiSetScribbleSize(size: number): void;
     /** Register the callback invoked when a prompt gesture completes (app → backend). */
     aiOnPrompt(cb: (payload: AiPromptPayload) => void): void;
+    /** Register the callback fired when the lasso vertex set changes (drives the Finish button). */
+    aiOnLassoChange(cb: (count: number, editing: boolean) => void): void;
     /** Apply a backend mask result into the scratch volume (overlay repaints next frame). */
     aiApplyMask(result: AiMaskResult): void;
     /** Clear the in-progress prompt set (e.g. slice change). */
     aiClearPrompts(): void;
+    /** Close + send the in-progress lasso to the backend (needs ≥3 vertices). */
+    aiFinishLasso(): void;
+    /** Undo the last lasso vertex add/delete. */
+    aiLassoUndo(): void;
+    /** Redo the last undone lasso vertex change. */
+    aiLassoRedo(): void;
+    /** Abandon the in-progress lasso (Esc). */
+    aiCancelLasso(): void;
+    /** True while the user is placing lasso vertices. */
+    aiIsLassoEditing(): boolean;
+    /** Number of placed lasso vertices (drives the Finish button). */
+    aiLassoVertCount(): number;
     /** "New region": freeze current regions (they persist) + start a fresh prompt set. */
     aiCommitRegion(): void;
     /** Discard all AI scratch painting since enter (sandbox discard). */
@@ -236,6 +261,20 @@ export declare class NrrdTools {
             rle: number[];
         }[];
     } | null;
+    /** Per-segmentation serialization (one binary RLE per label per z-slice) for the
+     *  multi-label / per-colour 3D build. */
+    aiGetScratchSegments(): {
+        axis: "z";
+        width: number;
+        height: number;
+        segments: {
+            label: number;
+            slices: {
+                sliceIndex: number;
+                rle: number[];
+            }[];
+        }[];
+    } | null;
     /**
      * Merge the AI scratch into a target layer as a single undoable group (sandbox
      * merge — best-practice: non-destructive + one Ctrl+Z). The scratch's channel

package/dist/types/Utils/segmentation/tools/AiAssistTool.d.ts

@@ -26,7 +26,7 @@ import type { SliceRenderHostDeps } from "./ToolHost";
 /** Scratch volume key in maskData.volumes — kept OUT of image.layers so
  *  compositeAllLayers ignores it (we render it ourselves in start()). */
 export declare const AI_SCRATCH_LAYER = "aiScratch";
-export type AiPromptTool = "point" | "box" | "scribble";
+export type AiPromptTool = "point" | "box" | "scribble" | "lasso";
 export interface AiPromptPoint {
     x: number;
     y: number;
@@ -48,6 +48,9 @@ export interface AiPromptPayload {
     };
     scribble?: AiPromptPoint[];
     scribbleRadius?: number;
+    /** Closed-contour lasso: ordered contour points (implicitly closed — the
+     *  backend connects the last point back to the first). One contour per gesture. */
+    lasso?: AiPromptPoint[];
 }
 export interface AiMaskResult {
     axis: "x" | "y" | "z";
@@ -73,29 +76,70 @@ export declare class AiAssistTool extends BaseTool {
     private committedVol;
     private promptTool;
     private polarity;
-    /** Target channel/label (1-8) the AI paints into — the "AI layer" channel. */
-    private channel;
+    /** The label value (1-255) the AI currently paints into = the active Segmentation.
+     *  Each Segmentation is a label value in the single-channel scratch volume; its
+     *  colour lives in the volume's colorMap (set via setSegmentColor). */
+    private activeLabel;
     /** Scribble brush radius (px), user-adjustable via slider. */
     private scribbleSize;
     /** Accumulated prompts for the CURRENT slice; reset on slice/axis change. */
     private points;
     private scribble;
+    /** Lasso contour sent to the backend (densified along the curve at finish). */
+    private lasso;
     private box;
     private activeSlice;
+    /** Placed lasso vertices (voxel + screen + polarity). Empty = not editing. */
+    private lassoVerts;
+    /** Undo / redo snapshot stacks of the vertex list (for Ctrl+Z / Ctrl+Y). */
+    private lassoUndo;
+    private lassoRedo;
+    /** Index of the vertex currently hovered (shows a red ✕; click removes it). −1 = none. */
+    private lassoHoverIdx;
+    /** Screen-pixel radius for hit-testing a hovered vertex. */
+    private static readonly LASSO_HIT_R;
+    /** Double-click detection (a dbl-click finishes the lasso). */
+    private lastLassoDownTime;
+    private lastLassoDownPos;
     private dragging;
     private dragStart;
     private dragScreenStart;
     private dragScreen;
     private screenScribble;
     private hoverScreen;
+    /** Hide the point seed markers once a prediction has painted (only the mask
+     *  should remain). A new point click re-shows them until its mask returns. */
+    private hidePointMarkers;
     /** Fired when a prompt gesture completes — app calls backend, then applyMask(). */
     onPrompt: ((payload: AiPromptPayload) => void) | null;
+    /** Fired whenever the lasso vertex set changes (add/delete/undo/redo/finish/cancel),
+     *  so the panel can reactively show the Finish button + vertex count. */
+    onLassoChange: ((count: number, editing: boolean) => void) | null;
     constructor(ctx: ToolContext, host: AiAssistHostDeps);
     setPromptTool(tool: AiPromptTool): void;
     setPolarity(label: number): void;
     setScribbleSize(size: number): void;
-    setChannel(channel: number): void;
-    getChannel(): number;
+    /** Select the active Segmentation by its label value (1-255). Switching starts a
+     *  fresh prompt set — otherwise accumulated prompts would be re-predicted and
+     *  repainted into the new label, recolouring the previous segmentation's region. */
+    setActiveSegment(label: number): void;
+    getActiveLabel(): number;
+    /** Set a Segmentation's colour (its label's entry in the scratch volume colorMap).
+     *  The 2D overlay repaints next frame (copper3d's render loop re-reads the map). */
+    setSegmentColor(label: number, color: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }): void;
+    /** "New segmentation": freeze the current regions (so they persist) and switch to
+     *  a fresh label, exactly like the old "New region" but targeting a new label. */
+    newSegment(label: number): void;
+    /** Delete a Segmentation: erase every voxel painted with its label from BOTH the
+     *  live scratch and the frozen (committed) volume, so the region disappears from
+     *  the view (otherwise orphaned label voxels would render with the wrong colour).
+     *  Goes via setRawData so the volume's version counter bumps (overlay repaints). */
+    clearSegment(label: number): void;
     getScratchVolume(): MaskVolume | null;
     /** Serialize the scratch volume as per-z-slice RLE (only NON-empty slices),
      *  for persisting to ai_generated_nii_LPS on the backend. Binary (any channel →
@@ -111,6 +155,22 @@ export declare class AiAssistTool extends BaseTool {
             rle: number[];
         }[];
     } | null;
+    /** Per-SEGMENTATION serialization for the 3D build: one binary RLE per non-empty
+     *  z-slice PER label (no binarize-merge), so the backend writes a multi-label
+     *  NIfTI and colours the GLB per segmentation. Includes both live and frozen
+     *  regions (both live in scratchVol). */
+    getScratchSegments(): {
+        axis: "z";
+        width: number;
+        height: number;
+        segments: {
+            label: number;
+            slices: {
+                sliceIndex: number;
+                rle: number[];
+            }[];
+        }[];
+    } | null;
     /** Create (or reuse) the scratch volume sized to the layer grid and register
      *  it under maskData.volumes['aiScratch']. Snapshots the empty buffer. */
     enter(): void;
@@ -126,21 +186,64 @@ export declare class AiAssistTool extends BaseTool {
     /** Clear the in-progress prompt set (e.g. slice/axis change). Does NOT freeze —
      *  use commitRegion() for the "New region" action. */
     resetPrompts(): void;
+    /** Drop the in-progress lasso vertices + undo/redo history (does not touch a
+     *  prediction already painted from a finished lasso). */
+    private clearLassoEditing;
+    /** Tell the app layer the lasso vertex set changed (drives the Finish button). */
+    private notifyLasso;
     /** Voxel-slice (width,height) for the current axis. */
     private sliceDims;
     /** Screen offset → voxel-slice (vx,vy) for the current axis. */
     private toVoxel;
+    /** Voxel-slice (vx,vy) → screen offset (px). Exact inverse of toVoxel, so
+     *  markers / lasso curves drawn from voxel coords track pan AND zoom each frame
+     *  (the freehand previews store screen px directly; persistent overlays don't). */
+    private voxelToScreen;
     onPointerDown(e: MouseEvent): void;
+    /** Lasso click: double-click finishes; click on a vertex deletes it; otherwise
+     *  add a vertex. Nothing is sent to the backend until finishLasso(). */
+    private onLassoPointerDown;
     onPointerMove(e: MouseEvent): void;
     onPointerUp(_e: MouseEvent): void;
     /** Reset the accumulated prompt set when the user scrubs to a new slice. */
     private syncSlice;
     private emit;
+    /** Index of the lasso vertex under (sx,sy) within the hit radius, else −1.
+     *  Uses live voxel→screen so it tracks pan/zoom. Topmost (latest) wins. */
+    private lassoVertAt;
+    /** Snapshot the vertex list for undo (clears redo). */
+    private pushLassoUndo;
+    /** Public: undo the last add/delete of a lasso vertex (Ctrl+Z while editing). */
+    lassoUndoAction(): void;
+    /** Public: redo (Ctrl+Y / Ctrl+Shift+Z while editing). */
+    lassoRedoAction(): void;
+    /** Public: abandon the in-progress lasso (Esc). */
+    cancelLasso(): void;
+    /** Public: true while the user is placing lasso vertices (≥1 vertex). */
+    isLassoEditing(): boolean;
+    /** Public: number of placed lasso vertices (drives the Finish button label/enable). */
+    getLassoVertCount(): number;
+    /** Vertices ordered by polar angle around their centroid, so the closed curve is
+     *  a SIMPLE (non-self-intersecting) loop regardless of click order — otherwise
+     *  connecting points in click order + closing easily produces a bow-tie crossing.
+     *  Trade-off: deep concavities collapse to their star-shaped hull, which is fine
+     *  for a "rough loop around a blob". */
+    private orderedLassoVerts;
+    /** Public: close the curve, densify it, and send it to the backend as the lasso
+     *  contour. Needs ≥3 vertices (a real area). Then clears the editing state. */
+    finishLasso(): void;
+    /** Sample a smooth CLOSED Catmull-Rom spline through `pts` → denser polyline.
+     *  `segs` samples per control-point span. <3 pts → returns a copy unchanged. */
+    private sampleClosedSpline;
     applyMask(result: AiMaskResult): void;
     /** Merge one RLE-encoded predicted slice into the scratch volume at sliceIndex.
      *  Predicted pixels → current channel; stale current-channel pixels cleared
      *  UNLESS they belong to a frozen (committed) region; OTHER channels preserved. */
     private applySliceRle;
     renderOverlay(targetCtx: CanvasRenderingContext2D): void;
+    /** A seed marker (small filled dot + ring) for point prompts. */
+    private drawSeedMarker;
+    /** Render the lasso editing overlay (curve + fill + vertices + hover ✕). */
+    private renderLassoOverlay;
 }
 export {};

package/dist/types/Utils/surfaceAnnotation/MeshGraph.d.ts

@@ -1,13 +1,15 @@
 import * as THREE from "three";
 /**
- * 从 BufferGeometry 的索引构建顶点邻接图,用于模式 B(测地线)的最短路径。
- * 顶点坐标按 local 存;传入的查询点需先转为 local(mesh.worldToLocal)。
+ * Build a vertex adjacency graph from a BufferGeometry's index, used for the shortest path in
+ * mode B (geodesic). Vertex coordinates are stored in local space; query points must be converted
+ * to local first (mesh.worldToLocal).
  *
- * 说明:几何须为已索引(indexed)。modelLoader 用 mergeVertices 焊接重复顶点,
- * 保证同一表面位置共享顶点,邻接图才连通。
+ * Note: the geometry must be indexed. modelLoader welds duplicate vertices with mergeVertices so
+ * that vertices at the same surface position are shared, otherwise the adjacency graph won't be connected.
  *
- * 性能:O(V²) Dijkstra + O(V) 最近顶点查找。对几万顶点单次点击可接受;
- * 若过大可后续换二叉堆 + 空间网格加速(留作升级)。
+ * Performance: O(V²) Dijkstra + O(V) nearest-vertex lookup. Acceptable for a single click on tens
+ * of thousands of vertices; if too large it can later be sped up with a binary heap + spatial grid
+ * (left as a future upgrade).
  */
 export declare class MeshGraph {
     private positions;
@@ -18,16 +20,16 @@ export declare class MeshGraph {
     private px;
     private py;
     private pz;
-    /** 最近顶点(传入 local 坐标)。 */
+    /** Nearest vertex (pass in local coordinates). */
     nearestVertex(localPoint: THREE.Vector3): number;
     /**
-     * 两顶点间最短路径(含端点的顶点索引序列)。二叉堆 Dijkstra,O(E log V)。
-     * 不连通时返回 [start,end] 兜底。
+     * Shortest path between two vertices (sequence of vertex indices including endpoints).
+     * Binary-heap Dijkstra, O(E log V). Falls back to [start,end] when disconnected.
      */
     shortestPath(startV: number, endV: number): number[];
     vertexWorld(i: number, matrixWorld: THREE.Matrix4): THREE.Vector3;
     vertexNormalWorld(i: number, mesh: THREE.Mesh): THREE.Vector3;
-    /** 顶点的 local 坐标 + local 法线(图几何即 local 空间)。 */
+    /** Vertex local coordinates + local normal (the graph geometry is already local space). */
     vertexLocal(i: number): {
         x: number;
         y: number;

package/dist/types/Utils/surfaceAnnotation/SurfaceAnnotator.d.ts

@@ -9,26 +9,34 @@ export interface SurfaceAnnotatorOptions {
         enabled: boolean;
     };
     mesh: THREE.Mesh;
-    /** 缺省时从 mesh 几何包围盒对角线自算。 */
+    /** Computed from the mesh geometry's bounding-box diagonal when omitted. */
     bboxDiagonal?: number;
-    /** 自由手绘 contour 颜色,默认 #e5006e。 */
+    /**
+     * Outward offset of the annotation line from the surface (world units), defaults to bboxDiagonal*0.002.
+     * Providing it separately decouples it from the sampling spacing (minGap/maxJump, still derived from
+     * bboxDiagonal) — useful on bumpy/voxel surfaces where a larger offset is needed to float the line
+     * above the relief without also coarsening the sampling.
+     */
+    epsilon?: number;
+    /** Freehand contour color, defaults to #e5006e. */
     freehandColor?: string;
-    /** 测地线 contour 颜色,默认 #ffa24e。 */
+    /** Geodesic contour color, defaults to #ffa24e. */
     geodesicColor?: string;
-    /** 放点标记颜色,默认 #ffd166。 */
+    /** Point-marker color, defaults to #ffd166. */
     pointColor?: string;
-    /** 线宽(像素),默认 3。 */
+    /** Line width (pixels), defaults to 3. */
     lineWidth?: number;
-    /** 标记小球半径,默认 bboxDiagonal*0.006。 */
+    /** Marker sphere radius, defaults to bboxDiagonal*0.006. */
     markerRadius?: number;
     onModeChange?: (m: AnnotationMode) => void;
-    /** 标注列表变化回调(增删/撤销/清空)。 */
+    /** Callback when the annotation list changes (add/remove/undo/clear). */
     onChange?: (annotations: Annotation[]) => void;
 }
 /**
- * 表面标注主控制器(Phase 4):navigate / freehand / geodesic / point 四模式,
- * Enter 闭合,数据交给 AnnotationStore 管理(多条带颜色标签、撤销/删除/清空、导出)。
- * 渲染层据 store.list() 做场景对账(reconcile),撤销/删除自动加/移 three 对象。
+ * Main surface-annotation controller (Phase 4): four modes navigate / freehand / geodesic / point,
+ * Enter closes the loop, and data is managed by AnnotationStore (multiple color-labeled strips,
+ * undo/delete/clear, export).
+ * The render layer reconciles the scene against store.list(); undo/delete automatically add/remove three objects.
  */
 export declare class SurfaceAnnotator {
     private o;
@@ -56,7 +64,7 @@ export declare class SurfaceAnnotator {
     private hoveredGeoMarker;
     private _projV;
     constructor(opts: SurfaceAnnotatorOptions);
-    /** 窗口尺寸变化时更新所有 fat line 的像素分辨率,否则线宽会失真。 */
+    /** Update the pixel resolution of all fat lines on window resize, otherwise line width distorts. */
     private onResize;
     private get freehandColor();
     private get geodesicColor();
@@ -64,13 +72,13 @@ export declare class SurfaceAnnotator {
     getMode(): AnnotationMode;
     setMode(m: AnnotationMode): void;
     getStore(): AnnotationStore;
-    /** 当前标注列表快照。 */
+    /** Snapshot of the current annotation list. */
     getAnnotations(): Annotation[];
     undo(): void;
     clearAll(): void;
     deleteAnnotation(id: string): void;
     selectAnnotation(id: string | null): void;
-    /** 颜色变更后重画对应 three 对象。 */
+    /** Redraw the corresponding three object after a color change. */
     refreshAnnotation(id: string): void;
     exportJSON(modelName: string, opts?: ExportOptions): {
         model: string;
@@ -87,42 +95,54 @@ export declare class SurfaceAnnotator {
         }[];
     };
     private applyCameraGating;
-    /** 据 store.list() 对账场景:补齐缺失对象、移除已删对象(不 dispose,留给撤销恢复)。 */
+    /** Reconcile the scene against store.list(): add missing objects, remove deleted ones (no dispose, kept for undo restore). */
     private reconcile;
     private applySelection;
     private disposeObject;
     private nextId;
     private hit;
     /**
-     * 事件目标是否是容器内的 WebGL canvas。
-     * 仅认 canvas:面板(GUIDE / 控制面板 / 标注列表的 ✕ 按钮)都是 container 的子元素,
-     * 若只判断 contains 会把面板上的点击也当成在模型上作画 —— 这会"穿透"删除按钮、
-     * 让 ✕ 难以点中。只响应 canvas 上的指针事件即可彻底隔离 UI 与画布。
+     * Whether the event target is the WebGL canvas inside the container.
+     * Only accept the canvas: panels (GUIDE / control panel / the ✕ buttons in the annotation list)
+     * are all children of the container, so checking contains alone would treat clicks on the panels
+     * as drawing on the model — which "leaks through" the delete buttons and makes ✕ hard to click.
+     * Responding only to pointer events on the canvas fully isolates the UI from the drawing surface.
      */
     private insideContainer;
     private onPointerDown;
-    /** 射线拾取进行中的锚点小球,返回锚点下标;未命中返回 -1。 */
+    /**
+     * Pick an in-progress anchor: return the index of the nearest anchor (screen pixel distance <
+     * tolerance), or -1 on a miss.
+     *
+     * Uses "screen-space pixel distance" instead of ray/sphere intersection: the anchor spheres are
+     * tiny, so strict ray/sphere hits require pixel-perfect aiming and most clicks miss — and a miss
+     * falls through to the "add anchor" branch, so trying to delete a point ends up adding one. That
+     * was the root cause of the old "deleting a point takes several clicks, must hit the sphere dead
+     * center" problem. Projecting each anchor to the screen and taking the nearest within tolerance
+     * makes deletion stable and reliable. The tolerance is enlarged relative to the sphere's screen
+     * radius to make it easy to hit.
+     */
     private pickGeoMarker;
-    /** 设置当前悬停的锚点(-1 = 无):更新高亮缩放、光标与"✕(可取消)"悬浮标。 */
+    /** Set the currently hovered anchor (-1 = none): update highlight scale, cursor, and the "✕ (cancel)" floating badge. */
     private setGeoHover;
-    /** 懒创建悬浮 ✕ 标(挂在 container 内,pointer-events:none 不挡点击)。 */
+    /** Lazily create the floating ✕ badge (appended inside the container, pointer-events:none so it doesn't block clicks). */
     private ensureGeoBadge;
-    /** 把 ✕ 标定位到锚点投影到屏幕的位置(正中心,即光标悬停处,避免歧义)。 */
+    /** Position the ✕ badge at the anchor's screen projection (dead center, i.e. where the cursor hovers, to avoid ambiguity). */
     private positionGeoBadge;
-    /** 据当前锚点重建可见的锚点小球(锚点比放点稍大,便于看见与点中取消)。 */
+    /** Rebuild the visible anchor spheres from the current anchors (slightly larger than placed points, so they're easy to see and click to cancel). */
     private rebuildGeoMarkers;
-    /** 据当前锚点重画进行中的测地线(不闭合);不足两点时移除线。 */
+    /** Redraw the in-progress geodesic from the current anchors (not closed); remove the line when fewer than two points. */
     private redrawGeoLine;
-    /** 丢弃进行中的测地线:移除并 dispose 线与全部锚点。 */
+    /** Discard the in-progress geodesic: remove and dispose the line and all anchors. */
     private clearActiveGeo;
-    /** 移除进行中测地线的全部锚点小球(落定后调用:只留下线)。 */
+    /** Remove all anchor spheres of the in-progress geodesic (called after committing: only the line remains). */
     private removeGeoMarkers;
     private onPointerMove;
     private onPointerUp;
     private closeLastContour;
-    /** 沿网格表面求 a→b 的测地路径(local 顶点),去掉与 a 重合的首点。a/b 已是 local。 */
+    /** Compute the geodesic path a→b along the mesh surface (local vertices), dropping the first point that coincides with a. a/b are already local. */
     private surfacePathBetween;
-    /** 结束当前测地线:闭合成环并落定为一条 contour。 */
+    /** Finish the current geodesic: close it into a ring and commit it as one contour. */
     private finishGeodesic;
     private isTypingTarget;
     private onKeyDown;

package/dist/types/Utils/surfaceAnnotation/annotationStore.d.ts

@@ -1,9 +1,9 @@
 import * as THREE from "three";
 import type { Annotation, ExportOptions } from "./types";
 /**
- * 标注数据模型 + 撤销栈 + 导出。纯数据,无 three / DOM 依赖。
- * 撤销只记录 add / remove 两类原子操作(满足"撤销最近添加 / 恢复删除")。
- * 通过 subscribe 通知 UI 与渲染层(后者据 list() 做场景对账)。
+ * Annotation data model + undo stack + export. Pure data, no three / DOM dependencies.
+ * Undo only records two atomic operations, add / remove (enough for "undo last add / restore delete").
+ * Notifies the UI and render layer via subscribe (the latter reconciles the scene against list()).
  */
 export declare class AnnotationStore {
     private items;
@@ -14,7 +14,7 @@ export declare class AnnotationStore {
     add(a: Annotation): void;
     remove(id: string): Annotation | undefined;
     undo(): void;
-    /** 清空,返回被清掉的项(供渲染层 dispose three 对象)。 */
+    /** Clear all, returning the removed items (so the render layer can dispose three objects). */
     clear(): Annotation[];
     list(): Annotation[];
     get(id: string): Annotation | undefined;

package/dist/types/Utils/surfaceAnnotation/contourRender.d.ts

@@ -3,5 +3,5 @@ import { Line2 } from "three/examples/jsm/lines/Line2";
 import type { AnnotationVertex } from "./types";
 export declare function makeContourLine(verts: AnnotationVertex[], color: string, closed: boolean, container: HTMLElement, epsilon: number, mesh: THREE.Mesh): Line2;
 export declare function updateContourLine(line: Line2, verts: AnnotationVertex[], closed: boolean, epsilon: number, mesh: THREE.Mesh): void;
-/** 改变已有 contour 线的颜色。 */
+/** Change the color of an existing contour line. */
 export declare function setContourColor(line: Line2, color: string): void;

package/dist/types/Utils/surfaceAnnotation/geodesicContour.d.ts

@@ -2,8 +2,9 @@ import * as THREE from "three";
 import type { AnnotationVertex } from "./types";
 import { MeshGraph } from "./MeshGraph";
 /**
- * 模式 B(测地线)状态机:逐次点击锚点,相邻锚点之间用 MeshGraph 求最短路径,
- * 拼成一条贴合表面的折线。Enter 结束并可闭合(首尾再求一段)。
+ * State machine for mode B (geodesic): click anchors one by one, find the shortest path between
+ * adjacent anchors with MeshGraph, and stitch them into a polyline that hugs the surface.
+ * Enter finishes and can close the loop (computing one more segment between first and last).
  */
 export declare class GeodesicContour {
     private graph;
@@ -12,21 +13,21 @@ export declare class GeodesicContour {
     private segments;
     private history;
     constructor(graph: MeshGraph, mesh: THREE.Mesh);
-    /** 任何改动锚点前先存一份快照(顶点索引数组很小,快照成本可忽略)。 */
+    /** Save a snapshot before any anchor change (the vertex-index array is tiny, so snapshot cost is negligible). */
     private snapshot;
-    /** 传入 local 命中点,snap 到最近顶点并对上一锚点求路径。 */
+    /** Given a local hit point, snap to the nearest vertex and compute the path to the previous anchor. */
     addAnchor(localHitPoint: THREE.Vector3): void;
-    /** 删除指定下标的锚点,重算相邻段(支持取消中间任意一点)。 */
+    /** Remove the anchor at the given index and recompute adjacent segments (allows canceling any middle point). */
     removeAnchorAt(index: number): void;
-    /** 是否还有可撤销的编辑(加点/删点)。 */
+    /** Whether there is still an editable change to undo (add/remove point). */
     canUndo(): boolean;
-    /** 撤销上一次锚点编辑(加点 → 删回去;删点 → 恢复)。无历史返回 false。 */
+    /** Undo the last anchor edit (add → remove it; remove → restore it). Returns false when no history. */
     undoEdit(): boolean;
-    /** 据当前锚点序列整体重算所有相邻段路径。 */
+    /** Recompute all adjacent-segment paths from the current anchor sequence. */
     private rebuildSegments;
-    /** 各锚点的 local 顶点(用于绘制可见的锚点标记)。 */
+    /** Local vertex of each anchor (used to draw visible anchor markers). */
     getAnchorLocals(): AnnotationVertex[];
     get anchorCount(): number;
-    /** 把所有路径顶点(world)+ 法线 拼成折线;closed 时补一段首尾路径。 */
+    /** Stitch all path vertices (world) + normals into a polyline; when closed, add one first-to-last segment. */
     buildVertices(closed: boolean): AnnotationVertex[];
 }

package/dist/types/Utils/surfaceAnnotation/pointMarkers.d.ts

@@ -1,7 +1,8 @@
 import * as THREE from "three";
 import type { AnnotationVertex } from "./types";
 /**
- * 在 local 顶点处生成一个标记小球(fiducial)。local→world 后沿 world 法线略外移,
- * 避免一半埋进表面。radius 由调用方按模型 bbox 缩放传入。
+ * Create a marker sphere (fiducial) at a local vertex. After local→world, nudge it
+ * outward along the world normal so it doesn't sink halfway into the surface.
+ * radius is passed in by the caller, scaled to the model bbox.
  */
 export declare function makePointMarker(v: AnnotationVertex, mesh: THREE.Mesh, color: string, radius: number): THREE.Mesh;

package/dist/types/Utils/surfaceAnnotation/raycastSurface.d.ts

@@ -1,7 +1,8 @@
 import * as THREE from "three";
 import type { SurfaceHit } from "./types";
 /**
- * 把屏幕坐标(clientX/Y)投射到 mesh 表面,返回命中点、world-space 法线与 faceIndex。
- * 未命中返回 null。本地实现,不依赖 Copper3D 未导出的 raycast 内部函数。
+ * Project screen coordinates (clientX/Y) onto the mesh surface, returning the hit point,
+ * world-space normal, and faceIndex. Returns null on a miss. Local implementation that does not
+ * depend on Copper3D's unexported raycast internals.
  */
 export declare function raycastSurface(camera: THREE.PerspectiveCamera, container: HTMLElement, mesh: THREE.Mesh, clientX: number, clientY: number): SurfaceHit | null;