simple-circuit-engine 0.0.11 → 0.0.13

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

@@ -0,0 +1,148 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for Label components
+ *
+ * Creates:
+ * - Text mesh using CanvasTexture for stencil/technical font styling
+ * - Component hitbox for raycasting
+ * - No pin groups (Label has zero pins)
+ *
+ * Configuration:
+ * - text: Display text content (max 64 characters, default "Label")
+ * - size: Scale multiplier (1-10, default 1)
+ *
+ * @example
+ * ```typescript
+ * const factory = new LabelVisualFactory();
+ * const visual = factory.createVisual(labelComponent);
+ * scene.add(visual);
+ *
+ * // Update text
+ * const newConfig = new Map([['text', 'Power Supply'], ['size', '2']]);
+ * factory.updateFromConfiguration(visual, newConfig);
+ * ```
+ */
+export declare class LabelVisualFactory extends ComponentVisualFactoryBase {
+    /** Maximum text length in characters */
+    private static readonly MAX_TEXT_LENGTH;
+    /** Font family for technical/stencil aesthetic */
+    private static readonly FONT_FAMILY;
+    /** Text color (dark gray for readability) */
+    private static readonly TEXT_COLOR;
+    /** Hover text color (blue tint matching other components) */
+    private static readonly HOVER_COLOR;
+    /** Selection text color (orange tint matching other components) */
+    private static readonly SELECTION_COLOR;
+    /** Base font size in pixels */
+    private static readonly BASE_FONT_SIZE;
+    /** Padding around text in pixels */
+    private static readonly PADDING;
+    constructor();
+    createVisual(component: Component, _context: VisualContext): THREE.Object3D;
+    /**
+     * Create a canvas with rendered text
+     *
+     * @param text - Text to render (truncated to MAX_TEXT_LENGTH)
+     * @returns HTMLCanvasElement with rendered text
+     */
+    private createTextCanvas;
+    /**
+     * Create a text mesh using CanvasTexture
+     *
+     * @param text - Text to display
+     * @returns THREE.Mesh with text texture
+     */
+    private createTextMesh;
+    /**
+     * Find the text mesh within the component group
+     *
+     * @param object3D - The component group
+     * @returns The text mesh or null if not found
+     */
+    private findTextMesh;
+    /**
+     * Normalize display text by truncating and providing default
+     * @param text
+     * @private
+     */
+    private normalizeDisplayText;
+    /**
+     * Update the text mesh with new text content
+     *
+     * Resizes canvas and geometry to fit the new text, then redraws.
+     *
+     * @param mesh - The text mesh to update
+     * @param text - New text content
+     * @param group - The parent group containing the hitbox to update
+     */
+    private updateTextMesh;
+    /**
+     * Update visual based on Label configuration
+     *
+     * @param object3D - The component group
+     * @param config - Configuration map with text and size
+     */
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+    /**
+     * Get config form definition for Label component
+     *
+     * @returns Form definition with text and size fields
+     */
+    getConfigFormDefinition(): ConfigFormDefinition;
+    /**
+     * Map core config to form data
+     *
+     * @param config - Core config from Component.config
+     * @returns Form data with appropriate types
+     */
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    /**
+     * Map form data back to core config
+     *
+     * @param formData - Form data from UI
+     * @returns Core config with string values
+     */
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    /**
+     * Apply hover visual effect to the Label
+     *
+     * Changes text color to hover color (blue) by redrawing the canvas.
+     *
+     * @param object3D - The component group
+     */
+    applyHover(object3D: THREE.Object3D): void;
+    /**
+     * Remove hover visual effect from the Label
+     *
+     * Restores text color to default by redrawing the canvas.
+     *
+     * @param object3D - The component group
+     */
+    removeHover(object3D: THREE.Object3D): void;
+    /**
+     * Apply selection visual effect to the Label
+     *
+     * Changes text color to selection color (orange) by redrawing the canvas.
+     *
+     * @param object3D - The component group
+     */
+    applySelection(object3D: THREE.Object3D): void;
+    /**
+     * Remove selection visual effect from the Label
+     *
+     * Restores text color based on hover state.
+     *
+     * @param object3D - The component group
+     */
+    removeSelection(object3D: THREE.Object3D): void;
+    /**
+     * Redraw the text canvas with a specific color
+     *
+     * @param object3D - The component group
+     * @param color - The CSS color string to use
+     */
+    private redrawTextWithColor;
+}

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

@@ -0,0 +1,72 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for Lightbulb components
+ * Animation:
+ * - Smooth emissive glow transition when Lightbulb lights up or turns off
+ * - Uses AnimationMixer with material property tracks (emissive, opacity)
+ * - Clones shared GLASS material per-instance during simulation for independent animation
+ */
+export declare class LightbulbVisualFactory extends ComponentVisualFactoryBase {
+    /** Lightbulb lit color (yellow glow) */
+    private readonly BULB_LIT_COLOR;
+    /** Lightbulb lit emissive intensity */
+    private readonly BULB_LIT_INTENSITY;
+    /** Lightbulb unlit opacity */
+    private readonly BULB_UNLIT_OPACITY;
+    private readonly BASE_GEOMETRY;
+    private readonly BULB_GEOMETRY;
+    /** Yellow in normalized RGB for ColorKeyframeTrack */
+    private readonly LIT_RGB;
+    /** 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 Lightbulb
+     *
+     * @returns Form definition with size
+     */
+    getConfigFormDefinition(): ConfigFormDefinition | null;
+    mapCoreConfigToForm(config: Map<string, string>): Map<string, any>;
+    /**
+     * Map form data to core config
+     *
+     * @param formData - Form data with size
+     * @returns Core config with string size
+     */
+    mapFormToCoreConfig(formData: Map<string, any>): Map<string, string>;
+    updateFromConfiguration(object3D: THREE.Object3D, config: Map<string, string>): void;
+    /**
+     * Update Lightbulb animation based on simulation state.
+     *
+     * - null state / no context: restore shared 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 shared GLASS material for independent per-instance animation.
+     * No-op if already cloned.
+     */
+    private _ensureClonedMaterial;
+    /**
+     * Dispose the per-instance clone and restore the shared GLASS.NORMAL material.
+     * No-op if not cloned.
+     */
+    private _restoreSharedMaterial;
+    private _snapToState;
+    /**
+     * Create a smooth material animation for goingOn / goingOff transitions.
+     */
+    private _animateBulb;
+    /**
+     * Stop all animations, clean up mixer.
+     */
+    private _cleanupMixer;
+    private findBulbMesh;
+}

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;
+}