@simten/ui 0.1.1

package/dist/primitives/tooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.js","sourceRoot":"","sources":["../../src/primitives/tooltip.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEtD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC,SAAS,eAAe,CAAC,EACvB,aAAa,GAAG,CAAC,EACjB,GAAG,KAAK,EAC+C;IACvD,OAAO,CACL,KAAC,gBAAgB,CAAC,QAAQ,iBACd,kBAAkB,EAC5B,aAAa,EAAE,aAAa,KACxB,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,OAAO,CAAC,EACf,GAAG,KAAK,EAC2C;IACnD,OAAO,KAAC,gBAAgB,CAAC,IAAI,iBAAW,SAAS,KAAK,KAAK,GAAI,CAAA;AACjE,CAAC;AAED,SAAS,cAAc,CAAC,EACtB,GAAG,KAAK,EAC8C;IACtD,OAAO,KAAC,gBAAgB,CAAC,OAAO,iBAAW,iBAAiB,KAAK,KAAK,GAAI,CAAA;AAC5E,CAAC;AAED,SAAS,cAAc,CAAC,EACtB,SAAS,EACT,UAAU,GAAG,CAAC,EACd,QAAQ,EACR,GAAG,KAAK,EAC8C;IACtD,OAAO,CACL,KAAC,gBAAgB,CAAC,MAAM,cACtB,MAAC,gBAAgB,CAAC,OAAO,iBACb,iBAAiB,EAC3B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,EAAE,CACX,maAAma,EACna,SAAS,CACV,KACG,KAAK,aAER,QAAQ,EACT,KAAC,gBAAgB,CAAC,KAAK,IAAC,SAAS,EAAC,oGAAoG,GAAG,IAChH,GACH,CAC3B,CAAA;AACH,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,CAAA"}

package/dist/sandbox/SandboxProvider.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SandboxProvider — singleton sandbox context
+ *
+ * Wraps the app so all consumers share a single hidden iframe.
+ * Use `useSandboxContext()` to get the SandboxHandle.
+ */
+import { type ReactNode } from 'react';
+import { type SandboxHandle } from './useSandbox.js';
+export declare function SandboxProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useSandboxContext(): SandboxHandle;
+//# sourceMappingURL=SandboxProvider.d.ts.map

package/dist/sandbox/SandboxProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxProvider.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxProvider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIjE,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAOpE;AAmBD,wBAAgB,iBAAiB,IAAI,aAAa,CAEjD"}

package/dist/sandbox/SandboxProvider.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * SandboxProvider — singleton sandbox context
+ *
+ * Wraps the app so all consumers share a single hidden iframe.
+ * Use `useSandboxContext()` to get the SandboxHandle.
+ */
+import { createContext, useContext } from 'react';
+import { useSandbox } from './useSandbox.js';
+const SandboxContext = createContext(null);
+export function SandboxProvider({ children }) {
+    const sandbox = useSandbox();
+    return (_jsx(SandboxContext.Provider, { value: sandbox, children: children }));
+}
+// No-op handle returned before the sandbox iframe is ready (SSR / pre-mount)
+const NULL_HANDLE = {
+    compile: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    compileIR: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    tick: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    tickN: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    scanPort: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    simulate: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    reset: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    setNode: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    snapshot: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    restore: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    pruneSnapshots: async () => ({ type: 'error', error: 'Sandbox not ready' }),
+    dispose: async () => { },
+    isReady: () => false,
+};
+export function useSandboxContext() {
+    return useContext(SandboxContext) ?? NULL_HANDLE;
+}
+//# sourceMappingURL=SandboxProvider.js.map

package/dist/sandbox/SandboxProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxProvider.js","sourceRoot":"","sources":["../../src/sandbox/SandboxProvider.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,UAAU,EAAsB,MAAM,iBAAiB,CAAC;AAEjE,MAAM,cAAc,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAC;AAEjE,MAAM,UAAU,eAAe,CAAC,EAAE,QAAQ,EAA2B;IACnE,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,OAAO,CACL,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YACpC,QAAQ,GACe,CAC3B,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,WAAW,GAAkB;IACjC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACpE,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACtE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACjE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAClE,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACrE,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACrE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAClE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACpE,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACrE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACpE,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC3E,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;IACvB,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;CACrB,CAAC;AAEF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,cAAc,CAAC,IAAI,WAAW,CAAC;AACnD,CAAC"}

package/dist/sandbox/index.d.ts

@@ -0,0 +1,4 @@
+export { useSandbox } from './useSandbox.js';
+export { SandboxProvider, useSandboxContext } from './SandboxProvider.js';
+export type { SandboxHandle, CompileResult, CompileIRResult, TickResult, SimulateResult, ResetResult, SetNodeResult, SandboxError, EvalSource, SimSlot, } from './useSandbox.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,OAAO,GACR,MAAM,iBAAiB,CAAC"}

package/dist/sandbox/index.js

@@ -0,0 +1,3 @@
+export { useSandbox } from './useSandbox.js';
+export { SandboxProvider, useSandboxContext } from './SandboxProvider.js';
+//# sourceMappingURL=index.js.map

package/dist/sandbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/sandbox/useSandbox.d.ts

@@ -0,0 +1,197 @@
+/**
+ * useSandbox — iframe execution sandbox manager (HOST side of the bridge).
+ *
+ * The iframe-side counterpart lives at `apps/sandbox/src/main.ts`. Most
+ * consumers should NOT call this directly — use `useCircuitSimulator` from
+ * `@simten/embed`, which composes this transport with circuit-level concerns.
+ * See `apps/web/content/docs/architecture.mdx` → "Runtime topology".
+ *
+ * Creates and manages a hidden iframe at SANDBOX_ORIGIN with
+ * sandbox="allow-scripts". All circuit compilation and simulation
+ * runs inside the sandbox — never in the main frame.
+ *
+ * Security guarantees:
+ *   - Separate origin → browser enforces isolation (no access to
+ *     main-frame cookies, localStorage, or DOM)
+ *   - sandbox="allow-scripts" blocks ALL network at the browser
+ *     kernel level (no fetch, XHR, WebSocket possible)
+ *   - postMessage boundary: only plain JSON crosses. No functions,
+ *     no Maps, no class instances.
+ *   - Infinite loops: 5s timeout kills and recreates the iframe;
+ *     main UI is unaffected.
+ *
+ * Usage:
+ *   const sandbox = useSandbox();
+ *   const result = await sandbox.compile(source);
+ *   const tick = await sandbox.tick({ a: true });
+ */
+import type { Circuit } from '@simten/core';
+import type { RLEValue } from '@simten/core/api';
+/**
+ * State of nodes on a peripheral's bus — exposed across the sandbox boundary
+ * so the UI can render displays, consoles, NIC FIFOs, etc.
+ *
+ * Values are whatever the simulator stores for each node: number | boolean |
+ * Map<number, number> | string. The sandbox only snapshots state for nodes
+ * tagged (via circuit `meta.synthesizable: false`) or wired directly to such
+ * a node — the sim analog of memory-mapped I/O.
+ */
+export type PeripheralState = Record<string, unknown>;
+export interface CompileResult {
+    circuits: Circuit[];
+    libraryCircuits: Circuit[];
+    portValues: Record<string, number | boolean>;
+    peripheralState?: PeripheralState;
+}
+export interface TickResult {
+    portValues: Record<string, number | boolean>;
+    cycle: number;
+    peripheralState?: PeripheralState;
+    /** Snapshot id returned when the tick was requested with `{ snapshot: true }`. */
+    snapshotId?: number;
+}
+export interface SimulateResult {
+    circuitName: string;
+    signals: Record<string, RLEValue[]>;
+    vcd: string;
+    ticks: number;
+    steadyStateAt?: number;
+}
+export interface ResetResult {
+    portValues: Record<string, number | boolean>;
+    peripheralState?: PeripheralState;
+}
+export interface SetNodeResult {
+    portValues: Record<string, number | boolean>;
+    peripheralState?: PeripheralState;
+    /** Snapshot id returned when `{ snapshot: true }` was passed. */
+    snapshotId?: number;
+}
+export interface SnapshotResult {
+    /** Undefined for combinational-only circuits (nothing to snapshot). */
+    snapshotId?: number;
+}
+export interface RestoreResult {
+    portValues: Record<string, number | boolean>;
+    cycle: number;
+    peripheralState?: PeripheralState;
+}
+export interface SandboxError {
+    type: 'error';
+    error: string;
+}
+export type SandboxResult = ({
+    type: 'compiled';
+} & CompileResult) | ({
+    type: 'compiled-ir';
+} & {
+    portValues: Record<string, number | boolean>;
+    peripheralState?: PeripheralState;
+    snapshotId?: number;
+}) | ({
+    type: 'ticked';
+} & TickResult) | ({
+    type: 'ticked-n';
+} & TickResult) | ({
+    type: 'scanned-port';
+} & {
+    values: number[];
+}) | ({
+    type: 'simulated';
+} & SimulateResult) | ({
+    type: 'reset';
+} & ResetResult) | ({
+    type: 'set-node';
+} & SetNodeResult) | ({
+    type: 'snapshot';
+} & SnapshotResult) | ({
+    type: 'restored';
+} & RestoreResult) | ({
+    type: 'pruned';
+} & {}) | ({
+    type: 'disposed';
+} & {}) | ({
+    type: 'error';
+} & SandboxError);
+export interface CompileIRResult {
+    portValues: Record<string, number | boolean>;
+    peripheralState?: PeripheralState;
+    /** Snapshot of the initial state, returned when `{ snapshot: true }` was requested. */
+    snapshotId?: number;
+}
+/** Serialized eval entry used to transfer eval functions to the sandbox */
+export interface EvalSource {
+    evalSource: string;
+    onTickSource?: string;
+    inputNames: string[];
+    outputNames: string[];
+    stateKeys?: string[];
+}
+/** Slot IDs are arbitrary strings — use any unique identifier per simulation context. */
+export type SimSlot = string;
+export interface SandboxHandle {
+    compile(source: string, slot?: SimSlot): Promise<CompileResult | SandboxError>;
+    /**
+     * Compile from Circuit IR (e.g. auto-harnessed circuit).
+     * Optional evalSources map transfers eval functions from the caller's context.
+     * If omitted, inherits eval functions from any previously-compiled slot.
+     * Pass `{ snapshot: true }` to capture the initial state for time-travel.
+     */
+    compileIR(circuit: any, libraryCircuits: any[], slot: SimSlot, options?: {
+        evalSources?: Record<string, EvalSource>;
+        snapshot?: boolean;
+    }): Promise<CompileIRResult | SandboxError>;
+    /** Pass `{ snapshot: true }` to also capture a post-tick snapshot for time-travel. */
+    tick(inputs?: Record<string, number | boolean>, slot?: SimSlot, options?: {
+        snapshot?: boolean;
+    }): Promise<TickResult | SandboxError>;
+    /**
+     * Advance the simulator by N ticks in a single round-trip. Returns final
+     * port values + one peripheral-state snapshot. Use for demos that need
+     * many ticks per frame (raster displays, batched compute).
+     * Pass `{ snapshot: true }` to capture a post-tickN snapshot.
+     */
+    tickN(n: number, inputs?: Record<string, number | boolean>, slot?: SimSlot, options?: {
+        snapshot?: boolean;
+    }): Promise<TickResult | SandboxError>;
+    /**
+     * Combinationally scan a debug address input across 0..count-1, sampling
+     * a value output port after each setting. Returns the array in one
+     * round-trip. Clock is NOT advanced. Models JTAG-style halted-mode reads.
+     */
+    scanPort(addrNodeId: string, valuePortKey: string, count: number, slot?: SimSlot): Promise<{
+        values: number[];
+    } | SandboxError>;
+    simulate(params: {
+        source?: string;
+        ticks: number;
+        inputs?: Record<string, number | boolean>;
+        memoryData?: Record<string, Record<string, number>>;
+        slot?: SimSlot;
+    }): Promise<SimulateResult | SandboxError>;
+    reset(slot?: SimSlot): Promise<ResetResult | SandboxError>;
+    setNode(nodeId: string, value: number | boolean | Map<number, number>, slot?: SimSlot, options?: {
+        snapshot?: boolean;
+    }): Promise<SetNodeResult | SandboxError>;
+    /**
+     * Take a snapshot of the current simulator state. Returns an opaque
+     * snapshotId the host can later pass to `restore()`. For combinational-only
+     * circuits returns `{ snapshotId: undefined }` — nothing to save.
+     */
+    snapshot(slot?: SimSlot): Promise<SnapshotResult | SandboxError>;
+    /** Restore the simulator to a previously-captured snapshot. */
+    restore(snapshotId: number, slot?: SimSlot): Promise<RestoreResult | SandboxError>;
+    /**
+     * Drop all snapshots with id <= keepAfterId. Called by the host when its
+     * local history cap is exceeded, so old snapshots get garbage-collected
+     * inside the sandbox. Silently succeeds if the slot has no snapshots.
+     */
+    pruneSnapshots(keepAfterId: number, slot?: SimSlot): Promise<{
+        type: 'pruned';
+    } | SandboxError>;
+    /** Free a slot's simulator + library when no longer needed (e.g. embed unmount). */
+    dispose(slot: SimSlot): Promise<void>;
+    isReady(): boolean;
+}
+export declare function useSandbox(): SandboxHandle;
+//# sourceMappingURL=useSandbox.d.ts.map

package/dist/sandbox/useSandbox.d.ts.map

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

package/dist/sandbox/useSandbox.js

@@ -0,0 +1,250 @@
+/**
+ * useSandbox — iframe execution sandbox manager (HOST side of the bridge).
+ *
+ * The iframe-side counterpart lives at `apps/sandbox/src/main.ts`. Most
+ * consumers should NOT call this directly — use `useCircuitSimulator` from
+ * `@simten/embed`, which composes this transport with circuit-level concerns.
+ * See `apps/web/content/docs/architecture.mdx` → "Runtime topology".
+ *
+ * Creates and manages a hidden iframe at SANDBOX_ORIGIN with
+ * sandbox="allow-scripts". All circuit compilation and simulation
+ * runs inside the sandbox — never in the main frame.
+ *
+ * Security guarantees:
+ *   - Separate origin → browser enforces isolation (no access to
+ *     main-frame cookies, localStorage, or DOM)
+ *   - sandbox="allow-scripts" blocks ALL network at the browser
+ *     kernel level (no fetch, XHR, WebSocket possible)
+ *   - postMessage boundary: only plain JSON crosses. No functions,
+ *     no Maps, no class instances.
+ *   - Infinite loops: 5s timeout kills and recreates the iframe;
+ *     main UI is unaffected.
+ *
+ * Usage:
+ *   const sandbox = useSandbox();
+ *   const result = await sandbox.compile(source);
+ *   const tick = await sandbox.tick({ a: true });
+ */
+import { useRef, useEffect, useCallback } from 'react';
+// ============================================================================
+// Config
+// ============================================================================
+// Sandbox origin: defaults work for normal dev (localhost:3002) and production
+// (sandbox.simten.dev). VITE_SANDBOX_ORIGIN is an optional escape hatch for
+// unusual setups (e.g. pointing local dev at a staging sandbox).
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const env = typeof import.meta !== 'undefined' ? import.meta.env : undefined;
+const SANDBOX_ORIGIN = env?.VITE_SANDBOX_ORIGIN
+    || (env?.PROD ? 'https://sandbox.simten.dev' : 'http://localhost:3002');
+function createIframe(state, container, handleMessage, onCrash) {
+    // Remove old iframe if any
+    if (state.iframe) {
+        state.iframe.remove();
+        state.iframe = null;
+        state.ready = false;
+    }
+    const iframe = document.createElement('iframe');
+    iframe.src = SANDBOX_ORIGIN;
+    // allow-same-origin: keeps iframe's declared origin (sandbox.simten.dev / localhost:3002)
+    // so the browser can load scripts and Vite dev server works.
+    // Origin isolation still holds: the main app (simten.dev / localhost:3001) is a
+    // different origin, so the iframe cannot access the main app's cookies or localStorage.
+    iframe.setAttribute('sandbox', 'allow-scripts allow-same-origin');
+    iframe.style.cssText = 'display:none;width:0;height:0;position:absolute;';
+    iframe.setAttribute('aria-hidden', 'true');
+    // Recover from catastrophic iframe crash (e.g. OOM, failed load)
+    iframe.onerror = onCrash;
+    container.appendChild(iframe);
+    state.iframe = iframe;
+    state.ready = false;
+    window.addEventListener('message', handleMessage);
+    return iframe;
+}
+function nextId(state) {
+    return `sb-${++state.idCounter}`;
+}
+export function useSandbox() {
+    const stateRef = useRef({
+        iframe: null,
+        ready: false,
+        pending: new Map(),
+        readyQueue: [],
+        idCounter: 0,
+    });
+    // Container div injected into document body (avoids React tree)
+    const containerRef = useRef(null);
+    const handleMessageRef = useRef(() => { });
+    const recreateIframe = useCallback(() => {
+        const state = stateRef.current;
+        const container = containerRef.current;
+        if (!container)
+            return;
+        // Fail all pending promises — sandbox crashed, no response coming
+        for (const [, resolve] of state.pending) {
+            resolve({ type: 'error', error: 'Sandbox restarted (crash)' });
+        }
+        state.pending.clear();
+        state.readyQueue = [];
+        window.removeEventListener('message', handleMessageRef.current);
+        createIframe(state, container, handleMessageRef.current, recreateIframeRef.current);
+    }, []);
+    const handleMessage = useCallback((event) => {
+        if (event.origin !== SANDBOX_ORIGIN)
+            return;
+        const state = stateRef.current;
+        const data = event.data;
+        if (data.type === 'ready') {
+            state.ready = true;
+            // Flush queued sends
+            for (const fn of state.readyQueue)
+                fn();
+            state.readyQueue = [];
+            return;
+        }
+        if (!data.id)
+            return;
+        const resolve = state.pending.get(data.id);
+        if (!resolve)
+            return;
+        state.pending.delete(data.id);
+        resolve(data);
+    }, []);
+    // Keep refs in sync
+    handleMessageRef.current = handleMessage;
+    const recreateIframeRef = useRef(recreateIframe);
+    recreateIframeRef.current = recreateIframe;
+    useEffect(() => {
+        const container = document.createElement('div');
+        container.style.cssText = 'position:absolute;left:-9999px;top:-9999px;';
+        document.body.appendChild(container);
+        containerRef.current = container;
+        const state = stateRef.current;
+        createIframe(state, container, handleMessage, recreateIframe);
+        return () => {
+            window.removeEventListener('message', handleMessage);
+            container.remove();
+            containerRef.current = null;
+        };
+    }, [handleMessage]);
+    // No timeout here — the sandbox's own 5s worker timeout always sends back an
+    // error response if user code hangs. recreateIframe() is only called by the
+    // iframe's onerror handler (catastrophic crash, failed load, OOM).
+    const send = useCallback((message) => {
+        return new Promise((resolve) => {
+            const state = stateRef.current;
+            const id = nextId(state);
+            const msgWithId = { ...message, id };
+            state.pending.set(id, resolve);
+            const doSend = () => {
+                const iframe = state.iframe;
+                if (!iframe?.contentWindow) {
+                    state.pending.delete(id);
+                    resolve({ type: 'error', error: 'Sandbox iframe not available' });
+                    return;
+                }
+                iframe.contentWindow.postMessage(msgWithId, SANDBOX_ORIGIN);
+            };
+            if (state.ready) {
+                doSend();
+            }
+            else {
+                state.readyQueue.push(doSend);
+            }
+        });
+    }, []);
+    const compile = useCallback(async (source, slot = 'default') => {
+        const result = await send({ type: 'compile', source, slot });
+        if ('error' in result)
+            return result;
+        const r = result;
+        return { circuits: r.circuits, libraryCircuits: r.libraryCircuits, portValues: r.portValues, peripheralState: r.peripheralState };
+    }, [send]);
+    const compileIR = useCallback(async (circuit, libraryCircuits, slot, options) => {
+        const result = await send({
+            type: 'compile-ir',
+            circuit,
+            libraryCircuits,
+            slot,
+            evalSources: options?.evalSources,
+            snapshot: options?.snapshot,
+        });
+        if ('error' in result)
+            return result;
+        const r = result;
+        return { portValues: r.portValues, peripheralState: r.peripheralState, snapshotId: r.snapshotId };
+    }, [send]);
+    const tick = useCallback(async (inputs, slot = 'default', options) => {
+        const result = await send({ type: 'tick', inputs, slot, snapshot: options?.snapshot });
+        if ('error' in result)
+            return result;
+        const r = result;
+        return { portValues: r.portValues, cycle: r.cycle, peripheralState: r.peripheralState, snapshotId: r.snapshotId };
+    }, [send]);
+    const tickN = useCallback(async (n, inputs, slot = 'default', options) => {
+        const result = await send({ type: 'tick-n', n, inputs, slot, snapshot: options?.snapshot });
+        if ('error' in result)
+            return result;
+        const r = result;
+        return { portValues: r.portValues, cycle: r.cycle, peripheralState: r.peripheralState, snapshotId: r.snapshotId };
+    }, [send]);
+    const scanPort = useCallback(async (addrNodeId, valuePortKey, count, slot = 'default') => {
+        const result = await send({ type: 'scan-port', addrNodeId, valuePortKey, count, slot });
+        if ('error' in result)
+            return result;
+        const r = result;
+        return { values: r.values };
+    }, [send]);
+    const simulate = useCallback(async (params) => {
+        const result = await send({ type: 'simulate', ...params });
+        if ('error' in result)
+            return result;
+        const r = result;
+        return {
+            circuitName: r.circuitName,
+            signals: r.signals,
+            vcd: r.vcd,
+            ticks: r.ticks,
+            steadyStateAt: r.steadyStateAt,
+        };
+    }, [send]);
+    const reset = useCallback(async (slot = 'default') => {
+        const result = await send({ type: 'reset', slot });
+        if ('error' in result)
+            return result;
+        const r = result;
+        return { portValues: r.portValues, peripheralState: r.peripheralState };
+    }, [send]);
+    const setNode = useCallback(async (nodeId, value, slot = 'default', options) => {
+        const result = await send({ type: 'set-node', nodeId, value, slot, snapshot: options?.snapshot });
+        if ('error' in result)
+            return result;
+        const r = result;
+        return { portValues: r.portValues, peripheralState: r.peripheralState, snapshotId: r.snapshotId };
+    }, [send]);
+    const snapshot = useCallback(async (slot = 'default') => {
+        const result = await send({ type: 'snapshot', slot });
+        if ('error' in result)
+            return result;
+        const r = result;
+        return { snapshotId: r.snapshotId };
+    }, [send]);
+    const restore = useCallback(async (snapshotId, slot = 'default') => {
+        const result = await send({ type: 'restore', snapshotId, slot });
+        if ('error' in result)
+            return result;
+        const r = result;
+        return { portValues: r.portValues, cycle: r.cycle, peripheralState: r.peripheralState };
+    }, [send]);
+    const pruneSnapshots = useCallback(async (keepAfterId, slot = 'default') => {
+        const result = await send({ type: 'prune-snapshots', keepAfterId, slot });
+        if ('error' in result)
+            return result;
+        return result;
+    }, [send]);
+    const dispose = useCallback(async (slot) => {
+        await send({ type: 'dispose', slot });
+    }, [send]);
+    const isReady = useCallback(() => stateRef.current.ready, []);
+    return { compile, compileIR, tick, tickN, scanPort, simulate, reset, setNode, snapshot, restore, pruneSnapshots, dispose, isReady };
+}
+//# sourceMappingURL=useSandbox.js.map

package/dist/sandbox/useSandbox.js.map

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

package/dist/share/encode-source.d.ts

@@ -0,0 +1,13 @@
+export declare const INLINE_URL_THRESHOLD = 4000;
+export declare function encodeSourceForUrl(source: string): string;
+export declare function decodeSourceFromUrl(encoded: string): string | null;
+export declare function shouldUseShortLink(encoded: string): boolean;
+/**
+ * 10 bytes (80 bits) of SHA-256, hex-encoded → 20-char key.
+ *
+ * Content-addressed: identical sources collapse to one key, so re-sharing
+ * the same circuit is idempotent and `put` is a safe overwrite-with-same-value.
+ * Birthday collisions are actuarially impossible at any plausible scale.
+ */
+export declare function hashSource(source: string): Promise<string>;
+//# sourceMappingURL=encode-source.d.ts.map

package/dist/share/encode-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-source.d.ts","sourceRoot":"","sources":["../../src/share/encode-source.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMhE"}

package/dist/share/encode-source.js

@@ -0,0 +1,31 @@
+import { compressToEncodedURIComponent, decompressFromEncodedURIComponent, } from "lz-string";
+export const INLINE_URL_THRESHOLD = 4000;
+export function encodeSourceForUrl(source) {
+    return compressToEncodedURIComponent(source);
+}
+export function decodeSourceFromUrl(encoded) {
+    try {
+        return decompressFromEncodedURIComponent(encoded) || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function shouldUseShortLink(encoded) {
+    return encoded.length > INLINE_URL_THRESHOLD;
+}
+/**
+ * 10 bytes (80 bits) of SHA-256, hex-encoded → 20-char key.
+ *
+ * Content-addressed: identical sources collapse to one key, so re-sharing
+ * the same circuit is idempotent and `put` is a safe overwrite-with-same-value.
+ * Birthday collisions are actuarially impossible at any plausible scale.
+ */
+export async function hashSource(source) {
+    const buf = new TextEncoder().encode(source);
+    const digest = await crypto.subtle.digest("SHA-256", buf);
+    return Array.from(new Uint8Array(digest).slice(0, 10))
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}
+//# sourceMappingURL=encode-source.js.map

package/dist/share/encode-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-source.js","sourceRoot":"","sources":["../../src/share/encode-source.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,WAAW,CAAC;AAEnB,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,6BAA6B,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,IAAI,CAAC;QACH,OAAO,iCAAiC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,OAAO,CAAC,MAAM,GAAG,oBAAoB,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc;IAC7C,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;SACnD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/share/index.d.ts

@@ -0,0 +1,2 @@
+export { INLINE_URL_THRESHOLD, encodeSourceForUrl, decodeSourceFromUrl, shouldUseShortLink, hashSource, } from "./encode-source.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/share/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,GACX,MAAM,oBAAoB,CAAC"}

package/dist/share/index.js

@@ -0,0 +1,2 @@
+export { INLINE_URL_THRESHOLD, encodeSourceForUrl, decodeSourceFromUrl, shouldUseShortLink, hashSource, } from "./encode-source.js";
+//# sourceMappingURL=index.js.map

package/dist/share/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/share/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,GACX,MAAM,oBAAoB,CAAC"}