simple-circuit-engine 0.0.11 → 0.0.12

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

@@ -0,0 +1,82 @@
+import { ComponentType } from '../../../core/index.ts';
+import { IGroupedFactoryRegistry } from '../../shared/components/GroupedFactoryRegistry';
+/**
+ * Sentinel value representing the "Branching Point" pseudo-component entry.
+ * When selected, BuildTool creates a branching point instead of a component.
+ */
+export declare const BRANCHING_POINT_SENTINEL: "__branching_point__";
+/**
+ * Union of actual component types and the branching point sentinel.
+ */
+export type PickerSelection = ComponentType | typeof BRANCHING_POINT_SENTINEL;
+/**
+ * Persisted widget state (survives open/close cycles within a session).
+ */
+export interface ComponentPickerState {
+    selectedGroupId: string;
+    selectedItem: PickerSelection | null;
+    widgetWidth: number;
+    widgetHeight: number;
+}
+/**
+ * DOM overlay widget for selecting components from grouped registry.
+ *
+ * Features:
+ * - Group dropdown for filtering component types
+ * - Scrollable item list with selection highlight
+ * - Draggable header bar
+ * - Resizable via CSS resize
+ * - State persistence across open/close (group, selection, size)
+ */
+export declare class ComponentPickerWidget {
+    private readonly registry;
+    private container;
+    private groupDropdown;
+    private itemList;
+    private state;
+    private readonly onSelectionChange;
+    private readonly onClose;
+    private escapeHandler;
+    private dragOffset;
+    private dragMoveHandler;
+    private dragEndHandler;
+    /**
+     * @param registry - Grouped factory registry providing groups and component types
+     * @param onSelectionChange - Called when user selects or deselects an item
+     * @param onClose - Called when user closes the widget (close button or Escape)
+     */
+    constructor(registry: IGroupedFactoryRegistry, onSelectionChange: (selection: PickerSelection | null) => void, onClose: () => void);
+    /** Whether the widget is currently open and visible */
+    get isOpen(): boolean;
+    /** The currently selected item (persists across open/close) */
+    get currentSelection(): PickerSelection | null;
+    /**
+     * Open the widget at the given screen position.
+     * If already open, repositions to the new location.
+     *
+     * @param screenPosition - Screen coordinates (typically from mouse event)
+     */
+    open(screenPosition: {
+        x: number;
+        y: number;
+    }): void;
+    /**
+     * Close the widget and remove DOM.
+     * Preserves state (group, selection, size) for next open.
+     */
+    close(): void;
+    /**
+     * Full cleanup including state reset.
+     */
+    dispose(): void;
+    private createDOM;
+    private renderItemList;
+    private createItemElement;
+    private selectItem;
+    private positionContainer;
+    private startDrag;
+    private onDragMove;
+    private endDrag;
+    private registerEventListeners;
+    private removeEventListeners;
+}

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

@@ -0,0 +1,93 @@
+import { UUID, Component } from '../../../core/index.ts';
+import { IFactoryRegistry } from '../../shared/components/ComponentVisualFactory';
+/**
+ * Manages lil-gui configuration panel for component config editing
+ *
+ * Responsibilities:
+ * - Panel lifecycle (open, close, dispose)
+ * - DOM container creation and positioning
+ * - lil-gui initialization and form building
+ * - Click-outside and Escape key handling
+ * - onChange event wiring to update component config
+ * - Event emission for config changes
+ */
+export declare class ConfigPanelWidget {
+    private factoryRegistry;
+    private readonly editComponentConfig;
+    private _isOpen;
+    private _currentComponentId;
+    private gui;
+    private container;
+    private formDataObject;
+    private clickOutsideHandler;
+    private escapeHandler;
+    /**
+     * Create a new ConfigPanelManager
+     *
+     * @param factoryRegistry - Factory registry for getting component factories
+     * @param editComponentConfig - Function to edit component config
+     * @param _camera - Three.js camera (reserved for future use)
+     * @param _domElement - Container DOM element (reserved for future use)
+     */
+    constructor(factoryRegistry: IFactoryRegistry, editComponentConfig: (componentId: UUID, newConfig: Map<string, string>) => void, _camera: unknown, _domElement: unknown);
+    /**
+     * Check if panel is currently open
+     */
+    get isOpen(): boolean;
+    /**
+     * Get the ID of the component currently being edited
+     */
+    get currentComponentId(): UUID | null;
+    /**
+     * Open the config panel for a component
+     *
+     * @param component - component to edit
+     * @param screenPosition - Screen coordinates for panel positioning
+     * @returns true if panel opened, false if component has no config
+     */
+    open(component: Component, screenPosition: {
+        x: number;
+        y: number;
+    }): boolean;
+    /**
+     * Close the config panel if open
+     */
+    close(): void;
+    /**
+     * Dispose of all resources
+     */
+    dispose(): void;
+    /**
+     * Position the container adjacent to component (right side preferred)
+     */
+    private positionContainer;
+    /**
+     * Build lil-gui from form definition
+     */
+    private buildGui;
+    /**
+     * Handle value change in the config form
+     * Maps form data back to core config and updates the component.
+     * When defaultLogicFamily or activationLogic changes, rebuilds the GUI to reflect
+     * updated disabled states and computed transitionSpan values.
+     *
+     * @param changedKey - The key of the field that changed
+     * @param _value - The new value
+     * @param component - Component being edited
+     * @param factory - Visual factory for the component
+     */
+    private onValueChange;
+    /**
+     * Rebuild the GUI in place, re-reading the updated component config.
+     * Used after interdependent field changes (defaultLogicFamily, activationLogic).
+     */
+    private rebuildGui;
+    /**
+     * Setup event listeners for dismissing the panel
+     */
+    private setupEventListeners;
+    /**
+     * Remove event listeners
+     */
+    private removeEventListeners;
+}

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;
+}