simple-circuit-engine 0.0.13 → 0.0.14

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