@simten/embed 0.1.1

package/dist/components/ErrorBoundary.d.ts

@@ -0,0 +1,23 @@
+import React, { type ErrorInfo, type ReactNode } from "react";
+interface ErrorBoundaryProps {
+    children: ReactNode;
+    fallback?: ReactNode | ((error: Error) => ReactNode);
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+    title?: string;
+}
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+/**
+ * React error boundary for circuit embed components.
+ * Catches render errors and displays a styled fallback instead of crashing.
+ */
+export declare class ErrorBoundary extends React.Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    handleRetry: () => void;
+    render(): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+export {};
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/dist/components/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/components/ErrorBoundary.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG9D,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK,CAAC,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;gBAC5E,KAAK,EAAE,kBAAkB;IAKrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS;IAIpD,WAAW,aAET;IAEF,MAAM;CAiBP"}

package/dist/components/ErrorBoundary.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { ErrorDisplay } from "./ErrorDisplay";
+/**
+ * React error boundary for circuit embed components.
+ * Catches render errors and displays a styled fallback instead of crashing.
+ */
+export class ErrorBoundary extends React.Component {
+    constructor(props) {
+        super(props);
+        this.state = { error: null };
+    }
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    componentDidCatch(error, errorInfo) {
+        this.props.onError?.(error, errorInfo);
+    }
+    handleRetry = () => {
+        this.setState({ error: null });
+    };
+    render() {
+        if (this.state.error) {
+            if (this.props.fallback) {
+                return typeof this.props.fallback === "function"
+                    ? this.props.fallback(this.state.error)
+                    : this.props.fallback;
+            }
+            return (_jsx(ErrorDisplay, { error: this.state.error.message, title: this.props.title ?? "Render Error", onRetry: this.handleRetry }));
+        }
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=ErrorBoundary.js.map

package/dist/components/ErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../../src/components/ErrorBoundary.tsx"],"names":[],"mappings":";AACA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAa9C;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK,CAAC,SAAiD;IACxF,YAAY,KAAyB;QACnC,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,wBAAwB,CAAC,KAAY;QAC1C,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,iBAAiB,CAAC,KAAY,EAAE,SAAoB;QAClD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,GAAG,GAAG,EAAE;QACjB,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACxB,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU;oBAC9C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;oBACvC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC1B,CAAC;YACD,OAAO,CACL,KAAC,YAAY,IACX,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,cAAc,EACzC,OAAO,EAAE,IAAI,CAAC,WAAW,GACzB,CACH,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/components/ErrorDisplay.d.ts

@@ -0,0 +1,18 @@
+export interface SimulatorError {
+    message: string;
+    line?: number;
+    column?: number;
+    stage: "parse" | "compile" | "elaborate" | "simulate";
+}
+interface ErrorDisplayProps {
+    error: string | SimulatorError | SimulatorError[];
+    title?: string;
+    onRetry?: () => void;
+}
+/**
+ * Styled error display for circuit embed components.
+ * Renders structured error messages with optional line/column info.
+ */
+export declare function ErrorDisplay({ error, title, onRetry }: ErrorDisplayProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ErrorDisplay.d.ts.map

package/dist/components/ErrorDisplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorDisplay.d.ts","sourceRoot":"","sources":["../../src/components/ErrorDisplay.tsx"],"names":[],"mappings":"AACA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;CACvD;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,EAAE,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAgBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,KAAuB,EAAE,OAAO,EAAE,EAAE,iBAAiB,2CA8C1F"}

package/dist/components/ErrorDisplay.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function parseErrors(error) {
+    if (Array.isArray(error))
+        return error;
+    if (typeof error === "object")
+        return [error];
+    // Legacy: semicolon-joined strings from older hook versions
+    return error.split("; ").map((msg) => ({ message: msg, stage: "compile" }));
+}
+const STAGE_LABELS = {
+    parse: "Parse",
+    compile: "Compile",
+    elaborate: "Elaborate",
+    simulate: "Simulate",
+};
+/**
+ * Styled error display for circuit embed components.
+ * Renders structured error messages with optional line/column info.
+ */
+export function ErrorDisplay({ error, title = "Circuit Error", onRetry }) {
+    const errors = parseErrors(error);
+    return (_jsx("div", { className: "rounded-xl border border-red-800/40 bg-red-950/20 p-4 overflow-hidden", role: "alert", "aria-live": "assertive", children: _jsxs("div", { className: "flex items-start gap-3", children: [_jsx("div", { className: "shrink-0 mt-0.5", children: _jsx("svg", { className: "w-5 h-5 text-red-400", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", strokeWidth: 2, children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M12 9v3.75m9-.75a9 9 0 11-18 0 9 9 0 0118 0zm-9 3.75h.008v.008H12v-.008z" }) }) }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("h4", { className: "text-sm font-semibold text-red-300", children: title }), _jsx("div", { className: "mt-2 space-y-1.5", children: errors.map((err, i) => (_jsxs("div", { className: "flex items-start gap-2", children: [_jsx("span", { className: "text-[10px] font-mono text-red-400/60 bg-red-900/30 px-1.5 py-0.5 rounded shrink-0 mt-0.5", children: STAGE_LABELS[err.stage] || err.stage }), _jsxs("span", { className: "text-xs font-mono text-red-300/80 break-all", children: [err.message, err.line !== undefined && (_jsxs("span", { className: "text-red-400/50 ml-1", children: ["(line ", err.line, err.column !== undefined ? `:${err.column}` : "", ")"] }))] })] }, i))) }), onRetry && (_jsx("button", { onClick: onRetry, className: "mt-3 px-3 py-1 text-xs font-medium rounded-md bg-red-900/30 hover:bg-red-900/50 text-red-300 transition-colors", children: "Retry" }))] })] }) }));
+}
+//# sourceMappingURL=ErrorDisplay.js.map

package/dist/components/ErrorDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorDisplay.js","sourceRoot":"","sources":["../../src/components/ErrorDisplay.tsx"],"names":[],"mappings":";AAcA,SAAS,WAAW,CAAC,KAAiD;IACpE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9C,4DAA4D;IAC5D,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,SAAkB,EAAE,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,YAAY,GAA2B;IAC3C,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,eAAe,EAAE,OAAO,EAAqB;IACzF,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAElC,OAAO,CACL,cACE,SAAS,EAAC,uEAAuE,EACjF,IAAI,EAAC,OAAO,eACF,WAAW,YAErB,eAAK,SAAS,EAAC,wBAAwB,aACrC,cAAK,SAAS,EAAC,iBAAiB,YAC9B,cAAK,SAAS,EAAC,sBAAsB,EAAC,IAAI,EAAC,MAAM,EAAC,OAAO,EAAC,WAAW,EAAC,MAAM,EAAC,cAAc,EAAC,WAAW,EAAE,CAAC,YACxG,eAAM,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAC,CAAC,EAAC,0EAA0E,GAAG,GAC9H,GACF,EACN,eAAK,SAAS,EAAC,gBAAgB,aAC7B,aAAI,SAAS,EAAC,oCAAoC,YAAE,KAAK,GAAM,EAC/D,cAAK,SAAS,EAAC,kBAAkB,YAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CACtB,eAAa,SAAS,EAAC,wBAAwB,aAC7C,eAAM,SAAS,EAAC,2FAA2F,YACxG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,GAChC,EACP,gBAAM,SAAS,EAAC,6CAA6C,aAC1D,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,CACzB,gBAAM,SAAS,EAAC,sBAAsB,uBAC7B,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,SAC5D,CACR,IACI,KAXC,CAAC,CAYL,CACP,CAAC,GACE,EACL,OAAO,IAAI,CACV,iBACE,OAAO,EAAE,OAAO,EAChB,SAAS,EAAC,gHAAgH,sBAGnH,CACV,IACG,IACF,GACF,CACP,CAAC;AACJ,CAAC"}

package/dist/components/LoadingSkeleton.d.ts

@@ -0,0 +1,11 @@
+interface LoadingSkeletonProps {
+    height?: number | string;
+}
+/**
+ * Loading skeleton for circuit embeds.
+ * Shows fake node placeholders with connecting lines, matching the dark theme.
+ * Respects height to prevent layout shift.
+ */
+export declare function LoadingSkeleton({ height }: LoadingSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=LoadingSkeleton.d.ts.map

package/dist/components/LoadingSkeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingSkeleton.d.ts","sourceRoot":"","sources":["../../src/components/LoadingSkeleton.tsx"],"names":[],"mappings":"AAGA,UAAU,oBAAoB;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAY,EAAE,EAAE,oBAAoB,2CAmCrE"}

package/dist/components/LoadingSkeleton.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Loading skeleton for circuit embeds.
+ * Shows fake node placeholders with connecting lines, matching the dark theme.
+ * Respects height to prevent layout shift.
+ */
+export function LoadingSkeleton({ height = 300 }) {
+    return (_jsxs("div", { className: "rounded-xl border border-[var(--embed-border)] bg-[var(--embed-bg-primary)] overflow-hidden flex items-center justify-center", style: { height }, role: "status", "aria-label": "Loading circuit", children: [_jsxs("div", { className: "flex items-center gap-8", children: [_jsxs("div", { className: "flex flex-col gap-4", children: [_jsx("div", { className: "w-20 h-14 rounded-lg bg-[var(--embed-bg-tertiary)]/60 animate-pulse" }), _jsx("div", { className: "w-20 h-14 rounded-lg bg-[var(--embed-bg-tertiary)]/60 animate-pulse", style: { animationDelay: "150ms" } })] }), _jsxs("div", { className: "flex flex-col gap-6 items-center", children: [_jsx("div", { className: "w-12 h-0.5 bg-[var(--embed-border)]/40 animate-pulse", style: { animationDelay: "300ms" } }), _jsx("div", { className: "w-12 h-0.5 bg-[var(--embed-border)]/40 animate-pulse", style: { animationDelay: "350ms" } })] }), _jsx("div", { className: "w-24 h-20 rounded-lg bg-[var(--embed-bg-tertiary)]/60 animate-pulse", style: { animationDelay: "200ms" } }), _jsx("div", { className: "w-12 h-0.5 bg-[var(--embed-border)]/40 animate-pulse", style: { animationDelay: "400ms" } }), _jsx("div", { className: "w-20 h-14 rounded-lg bg-[var(--embed-bg-tertiary)]/60 animate-pulse", style: { animationDelay: "250ms" } })] }), _jsx("span", { className: "sr-only", children: "Compiling and laying out circuit..." })] }));
+}
+//# sourceMappingURL=LoadingSkeleton.js.map

package/dist/components/LoadingSkeleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingSkeleton.js","sourceRoot":"","sources":["../../src/components/LoadingSkeleton.tsx"],"names":[],"mappings":";AAOA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAAE,MAAM,GAAG,GAAG,EAAwB;IACpE,OAAO,CACL,eACE,SAAS,EAAC,8HAA8H,EACxI,KAAK,EAAE,EAAE,MAAM,EAAE,EACjB,IAAI,EAAC,QAAQ,gBACF,iBAAiB,aAE5B,eAAK,SAAS,EAAC,yBAAyB,aAEtC,eAAK,SAAS,EAAC,qBAAqB,aAClC,cAAK,SAAS,EAAC,qEAAqE,GAAG,EACvF,cAAK,SAAS,EAAC,qEAAqE,EAAC,KAAK,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,GAAI,IACvH,EAGN,eAAK,SAAS,EAAC,kCAAkC,aAC/C,cAAK,SAAS,EAAC,sDAAsD,EAAC,KAAK,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,GAAI,EAC5G,cAAK,SAAS,EAAC,sDAAsD,EAAC,KAAK,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,GAAI,IACxG,EAGN,cAAK,SAAS,EAAC,qEAAqE,EAAC,KAAK,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,GAAI,EAG3H,cAAK,SAAS,EAAC,sDAAsD,EAAC,KAAK,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,GAAI,EAG5G,cAAK,SAAS,EAAC,qEAAqE,EAAC,KAAK,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,GAAI,IACvH,EAGN,eAAM,SAAS,EAAC,SAAS,oDAA2C,IAChE,CACP,CAAC;AACJ,CAAC"}

package/dist/components/nodes/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-export canonical node components from @simten/ui/nodes.
+ * This allows external consumers to import from @simten/embed/nodes
+ * while the source of truth lives in the ui package.
+ */
+export { BaseNode, type PortConfig, type BaseNodeProps, InputNode, OutputNode, LogicGateNode, EmbedConsoleNode, EmbedScreenNode, CompositeBadge, type NodeData, } from "@simten/ui/nodes";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/nodes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/nodes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,SAAS,EACT,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,KAAK,QAAQ,GACd,MAAM,kBAAkB,CAAC"}

package/dist/components/nodes/index.js

@@ -0,0 +1,7 @@
+/**
+ * Re-export canonical node components from @simten/ui/nodes.
+ * This allows external consumers to import from @simten/embed/nodes
+ * while the source of truth lives in the ui package.
+ */
+export { BaseNode, InputNode, OutputNode, LogicGateNode, EmbedConsoleNode, EmbedScreenNode, CompositeBadge, } from "@simten/ui/nodes";
+//# sourceMappingURL=index.js.map

package/dist/components/nodes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/nodes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,QAAQ,EAGR,SAAS,EACT,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,GAEf,MAAM,kBAAkB,CAAC"}

package/dist/hooks/useCircuitSimulator.d.ts

@@ -0,0 +1,95 @@
+/**
+ * useCircuitSimulator — the public circuit-simulation hook.
+ *
+ * Composes the sandbox bridge (`useSandbox` in @simten/ui) with circuit-level
+ * concerns: auto-harness, time-travel history, auto-run, snapshot/restore.
+ * This is what every embed/blog/editor consumer calls.
+ *
+ * Runtime topology (browser path):
+ *   useCircuitSimulator (here)
+ *     → useSandbox             — packages/ui/src/sandbox/useSandbox.ts (postMessage bridge)
+ *     → apps/sandbox/main.ts   — runs inside the cross-origin iframe
+ *     → core/simulator         — pure simulator engine
+ *
+ * For non-browser callers (vitest, CI), skip this hook entirely and use
+ * `@simten/core/sim` directly — no iframe, no React, just the engine.
+ *
+ * See: apps/web/content/docs/architecture.mdx → "Runtime topology".
+ */
+import { type SimulatorEngine, type CircuitLibrary, type FlatPortValueMap, type FlatSequentialState } from "@simten/core/simulator";
+import type { Circuit } from "@simten/core";
+import type { BuiltCircuit } from "@simten/core/circuit";
+export interface SimulatorState {
+    outputs: Record<string, boolean | number>;
+    inputs: Record<string, boolean | number>;
+    cycleCount: number;
+    ready: boolean;
+    error: string | null;
+    isSequential: boolean;
+    circuit: Circuit | null;
+    portValues: FlatPortValueMap | null;
+    sequentialState: FlatSequentialState | null;
+    componentLibrary: CircuitLibrary | null;
+    history: readonly {
+        engineSnapshot: unknown;
+        metadata?: unknown;
+    }[];
+    historyIndex: number;
+    isViewingPast: boolean;
+    isRunning: boolean;
+    speed: number;
+}
+export interface SimulatorActions {
+    setNode: (name: string, value: boolean | number) => void;
+    toggleInput: (name: string) => void;
+    toggleNode: (nodeId: string) => void;
+    /**
+     * Set a node's value. Returns the resulting port-value Map (so scan-style
+     * callers can read debug outputs without waiting for a React re-render),
+     * or null if the sandbox isn't ready / errored.
+     */
+    setNodeValue: (nodeId: string, value: number | boolean | Map<number, number>) => Promise<ReadonlyMap<string, boolean | number> | null>;
+    tick: () => void;
+    /** Advance N ticks in a single sandbox round-trip; one React update. */
+    tickN: (n: number) => Promise<void>;
+    /**
+     * Combinationally scan a debug-address node across 0..count-1, sampling
+     * a value port after each setting. Single round-trip; clock not advanced.
+     * Returns the `number[]` of length `count`, or null on error.
+     */
+    scanPort: (addrNodeId: string, valuePortKey: string, count: number) => Promise<number[] | null>;
+    reset: () => void;
+    stepBack: () => void;
+    stepForward: () => void;
+    seek: (index: number) => void;
+    startAutoRun: (ticksPerSecond: number, options?: {
+        displayRate?: number;
+        onBeforeTick?: () => void;
+    }) => void;
+    stopAutoRun: () => void;
+    setSpeed: (ticksPerSecond: number) => void;
+    runCombinational: () => void;
+    getSimulator: () => SimulatorEngine | null;
+}
+export interface UseCircuitSimulatorOptions {
+    /** Wrap the circuit with auto-generated Switch/Led nodes */
+    autoHarness?: boolean;
+    /** Initial values for input ports (only used when autoHarness is true) */
+    initialInputs?: Record<string, number | boolean>;
+}
+/**
+ * Build a minimal BuiltCircuit-like object from a Circuit IR and its dependencies.
+ * Used by the editor to adapt sandbox compile results into the shape useCircuitSimulator expects.
+ * The resulting object has no live eval functions (empty registry lookups) — the sandbox
+ * is expected to already have the evals registered from a prior sandbox.compile(source).
+ */
+export declare function builtFromIR(circuit: Circuit, dependencies: Circuit[]): BuiltCircuit;
+/**
+ * Circuit simulator hook — runs simulation in the sandbox iframe.
+ *
+ * Takes a BuiltCircuit and returns reactive simulation state + actions.
+ * All simulation happens inside the sandbox for security (CSP-isolated,
+ * cross-origin) — no user code runs in the main frame at simulation time.
+ */
+export declare function useCircuitSimulator(circuit: BuiltCircuit | null, options?: UseCircuitSimulatorOptions): SimulatorState & SimulatorActions;
+//# sourceMappingURL=useCircuitSimulator.d.ts.map

package/dist/hooks/useCircuitSimulator.d.ts.map

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