@simten/ui 0.1.1

package/dist/canvas/projection.js

@@ -0,0 +1,317 @@
+/**
+ * Pure projection utility for embed.
+ * Converts Circuit + Metadata into ReactFlow nodes and edges.
+ * No stores, no caches, no globals — explicit params only.
+ */
+const WIRE_COLORS = {
+    TRUE: '#22c55e',
+    FALSE: '#94a3b8',
+    UNDEFINED: '#cbd5e1',
+};
+function portPathKey(path) {
+    return path.nodeId === '' ? `.${path.portName}` : `${path.nodeId}.${path.portName}`;
+}
+function getNodeTypeForComponent(componentRef, inputCount, outputCount, isComposite) {
+    const typeMap = {
+        Switch: 'inputNode',
+        Input: 'numericInputNode',
+        Led: 'outputNode',
+        And: 'logicGateNode',
+        Or: 'logicGateNode',
+        Not: 'logicGateNode',
+        Nand: 'logicGateNode',
+        Nor: 'logicGateNode',
+        Xor: 'logicGateNode',
+        Xnor: 'logicGateNode',
+        Buffer: 'logicGateNode',
+        DFlipFlop: 'logicGateNode',
+        Register: 'registerNode',
+        RAM: 'ramNode',
+        ROM: 'romNode',
+        HexDisplay: 'outputNode',
+        SevenSegment: 'outputNode',
+        Screen: 'screenNode',
+        RasterDisplay: 'rasterDisplayNode',
+        Console: 'consoleNode',
+        UART_TX: 'uartTxNode',
+        NIC_FIFO: 'nicFifoNode',
+        Constant: 'logicGateNode',
+        RV32I_InstrMem: 'rv32iInstrMemNode',
+        DualPortROM: 'rv32iInstrMemNode',
+        Eth_FrameInput: 'ethFrameInputNode',
+    };
+    if (typeMap[componentRef])
+        return typeMap[componentRef];
+    // Composites always render as a generic gate box. The shape-based heuristics
+    // below only apply to primitives — a composite with 0 inputs (e.g. an internal
+    // counter that streams bytes) shouldn't be coerced into a toggle.
+    if (isComposite)
+        return 'logicGateNode';
+    if (inputCount === 0 && outputCount > 0)
+        return 'inputNode';
+    if (inputCount > 0 && outputCount === 0)
+        return 'outputNode';
+    if (inputCount > 0 && outputCount > 0)
+        return 'logicGateNode';
+    return 'default';
+}
+/**
+ * Project Circuit nodes to ReactFlow nodes.
+ * Pure function — all state passed explicitly.
+ */
+function projectCircuitToNodes(circuit, metadata, library, portValues, seqState) {
+    const reactFlowNodes = [];
+    for (const node of circuit.nodes) {
+        const nodeMetadata = metadata.components[node.id];
+        if (!nodeMetadata) {
+            console.warn(`[projection] node '${node.id}' (${node.componentRef}) has no layout metadata, skipping render`);
+            continue;
+        }
+        const componentDef = library.resolveCircuit(node.componentRef);
+        if (!componentDef)
+            continue;
+        const inputCount = node.inputs.length;
+        const outputCount = node.outputs.length;
+        const inputNames = node.inputs.map((p) => p.name);
+        const outputNames = node.outputs.map((p) => p.name);
+        const isComposite = componentDef.implementation.kind === 'composite';
+        const nodeType = getNodeTypeForComponent(node.componentRef, inputCount, outputCount, isComposite);
+        let value = undefined;
+        let numericValue = undefined;
+        let width = undefined;
+        let pixels = undefined;
+        let consoleText = undefined;
+        let uartText = undefined;
+        let nicState = undefined;
+        if (node.componentRef === 'Switch' || node.componentRef === 'Led') {
+            let resolved = false;
+            if (portValues) {
+                if (node.componentRef === 'Led' && node.inputs.length > 0) {
+                    const inputKey = portPathKey({ nodeId: node.id, portName: node.inputs[0].name });
+                    const portValue = portValues.get(inputKey);
+                    if (portValue !== undefined) {
+                        value = Boolean(portValue);
+                        resolved = true;
+                    }
+                }
+                else if (node.componentRef === 'Switch' && node.outputs.length > 0) {
+                    const outputKey = portPathKey({ nodeId: node.id, portName: node.outputs[0].name });
+                    const portValue = portValues.get(outputKey);
+                    if (portValue !== undefined) {
+                        value = Boolean(portValue);
+                        resolved = true;
+                    }
+                }
+            }
+            if (!resolved && 'value' in node.arguments) {
+                value = Boolean(node.arguments.value);
+            }
+        }
+        else if (node.componentRef === 'Input') {
+            width = typeof node.arguments.width === 'number' ? node.arguments.width : 8;
+            let numResolved = false;
+            if (portValues && node.outputs.length > 0) {
+                const outputKey = portPathKey({ nodeId: node.id, portName: node.outputs[0].name });
+                const portValue = portValues.get(outputKey);
+                if (portValue !== undefined && typeof portValue === 'number') {
+                    numericValue = portValue;
+                    numResolved = true;
+                }
+            }
+            if (!numResolved) {
+                numericValue = typeof node.arguments.value === 'number' ? node.arguments.value : 0;
+            }
+        }
+        else if (node.componentRef === 'HexDisplay' || node.componentRef === 'SevenSegment') {
+            if (portValues && node.inputs.length > 0) {
+                const inputKey = portPathKey({ nodeId: node.id, portName: node.inputs[0].name });
+                const portValue = portValues.get(inputKey);
+                numericValue = typeof portValue === 'number' ? portValue : 0;
+            }
+        }
+        else if (node.componentRef === 'Screen') {
+            const screenW = node.arguments.width ?? 8;
+            const screenH = node.arguments.height ?? 8;
+            const totalPixels = screenW * screenH;
+            pixels = new Array(totalPixels).fill(0);
+            if (seqState && portValues) {
+                const dataInConnection = Array.from(circuit.connections).find(conn => conn.target.nodeId === node.id && conn.target.portName === 'dataIn');
+                if (dataInConnection) {
+                    const sourceNode = circuit.nodes.find(n => n.id === dataInConnection.source.nodeId);
+                    if (sourceNode?.componentRef === 'DualPortRAM') {
+                        const ramState = seqState.currentState.get(sourceNode.id);
+                        if (ramState instanceof Map) {
+                            for (let addr = 0; addr < totalPixels; addr++) {
+                                pixels[addr] = ramState.get(addr) ?? 0;
+                            }
+                        }
+                    }
+                    else if (sourceNode?.componentRef === 'Mux') {
+                        const selKey = portPathKey({ nodeId: sourceNode.id, portName: 'sel' });
+                        const selValue = portValues.get(selKey);
+                        const selectedInputPort = selValue === 0 ? 'in0' : 'in1';
+                        const muxInputConnection = Array.from(circuit.connections).find(conn => conn.target.nodeId === sourceNode.id && conn.target.portName === selectedInputPort);
+                        if (muxInputConnection) {
+                            const ramNode = circuit.nodes.find(n => n.id === muxInputConnection.source.nodeId);
+                            if (ramNode?.componentRef === 'DualPortRAM') {
+                                const ramState = seqState.currentState.get(ramNode.id);
+                                if (ramState instanceof Map) {
+                                    for (let addr = 0; addr < totalPixels; addr++) {
+                                        pixels[addr] = ramState.get(addr) ?? 0;
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        else if (node.componentRef === 'RasterDisplay') {
+            const rasterW = node.arguments.width ?? 8;
+            const rasterH = node.arguments.height ?? 8;
+            const rasterPixels = rasterW * rasterH;
+            pixels = new Array(rasterPixels).fill(0);
+            if (seqState) {
+                const displayState = seqState.currentState.get(node.id);
+                if (displayState instanceof Map) {
+                    for (let addr = 0; addr < rasterPixels; addr++) {
+                        pixels[addr] = displayState.get(addr) ?? 0;
+                    }
+                }
+            }
+        }
+        else if (node.componentRef === 'Console') {
+            if (seqState) {
+                const consoleState = seqState.currentState.get(node.id);
+                if (typeof consoleState === 'string')
+                    consoleText = consoleState;
+            }
+        }
+        else if (node.componentRef === 'UART_TX') {
+            if (seqState) {
+                const uartState = seqState.currentState.get(node.id);
+                if (typeof uartState === 'string')
+                    uartText = uartState;
+            }
+        }
+        else if (node.componentRef === 'NIC_FIFO') {
+            if (seqState) {
+                const state = seqState.currentState.get(node.id);
+                if (state instanceof Map) {
+                    const s = state;
+                    const txWp = s.get(0x2000) ?? 0;
+                    const txRp = s.get(0x2001) ?? 0;
+                    const rxCount = s.get(0x2012) ?? 0;
+                    const draining = (s.get(0x2004) ?? 0) !== 0;
+                    nicState = { txCount: txWp - txRp, rxCount, draining };
+                }
+            }
+        }
+        reactFlowNodes.push({
+            id: node.id,
+            type: nodeType,
+            position: nodeMetadata.position,
+            data: {
+                nodeId: node.id,
+                componentRef: node.componentRef,
+                label: node.label,
+                value,
+                numericValue,
+                width,
+                inputCount,
+                outputCount,
+                inputNames,
+                outputNames,
+                isComposite,
+                arguments: node.arguments,
+                __pixels: pixels,
+                __consoleText: consoleText,
+                __uartText: uartText,
+                __nicState: nicState,
+            },
+            selectable: true,
+            deletable: false,
+        });
+    }
+    // Surface nested console/UART nodes
+    if (seqState) {
+        const existingNodeIds = new Set(reactFlowNodes.map(n => n.id));
+        let consoleIndex = 0;
+        for (const [nodeId, state] of seqState.currentState.entries()) {
+            if (existingNodeIds.has(nodeId))
+                continue;
+            if (typeof state === 'string') {
+                const pathParts = nodeId.split('.');
+                const shortLabel = pathParts.length > 1 ? pathParts.slice(-2).join('.') : nodeId;
+                const isUart = nodeId.toLowerCase().includes('uart');
+                reactFlowNodes.push({
+                    id: `__virtual_console_${consoleIndex}`,
+                    type: isUart ? 'uartTxNode' : 'consoleNode',
+                    position: { x: 600, y: 50 + (consoleIndex * 250) },
+                    data: {
+                        nodeId,
+                        componentRef: isUart ? 'UART_TX' : 'Console',
+                        label: isUart ? `UART (${shortLabel})` : `Console (${shortLabel})`,
+                        value: undefined,
+                        numericValue: undefined,
+                        width: undefined,
+                        inputCount: isUart ? 4 : 2,
+                        outputCount: 1,
+                        inputNames: isUart ? ['addr', 'write_data', 'mem_read', 'mem_write'] : ['data', 'we'],
+                        outputNames: isUart ? ['read_data'] : ['text'],
+                        __consoleText: isUart ? undefined : state,
+                        __uartText: isUart ? state : undefined,
+                    },
+                    selected: false,
+                    selectable: false,
+                    deletable: false,
+                });
+                consoleIndex++;
+            }
+        }
+    }
+    return reactFlowNodes;
+}
+/**
+ * Project Circuit connections to ReactFlow edges.
+ * Pure function — no hidden state.
+ */
+function projectCircuitToEdges(circuit, portValues) {
+    const edges = [];
+    for (const connection of circuit.connections) {
+        let edgeColor = WIRE_COLORS.UNDEFINED;
+        if (portValues) {
+            const value = portValues.get(portPathKey(connection.source))
+                ?? portValues.get(portPathKey(connection.target));
+            if (value !== undefined) {
+                edgeColor = (typeof value === 'boolean' ? value : value !== 0)
+                    ? WIRE_COLORS.TRUE : WIRE_COLORS.FALSE;
+            }
+        }
+        edges.push({
+            id: connection.id,
+            type: 'orthogonal',
+            source: connection.source.nodeId,
+            target: connection.target.nodeId,
+            sourceHandle: `out-${connection.source.portName}`,
+            targetHandle: `in-${connection.target.portName}`,
+            style: { stroke: edgeColor, strokeWidth: 2 },
+            animated: false,
+            selectable: false,
+            deletable: false,
+        });
+    }
+    return edges;
+}
+/**
+ * Main projection function — pure, no side effects.
+ */
+export function projectCircuitToReactFlow(circuit, metadata, library, portValues, seqState) {
+    if (!circuit)
+        return { nodes: [], edges: [] };
+    return {
+        nodes: projectCircuitToNodes(circuit, metadata, library, portValues, seqState),
+        edges: projectCircuitToEdges(circuit, portValues),
+    };
+}
+//# sourceMappingURL=projection.js.map

package/dist/canvas/projection.js.map

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

package/dist/canvas/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Types for the embed package.
+ * Defines layout metadata types and re-exports simulator types from core.
+ */
+export type { FlatCircuit, FlatPortValueMap, FlatSequentialState, } from "@simten/core/simulator";
+export type { Circuit } from "@simten/core";
+import type { Circuit as CircuitType } from "@simten/core";
+export interface InspectorFrame {
+    componentName: string;
+    componentDef: CircuitType;
+    nodeLabel: string;
+}
+/** Screen rect of the node that triggered the dialog (for animate-from-origin) */
+export interface OriginRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface Position {
+    x: number;
+    y: number;
+}
+export interface Dimensions {
+    width: number;
+    height: number;
+}
+export interface ComponentMetadata {
+    id: string;
+    position: Position;
+    dimensions?: Dimensions;
+}
+export interface ConnectionMetadata {
+    id: string;
+}
+export interface MetadataState {
+    components: Record<string, ComponentMetadata>;
+    connections: Record<string, ConnectionMetadata>;
+}
+/**
+ * Public layout prop type. Maps a node's label (or id, as fallback) to its
+ * position on the canvas. Pass to CircuitCanvas / CircuitEmbed via the
+ * `layout` prop to bypass the runtime layout engine entirely.
+ *
+ * When parameterised by a `BuiltCircuit`, the keys are constrained at compile
+ * time to the union of input names, output names, and node labels.
+ */
+import type { BuiltCircuit } from "@simten/core";
+export type CircuitLayout<C extends BuiltCircuit | undefined = undefined> = C extends BuiltCircuit<infer Ins, infer Outs, infer Ns> ? Record<keyof Ins | keyof Outs | keyof Ns, {
+    x: number;
+    y: number;
+}> : Record<string, {
+    x: number;
+    y: number;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/canvas/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/canvas/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,WAAW,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACjD;AAED;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,IAC5C,CAAC,SAAS,YAAY,CAAC,MAAM,GAAG,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC,GACvD,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,IAAI,GAAG,MAAM,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACnE,MAAM,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}

package/dist/canvas/types.js

@@ -0,0 +1,6 @@
+/**
+ * Types for the embed package.
+ * Defines layout metadata types and re-exports simulator types from core.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/canvas/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/canvas/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/canvas/useLayout.d.ts

@@ -0,0 +1,21 @@
+/**
+ * useLayout — synchronous layout hook for CircuitCanvas.
+ *
+ * Wraps computeDagreLayout. Result is available on first render.
+ * No loading state, no fallback — dagre runs in <2 ms for typical
+ * circuits.
+ */
+import type { Circuit } from "@simten/core";
+import type { MetadataState } from "./types";
+import { type DagreLayoutOptions } from "./dagre-layout";
+export type { DagreLayoutOptions };
+/**
+ * Returns layout metadata for a circuit. Synchronous: result is
+ * available on first render. Pass `null` to skip layout (e.g. when
+ * the consumer is providing a static `layout` prop).
+ */
+export declare function useLayout(circuit: Circuit | null, options?: DagreLayoutOptions): {
+    metadata: MetadataState;
+    isLayoutReady: boolean;
+};
+//# sourceMappingURL=useLayout.d.ts.map

package/dist/canvas/useLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLayout.d.ts","sourceRoot":"","sources":["../../src/canvas/useLayout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,OAAO,GAAG,IAAI,EACvB,OAAO,CAAC,EAAE,kBAAkB,GAC3B;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAUrD"}

package/dist/canvas/useLayout.js

@@ -0,0 +1,26 @@
+/**
+ * useLayout — synchronous layout hook for CircuitCanvas.
+ *
+ * Wraps computeDagreLayout. Result is available on first render.
+ * No loading state, no fallback — dagre runs in <2 ms for typical
+ * circuits.
+ */
+import { useMemo } from "react";
+import { computeDagreLayout } from "./dagre-layout";
+/**
+ * Returns layout metadata for a circuit. Synchronous: result is
+ * available on first render. Pass `null` to skip layout (e.g. when
+ * the consumer is providing a static `layout` prop).
+ */
+export function useLayout(circuit, options) {
+    return useMemo(() => {
+        if (!circuit) {
+            return {
+                metadata: { components: {}, connections: {} },
+                isLayoutReady: false,
+            };
+        }
+        return { metadata: computeDagreLayout(circuit, options), isLayoutReady: true };
+    }, [circuit, options?.direction, options?.nodeSpacing, options?.rankSpacing]);
+}
+//# sourceMappingURL=useLayout.js.map

package/dist/canvas/useLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLayout.js","sourceRoot":"","sources":["../../src/canvas/useLayout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAGhC,OAAO,EAAE,kBAAkB,EAA2B,MAAM,gBAAgB,CAAC;AAI7E;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,OAAuB,EACvB,OAA4B;IAE5B,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAmB;gBAC9D,aAAa,EAAE,KAAK;aACrB,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACjF,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/editor/components/CircuitSelector.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CircuitSelector Component
+ *
+ * Dropdown selector for choosing which compiled TypeScript circuit to visualize.
+ * Displays circuit count and allows switching between multiple circuits
+ * when a circuit code file defines multiple circuits.
+ */
+export declare function CircuitSelector(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CircuitSelector.d.ts.map

package/dist/editor/components/CircuitSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircuitSelector.d.ts","sourceRoot":"","sources":["../../../src/editor/components/CircuitSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,wBAAgB,eAAe,4CAyC9B"}

package/dist/editor/components/CircuitSelector.js

@@ -0,0 +1,20 @@
+/**
+ * CircuitSelector Component
+ *
+ * Dropdown selector for choosing which compiled TypeScript circuit to visualize.
+ * Displays circuit count and allows switching between multiple circuits
+ * when a circuit code file defines multiple circuits.
+ */
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCircuitPreviewStore } from '../stores/circuit-preview-store';
+import { cn } from '../../lib/utils';
+export function CircuitSelector() {
+    const compiledCircuits = useCircuitPreviewStore((state) => state.compiledCircuits);
+    const selectedCircuitIndex = useCircuitPreviewStore((state) => state.selectedCircuitIndex);
+    const selectCircuit = useCircuitPreviewStore((state) => state.selectCircuit);
+    const hasCircuits = compiledCircuits.length > 0;
+    const circuitCount = compiledCircuits.length;
+    return (_jsxs("div", { className: "flex items-center gap-4 px-4 py-2 border-b bg-gray-50 dark:bg-gray-900", children: [_jsx("label", { htmlFor: "circuit-select", className: "text-sm font-medium text-gray-700 dark:text-gray-300", children: "Circuit:" }), _jsxs("select", { id: "circuit-select", value: selectedCircuitIndex, onChange: (e) => selectCircuit(Number(e.target.value)), disabled: !hasCircuits, className: cn('px-3 py-1 rounded border text-sm', 'bg-white dark:bg-gray-800', 'border-gray-300 dark:border-gray-600', 'text-gray-900 dark:text-gray-100', 'focus:outline-none focus:ring-2 focus:ring-blue-500', 'disabled:opacity-50 disabled:cursor-not-allowed'), children: [!hasCircuits && _jsx("option", { value: -1, children: "No circuits compiled" }), compiledCircuits.map((circuit, index) => (_jsx("option", { value: index, children: circuit.name }, index)))] }), _jsxs("span", { className: "text-sm text-gray-600 dark:text-gray-400", children: [circuitCount === 0 && 'No circuits compiled', circuitCount === 1 && '1 circuit compiled', circuitCount > 1 && `${circuitCount} circuits compiled`] })] }));
+}
+//# sourceMappingURL=CircuitSelector.js.map

package/dist/editor/components/CircuitSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircuitSelector.js","sourceRoot":"","sources":["../../../src/editor/components/CircuitSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,CAAC;;AAEb,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAErC,MAAM,UAAU,eAAe;IAC7B,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnF,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC3F,MAAM,aAAa,GAAG,sBAAsB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAE7E,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAE7C,OAAO,CACL,eAAK,SAAS,EAAC,wEAAwE,aACrF,gBAAO,OAAO,EAAC,gBAAgB,EAAC,SAAS,EAAC,sDAAsD,yBAExF,EACR,kBACE,EAAE,EAAC,gBAAgB,EACnB,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EACtD,QAAQ,EAAE,CAAC,WAAW,EACtB,SAAS,EAAE,EAAE,CACX,kCAAkC,EAClC,2BAA2B,EAC3B,sCAAsC,EACtC,kCAAkC,EAClC,qDAAqD,EACrD,iDAAiD,CAClD,aAEA,CAAC,WAAW,IAAI,iBAAQ,KAAK,EAAE,CAAC,CAAC,qCAA+B,EAChE,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CACxC,iBAAoB,KAAK,EAAE,KAAK,YAC7B,OAAO,CAAC,IAAI,IADF,KAAK,CAET,CACV,CAAC,IACK,EACT,gBAAM,SAAS,EAAC,0CAA0C,aACvD,YAAY,KAAK,CAAC,IAAI,sBAAsB,EAC5C,YAAY,KAAK,CAAC,IAAI,oBAAoB,EAC1C,YAAY,GAAG,CAAC,IAAI,GAAG,YAAY,oBAAoB,IACnD,IACH,CACP,CAAC;AACJ,CAAC"}

package/dist/editor/components/CircuitTabBar.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CircuitTabBar Component
+ *
+ * Browser-style tabs for switching between compiled circuits.
+ * Replaces the old dropdown selector with a more discoverable tab interface.
+ */
+export declare function CircuitTabBar(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CircuitTabBar.d.ts.map

package/dist/editor/components/CircuitTabBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircuitTabBar.d.ts","sourceRoot":"","sources":["../../../src/editor/components/CircuitTabBar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,wBAAgB,aAAa,4CAqC5B"}

package/dist/editor/components/CircuitTabBar.js

@@ -0,0 +1,23 @@
+/**
+ * CircuitTabBar Component
+ *
+ * Browser-style tabs for switching between compiled circuits.
+ * Replaces the old dropdown selector with a more discoverable tab interface.
+ */
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCircuitPreviewStore } from '../stores/circuit-preview-store';
+import { cn } from '../../lib/utils';
+export function CircuitTabBar() {
+    const compiledCircuits = useCircuitPreviewStore((state) => state.compiledCircuits);
+    const selectedCircuitIndex = useCircuitPreviewStore((state) => state.selectedCircuitIndex);
+    const selectCircuit = useCircuitPreviewStore((state) => state.selectCircuit);
+    const hasCircuits = compiledCircuits.length > 0;
+    if (!hasCircuits) {
+        return (_jsx("div", { className: "flex items-center gap-2 px-4 py-3 border-b bg-gray-50 dark:bg-gray-900", children: _jsx("span", { className: "text-sm text-gray-600 dark:text-gray-400", children: "No circuits compiled. Write circuit code to see circuits here." }) }));
+    }
+    return (_jsx("div", { className: "flex items-center gap-1 px-2 py-2 border-b bg-gray-100 dark:bg-gray-900 overflow-x-auto", children: compiledCircuits.map((circuit, index) => (_jsx("button", { onClick: () => selectCircuit(index), className: cn('px-4 py-2 text-sm font-medium rounded-t-md transition-all whitespace-nowrap', 'hover:bg-gray-200 dark:hover:bg-gray-700', selectedCircuitIndex === index
+                ? 'bg-white dark:bg-gray-800 text-blue-600 dark:text-blue-400 border-t-2 border-x border-blue-600 dark:border-blue-400'
+                : 'bg-gray-50 dark:bg-gray-800 text-gray-700 dark:text-gray-300 border border-transparent'), title: `Switch to ${circuit.name} circuit`, children: circuit.name }, index))) }));
+}
+//# sourceMappingURL=CircuitTabBar.js.map

package/dist/editor/components/CircuitTabBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircuitTabBar.js","sourceRoot":"","sources":["../../../src/editor/components/CircuitTabBar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,CAAC;;AAEb,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAErC,MAAM,UAAU,aAAa;IAC3B,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnF,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC3F,MAAM,aAAa,GAAG,sBAAsB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAE7E,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;IAEhD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CACL,cAAK,SAAS,EAAC,wEAAwE,YACrF,eAAM,SAAS,EAAC,0CAA0C,+EAEnD,GACH,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,cAAK,SAAS,EAAC,yFAAyF,YACrG,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CACxC,iBAEE,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EACnC,SAAS,EAAE,EAAE,CACX,6EAA6E,EAC7E,0CAA0C,EAC1C,oBAAoB,KAAK,KAAK;gBAC5B,CAAC,CAAC,qHAAqH;gBACvH,CAAC,CAAC,wFAAwF,CAC7F,EACD,KAAK,EAAE,aAAa,OAAO,CAAC,IAAI,UAAU,YAEzC,OAAO,CAAC,IAAI,IAXR,KAAK,CAYH,CACV,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/editor/components/ClockControls.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Editor ClockControls — re-exports the unified canvas ClockControls.
+ * The VisualEditor passes all props from the session.
+ */
+export { ClockControls, type ClockControlsProps } from '../../canvas/ClockControls';
+//# sourceMappingURL=ClockControls.d.ts.map

package/dist/editor/components/ClockControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClockControls.d.ts","sourceRoot":"","sources":["../../../src/editor/components/ClockControls.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/editor/components/ClockControls.js

@@ -0,0 +1,7 @@
+/**
+ * Editor ClockControls — re-exports the unified canvas ClockControls.
+ * The VisualEditor passes all props from the session.
+ */
+'use client';
+export { ClockControls } from '../../canvas/ClockControls';
+//# sourceMappingURL=ClockControls.js.map

package/dist/editor/components/ClockControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClockControls.js","sourceRoot":"","sources":["../../../src/editor/components/ClockControls.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAA2B,MAAM,4BAA4B,CAAC"}

package/dist/editor/components/ComponentTooltip.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ComponentTooltip Component
+ *
+ * Displays detailed information about a component on hover,
+ * similar to Turing Complete game tooltips.
+ * Shows component name, description, and input/output states.
+ */
+import React from 'react';
+export interface PortInfo {
+    index: number;
+    label: string;
+    value?: boolean;
+}
+interface ComponentTooltipProps {
+    children: React.ReactNode;
+    title: string;
+    description: string;
+    inputs?: PortInfo[];
+    outputs?: PortInfo[];
+    enabled?: boolean;
+    delayMs?: number;
+}
+export declare function ComponentTooltip({ children, title, description, inputs, outputs, enabled, delayMs, }: ComponentTooltipProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ComponentTooltip.d.ts.map

package/dist/editor/components/ComponentTooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentTooltip.d.ts","sourceRoot":"","sources":["../../../src/editor/components/ComponentTooltip.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAI3D,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,KAAK,EACL,WAAW,EACX,MAAW,EACX,OAAY,EACZ,OAAc,EACd,OAAa,GACd,EAAE,qBAAqB,2CA0EvB"}