simple-circuit-engine 0.0.10 → 0.0.12

package/dist/scene/shared/components/basic/RectangleLEDVisualFactory.d.ts

@@ -0,0 +1,86 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for RectangleLED components
+ *
+ * Creates:
+ * - LED box mesh
+ * - Input pin group
+ * - Output pin group
+ * - Component hitbox for raycasting
+ *
+ * Animation:
+ * - Smooth emissive glow transition when LED lights up or turns off
+ * - Uses AnimationMixer with material property tracks (emissive, emissiveIntensity)
+ * - Clones PRIVATE material per-instance during simulation for independent animation
+ */
+export declare class RectangleLEDVisualFactory extends ComponentVisualFactoryBase {
+    /** LED lit color (yellow glow) */
+    private readonly LED_LIT_COLOR;
+    /** LED lit emissive intensity */
+    private readonly LED_LIT_INTENSITY;
+    /** Black in normalized RGB for ColorKeyframeTrack */
+    private readonly UNLIT_RGB;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    private createPinsVisual;
+    /**
+     * Get config form definition for RectangleLED (T027)
+     *
+     * @returns Form definition with activeColor and idleColor color fields
+     */
+    getConfigFormDefinition(): ConfigFormDefinition | null;
+    /**
+     * Map core config to form data (T027)
+     * Converts hex/preset strings to hex values for color picker
+     *
+     * @param config - Core component config
+     * @returns Form data with hex color strings
+     */
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    /**
+     * Map form data to core config (T027)
+     * Converts hex colors to preset names if they match, otherwise keeps hex
+     *
+     * @param formData - Form data with hex color strings
+     * @returns Core config with hex or preset name strings
+     */
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    /**
+     * Update visual from configuration (T022)
+     * Updates LED color and geometry based on config
+     */
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+    /**
+     * Update LED animation based on simulation state.
+     *
+     * - null state / no context: restore private material, cleanup mixer
+     * - paused/initial: snap to target state
+     * - playing + transitional (goingOn/goingOff): smooth material animation
+     * - playing + stable (on/off): snap to final state
+     */
+    updateAnimation(object3D: THREE.Object3D, state: ComponentState | null): void;
+    /**
+     * Clone the PRIVATE material for independent per-instance animation.
+     * Stashes the original PRIVATE material in mesh.userData.privateMat.
+     * No-op if already cloned.
+     */
+    private _ensureClonedMaterial;
+    /**
+     * Dispose the animation clone and restore the stashed PRIVATE material.
+     * No-op if not cloned.
+     */
+    private _restorePrivateMaterial;
+    private _snapToState;
+    /**
+     * Create a smooth material animation for goingOn / goingOff transitions.
+     */
+    private _animateLed;
+    /**
+     * Stop all animations, clean up mixer.
+     */
+    private _cleanupMixer;
+    private findLedMesh;
+}

package/dist/scene/shared/components/basic/RelayVisualFactory.d.ts

@@ -0,0 +1,92 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for Relay components.
+ *
+ * Animation (3 independent clip groups on a single AnimationMixer):
+ *
+ * 1. **Mechanical clip** — contactor rotation + coil bar position + bar emissive glow
+ *    Triggered on state transition (closing/opening). Duration = transitionSpan.
+ *
+ * 2. **Coil color clip** — all coil rings share one cloned material, single color track
+ *    Triggered on cmd param change. Deduped by target color hex.
+ *
+ * 3. **Power color clip** — contactor + powerInBar share one cloned material, single color track
+ *    Triggered on power param change. Deduped by target color hex.
+ */
+export declare class RelayVisualFactory extends ComponentVisualFactoryBase {
+    private readonly COIL_GEOM;
+    private readonly COIL_BAR_GEOM;
+    private readonly PWIN_BAR_GEOM;
+    private readonly CONTACTOR_GEOM;
+    private readonly NEGATIVE_CONTACTOR_GEOM;
+    private readonly COIL_BAR_Z_IDLE;
+    private readonly COIL_BAR_Z_ACTIVE;
+    private readonly IDLE_ROTATION;
+    private readonly ACTIVE_ROTATION;
+    /** Coil ring colors (from cmd.voltage / cmd.current) */
+    private readonly COIL_COLOR_BOTH;
+    private readonly COIL_COLOR_VOLTAGE;
+    private readonly COIL_COLOR_CURRENT;
+    private readonly COIL_COLOR_NONE;
+    /** Magnetic bar glow */
+    private readonly BAR_GLOW_COLOR;
+    private readonly BAR_GLOW_INTENSITY;
+    /** Power element colors (from power_in / power_out) */
+    private readonly POWER_COLOR_BOTH;
+    private readonly POWER_COLOR_VOLTAGE;
+    private readonly POWER_COLOR_CURRENT;
+    private readonly POWER_COLOR_NONE;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    private _createPinsVisual;
+    private _createCoilGroup;
+    private _createContactorGroup;
+    private _disposeContactorGroup;
+    getConfigFormDefinition(): ConfigFormDefinition | null;
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+    /**
+     * Update relay animation based on simulation state.
+     *
+     * - null / no context → cleanup, restore materials, reset to idle
+     * - paused → snap all parts to current state values
+     * - playing + transitional → animate mechanical + bar effect; update color clips
+     * - playing + stable → snap mechanical + bar; update color clips
+     */
+    updateAnimation(object3D: THREE.Object3D, state: ComponentState | null): void;
+    /** Is the coil magnetically active in the given state? */
+    private _isCmdActive;
+    /** Is the transition moving TOWARD the active position? */
+    private _isGoingActive;
+    private _computeCoilColor;
+    private _computePowerColor;
+    private _getColorAnimDurationSecs;
+    private _snapMechanical;
+    private _snapCoilColor;
+    private _snapBarEffect;
+    private _snapPowerColor;
+    /** Clone WHITE once and assign the same clone to all 7 coil rings. */
+    private _ensureCoilClonedMaterial;
+    /** Clone SHINY_SILVER for the coil bar (emissive animation). */
+    private _ensureBarClonedMaterial;
+    /** Clone WHITE once and assign to both contactor and powerInBar. */
+    private _ensurePowerClonedMaterial;
+    /** Restore all animated materials to their SHARED originals. */
+    private _restoreAllMaterials;
+    private _animateMechanical;
+    private _updateCoilColorAnim;
+    private _updatePowerColorAnim;
+    /** Stop only the mechanical clip (rotation + bar position + bar glow). */
+    private _cleanupMechanicalClip;
+    /** Stop all animations, dispose mixer, clear all animation userData. */
+    private _cleanupMixer;
+    /** Reset positions/rotations to idle (no coil energized). */
+    private _resetToDefault;
+    /** Find all animated sub-objects in a single traverse. */
+    private _findParts;
+    private _findContactorGroup;
+}

package/dist/scene/shared/components/basic/SmallLEDVisualFactory.d.ts

@@ -0,0 +1,86 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for SmallLED components
+ *
+ * Creates:
+ * - LED cylinder mesh
+ * - Input pin group
+ * - Output pin group
+ * - Component hitbox for raycasting
+ *
+ * Animation:
+ * - Smooth emissive glow transition when LED lights up or turns off
+ * - Uses AnimationMixer with material property tracks (emissive, emissiveIntensity)
+ * - Clones PRIVATE material per-instance during simulation for independent animation
+ */
+export declare class SmallLEDVisualFactory extends ComponentVisualFactoryBase {
+    /** LED lit color (yellow glow) */
+    private readonly LED_LIT_COLOR;
+    /** LED lit emissive intensity */
+    private readonly LED_LIT_INTENSITY;
+    /** Black in normalized RGB for ColorKeyframeTrack */
+    private readonly UNLIT_RGB;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    private createPinsVisual;
+    /**
+     * Get config form definition for SmallLED (T027)
+     *
+     * @returns Form definition with activeColor and idleColor color fields
+     */
+    getConfigFormDefinition(): ConfigFormDefinition | null;
+    /**
+     * Map core config to form data (T027)
+     * Converts hex/preset strings to hex values for color picker
+     *
+     * @param config - Core component config
+     * @returns Form data with hex color strings
+     */
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    /**
+     * Map form data to core config (T027)
+     * Converts hex colors to preset names if they match, otherwise keeps hex
+     *
+     * @param formData - Form data with hex color strings
+     * @returns Core config with hex or preset name strings
+     */
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    /**
+     * Update visual from configuration (T022)
+     * Updates LED color based on activeColor config
+     */
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+    /**
+     * Update LED animation based on simulation state.
+     *
+     * - null state / no context: restore private material, cleanup mixer
+     * - paused/initial: snap to target state
+     * - playing + transitional (goingOn/goingOff): smooth material animation
+     * - playing + stable (on/off): snap to final state
+     */
+    updateAnimation(object3D: THREE.Object3D, state: ComponentState | null): void;
+    /**
+     * Clone the PRIVATE material for independent per-instance animation.
+     * Stashes the original PRIVATE material in mesh.userData.privateMat.
+     * No-op if already cloned.
+     */
+    private _ensureClonedMaterial;
+    /**
+     * Dispose the animation clone and restore the stashed PRIVATE material.
+     * No-op if not cloned.
+     */
+    private _restorePrivateMaterial;
+    private _snapToState;
+    /**
+     * Create a smooth material animation for goingOn / goingOff transitions.
+     */
+    private _animateLed;
+    /**
+     * Stop all animations, clean up mixer.
+     */
+    private _cleanupMixer;
+    private findLedMesh;
+}

package/dist/scene/shared/components/basic/SwitchVisualFactory.d.ts

@@ -0,0 +1,85 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for Switch components
+ *
+ * Creates:
+ * - Contactor (box, rotatable for animation)
+ * - Input pin group
+ * - Output pin group
+ * - Component hitbox for raycasting
+ *
+ * Animation:
+ * - Smooth rotation of contactor between open/closed via AnimationMixer
+ * - Supports mid-transition interruption (re-toggle during closing/opening)
+ */
+export declare class SwitchVisualFactory extends ComponentVisualFactoryBase {
+    /** Rotation for closed switch (contactor aligned) */
+    private readonly CLOSED_ROTATION;
+    /** Rotation for open switch (contactor misaligned) */
+    private readonly OPEN_ROTATION;
+    private readonly CONTACTOR_GEOMETRY;
+    /** Contactor color when output has both voltage and current */
+    private readonly COLOR_VOLTAGE_CURRENT;
+    /** Contactor color when output has current only */
+    private readonly COLOR_CURRENT;
+    /** Contactor color when output has voltage only */
+    private readonly COLOR_VOLTAGE;
+    /** Contactor color when output has neither */
+    private readonly COLOR_NONE;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    private createPinsVisual;
+    /**
+     * Get config form definition for Switch
+     *
+     * @returns Form definition with initialState, transitionSpan and size
+     */
+    getConfigFormDefinition(): ConfigFormDefinition | null;
+    /**
+     * Map core config to form data
+     * Converts "open"/"closed" strings to boolean
+     */
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    /**
+     * Map form data to core config
+     * Converts boolean to "open"/"closed" strings
+     */
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+    /**
+     * Update switch animation based on simulation state.
+     *
+     * - null state / no context: cleanup mixer, reset to config default
+     * - paused/initial + transitional: snap to start rotation
+     * - paused/initial + stable: snap to state rotation
+     * - playing + transitional: smooth rotation animation
+     * - playing + stable: snap to final rotation, cleanup mixer
+     */
+    updateAnimation(object3D: THREE.Object3D, state: ComponentState | null): void;
+    /** Maps stable state → target rotation */
+    private _getStateRotation;
+    /** Maps transitional state → the rotation it came FROM */
+    private _getStartRotation;
+    /**
+     * Create smooth rotation + color animations for closing/opening transitions.
+     * Rotation clip: current → target state rotation (persists across updateAnimation calls)
+     * Color clip: current contactor color → white (stopped on next updateAnimation so pin state takes over)
+     */
+    private _animateContactor;
+    /**
+     * Stop the color fade animation so _updateContactorColor can set color from pin state.
+     */
+    private _stopColorAnimation;
+    /**
+     * Stop all animations, clean up mixer, reset to config default rotation.
+     */
+    private _cleanupMixer;
+    private _ensureClonedMaterial;
+    private _restoreSharedMaterial;
+    private _updateContactorColor;
+    private findContactorGroup;
+    private _findContactorMesh;
+}

package/dist/scene/shared/components/gates/InverterVisualFactory.d.ts

@@ -0,0 +1,104 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for Inverter/Buffer components
+ *
+ * Creates:
+ * - Inverter triangle or Buffer trapezoid extrude geom mesh
+ * - Vcc, input and output pin group
+ * - Component hitbox for raycasting
+ *
+ * Animation:
+ * - Emissive glow when component is high (based on simulation state)
+ */
+export declare class InverterVisualFactory extends ComponentVisualFactoryBase {
+    /** Shared Inverter envelope geometry */
+    private readonly INVERTER_GEOM;
+    /** Shared Inverter inner hole geometry */
+    private readonly INVERTER_HOLE_GEOM;
+    /** Shared Buffer envelope geometry */
+    private readonly BUFFER_GEOM;
+    /** Shared Buffer inner hole geometry */
+    private readonly BUFFER_HOLE_GEOM;
+    private readonly HOLE_COLOR_HIGH;
+    private readonly HOLE_COLOR_LOW;
+    private readonly HOLE_EMISSIVE_HIGH_INTENSITY;
+    private readonly HOLE_EMISSIVE_LOW_INTENSITY;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    private createPinsVisual;
+    private replaceEnvelope;
+    private replaceHole;
+    /**
+     * Get config form definition for Inverter
+     *
+     * @param config - Optional current config to determine disabled state of transitionSpan
+     * @returns Form definition with defaultLogicFamily dropdown, activationLogic boolean, and transitionSpan number
+     */
+    getConfigFormDefinition(config?: Map<string, string>): ConfigFormDefinition | null;
+    /**
+     * Map core config to form data
+     * Converts "positive"/"negative" strings to boolean
+     *
+     * @param config - Core component config
+     * @returns Form data with boolean activationLogic
+     */
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    /**
+     * Map form data to core config
+     * Converts boolean to "positive"/"negative" strings
+     *
+     * @param formData - Form data with boolean activationLogic
+     * @returns Core config with string activationLogic
+     */
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+    /**
+     * Update Inverter animation based on simulation state
+     *
+     * @param object3D - The Object3D created by createVisual()
+     * @param state - The Inverter's current simulation state
+     */
+    updateAnimation(object3D: THREE.Object3D, state: ComponentState | null): void;
+    private _setHoleColor;
+    private _ensureClonedHoleMaterial;
+    private _restoreSharedHoleMaterial;
+    private _cleanupMixer;
+    /**
+     * Animate the hole color between LOW and HIGH over the transition span.
+     * Reads current color for mid-transition support.
+     */
+    private _animateHoleColor;
+    /**
+     * Find the envelope mesh within the component group
+     *
+     * @param object3D - The Object3D group created by createVisual()
+     * @returns The envelope mesh if found, null otherwise
+     *
+     * @remarks
+     * Searches for a mesh with userData.part === 'envelope'
+     */
+    private findEnvelopeMesh;
+    /**
+     * Find the hole mesh within the component group
+     *
+     * @param object3D - The Object3D group created by createVisual()
+     * @returns The hole mesh if found, null otherwise
+     *
+     * @remarks
+     * Searches for a mesh with userData.part === 'hole'
+     */
+    private findHoleMesh;
+    /**
+     * Find the negative marker mesh within the component group
+     *
+     * @param object3D - The Object3D group created by createVisual()
+     * @returns The negative marker mesh if found, null otherwise
+     *
+     * @remarks
+     * Searches for a mesh with userData.part === 'negativeMarker'
+     */
+    protected findNegativeMarkerMesh(object3D: THREE.Object3D): THREE.Mesh | null;
+}

package/dist/scene/shared/components/gates/Nand4GateVisualFactory.d.ts

@@ -0,0 +1,27 @@
+import { Component } from '../../../../core/index.ts';
+import { NandGateVisualFactory } from './NandGateVisualFactory';
+import { VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for NAND gates components
+ *
+ * Creates:
+ * - Gate mesh
+ * - vcc, gnd, inputs and output pin groups
+ * - Component hitbox for raycasting
+ *
+ * Animation:
+ * - Emissive glow when Gate is high (based on simulation state)
+ */
+export declare class Nand4GateVisualFactory extends NandGateVisualFactory {
+    /** Shared open envelope geometry */
+    protected readonly ENVELOPE_GEOM: THREE.ExtrudeGeometry;
+    /** Shared inner hole geometry */
+    protected readonly HOLE_GEOM: THREE.ExtrudeGeometry;
+    /** Shared geometry for negative marker **/
+    protected readonly NEG_MARKER_GEOM: THREE.CylinderGeometry;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    protected createPinsVisual(component: Component, context: VisualContext, group: THREE.Group): void;
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+}

package/dist/scene/shared/components/gates/Nand8GateVisualFactory.d.ts

@@ -0,0 +1,27 @@
+import { Component } from '../../../../core/index.ts';
+import { NandGateVisualFactory } from './NandGateVisualFactory';
+import { VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for NAND gates components
+ *
+ * Creates:
+ * - Gate mesh
+ * - vcc, gnd, inputs and output pin groups
+ * - Component hitbox for raycasting
+ *
+ * Animation:
+ * - Emissive glow when Gate is high (based on simulation state)
+ */
+export declare class Nand8GateVisualFactory extends NandGateVisualFactory {
+    /** Shared open envelope geometry */
+    protected readonly ENVELOPE_GEOM: THREE.ExtrudeGeometry;
+    /** Shared inner hole geometry */
+    protected readonly HOLE_GEOM: THREE.ExtrudeGeometry;
+    /** Shared geometry for negative marker **/
+    protected readonly NEG_MARKER_GEOM: THREE.CylinderGeometry;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    protected createPinsVisual(component: Component, context: VisualContext, group: THREE.Group): void;
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+}

package/dist/scene/shared/components/gates/NandGateVisualFactory.d.ts

@@ -0,0 +1,101 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for NAND gates components
+ *
+ * Creates:
+ * - Gate mesh
+ * - vcc, gnd, inputs and output pin groups
+ * - Component hitbox for raycasting
+ *
+ * Animation:
+ * - Emissive glow when Gate is high (based on simulation state)
+ */
+export declare class NandGateVisualFactory extends ComponentVisualFactoryBase {
+    /** Shared envelope geometry */
+    protected readonly ENVELOPE_GEOM: THREE.ExtrudeGeometry;
+    /** Shared inner hole geometry */
+    protected readonly HOLE_GEOM: THREE.ExtrudeGeometry;
+    /** Shared geometry for negative marker **/
+    protected readonly NEG_MARKER_GEOM: THREE.CylinderGeometry;
+    protected readonly HOLE_COLOR_HIGH: THREE.Color;
+    protected readonly HOLE_COLOR_LOW: THREE.Color;
+    protected readonly HOLE_EMISSIVE_HIGH_INTENSITY = 0.5;
+    protected readonly HOLE_EMISSIVE_LOW_INTENSITY = 0.2;
+    constructor();
+    defaultRotation(): number;
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    protected createPinsVisual(component: Component, context: VisualContext, group: THREE.Group): void;
+    /**
+     * Get config form definition
+     *
+     * @param config - Optional current config to determine disabled state of transitionSpan
+     * @returns Form definition with defaultLogicFamily dropdown, activationLogic boolean, and transitionSpan number
+     */
+    getConfigFormDefinition(config?: Map<string, string>): ConfigFormDefinition | null;
+    /**
+     * Map core config to form data
+     * Converts "positive"/"negative" strings to boolean
+     *
+     * @param config - Core component config
+     * @returns Form data with boolean activationLogic
+     */
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    /**
+     * Map form data to core config
+     * Converts boolean to "positive"/"negative" strings
+     *
+     * @param formData - Form data with boolean activationLogic
+     * @returns Core config with string activationLogic
+     */
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+    /**
+     * Update animation based on simulation state
+     *
+     * @param object3D - The Object3D created by createVisual()
+     * @param state - The component current simulation state
+     */
+    updateAnimation(object3D: THREE.Object3D, state: ComponentState | null): void;
+    private _setHoleColor;
+    private _ensureClonedHoleMaterial;
+    private _restoreSharedHoleMaterial;
+    private _cleanupMixer;
+    /**
+     * Animate the hole color between LOW and HIGH over the transition span.
+     * Reads current color for mid-transition support.
+     */
+    private _animateHoleColor;
+    /**
+     * Find the envelope mesh within the component group
+     *
+     * @param object3D - The Object3D group created by createVisual()
+     * @returns The envelope mesh if found, null otherwise
+     *
+     * @remarks
+     * Searches for a mesh with userData.part === 'envelope'
+     */
+    protected findEnvelopeMesh(object3D: THREE.Object3D): THREE.Mesh | null;
+    /**
+     * Find the hole mesh within the component group
+     *
+     * @param object3D - The Object3D group created by createVisual()
+     * @returns The hole mesh if found, null otherwise
+     *
+     * @remarks
+     * Searches for a mesh with userData.part === 'hole'
+     */
+    protected findHoleMesh(object3D: THREE.Object3D): THREE.Mesh | null;
+    /**
+     * Find the negative marker mesh within the component group
+     *
+     * @param object3D - The Object3D group created by createVisual()
+     * @returns The negative marker mesh if found, null otherwise
+     *
+     * @remarks
+     * Searches for a mesh with userData.part === 'negativeMarker'
+     */
+    protected findNegativeMarkerMesh(object3D: THREE.Object3D): THREE.Mesh | null;
+}

package/dist/scene/shared/components/gates/Nor4GateVisualFactory.d.ts

@@ -0,0 +1,27 @@
+import { Component } from '../../../../core/index.ts';
+import { NorGateVisualFactory } from './NorGateVisualFactory';
+import { VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for NOR gates components
+ *
+ * Creates:
+ * - Gate mesh
+ * - vcc, gnd, inputs and output pin groups
+ * - Component hitbox for raycasting
+ *
+ * Animation:
+ * - Emissive glow when Gate is high (based on simulation state)
+ */
+export declare class Nor4GateVisualFactory extends NorGateVisualFactory {
+    /** Shared open envelope geometry */
+    protected readonly ENVELOPE_GEOM: THREE.ExtrudeGeometry;
+    /** Shared inner hole geometry */
+    protected readonly HOLE_GEOM: THREE.ExtrudeGeometry;
+    /** Shared geometry for negative marker **/
+    protected readonly NEG_MARKER_GEOM: THREE.CylinderGeometry;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    protected createPinsVisual(component: Component, context: VisualContext, group: THREE.Group): void;
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+}

package/dist/scene/shared/components/gates/Nor8GateVisualFactory.d.ts

@@ -0,0 +1,27 @@
+import { Component } from '../../../../core/index.ts';
+import { NorGateVisualFactory } from './NorGateVisualFactory';
+import { VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for NOR gates components
+ *
+ * Creates:
+ * - Gate mesh
+ * - vcc, gnd, inputs and output pin groups
+ * - Component hitbox for raycasting
+ *
+ * Animation:
+ * - Emissive glow when Gate is high (based on simulation state)
+ */
+export declare class Nor8GateVisualFactory extends NorGateVisualFactory {
+    /** Shared open envelope geometry */
+    protected readonly ENVELOPE_GEOM: THREE.ExtrudeGeometry;
+    /** Shared inner hole geometry */
+    protected readonly HOLE_GEOM: THREE.ExtrudeGeometry;
+    /** Shared geometry for negative marker **/
+    protected readonly NEG_MARKER_GEOM: THREE.CylinderGeometry;
+    constructor();
+    createVisual(component: Component, context: VisualContext): THREE.Object3D;
+    protected createPinsVisual(component: Component, context: VisualContext, group: THREE.Group): void;
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+}