simple-circuit-engine 0.0.11 → 0.0.13

package/dist/scene/static/tools/MultiSelectTool.d.ts

@@ -0,0 +1,265 @@
+import { UUID, ENodeSourceType } from '../../../core/index.ts';
+import { IEditingTool, CursorType } from '../../shared/types';
+import { CircuitController } from '../CircuitController';
+/**
+ * MultiSelectTool - Enables multi-element selection and bulk operations
+ * @module scene/static/tools/MultiSelectTool
+ */
+import * as THREE from 'three';
+/**
+ * Operating modes for the MultiSelectTool
+ */
+export type MultiSelectToolMode = 'idle' | 'selecting' | 'dragging';
+/**
+ * State during rectangle selection operation (T010)
+ */
+export interface SelectionRectState {
+    /** Starting mouse position in screen coordinates */
+    startScreen: {
+        x: number;
+        y: number;
+    };
+    /** Current mouse position in screen coordinates */
+    currentScreen: {
+        x: number;
+        y: number;
+    };
+    /** DOM element for visual rectangle overlay */
+    overlayElement: HTMLDivElement;
+    /** Whether Shift key is held (additive selection mode) */
+    shiftHeld: boolean;
+    /** Elements currently previewed as "will be selected" */
+    previewedElements: Set<UUID>;
+}
+/**
+ * State during bulk move operation (T023)
+ */
+export interface BulkDragState {
+    /** Starting cursor position in world coordinates */
+    dragStartWorld: THREE.Vector3;
+    /** Snapshot of initial positions for all selected elements */
+    initialPositions: Map<UUID, THREE.Vector3>;
+    /** Wire IDs that need geometry updates during drag */
+    affectedWireIds: Set<UUID>;
+    /** Initial intermediate positions for selected wires (wireId -> array of positions) */
+    initialWireIntermediatePositions: Map<UUID, THREE.Vector3[]>;
+}
+/**
+ * Complete clipboard data structure for copy/paste
+ * TODO : copy and paste edited enodes sourceType and components config
+ */
+export interface ClipboardData {
+    /** Center of selection bounding box in grid coordinates */
+    anchor: {
+        x: number;
+        y: number;
+    };
+    /** Copied component definitions */
+    components: ClipboardComponent[];
+    /** Copied branching point definitions */
+    branchingPoints: ClipboardBranchingPoint[];
+    /** Copied wire definitions (only wires with both endpoints in selection) */
+    wires: ClipboardWire[];
+}
+/**
+ * Component data within clipboard
+ */
+export interface ClipboardComponent {
+    /** Component type identifier */
+    type: string;
+    /** Position relative to clipboard anchor */
+    relativePosition: {
+        x: number;
+        y: number;
+    };
+    /** Rotation angle in degrees */
+    rotation: number;
+    /** Original element ID for wire remapping during paste */
+    originalId: UUID;
+    /** Original configuration data for the component */
+    config: Map<string, string>;
+    /** Original pins sourceTypes */
+    pinSources: Array<ENodeSourceType | undefined | null>;
+}
+/**
+ * Branching point data within clipboard
+ */
+export interface ClipboardBranchingPoint {
+    /** Position relative to clipboard anchor */
+    relativePosition: {
+        x: number;
+        y: number;
+    };
+    /** Original element ID for wire remapping during paste */
+    originalId: UUID;
+    /** Source type of the branching point */
+    source?: ENodeSourceType | undefined;
+}
+/**
+ * Wire data within clipboard
+ */
+export interface ClipboardWire {
+    /** Original ID of first endpoint (component pin or branching point) */
+    node1OriginalId: UUID;
+    /** Original ID of second endpoint */
+    node2OriginalId: UUID;
+    /** Intermediate positions relative to clipboard anchor */
+    relativeIntermediatePositions: Array<{
+        x: number;
+        y: number;
+    }>;
+}
+/**
+ * MultiSelectTool implementation
+ *
+ * Provides functionality for:
+ * - Rectangle selection of multiple elements
+ * - Bulk move operations
+ * - Bulk delete operations
+ * - Copy/paste and cut/paste operations
+ */
+export declare class MultiSelectTool implements IEditingTool {
+    readonly type: "multiSelect";
+    private mode;
+    private readonly controller;
+    private selectionRectState;
+    private bulkDragState;
+    private clipboardData;
+    private clipboardPinToComponent;
+    private clipboardPinIndices;
+    private handlePointerDown;
+    private handlePointerMove;
+    private handlePointerUp;
+    private handleKeyDown;
+    private handleGridPositionMove;
+    constructor(controller: CircuitController);
+    /**
+     * Get the current operating mode
+     */
+    getMode(): MultiSelectToolMode;
+    /**
+     * Called when tool becomes active
+     */
+    onActivate(): void;
+    /**
+     * Called when tool is deactivated
+     */
+    onDeactivate(): void;
+    /**
+     * Cancel any in-progress operation
+     */
+    cancelOperation(): void;
+    /**
+     * Get the current cursor type for this tool (T031)
+     */
+    getCursorType(): CursorType;
+    /**
+     * Get preview objects to render in the scene
+     */
+    getPreviewObjects(): THREE.Object3D[];
+    /**
+     * Handle pointer down event (T011, T019, T020, T021, T024)
+     * - Empty space: start rectangle selection
+     * - Element click: select that element (clear others unless Shift held)
+     * - Selected element: prepare for bulk drag (Phase 4)
+     */
+    private _handlePointerDown;
+    /**
+     * Handle pointer move event (T013)
+     * Updates rectangle dimensions during selection
+     */
+    private _handlePointerMove;
+    /**
+     * Handle pointer up event (T016, T021, T029)
+     * Commits selection or bulk drag, or clears if it was just a click
+     */
+    private _handlePointerUp;
+    /**
+     * Handle grid position move event (T027)
+     * Updates element positions during bulk drag
+     */
+    private _handleGridPositionMove;
+    /**
+     * Handle keyboard events (T017, T030, T034, T043, T048, T053)
+     * - Escape: cancel current operation
+     * - Delete/Backspace: delete selection
+     * - Ctrl+C/Cmd+C: copy selection
+     * - Ctrl+V/Cmd+V: paste clipboard
+     * - Ctrl+X/Cmd+X: cut selection
+     */
+    private _handleKeyDown;
+    /**
+     * Start rectangle selection (T012)
+     */
+    private _startSelectionRect;
+    /**
+     * Update CSS overlay dimensions and position (T013)
+     */
+    private _updateSelectionRectOverlay;
+    /**
+     * Update preview highlighting for elements inside rectangle (T015)
+     */
+    private _updatePreviewHighlighting;
+    /**
+     * Get elements inside the current selection rectangle (T014)
+     * Components/BPs: selected if center is inside rectangle
+     * Wires: selected only if BOTH endpoints are selected
+     */
+    private _getElementsInSelectionRect;
+    /**
+     * Commit the rectangle selection (T016, T018, T022)
+     */
+    private _commitSelectionRect;
+    /**
+     * Cancel rectangle selection (T017)
+     */
+    private _cancelSelectionRect;
+    /**
+     * Clean up selection rectangle overlay
+     */
+    private _cleanupSelectionRect;
+    /**
+     * Start bulk drag operation (T024, T025, T026, T032)
+     */
+    private _startBulkDrag;
+    /**
+     * Update bulk drag - apply delta to all selected elements (T027, T028)
+     */
+    private _updateBulkDrag;
+    /**
+     * Commit bulk drag operation (T029, T032)
+     */
+    private _commitBulkDrag;
+    /**
+     * Cancel bulk drag operation - revert all elements to initial positions (T030)
+     */
+    private _cancelBulkDrag;
+    /**
+     * Check if clipboard has content (T050)
+     */
+    hasClipboardContent(): boolean;
+    /**
+     * Copy current selection to clipboard (T039, T040, T041, T042, T051)
+     * @returns true if copy succeeded (non-empty selection)
+     */
+    copySelection(): boolean;
+    /**
+     * Paste clipboard content at cursor position (T044, T045, T046, T047, T049, T051)
+     * @returns true if paste succeeded (non-empty clipboard)
+     */
+    pasteAtCursor(): boolean;
+    /**
+     * Cut current selection (copy + delete) (T052)
+     * @returns true if cut succeeded
+     */
+    cutSelection(): boolean;
+    /**
+     * Delete all selected elements (T033, T034, T035, T036, T037)
+     *
+     * Deletion order per research.md:
+     * 1. Selected wires
+     * 2. Selected components (cascades to connected wires)
+     * 3. Selected branching points
+     */
+    deleteSelection(): boolean;
+}