@r-a-i-t-h/viz-host 0.1.0

package/dist/contextDeps.js

@@ -0,0 +1,394 @@
+/**
+ * Static context dependency graph: which actions / guards / invokes read or
+ * write which context keys. Built from live machine `logic` before
+ * `toPortable` strips functions.
+ */
+const CONTEXT_KEY_RE = /context\s*(?:\.\s*([A-Za-z_$][\w$]*)|\[["']([^"']+)["']\])/g;
+const COMPOUND_GUARDS = new Set(['xstate.and', 'xstate.or', 'xstate.not']);
+/** Analyze a live state machine for context key read/write dependencies. */
+export function analyzeContextDeps(logic) {
+    const machine = logic;
+    const graph = { nodes: new Map(), edges: [] };
+    const initialKeys = plainContextKeys(machine.config?.context);
+    for (const key of initialKeys) {
+        ensureContextKey(graph, key);
+    }
+    const root = machine.definition;
+    if (root) {
+        walkState(root, machine.config, machine, graph);
+    }
+    return {
+        nodes: [...graph.nodes.values()],
+        edges: graph.edges,
+    };
+}
+function walkState(node, config, machine, graph) {
+    const stateId = typeof node.id === 'string' && node.id.length > 0 ? node.id : '(unknown)';
+    analyzeActions(node.entry, config?.entry, machine, graph, {
+        stateId,
+        site: 'entry',
+    });
+    analyzeActions(node.exit, config?.exit, machine, graph, {
+        stateId,
+        site: 'exit',
+    });
+    const onKeys = new Set(Object.keys(node.on ?? {}));
+    for (const [eventType, value] of Object.entries(node.on ?? {})) {
+        const configTransitions = config?.on?.[eventType];
+        const defTransitions = asList(value);
+        const cfgTransitions = asList(configTransitions);
+        for (let i = 0; i < defTransitions.length; i++) {
+            analyzeTransition(defTransitions[i], cfgTransitions[i], machine, graph, {
+                stateId,
+                site: 'transition',
+                eventType,
+            });
+        }
+    }
+    // Eventless / always transitions live on `transitions` but not always in `on`.
+    for (const transition of node.transitions ?? []) {
+        const eventType = eventTypeOf(transition);
+        if (eventType && onKeys.has(eventType))
+            continue;
+        analyzeTransition(transition, undefined, machine, graph, {
+            stateId,
+            site: 'transition',
+            eventType,
+        });
+    }
+    const defInvokes = node.invoke ?? [];
+    const cfgInvokes = asList(config?.invoke);
+    for (let i = 0; i < defInvokes.length; i++) {
+        analyzeInvoke(defInvokes[i], cfgInvokes[i], graph, stateId);
+    }
+    for (const [key, child] of Object.entries(node.states ?? {})) {
+        walkState(child, config?.states?.[key], machine, graph);
+    }
+}
+function analyzeTransition(transition, configTransition, machine, graph, site) {
+    if (!transition || typeof transition !== 'object')
+        return;
+    const t = transition;
+    const cfg = configTransition && typeof configTransition === 'object'
+        ? configTransition
+        : undefined;
+    analyzeActions(t.actions, cfg?.actions, machine, graph, site);
+    const guard = t.guard ?? cfg?.guard;
+    if (guard != null) {
+        analyzeGuard(guard, machine, graph, site);
+    }
+}
+function analyzeInvoke(invoke, configInvoke, graph, stateId) {
+    if (!invoke || typeof invoke !== 'object')
+        return;
+    const inv = invoke;
+    const cfg = configInvoke && typeof configInvoke === 'object'
+        ? configInvoke
+        : undefined;
+    const invokeId = invokeEntityId(inv.id, inv.src, stateId);
+    const label = invokeLabel(inv.id, inv.src);
+    ensureEntity(graph, invokeId, 'invoke', label, 'opaque');
+    const site = { stateId, site: 'invoke' };
+    const input = typeof inv.input === 'function' ? inv.input : cfg?.input;
+    if (typeof input === 'function') {
+        const reads = extractContextReads(input);
+        if (reads.length > 0) {
+            bumpCoverage(graph, invokeId, 'partial');
+            for (const key of reads) {
+                addEdge(graph, invokeId, key, 'reads', site);
+            }
+        }
+    }
+    // onDone / onError actions are already present on `definition.on` with live
+    // assign functions — do not re-walk invoke.onDone/onError (would duplicate).
+}
+function analyzeActions(actions, configActions, machine, graph, site) {
+    const defList = asList(actions);
+    const cfgList = asList(configActions);
+    const len = Math.max(defList.length, cfgList.length);
+    for (let i = 0; i < len; i++) {
+        const action = preferActionBody(defList[i], cfgList[i]);
+        if (action == null)
+            continue;
+        if (isInjectedAfterAction(action))
+            continue;
+        analyzeAction(action, machine, graph, site);
+    }
+}
+/**
+ * Definition sometimes stores `{ type: 'xstate.assign' }` without `.assignment`;
+ * the authored config still has the live assign function — prefer that.
+ */
+function preferActionBody(definitionAction, configAction) {
+    if (isStrippedAssign(definitionAction) && configAction != null) {
+        return configAction;
+    }
+    return definitionAction ?? configAction;
+}
+function isStrippedAssign(action) {
+    if (!action || typeof action !== 'object')
+        return false;
+    const typed = action;
+    return typed.type === 'xstate.assign' && typed.assignment == null;
+}
+function analyzeAction(action, machine, graph, site) {
+    const resolved = resolveAction(action, machine);
+    const entityId = `action:${resolved.name}`;
+    ensureEntity(graph, entityId, 'action', resolved.name, 'opaque');
+    if (resolved.assignKeys.length > 0) {
+        bumpCoverage(graph, entityId, 'known');
+        for (const key of resolved.assignKeys) {
+            addEdge(graph, entityId, key, 'writes', site);
+        }
+    }
+    if (resolved.readKeys.length > 0) {
+        bumpCoverage(graph, entityId, 'partial');
+        for (const key of resolved.readKeys) {
+            addEdge(graph, entityId, key, 'reads', site);
+        }
+    }
+}
+function analyzeGuard(guard, machine, graph, site) {
+    for (const leaf of flattenGuard(guard)) {
+        const resolved = resolveGuard(leaf, machine);
+        const entityId = `guard:${resolved.name}`;
+        ensureEntity(graph, entityId, 'guard', resolved.name, 'opaque');
+        if (resolved.readKeys.length > 0) {
+            bumpCoverage(graph, entityId, 'partial');
+            for (const key of resolved.readKeys) {
+                addEdge(graph, entityId, key, 'reads', site);
+            }
+        }
+    }
+}
+function resolveAction(action, machine) {
+    if (typeof action === 'string') {
+        return resolveActionImpl(action, machine.implementations?.actions?.[action]);
+    }
+    if (typeof action === 'function') {
+        const typed = action;
+        const type = typeof typed.type === 'string' && typed.type.length > 0
+            ? typed.type
+            : '(inline)';
+        return inspectActionValue(type, action);
+    }
+    if (action && typeof action === 'object') {
+        const type = action.type;
+        if (typeof type === 'string' && type.length > 0) {
+            if (type === 'xstate.assign') {
+                return inspectActionValue(type, action);
+            }
+            const impl = machine.implementations?.actions?.[type];
+            if (impl !== undefined) {
+                return resolveActionImpl(type, impl);
+            }
+            return inspectActionValue(type, action);
+        }
+    }
+    return { name: '(inline)', assignKeys: [], readKeys: [] };
+}
+function resolveActionImpl(name, impl) {
+    if (impl === undefined) {
+        return { name, assignKeys: [], readKeys: [] };
+    }
+    return inspectActionValue(name, impl);
+}
+function inspectActionValue(name, value) {
+    const assignment = getAssignmentMap(value);
+    if (assignment) {
+        const assignKeys = [];
+        const readKeys = [];
+        for (const [key, expr] of Object.entries(assignment)) {
+            assignKeys.push(key);
+            if (typeof expr === 'function') {
+                readKeys.push(...extractContextReads(expr));
+            }
+        }
+        return {
+            name: name === 'xstate.assign' ? 'xstate.assign' : name,
+            assignKeys: unique(assignKeys),
+            readKeys: unique(readKeys),
+        };
+    }
+    if (typeof value === 'function') {
+        return {
+            name,
+            assignKeys: [],
+            readKeys: extractContextReads(value),
+        };
+    }
+    return { name, assignKeys: [], readKeys: [] };
+}
+/** XState `assign()` is a function (or object) with an `.assignment` map. */
+function getAssignmentMap(value) {
+    if (value == null)
+        return null;
+    if (typeof value !== 'function' && typeof value !== 'object')
+        return null;
+    const assignment = value.assignment;
+    if (!assignment || typeof assignment !== 'object' || Array.isArray(assignment)) {
+        return null;
+    }
+    return assignment;
+}
+function resolveGuard(guard, machine) {
+    if (typeof guard === 'string') {
+        const impl = machine.implementations?.guards?.[guard];
+        return {
+            name: guard,
+            readKeys: typeof impl === 'function' ? extractContextReads(impl) : [],
+        };
+    }
+    if (typeof guard === 'function') {
+        const typed = guard;
+        const name = typeof typed.type === 'string' && typed.type.length > 0
+            ? typed.type
+            : '(inline)';
+        return { name, readKeys: extractContextReads(guard) };
+    }
+    if (guard && typeof guard === 'object' && 'type' in guard) {
+        const type = guard.type;
+        if (typeof type === 'string') {
+            const impl = machine.implementations?.guards?.[type];
+            if (typeof impl === 'function') {
+                return { name: type, readKeys: extractContextReads(impl) };
+            }
+            return { name: type, readKeys: [] };
+        }
+    }
+    return { name: '(inline)', readKeys: [] };
+}
+/** Expand compound guards into leaf refs (skipping and/or/not wrappers). */
+function flattenGuard(guard) {
+    if (guard == null)
+        return [];
+    if (typeof guard === 'string' || typeof guard === 'function') {
+        return [guard];
+    }
+    if (guard && typeof guard === 'object' && 'type' in guard) {
+        const type = guard.type;
+        if (typeof type === 'string' && COMPOUND_GUARDS.has(type)) {
+            const params = guard.params;
+            const list = asList(params);
+            return list.flatMap(flattenGuard);
+        }
+        return [guard];
+    }
+    return [guard];
+}
+function extractContextReads(fn) {
+    if (typeof fn !== 'function')
+        return [];
+    try {
+        const src = Function.prototype.toString.call(fn);
+        const keys = [];
+        CONTEXT_KEY_RE.lastIndex = 0;
+        for (const match of src.matchAll(CONTEXT_KEY_RE)) {
+            const key = match[1] ?? match[2];
+            if (key)
+                keys.push(key);
+        }
+        return unique(keys);
+    }
+    catch {
+        return [];
+    }
+}
+function plainContextKeys(context) {
+    if (!context || typeof context !== 'object' || Array.isArray(context)) {
+        return [];
+    }
+    return Object.keys(context);
+}
+function ensureContextKey(graph, key) {
+    const id = `ctx:${key}`;
+    if (!graph.nodes.has(id)) {
+        graph.nodes.set(id, {
+            id,
+            kind: 'contextKey',
+            label: key,
+            coverage: 'known',
+        });
+    }
+    return id;
+}
+function ensureEntity(graph, id, kind, label, coverage) {
+    const existing = graph.nodes.get(id);
+    if (!existing) {
+        graph.nodes.set(id, { id, kind, label, coverage });
+        return;
+    }
+    existing.coverage = mergeCoverage(existing.coverage, coverage);
+}
+function bumpCoverage(graph, id, coverage) {
+    const node = graph.nodes.get(id);
+    if (!node)
+        return;
+    node.coverage = mergeCoverage(node.coverage, coverage);
+}
+function mergeCoverage(a, b) {
+    const rank = { opaque: 0, partial: 1, known: 2 };
+    return rank[a] >= rank[b] ? a : b;
+}
+function addEdge(graph, fromEntityId, contextKey, relation, site) {
+    const to = ensureContextKey(graph, contextKey);
+    const already = graph.edges.some((edge) => edge.from === fromEntityId &&
+        edge.to === to &&
+        edge.relation === relation &&
+        edge.at.stateId === site.stateId &&
+        edge.at.site === site.site &&
+        edge.at.eventType === site.eventType);
+    if (already)
+        return;
+    graph.edges.push({
+        from: fromEntityId,
+        to,
+        relation,
+        at: {
+            stateId: site.stateId,
+            site: site.site,
+            ...(site.eventType !== undefined ? { eventType: site.eventType } : {}),
+        },
+    });
+}
+function invokeEntityId(id, src, stateId) {
+    if (typeof id === 'string' && id.length > 0)
+        return `invoke:${id}`;
+    if (typeof src === 'string' && src.length > 0) {
+        return `invoke:${stateId}:${src}`;
+    }
+    return `invoke:${stateId}`;
+}
+function invokeLabel(id, src) {
+    if (typeof id === 'string' && id.length > 0)
+        return id;
+    if (typeof src === 'string' && src.length > 0)
+        return src;
+    if (src && typeof src === 'object' && 'id' in src) {
+        const srcId = src.id;
+        if (typeof srcId === 'string')
+            return srcId;
+    }
+    return '(invoke)';
+}
+function asList(value) {
+    if (value == null)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+function eventTypeOf(transition) {
+    if (!transition || typeof transition !== 'object')
+        return undefined;
+    const eventType = transition.eventType;
+    return typeof eventType === 'string' ? eventType : undefined;
+}
+function isInjectedAfterAction(action) {
+    if (!action || typeof action !== 'object')
+        return false;
+    const type = action.type;
+    return type === 'xstate.raise' || type === 'xstate.cancel';
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+//# sourceMappingURL=contextDeps.js.map

package/dist/contextDeps.js.map

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

package/dist/createVisualizerHost.d.ts

@@ -0,0 +1,69 @@
+import type { AnyEventObject, InspectionEvent, MachineContext } from 'xstate';
+import { type HostBridgeStatus, type VisualizerSnapshot } from '@r-a-i-t-h/viz-protocol';
+export type { HostBridgeStatus, VisualizerSnapshot } from '@r-a-i-t-h/viz-protocol';
+export interface VisualizerHostOptions {
+    /**
+     * Absolute or same-origin URL of the visualizer page.
+     * Required for `openPopup()`.
+     */
+    visualizerUrl: string;
+    /** Max log entries retained for subscribers and popup replay. @default 100 */
+    maxLogEntries?: number;
+    /**
+     * Scrub context before frames are stored / sent over postMessage.
+     * Runs after actor-ref enrichment so spawn↔sessionId markers can survive
+     * if the hook leaves those keys intact.
+     */
+    sanitizeContext?: (context: MachineContext) => MachineContext;
+    /** Scrub events before logging event types (and any future event payloads). */
+    sanitizeEvent?: (event: AnyEventObject) => AnyEventObject;
+}
+export type VisualizerListener = (snapshot: VisualizerSnapshot) => void;
+/**
+ * Framework-agnostic visualizer host API.
+ *
+ * Real deployments typically only call `openPopup()` from a user gesture
+ * (or a parent-page message that triggers one). Inline visibility is optional
+ * and mainly useful for local PoCs — the host iframe need not ship any UI.
+ *
+ * @example
+ * ```ts
+ * const viz = createVisualizerHost({
+ *   visualizerUrl: 'https://your-viz-host/',
+ * });
+ * const actor = createActor(machine, { inspect: viz.inspect });
+ * actor.start();
+ *
+ * // From a click handler, console, or parent postMessage bridge:
+ * viz.openPopup();
+ * viz.showInline();
+ * ```
+ */
+export interface VisualizerHost {
+    /**
+     * Pass to `createActor(machine, { inspect: host.inspect })`.
+     * Every new machine actor (root or spawned/invoked) is projected from its
+     * `@xstate.actor` event and forwarded to the popup / subscribers.
+     */
+    readonly inspect: (event: InspectionEvent) => void;
+    /** Open (or focus) the popup visualizer. Must run from a user gesture. */
+    openPopup(): boolean;
+    /** Request that subscribers show an in-page visualizer. */
+    showInline(): void;
+    /** Request that subscribers hide the in-page visualizer. */
+    hideInline(): void;
+    /** Toggle in-page visualizer visibility. Returns the new value. */
+    toggleInline(): boolean;
+    isInlineVisible(): boolean;
+    getPopupStatus(): HostBridgeStatus;
+    getSnapshot(): VisualizerSnapshot;
+    /** Subscribe to snapshot changes. Returns an unsubscribe function. */
+    subscribe(listener: VisualizerListener): () => void;
+    dispose(): void;
+}
+/**
+ * Create a visualizer host that attaches to XState actors via `inspect`.
+ * No React, no CSS — pure API. Optional UIs subscribe or call these methods.
+ */
+export declare function createVisualizerHost(options: VisualizerHostOptions): VisualizerHost;
+//# sourceMappingURL=createVisualizerHost.d.ts.map

package/dist/createVisualizerHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVisualizerHost.d.ts","sourceRoot":"","sources":["../src/createVisualizerHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC9E,OAAO,EACL,KAAK,gBAAgB,EAIrB,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAQjC,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,cAAc,CAAC;IAC9D,+EAA+E;IAC/E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,cAAc,CAAC;CAC3D;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAEnD,0EAA0E;IAC1E,SAAS,IAAI,OAAO,CAAC;IAErB,2DAA2D;IAC3D,UAAU,IAAI,IAAI,CAAC;IAEnB,4DAA4D;IAC5D,UAAU,IAAI,IAAI,CAAC;IAEnB,mEAAmE;IACnE,YAAY,IAAI,OAAO,CAAC;IAExB,eAAe,IAAI,OAAO,CAAC;IAE3B,cAAc,IAAI,gBAAgB,CAAC;IAEnC,WAAW,IAAI,kBAAkB,CAAC;IAElC,sEAAsE;IACtE,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAAC;IAEpD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAqIhB"}

package/dist/createVisualizerHost.js

@@ -0,0 +1,135 @@
+import {} from '@r-a-i-t-h/viz-protocol';
+import { HostBridge } from './bridge/hostBridge.js';
+import { machineLogicFromEvent, projectFrame, projectMachine, } from './project.js';
+/**
+ * Create a visualizer host that attaches to XState actors via `inspect`.
+ * No React, no CSS — pure API. Optional UIs subscribe or call these methods.
+ */
+export function createVisualizerHost(options) {
+    const maxLogEntries = options.maxLogEntries ?? 100;
+    const listeners = new Set();
+    const machines = new Map();
+    const frames = new Map();
+    const previousContexts = new Map();
+    const previousContextAges = new Map();
+    let log = [];
+    let inlineVisible = false;
+    let seq = 0;
+    const bridge = new HostBridge({
+        visualizerUrl: options.visualizerUrl,
+        maxLogDeferred: maxLogEntries,
+        onStatus: () => emit(),
+    });
+    const emit = () => {
+        const snapshot = getSnapshot();
+        for (const listener of listeners)
+            listener(snapshot);
+    };
+    const getSnapshot = () => ({
+        machines: [...machines.values()],
+        frames: Object.fromEntries(frames),
+        log,
+        inlineVisible,
+        popupStatus: bridge.getStatus(),
+    });
+    const inspect = (event) => {
+        const resolved = machineLogicFromEvent(event);
+        if (resolved) {
+            const machine = projectMachine(resolved.logic, resolved.sessionId, {
+                parentSessionId: resolved.parentSessionId,
+                input: resolved.input,
+            });
+            machines.set(machine.sessionId, machine);
+            bridge.sendMachine(machine);
+        }
+        const logged = summarizeInspectionEvent(event, seq++, options.sanitizeEvent);
+        log = [logged, ...log].slice(0, maxLogEntries);
+        bridge.sendLog(logged);
+        if (event.type === '@xstate.snapshot') {
+            const snapshot = event.snapshot;
+            const sessionId = logged.sessionId;
+            const frame = projectFrame(sessionId, snapshot, {
+                eventType: logged.eventType,
+                previousContext: previousContexts.get(sessionId),
+                previousAges: previousContextAges.get(sessionId),
+                machine: machines.get(sessionId),
+                sanitizeContext: options.sanitizeContext
+                    ? (ctx) => options.sanitizeContext((ctx ?? {}))
+                    : undefined,
+            });
+            previousContexts.set(sessionId, frame.context);
+            if (frame.contextKeyAges) {
+                previousContextAges.set(sessionId, frame.contextKeyAges);
+            }
+            frames.set(frame.sessionId, frame);
+            bridge.sendFrame(frame);
+        }
+        emit();
+    };
+    const host = {
+        inspect,
+        openPopup() {
+            const ok = bridge.open();
+            emit();
+            return ok;
+        },
+        showInline() {
+            inlineVisible = true;
+            emit();
+        },
+        hideInline() {
+            inlineVisible = false;
+            emit();
+        },
+        toggleInline() {
+            inlineVisible = !inlineVisible;
+            emit();
+            return inlineVisible;
+        },
+        isInlineVisible() {
+            return inlineVisible;
+        },
+        getPopupStatus() {
+            return bridge.getStatus();
+        },
+        getSnapshot,
+        subscribe(listener) {
+            listeners.add(listener);
+            listener(getSnapshot());
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        dispose() {
+            bridge.dispose();
+            listeners.clear();
+            machines.clear();
+            frames.clear();
+            previousContexts.clear();
+            previousContextAges.clear();
+            log = [];
+        },
+    };
+    return host;
+}
+function summarizeInspectionEvent(event, seq, sanitizeEvent) {
+    const actorRef = event.actorRef;
+    const base = {
+        seq,
+        type: event.type,
+        sessionId: actorRef?.sessionId ?? '(unknown)',
+        at: Date.now(),
+    };
+    if ('event' in event && event.event) {
+        const scrubbed = sanitizeEvent
+            ? sanitizeEvent(event.event)
+            : event.event;
+        base.eventType = scrubbed.type;
+    }
+    if ('snapshot' in event && event.snapshot) {
+        const snapshot = event.snapshot;
+        base.value = snapshot.value;
+    }
+    return base;
+}
+//# sourceMappingURL=createVisualizerHost.js.map

package/dist/createVisualizerHost.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Host library: inspect + project live XState logic → Viz*, open popup bridge.
+ *
+ * Depends on `@r-a-i-t-h/viz-protocol` for the shared model/wire types.
+ * Peer: `xstate` v5.
+ */
+export { createVisualizerHost, type VisualizerHost, type VisualizerHostOptions, type VisualizerListener, } from './createVisualizerHost.js';
+export type { HostBridgeStatus, VisualizerSnapshot } from '@r-a-i-t-h/viz-protocol';
+export { machineLogicFromEvent, projectFrame, projectMachine, portableizeContext, activePaths, } from './project.js';
+export { normalizeStateNodeId } from '@r-a-i-t-h/viz-protocol';
+export { collectNextEvents } from './nextEvents.js';
+export { computeContextKeyAges } from './contextAges.js';
+export { analyzeContextDeps, type ContextDepEdge, type ContextDepGraph, type ContextDepNode, type DepCoverage, type DepEntityKind, type DepRelation, type DepSite, } from './contextDeps.js';
+/** Re-export protocol model for apps that only install `@r-a-i-t-h/viz-host`. */
+export type { VizActorRefMarker, VizAnalysis, VizBadge, VizBadgeKind, VizEvent, VizFrame, VizInvoke, VizLogEntry, VizMachine, VizNextEvent, VizNextEventCandidate, VizNode, VizNodeDetails, VizNodeKind, VizSymbol, VizTransition, } from '@r-a-i-t-h/viz-protocol';
+export { isVizActorRefMarker } from '@r-a-i-t-h/viz-protocol';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,OAAO,GACb,MAAM,kBAAkB,CAAC;AAE1B,iFAAiF;AACjF,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,OAAO,EACP,cAAc,EACd,WAAW,EACX,SAAS,EACT,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}