simple-circuit-engine 0.0.13 → 0.0.14

package/dist/index.js

@@ -1,139 +1,176 @@
-import { $ as t, A as e, At as s, B as r, C as i, Ct as o, D as n, Dt as l, E as c, Et as u, F as S, G as h, H as y, I as B, J as C, K as m, L as d, M as p, N as g, O as F, Ot as G, P as E, Q as N, R as v, S as V, St as T, T as A, Tt as L, U as I, V as D, W as M, X as O, Y as R, Z as _, _ as b, _t as P, a as f, at as w, b as X, bt as k, c as H, ct as U, d as x, dt as W, et as z, f as Y, ft as j, g as q, gt as J, h as K, ht as Q, i as Z, it as $, j as aa, k as ta, kt as ea, l as sa, lt as ra, m as ia, mt as oa, n as na, nt as la, o as ca, ot as ua, p as Sa, pt as ha, q as ya, r as Ba, rt as Ca, s as ma, st as da, t as pa, tt as ga, u as Fa, ut as Ga, v as Ea, vt as Na, w as va, wt as Va, x as Ta, xt as Aa, y as La, yt as Ia, z as Da } from "./core-b6Q8w2sn.js";
-import { A as Oa, B as Ra, C as _a, D as ba, E as Pa, F as fa, G as wa, H as Xa, I as ka, J as Ha, K as Ua, L as xa, M as Wa, N as za, O as Ya, P as ja, R as qa, S as Ja, T as Ka, U as Qa, V as Za, W as $a, X as at, Y as tt, Z as et, _ as st, a as rt, b as it, c as ot, d as nt, f as lt, g as ct, h as ut, i as St, j as ht, k as yt, l as Bt, m as Ct, n as mt, o as dt, p as pt, q as gt, r as Ft, s as Gt, t as Et, u as Nt, v as vt, w as Vt, x as Tt, y as At, z as Lt } from "./scene-D4QcWeiq.js";
+import { $ as t, $t as s, A as e, At as i, B as r, Bt as o, C as n, Ct as c, D as l, Dt as h, E as u, Et as S, F as g, Ft as B, G as p, Gt as y, H as F, Ht as v, I as C, It as d, J as m, Jt as L, K as E, Kt as I, L as V, Lt as G, M as N, Mt as T, N as A, Nt as O, O as M, Ot as D, P as R, Pt as f, Q as w, Qt as P, R as _, Rt as b, S as X, St as W, T as x, Tt as H, U, Ut as k, V as z, Vt as Y, W as Q, Wt as j, X as q, Xt as J, Y as K, Yt as Z, Z as $, Zt as aa, _ as ta, _t as sa, a as ea, at as ia, b as ra, bt as oa, c as na, ct as ca, d as la, dt as ha, en as ua, et as Sa, f as ga, ft as Ba, g as pa, gt as ya, h as Fa, ht as va, i as Ca, it as da, j as ma, jt as La, k as Ea, kt as Ia, l as Va, lt as Ga, m as Na, mt as Ta, n as Aa, nt as Oa, o as Ma, ot as Da, p as Ra, pt as fa, q as wa, qt as Pa, r as _a, rt as ba, s as Xa, st as Wa, t as xa, tn as Ha, tt as Ua, u as ka, ut as za, v as Ya, vt as Qa, w as ja, wt as qa, x as Ja, xt as Ka, y as Za, yt as $a, z as at, zt as tt } from "./core-HH6iRWtB.js";
+import { $ as et, A as it, B as rt, C as ot, D as nt, E as ct, F as lt, G as ht, H as ut, I as St, J as gt, K as Bt, L as pt, M as yt, N as Ft, O as vt, P as Ct, Q as dt, R as mt, S as Lt, T as Et, U as It, V as Vt, W as Gt, X as Nt, Y as Tt, Z as At, _ as Ot, a as Mt, at as Dt, b as Rt, c as ft, ct as wt, d as Pt, et as _t, f as bt, g as Xt, h as Wt, i as xt, it as Ht, j as Ut, k as kt, l as zt, lt as Yt, m as Qt, n as jt, nt as qt, o as Jt, ot as Kt, p as Zt, q as $t, r as as, rt as ts, s as ss, st as es, t as is, tt as rs, u as os, v as ns, w as cs, x as ls, y as hs, z as us } from "./scene-C1xhdw_B.js";
 export {
-  Q as ALL_LOGIC_FAMILIES,
-  Fa as AdderBehavior,
-  E as AdderState,
-  dt as AdderVisualFactory,
-  B as ArithmeticState,
-  Ha as BRANCHING_POINT_SENTINEL,
-  ta as BatteryBehavior,
-  z as BatteryState,
-  Pa as BatteryVisualFactory,
-  aa as BehaviorRegistry,
-  Za as BranchingPointVisualFactory,
-  gt as BuildTool,
-  J as CIRCUIT_FILE_VERSION,
-  Oa as CMP_MATERIALS,
-  P as COMPONENT_TYPE_METADATA,
-  l as CameraOptions,
-  ua as Circuit,
-  ka as CircuitController,
-  ja as CircuitEngine,
-  Ga as CircuitMetadata,
-  W as CircuitOptions,
-  Z as CircuitRunner,
-  fa as CircuitRunnerController,
-  $a as CircuitWriter,
-  V as ClockBehavior,
-  ya as ClockState,
-  vt as ClockVisualFactory,
-  ht as CmpMatCategory,
-  Wa as CmpMatType,
-  za as CmpMatVariant,
-  j as Component,
-  tt as ComponentPickerWidget,
-  ga as ComponentState,
-  Na as ComponentType,
-  Ia as DEFAULT_LOGIC_FAMILY,
-  Ya as DefaultVisualFactory,
-  ca as DirtyTracker,
-  i as DoubleThrowSwitchBehavior,
-  C as DoubleThrowSwitchState,
-  At as DoubleThrowSwitchVisualFactory,
-  oa as ENode,
-  k as ENodeSourceType,
-  Aa as ENodeType,
-  sa as EightBitAdderBehavior,
-  g as EightBitAdderState,
-  rt as EightBitAdderVisualFactory,
-  H as EightBitOnesComplementBehavior,
-  p as EightBitOnesComplementState,
-  St as EightBitOnesComplementVisualFactory,
-  ma as EventQueue,
-  yt as FactoryRegistry,
-  ba as GroupedFactoryRegistry,
-  x as HalfAdderBehavior,
-  S as HalfAdderState,
-  Gt as HalfAdderVisualFactory,
-  Qa as HitboxLayers,
-  Xa as HoverManager,
-  Ta as InverterBehavior,
-  m as InverterState,
-  st as InverterVisualFactory,
-  Ka as LabelVisualFactory,
-  F as LightbulbBehavior,
-  t as LightbulbState,
-  Vt as LightbulbVisualFactory,
-  ea as Memoize,
-  s as MemoizeExpiring,
-  Ua as MultiSelectTool,
-  La as Nand4GateBehavior,
-  M as Nand4GateState,
-  ut as Nand4GateVisualFactory,
+  o as ALL_LOGIC_FAMILIES,
+  Ja as AdderBehavior,
+  Ua as AdderState,
+  Ot as AdderVisualFactory,
+  ba as ArithmeticState,
+  Kt as BRANCHING_POINT_SENTINEL,
+  r as BatteryBehavior,
+  Ka as BatteryState,
+  pt as BatteryVisualFactory,
+  F as BehaviorRegistry,
+  et as BranchingPointVisualFactory,
+  Dt as BuildTool,
+  Y as CIRCUIT_FILE_VERSION,
+  Vt as CMP_MATERIALS,
+  v as COMPONENT_TYPE_METADATA,
+  P as CameraOptions,
+  La as Circuit,
+  gt as CircuitController,
+  ht as CircuitEngine,
+  B as CircuitMetadata,
+  d as CircuitOptions,
+  ea as CircuitRunner,
+  $t as CircuitRunnerController,
+  qt as CircuitWriter,
+  A as ClockBehavior,
+  Ta as ClockState,
+  kt as ClockVisualFactory,
+  ut as CmpMatCategory,
+  It as CmpMatType,
+  Gt as CmpMatVariant,
+  G as Component,
+  es as ComponentPickerWidget,
+  W as ComponentState,
+  k as ComponentType,
+  j as DEFAULT_LOGIC_FAMILY,
+  us as DefaultVisualFactory,
+  Xa as DirtyTracker,
+  R as DoubleThrowSwitchBehavior,
+  va as DoubleThrowSwitchState,
+  it as DoubleThrowSwitchVisualFactory,
+  tt as ENode,
+  y as ENodeSourceType,
+  I as ENodeType,
+  ra as EightBitAdderBehavior,
+  Sa as EightBitAdderState,
+  Xt as EightBitAdderVisualFactory,
+  Za as EightBitOnesComplementBehavior,
+  t as EightBitOnesComplementState,
+  Wt as EightBitOnesComplementVisualFactory,
+  Na as EightInputBehavior,
+  m as EightInputState,
+  os as EightInputVisualFactory,
+  Va as EightLightBehavior,
+  U as EightLightState,
+  Mt as EightLightVisualFactory,
+  na as EventQueue,
+  rt as FactoryRegistry,
+  Fa as FourInputBehavior,
+  K as FourInputState,
+  Pt as FourInputVisualFactory,
+  ka as FourLightBehavior,
+  Q as FourLightState,
+  Jt as FourLightVisualFactory,
+  mt as GroupedFactoryRegistry,
+  X as HalfAdderBehavior,
+  Oa as HalfAdderState,
+  ns as HalfAdderVisualFactory,
+  rs as HitboxLayers,
+  _t as HoverManager,
+  Ya as InputBehaviorMixin,
+  w as InputState,
+  Qt as InputVisualFactoryBase,
+  N as InverterBehavior,
+  fa as InverterState,
+  vt as InverterVisualFactory,
+  St as LabelVisualFactory,
+  Ra as LightBehaviorMixin,
+  wa as LightState,
+  zt as LightVisualFactoryBase,
+  at as LightbulbBehavior,
+  oa as LightbulbState,
+  lt as LightbulbVisualFactory,
+  ua as Memoize,
+  Ha as MemoizeExpiring,
+  Ht as MultiSelectTool,
+  e as Nand4GateBehavior,
+  ha as Nand4GateState,
+  ct as Nand4GateVisualFactory,
   Ea as Nand8GateBehavior,
-  I as Nand8GateState,
-  Ct as Nand8GateVisualFactory,
-  X as NandGateBehavior,
-  h as NandGateState,
-  ct as NandGateVisualFactory,
-  q as Nor4GateBehavior,
-  D as Nor4GateState,
-  lt as Nor4GateVisualFactory,
-  K as Nor8GateBehavior,
-  r as Nor8GateState,
-  nt as Nor8GateVisualFactory,
-  b as NorGateBehavior,
-  y as NorGateState,
-  pt as NorGateVisualFactory,
-  Va as Position,
-  G as Position3D,
-  n as RectangleLEDBehavior,
-  _ as RectangleLEDState,
-  _a as RectangleLEDVisualFactory,
-  c as RelayBehavior,
-  O as RelayState,
-  Ja as RelayVisualFactory,
-  o as Rotation,
-  at as SCE_NS,
-  $ as SIMULATION_SPEED,
-  wa as SelectionManager,
-  la as SimulationState,
-  A as SmallLEDBehavior,
-  N as SmallLEDState,
-  Tt as SmallLEDVisualFactory,
-  f as StateManager,
-  va as SwitchBehavior,
-  R as SwitchState,
-  it as SwitchVisualFactory,
-  w as TRANSITION_DEFAULTS,
-  ha as Wire,
-  Ra as WireVisualManager,
-  Sa as Xor4GateBehavior,
-  v as Xor4GateState,
-  Bt as Xor4GateVisualFactory,
-  Y as Xor8GateBehavior,
-  d as Xor8GateState,
-  ot as Xor8GateVisualFactory,
-  ia as XorGateBehavior,
+  za as Nand8GateState,
+  Et as Nand8GateVisualFactory,
+  ma as NandGateBehavior,
+  Ba as NandGateState,
+  nt as NandGateVisualFactory,
+  l as Nor4GateBehavior,
+  ca as Nor4GateState,
+  ot as Nor4GateVisualFactory,
+  u as Nor8GateBehavior,
+  Wa as Nor8GateState,
+  Lt as Nor8GateVisualFactory,
+  M as NorGateBehavior,
+  Ga as NorGateState,
+  cs as NorGateVisualFactory,
+  ta as OneInputBehavior,
+  $ as OneInputState,
+  Zt as OneInputVisualFactory,
+  ga as OneLightBehavior,
+  E as OneLightState,
+  ft as OneLightVisualFactory,
+  Z as Position,
+  s as Position3D,
+  _ as RectangleLEDBehavior,
+  Qa as RectangleLEDState,
+  Ct as RectangleLEDVisualFactory,
+  V as RelayBehavior,
+  sa as RelayState,
+  Ft as RelayVisualFactory,
+  L as Rotation,
+  wt as SCE_NS,
+  H as SIMULATION_SPEED,
+  ts as SelectionManager,
+  c as SimulationState,
+  C as SmallLEDBehavior,
+  $a as SmallLEDState,
+  yt as SmallLEDVisualFactory,
+  Ma as StateManager,
+  g as SwitchBehavior,
+  ya as SwitchState,
+  Ut as SwitchVisualFactory,
+  S as TRANSITION_DEFAULTS,
+  pa as TwoInputBehavior,
+  q as TwoInputState,
+  bt as TwoInputVisualFactory,
+  la as TwoLightBehavior,
+  p as TwoLightState,
+  ss as TwoLightVisualFactory,
+  Bt as WidgetsManager,
+  b as Wire,
+  dt as WireVisualManager,
+  ja as Xor4GateBehavior,
+  ia as Xor4GateState,
+  Rt as Xor4GateVisualFactory,
+  n as Xor8GateBehavior,
+  da as Xor8GateState,
+  hs as Xor8GateVisualFactory,
+  x as XorGateBehavior,
   Da as XorGateState,
-  Nt as XorGateVisualFactory,
-  da as classifyGate,
-  U as computeGateDelay,
-  ra as computeTransitionSpan,
-  xa as controllerOptions,
-  qa as engineOptions,
-  L as findPositionBestIndex,
-  T as generateUUID,
-  e as getTransitionSpan,
-  Lt as mapControlsOptions,
-  pa as registerArithmeticComponentsBehaviors,
-  Et as registerArithmeticComponentsFactories,
-  na as registerBasicComponentsBehaviors,
-  mt as registerBasicComponentsFactories,
-  Ba as registerGatesComponentsBehaviors,
-  Ft as registerGatesComponentsFactories,
-  et as registerSceTranslations,
-  u as simplifyPositions,
-  Ca as unionElectricalStates
+  ls as XorGateVisualFactory,
+  T as classifyGate,
+  O as computeGateDelay,
+  f as computeTransitionSpan,
+  Tt as controllerOptions,
+  Nt as engineOptions,
+  h as findBpsAtLogicDistance,
+  D as findBpsAtLogicDistanceWithPath,
+  Ia as findPinsReachableFromBp,
+  i as findPinsReachableFromBpWithPath,
+  J as findPositionBestIndex,
+  Pa as generateUUID,
+  z as getTransitionSpan,
+  At as mapControlsOptions,
+  xa as registerArithmeticComponentsBehaviors,
+  is as registerArithmeticComponentsFactories,
+  Aa as registerBasicComponentsBehaviors,
+  jt as registerBasicComponentsFactories,
+  _a as registerGatesComponentsBehaviors,
+  as as registerGatesComponentsFactories,
+  Ca as registerInterfaceComponentsBehaviors,
+  xt as registerInterfaceComponentsFactories,
+  Yt as registerSceTranslations,
+  aa as simplifyPositions,
+  qa as unionElectricalStates
 };

package/dist/scene/CircuitEngine.d.ts

@@ -25,8 +25,10 @@ import * as THREE from 'three';
  *
  * @example
  * ```typescript
+ * const renderer = new THREE.WebGLRenderer({ antialias: true });
  * const engine = new CircuitEngine(factoryRegistry, behaviorRegistry);
- * engine.initialize(container);
+ * engine.initialize(container, renderer);
+ * container.appendChild(renderer.domElement);
  * engine.setCircuit(circuit);
  *
  * // Edit mode (default)
@@ -49,11 +51,13 @@ export declare class CircuitEngine extends EventEmitter<CircuitEngineEventMap> {
     private _editController;
     private _simulationController;
     private _mode;
+    private _multiWiring;
     private _initialized;
     private _options;
     private _disposed;
     private _editControllerCleanup;
     private _simulationControllerCleanup;
+    private _widgetsManager;
     /**
      * Create a new CircuitEngine instance.
      *
@@ -71,15 +75,20 @@ export declare class CircuitEngine extends EventEmitter<CircuitEngineEventMap> {
      */
     get isDisposed(): boolean;
     /**
-     * Initialize the engine with a DOM container.
+     * Initialize the engine with a DOM container and a WebGLRenderer.
      * Creates shared Three.js resources and both controllers.
      *
-     * @param container - HTMLElement to mount the scene
+     * The caller owns the renderer and its canvas; the engine binds MapControls
+     * to `renderer.domElement` (not the container) so DOM overlays such as the
+     * integrated widgets can receive pointer events normally.
+     *
+     * @param container - HTMLElement to mount the scene (used for bounds, mouse tracking, widget overlay)
+     * @param renderer - WebGLRenderer owned by the consumer. Its canvas (`renderer.domElement`) is used for pointer input.
      * @param options - Configuration options
      * @throws {TypeError} If container is not a valid HTMLElement
      * @throws {Error} If already initialized
      */
-    initialize(container: HTMLElement, options?: EngineOptions): void;
+    initialize(container: HTMLElement, renderer: THREE.WebGLRenderer, options?: EngineOptions): void;
     /**
      * Create shared resources for both controllers.
      */
@@ -174,6 +183,17 @@ export declare class CircuitEngine extends EventEmitter<CircuitEngineEventMap> {
      * @throws {Error} If not in edit mode
      */
     setEditModeEnabled(enabled: boolean): void;
+    /**
+     * Whether the multi-wiring flag is currently enabled.
+     * Wiring tools may use it to create several wires per pull (semantics handled
+     * by the tools; the engine only owns the flag and forwards changes).
+     */
+    get multiWiring(): boolean;
+    /**
+     * Toggle the multi-wiring flag and forward to the edit controller.
+     * Emits `multiWiringChanged` once on transition.
+     */
+    setMultiWiring(value: boolean): void;
     /**
      * Start automatic simulation playback.
      *
@@ -198,6 +218,18 @@ export declare class CircuitEngine extends EventEmitter<CircuitEngineEventMap> {
      * @throws {Error} If not in simulation mode
      */
     stop(): void;
+    /**
+     * Request help for the current mode. Emits `helpRequested` with the active
+     * mode as payload; consumers decide how to render help (modal, sidebar, etc.).
+     *
+     * @example
+     * ```typescript
+     * engine.on('helpRequested', ({ mode }) => {
+     *   openHelpDialog(mode);
+     * });
+     * ```
+     */
+    requestHelp(): void;
     /**
      * Check if simulation is currently playing
      */

package/dist/scene/index.d.ts

@@ -11,9 +11,11 @@
  * ```typescript
  * import { CircuitController, FactoryRegistry } from 'simple-circuit-controller/scene';
  *
+ * const renderer = new THREE.WebGLRenderer({ antialias: true });
  * const registry = new FactoryRegistry(defaultFactory);
  * const controller = new CircuitController(registry);
- * controller.initialize(container);
+ * controller.initialize(container, renderer);
+ * container.appendChild(renderer.domElement);
  * controller.setCircuit(circuit);
  * ```
  */
@@ -21,6 +23,8 @@ export { CircuitEngine } from './CircuitEngine';
 export { CircuitController } from './static/CircuitController';
 export { CircuitRunnerController } from './simulation/CircuitRunnerController';
 export type { AbstractCircuitController } from './shared/AbstractCircuitController';
+export { WidgetsManager } from './widgets';
+export type { IEngineForWidgets } from './widgets';
 export { BuildTool } from './static/tools/BuildTool';
 export { MultiSelectTool } from './static/tools/MultiSelectTool';
 export { ComponentPickerWidget, BRANCHING_POINT_SENTINEL, } from './static/tools/ComponentPickerWidget';
@@ -40,4 +44,4 @@ export * from './shared/types';
 export { HitboxLayers } from './shared/utils/LayerConstants';
 export type { HitboxLayerValue } from './shared/utils/LayerConstants';
 export * from './shared/utils/Options';
-export { registerBasicComponentsFactories, registerGatesComponentsFactories, registerArithmeticComponentsFactories } from './setup';
+export { registerBasicComponentsFactories, registerGatesComponentsFactories, registerArithmeticComponentsFactories, registerInterfaceComponentsFactories } from './setup';

package/dist/scene/index.js

@@ -1,52 +1,64 @@
-import { A as s, B as t, C as r, D as o, E as i, F as e, G as l, H as c, I as u, J as n, K as y, L as F, M as V, N as C, O as g, P as p, R as m, S as d, T as G, U as N, V as M, W as h, Y as E, _ as A, a as B, b as L, c as R, d as S, f as T, g as b, h as I, i as O, j as D, k as H, l as P, m as f, n as w, o as W, p as _, q as k, r as v, s as x, t as X, u as j, v as q, w as z, x as J, y as K, z as U } from "../scene-D4QcWeiq.js";
+import { $ as t, A as s, B as r, C as i, D as o, E as e, F as l, G as c, H as u, I as n, J as y, K as F, L as V, M as g, N as p, O as C, P as h, Q as m, R as d, S as G, T as L, U as I, V as N, W as E, X as M, Y as B, Z as T, _ as A, a as O, at as R, b as S, c as b, d as w, et as f, f as D, g as H, h as P, i as W, it as X, j as _, k, l as v, m as x, n as j, nt as q, o as z, ot as J, p as K, q as Q, r as U, rt as Y, s as Z, st as $, t as aa, tt as ta, u as sa, v as ra, w as ia, x as oa, y as ea, z as la } from "../scene-C1xhdw_B.js";
 export {
-  W as AdderVisualFactory,
-  n as BRANCHING_POINT_SENTINEL,
-  i as BatteryVisualFactory,
-  M as BranchingPointVisualFactory,
-  k as BuildTool,
-  s as CMP_MATERIALS,
-  u as CircuitController,
-  p as CircuitEngine,
-  e as CircuitRunnerController,
-  h as CircuitWriter,
-  q as ClockVisualFactory,
-  D as CmpMatCategory,
-  V as CmpMatType,
-  C as CmpMatVariant,
-  E as ComponentPickerWidget,
-  g as DefaultVisualFactory,
-  K as DoubleThrowSwitchVisualFactory,
-  B as EightBitAdderVisualFactory,
-  O as EightBitOnesComplementVisualFactory,
-  H as FactoryRegistry,
-  o as GroupedFactoryRegistry,
-  x as HalfAdderVisualFactory,
-  N as HitboxLayers,
-  c as HoverManager,
-  A as InverterVisualFactory,
-  G as LabelVisualFactory,
-  z as LightbulbVisualFactory,
-  y as MultiSelectTool,
-  I as Nand4GateVisualFactory,
-  f as Nand8GateVisualFactory,
-  b as NandGateVisualFactory,
-  T as Nor4GateVisualFactory,
-  S as Nor8GateVisualFactory,
-  _ as NorGateVisualFactory,
-  r as RectangleLEDVisualFactory,
-  d as RelayVisualFactory,
-  l as SelectionManager,
-  J as SmallLEDVisualFactory,
-  L as SwitchVisualFactory,
-  t as WireVisualManager,
-  P as Xor4GateVisualFactory,
-  R as Xor8GateVisualFactory,
-  j as XorGateVisualFactory,
-  F as controllerOptions,
-  m as engineOptions,
-  U as mapControlsOptions,
-  X as registerArithmeticComponentsFactories,
-  w as registerBasicComponentsFactories,
-  v as registerGatesComponentsFactories
+  A as AdderVisualFactory,
+  J as BRANCHING_POINT_SENTINEL,
+  V as BatteryVisualFactory,
+  t as BranchingPointVisualFactory,
+  R as BuildTool,
+  N as CMP_MATERIALS,
+  y as CircuitController,
+  c as CircuitEngine,
+  Q as CircuitRunnerController,
+  q as CircuitWriter,
+  k as ClockVisualFactory,
+  u as CmpMatCategory,
+  I as CmpMatType,
+  E as CmpMatVariant,
+  $ as ComponentPickerWidget,
+  la as DefaultVisualFactory,
+  s as DoubleThrowSwitchVisualFactory,
+  H as EightBitAdderVisualFactory,
+  P as EightBitOnesComplementVisualFactory,
+  sa as EightInputVisualFactory,
+  O as EightLightVisualFactory,
+  r as FactoryRegistry,
+  w as FourInputVisualFactory,
+  z as FourLightVisualFactory,
+  d as GroupedFactoryRegistry,
+  ra as HalfAdderVisualFactory,
+  ta as HitboxLayers,
+  f as HoverManager,
+  x as InputVisualFactoryBase,
+  C as InverterVisualFactory,
+  n as LabelVisualFactory,
+  v as LightVisualFactoryBase,
+  l as LightbulbVisualFactory,
+  X as MultiSelectTool,
+  e as Nand4GateVisualFactory,
+  L as Nand8GateVisualFactory,
+  o as NandGateVisualFactory,
+  i as Nor4GateVisualFactory,
+  G as Nor8GateVisualFactory,
+  ia as NorGateVisualFactory,
+  K as OneInputVisualFactory,
+  b as OneLightVisualFactory,
+  h as RectangleLEDVisualFactory,
+  p as RelayVisualFactory,
+  Y as SelectionManager,
+  g as SmallLEDVisualFactory,
+  _ as SwitchVisualFactory,
+  D as TwoInputVisualFactory,
+  Z as TwoLightVisualFactory,
+  F as WidgetsManager,
+  m as WireVisualManager,
+  S as Xor4GateVisualFactory,
+  ea as Xor8GateVisualFactory,
+  oa as XorGateVisualFactory,
+  B as controllerOptions,
+  M as engineOptions,
+  T as mapControlsOptions,
+  aa as registerArithmeticComponentsFactories,
+  j as registerBasicComponentsFactories,
+  U as registerGatesComponentsFactories,
+  W as registerInterfaceComponentsFactories
 };

package/dist/scene/setup.d.ts

@@ -24,3 +24,13 @@ export declare function registerGatesComponentsFactories(registry: IGroupedFacto
  * @returns The input registry for chaining
  */
 export declare function registerArithmeticComponentsFactories(registry: IGroupedFactoryRegistry): IGroupedFactoryRegistry;
+/**
+ * Register all interface components visual factories in the interface group.
+ * Interface components are:
+ *  - inputs: OneInput, TwoInput, FourInput, EightInput
+ *  - lights: OneLight, TwoLight, FourLight, EightLight
+ * @public
+ * @param registry - A grouped factory registry to populate
+ * @returns The input registry for chaining
+ */
+export declare function registerInterfaceComponentsFactories(registry: IGroupedFactoryRegistry): IGroupedFactoryRegistry;

package/dist/scene/shared/AbstractCircuitController.d.ts

@@ -32,6 +32,7 @@ import * as THREE from 'three';
  */
 export declare abstract class AbstractCircuitController extends EventEmitter<ControllerEventMap> {
     protected _container: HTMLElement | null;
+    protected _renderer: THREE.WebGLRenderer | null;
     protected _scene: THREE.Scene | null;
     protected _grid: THREE.GridHelper | null;
     protected _camera: THREE.PerspectiveCamera | null;
@@ -69,18 +70,19 @@ export declare abstract class AbstractCircuitController extends EventEmitter<Con
     protected get grid(): THREE.GridHelper | null;
     protected set grid(grid: THREE.GridHelper);
     /**
-     * Initialize the controller with a DOM container.
+     * Initialize the controller with a DOM container and a WebGLRenderer.
      * Creates scene, camera, lights, MapControls, and HoverManager.
      *
      * When sharedResources were provided in constructor, uses those instead
      * of creating new resources. This enables the CircuitEngine facade pattern.
      *
-     * @param container - HTMLElement to attach scene to
+     * @param container - HTMLElement to attach scene to (bounds, hover, mouse tracking)
+     * @param renderer - WebGLRenderer owned by the consumer; `renderer.domElement` is what MapControls binds to
      * @param options - Optional configuration
      * @throws {TypeError} If container is not a valid HTMLElement
      * @throws {Error} If already initialized
      */
-    initialize(container: HTMLElement, options?: ControllerOptions): void;
+    initialize(container: HTMLElement, renderer: THREE.WebGLRenderer, options?: ControllerOptions): void;
     /**
      * Hook for subclasses to perform additional initialization.
      * Called after base initialization but before emitting 'ready'.

package/dist/scene/shared/HoverManager.d.ts

@@ -55,6 +55,21 @@ export declare class HoverManager {
      * @param normalizedY - Mouse Y in normalized HTML container coordinates [-1, 1]
      */
     updateFromMouse(normalizedX: number, normalizedY: number): void;
+    /**
+     * Raycast against the descendants of the given component object3D at the
+     * last known mouse position and return all `userData.part` strings that
+     * are currently hit.
+     *
+     * Useful when a click on a component hitbox needs to be refined to a
+     * specific sub-part (e.g. one switch among many in a multi-input
+     * component). Unlike priority hover detection this method ignores hitbox
+     * layers and walks the full sub-tree.
+     *
+     * @param componentObject3D - Root object of the component to introspect
+     * @returns De-duplicated `part` strings hit, in raycast order. Empty if
+     *          no annotated mesh is under the cursor.
+     */
+    getHoveredComponentParts(componentObject3D: THREE.Object3D): string[];
     /**
      * Force update hover state at current mouse position
      *

package/dist/scene/shared/components/index.d.ts

@@ -31,3 +31,13 @@ export { HalfAdderVisualFactory } from './arithmetic/HalfAdderVisualFactory';
 export { AdderVisualFactory } from './arithmetic/AdderVisualFactory';
 export { EightBitAdderVisualFactory } from './arithmetic/EightBitAdderVisualFactory';
 export { EightBitOnesComplementVisualFactory } from './arithmetic/EightBitOnesComplementVisualFactory';
+export { InputVisualFactoryBase } from './interface/InputVisualFactoryBase';
+export { OneInputVisualFactory } from './interface/OneInputVisualFactory';
+export { TwoInputVisualFactory } from './interface/TwoInputVisualFactory';
+export { FourInputVisualFactory } from './interface/FourInputVisualFactory';
+export { EightInputVisualFactory } from './interface/EightInputVisualFactory';
+export { LightVisualFactoryBase } from './interface/LightVisualFactoryBase';
+export { OneLightVisualFactory } from './interface/OneLightVisualFactory';
+export { TwoLightVisualFactory } from './interface/TwoLightVisualFactory';
+export { FourLightVisualFactory } from './interface/FourLightVisualFactory';
+export { EightLightVisualFactory } from './interface/EightLightVisualFactory';

package/dist/scene/shared/components/interface/EightInputVisualFactory.d.ts

@@ -0,0 +1,15 @@
+import { Component } from '../../../../core/index.ts';
+import { VisualContext } from '../../types';
+import { InputVisualFactoryBase } from './InputVisualFactoryBase';
+import * as THREE from 'three';
+/** Visual factory for the EightInput component (eight-switch user input). */
+export declare class EightInputVisualFactory extends InputVisualFactoryBase {
+    protected readonly bitCount = 8;
+    protected readonly holePositions: Array<{
+        x: number;
+        y: number;
+    }>;
+    protected readonly envelopeHeight = 8.4;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+}