simple-circuit-engine 0.0.13 → 0.0.14

package/dist/core/simulation/states/interface/OneLightState.d.ts

@@ -0,0 +1,6 @@
+import { UUID } from '../../../utils/types';
+import { LightState } from './LightState';
+/** Single-light input mirror. Stable states `'0'` and `'1'`. */
+export declare class OneLightState extends LightState {
+    constructor(componentId: UUID, initialState?: string);
+}

package/dist/core/simulation/states/interface/TwoInputState.d.ts

@@ -0,0 +1,6 @@
+import { UUID } from '../../../utils/types';
+import { InputState } from './InputState';
+/** Two-switch user input. Stable states `'0'`..`'3'`. */
+export declare class TwoInputState extends InputState {
+    constructor(componentId: UUID, initialState?: string);
+}

package/dist/core/simulation/states/interface/TwoLightState.d.ts

@@ -0,0 +1,6 @@
+import { UUID } from '../../../utils/types';
+import { LightState } from './LightState';
+/** Two-light input mirror. Stable states `'0'`–`'3'`. */
+export declare class TwoLightState extends LightState {
+    constructor(componentId: UUID, initialState?: string);
+}

package/dist/core/simulation/types.d.ts

@@ -44,8 +44,13 @@ export declare const TRANSITION_DEFAULTS: {
 export interface IUserCommand {
     /**
      * Type of command.
+     *
+     * - `toggle_switch`: flip a (double-throw) switch component.
+     * - `toggle_input`: flip one switch of a multi-switch input component
+     *   (OneInput, TwoInput, FourInput, EightInput); `parameters` MUST carry
+     *   `index` identifying which switch was toggled.
      */
-    readonly type: 'toggle_switch';
+    readonly type: 'toggle_switch' | 'toggle_input';
     /**
      * UUID of target component.
      */
@@ -61,6 +66,9 @@ export interface IUserCommand {
      * - `tickCount`: Number of ticks for the switch transition. Computed at toggle time
      *   using the formula: `ceil(transitionUserSpan × simulationSpeed / 1000)` with minimum of 1.
      *   If not provided, behavior uses default transition timing.
+     *
+     * For `toggle_input` commands:
+     * - `index`: index of the toggled switch within the multi-switch component.
      */
     readonly parameters?: Map<string, string> | null;
 }

package/dist/core/topology/Component.d.ts

@@ -97,6 +97,10 @@ export declare class Component {
     constructor(type: ComponentType, position: Position, rotation: Rotation, pins: ReadonlyArray<UUID>, editable?: boolean);
     getPinLabel(pinId: UUID): string | undefined;
     getPinMetadata(pinId: UUID): IPinMetadata | undefined;
+    /** Resolve the ENode UUID of the logic pin at `index` within `interfaceName`, or undefined. */
+    getPinIdByInterface(interfaceName: string, index: number): UUID | undefined;
+    /** Largest index found across pins of the given logic interface, or -1 if none. */
+    getInterfaceMaxIndex(interfaceName: string): number;
     setAllParameters(config: Map<string, string>): void;
     setParameter(key: string, value: string): void;
     /**

package/dist/core/topology/ENode.d.ts

@@ -1,5 +1,5 @@
 import { UUID, Position } from '../utils';
-import { ENodeSourceType, ENodeType, IENode } from './types';
+import { ENodeSourceType, ENodeType, IENode, ILogicPinMetadata } from './types';
 import { Circuit } from './Circuit';
 /**
  * Electrical connection point (component pin or wire branching point).
@@ -76,6 +76,10 @@ export declare class ENode {
      * @readonly
      */
     readonly subtype: string;
+    /**
+     * logic pin metadata for logicInput / logicOutput pins
+     */
+    readonly logicMetadata: ILogicPinMetadata | undefined;
     /**
      * Create a new electrical node.
      *
@@ -89,6 +93,7 @@ export declare class ENode {
      * @param source - Source type (Voltage/Current) or undefined
      *
      * @param subtype
+     * @param logicMetadata
      * @example
      * ```typescript
      * // Pin node (internal to Circuit)
@@ -110,7 +115,7 @@ export declare class ENode {
      * );
      * ```
      */
-    constructor(type: ENodeType, component: UUID | undefined, pinLabel: string | undefined, position: Position | undefined, source?: ENodeSourceType | undefined, subtype?: string);
+    constructor(type: ENodeType, component: UUID | undefined, pinLabel: string | undefined, position: Position | undefined, source: ENodeSourceType | undefined, subtype: string | undefined, logicMetadata: ILogicPinMetadata | undefined);
     /**
      * Get the position of this electrical node.
      *

package/dist/core/topology/index.d.ts

@@ -12,3 +12,5 @@ export { CircuitOptions } from './CircuitOptions.js';
 export { CircuitMetadata } from './CircuitMetadata.js';
 export { Circuit } from './Circuit.js';
 export { computeTransitionSpan, classifyGate, computeGateDelay } from './delays.js';
+export { findPinsReachableFromBp, findBpsAtLogicDistance, findPinsReachableFromBpWithPath, findBpsAtLogicDistanceWithPath, } from './networkTraversal.js';
+export type { IPinReach, IBpAtDistance } from './networkTraversal.js';

package/dist/core/topology/networkTraversal.d.ts

@@ -0,0 +1,50 @@
+import { Circuit } from './Circuit';
+import { UUID } from '../utils';
+/** Reach record returned by `findPinsReachableFromBpWithPath`. */
+export interface IPinReach {
+    /** Logic distance — number of wire edges from the start BP to this pin. */
+    Dl: number;
+    /** ENode immediately preceding the pin on the shortest BFS path back to the
+     *  start BP. For Dl=1 this is the start BP itself. */
+    predecessor: UUID;
+}
+/** Sibling record returned by `findBpsAtLogicDistanceWithPath`. */
+export interface IBpAtDistance {
+    /** Branching-point UUID at exactly the requested logic distance. */
+    id: UUID;
+    /** ENode immediately preceding this BP on the shortest BFS path back to
+     *  the start pin. For Dl=1 this is the start pin itself. */
+    predecessor: UUID;
+}
+/** BFS the BP-only sub-graph from a start branching point and report every
+ * pin reached as a terminal endpoint, with its logic distance Dl.
+ *
+ * Pins are NEVER traversed through. If two paths reach the same pin, the
+ * smallest Dl wins.
+ *
+ * @returns A map of `pinId → Dl`. Empty if no pin is reachable.
+ */
+export declare function findPinsReachableFromBp(circuit: Circuit, startBpId: UUID): Map<UUID, number>;
+/** Same as `findPinsReachableFromBp` but each entry also carries the BFS
+ * predecessor (the ENode one step closer to the start BP on the shortest
+ * path). Used by rule 4 to identify which of newBP's two wires leads back
+ * to the anchor pin.
+ *
+ * Map insertion order matches BFS visit order, so iterating it yields ties
+ * in BFS-first order.
+ */
+export declare function findPinsReachableFromBpWithPath(circuit: Circuit, startBpId: UUID): Map<UUID, IPinReach>;
+/** BFS the BP-only sub-graph from a start pin and return every BP reached at
+ * exactly logic distance `Dl` (i.e. path-edge count = `Dl`).
+ *
+ * Branches that hit any pin before reaching the target depth are cut. The
+ * start pin itself is never returned.
+ *
+ * @returns Array of branching-point UUIDs at logic distance Dl from the pin.
+ */
+export declare function findBpsAtLogicDistance(circuit: Circuit, startPinId: UUID, Dl: number): UUID[];
+/** Same as `findBpsAtLogicDistance` but each entry carries the BFS
+ * predecessor (one step closer to the start pin). Used by rule 4 to identify
+ * which wire of each sibling to split.
+ */
+export declare function findBpsAtLogicDistanceWithPath(circuit: Circuit, startPinId: UUID, Dl: number): IBpAtDistance[];

package/dist/core/topology/types.d.ts

@@ -2,7 +2,7 @@ import { ICameraOptions, IPosition, UUID } from '../utils';
 /**
  * canonic version for circuit files produced
  */
-export declare const CIRCUIT_FILE_VERSION = "0.0.11";
+export declare const CIRCUIT_FILE_VERSION = "0.0.14";
 /**
  * Type of electrical pinSources in the circuit.
  *
@@ -55,10 +55,12 @@ export declare enum ENodeType {
  *
  * @property interface - name of the pin's interface (one interface combine several pins in the case of numeric inputs/outpus)
  * @property index - index of the pin within the interface (starts at 0 by convention)
+ * @property size - whole size of the interface, e.g. number of pins it has
  */
 export interface ILogicPinMetadata {
     readonly interface: string;
     readonly index: number;
+    readonly size: number;
 }
 /**
  * Metadata describing a component pin's source type and subtype.
@@ -105,6 +107,7 @@ export interface IENode {
     position?: IPosition | null;
     source?: ENodeSourceType | null;
     subtype: string;
+    logicMetadata: ILogicPinMetadata | null;
 }
 /** Interface defining a Wire (link between 2 ENodes supporting intermediate position to tune its path) **/
 export interface IWire {
@@ -177,7 +180,15 @@ export declare enum ComponentType {
     HalfAdder = "halfAdder",
     Adder = "adder",
     EightBitAdder = "eightBitAdder",
-    EightBitOnesComplement = "eightBitOnesComplement"
+    EightBitOnesComplement = "eightBitOnesComplement",
+    OneInput = "oneInput",
+    TwoInput = "twoInput",
+    FourInput = "fourInput",
+    EightInput = "eightInput",
+    OneLight = "oneLight",
+    TwoLight = "twoLight",
+    FourLight = "fourLight",
+    EightLight = "eightLight"
 }
 /**
  * Component type metadata lookup table.