copper3d 2.2.3 → 3.0.0

package/dist/Utils/segmentation/eventRouter/EventRouter.d.ts

@@ -0,0 +1,144 @@
+/**
+ * EventRouter - Centralized Event Management
+ *
+ * Consolidates keyboard, pointer, and wheel event handling from
+ * DrawToolCore.ts and DragOperator.ts into a single unified system.
+ *
+ * Features:
+ * - Single point of event registration/cleanup
+ * - Mode-based event routing (draw, drag, contrast, crosshair, etc.)
+ * - Prevents memory leaks through proper handler cleanup
+ * - Eliminates duplicate keyboard listeners between DrawToolCore and DragOperator
+ */
+import type { InteractionMode, GuiTool, KeyboardHandler, PointerHandler, WheelHandler, ModeChangeCallback, EventRouterConfig, KeyboardSettings, InteractionState } from './types';
+export declare class EventRouter {
+    private container;
+    private canvas;
+    private mode;
+    private guiTool;
+    private state;
+    private keyboardSettings;
+    /** When false, contrast key (Ctrl/Meta) is ignored for mode switching. */
+    private contrastEnabled;
+    private onModeChange?;
+    private modeChangeSubscribers;
+    private keydownHandler?;
+    private keyupHandler?;
+    private pointerDownHandler?;
+    private pointerMoveHandler?;
+    private pointerUpHandler?;
+    private pointerLeaveHandler?;
+    private wheelHandler?;
+    private boundKeyDown;
+    private boundKeyUp;
+    private boundPointerDown;
+    private boundPointerMove;
+    private boundPointerUp;
+    private boundPointerLeave;
+    private boundWheel;
+    private boundContextMenu;
+    private isBound;
+    constructor(config: EventRouterConfig);
+    /**
+     * Bind all event listeners to DOM elements.
+     * Call this after setting handlers.
+     */
+    bindAll(): void;
+    /**
+     * Remove all event listeners from DOM elements.
+     * Call this on cleanup to prevent memory leaks.
+     */
+    unbindAll(): void;
+    /**
+     * Get the current interaction mode.
+     */
+    getMode(): InteractionMode;
+    /**
+     * Set the interaction mode directly.
+     */
+    setMode(mode: InteractionMode): void;
+    /**
+     * Subscribe to mode change events.
+     * Returns an unsubscribe function.
+     */
+    subscribeModeChange(callback: ModeChangeCallback): () => void;
+    /**
+     * Get the current GUI tool selection.
+     */
+    getGuiTool(): GuiTool;
+    /**
+     * Set the GUI tool (from UI buttons).
+     */
+    setGuiTool(tool: GuiTool): void;
+    /**
+     * Toggle crosshair mode.
+     */
+    toggleCrosshair(): void;
+    /**
+     * Check if crosshair mode is enabled.
+     */
+    isCrosshairEnabled(): boolean;
+    /**
+     * Get current interaction state.
+     */
+    getState(): Readonly<InteractionState>;
+    isShiftHeld(): boolean;
+    isCtrlHeld(): boolean;
+    isLeftButtonDown(): boolean;
+    isRightButtonDown(): boolean;
+    /**
+     * Update keyboard settings.
+     */
+    setKeyboardSettings(settings: Partial<KeyboardSettings>): void;
+    getKeyboardSettings(): KeyboardSettings;
+    /**
+     * Enable or disable the contrast shortcut (Ctrl/Meta key).
+     *
+     * When disabled:
+     * - `ctrlHeld` state is never set to true
+     * - The mode will not be changed to `'contrast'` via key events
+     * - If the mode is currently `'contrast'` it is reset to `'idle'`
+     *
+     * The external keydown/keyup handlers are still called regardless
+     * of this flag so other Ctrl-based shortcuts (e.g. Ctrl+Z undo)
+     * continue to work normally.
+     */
+    setContrastEnabled(enabled: boolean): void;
+    /** Whether the contrast shortcut is currently enabled. */
+    isContrastEnabled(): boolean;
+    /**
+     * Register the keydown handler (from DrawToolCore/DragOperator).
+     */
+    setKeydownHandler(handler: KeyboardHandler): void;
+    /**
+     * Register the keyup handler.
+     */
+    setKeyupHandler(handler: KeyboardHandler): void;
+    /**
+     * Register pointer down handler.
+     */
+    setPointerDownHandler(handler: PointerHandler): void;
+    /**
+     * Register pointer move handler.
+     */
+    setPointerMoveHandler(handler: PointerHandler): void;
+    /**
+     * Register pointer up handler.
+     */
+    setPointerUpHandler(handler: PointerHandler): void;
+    /**
+     * Register pointer leave handler.
+     */
+    setPointerLeaveHandler(handler: PointerHandler): void;
+    /**
+     * Register wheel handler.
+     */
+    setWheelHandler(handler: WheelHandler): void;
+    private handleKeyDown;
+    private handleKeyUp;
+    private handlePointerDown;
+    private handlePointerMove;
+    private handlePointerUp;
+    private handlePointerLeave;
+    private handleWheel;
+}

package/dist/Utils/segmentation/eventRouter/EventRouter.js

@@ -0,0 +1,369 @@
+/**
+ * EventRouter - Centralized Event Management
+ *
+ * Consolidates keyboard, pointer, and wheel event handling from
+ * DrawToolCore.ts and DragOperator.ts into a single unified system.
+ *
+ * Features:
+ * - Single point of event registration/cleanup
+ * - Mode-based event routing (draw, drag, contrast, crosshair, etc.)
+ * - Prevents memory leaks through proper handler cleanup
+ * - Eliminates duplicate keyboard listeners between DrawToolCore and DragOperator
+ */
+/**
+ * Default keyboard settings matching nrrd_states.keyboardSettings
+ */
+const DEFAULT_KEYBOARD_SETTINGS = {
+    draw: 'Shift',
+    undo: 'z',
+    redo: 'y',
+    contrast: ['Control', 'Meta'],
+    crosshair: 'c',
+    mouseWheel: 'Scroll:Zoom'
+};
+/**
+ * Drawing tools that can be used with Shift+drag
+ */
+const DRAWING_TOOLS = new Set(['pencil', 'brush', 'eraser']);
+export class EventRouter {
+    constructor(config) {
+        // === State ===
+        this.mode = 'idle';
+        this.guiTool = 'pencil';
+        this.state = {
+            shiftHeld: false,
+            ctrlHeld: false,
+            leftButtonDown: false,
+            rightButtonDown: false,
+            crosshairEnabled: false,
+        };
+        // === Configuration ===
+        this.keyboardSettings = DEFAULT_KEYBOARD_SETTINGS;
+        /** When false, contrast key (Ctrl/Meta) is ignored for mode switching. */
+        this.contrastEnabled = true;
+        this.modeChangeSubscribers = [];
+        // === Binding state ===
+        this.isBound = false;
+        this.container = config.container;
+        this.canvas = config.canvas;
+        this.onModeChange = config.onModeChange;
+        // Bind internal handlers
+        this.boundKeyDown = this.handleKeyDown.bind(this);
+        this.boundKeyUp = this.handleKeyUp.bind(this);
+        this.boundPointerDown = this.handlePointerDown.bind(this);
+        this.boundPointerMove = this.handlePointerMove.bind(this);
+        this.boundPointerUp = this.handlePointerUp.bind(this);
+        this.boundPointerLeave = this.handlePointerLeave.bind(this);
+        this.boundWheel = this.handleWheel.bind(this);
+        this.boundContextMenu = (e) => e.preventDefault();
+    }
+    // ========================================
+    // Lifecycle Methods
+    // ========================================
+    /**
+     * Bind all event listeners to DOM elements.
+     * Call this after setting handlers.
+     */
+    bindAll() {
+        if (this.isBound) {
+            console.warn('EventRouter: Already bound, call unbindAll() first');
+            return;
+        }
+        // Keyboard events on container
+        this.container.addEventListener('keydown', this.boundKeyDown);
+        this.container.addEventListener('keyup', this.boundKeyUp);
+        // Pointer events on canvas
+        this.canvas.addEventListener('pointerdown', this.boundPointerDown, true);
+        this.canvas.addEventListener('pointermove', this.boundPointerMove);
+        this.canvas.addEventListener('pointerup', this.boundPointerUp);
+        this.canvas.addEventListener('pointerleave', this.boundPointerLeave);
+        // Wheel event on canvas
+        this.canvas.addEventListener('wheel', this.boundWheel, { passive: false });
+        // Disable right-click context menu
+        this.canvas.addEventListener('contextmenu', this.boundContextMenu);
+        this.isBound = true;
+    }
+    /**
+     * Remove all event listeners from DOM elements.
+     * Call this on cleanup to prevent memory leaks.
+     */
+    unbindAll() {
+        if (!this.isBound) {
+            return;
+        }
+        // Keyboard events
+        this.container.removeEventListener('keydown', this.boundKeyDown);
+        this.container.removeEventListener('keyup', this.boundKeyUp);
+        // Pointer events
+        this.canvas.removeEventListener('pointerdown', this.boundPointerDown, true);
+        this.canvas.removeEventListener('pointermove', this.boundPointerMove);
+        this.canvas.removeEventListener('pointerup', this.boundPointerUp);
+        this.canvas.removeEventListener('pointerleave', this.boundPointerLeave);
+        // Wheel event
+        this.canvas.removeEventListener('wheel', this.boundWheel);
+        // Context menu
+        this.canvas.removeEventListener('contextmenu', this.boundContextMenu);
+        this.isBound = false;
+    }
+    // ========================================
+    // Mode Management
+    // ========================================
+    /**
+     * Get the current interaction mode.
+     */
+    getMode() {
+        return this.mode;
+    }
+    /**
+     * Set the interaction mode directly.
+     */
+    setMode(mode) {
+        if (this.mode === mode)
+            return;
+        const prevMode = this.mode;
+        this.mode = mode;
+        // Notify primary callback
+        if (this.onModeChange) {
+            this.onModeChange(prevMode, mode);
+        }
+        // Notify all subscribers
+        for (const subscriber of this.modeChangeSubscribers) {
+            subscriber(prevMode, mode);
+        }
+    }
+    /**
+     * Subscribe to mode change events.
+     * Returns an unsubscribe function.
+     */
+    subscribeModeChange(callback) {
+        this.modeChangeSubscribers.push(callback);
+        return () => {
+            const index = this.modeChangeSubscribers.indexOf(callback);
+            if (index >= 0) {
+                this.modeChangeSubscribers.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Get the current GUI tool selection.
+     */
+    getGuiTool() {
+        return this.guiTool;
+    }
+    /**
+     * Set the GUI tool (from UI buttons).
+     */
+    setGuiTool(tool) {
+        this.guiTool = tool;
+        // Reset to idle when switching tools
+        if (tool === 'sphere' || tool === 'calculator') {
+            this.state.crosshairEnabled = false;
+            this.setMode('idle');
+        }
+    }
+    /**
+     * Toggle crosshair mode.
+     */
+    toggleCrosshair() {
+        if (!DRAWING_TOOLS.has(this.guiTool))
+            return;
+        if (this.state.shiftHeld || this.state.ctrlHeld)
+            return;
+        this.state.crosshairEnabled = !this.state.crosshairEnabled;
+        this.setMode(this.state.crosshairEnabled ? 'crosshair' : 'idle');
+    }
+    /**
+     * Check if crosshair mode is enabled.
+     */
+    isCrosshairEnabled() {
+        return this.state.crosshairEnabled;
+    }
+    // ========================================
+    // State Queries
+    // ========================================
+    /**
+     * Get current interaction state.
+     */
+    getState() {
+        return Object.assign({}, this.state);
+    }
+    isShiftHeld() {
+        return this.state.shiftHeld;
+    }
+    isCtrlHeld() {
+        return this.state.ctrlHeld;
+    }
+    isLeftButtonDown() {
+        return this.state.leftButtonDown;
+    }
+    isRightButtonDown() {
+        return this.state.rightButtonDown;
+    }
+    // ========================================
+    // Configuration
+    // ========================================
+    /**
+     * Update keyboard settings.
+     */
+    setKeyboardSettings(settings) {
+        this.keyboardSettings = Object.assign(Object.assign({}, this.keyboardSettings), settings);
+    }
+    getKeyboardSettings() {
+        return Object.assign({}, this.keyboardSettings);
+    }
+    /**
+     * Enable or disable the contrast shortcut (Ctrl/Meta key).
+     *
+     * When disabled:
+     * - `ctrlHeld` state is never set to true
+     * - The mode will not be changed to `'contrast'` via key events
+     * - If the mode is currently `'contrast'` it is reset to `'idle'`
+     *
+     * The external keydown/keyup handlers are still called regardless
+     * of this flag so other Ctrl-based shortcuts (e.g. Ctrl+Z undo)
+     * continue to work normally.
+     */
+    setContrastEnabled(enabled) {
+        this.contrastEnabled = enabled;
+        if (!enabled && this.mode === 'contrast') {
+            this.state.ctrlHeld = false;
+            this.setMode('idle');
+        }
+    }
+    /** Whether the contrast shortcut is currently enabled. */
+    isContrastEnabled() {
+        return this.contrastEnabled;
+    }
+    // ========================================
+    // Handler Registration
+    // ========================================
+    /**
+     * Register the keydown handler (from DrawToolCore/DragOperator).
+     */
+    setKeydownHandler(handler) {
+        this.keydownHandler = handler;
+    }
+    /**
+     * Register the keyup handler.
+     */
+    setKeyupHandler(handler) {
+        this.keyupHandler = handler;
+    }
+    /**
+     * Register pointer down handler.
+     */
+    setPointerDownHandler(handler) {
+        this.pointerDownHandler = handler;
+    }
+    /**
+     * Register pointer move handler.
+     */
+    setPointerMoveHandler(handler) {
+        this.pointerMoveHandler = handler;
+    }
+    /**
+     * Register pointer up handler.
+     */
+    setPointerUpHandler(handler) {
+        this.pointerUpHandler = handler;
+    }
+    /**
+     * Register pointer leave handler.
+     */
+    setPointerLeaveHandler(handler) {
+        this.pointerLeaveHandler = handler;
+    }
+    /**
+     * Register wheel handler.
+     */
+    setWheelHandler(handler) {
+        this.wheelHandler = handler;
+    }
+    // ========================================
+    // Internal Event Handlers
+    // ========================================
+    handleKeyDown(ev) {
+        // Update state based on modifier keys
+        if (ev.key === this.keyboardSettings.draw) {
+            this.state.shiftHeld = true;
+            if (DRAWING_TOOLS.has(this.guiTool) && !this.state.ctrlHeld) {
+                this.setMode('draw');
+            }
+        }
+        if (this.contrastEnabled && this.keyboardSettings.contrast.includes(ev.key)) {
+            this.state.ctrlHeld = true;
+        }
+        // Route to external handler
+        if (this.keydownHandler) {
+            this.keydownHandler(ev);
+        }
+    }
+    handleKeyUp(ev) {
+        // Update state based on modifier keys
+        if (ev.key === this.keyboardSettings.draw) {
+            this.state.shiftHeld = false;
+            if (this.mode === 'draw') {
+                this.setMode('idle');
+            }
+        }
+        if (this.keyboardSettings.contrast.includes(ev.key)) {
+            this.state.ctrlHeld = false;
+            // Do NOT auto-exit contrast mode here. Contrast is a toggle
+            // (press Ctrl once → enter, press again → exit), not a hold.
+            // DrawToolCore's keyupHandler manages the toggle exclusively.
+            // Auto-exiting here would conflict with it (EventRouter exits,
+            // then DrawToolCore immediately re-enters → stuck in contrast).
+        }
+        // Route to external handler
+        if (this.keyupHandler) {
+            this.keyupHandler(ev);
+        }
+    }
+    handlePointerDown(ev) {
+        if (ev.button === 0) {
+            this.state.leftButtonDown = true;
+        }
+        else if (ev.button === 2) {
+            this.state.rightButtonDown = true;
+            this.setMode('pan');
+        }
+        // Route to external handler
+        if (this.pointerDownHandler) {
+            this.pointerDownHandler(ev);
+        }
+    }
+    handlePointerMove(ev) {
+        // Route to external handler
+        if (this.pointerMoveHandler) {
+            this.pointerMoveHandler(ev);
+        }
+    }
+    handlePointerUp(ev) {
+        if (ev.button === 0) {
+            this.state.leftButtonDown = false;
+        }
+        else if (ev.button === 2) {
+            this.state.rightButtonDown = false;
+            if (this.mode === 'pan') {
+                this.setMode('idle');
+            }
+        }
+        // Route to external handler
+        if (this.pointerUpHandler) {
+            this.pointerUpHandler(ev);
+        }
+    }
+    handlePointerLeave(ev) {
+        // Route to external handler
+        if (this.pointerLeaveHandler) {
+            this.pointerLeaveHandler(ev);
+        }
+    }
+    handleWheel(ev) {
+        // Route to external handler
+        if (this.wheelHandler) {
+            this.wheelHandler(ev);
+        }
+    }
+}
+//# sourceMappingURL=EventRouter.js.map

package/dist/Utils/segmentation/eventRouter/EventRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventRouter.js","sourceRoot":"","sources":["../../../../src/Utils/segmentation/eventRouter/EventRouter.ts"],"names":[],"mappings":"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"}

package/dist/Utils/segmentation/eventRouter/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Event Router Module
+ *
+ * Exports centralized event handling components for the segmentation module.
+ */
+export { EventRouter } from './EventRouter';
+export type { InteractionMode, GuiTool, KeyboardHandler, PointerHandler, WheelHandler, ModeChangeCallback, EventRouterConfig, KeyboardSettings, InteractionState } from './types';

package/dist/Utils/segmentation/eventRouter/index.js

@@ -0,0 +1,7 @@
+/**
+ * Event Router Module
+ *
+ * Exports centralized event handling components for the segmentation module.
+ */
+export { EventRouter } from './EventRouter';
+//# sourceMappingURL=index.js.map

package/dist/Utils/segmentation/eventRouter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Utils/segmentation/eventRouter/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,70 @@
+/**
+ * Event Router Types
+ *
+ * Type definitions for centralized event handling in the segmentation module.
+ */
+/**
+ * Interaction modes representing the current operational state.
+ *
+ * - `idle`: Default state, allows navigation (drag slice, wheel zoom)
+ * - `draw`: Shift held, left-drag paints (pencil/brush/eraser)
+ * - `drag`: Left-drag changes slices
+ * - `contrast`: Ctrl held, left-drag adjusts window/level
+ * - `crosshair`: Crosshair mode enabled (C key toggle)
+ * - `sphere`: Sphere placement tool active
+ * - `calculator`: Distance calculator tool active
+ * - `pan`: Right-drag panning the canvas
+ */
+export type InteractionMode = 'idle' | 'draw' | 'drag' | 'contrast' | 'crosshair' | 'sphere' | 'calculator' | 'pan';
+/**
+ * GUI tool selection (set from UI buttons)
+ */
+export type GuiTool = 'pencil' | 'brush' | 'eraser' | 'sphere' | 'calculator';
+/**
+ * Keyboard event handler type
+ */
+export type KeyboardHandler = (ev: KeyboardEvent) => void;
+/**
+ * Pointer event handler type
+ */
+export type PointerHandler = (ev: PointerEvent) => void;
+/**
+ * Wheel event handler type
+ */
+export type WheelHandler = (ev: WheelEvent) => void;
+/**
+ * Mode change callback - called when interaction mode changes
+ */
+export type ModeChangeCallback = (prevMode: InteractionMode, newMode: InteractionMode) => void;
+/**
+ * Configuration for EventRouter initialization
+ */
+export interface EventRouterConfig {
+    /** Container element to attach keyboard events */
+    container: HTMLElement;
+    /** Canvas element to attach pointer/wheel events */
+    canvas: HTMLCanvasElement;
+    /** Optional callback when mode changes */
+    onModeChange?: ModeChangeCallback;
+}
+/**
+ * Keyboard settings from nrrd_states
+ */
+export interface KeyboardSettings {
+    draw: string;
+    undo: string;
+    redo: string;
+    contrast: string[];
+    crosshair: string;
+    mouseWheel: 'Scroll:Zoom' | 'Scroll:Slice';
+}
+/**
+ * State flags tracked by EventRouter
+ */
+export interface InteractionState {
+    shiftHeld: boolean;
+    ctrlHeld: boolean;
+    leftButtonDown: boolean;
+    rightButtonDown: boolean;
+    crosshairEnabled: boolean;
+}

package/dist/Utils/segmentation/eventRouter/types.js

@@ -0,0 +1,7 @@
+/**
+ * Event Router Types
+ *
+ * Type definitions for centralized event handling in the segmentation module.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/Utils/segmentation/eventRouter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/Utils/segmentation/eventRouter/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/Utils/segmentation/tools/BaseTool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * BaseTool - Abstract base for extracted DrawToolCore tools
+ *
+ * Provides shared access to the legacy state objects (nrrd_states,
+ * gui_states, protectedData) via a ToolContext interface.
+ *
+ * NOTE: This is for the OLD DrawToolCore system.
+ * The new SegmentationManager system has its own tools in manager/tools/.
+ */
+import type { INrrdStates, IGUIStates, IProtected, ICursorPage } from "../coreTools/coreType";
+/**
+ * Shared context injected into every legacy tool.
+ * References are shared (not copied), so tools see the same state.
+ */
+export interface ToolContext {
+    nrrd_states: INrrdStates;
+    gui_states: IGUIStates;
+    protectedData: IProtected;
+    cursorPage: ICursorPage;
+}
+export declare abstract class BaseTool {
+    protected ctx: ToolContext;
+    constructor(ctx: ToolContext);
+    setContext(ctx: ToolContext): void;
+}

package/dist/Utils/segmentation/tools/BaseTool.js

@@ -0,0 +1,18 @@
+/**
+ * BaseTool - Abstract base for extracted DrawToolCore tools
+ *
+ * Provides shared access to the legacy state objects (nrrd_states,
+ * gui_states, protectedData) via a ToolContext interface.
+ *
+ * NOTE: This is for the OLD DrawToolCore system.
+ * The new SegmentationManager system has its own tools in manager/tools/.
+ */
+export class BaseTool {
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    setContext(ctx) {
+        this.ctx = ctx;
+    }
+}
+//# sourceMappingURL=BaseTool.js.map

package/dist/Utils/segmentation/tools/BaseTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTool.js","sourceRoot":"","sources":["../../../../src/Utils/segmentation/tools/BaseTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,MAAM,OAAgB,QAAQ;IAG5B,YAAY,GAAgB;QAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,GAAgB;QACzB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF"}