simple-circuit-engine 0.0.12 → 0.0.14

package/dist/scene/widgets/MultiWiringWidget.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Multi-Wiring Widget
+ * @module scene/widgets/MultiWiringWidget
+ *
+ * Single toggle button (verr-maj style) that flips the engine's multi-wiring
+ * flag. Visible only in edit mode.
+ */
+export declare class MultiWiringWidget {
+    private readonly _button;
+    private readonly _onToggle;
+    private _active;
+    constructor(initialActive: boolean, onToggle: () => void);
+    mount(parent: HTMLElement): void;
+    setVisible(visible: boolean): void;
+    setActive(active: boolean): void;
+    setLanguage(_lng: string): void;
+    dispose(): void;
+    /** Test/debug accessor. */
+    get element(): HTMLButtonElement;
+    private _render;
+}

package/dist/scene/{static → widgets}/PinTooltipWidget.d.ts

@@ -1,4 +1,5 @@
 import { ComponentType } from '../../core/index.ts';
+import { ILogicPinMetadata } from '../../core/topology/types';
 /**
  * Manages a transient HTML tooltip displayed when hovering a component pin.
  *
@@ -15,12 +16,17 @@ export declare class PinTooltipWidget {
      * Show tooltip at the given client coordinates for the specified pin.
      * If already showing for the same component type, only repositions.
      */
-    show(pinLabel: string, componentType: ComponentType, clientX: number, clientY: number): void;
+    show(pinLabel: string, componentType: ComponentType, logicMetadata: ILogicPinMetadata | null, clientX: number, clientY: number): void;
     /** Hide and remove the tooltip element */
     hide(): void;
     /** Update cursor position without recreating the tooltip */
     updatePosition(clientX: number, clientY: number): void;
     get isVisible(): boolean;
+    /**
+     * Signal a language change — hides any open tooltip so the next hover
+     * recreates it with updated translations.
+     */
+    setLanguage(_lng: string): void;
     dispose(): void;
     private _position;
 }

package/dist/scene/widgets/SimulationPlayerWidget.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Simulation Player Widget
+ * @module scene/widgets/SimulationPlayerWidget
+ *
+ * Horizontal control strip: stop | (spacer) | play/pause | speed slider |
+ * TPS indicator | step. Visible only in simulation mode.
+ *
+ * Play/pause button icon reflects current state: `pauseIcon` while playing,
+ * `playIcon` while paused. The step button relies on the engine pausing
+ * automatically when stepping while playing.
+ */
+export interface SimulationPlayerCallbacks {
+    onTogglePlay: () => void;
+    onSpeedChange: (tps: number) => void;
+    onStep: () => void;
+    onStopReset: () => void;
+}
+export declare class SimulationPlayerWidget {
+    private readonly _root;
+    private readonly _stopBtn;
+    private readonly _playPauseBtn;
+    private readonly _stepBtn;
+    private readonly _slider;
+    private readonly _speedLabel;
+    private readonly _callbacks;
+    private _isPlaying;
+    private _currentTick;
+    constructor(minSpeed: number, maxSpeed: number, initialSpeed: number, initialPlaying: boolean, callbacks: SimulationPlayerCallbacks);
+    mount(parent: HTMLElement): void;
+    setVisible(visible: boolean): void;
+    setPosition(top: number, left: number): void;
+    setSpeed(tps: number): void;
+    setTick(tick: number): void;
+    setPlaying(playing: boolean): void;
+    setLanguage(_lng: string): void;
+    dispose(): void;
+    /** Test/debug accessor. */
+    get element(): HTMLDivElement;
+    /** Test/debug accessor. */
+    get sliderElement(): HTMLInputElement;
+    /** Test/debug accessor. */
+    get stopButton(): HTMLButtonElement;
+    /** Test/debug accessor. */
+    get playPauseButton(): HTMLButtonElement;
+    /** Test/debug accessor. */
+    get stepButton(): HTMLButtonElement;
+    private _makeStopButton;
+    private _makePlayPauseButton;
+    private _makeStepButton;
+    private _makeSlider;
+    private _makeSpeedLabel;
+    private _renderLabel;
+    private _renderPlayPauseIcon;
+    private _playPauseTitle;
+    private _renderThumbColor;
+    /**
+     * Inject a one-shot stylesheet for the slider thumb so it visually matches
+     * `slider.png` (orange round thumb on a grey track) on browsers that ignore
+     * `accent-color`. Idempotent across multiple widget instances.
+     */
+    private _injectThumbStyles;
+}

package/dist/scene/widgets/ToolsWidget.d.ts

@@ -0,0 +1,18 @@
+import { ToolType } from '../shared/types';
+export declare class ToolsWidget {
+    private readonly _root;
+    private readonly _buildBtn;
+    private readonly _multiSelectBtn;
+    private readonly _onSelect;
+    private _activeTool;
+    constructor(initialTool: ToolType | null, onSelect: (tool: ToolType) => void);
+    mount(parent: HTMLElement): void;
+    setVisible(visible: boolean): void;
+    setActiveTool(tool: ToolType | null): void;
+    setLanguage(_lng: string): void;
+    dispose(): void;
+    /** Test/debug accessor. */
+    get element(): HTMLDivElement;
+    private _makeButton;
+    private _render;
+}

package/dist/scene/widgets/WidgetsManager.d.ts

@@ -0,0 +1,65 @@
+import { EngineMode, ToolType } from '../shared/types';
+import { HelpWidget } from './HelpWidget';
+import { SimulationPlayerWidget } from './SimulationPlayerWidget';
+/**
+ * Minimal slice of CircuitEngine the manager depends on. Defined as an
+ * interface (rather than importing `CircuitEngine` directly) to keep widgets
+ * unit-testable with a small mock.
+ */
+export interface IEngineForWidgets {
+    readonly mode: EngineMode;
+    readonly multiWiring: boolean;
+    readonly simulationSpeed: number;
+    readonly minSimulationSpeed: number;
+    readonly maxSimulationSpeed: number;
+    readonly isPlaying: boolean;
+    setMode(mode: EngineMode): void;
+    setActiveTool(toolType: ToolType): void;
+    getActiveTool(): ToolType | null;
+    setEditModeEnabled(enabled: boolean): void;
+    setMultiWiring(value: boolean): void;
+    play(): void;
+    pause(): void;
+    step(): void;
+    stop(): void;
+    requestHelp(): void;
+    on(event: any, callback: (payload: any) => void): void;
+    off(event: any, callback: (payload: any) => void): void;
+}
+export declare class WidgetsManager {
+    private readonly _engine;
+    private readonly _container;
+    private readonly _root;
+    private readonly _modeWidget;
+    private readonly _toolsWidget;
+    private readonly _multiWiringWidget;
+    private readonly _playerWidget;
+    private readonly _helpWidget;
+    private readonly _subscriptions;
+    private _disposed;
+    private _resizeObserver;
+    constructor(engine: IEngineForWidgets, container: HTMLElement);
+    /**
+     * Re-render translated labels after the consumer changed i18next language.
+     */
+    setLanguage(lng: string): void;
+    dispose(): void;
+    /** Test/debug accessor. */
+    get root(): HTMLDivElement;
+    /** Test/debug accessor. */
+    get container(): HTMLElement;
+    /** Test/debug accessor. */
+    get helpWidget(): HelpWidget;
+    /** Test/debug accessor. */
+    get playerWidget(): SimulationPlayerWidget;
+    private _subscribeToEngine;
+    private _listen;
+    private _applyModeVisibility;
+    private _handleModeToggle;
+    private _handleToolSelect;
+    private _handleMultiWiringToggle;
+    private _handleHelpRequested;
+    private _applyResponsivePlayerLayout;
+    private _observeContainerResize;
+    private _safeCall;
+}

package/dist/scene/widgets/assets/icons.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Embedded heroicon SVGs (24x24 outline) used by the integrated widgets.
+ *
+ * Sources: https://heroicons.com/ (MIT). Inlined as raw markup so the library
+ * ships no external icon dependency and CSS `currentColor` drives the stroke.
+ */
+export declare const wrenchScrewdriverIcon: string;
+export declare const cubeTransparentIcon: string;
+export declare const barsArrowDownIcon: string;
+export declare const playIcon: string;
+export declare const pauseIcon: string;
+export declare const stepIcon: string;
+export declare const stopIcon: string;
+export declare const questionMarkIcon: string;
+/**
+ * Wrap an inline SVG string into a `<span>` so it can be appended to any
+ * widget DOM. The SVG inherits `color` from the parent button so styling stays
+ * declarative.
+ */
+export declare function iconElement(svg: string, sizePx?: number): HTMLElement;

package/dist/scene/widgets/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Integrated overlay widgets shipped with the scene module.
+ *
+ * Public surface kept minimal: only `WidgetsManager` is exported so consumers
+ * who opt out of the bundled wiring can still mount it manually. Individual
+ * widgets are implementation detail.
+ */
+export { WidgetsManager } from './WidgetsManager';
+export type { IEngineForWidgets } from './WidgetsManager';

package/dist/scene/widgets/styles.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared inline-style helpers for the integrated widgets.
+ *
+ * Library convention is to avoid bundling a stylesheet — every widget styles
+ * its DOM via `Object.assign(el.style, ...)`. These helpers centralise the
+ * shared tokens (button base, active state, container) so the four widgets
+ * stay visually consistent without an external CSS file.
+ */
+export declare const WIDGET_Z_INDEX = 1500;
+/** Base background and border for square icon buttons (inactive state). */
+export declare function applyIconButtonBase(button: HTMLButtonElement): void;
+/** Toggle the active visual variant on an icon button. */
+export declare function setIconButtonActive(button: HTMLButtonElement, active: boolean): void;
+/** Position a widget root absolutely inside the engine container. */
+export declare function applyWidgetRoot(el: HTMLElement, top: number, left: number): void;
+/** Vertical layout offsets (px) for the left-edge widget stack. */
+export declare const LAYOUT: {
+    readonly GUTTER: 12;
+    readonly BUTTON: 36;
+    readonly MODE_TOP: 12;
+    readonly TOOLS_TOP: 60;
+    readonly MULTI_WIRING_TOP: 60;
+    readonly MULTI_WIRING_LEFT: 53;
+    readonly PLAYER_TOP: 8;
+    readonly PLAYER_LEFT: 170;
+    readonly PLAYER_RESPONSIVE_TOP: 60;
+    readonly PLAYER_RESPONSIVE_LEFT: 12;
+    readonly HELP_TOP_EDIT: 10;
+    readonly HELP_LEFT_EDIT: 100;
+    readonly HELP_TOP_SIM: 10;
+    readonly HELP_LEFT_SIM: 130;
+    readonly LEFT: 12;
+};