simple-circuit-engine 0.0.12 → 0.0.13

package/dist/index.js

@@ -1,122 +1,139 @@
-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";
+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";
 export {
-  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,
-  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,
-  L as TRANSITION_DEFAULTS,
-  na as Wire,
-  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
+  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,
+  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,
+  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
 };

package/dist/scene/CircuitEngine.d.ts

@@ -102,6 +102,19 @@ export declare class CircuitEngine extends EventEmitter<CircuitEngineEventMap> {
      * Current operating mode
      */
     get mode(): EngineMode;
+    /**
+     * Refresh all scene widgets to display strings in the given language.
+     *
+     * Does NOT change the consumer's i18next instance — the caller must have
+     * already called `i18next.changeLanguage(lng)` before invoking this. This
+     * method only signals the scene to re-read translations for currently-open
+     * widgets (pin tooltip, component picker, config panel).
+     *
+     * Safe to call at any point in the engine lifecycle after `initialize()`.
+     *
+     * @param lng - Target language code (e.g., 'en', 'fr')
+     */
+    setLanguage(lng: string): void;
     /**
      * Switch between edit and simulation modes.
      *

package/dist/scene/index.d.ts

@@ -40,4 +40,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 } from './setup';
+export { registerBasicComponentsFactories, registerGatesComponentsFactories, registerArithmeticComponentsFactories } from './setup';

package/dist/scene/index.js

@@ -1,47 +1,52 @@
-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";
+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";
 export {
-  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,
-  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
+  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
 };

package/dist/scene/setup.d.ts

@@ -16,3 +16,11 @@ export declare function registerBasicComponentsFactories(registry: IGroupedFacto
  * @returns The input registry for chaining
  */
 export declare function registerGatesComponentsFactories(registry: IGroupedFactoryRegistry): IGroupedFactoryRegistry;
+/**
+ * Register all arithmetic components visual factories in the arithmetic group
+ * Arithmetic components are : HalfAdder
+ * @public
+ * @param registry - A grouped factory registry to populate
+ * @returns The input registry for chaining
+ */
+export declare function registerArithmeticComponentsFactories(registry: IGroupedFactoryRegistry): IGroupedFactoryRegistry;

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

@@ -129,6 +129,12 @@ export declare abstract class AbstractCircuitController extends EventEmitter<Con
      * Get the current circuit being visualized
      */
     getCircuit(): Circuit | null;
+    /**
+     * Refresh any user-visible strings in owned widgets after the consumer has
+     * switched i18next to a new language. Default is a no-op for controllers
+     * that own no translated widgets.
+     */
+    setLanguage(_lng: string): void;
     protected abstract onSetCircuit(): void;
     /**
      * Loads a new circuit to visualize or null for clearing the scene

package/dist/scene/shared/components/arithmetic/AdderVisualFactory.d.ts

@@ -0,0 +1,54 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for Adder components.
+ *
+ * Creates:
+ * - An `envelope` rectangular frame (EmptyRectangleGeometry)
+ * - A horizontal `separator` box dividing upper/lower chambers
+ * - A `sumFiller` (RectangleWithNailGeometry) in the upper chamber;
+ *   its material is animated blue↔red following the sum output state
+ * - A `plus` box inside the sumFiller (visual cue)
+ * - A `carryFiller` (RectangleWithNailGeometry) box in the lower chamber; its material is animated
+ *   blue↔red following the carry output state
+ * - pin groups for vcc, inputA, inputB, sum, carry, gnd
+ *
+ * Animation:
+ * - sumFiller ↔ blue/red based on sum output (current/next state)
+ * - carryFiller ↔ blue/red based on carry output (current/next state)
+ */
+export declare class AdderVisualFactory extends ComponentVisualFactoryBase {
+    private readonly ENVELOPE_GEOM;
+    /** Horizontal separator splitting upper/lower chambers at Z=0 */
+    private readonly SEPARATOR_GEOM;
+    private readonly SEPARATOR_SIDE_GEOM;
+    private readonly CELL_FILLER_GEOM;
+    /** Small box inside sumFiller (visual cue for the XOR "+") */
+    private readonly PLUS_GEOM;
+    protected readonly FILLER_COLOR_HIGH: THREE.Color;
+    protected readonly FILLER_COLOR_LOW: THREE.Color;
+    protected readonly FILLER_EMISSIVE_HIGH_INTENSITY = 0.5;
+    protected readonly FILLER_EMISSIVE_LOW_INTENSITY = 0.2;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    protected createPinsVisual(component: Component, context: VisualContext, group: THREE.Group): void;
+    getConfigFormDefinition(config?: Map<string, string>): ConfigFormDefinition | null;
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    updateAnimation(object3D: THREE.Object3D, state: ComponentState | null): void;
+    private _setFillerColor;
+    private _ensureClonedFillerMaterial;
+    private _restoreSharedFillerMaterial;
+    private _cleanupMixer;
+    /**
+     * Animate sumFiller and carryFiller fill colors over the transition span.
+     * Builds a single AnimationClip with up to two target tracks per filler
+     * (color, emissive, emissiveIntensity) — only for fillers whose value changes.
+     */
+    private _animateFillers;
+    private _pushFillerTracks;
+    /** Find a child mesh by its userData.part name */
+    protected findPartMesh(object3D: THREE.Object3D, part: string): THREE.Mesh | null;
+}

package/dist/scene/shared/components/arithmetic/EightBitAdderVisualFactory.d.ts

@@ -0,0 +1,45 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for EightBitAdder components.
+ *
+ * Creates:
+ * - An `envelope` frame (KuKoGeometry)
+ * - A vertical `separator` dividing carry/sum cells
+ * - 7 horizontal separators dividing ith cells
+ * - 16 cells carry i / sum i representing state
+ *   cells materials are animated blue↔red following the component state
+ * - pin groups for vcc, 2*8 inputs, 8*sums, carryIn, carryOut and gnd
+ *
+ */
+export declare class EightBitAdderVisualFactory extends ComponentVisualFactoryBase {
+    private readonly ENVELOPE_GEOM;
+    private readonly VERTICAL_SEPARATOR_GEOM;
+    private readonly HORIZONTAL_SEPARATOR_GEOM;
+    private readonly CELL_FILLER_GEOM;
+    protected readonly FILLER_COLOR_HIGH: THREE.Color;
+    protected readonly FILLER_COLOR_LOW: THREE.Color;
+    protected readonly FILLER_EMISSIVE_HIGH_INTENSITY = 0.5;
+    protected readonly FILLER_EMISSIVE_LOW_INTENSITY = 0.2;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    protected createPinsVisual(component: Component, context: VisualContext, group: THREE.Group): void;
+    getConfigFormDefinition(config?: Map<string, string>): ConfigFormDefinition | null;
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    updateAnimation(object3D: THREE.Object3D, state: ComponentState | null): void;
+    private _setCellColor;
+    private _ensureClonedMaterial;
+    private _restoreSharedMaterial;
+    private _cleanupMixer;
+    /** Collect all 16 cell meshes with their state bit position. */
+    private _findCellMeshes;
+    /**
+     * Animate the 16 cells over the transition span.
+     * Builds a single AnimationClip with tracks only for cells whose bit changes.
+     */
+    private _animateCells;
+    private _pushCellTracks;
+}

package/dist/scene/shared/components/arithmetic/EightBitOnesComplementVisualFactory.d.ts

@@ -0,0 +1,63 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for EightBitOnesComplement components.
+ *
+ * Creates:
+ * - An `envelope` frame (EmptyRectangleGeometry)
+ * - A vertical `separator` dividing flag area / outputs cells
+ * - 7 horizontal separators dividing ith cells
+ * - 2 rectangles with nail filler, 3 animated box geometry and 2 filler boxes for flag area
+ * - 8 cells outputs i representing output state
+ *   cells materials are animated blue↔red following the component state
+ * - pin groups for vcc, 8 inputs, 8*outputs and gnd
+ *
+ */
+export declare class EightBitOnesComplementVisualFactory extends ComponentVisualFactoryBase {
+    private readonly ENVELOPE_GEOM;
+    private readonly VERTICAL_SEPARATOR_GEOM;
+    private readonly HORIZONTAL_SEPARATOR_GEOM;
+    private readonly CELL_FILLER_GEOM;
+    private readonly INDICATOR_MINUS_GEOM;
+    private readonly INDICATOR_PLUS_GEOM;
+    private readonly INDICATOR_FILLER_GEOM;
+    protected readonly FILLER_COLOR_HIGH: THREE.Color;
+    protected readonly FILLER_COLOR_LOW: THREE.Color;
+    protected readonly FILLER_COLOR_NEUTRAL: THREE.Color;
+    protected readonly FILLER_EMISSIVE_BLACK: THREE.Color;
+    protected readonly FILLER_EMISSIVE_HIGH_INTENSITY = 0.5;
+    protected readonly FILLER_EMISSIVE_LOW_INTENSITY = 0.2;
+    protected readonly FILLER_EMISSIVE_NEUTRAL_INTENSITY = 0;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    protected createPinsVisual(component: Component, context: VisualContext, group: THREE.Group): void;
+    getConfigFormDefinition(config?: Map<string, string>): ConfigFormDefinition | null;
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    updateAnimation(object3D: THREE.Object3D, state: ComponentState | null): void;
+    /**
+     * Resolve the target color state for a cell given its kind and the bit value:
+     * - `output`: high→red, low→blue
+     * - `minus`:  high→blue, low→red (inverted vs output — blue minus = complement active)
+     * - `plus`:   high→white (blends with envelope, hiding the +), low→red
+     */
+    private _cellTarget;
+    private _setCellColor;
+    private _ensureClonedMaterial;
+    private _restoreSharedMaterial;
+    private _cleanupMixer;
+    /**
+     * Collect all animated cells (8 outputs + minus + 2 plus parts).
+     * Output cells read bits 0–7; the three indicator cells all read bit 8
+     * (the invert flag) but render it with different color rules.
+     */
+    private _findCellMeshes;
+    /**
+     * Animate all cells over the transition span.
+     * Builds a single AnimationClip with tracks only for cells whose bit changes.
+     */
+    private _animateCells;
+    private _pushCellTracks;
+}

package/dist/scene/shared/components/arithmetic/HalfAdderVisualFactory.d.ts

@@ -0,0 +1,55 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for Half Adder components.
+ *
+ * Creates:
+ * - An `envelope` rectangular frame (EmptyRectangleGeometry)
+ * - A horizontal `separator` box dividing upper/lower chambers
+ * - A `sumFiller` (RectangleWithNailGeometry) in the upper chamber;
+ *   its material is animated blue↔red following the sum output state
+ * - A `halfPlus` small box inside the sumFiller (visual cue)
+ * - A `carryFiller` box in the lower chamber; its material is animated
+ *   blue↔red following the carry output state
+ * - pin groups for vcc, inputA, inputB, sum, carry, gnd
+ *
+ * Animation:
+ * - sumFiller ↔ blue/red based on sum output (current/next state)
+ * - carryFiller ↔ blue/red based on carry output (current/next state)
+ */
+export declare class HalfAdderVisualFactory extends ComponentVisualFactoryBase {
+    private readonly ENVELOPE_GEOM;
+    /** Horizontal separator splitting upper/lower chambers at Z=0 */
+    private readonly SEPARATOR_GEOM;
+    private readonly SEPARATOR_SIDE_GEOM;
+    private readonly SUM_FILLER_GEOM;
+    /** Small box inside sumFiller (visual cue for the XOR "+") */
+    private readonly HALF_PLUS_GEOM;
+    private readonly CARRY_FILLER_GEOM;
+    protected readonly FILLER_COLOR_HIGH: THREE.Color;
+    protected readonly FILLER_COLOR_LOW: THREE.Color;
+    protected readonly FILLER_EMISSIVE_HIGH_INTENSITY = 0.5;
+    protected readonly FILLER_EMISSIVE_LOW_INTENSITY = 0.2;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    protected createPinsVisual(component: Component, context: VisualContext, group: THREE.Group): void;
+    getConfigFormDefinition(config?: Map<string, string>): ConfigFormDefinition | null;
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    updateAnimation(object3D: THREE.Object3D, state: ComponentState | null): void;
+    private _setFillerColor;
+    private _ensureClonedFillerMaterial;
+    private _restoreSharedFillerMaterial;
+    private _cleanupMixer;
+    /**
+     * Animate sumFiller and carryFiller fill colors over the transition span.
+     * Builds a single AnimationClip with up to two target tracks per filler
+     * (color, emissive, emissiveIntensity) — only for fillers whose value changes.
+     */
+    private _animateFillers;
+    private _pushFillerTracks;
+    /** Find a child mesh by its userData.part name */
+    protected findPartMesh(object3D: THREE.Object3D, part: string): THREE.Mesh | null;
+}

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

@@ -0,0 +1,4 @@
+export { AdderVisualFactory } from './AdderVisualFactory';
+export { HalfAdderVisualFactory } from './HalfAdderVisualFactory';
+export { EightBitAdderVisualFactory } from './EightBitAdderVisualFactory';
+export { EightBitOnesComplementVisualFactory } from './EightBitOnesComplementVisualFactory';