@simten/ui 0.1.1

package/dist/canvas/drill-down-view.js

@@ -0,0 +1,134 @@
+/**
+ * Drill-Down View Utilities
+ *
+ * Creates viewable circuits for composite component internals.
+ * When a user drills into a composite (e.g., HalfAdder), we need to:
+ * 1. Show its internal nodes on the canvas
+ * 2. Add synthetic boundary nodes for the composite's ports
+ * 3. Scope port values so internal node IDs match simulation keys
+ */
+/** Prefix for synthetic boundary input nodes */
+export const BOUNDARY_IN_PREFIX = '__boundary_in_';
+/** Prefix for synthetic boundary output nodes */
+export const BOUNDARY_OUT_PREFIX = '__boundary_out_';
+/**
+ * Creates a viewable circuit from a composite's definition.
+ *
+ * The composite Circuit has internal nodes and connections where circuit-level
+ * ports use `nodeId: ""`. We replace those with synthetic Switch/Input (for inputs)
+ * and Led (for outputs) boundary nodes, so the canvas renders them naturally.
+ */
+export function createDrillDownViewCircuit(composite) {
+    const boundaryNodes = [];
+    const rewrittenConnections = [];
+    // Create boundary input nodes (one per composite input port)
+    for (const port of composite.inputs) {
+        const boundaryId = `${BOUNDARY_IN_PREFIX}${port.name}`;
+        const isBus = port.portType.kind === 'bus';
+        boundaryNodes.push({
+            id: boundaryId,
+            label: port.name,
+            componentRef: isBus ? 'Input' : 'Switch',
+            arguments: isBus ? { value: 0, width: port.portType.width } : { value: false },
+            inputs: [],
+            outputs: [{
+                    id: `${boundaryId}_out`,
+                    name: 'out',
+                    portType: port.portType,
+                }],
+            clocks: [],
+        });
+    }
+    // Create boundary output nodes (one per composite output port)
+    // Bus outputs use HexDisplay (shows numeric value), bit outputs use Led (shows on/off)
+    for (const port of composite.outputs) {
+        const boundaryId = `${BOUNDARY_OUT_PREFIX}${port.name}`;
+        const isBus = port.portType.kind === 'bus';
+        boundaryNodes.push({
+            id: boundaryId,
+            label: port.name,
+            componentRef: isBus ? 'HexDisplay' : 'Led',
+            arguments: {},
+            inputs: [{
+                    id: `${boundaryId}_in`,
+                    name: 'in',
+                    portType: port.portType,
+                }],
+            outputs: [],
+            clocks: [],
+        });
+    }
+    // Rewrite connections: replace circuit-level port references (nodeId: "")
+    // with the corresponding boundary node IDs
+    for (const conn of composite.connections) {
+        const newSource = { ...conn.source };
+        const newTarget = { ...conn.target };
+        if (conn.source.nodeId === '') {
+            // Circuit-level input port → boundary input node's output
+            newSource.nodeId = `${BOUNDARY_IN_PREFIX}${conn.source.portName}`;
+            newSource.portName = 'out';
+        }
+        if (conn.target.nodeId === '') {
+            // Circuit-level output port → boundary output node's input
+            newTarget.nodeId = `${BOUNDARY_OUT_PREFIX}${conn.target.portName}`;
+            newTarget.portName = 'in';
+        }
+        rewrittenConnections.push({
+            ...conn,
+            source: newSource,
+            target: newTarget,
+        });
+    }
+    return {
+        ...composite,
+        name: `__drilldown_${composite.name}`,
+        nodes: [...boundaryNodes, ...composite.nodes],
+        connections: rewrittenConnections,
+        // Mark as primitive so the view circuit itself isn't treated as drillable
+        implementation: { kind: 'primitive' },
+    };
+}
+/**
+ * Scopes port values for a drilled-in view.
+ *
+ * The flat simulator produces port value keys with hierarchical prefixes like
+ * "ha1_abc.xor1_def.out". When we drill into "ha1_abc", we need to strip
+ * that prefix so keys become "xor1_def.out" — matching the composite's internal node IDs.
+ *
+ * Also maps boundary port values: the composite instance's own port values
+ * get mapped to synthetic boundary node IDs.
+ */
+export function scopePortValues(portValues, prefix, composite) {
+    if (!prefix)
+        return portValues;
+    const scoped = new Map();
+    for (const [key, value] of portValues.entries()) {
+        if (key.startsWith(prefix)) {
+            const scopedKey = key.slice(prefix.length);
+            scoped.set(scopedKey, value);
+        }
+    }
+    // Map boundary port values from the parent scope
+    // The composite instance's ports in the parent are keyed as "nodeId.portName"
+    // We map them to "__boundary_in_portName.out" and "__boundary_out_portName.in"
+    if (composite) {
+        // Strip trailing dot from prefix to get the instance nodeId
+        const instanceId = prefix.endsWith('.') ? prefix.slice(0, -1) : prefix;
+        for (const port of composite.inputs) {
+            const parentKey = `${instanceId}.${port.name}`;
+            const value = portValues.get(parentKey);
+            if (value !== undefined) {
+                scoped.set(`${BOUNDARY_IN_PREFIX}${port.name}.out`, value);
+            }
+        }
+        for (const port of composite.outputs) {
+            const parentKey = `${instanceId}.${port.name}`;
+            const value = portValues.get(parentKey);
+            if (value !== undefined) {
+                scoped.set(`${BOUNDARY_OUT_PREFIX}${port.name}.in`, value);
+            }
+        }
+    }
+    return scoped;
+}
+//# sourceMappingURL=drill-down-view.js.map

package/dist/canvas/drill-down-view.js.map

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

package/dist/canvas/hooks/useDetectTheme.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Reactive theme detection from the `dark` class on `<html>`.
+ * Falls back to `"light"` during SSR / when document is unavailable.
+ */
+export declare function useDetectTheme(): "light" | "dark";
+//# sourceMappingURL=useDetectTheme.d.ts.map

package/dist/canvas/hooks/useDetectTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDetectTheme.d.ts","sourceRoot":"","sources":["../../../src/canvas/hooks/useDetectTheme.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,GAAG,MAAM,CAiBjD"}

package/dist/canvas/hooks/useDetectTheme.js

@@ -0,0 +1,20 @@
+import { useState, useEffect } from "react";
+/**
+ * Reactive theme detection from the `dark` class on `<html>`.
+ * Falls back to `"light"` during SSR / when document is unavailable.
+ */
+export function useDetectTheme() {
+    const [theme, setTheme] = useState(() => typeof document !== "undefined" && document.documentElement.classList.contains("dark")
+        ? "dark"
+        : "light");
+    useEffect(() => {
+        const el = document.documentElement;
+        const observer = new MutationObserver(() => {
+            setTheme(el.classList.contains("dark") ? "dark" : "light");
+        });
+        observer.observe(el, { attributes: true, attributeFilter: ["class"] });
+        return () => observer.disconnect();
+    }, []);
+    return theme;
+}
+//# sourceMappingURL=useDetectTheme.js.map

package/dist/canvas/hooks/useDetectTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDetectTheme.js","sourceRoot":"","sources":["../../../src/canvas/hooks/useDetectTheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAmB,GAAG,EAAE,CACxD,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpF,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,OAAO,CACZ,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE;YACzC,QAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvE,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/canvas/hooks/useIsMobile.d.ts

@@ -0,0 +1,2 @@
+export declare function useIsMobile(): boolean;
+//# sourceMappingURL=useIsMobile.d.ts.map

package/dist/canvas/hooks/useIsMobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsMobile.d.ts","sourceRoot":"","sources":["../../../src/canvas/hooks/useIsMobile.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,IAAI,OAAO,CAgBrC"}

package/dist/canvas/hooks/useIsMobile.js

@@ -0,0 +1,20 @@
+import { useEffect, useState } from "react";
+const MOBILE_QUERY = "(pointer: coarse) and (max-width: 1024px)";
+export function useIsMobile() {
+    const [isMobile, setIsMobile] = useState(() => {
+        if (typeof window === "undefined" || !window.matchMedia)
+            return false;
+        return window.matchMedia(MOBILE_QUERY).matches;
+    });
+    useEffect(() => {
+        if (typeof window === "undefined" || !window.matchMedia)
+            return;
+        const mql = window.matchMedia(MOBILE_QUERY);
+        const onChange = (e) => setIsMobile(e.matches);
+        setIsMobile(mql.matches);
+        mql.addEventListener("change", onChange);
+        return () => mql.removeEventListener("change", onChange);
+    }, []);
+    return isMobile;
+}
+//# sourceMappingURL=useIsMobile.js.map

package/dist/canvas/hooks/useIsMobile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsMobile.js","sourceRoot":"","sources":["../../../src/canvas/hooks/useIsMobile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,YAAY,GAAG,2CAA2C,CAAC;AAEjE,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAU,GAAG,EAAE;QACrD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QACtE,OAAO,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO;QAChE,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,CAAC,CAAsB,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACpE,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzB,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/canvas/hooks/useSimulationSession.d.ts

@@ -0,0 +1,23 @@
+/**
+ * React binding for SimulationSession.
+ *
+ * Thin wrapper using useSyncExternalStore — the session's getState()
+ * returns a stable reference, so React only re-renders when something
+ * actually changes.
+ */
+import type { SimulationSession, SimulationSessionState, SessionSnapshot } from "@simten/core/simulator";
+import type { BitValue, BusValue } from "@simten/core/simulator";
+export interface UseSimulationSessionResult<TMeta = unknown> extends SimulationSessionState<TMeta> {
+    tick: (metadata?: TMeta) => void;
+    reset: () => void;
+    setNode: (name: string, value: BitValue | BusValue) => void;
+    runCombinational: () => void;
+    stepBack: () => SessionSnapshot<TMeta> | null;
+    stepForward: () => SessionSnapshot<TMeta> | null;
+    seek: (index: number) => SessionSnapshot<TMeta> | null;
+    startAutoRun: SimulationSession<TMeta>["startAutoRun"];
+    stopAutoRun: () => void;
+    setSpeed: (ticksPerSecond: number) => void;
+}
+export declare function useSimulationSession<TMeta = unknown>(session: SimulationSession<TMeta> | null): UseSimulationSessionResult<TMeta>;
+//# sourceMappingURL=useSimulationSession.d.ts.map

package/dist/canvas/hooks/useSimulationSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSimulationSession.d.ts","sourceRoot":"","sources":["../../../src/canvas/hooks/useSimulationSession.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAiBjE,MAAM,WAAW,0BAA0B,CAAC,KAAK,GAAG,OAAO,CACzD,SAAQ,sBAAsB,CAAC,KAAK,CAAC;IACrC,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAC5D,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,eAAe,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC9C,WAAW,EAAE,MAAM,eAAe,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACjD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,eAAe,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACvD,YAAY,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC;IACvD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED,wBAAgB,oBAAoB,CAAC,KAAK,GAAG,OAAO,EAClD,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,GACvC,0BAA0B,CAAC,KAAK,CAAC,CA8BnC"}

package/dist/canvas/hooks/useSimulationSession.js

@@ -0,0 +1,41 @@
+/**
+ * React binding for SimulationSession.
+ *
+ * Thin wrapper using useSyncExternalStore — the session's getState()
+ * returns a stable reference, so React only re-renders when something
+ * actually changes.
+ */
+"use client";
+import { useSyncExternalStore, useCallback, useMemo } from "react";
+const EMPTY_STATE = {
+    portValues: new Map(),
+    sequentialState: null,
+    cycle: 0,
+    isSequential: false,
+    history: [],
+    historyIndex: -1,
+    isViewingPast: false,
+    isRunning: false,
+    speed: 0,
+};
+const noopUnsubscribe = () => { };
+const noopSubscribe = () => noopUnsubscribe;
+export function useSimulationSession(session) {
+    const subscribe = useCallback((listener) => session ? session.subscribe(listener) : noopSubscribe(), [session]);
+    const getSnapshot = useCallback(() => (session ? session.getState() : EMPTY_STATE), [session]);
+    const state = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    const actions = useMemo(() => ({
+        tick: (metadata) => session?.tick(metadata),
+        reset: () => session?.reset(),
+        setNode: (name, value) => session?.setNode(name, value),
+        runCombinational: () => session?.runCombinational(),
+        stepBack: () => session?.stepBack() ?? null,
+        stepForward: () => session?.stepForward() ?? null,
+        seek: (index) => session?.seek(index) ?? null,
+        startAutoRun: (...args) => session?.startAutoRun(...args),
+        stopAutoRun: () => session?.stopAutoRun(),
+        setSpeed: (tps) => session?.setSpeed(tps),
+    }), [session]);
+    return { ...state, ...actions };
+}
+//# sourceMappingURL=useSimulationSession.js.map

package/dist/canvas/hooks/useSimulationSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSimulationSession.js","sourceRoot":"","sources":["../../../src/canvas/hooks/useSimulationSession.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,CAAC;AAEb,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAQnE,MAAM,WAAW,GAA2B;IAC1C,UAAU,EAAE,IAAI,GAAG,EAAE;IACrB,eAAe,EAAE,IAAI;IACrB,KAAK,EAAE,CAAC;IACR,YAAY,EAAE,KAAK;IACnB,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,CAAC,CAAC;IAChB,aAAa,EAAE,KAAK;IACpB,SAAS,EAAE,KAAK;IAChB,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,eAAe,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AACjC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC;AAgB5C,MAAM,UAAU,oBAAoB,CAClC,OAAwC;IAExC,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,QAAoB,EAAE,EAAE,CACvB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,EACzD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAC7B,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,WAA4C,CAAC,EACnF,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IAGxE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC;QACnD,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE;QAC7B,OAAO,EAAE,CAAC,IAAY,EAAE,KAA0B,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;QACpF,gBAAgB,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE;QACnD,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI;QAC3C,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI;QACjD,IAAI,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI;QACrD,YAAY,EAAE,CAAC,GAAG,IAA0D,EAAE,EAAE,CAC9E,OAAO,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC;QAChC,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE;QACzC,QAAQ,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC;KAClD,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEf,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,EAAuC,CAAC;AACvE,CAAC"}

package/dist/canvas/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @simten/ui/canvas
+ *
+ * Unified circuit canvas — props-driven, store-free.
+ * Used by both the embed package and the editor.
+ */
+export { CircuitCanvas } from "./CircuitCanvas";
+export type { CircuitCanvasProps } from "./CircuitCanvas";
+export { NODE_TYPES, EDGE_TYPES } from "./node-types";
+export { projectCircuitToReactFlow } from "./projection";
+export { useLayout } from "./useLayout";
+export { computeDagreLayout } from "./dagre-layout";
+export { createDrillDownViewCircuit, scopePortValues } from "./drill-down-view";
+export { CompositeInspectorDialog } from "./CompositeInspectorDialog";
+export type { CompositeInspectorDialogProps } from "./CompositeInspectorDialog";
+export type { CircuitLayout, MetadataState, InspectorFrame, OriginRect } from "./types";
+export { useSimulationSession } from "./hooks/useSimulationSession";
+export type { UseSimulationSessionResult } from "./hooks/useSimulationSession";
+export { ClockControls } from "./ClockControls";
+export type { ClockControlsProps } from "./ClockControls";
+export { useDetectTheme } from "./hooks/useDetectTheme";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/canvas/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/canvas/index.js

@@ -0,0 +1,17 @@
+/**
+ * @simten/ui/canvas
+ *
+ * Unified circuit canvas — props-driven, store-free.
+ * Used by both the embed package and the editor.
+ */
+export { CircuitCanvas } from "./CircuitCanvas";
+export { NODE_TYPES, EDGE_TYPES } from "./node-types";
+export { projectCircuitToReactFlow } from "./projection";
+export { useLayout } from "./useLayout";
+export { computeDagreLayout } from "./dagre-layout";
+export { createDrillDownViewCircuit, scopePortValues } from "./drill-down-view";
+export { CompositeInspectorDialog } from "./CompositeInspectorDialog";
+export { useSimulationSession } from "./hooks/useSimulationSession";
+export { ClockControls } from "./ClockControls";
+export { useDetectTheme } from "./hooks/useDetectTheme";
+//# sourceMappingURL=index.js.map

package/dist/canvas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/canvas/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/canvas/label-utils.d.ts

@@ -0,0 +1,10 @@
+import type { Circuit } from "@simten/core";
+/**
+ * Extract clean label from node ID (removes timestamps and prefixes).
+ */
+export declare function extractCleanLabel(nodeId: string): string;
+/**
+ * Clean up node labels for display.
+ */
+export declare function cleanCircuitLabels(circuit: Circuit): Circuit;
+//# sourceMappingURL=label-utils.d.ts.map

package/dist/canvas/label-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-utils.d.ts","sourceRoot":"","sources":["../../src/canvas/label-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAexD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQ5D"}

package/dist/canvas/label-utils.js

@@ -0,0 +1,32 @@
+/**
+ * Extract clean label from node ID (removes timestamps and prefixes).
+ */
+export function extractCleanLabel(nodeId) {
+    if (nodeId.includes('.')) {
+        return extractCleanLabel(nodeId.split('.').pop() || nodeId);
+    }
+    const parts = nodeId.split('_');
+    for (let i = 0; i < parts.length; i++) {
+        if (/^\d{10,}$/.test(parts[i])) {
+            const nameParts = parts.slice(0, i);
+            if (nameParts.length > 1 && /^[A-Z]/.test(nameParts[0])) {
+                return nameParts.slice(1).join('_') || nameParts[0];
+            }
+            return nameParts.join('_') || nodeId;
+        }
+    }
+    return nodeId;
+}
+/**
+ * Clean up node labels for display.
+ */
+export function cleanCircuitLabels(circuit) {
+    return {
+        ...circuit,
+        nodes: circuit.nodes.map(node => ({
+            ...node,
+            label: extractCleanLabel(node.label || node.id),
+        })),
+    };
+}
+//# sourceMappingURL=label-utils.js.map

package/dist/canvas/label-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-utils.js","sourceRoot":"","sources":["../../src/canvas/label-utils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;YACtD,CAAC;YACD,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;QACL,GAAG,OAAO;QACV,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChC,GAAG,IAAI;YACP,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/canvas/node-types.d.ts

@@ -0,0 +1,10 @@
+import { type NodeTypes, type EdgeTypes } from "@xyflow/react";
+/**
+ * Default node type map — all rich components, no fallbacks.
+ */
+export declare const NODE_TYPES: NodeTypes;
+/**
+ * Edge type map.
+ */
+export declare const EDGE_TYPES: EdgeTypes;
+//# sourceMappingURL=node-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-types.d.ts","sourceRoot":"","sources":["../../src/canvas/node-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAmB/E;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,SAgBjB,CAAC;AAET;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,SAExB,CAAC"}

package/dist/canvas/node-types.js

@@ -0,0 +1,29 @@
+import { SmoothStepEdge } from "@xyflow/react";
+import { InputNode, NumericInputNode, OutputNode, LogicGateNode, ConsoleNode, ScreenNode, RasterDisplayNode, RegisterNode, RAMNode, ROMNode, UartTxNode, NicFifoNode, RV32IInstrMemNode, EthFrameInputNode, } from "../nodes";
+/**
+ * Default node type map — all rich components, no fallbacks.
+ */
+export const NODE_TYPES = {
+    inputNode: InputNode,
+    numericInputNode: NumericInputNode,
+    outputNode: OutputNode,
+    logicGateNode: LogicGateNode,
+    registerNode: RegisterNode,
+    ramNode: RAMNode,
+    romNode: ROMNode,
+    rv32iInstrMemNode: RV32IInstrMemNode,
+    ethFrameInputNode: EthFrameInputNode,
+    consoleNode: ConsoleNode,
+    uartTxNode: UartTxNode,
+    nicFifoNode: NicFifoNode,
+    screenNode: ScreenNode,
+    rasterDisplayNode: RasterDisplayNode,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+};
+/**
+ * Edge type map.
+ */
+export const EDGE_TYPES = {
+    orthogonal: SmoothStepEdge,
+};
+//# sourceMappingURL=node-types.js.map

package/dist/canvas/node-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-types.js","sourceRoot":"","sources":["../../src/canvas/node-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkC,MAAM,eAAe,CAAC;AAE/E,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,OAAO,EACP,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAc;IACnC,SAAS,EAAE,SAAS;IACpB,gBAAgB,EAAE,gBAAgB;IAClC,UAAU,EAAE,UAAU;IACtB,aAAa,EAAE,aAAa;IAC5B,YAAY,EAAE,YAAY;IAC1B,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,iBAAiB,EAAE,iBAAiB;IACpC,iBAAiB,EAAE,iBAAiB;IACpC,WAAW,EAAE,WAAW;IACxB,UAAU,EAAE,UAAU;IACtB,WAAW,EAAE,WAAW;IACxB,UAAU,EAAE,UAAU;IACtB,iBAAiB,EAAE,iBAAiB;IACpC,8DAA8D;CACxD,CAAC;AAET;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAc;IACnC,UAAU,EAAE,cAAc;CAC3B,CAAC"}

package/dist/canvas/projection.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure projection utility for embed.
+ * Converts Circuit + Metadata into ReactFlow nodes and edges.
+ * No stores, no caches, no globals — explicit params only.
+ */
+import type { Node as ReactFlowNode, Edge } from '@xyflow/react';
+import type { Circuit } from '@simten/core';
+import type { CircuitLibrary, FlatPortValueMap, FlatSequentialState } from '@simten/core/simulator';
+import type { MetadataState } from './types';
+import type { NodeData } from '../nodes';
+export type { NodeData };
+/**
+ * Main projection function — pure, no side effects.
+ */
+export declare function projectCircuitToReactFlow(circuit: Circuit | null, metadata: MetadataState, library: CircuitLibrary, portValues?: FlatPortValueMap, seqState?: FlatSequentialState): {
+    nodes: ReactFlowNode<NodeData>[];
+    edges: Edge[];
+};
+//# sourceMappingURL=projection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/canvas/projection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,aAAa,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,YAAY,EAAE,QAAQ,EAAE,CAAC;AA+TzB;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,GAAG,IAAI,EACvB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,gBAAgB,EAC7B,QAAQ,CAAC,EAAE,mBAAmB;;;EAQ/B"}