copper3d 2.2.3 → 3.0.0

package/dist/index.d.ts

@@ -18,7 +18,9 @@ import { MeshNodeTool } from "./Utils/MeshNodeTool";
 import { removeGuiFolderChilden } from "./Utils/segmentation/coreTools/gui";
 import { nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, exportPaintImageType, IOptVTKLoader } from "./types/types";
 import { IPaintImage, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates } from "./Utils/segmentation/coreTools/coreType";
+import { CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss } from "./Utils/segmentation/core/index";
+import type { LayerId, ChannelValue } from "./Utils/segmentation/core/index";
 import "./css/style.css";
-export declare const REVISION = "v2.2.3";
-export { copperRenderer, copperRendererOnDemond, copperMSceneRenderer, setHDRFilePath, addLabelToScene, convert3DPostoScreenPos, convertScreenPosto3DPos, addBoxHelper, fullScreenListenner, configKiwriousHeart, copperScene, copperSceneOnDemond, copperMScene, CameraViewPoint, kiwrious, NrrdTools, loading, Copper3dTrackballControls, createTexture2D_NRRD, MeshNodeTool, throttle, removeGuiFolderChilden, };
-export type { positionType, screenPosType, optsType, nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, IPaintImage, exportPaintImageType, IOptVTKLoader, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates };
+export declare const REVISION = "v3.0.0-beta";
+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, rgbaToHex, rgbaToCss, };
+export type { positionType, screenPosType, optsType, nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, IPaintImage, exportPaintImageType, IOptVTKLoader, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates, LayerId, ChannelValue, };

package/dist/index.js

@@ -14,11 +14,13 @@ import { createTexture2D_NRRD } from "./Utils/texture2d";
 import { configKiwriousHeart } from "./Utils/kiwrious/configKiwrious";
 import kiwrious from "./Utils/kiwrious/configKiwrious";
 import { NrrdTools } from "./Utils/segmentation/NrrdTools";
+// Phase 7: Segmentation Module - Unified exports
 import { Copper3dTrackballControls } from "./Controls/Copper3dTrackballControls";
 import { MeshNodeTool } from "./Utils/MeshNodeTool";
 import { removeGuiFolderChilden } from "./Utils/segmentation/coreTools/gui";
+import { CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss } from "./Utils/segmentation/core/index";
 import "./css/style.css";
-export const REVISION = "v2.2.3";
+export const REVISION = "v3.0.0-beta";
 console.log(`%cCopper3D Visualisation %cBeta:${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, };
+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, rgbaToHex, rgbaToCss, };
 //# 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;AAE3D,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,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEjC,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,GACvB,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,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;AAc5E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAG3G,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,SAAS,EACT,SAAS,GACV,CAAC"}

package/dist/types/Renderer/copperRenderer.d.ts

@@ -9,7 +9,7 @@ export declare class copperRenderer extends baseRenderer {
     private interval;
     preRenderCallbackFunctions: Array<Function>;
     constructor(container: HTMLDivElement, options?: ICopperRenderOpt);
-    getSceneByName(name: string): copperScene | import("../Scene/baseScene").baseScene | import("../index").copperMScene;
+    getSceneByName(name: string): copperScene | import("../Scene/baseScene").baseScene | import("..").copperMScene;
     setFPS(fps: number): void;
     setCurrentScene(sceneIn: copperScene): void;
     createScene(name: string): copperScene | undefined;

package/dist/types/Renderer/copperRendererOnDemond.d.ts

@@ -4,7 +4,7 @@ import { copperSceneOnDemond } from "../Scene/copperSceneOnDemond";
 export declare class copperRendererOnDemond extends baseRenderer {
     private sceneMap;
     constructor(container: HTMLDivElement, options?: ICopperRenderOpt);
-    getSceneByName(name: string): import("../index").copperScene | import("../Scene/baseScene").baseScene | import("../index").copperMScene;
+    getSceneByName(name: string): import("..").copperScene | import("../Scene/baseScene").baseScene | import("..").copperMScene;
     setCurrentScene(sceneIn: copperSceneOnDemond): void;
     createScene(name: string): copperSceneOnDemond | undefined;
     animate: () => void;

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

@@ -16,6 +16,9 @@ export declare class copperScene extends baseScene {
     private texture2dMesh;
     constructor(container: HTMLDivElement, renderer: THREE.WebGLRenderer, opt?: ICopperSceneOpts);
     loadGltf(url: string, callback?: (content: THREE.Group) => void): void;
+    loadPureGLB(url: string, callback?: (mesh: THREE.Group) => void, opts?: {
+        color: string;
+    }): void;
     loadVtk(url: string): void;
     loadVtks(models: Array<vtkModels>): void;
     texture2d(url: string): void;

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

@@ -1,12 +1,60 @@
-import { IProtected, IGUIStates, INrrdStates, ICursorPage, IPaintImages, IConvertObjType } from "./coreTools/coreType";
+import { IProtected, IGUIStates, INrrdStates, ICursorPage, IPaintImage, IPaintImages, IConvertObjType, INewMaskData, IKeyBoardSettings } from "./coreTools/coreType";
+import { MaskVolume } from "./core/index";
 export declare class CommToolsData {
     baseCanvasesSize: number;
+    private _reusableSliceBuffer;
+    private _reusableBufferWidth;
+    private _reusableBufferHeight;
+    /** Whether the keyboard-config dialog is open (suppresses all shortcuts). */
+    protected _configKeyBoard: boolean;
+    /** Active keyboard shortcut bindings. */
+    protected _keyboardSettings: IKeyBoardSettings;
     nrrd_states: INrrdStates;
     cursorPage: ICursorPage;
     gui_states: IGUIStates;
     protectedData: IProtected;
-    constructor(container: HTMLElement, mainAreaContainer: HTMLElement);
-    private generateCanvases;
+    constructor(container: HTMLElement, mainAreaContainer: HTMLElement, options?: {
+        layers?: string[];
+    });
+    /**
+     * Get MaskVolume for a specific layer
+     *
+     * @param layer - Layer name: "layer1", "layer2", or "layer3"
+     * @returns MaskVolume instance for the specified layer
+     *
+     * @example
+     * ```ts
+     * const volume = this.getVolumeForLayer("layer1");
+     * volume.setVoxel(x, y, z, 255);
+     * ```
+     */
+    getVolumeForLayer(layer: string): MaskVolume;
+    /**
+     * Get MaskVolume for the currently active layer
+     *
+     * @returns MaskVolume instance for the current layer
+     *
+     * @example
+     * ```ts
+     * const volume = this.getCurrentVolume();
+     * const slice = volume.getSliceImageData(50, 'z');
+     * ```
+     */
+    getCurrentVolume(): MaskVolume;
+    /**
+     * Get all three MaskVolume instances
+     *
+     * @returns Object containing all three layer volumes
+     *
+     * @example
+     * ```ts
+     * const { layer1, layer2, layer3 } = this.getAllVolumes();
+     * layer1.clear();
+     * ```
+     */
+    getAllVolumes(): INewMaskData;
+    private generateSystemCanvases;
+    private generateLayerTargets;
     /**
      * Rewrite this {clearPaint} function under DrawToolCore
      */
@@ -15,6 +63,10 @@ export declare class CommToolsData {
      * Rewrite this {undoLastPainting} function under DrawToolCore
      */
     undoLastPainting(): void;
+    /**
+     * Rewrite this {redoLastPainting} function under DrawToolCore
+     */
+    redoLastPainting(): void;
     /**
      * Rewrite this {clearStoreImages} function under NrrdTools
      */
@@ -66,10 +118,61 @@ export declare class CommToolsData {
     /**
      * Get a painted mask image (IPaintImage) based on current axis and input slice index.
      *
+     * Phase 3: Reads directly from MaskVolume (no caching needed — reads are fast).
+     *
      * @param axis "x" | "y" | "z"
      * @param sliceIndex number
-     * @param paintedImages IPaintImages, All painted mask images.
-     * @returns
+     * @returns IPaintImage with the mask for the given slice, or undefined if not found
+     */
+    filterDrawedImage(axis: "x" | "y" | "z", sliceIndex: number): IPaintImage | undefined;
+    /**
+     * Get or create a reusable ImageData buffer for the given axis.
+     *
+     * Reuses the same buffer across multiple slice renders to avoid
+     * allocating a new ImageData per layer per slice switch.
+     * The buffer is only reallocated when slice dimensions change (axis switch).
+     *
+     * @param axis - Axis: "x", "y", or "z"
+     * @returns Reusable ImageData buffer with correct dimensions
+     */
+    getOrCreateSliceBuffer(axis: "x" | "y" | "z"): ImageData | null;
+    /**
+     * Render a layer's slice into a reusable buffer and draw to the target canvas.
+     *
+     * Uses MaskVolume.getSliceRawImageDataInto() for zero-allocation rendering.
+     * The caller should obtain the buffer via getOrCreateSliceBuffer() and reuse
+     * it across multiple layer renders.
+     *
+     * @param layer - Layer name: "layer1", "layer2", or "layer3"
+     * @param axis - Axis: "x", "y", or "z"
+     * @param sliceIndex - Slice index
+     * @param buffer - Reusable ImageData buffer (from getOrCreateSliceBuffer)
+     * @param targetCtx - Canvas context to draw the result onto
+     * @param scaledWidth - Target display width
+     * @param scaledHeight - Target display height
+     */
+    renderSliceToCanvas(layer: string, axis: "x" | "y" | "z", sliceIndex: number, buffer: ImageData, targetCtx: CanvasRenderingContext2D, scaledWidth: number, scaledHeight: number): void;
+    /**
+     * Invalidate the reusable buffer (e.g. when switching datasets).
+     * The buffer will be lazily recreated on next use.
+     */
+    invalidateSliceBuffer(): void;
+    /**
+     * Apply the same flip transform used by flipDisplayImageByAxis() to any
+     * canvas context.  This ensures mask overlays align with the flipped CT image.
+     *
+     * The flip is its own inverse (applying twice = identity), so it works for
+     * both directions: volume→display (rendering) and display→volume (storing).
+     *
+     * @param ctx    Target 2D context (must be wrapped in save/restore by caller).
+     * @param width  Canvas width in pixels.
+     * @param height Canvas height in pixels.
+     * @param axis   Current viewing axis.
+     */
+    applyMaskFlipForAxis(ctx: CanvasRenderingContext2D, width: number, height: number, axis: "x" | "y" | "z"): void;
+    /**
+     * Composite all layer canvases to the master display canvas.
+     * Only draws layers whose visibility is enabled.
      */
-    filterDrawedImage(axis: "x" | "y" | "z", sliceIndex: number, paintedImages: IPaintImages): import("./coreTools/coreType").IPaintImage;
+    compositeAllLayers(): void;
 }

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

@@ -1,4 +1,5 @@
-import { IDragOpts, IDrawingEvents, IProtected, IGUIStates, INrrdStates, IPaintImage, IPaintImages } from "./coreTools/coreType";
+import { IDragOpts, IDrawingEvents, IProtected, IGUIStates, INrrdStates } from "./coreTools/coreType";
+import type { EventRouter } from "./eventRouter";
 export declare class DragOperator {
     container: HTMLElement;
     private dragPrameters;
@@ -8,20 +9,25 @@ export declare class DragOperator {
     private nrrd_states;
     private gui_states;
     private protectedData;
-    private dragEffectCanvases;
+    private dragSliceTool;
     private setSyncsliceNum;
     private setIsDrawFalse;
     private flipDisplayImageByAxis;
     private setEmptyCanvasSize;
-    private filterDrawedImage;
-    constructor(container: HTMLElement, nrrd_sates: INrrdStates, gui_states: IGUIStates, protectedData: IProtected, drawingPrameters: IDrawingEvents, setSyncsliceNum: () => void, setIsDrawFalse: (target: number) => void, flipDisplayImageByAxis: () => void, setEmptyCanvasSize: (axis?: "x" | "y" | "z") => void, filterDrawedImage: (axis: "x" | "y" | "z", sliceIndex: number, paintedImages: IPaintImages) => IPaintImage);
+    private getOrCreateSliceBuffer;
+    private renderSliceToCanvas;
+    private eventRouter;
+    constructor(container: HTMLElement, nrrd_sates: INrrdStates, gui_states: IGUIStates, protectedData: IProtected, drawingPrameters: IDrawingEvents, setSyncsliceNum: () => void, setIsDrawFalse: (target: number) => void, flipDisplayImageByAxis: () => void, setEmptyCanvasSize: (axis?: "x" | "y" | "z") => void, getOrCreateSliceBuffer: (axis: "x" | "y" | "z") => ImageData | null, renderSliceToCanvas: (layer: string, axis: "x" | "y" | "z", sliceIndex: number, buffer: ImageData, targetCtx: CanvasRenderingContext2D, scaledWidth: number, scaledHeight: number) => void);
     private init;
     setShowDragNumberDiv(sliceIndexContainer: HTMLDivElement): void;
+    /**
+     * Set the EventRouter reference for centralized event handling.
+     * Called by NrrdTools/DrawToolCore after EventRouter is initialized.
+     * Subscribes to mode changes to control drag mode.
+     */
+    setEventRouter(eventRouter: EventRouter): void;
     drag(opts?: IDragOpts): void;
     updateIndex(move: number): void;
-    private drawDragSlice;
-    private drawMaskToLabelCtx;
-    private cleanCanvases;
     updateShowNumDiv(contrastNum: number): void;
     updateCurrentContrastSlice(): any;
     configDragMode: () => void;

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

@@ -1,5 +1,13 @@
-import { IDrawingEvents, IContrastEvents, IDrawOpts, IPaintImage, IPaintImages, IUndoType } from "./coreTools/coreType";
+import { IConvertObjType, IDrawingEvents, IContrastEvents, IDrawOpts, IPaintImages } from "./coreTools/coreType";
 import { CommToolsData } from "./CommToolsData";
+import { EventRouter } from "./eventRouter";
+import { SphereTool } from "./tools/SphereTool";
+import { CrosshairTool } from "./tools/CrosshairTool";
+import { ContrastTool } from "./tools/ContrastTool";
+import { ZoomTool } from "./tools/ZoomTool";
+import { EraserTool } from "./tools/EraserTool";
+import { ImageStoreHelper } from "./tools/ImageStoreHelper";
+import { UndoManager } from "./core";
 export declare class DrawToolCore extends CommToolsData {
     container: HTMLElement;
     mainAreaContainer: HTMLDivElement;
@@ -7,9 +15,23 @@ export declare class DrawToolCore extends CommToolsData {
     contrastEventPrameters: IContrastEvents;
     eraserUrls: string[];
     pencilUrls: string[];
-    undoArray: Array<IUndoType>;
+    undoManager: UndoManager;
+    /** Snapshot of the active layer's slice captured on mouse-down (before drawing). */
+    private preDrawSlice;
+    private preDrawAxis;
+    private preDrawSliceIndex;
+    protected eventRouter: EventRouter | null;
+    protected sphereTool: SphereTool;
+    protected crosshairTool: CrosshairTool;
+    protected contrastTool: ContrastTool;
+    protected zoomTool: ZoomTool;
+    protected eraserTool: EraserTool;
+    protected imageStoreHelper: ImageStoreHelper;
     start: () => void;
-    constructor(container: HTMLElement);
+    constructor(container: HTMLElement, options?: {
+        layers?: string[];
+    });
+    private initTools;
     private initDrawToolCore;
     setEraserUrls(urls: string[]): void;
     setPencilIconUrls(urls: string[]): void;
@@ -30,96 +52,55 @@ export declare class DrawToolCore extends CommToolsData {
     configMouseSliceWheel(): void;
     private enableCrosshair;
     drawImageOnEmptyImage(canvas: HTMLCanvasElement): void;
-    /****************************Sphere calculate distance functions****************************************************/
-    private getSpherePosition;
+    /****************************Sphere functions (delegated to SphereTool)****************************************************/
     drawCalculatorSphereOnEachViews(axis: "x" | "y" | "z"): void;
-    /****************************Sphere functions****************************************************/
-    private storeSphereImages;
     private drawSphereOnEachViews;
-    /**
-     *
-     * @param ctx draw sphere canvas ctx
-     * @param x width must be match the origin size, size factor 1, ignore the size factor
-     * @param y height must be match the origin size, size factor 1, ignore the size factor
-     * @param radius radius must be match the origin size, size factor 1, ignore the size factor
-     * @param color sphere color
-     */
-    private drawSphereCore;
-    private setSphereCanvasSize;
     private configMouseSphereWheel;
     drawCalculatorSphere(radius: number): void;
     drawSphere(mouseX: number, mouseY: number, radius: number): void;
-    private clearSphereCanvas;
     /**
-    * We generate the MRI slice from threejs based on mm, but when we display it is based on pixel size/distance.
-    * So, the index munber on each axis (sagittal, axial, coronal) is the slice's depth in mm distance. And the width and height displayed on screen is the slice's width and height in pixel distance.
-    *
-    * When we switch into different axis' views, we need to convert current view's the depth to the pixel distance in other views width or height, and convert the current view's width or height from pixel distance to mm distance as other views' depth (slice index) in general.
-    *
-    * Then as for the crosshair (Cursor Inspector), we also need to convert the cursor point (x, y, z) to other views' (x, y, z).
-    *
-    * @param from "x" | "y" | "z", current view axis, "x: sagittle, y: coronal, z: axial".
-    * @param to "x" | "y" | "z", target view axis (where you want jump to), "x: sagittle, y: coronal, z: axial".
-    * @param cursorNumX number, cursor point x on current axis's slice. (pixel distance)
-    * @param cursorNumY number, cursor point y on current axis's slice. (pixel distance)
-    * @param currentSliceIndex number, current axis's slice's index/depth. (mm distance)
-    * @returns
-    */
-    convertCursorPoint(from: "x" | "y" | "z", to: "x" | "y" | "z", cursorNumX: number, cursorNumY: number, currentSliceIndex: number): {
-        currentIndex: number;
-        oldIndex: number;
-        convertCursorNumX: number;
-        convertCursorNumY: number;
-    } | undefined;
+     * Convert cursor point between axis views.
+     * Delegated to CrosshairTool.
+     */
+    convertCursorPoint(from: "x" | "y" | "z", to: "x" | "y" | "z", cursorNumX: number, cursorNumY: number, currentSliceIndex: number): IConvertObjType | undefined;
     private setUpSphereOrigins;
-    /****************************label div controls****************************************************/
-    getRestLabel(): ("label1" | "label2" | "label3")[];
-    /**************************** Undo clear functions****************************************************/
-    private getCurrentUndo;
+    /****************************layer div controls****************************************************/
+    getRestLayer(): string[];
+    /**************************** Undo/Redo functions (Phase 6 — Delta-based) ****************************/
     /**
-     * Clear mask on current slice canvas
+     * Clear mask on current slice canvas.
+     *
+     * Phase 2: Clears the MaskVolume slice for all three layers,
+     * re-stores, and notifies external via getMask callback with clearFlag=true.
+     * Phase 6: Also records a MaskDelta for undo support.
      */
     clearPaint(): void;
-    undoLastPainting(): void;
-    /****************************Store images****************************************************/
-    storeImageToAxis(index: number, paintedImages: IPaintImages, imageData: ImageData, axis?: "x" | "y" | "z"): void;
-    storeAllImages(index: number, label: string): void;
-    storeImageToLabel(index: number, canvas: HTMLCanvasElement, paintedImages: IPaintImages): ImageData;
-    storeEachLayerImage(index: number, label: string): void;
-    sliceArrayH(arr: Uint8ClampedArray, row: number, col: number): Uint8ClampedArray[];
-    sliceArrayV(arr: Uint8ClampedArray, row: number, col: number): number[][];
     /**
-     *
-     * @param paintImageArray : the target view slice's marked images array
-     * @param length : the target view slice's dimention (total slice index num)
-     * @param ratio : the target slice image's width/height ratio of its dimention length
-     * @param markedArr : current painted image's vertical 2d Array
-     * @param targetWidth : the target image width
-     * @param convertIndex : Mapping current image's index to target slice image's width/height pixel start point
+     * Undo the last drawing operation on the active layer.
+     * Restores the MaskVolume slice to its pre-draw state, re-renders
+     * the canvas, and notifies the backend.
      */
-    replaceVerticalColPixels(paintImageArray: IPaintImage[], length: number, ratio: number, markedArr: number[][] | Uint8ClampedArray[], targetWidth: number, convertIndex: number): void;
+    undoLastPainting(): void;
     /**
-     *
-     * @param paintImageArray : the target view slice's marked images array
-     * @param length : the target view slice's dimention (total slice index num)
-     * @param ratio : the target slice image's width/height ratio of its dimention length
-     * @param markedArr : current painted image's horizontal 2d Array
-     * @param targetWidth : the target image width
-     * @param convertIndex : Mapping current image's index to target slice image's width/height pixel start point
+     * Redo the last undone operation on the active layer.
+     * Reapplies the MaskVolume slice to its post-draw state, re-renders
+     * the canvas, and notifies the backend.
      */
-    replaceHorizontalRowPixels(paintImageArray: IPaintImage[], length: number, ratio: number, markedArr: number[][] | Uint8ClampedArray[], targetWidth: number, convertIndex: number): void;
-    /****************************** Utils for store image and itksnap core **************************************/
-    checkSharedPlaceSlice(width: number, height: number, imageData: ImageData): Uint8ClampedArray;
-    replaceArray(mainArr: number[] | Uint8ClampedArray, replaceArr: number[] | Uint8ClampedArray): void;
-    findSliceInSharedPlace(): ImageData[];
-    /******************************** Utils gui related functions ***************************************/
+    redoLastPainting(): void;
     /**
-     * Set up root container events fns for drag function
-     * @param callback
+     * Re-render a layer canvas from MaskVolume and composite to master.
+     * Called after writing oldSlice/newSlice back to the volume during undo/redo.
      */
+    private applyUndoRedoToCanvas;
+    /****************************Store images (delegated to ImageStoreHelper)****************************************************/
+    storeImageToAxis(index: number, paintedImages: IPaintImages, imageData: ImageData, axis?: "x" | "y" | "z"): void;
+    storeAllImages(index: number, layer: string): void;
+    storeImageToLayer(index: number, canvas: HTMLCanvasElement, paintedImages: IPaintImages): ImageData;
+    storeEachLayerImage(index: number, layer: string): void;
+    /******************************** Utils gui related functions (delegated to ContrastTool) ***************************************/
     setupConrastEvents(callback: (step: number, towards: "horizental" | "vertical") => void): void;
     configContrastDragMode: () => void;
     removeContrastDragMode: () => void;
-    updateSlicesContrast(value: number, flag: string): void;
-    repraintCurrentContrastSlice(): void;
+    updateSlicesContrast: (value: number, flag: string) => void;
+    repraintCurrentContrastSlice: () => void;
 }