simple-circuit-engine 0.0.11 → 0.0.12

package/dist/index.js

@@ -1,115 +1,122 @@
-import { A as e, b as o, d as r, C as s, m as i, i as n, c as l, D as c, k as u, h as S, E as y, e as G, j as h, P as N, a as B, R as F, S as C, n as p, l as v, T as g, f as E, g as m, s as L } from "./CircuitRunner-BQQlhwjD.js";
-import { BatteryBehavior as I, BatteryState as V, BehaviorRegistry as d, Circuit as D, CircuitMetadata as R, CircuitOptions as M, ComponentState as b, DoubleThrowSwitchBehavior as O, DoubleThrowSwitchState as A, InverterBehavior as _, InverterState as P, LightbulbBehavior as w, LightbulbState as X, Memoize as f, MemoizeExpiring as x, Nand4GateBehavior as U, Nand4GateState as W, Nand8GateBehavior as k, Nand8GateState as H, NandGateBehavior as j, NandGateState as z, Nor4GateBehavior as Y, Nor4GateState as q, Nor8GateBehavior as Q, Nor8GateState as J, NorGateBehavior as K, NorGateState as Z, RectangleLEDBehavior as $, RectangleLEDState as aa, RelayBehavior as ta, RelayState as ea, SmallLEDBehavior as oa, SmallLEDState as ra, SwitchBehavior as sa, SwitchState as ia, Wire as na, Xor4GateBehavior as la, Xor4GateState as ca, Xor8GateBehavior as ua, Xor8GateState as Sa, XorGateBehavior as ya, XorGateState as Ga, classifyGate as ha, computeGateDelay as Na, computeTransitionSpan as Ba, registerBasicComponentsBehaviors as Fa, registerGatesComponentsBehaviors as Ca } from "./core/index.js";
-import { d as va, i as ga, f as Ea, B as ma, a as La, C as Ta, b as Ia, e as Va, c as da, D as Da, n as Ra, F as Ma, G as ba, g as Oa, H as Aa, I as _a, L as Pa, j as wa, M as Xa, o as fa, p as xa, N as Ua, s as Wa, t as ka, q as Ha, R as ja, k as za, S as Ya, l as qa, m as Qa, W as Ja, u as Ka, v as Za, X as $a, x as at, y as tt, w as et, r as ot, h as rt } from "./setup-CIq_kgaw.js";
+import { $ as t, A as s, B as e, C as o, D as r, E as i, F as n, G as l, H as c, I as u, J as S, K as y, L as h, M as C, N as G, O as p, P as N, Q as B, R as F, S as m, T as v, U as g, V as E, W as T, X as V, Y as L, Z as I, _ as d, _t as D, a as M, at as R, b as _, bt as A, c as O, ct as b, d as P, dt as w, et as X, f, ft as U, g as k, gt as x, h as W, ht as H, i as z, it as Y, j, k as Q, l as q, lt as J, m as K, mt as Z, n as $, nt as aa, o as ta, ot as sa, p as ea, pt as oa, q as ra, r as ia, rt as na, s as la, st as ca, t as ua, tt as Sa, u as ya, ut as ha, v as Ca, vt as Ga, w as pa, x as Na, y as Ba, yt as Fa, z as ma } from "./core-Bjta9Y7_.js";
+import { A as ga, B as Ea, C as Ta, D as Va, E as La, F as Ia, H as da, I as Da, L as Ma, M as Ra, N as _a, O as Aa, P as Oa, R as ba, S as Pa, T as wa, U as Xa, V as fa, W as Ua, _ as ka, a as xa, b as Wa, c as Ha, d as za, f as Ya, g as ja, h as Qa, i as qa, j as Ja, k as Ka, l as Za, m as $a, n as at, o as tt, p as st, r as et, s as ot, t as rt, u as it, v as nt, w as lt, x as ct, y as ut, z as St } from "./scene-CVsDdySt.js";
 export {
-  e as ALL_LOGIC_FAMILIES,
-  va as BRANCHING_POINT_SENTINEL,
-  I as BatteryBehavior,
-  V as BatteryState,
-  ga as BatteryVisualFactory,
-  d as BehaviorRegistry,
-  Ea as BranchingPointVisualFactory,
-  ma as BuildTool,
-  o as CIRCUIT_FILE_VERSION,
-  r as COMPONENT_TYPE_METADATA,
-  s as CameraOptions,
-  D as Circuit,
-  La as CircuitController,
-  Ta as CircuitEngine,
-  R as CircuitMetadata,
-  M as CircuitOptions,
-  i as CircuitRunner,
-  Ia as CircuitRunnerController,
-  Va as CircuitWriter,
-  n as Component,
-  da as ComponentPickerWidget,
-  b as ComponentState,
-  l as ComponentType,
-  c as DEFAULT_LOGIC_FAMILY,
-  Da as DefaultVisualFactory,
-  u as DirtyTracker,
-  O as DoubleThrowSwitchBehavior,
-  A as DoubleThrowSwitchState,
-  Ra as DoubleThrowSwitchVisualFactory,
-  S as ENode,
-  y as ENodeSourceType,
-  G as ENodeType,
-  h as EventQueue,
-  Ma as FactoryRegistry,
-  ba as GroupedFactoryRegistry,
-  Oa as HitboxLayers,
-  Aa as HoverManager,
-  _ as InverterBehavior,
-  P as InverterState,
-  _a as InverterVisualFactory,
-  Pa as LabelVisualFactory,
-  w as LightbulbBehavior,
-  X as LightbulbState,
-  wa as LightbulbVisualFactory,
-  f as Memoize,
-  x as MemoizeExpiring,
-  Xa as MultiSelectTool,
-  U as Nand4GateBehavior,
-  W as Nand4GateState,
-  fa as Nand4GateVisualFactory,
-  k as Nand8GateBehavior,
-  H as Nand8GateState,
-  xa as Nand8GateVisualFactory,
-  j as NandGateBehavior,
-  z as NandGateState,
-  Ua as NandGateVisualFactory,
-  Y as Nor4GateBehavior,
-  q as Nor4GateState,
-  Wa as Nor4GateVisualFactory,
-  Q as Nor8GateBehavior,
-  J as Nor8GateState,
-  ka as Nor8GateVisualFactory,
-  K as NorGateBehavior,
-  Z as NorGateState,
+  R as ALL_LOGIC_FAMILIES,
+  Xa as BRANCHING_POINT_SENTINEL,
+  pa as BatteryBehavior,
+  T as BatteryState,
+  ct as BatteryVisualFactory,
+  i as BehaviorRegistry,
+  Da as BranchingPointVisualFactory,
+  da as BuildTool,
+  sa as CIRCUIT_FILE_VERSION,
+  wa as CMP_MATERIALS,
+  ca as COMPONENT_TYPE_METADATA,
+  D as CameraOptions,
+  V as Circuit,
+  Ja as CircuitController,
+  Ka as CircuitEngine,
+  X as CircuitMetadata,
+  Sa as CircuitOptions,
+  ia as CircuitRunner,
+  ga as CircuitRunnerController,
+  St as CircuitWriter,
+  d as ClockBehavior,
+  h as ClockState,
+  st as ClockVisualFactory,
+  La as CmpMatCategory,
+  Va as CmpMatType,
+  Aa as CmpMatVariant,
+  aa as Component,
+  Ua as ComponentPickerWidget,
+  l as ComponentState,
+  b as ComponentType,
+  J as DEFAULT_LOGIC_FAMILY,
+  Ta as DefaultVisualFactory,
+  M as DirtyTracker,
+  Ca as DoubleThrowSwitchBehavior,
+  F as DoubleThrowSwitchState,
+  $a as DoubleThrowSwitchVisualFactory,
+  Y as ENode,
+  ha as ENodeSourceType,
+  w as ENodeType,
+  ta as EventQueue,
+  lt as FactoryRegistry,
+  Pa as GroupedFactoryRegistry,
+  ba as HitboxLayers,
+  Ma as HoverManager,
+  k as InverterBehavior,
+  u as InverterState,
+  Ya as InverterVisualFactory,
+  Wa as LabelVisualFactory,
+  o as LightbulbBehavior,
+  g as LightbulbState,
+  ut as LightbulbVisualFactory,
+  Fa as Memoize,
+  A as MemoizeExpiring,
+  fa as MultiSelectTool,
+  K as Nand4GateBehavior,
+  N as Nand4GateState,
+  it as Nand4GateVisualFactory,
+  ea as Nand8GateBehavior,
+  G as Nand8GateState,
+  Za as Nand8GateVisualFactory,
+  W as NandGateBehavior,
+  n as NandGateState,
+  za as NandGateVisualFactory,
+  P as Nor4GateBehavior,
+  j as Nor4GateState,
+  ot as Nor4GateVisualFactory,
+  ya as Nor8GateBehavior,
+  s as Nor8GateState,
+  tt as Nor8GateVisualFactory,
+  f as NorGateBehavior,
+  C as NorGateState,
   Ha as NorGateVisualFactory,
-  N as Position,
-  B as Position3D,
-  $ as RectangleLEDBehavior,
-  aa as RectangleLEDState,
-  ja as RectangleLEDVisualFactory,
-  ta as RelayBehavior,
-  ea as RelayState,
-  za as RelayVisualFactory,
-  F as Rotation,
-  C as SIMULATION_SPEED,
-  Ya as SelectionManager,
-  p as SimulationState,
-  oa as SmallLEDBehavior,
-  ra as SmallLEDState,
-  qa as SmallLEDVisualFactory,
-  v as StateManager,
-  sa as SwitchBehavior,
-  ia as SwitchState,
+  Z as Position,
+  Ga as Position3D,
+  m as RectangleLEDBehavior,
+  E as RectangleLEDState,
+  nt as RectangleLEDVisualFactory,
+  Na as RelayBehavior,
+  e as RelayState,
+  ka as RelayVisualFactory,
+  oa as Rotation,
+  S as SIMULATION_SPEED,
+  Ea as SelectionManager,
+  y as SimulationState,
+  _ as SmallLEDBehavior,
+  c as SmallLEDState,
+  ja as SmallLEDVisualFactory,
+  z as StateManager,
+  Ba as SwitchBehavior,
+  ma as SwitchState,
   Qa as SwitchVisualFactory,
-  g as TRANSITION_DEFAULTS,
+  L as TRANSITION_DEFAULTS,
   na as Wire,
-  Ja as WireVisualManager,
-  la as Xor4GateBehavior,
-  ca as Xor4GateState,
-  Ka as Xor4GateVisualFactory,
-  ua as Xor8GateBehavior,
-  Sa as Xor8GateState,
-  Za as Xor8GateVisualFactory,
-  ya as XorGateBehavior,
-  Ga as XorGateState,
-  $a as XorGateVisualFactory,
-  ha as classifyGate,
-  Na as computeGateDelay,
-  Ba as computeTransitionSpan,
-  at as controllerOptions,
-  tt as engineOptions,
-  E as findPositionBestIndex,
-  m as generateUUID,
-  et as mapControlsOptions,
-  Fa as registerBasicComponentsBehaviors,
-  ot as registerBasicComponentsFactories,
-  Ca as registerGatesComponentsBehaviors,
-  rt as registerGatesComponentsFactories,
-  L as simplifyPositions
+  Ia as WireVisualManager,
+  O as Xor4GateBehavior,
+  p as Xor4GateState,
+  qa as Xor4GateVisualFactory,
+  la as Xor8GateBehavior,
+  r as Xor8GateState,
+  et as Xor8GateVisualFactory,
+  q as XorGateBehavior,
+  Q as XorGateState,
+  xa as XorGateVisualFactory,
+  I as classifyGate,
+  B as computeGateDelay,
+  t as computeTransitionSpan,
+  Ra as controllerOptions,
+  _a as engineOptions,
+  H as findPositionBestIndex,
+  U as generateUUID,
+  v as getTransitionSpan,
+  Oa as mapControlsOptions,
+  ua as registerBasicComponentsBehaviors,
+  rt as registerBasicComponentsFactories,
+  $ as registerGatesComponentsBehaviors,
+  at as registerGatesComponentsFactories,
+  x as simplifyPositions,
+  ra as unionElectricalStates
 };
-//# sourceMappingURL=index.js.map

package/dist/scene/CircuitEngine.d.ts

@@ -0,0 +1,270 @@
+import { MapControls } from 'three/addons/controls/MapControls.js';
+import { EventEmitter } from './shared/EventEmitter';
+import { Circuit, BehaviorRegistry } from '../core/index.ts';
+import { CircuitController } from './static/CircuitController';
+import { CircuitRunnerController } from './simulation/CircuitRunnerController';
+import { IFactoryRegistry } from './shared/components/ComponentVisualFactory';
+import { EngineMode, CircuitEngineEventMap, EngineOptions, ToolType } from './shared/types';
+/**
+ * CircuitEngine - Unified Facade for Circuit Editing and Simulation
+ * @module scene/CircuitEngine
+ *
+ * Provides a unified API for both static circuit editing and live simulation,
+ * managing mode transitions and resource sharing between controllers.
+ */
+import * as THREE from 'three';
+/**
+ * CircuitEngine - Unified Facade for Circuit Editing and Simulation
+ *
+ * Manages two internal controllers:
+ * - CircuitController: Static editing with tools, selection, and manipulation
+ * - CircuitRunnerController: Live simulation with playback and animation
+ *
+ * Both controllers share the same Three.js scene, camera, and visual objects,
+ * enabling seamless transitions between edit and simulation modes.
+ *
+ * @example
+ * ```typescript
+ * const engine = new CircuitEngine(factoryRegistry, behaviorRegistry);
+ * engine.initialize(container);
+ * engine.setCircuit(circuit);
+ *
+ * // Edit mode (default)
+ * engine.setEditModeEnabled(true);
+ * engine.setActiveTool('build');
+ *
+ * // Switch to simulation
+ * engine.setMode('simulation');
+ * engine.play();
+ *
+ * // Switch back to edit
+ * engine.setMode('edit');
+ * ```
+ */
+export declare class CircuitEngine extends EventEmitter<CircuitEngineEventMap> {
+    private readonly _factoryRegistry;
+    private readonly _behaviorRegistry;
+    private _sharedResources;
+    private _container;
+    private _editController;
+    private _simulationController;
+    private _mode;
+    private _initialized;
+    private _options;
+    private _disposed;
+    private _editControllerCleanup;
+    private _simulationControllerCleanup;
+    /**
+     * Create a new CircuitEngine instance.
+     *
+     * @param factoryRegistry - Registry of component visual factories
+     * @param behaviorRegistry - Registry of component simulation behaviors
+     * @throws {TypeError} If factoryRegistry or behaviorRegistry is null/undefined
+     */
+    constructor(factoryRegistry: IFactoryRegistry, behaviorRegistry: BehaviorRegistry);
+    /**
+     * Check if engine is initialized
+     */
+    get isInitialized(): boolean;
+    /**
+     * Check if engine is disposed
+     */
+    get isDisposed(): boolean;
+    /**
+     * Initialize the engine with a DOM container.
+     * Creates shared Three.js resources and both controllers.
+     *
+     * @param container - HTMLElement to mount the scene
+     * @param options - Configuration options
+     * @throws {TypeError} If container is not a valid HTMLElement
+     * @throws {Error} If already initialized
+     */
+    initialize(container: HTMLElement, options?: EngineOptions): void;
+    /**
+     * Create shared resources for both controllers.
+     */
+    private _createSharedResources;
+    /**
+     * Setup event forwarding from both controllers to engine.
+     */
+    private _setupEventForwarding;
+    /**
+     * Teardown event forwarding cleanup.
+     */
+    private _teardownEventForwarding;
+    /**
+     * Dispose all resources and clean up.
+     *
+     * @throws {Error} If not initialized or already disposed
+     */
+    dispose(): void;
+    /**
+     * Current operating mode
+     */
+    get mode(): EngineMode;
+    /**
+     * Switch between edit and simulation modes.
+     *
+     * @param mode - Target mode to switch to
+     * @throws {Error} If not initialized
+     * @throws {Error} If switching to simulation without a circuit loaded
+     */
+    setMode(mode: EngineMode): void;
+    /**
+     * Transition from edit mode to simulation mode.
+     */
+    private _transitionToSimulation;
+    /**
+     * Transition from simulation mode to edit mode.
+     */
+    private _transitionToEdit;
+    /**
+     * Load a circuit for editing/simulation.
+     *
+     * @param circuit - Circuit to load, or null to clear
+     * @throws {Error} If not initialized
+     */
+    setCircuit(circuit: Circuit | null): void;
+    /**
+     * Get the currently loaded circuit
+     */
+    getCircuit(): Circuit | null;
+    /**
+     * Get the edit controller for advanced operations.
+     *
+     * @throws {Error} If not initialized
+     */
+    getEditController(): CircuitController;
+    /**
+     * Get the simulation controller for advanced operations.
+     *
+     * @throws {Error} If not initialized
+     */
+    getSimulationController(): CircuitRunnerController;
+    /**
+     * Activate an editing tool.
+     *
+     * @param toolType - Tool to activate
+     * @throws {Error} If not in edit mode
+     */
+    setActiveTool(toolType: ToolType): void;
+    /**
+     * Get the currently active tool
+     *
+     * @throws {Error} If not in edit mode
+     */
+    getActiveTool(): ToolType | null;
+    /**
+     * Enable or disable edit mode (tool system).
+     *
+     * @param enabled - True to enable, false to disable
+     * @throws {Error} If not in edit mode
+     */
+    setEditModeEnabled(enabled: boolean): void;
+    /**
+     * Start automatic simulation playback.
+     *
+     * @throws {Error} If not in simulation mode
+     */
+    play(): void;
+    /**
+     * Pause automatic simulation playback.
+     *
+     * @throws {Error} If not in simulation mode
+     */
+    pause(): void;
+    /**
+     * Execute a single simulation tick.
+     *
+     * @throws {Error} If not in simulation mode
+     */
+    step(): void;
+    /**
+     * Stop simulation and reset to initial state.
+     *
+     * @throws {Error} If not in simulation mode
+     */
+    stop(): void;
+    /**
+     * Check if simulation is currently playing
+     */
+    get isPlaying(): boolean;
+    /**
+     * Get current simulation tick
+     */
+    get currentTick(): number;
+    /**
+     * Tick interval in milliseconds
+     */
+    get tickInterval(): number;
+    set tickInterval(value: number);
+    /**
+     * Simulation speed in ticks per second.
+     * Range: 1-20 TPS. Works in both edit and simulation modes.
+     */
+    get simulationSpeed(): number;
+    set simulationSpeed(tps: number);
+    /**
+     * Minimum allowed simulation speed in ticks per second.
+     */
+    get minSimulationSpeed(): number;
+    /**
+     * Maximum allowed simulation speed in ticks per second.
+     */
+    get maxSimulationSpeed(): number;
+    /**
+     * Update active animations. Call once per frame from the render loop.
+     * No-op if not initialized, disposed, or not in simulation mode.
+     *
+     * @param delta - Time in seconds since last frame (from THREE.Clock.getDelta())
+     */
+    update(delta: number): void;
+    /**
+     * Get the Three.js scene for external rendering.
+     *
+     * @throws {Error} If not initialized
+     */
+    getScene(): THREE.Scene;
+    /**
+     * Get the camera for external rendering.
+     *
+     * @throws {Error} If not initialized
+     */
+    getCamera(): THREE.PerspectiveCamera;
+    /**
+     * Get the MapControls for external manipulation.
+     *
+     * @throws {Error} If not initialized
+     */
+    getControls(): MapControls;
+    /**
+     * Hook called before exporting the circuit visualization.
+     * Saves world informations such as camera position, in the circuit metadata.
+     */
+    beforeExport(): void;
+    /**
+     * Handle container resize.
+     *
+     * @param width - New width (optional, uses container if omitted)
+     * @param height - New height (optional, uses container if omitted)
+     */
+    onContainerResize(width?: number, height?: number): void;
+    /**
+     * Check that controller is initialized and not disposed.
+     *
+     * @throws {Error} If not initialized or disposed
+     */
+    private _checkInitialized;
+    /**
+     * Check that controller is in edit mode.
+     *
+     * @throws {Error} If not in edit mode
+     */
+    private _checkEditMode;
+    /**
+     * Check that engine is in simulation mode.
+     *
+     * @throws {Error} If not in simulation mode
+     */
+    private _checkSimulationMode;
+}

package/dist/scene/index.d.ts

@@ -41,4 +41,3 @@ export { HitboxLayers } from './shared/utils/LayerConstants';
 export type { HitboxLayerValue } from './shared/utils/LayerConstants';
 export * from './shared/utils/Options';
 export { registerBasicComponentsFactories, registerGatesComponentsFactories } from './setup';
-//# sourceMappingURL=index.d.ts.map

package/dist/scene/index.js

@@ -1,43 +1,47 @@
-import { d as t, i as r, f as o, B as i, a as e, C as l, b as c, e as u, c as n, D as y, n as F, F as V, G as g, g as G, H as C, I as N, L as p, j as d, M as m, o as L, p as R, N as S, s as b, t as h, q as B, R as D, k as E, S as I, l as M, m as T, W as w, u as H, v as O, X as W, x as X, y as f, w as v, r as x, h as P } from "../setup-CIq_kgaw.js";
+import { A as s, B as t, C as r, D as o, E as i, F as e, H as l, I as c, L as u, M as n, N as y, O as F, P as V, R as C, S as g, T as p, U as G, V as N, W as m, _ as M, a as L, b as R, c as S, d as T, f as d, g as E, h as b, i as h, j as B, k as I, l as D, m as O, n as P, o as w, p as A, r as H, s as W, t as _, u as f, v as k, w as v, x, y as X, z as j } from "../scene-CVsDdySt.js";
 export {
-  t as BRANCHING_POINT_SENTINEL,
-  r as BatteryVisualFactory,
-  o as BranchingPointVisualFactory,
-  i as BuildTool,
-  e as CircuitController,
-  l as CircuitEngine,
-  c as CircuitRunnerController,
-  u as CircuitWriter,
-  n as ComponentPickerWidget,
-  y as DefaultVisualFactory,
-  F as DoubleThrowSwitchVisualFactory,
-  V as FactoryRegistry,
+  G as BRANCHING_POINT_SENTINEL,
+  x as BatteryVisualFactory,
+  c as BranchingPointVisualFactory,
+  l as BuildTool,
+  p as CMP_MATERIALS,
+  B as CircuitController,
+  I as CircuitEngine,
+  s as CircuitRunnerController,
+  j as CircuitWriter,
+  A as ClockVisualFactory,
+  i as CmpMatCategory,
+  o as CmpMatType,
+  F as CmpMatVariant,
+  m as ComponentPickerWidget,
+  r as DefaultVisualFactory,
+  O as DoubleThrowSwitchVisualFactory,
+  v as FactoryRegistry,
   g as GroupedFactoryRegistry,
-  G as HitboxLayers,
-  C as HoverManager,
-  N as InverterVisualFactory,
-  p as LabelVisualFactory,
-  d as LightbulbVisualFactory,
-  m as MultiSelectTool,
-  L as Nand4GateVisualFactory,
-  R as Nand8GateVisualFactory,
-  S as NandGateVisualFactory,
-  b as Nor4GateVisualFactory,
-  h as Nor8GateVisualFactory,
-  B as NorGateVisualFactory,
-  D as RectangleLEDVisualFactory,
-  E as RelayVisualFactory,
-  I as SelectionManager,
-  M as SmallLEDVisualFactory,
-  T as SwitchVisualFactory,
-  w as WireVisualManager,
-  H as Xor4GateVisualFactory,
-  O as Xor8GateVisualFactory,
-  W as XorGateVisualFactory,
-  X as controllerOptions,
-  f as engineOptions,
-  v as mapControlsOptions,
-  x as registerBasicComponentsFactories,
+  C as HitboxLayers,
+  u as HoverManager,
+  d as InverterVisualFactory,
+  R as LabelVisualFactory,
+  X as LightbulbVisualFactory,
+  N as MultiSelectTool,
+  f as Nand4GateVisualFactory,
+  D as Nand8GateVisualFactory,
+  T as NandGateVisualFactory,
+  W as Nor4GateVisualFactory,
+  w as Nor8GateVisualFactory,
+  S as NorGateVisualFactory,
+  k as RectangleLEDVisualFactory,
+  M as RelayVisualFactory,
+  t as SelectionManager,
+  E as SmallLEDVisualFactory,
+  b as SwitchVisualFactory,
+  e as WireVisualManager,
+  h as Xor4GateVisualFactory,
+  H as Xor8GateVisualFactory,
+  L as XorGateVisualFactory,
+  n as controllerOptions,
+  y as engineOptions,
+  V as mapControlsOptions,
+  _ as registerBasicComponentsFactories,
   P as registerGatesComponentsFactories
 };
-//# sourceMappingURL=index.js.map

package/dist/scene/setup.d.ts

@@ -0,0 +1,18 @@
+import { IGroupedFactoryRegistry } from './shared/components';
+/**
+ * Register all basic components visual factories in the basic group
+ * Basic components are : Battery, Clock, Label, Switches, Lightbulb, RectangleLED, Relay, SmallLED
+ * @public
+ * @param registry - A grouped factory registry to populate
+ * @returns The input registry for chaining
+ */
+export declare function registerBasicComponentsFactories(registry: IGroupedFactoryRegistry): IGroupedFactoryRegistry;
+/**
+ * Register all logic gates components visual factories in the gates group
+ * gates are : Inverter, NAND (2,4,8 inputs), NOR (2,4,8 inputs) and XOR (2,4,8 inputs)
+ * AND/OR are gotten by changing the activationLogic of NAND/NOR
+ * @public
+ * @param registry - A grouped factory registry to populate
+ * @returns The input registry for chaining
+ */
+export declare function registerGatesComponentsFactories(registry: IGroupedFactoryRegistry): IGroupedFactoryRegistry;