simple-circuit-engine 0.0.11 → 0.0.12

package/dist/scene/shared/components/gates/NorGateVisualFactory.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 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 NorGateVisualFactory 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/Xor4GateVisualFactory.d.ts

@@ -0,0 +1,29 @@
+import { Component } from '../../../../core/index.ts';
+import { XorGateVisualFactory } from './XorGateVisualFactory';
+import { VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for XOR 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 Xor4GateVisualFactory extends XorGateVisualFactory {
+    /** XOR tail geometry */
+    protected readonly TAIL_GEOM: THREE.ExtrudeGeometry;
+    /** 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/Xor8GateVisualFactory.d.ts

@@ -0,0 +1,29 @@
+import { Component } from '../../../../core/index.ts';
+import { XorGateVisualFactory } from './XorGateVisualFactory';
+import { VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for XOR 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 Xor8GateVisualFactory extends XorGateVisualFactory {
+    /** XOR tail geometry */
+    protected readonly TAIL_GEOM: THREE.ExtrudeGeometry;
+    /** 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/XorGateVisualFactory.d.ts

@@ -0,0 +1,103 @@
+import { ComponentVisualFactoryBase } from '../ComponentVisualFactory';
+import { Component, ComponentState } from '../../../../core/index.ts';
+import { ConfigFormDefinition, VisualContext } from '../../types';
+import * as THREE from 'three';
+/**
+ * Visual factory for XOR 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 XorGateVisualFactory extends ComponentVisualFactoryBase {
+    /** XOR tail geometry */
+    protected readonly TAIL_GEOM: THREE.ExtrudeGeometry;
+    /** 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;
+    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 for XOR/XNOR Gate
+     *
+     * @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/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Component visual factories
+ * @module scene/shared/components
+ */
+export type { IFactoryRegistry, IComponentVisualFactory } from './ComponentVisualFactory.js';
+export { CmpMatCategory, CmpMatVariant, CmpMatType, CMP_MATERIALS } from './types.js';
+export { FactoryRegistry } from './FactoryRegistry.js';
+export { DefaultVisualFactory } from './DefaultVisualFactory.js';
+export type { ComponentGroup, IComponentGroupBuilder, IGroupedFactoryRegistry, } from './GroupedFactoryRegistry.js';
+export { GroupedFactoryRegistry } from './GroupedFactoryRegistry.js';
+export { BatteryVisualFactory } from './basic/BatteryVisualFactory';
+export { LabelVisualFactory } from './basic/LabelVisualFactory';
+export { LightbulbVisualFactory } from './basic/LightbulbVisualFactory';
+export { RectangleLEDVisualFactory } from './basic/RectangleLEDVisualFactory';
+export { RelayVisualFactory } from './basic/RelayVisualFactory';
+export { SmallLEDVisualFactory } from './basic/SmallLEDVisualFactory';
+export { SwitchVisualFactory } from './basic/SwitchVisualFactory';
+export { DoubleThrowSwitchVisualFactory } from './basic/DoubleThrowSwitchVisualFactory';
+export { ClockVisualFactory } from './basic/ClockVisualFactory';
+export { InverterVisualFactory } from './gates/InverterVisualFactory';
+export { NandGateVisualFactory } from './gates/NandGateVisualFactory';
+export { Nand4GateVisualFactory } from './gates/Nand4GateVisualFactory';
+export { Nand8GateVisualFactory } from './gates/Nand8GateVisualFactory';
+export { NorGateVisualFactory } from './gates/NorGateVisualFactory';
+export { Nor4GateVisualFactory } from './gates/Nor4GateVisualFactory';
+export { Nor8GateVisualFactory } from './gates/Nor8GateVisualFactory';
+export { XorGateVisualFactory } from './gates/XorGateVisualFactory';
+export { Xor4GateVisualFactory } from './gates/Xor4GateVisualFactory';
+export { Xor8GateVisualFactory } from './gates/Xor8GateVisualFactory';

package/dist/scene/shared/components/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Component Material Types
+ * @module scene/shared/components/types
+ *
+ * Enums and shared material dictionary for the component visual factory system.
+ * Materials are singleton instances shared across all factory instances.
+ */
+import * as THREE from 'three';
+/** Material category — identifies a family of related shared materials */
+export declare const enum CmpMatCategory {
+    WHITE = "WHITE",
+    SHINY_SILVER = "SHINY_SILVER",
+    GLASS = "GLASS",
+    DARK_GRAY = "DARK_GRAY"
+}
+/** Material variant — visual state within a category */
+export declare const enum CmpMatVariant {
+    NORMAL = "NORMAL",
+    HOVERED = "HOVERED",
+    SELECTED = "SELECTED"
+}
+/**
+ * Material ownership type — stored on `material.userData.matType`.
+ * Numeric for fast comparison; determines how hover/select/animation interact.
+ *
+ * - **SHARED** — from CMP_MATERIALS dict; hover/select may swap to a variant
+ * - **FACTORY** — per-visual factory material; skip hover/select swap
+ * - **PRIVATE** — per-instance material (e.g. LED configurable color); skip hover/select swap
+ * - **ANIMATION_CLONE** — cloned from SHARED for animation; skip hover/select swap
+ */
+export declare const enum CmpMatType {
+    SHARED = 0,
+    FACTORY = 1,
+    PRIVATE = 2,
+    ANIMATION_CLONE = 3
+}
+/**
+ * Shared material dictionary: CmpMatCategory → CmpMatVariant → MeshLambertMaterial.
+ *
+ * Every material carries `userData.matType` and `userData.matCat` (its category)
+ * (`CmpMatType.SHARED`) so hover/select logic can identify and swap them.
+ */
+export declare const CMP_MATERIALS: Readonly<Record<CmpMatCategory, Record<CmpMatVariant, THREE.MeshLambertMaterial>>>;