@simten/embed 0.1.1

package/dist/CircuitViewer.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * CircuitViewer — the single "render an interactive circuit" component.
+ *
+ * Takes a BuiltCircuit, wires up simulation, and renders CircuitCanvas + ClockControls.
+ * Pure props — no stores. Everything else (CircuitEmbed, EditorWorkspace, <circuit-embed>)
+ * is a thin wrapper around this.
+ */
+import { useCallback, useEffect, useRef, forwardRef, useImperativeHandle } from "react";
+import { useCircuitSimulator } from "./hooks/useCircuitSimulator";
+import { CircuitCanvas, ClockControls, useDetectTheme } from "@simten/ui/canvas";
+const CircuitViewerImpl = forwardRef(function CircuitViewer({ circuit, height = 300, showControls = true, autoHarness = false, initialInputs, layout, theme, focus, showPortLabels, onPortClick, glowUnconnected, renderEmptyState, renderOverlay, onPortValuesChange, }, ref) {
+    const sim = useCircuitSimulator(circuit, { autoHarness, initialInputs });
+    const detectedTheme = useDetectTheme();
+    const resolvedTheme = theme ?? detectedTheme;
+    // Capture the callback in a ref so inline functions don't cause the
+    // firing effect below to re-run on every parent render. The effect
+    // depends only on [sim.ready, sim.portValues], not on the callback
+    // identity, so passing `onPortValuesChange={(pv) => setX(pv)}` is
+    // safe even though it creates a new function reference each render.
+    const onPortValuesChangeRef = useRef(onPortValuesChange);
+    useEffect(() => {
+        onPortValuesChangeRef.current = onPortValuesChange;
+    });
+    // Fire once the sim is ready and port values have first settled; then
+    // fire on every subsequent settled change. The empty-map guard avoids
+    // a spurious fire during the initial compile-but-not-yet-propagated
+    // window. The hook only exposes settled states, so no debouncing is
+    // needed for intermediate propagation steps.
+    useEffect(() => {
+        if (!sim.ready || !sim.portValues || sim.portValues.size === 0)
+            return;
+        onPortValuesChangeRef.current?.(sim.portValues);
+    }, [sim.ready, sim.portValues]);
+    const handleTick = useCallback(() => {
+        sim.tick();
+    }, [sim.tick]);
+    const handleReset = useCallback(() => {
+        sim.reset();
+    }, [sim.reset]);
+    useImperativeHandle(ref, () => ({
+        tick: handleTick,
+        reset: handleReset,
+        setNodeValue: sim.setNodeValue,
+        startAutoRun: sim.startAutoRun,
+        stopAutoRun: sim.stopAutoRun,
+    }), [handleTick, handleReset, sim.setNodeValue, sim.startAutoRun, sim.stopAutoRun]);
+    if (sim.error) {
+        return (_jsx("div", { style: { height }, className: "flex items-center justify-center p-4", children: _jsxs("div", { className: "text-sm text-red-400 bg-red-500/10 rounded p-3 border border-red-500/20", children: [_jsx("div", { className: "font-medium mb-1", children: "Compilation Error" }), _jsx("div", { className: "font-mono text-xs", children: sim.error })] }) }));
+    }
+    if (!sim.ready) {
+        return (_jsx("div", { style: { height }, className: "flex items-center justify-center text-muted-foreground/60 text-sm", children: "Compiling..." }));
+    }
+    const controlHeight = sim.isSequential && showControls ? 40 : 0;
+    const canvasHeight = typeof height === "number" ? height - controlHeight : height;
+    return (_jsxs("div", { style: { height }, className: "flex flex-col", "data-embed-theme": resolvedTheme, children: [_jsx("div", { className: "flex-1 min-h-0", children: _jsx(CircuitCanvas, { circuit: sim.circuit, componentLibrary: sim.componentLibrary ?? undefined, portValues: sim.portValues, sequentialState: sim.sequentialState, onToggleNode: sim.toggleNode, onSetNodeValue: sim.setNodeValue, onLoadMemory: (nodeId, memData) => {
+                        const engine = sim.getSimulator();
+                        if (engine) {
+                            engine.setNode(nodeId, memData);
+                            sim.runCombinational();
+                        }
+                    }, height: canvasHeight, focus: focus, showPortLabels: showPortLabels, onPortClick: onPortClick, glowUnconnected: glowUnconnected, renderEmptyState: renderEmptyState, renderOverlay: renderOverlay, ...(layout ? { layout } : {}), ...(theme ? { theme } : {}) }) }), sim.isSequential && showControls && (_jsx(ClockControls, { cycle: sim.cycleCount, historyLength: sim.history?.length ?? 0, historyIndex: sim.historyIndex ?? -1, isRunning: sim.isRunning, isViewingPast: sim.isViewingPast ?? false, onStep: handleTick, onRun: () => sim.startAutoRun(5), onPause: () => sim.stopAutoRun(), onReset: handleReset, onStepBack: () => sim.stepBack(), onStepForward: () => {
+                    if (sim.isViewingPast) {
+                        sim.stepForward();
+                    }
+                    else {
+                        handleTick();
+                    }
+                }, speed: 5 }))] }));
+});
+/**
+ * CircuitViewer with generic inference over the circuit type.
+ * Cast preserves the generic so `layout` keys are constrained at compile time.
+ */
+export const CircuitViewer = CircuitViewerImpl;
+//# sourceMappingURL=CircuitViewer.js.map

package/dist/CircuitViewer.js.map

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

package/dist/canvas/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export from @simten/ui/canvas.
+ */
+export { CircuitCanvas } from "@simten/ui/canvas";
+export type { CircuitCanvasProps } from "@simten/ui/canvas";
+//# 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;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/canvas/index.js

@@ -0,0 +1,5 @@
+/**
+ * Re-export from @simten/ui/canvas.
+ */
+export { CircuitCanvas } from "@simten/ui/canvas";
+//# 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;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}