@simten/ui 0.1.1

package/dist/editor/lib/utils/circuit-flattener.js

@@ -0,0 +1,230 @@
+/**
+ * Circuit Flattener (IR v0.1)
+ *
+ * Expands composite components into a flat Circuit containing only primitives.
+ * This allows the simulator to work with nested components by flattening the
+ * hierarchy into a single level, avoiding recursive evaluation overhead.
+ *
+ * Key features:
+ * - State isolation: Each instance gets unique IDs (componentId__nodeId)
+ * - Preserves all port connections through hierarchy
+ * - Recursively expands nested composites
+ * - Compatible with IR v0.1 Circuit/Node format
+ */
+import { useCircuitLibraryStore } from '../../stores/circuit-library-store';
+import { nanoid } from 'nanoid';
+/**
+ * Port mapping key format: "nodeId.portName"
+ */
+function portMapKey(nodeId, portName) {
+    return `${nodeId}.${portName}`;
+}
+/**
+ * Flatten a circuit by recursively expanding all composite components into primitives
+ */
+export function flattenCircuit(circuit) {
+    const library = useCircuitLibraryStore.getState();
+    const flatNodes = [];
+    const flatConnections = [];
+    const nodeMapping = new Map();
+    // Port mapping: tracks how ports of composite nodes map to internal primitive ports
+    // Format: "nodeId.portName" -> ["expandedNodeId1.portName", "expandedNodeId2.portName", ...]
+    // Supports fan-out (one port connecting to multiple internal ports)
+    const portMapping = new Map();
+    // Known primitive component types (don't need to be expanded)
+    const knownPrimitives = new Set([
+        'And', 'Or', 'Not', 'Nand', 'Nor', 'Xor', 'Xnor', 'Buffer',
+        'Switch', 'Button', 'Input', 'Led', 'HexDisplay', 'SevenSegment',
+        'DFlipFlop', 'Register', 'RAM'
+    ]);
+    // Recursively expand each node
+    for (const node of circuit.nodes) {
+        // Check if it's a known primitive (don't need library lookup)
+        if (knownPrimitives.has(node.componentRef)) {
+            flatNodes.push(node);
+            nodeMapping.set(node.id, [node.id]);
+            continue;
+        }
+        // Try to resolve from library for user-defined components
+        const componentDef = library.resolveCircuit(node.componentRef);
+        if (!componentDef) {
+            // Unknown component - treat as primitive (fail gracefully)
+            console.warn(`[FLATTEN] Component not found: ${node.componentRef}, treating as primitive`);
+            flatNodes.push(node);
+            nodeMapping.set(node.id, [node.id]);
+            continue;
+        }
+        // If primitive, keep as-is
+        if (componentDef.implementation.kind === 'primitive') {
+            flatNodes.push(node);
+            nodeMapping.set(node.id, [node.id]);
+            continue;
+        }
+        // If composite, expand it
+        if (componentDef.implementation.kind === 'composite') {
+            const expansionResult = expandCompositeNode(node, componentDef, library.resolveCircuit.bind(library), knownPrimitives);
+            flatNodes.push(...expansionResult.nodes);
+            nodeMapping.set(node.id, expansionResult.nodes.map(n => n.id));
+            // Merge port mappings
+            for (const [key, values] of expansionResult.portMapping.entries()) {
+                const existing = portMapping.get(key) || [];
+                portMapping.set(key, [...existing, ...values]);
+            }
+            // Add internal connections
+            flatConnections.push(...expansionResult.connections);
+        }
+    }
+    // Remap external connections to go through expanded internal nodes
+    for (const conn of circuit.connections) {
+        const remappedConns = remapConnection(conn, portMapping);
+        flatConnections.push(...remappedConns);
+    }
+    return {
+        ...circuit,
+        nodes: flatNodes,
+        connections: flatConnections,
+        nodeMapping,
+    };
+}
+function expandCompositeNode(node, componentDef, resolveCircuit, knownPrimitives, visited = new Set()) {
+    const nodes = [];
+    const connections = [];
+    const portMapping = new Map();
+    // Create internal nodes with prefixed IDs
+    for (const internalNode of componentDef.nodes) {
+        const expandedId = `${node.id}__${internalNode.id}`;
+        // Check if it's a known primitive
+        if (knownPrimitives.has(internalNode.componentRef)) {
+            // Primitive node - create expanded version
+            const expandedNode = {
+                ...internalNode,
+                id: expandedId,
+                inputs: internalNode.inputs.map(inp => ({
+                    ...inp,
+                    id: `${expandedId}.${inp.name}`,
+                })),
+                outputs: internalNode.outputs.map(out => ({
+                    ...out,
+                    id: `${expandedId}.${out.name}`,
+                })),
+            };
+            nodes.push(expandedNode);
+            continue;
+        }
+        // Check if internal node is also composite - recursively expand
+        const internalComponentDef = resolveCircuit(internalNode.componentRef);
+        if (internalComponentDef?.implementation.kind === 'composite') {
+            // Guard against recursive circuit definitions
+            if (visited.has(internalNode.componentRef)) {
+                console.warn(`[FLATTEN] Recursive circuit reference: ${internalNode.componentRef}, skipping`);
+                continue;
+            }
+            const childVisited = new Set(visited);
+            childVisited.add(internalNode.componentRef);
+            // Recursively expand nested composite
+            const nestedExpansion = expandCompositeNode({ ...internalNode, id: expandedId }, internalComponentDef, resolveCircuit, knownPrimitives, childVisited);
+            nodes.push(...nestedExpansion.nodes);
+            connections.push(...nestedExpansion.connections);
+            // Remap nested port mappings through our prefix
+            for (const [key, values] of nestedExpansion.portMapping.entries()) {
+                const [keyNodeId, keyPortName] = key.split('.');
+                const remappedKey = portMapKey(keyNodeId, keyPortName);
+                const existing = portMapping.get(remappedKey) || [];
+                portMapping.set(remappedKey, [...existing, ...values]);
+            }
+        }
+        else {
+            // Unknown or primitive node - create expanded version
+            const expandedNode = {
+                ...internalNode,
+                id: expandedId,
+                inputs: internalNode.inputs.map(inp => ({
+                    ...inp,
+                    id: `${expandedId}.${inp.name}`,
+                })),
+                outputs: internalNode.outputs.map(out => ({
+                    ...out,
+                    id: `${expandedId}.${out.name}`,
+                })),
+            };
+            nodes.push(expandedNode);
+        }
+    }
+    // Process internal connections and build port mappings
+    for (const conn of componentDef.connections) {
+        const sourceNodeId = conn.source.nodeId === '' ? node.id : `${node.id}__${conn.source.nodeId}`;
+        const targetNodeId = conn.target.nodeId === '' ? node.id : `${node.id}__${conn.target.nodeId}`;
+        // If source is circuit-level input (empty nodeId), create port mapping
+        if (conn.source.nodeId === '') {
+            // Map: original node's input port -> internal node's input port
+            const originalInputKey = portMapKey(node.id, conn.source.portName);
+            const internalTargetPath = {
+                nodeId: targetNodeId,
+                portName: conn.target.portName,
+            };
+            const existing = portMapping.get(originalInputKey) || [];
+            portMapping.set(originalInputKey, [...existing, internalTargetPath]);
+        }
+        // If target is circuit-level output (empty nodeId), create port mapping
+        if (conn.target.nodeId === '') {
+            // Map: original node's output port -> internal node's output port
+            const originalOutputKey = portMapKey(node.id, conn.target.portName);
+            const internalSourcePath = {
+                nodeId: sourceNodeId,
+                portName: conn.source.portName,
+            };
+            const existing = portMapping.get(originalOutputKey) || [];
+            portMapping.set(originalOutputKey, [...existing, internalSourcePath]);
+        }
+        // Only create internal connection if both sides are internal nodes
+        if (conn.source.nodeId !== '' && conn.target.nodeId !== '') {
+            const expandedConn = {
+                ...conn,
+                id: nanoid(),
+                source: { nodeId: sourceNodeId, portName: conn.source.portName },
+                target: { nodeId: targetNodeId, portName: conn.target.portName },
+            };
+            connections.push(expandedConn);
+        }
+    }
+    return { nodes, connections, portMapping };
+}
+/**
+ * Remap a connection through port mappings (for composite component ports)
+ * Returns an array to handle fan-out (one source to multiple targets)
+ */
+function remapConnection(conn, portMapping) {
+    // Try to remap source
+    const sourceKey = portMapKey(conn.source.nodeId, conn.source.portName);
+    const remappedSources = portMapping.get(sourceKey) || [conn.source];
+    // Try to remap target
+    const targetKey = portMapKey(conn.target.nodeId, conn.target.portName);
+    const remappedTargets = portMapping.get(targetKey) || [conn.target];
+    // Create connection for each combination of source/target (handles fan-out)
+    const connections = [];
+    for (const source of remappedSources) {
+        for (const target of remappedTargets) {
+            connections.push({
+                ...conn,
+                id: nanoid(),
+                source,
+                target,
+            });
+        }
+    }
+    return connections;
+}
+/**
+ * Check if a circuit contains any composite components
+ */
+export function hasCompositeComponents(circuit) {
+    const library = useCircuitLibraryStore.getState();
+    for (const node of circuit.nodes) {
+        const componentDef = library.resolveCircuit(node.componentRef);
+        if (componentDef?.implementation.kind === 'composite') {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=circuit-flattener.js.map

package/dist/editor/lib/utils/circuit-flattener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-flattener.js","sourceRoot":"","sources":["../../../../src/editor/lib/utils/circuit-flattener.ts"],"names":[],"mappings":"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"}

package/dist/editor/lib/utils/component-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Circuit Utility Functions
+ *
+ * Helper functions for analyzing circuit structure and properties.
+ */
+import type { Component } from '../../types';
+import type { Circuit } from '../../types/circuit';
+/**
+ * Recursively checks if a circuit or any of its nested circuits
+ * contains sequential primitives (D_FLIP_FLOP, REGISTER, RAM).
+ *
+ * @param componentType - The type/name of the circuit to check
+ * @param components - The current circuit's component instances
+ * @param resolveCircuit - Function to resolve circuit definitions from the library
+ * @param visited - Set of already-visited circuit types to prevent infinite recursion
+ * @returns true if the circuit or any nested circuit is sequential
+ */
+export declare function containsSequentialCircuit(componentType: string, components: Record<string, Component>, resolveCircuit: (name: string) => Circuit | undefined, visited?: Set<string>): boolean;
+/**
+ * Checks if the current circuit has any sequential circuits,
+ * including those nested inside composite circuits.
+ *
+ * @param components - The current circuit's component instances
+ * @param resolveCircuit - Function to resolve circuit definitions from the library
+ * @returns true if any circuit in the hierarchy is or contains sequential primitives
+ */
+export declare function hasSequentialCircuits(components: Record<string, Component>, resolveCircuit: (name: string) => Circuit | undefined): boolean;
+//# sourceMappingURL=component-utils.d.ts.map

package/dist/editor/lib/utils/component-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-utils.d.ts","sourceRoot":"","sources":["../../../../src/editor/lib/utils/component-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAWnD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACrC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,EACrD,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,OAAO,CAoCT;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACrC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,GACpD,OAAO,CAOT"}

package/dist/editor/lib/utils/component-utils.js

@@ -0,0 +1,72 @@
+/**
+ * Circuit Utility Functions
+ *
+ * Helper functions for analyzing circuit structure and properties.
+ */
+import { isSequentialComponent } from '../../types';
+/**
+ * Check if a circuit type is sequential.
+ * Delegates entirely to isSequentialComponent (data-driven via clock ports).
+ */
+function isSequentialPrimitive(componentType) {
+    return isSequentialComponent(componentType);
+}
+/**
+ * Recursively checks if a circuit or any of its nested circuits
+ * contains sequential primitives (D_FLIP_FLOP, REGISTER, RAM).
+ *
+ * @param componentType - The type/name of the circuit to check
+ * @param components - The current circuit's component instances
+ * @param resolveCircuit - Function to resolve circuit definitions from the library
+ * @param visited - Set of already-visited circuit types to prevent infinite recursion
+ * @returns true if the circuit or any nested circuit is sequential
+ */
+export function containsSequentialCircuit(componentType, components, resolveCircuit, visited = new Set()) {
+    // Prevent infinite recursion for circular references
+    if (visited.has(componentType)) {
+        return false;
+    }
+    visited.add(componentType);
+    // Check if this is a sequential primitive (handles both old and new naming)
+    if (isSequentialPrimitive(componentType)) {
+        return true;
+    }
+    // Resolve the circuit definition from the library
+    const circuit = resolveCircuit(componentType);
+    if (!circuit) {
+        // Circuit not found in library, assume non-sequential
+        return false;
+    }
+    // If this is a primitive implementation, it's not sequential (we already checked above)
+    if (circuit.implementation.kind === 'primitive') {
+        return false;
+    }
+    // For composite circuits, recursively check all internal nodes
+    if (circuit.implementation.kind === 'composite') {
+        for (const node of circuit.nodes) {
+            // Recursively check if this node's circuit is sequential
+            if (containsSequentialCircuit(node.componentRef, components, resolveCircuit, visited)) {
+                return true;
+            }
+        }
+    }
+    // No sequential circuits found
+    return false;
+}
+/**
+ * Checks if the current circuit has any sequential circuits,
+ * including those nested inside composite circuits.
+ *
+ * @param components - The current circuit's component instances
+ * @param resolveCircuit - Function to resolve circuit definitions from the library
+ * @returns true if any circuit in the hierarchy is or contains sequential primitives
+ */
+export function hasSequentialCircuits(components, resolveCircuit) {
+    for (const component of Object.values(components)) {
+        if (containsSequentialCircuit(component.type, components, resolveCircuit)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=component-utils.js.map

package/dist/editor/lib/utils/component-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-utils.js","sourceRoot":"","sources":["../../../../src/editor/lib/utils/component-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,SAAS,qBAAqB,CAAC,aAAqB;IAClD,OAAO,qBAAqB,CAAC,aAAa,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,aAAqB,EACrB,UAAqC,EACrC,cAAqD,EACrD,UAAuB,IAAI,GAAG,EAAE;IAEhC,qDAAqD;IACrD,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAE3B,4EAA4E;IAC5E,IAAI,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kDAAkD;IAClD,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,sDAAsD;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wFAAwF;IACxF,IAAI,OAAO,CAAC,cAAc,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+DAA+D;IAC/D,IAAI,OAAO,CAAC,cAAc,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,yDAAyD;YACzD,IAAI,yBAAyB,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,CAAC;gBACtF,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAqC,EACrC,cAAqD;IAErD,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAClD,IAAI,yBAAyB,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/editor/lib/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './circuit-flattener';
+export * from './component-utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/lib/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/editor/lib/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/editor/lib/utils/index.js

@@ -0,0 +1,3 @@
+export * from './circuit-flattener';
+export * from './component-utils';
+//# sourceMappingURL=index.js.map

package/dist/editor/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/editor/lib/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/editor/lib/visualization/index.d.ts

@@ -0,0 +1,2 @@
+export * from './vcd-generator';
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/lib/visualization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/editor/lib/visualization/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/editor/lib/visualization/index.js

@@ -0,0 +1,2 @@
+export * from './vcd-generator';
+//# sourceMappingURL=index.js.map

package/dist/editor/lib/visualization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/editor/lib/visualization/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/editor/lib/visualization/vcd-generator.d.ts

@@ -0,0 +1,63 @@
+/**
+ * VCD (Value Change Dump) Generator
+ *
+ * Generates industry-standard VCD waveform files from testbench traces.
+ * VCD files can be viewed in GTKWave, ModelSim, Vivado, and other tools.
+ *
+ * VCD Format Specification:
+ * - Header: version, date, timescale, scope, variable declarations
+ * - Body: timestamp and value change records
+ * - Compact: Only emit value changes, not every cycle
+ *
+ * References:
+ * - IEEE 1364-2001 VCD Format
+ * - GTKWave documentation
+ */
+import { CaptureData } from '../../types/testbench';
+/**
+ * Generate VCD file content from capture data
+ *
+ * @param captureData - Trace data collected during testbench run
+ * @param timescale - Time unit (default: "1 ns" - 1 nanosecond per cycle)
+ * @returns VCD file content as string
+ */
+export declare function generateVCD(captureData: CaptureData, timescale?: string): string;
+/**
+ * Write VCD to file (triggers browser download)
+ */
+export declare function writeVCDToFile(captureData: CaptureData, filename: string, timescale?: string): void;
+/**
+ * Trigger VCD file download in browser
+ */
+export declare function downloadVCD(content: string, filename: string): void;
+/**
+ * Parse VCD header to extract signal information
+ * (Useful for testing and verification)
+ */
+export interface VCDSignalInfo {
+    id: string;
+    name: string;
+    width: number;
+    type: string;
+}
+/**
+ * Parse VCD file header
+ */
+export declare function parseVCDHeader(vcdContent: string): {
+    timescale: string;
+    signals: VCDSignalInfo[];
+};
+/**
+ * Get VCD file statistics
+ */
+export declare function getVCDStats(captureData: CaptureData): {
+    signalCount: number;
+    totalCycles: number;
+    totalChanges: number;
+    fileSize: number;
+};
+/**
+ * Format VCD stats for display
+ */
+export declare function formatVCDStats(stats: ReturnType<typeof getVCDStats>): string;
+//# sourceMappingURL=vcd-generator.d.ts.map

package/dist/editor/lib/visualization/vcd-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vcd-generator.d.ts","sourceRoot":"","sources":["../../../../src/editor/lib/visualization/vcd-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAwB,MAAM,uBAAuB,CAAC;AAO1E;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,WAAW,EACxB,SAAS,SAAS,GACjB,MAAM,CAeR;AAwKD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAS,GACjB,IAAI,CAGN;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUnE;AAMD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CAqCA;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAoBA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,MAAM,CAQ5E"}