@statelyai/sdk 0.4.1 → 0.5.1

package/dist/embed.d.mts

@@ -1,4 +1,4 @@
-import { a as EmbedMode, c as ExportFormatMap, d as UploadResult, i as EmbedEventName, l as InitOptions, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat, t as CommentsConfig } from "./protocol-CZVFCSg3.mjs";
+import { a as EmbedMode, c as ExportFormatMap, f as UploadResult, i as EmbedEventName, l as InitOptions, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat, t as CommentsConfig, u as MachineSourceLocations } from "./protocol-BPuwbNCz.mjs";
 
 //#region src/embed.d.ts
 interface AssetConfig {
@@ -44,7 +44,7 @@ interface StatelyEmbed {
   /** Send init message (queued if iframe not ready yet). */
   init(options: InitOptions): void;
   /** Update the machine (shorthand for update message). */
-  updateMachine(machine: unknown, format?: string): void;
+  updateMachine(machine: unknown, format?: string, sourceLocations?: MachineSourceLocations): void;
   /** Change the embed mode. */
   setMode(mode: EmbedMode): void;
   /** Change the embed theme. */
@@ -64,4 +64,4 @@ interface StatelyEmbed {
 }
 declare function createStatelyEmbed(options: StatelyEmbedOptions): StatelyEmbed;
 //#endregion
-export { AssetConfig, type CommentsConfig, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type InitOptions, StatelyEmbed, StatelyEmbedOptions, type UploadResult, createStatelyEmbed };
+export { AssetConfig, type CommentsConfig, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type InitOptions, type MachineSourceLocations, StatelyEmbed, StatelyEmbedOptions, type UploadResult, createStatelyEmbed };

package/dist/embed.mjs

@@ -1,10 +1,15 @@
-import { i as createPendingExportManager, o as toInitMessage, r as createEventRegistry, t as createPostMessageTransport } from "./transport-C1fRAuv-.mjs";
+import { a as toInitMessage, i as createPendingExportManager, r as createEventRegistry, t as createPostMessageTransport } from "./transport-DoCHBLTu.mjs";
 
 //#region src/embed.ts
-function createStatelyEmbed(options) {
+function buildEmbedUrl(options) {
 	const base = options.baseUrl.replace(/\/+$/, "") + "/embed";
-	const embedUrl = options.apiKey ? `${base}?api_key=${encodeURIComponent(options.apiKey)}` : base;
-	const targetOrigin = options.origin ?? new URL(embedUrl).origin;
+	const url = new URL(base);
+	if (options.apiKey) url.searchParams.set("api_key", options.apiKey);
+	return url.toString();
+}
+function createStatelyEmbed(options) {
+	const embedUrl = buildEmbedUrl(options);
+	const targetOrigin = options.origin ?? "*";
 	let iframe = null;
 	let transport = null;
 	let ownedIframe = false;
@@ -45,7 +50,10 @@ function createStatelyEmbed(options) {
 			case "@statelyai.loaded": {
 				const loaded = data;
 				options.onLoaded?.(loaded.graph);
-				events.emit("loaded", { graph: loaded.graph });
+				events.emit("loaded", {
+					graph: loaded.graph,
+					sourceLocations: loaded.sourceLocations
+				});
 				break;
 			}
 			case "@statelyai.change": {
@@ -53,7 +61,9 @@ function createStatelyEmbed(options) {
 				options.onChange?.(change.graph, change.machineConfig);
 				events.emit("change", {
 					graph: change.graph,
-					machineConfig: change.machineConfig
+					machineConfig: change.machineConfig,
+					patches: change.patches,
+					sourceLocations: change.sourceLocations
 				});
 				break;
 			}
@@ -62,7 +72,10 @@ function createStatelyEmbed(options) {
 				options.onSave?.(save.graph, save.machineConfig);
 				events.emit("save", {
 					graph: save.graph,
-					machineConfig: save.machineConfig
+					machineConfig: save.machineConfig,
+					patches: save.patches,
+					validations: save.validations,
+					sourceLocations: save.sourceLocations
 				});
 				break;
 			}
@@ -169,11 +182,12 @@ function createStatelyEmbed(options) {
 		init(opts) {
 			send(toInitMessage(opts));
 		},
-		updateMachine(machine, format) {
+		updateMachine(machine, format, sourceLocations) {
 			send({
 				type: "@statelyai.update",
 				machine,
-				format
+				format,
+				sourceLocations
 			});
 		},
 		setMode(mode) {

package/dist/graph.mjs

@@ -1,6 +1,7 @@
 import { createFormatConverter, createGraph } from "@statelyai/graph";
 
 //#region src/graph.ts
+const EXPR_ACTION_TYPE = "xstate.expr";
 function toJsonObject(value) {
 	return value;
 }
@@ -31,17 +32,17 @@ function normalizeStudioHistory(history) {
 	if (history === true) return "shallow";
 	return history || void 0;
 }
-function toActionSource(action) {
+function toActionSource(implementation) {
 	return {
 		type: "action",
-		id: action.id,
-		name: action.name,
-		...action.description ? { description: action.description } : {},
-		...action.icon ? { icon: action.icon } : {},
-		lang: action.code?.lang ?? "js",
+		id: implementation.id,
+		name: implementation.name,
+		...implementation.description ? { description: implementation.description } : {},
+		...implementation.icon ? { icon: implementation.icon } : {},
+		lang: implementation.code?.lang ?? "js",
 		imports: [],
-		code: action.code?.body,
-		...action.paramsSchema ? { paramsSchema: action.paramsSchema } : {}
+		code: implementation.code?.body,
+		...implementation.paramsSchema ? { paramsSchema: implementation.paramsSchema } : {}
 	};
 }
 function toGuardSource(guard) {
@@ -72,16 +73,16 @@ function toActorSource(actor) {
 		...actor.outputSchema ? { outputSchema: actor.outputSchema } : {}
 	};
 }
-function fromActionSource(action) {
+function fromActionSource(source) {
 	return {
-		id: action.id,
-		name: action.name,
-		description: action.description ?? null,
-		...action.icon ? { icon: action.icon } : {},
-		paramsSchema: action.paramsSchema ?? null,
-		...action.code ? { code: {
-			body: action.code,
-			...action.lang ? { lang: action.lang } : {}
+		id: source.id,
+		name: source.name,
+		description: source.description ?? null,
+		...source.icon ? { icon: source.icon } : {},
+		paramsSchema: source.paramsSchema ?? null,
+		...source.code ? { code: {
+			body: source.code,
+			...source.lang ? { lang: source.lang } : {}
 		} } : {}
 	};
 }
@@ -113,6 +114,10 @@ function fromActorSource(actor) {
 	};
 }
 function toStudioAction(action) {
+	if (action.type === EXPR_ACTION_TYPE && typeof action.params?.code === "string") return {
+		kind: "inline",
+		action: { expr: action.params.code }
+	};
 	return {
 		kind: "named",
 		action: {
@@ -123,8 +128,11 @@ function toStudioAction(action) {
 }
 function fromStudioAction(action) {
 	if (action.kind === "inline") return {
-		type: "inline",
-		params: { expr: action.action.expr }
+		type: EXPR_ACTION_TYPE,
+		params: {
+			code: action.action.expr,
+			lang: "ts"
+		}
 	};
 	if ("params" in action.action && action.action.params) return {
 		type: action.action.type,

package/dist/{graphToXStateTS-Cfp_fxSH.mjs → graphToXStateTS-CtecEESq.mjs}

@@ -5,6 +5,7 @@
 * - Single-quoted strings
 * - Omits undefined values
 * - Supports RawCode for verbatim expressions
+* - Supports inline expression directives for verbatim expressions
 */
 const VALID_IDENT = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
 var RawCode = class {
@@ -17,6 +18,7 @@ function raw(code) {
 }
 function serializeJS(value, indent = 0, step = 2) {
 	if (value instanceof RawCode) return value.code;
+	if (isInlineExpressionDirective(value)) return value.expr;
 	if (value === void 0) return "undefined";
 	if (value === null) return "null";
 	if (typeof value === "string") return `'${escapeString(value)}'`;
@@ -45,10 +47,18 @@ function serializeObject(obj, indent, step) {
 	return `{\n${entries.map(([key, val]) => {
 		const k = VALID_IDENT.test(key) ? key : `'${escapeString(key)}'`;
 		const serialized = serializeJS(val, inner, step);
-		if (val instanceof RawCode && serialized.includes("\n")) return `${pad}${k}: ${indentRawCode(serialized, inner)}`;
+		if (isRawExpression(val) && serialized.includes("\n")) return `${pad}${k}: ${indentRawCode(serialized, inner)}`;
 		return `${pad}${k}: ${serialized}`;
 	}).join(",\n")},\n${closePad}}`;
 }
+function isRawExpression(value) {
+	return value instanceof RawCode || isInlineExpressionDirective(value);
+}
+function isInlineExpressionDirective(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const directive = value;
+	return directive["@type"] === "code" && typeof directive.expr === "string";
+}
 function indentRawCode(code, indent) {
 	const lines = code.split("\n");
 	if (lines.length <= 1) return code;
@@ -84,14 +94,17 @@ function stripExportDefault(code) {
 
 //#endregion
 //#region src/graphToMachineConfig.ts
-function getNodePath(graph, node) {
-	const path = [];
-	let currentNode = node;
-	while (currentNode) {
-		path.unshift(currentNode.data.key);
-		currentNode = graph.nodes.find((n) => n.id === currentNode.parentId);
-	}
-	return path;
+function isAutoGeneratedId(id) {
+	return !!id && id.startsWith("$auto-");
+}
+function getSerializedNodeId(node) {
+	return node.data.nodeId ?? void 0;
+}
+function getDefaultNodeId(graph, node) {
+	if (!node.parentId) return "(machine)";
+	const parentNode = graph.nodes.find((candidate) => candidate.id === node.parentId);
+	if (!parentNode) return `${node.parentId}.${node.data.key}`;
+	return `${getSerializedNodeId(parentNode) ?? getDefaultNodeId(graph, parentNode)}.${node.data.key}`;
 }
 /** Unwrap single-element arrays to a single value (XState single-or-array convention) */
 function singleOrArray(arr) {
@@ -169,6 +182,7 @@ function formatEventParam(event) {
 */
 function serializeActionItem(action) {
 	const { type, params } = action;
+	const exprCode = type === "xstate.expr" && typeof params?.code === "string" ? params.code : void 0;
 	switch (type) {
 		case "xstate.raise": {
 			const eventStr = formatEventParam(params?.event);
@@ -196,9 +210,14 @@ function serializeActionItem(action) {
 		}
 		case "xstate.stopChild": return raw(`stopChild(${params?.actorRef ? `'${params.actorRef}'` : `'unknown'`})`);
 		case "xstate.log": return raw(`log(${(params?.label ? `'${params.label}'` : void 0) ?? ""})`);
-		case "xstate.assign": return raw(`assign({ /* ... */ })`);
+		case "xstate.assign": {
+			const assignments = params?.assignment && typeof params.assignment === "object" && !Array.isArray(params.assignment) ? params.assignment : params;
+			const entries = Object.entries(assignments ?? {}).filter(([k, v]) => k && v !== void 0);
+			if (entries.length === 0) return raw(`assign({ /* ... */ })`);
+			return raw(`assign({ ${entries.map(([k, v]) => `${JSON.stringify(k)}: ${formatAssignValue(v)}`).join(", ")} })`);
+		}
 		default:
-			if (action.code) return raw(stripExportDefault(action.code));
+			if (exprCode) return raw(stripExportDefault(exprCode));
 			if (!params || Object.keys(params).length === 0) return { type };
 			return {
 				type,
@@ -206,6 +225,12 @@ function serializeActionItem(action) {
 			};
 	}
 }
+function formatAssignValue(value) {
+	if (typeof value !== "string") return JSON.stringify(value);
+	const templateExpression = value.match(/^\{\{([\s\S]*)\}\}$/);
+	if (templateExpression) return templateExpression[1];
+	return JSON.stringify(value);
+}
 /** Normalize tag to string — handles both `string` and `{ name: string }` */
 function tagToString(tag) {
 	return typeof tag === "string" ? tag : tag.name;
@@ -215,8 +240,10 @@ function graphToMachineConfig(graph, options = {}) {
 	const config = {};
 	function getNodeConfig(node) {
 		const nodeConfig = node.parentId ? {} : config;
-		const nodePath = getNodePath(graph, node);
-		const resolvedNodeId = !node.parentId ? node.id : nodePath.join(".") === node.id ? void 0 : node.id;
+		const isRoot = !node.parentId;
+		const authoredNodeId = getSerializedNodeId(node) ?? (isRoot ? graph.id : void 0);
+		const defaultNodeId = getDefaultNodeId(graph, node);
+		const resolvedNodeId = isAutoGeneratedId(authoredNodeId) ? void 0 : isRoot ? authoredNodeId : defaultNodeId === authoredNodeId ? void 0 : authoredNodeId;
 		const initialNode = node.data.initialId ? graph.nodes.find((n) => n.id === node.data.initialId) : null;
 		const nodeType = [
 			"final",
@@ -233,7 +260,8 @@ function graphToMachineConfig(graph, options = {}) {
 			...node.data.invokes?.length ? { invoke: node.data.invokes.map((inv) => ({
 				src: inv.src,
 				id: inv.id,
-				...inv.input ? { input: inv.input } : void 0
+				...inv.input ? { input: inv.input } : void 0,
+				...inv.output ? { output: inv.output } : void 0
 			})) } : void 0,
 			...tags?.length ? { tags: tags.map(tagToString) } : void 0,
 			...showDescriptions && node.data.description ? { description: node.data.description } : void 0,
@@ -303,6 +331,11 @@ function graphToMachineConfig(graph, options = {}) {
 				};
 			});
 		}
+		if (Array.isArray(nodeConfig.invoke)) nodeConfig.invoke = nodeConfig.invoke.map((inv) => {
+			if (!isAutoGeneratedId(inv.id)) return inv;
+			const { id: _id, ...rest } = inv;
+			return rest;
+		});
 		if (childNodes.length > 0) {
 			nodeConfig.states = {};
 			for (const childState of childNodes) nodeConfig.states[childState.data.key] = getNodeConfig(childState);
@@ -442,17 +475,22 @@ function scanInlineCodeForBuiltins(code, used) {
 	const expr = stripExportDefault(code);
 	for (const importName of Object.values(BUILTIN_ACTION_IMPORTS)) if (new RegExp(`\\b${importName}\\b`).test(expr)) used.add(importName);
 }
+function getExprActionCode(action) {
+	return action.type === "xstate.expr" && typeof action.params?.code === "string" ? action.params.code : void 0;
+}
 function getUsedBuiltInActions(graph) {
 	const used = /* @__PURE__ */ new Set();
 	for (const node of graph.nodes) for (const action of [...node.data.entry ?? [], ...node.data.exit ?? []]) {
 		const imp = BUILTIN_ACTION_IMPORTS[action.type];
 		if (imp) used.add(imp);
-		if (action.code) scanInlineCodeForBuiltins(action.code, used);
+		const exprCode = getExprActionCode(action);
+		if (exprCode) scanInlineCodeForBuiltins(exprCode, used);
 	}
 	for (const edge of graph.edges) for (const action of edge.data.actions ?? []) {
 		const imp = BUILTIN_ACTION_IMPORTS[action.type];
 		if (imp) used.add(imp);
-		if (action.code) scanInlineCodeForBuiltins(action.code, used);
+		const exprCode = getExprActionCode(action);
+		if (exprCode) scanInlineCodeForBuiltins(exprCode, used);
 	}
 	return used;
 }
@@ -497,10 +535,10 @@ function hasSchemaProperties(schema) {
 }
 function buildActionsBlock(actions) {
 	const block = {};
-	for (const action of actions) if (action.code?.body) {
-		const params = hasSchemaProperties(action.paramsSchema) ? `, params: ${jsonSchemaToTSType(action.paramsSchema)}` : "";
-		block[action.name] = raw(`function ({ context, event }${params ? params : ""}) {\n  ${dedent(action.code.body)}\n}`);
-	} else block[action.name] = raw(`function ({ context, event }) {\n  // TODO: implement ${action.name}\n}`);
+	for (const implementation of actions) if (implementation.code?.body) {
+		const params = hasSchemaProperties(implementation.paramsSchema) ? `, params: ${jsonSchemaToTSType(implementation.paramsSchema)}` : "";
+		block[implementation.name] = raw(`function ({ context, event }${params ? params : ""}) {\n  ${dedent(implementation.code.body)}\n}`);
+	} else block[implementation.name] = raw(`function ({ context, event }) {\n  // TODO: implement ${implementation.name}\n}`);
 	return block;
 }
 function buildGuardsBlock(guards) {

package/dist/index.d.mts

@@ -1,59 +1,43 @@
 import { C as EventTypeData, S as DigraphNodeConfig, _ as studioMachineConverter, a as StatelyGraphData, b as DigraphConfig, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, o as StatelyGuard, r as StatelyEdgeData, t as StatelyAction, v as toStudioMachine, w as StateNodeJSONData, x as DigraphEdgeConfig, y as DigraphAction } from "./graph-BfezxFKJ.mjs";
 import { a as ProjectMachine, c as StudioClientOptions, i as ProjectData, l as VerifyApiKeyResponse, n as ExtractedMachine, o as StudioApiError, r as GetMachineOptions, s as StudioClient, t as ExtractMachinesResponse, u as createStatelyClient } from "./studio-D2uQhrvX.mjs";
 import { PlanSyncOptions, PullSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";
-import { a as EmbedMode, c as ExportFormatMap, d as UploadResult, i as EmbedEventName, l as InitOptions, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat, t as CommentsConfig, u as ProtocolMessage } from "./protocol-CZVFCSg3.mjs";
+import { a as EmbedMode, c as ExportFormatMap, f as UploadResult, i as EmbedEventName, l as InitOptions, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat, t as CommentsConfig } from "./protocol-BPuwbNCz.mjs";
 import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
-import { CreateInspectorOptions, InspectOptions, Inspector, createStatelyInspector } from "./inspect.mjs";
+import { a as ManualActorOptions, c as createPostMessageTransport, i as InspectorEvents, l as createWebSocketTransport, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-ttRIjoCu.mjs";
+import { ActionLocation, GraphPatch } from "./patchTypes.mjs";
 import { JSONSchema7 } from "json-schema";
 import { UnknownMachineConfig } from "xstate";
 
-//#region src/transport.d.ts
-interface Transport {
-  send(msg: ProtocolMessage): void;
-  onMessage(handler: (msg: ProtocolMessage) => void): () => void;
-  destroy(): void;
-  readonly ready: boolean;
-  onReady(handler: () => void): () => void;
-}
-interface PostMessageTransportOptions {
-  iframe: HTMLIFrameElement;
-  targetOrigin: string;
-  /** Filter by source. Defaults to iframe.contentWindow. */
-  source?: Window;
-}
-declare function createPostMessageTransport(options: PostMessageTransportOptions): Transport;
-interface WebSocketTransportOptions {
-  url: string;
-  role: 'client' | 'viz';
-  sessionId: string;
-  metadata?: {
-    name?: string;
-    machineId?: string;
-  };
-  /** Reconnect on disconnect. Default true. */
-  reconnect?: boolean;
-  /** Max reconnect attempts. Default 10. */
-  maxReconnectAttempts?: number;
-}
-declare function createWebSocketTransport(options: WebSocketTransportOptions): Transport;
-//#endregion
 //#region src/codegenTypes.d.ts
 interface CodeGenAction {
   type: string;
   params?: Record<string, unknown>;
-  code?: string;
 }
 interface CodeGenGuard {
   type: string;
   code?: string;
   params?: Record<string, unknown>;
 }
+/**
+ * Serialized inline expression directive.
+ *
+ * Code generation treats this object as JavaScript/TypeScript source, not as a
+ * machine config object. It is used for fields such as invoke `input` and
+ * `output` where XState accepts mapper expressions.
+ */
+interface CodeExpression {
+  '@type': 'code';
+  lang: 'js' | 'ts';
+  expr: string;
+}
 interface CodeGenInvoke {
   src: string;
   id: string;
-  input?: unknown;
+  input?: Record<string, unknown> | CodeExpression;
+  output?: Record<string, unknown> | CodeExpression;
 }
 interface CodeGenNodeData {
+  nodeId?: string | null;
   key: string;
   type?: 'normal' | 'parallel' | 'final' | 'history' | null;
   initialId?: string | null;
@@ -155,6 +139,7 @@ declare function graphToXStateTS(graph: CodeGenGraph, options?: XStateTSOptions)
  * - Single-quoted strings
  * - Omits undefined values
  * - Supports RawCode for verbatim expressions
+ * - Supports inline expression directives for verbatim expressions
  */
 declare class RawCode {
   code: string;
@@ -176,4 +161,4 @@ declare function contextSchemaToTSType(context: Record<string, JSONSchema7> | nu
  */
 declare function eventsSchemaToTSType(events: Record<string, JSONSchema7> | null | undefined): string | null;
 //#endregion
-export { type AssetConfig, type CodeGenGraph, type CommentsConfig, type CreateInspectorOptions, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesResponse, type ExtractedMachine, type GetMachineOptions, type InitOptions, type InspectOptions, type Inspector, type MachineConfigOptions, type PlanSyncOptions, type ProjectData, type ProjectMachine, type PullSyncResult, RawCode, type ResolvedSyncInput, type StateNodeJSONData, type StatelyAction, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StudioAction, StudioApiError, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioNode, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type UploadResult, type VerifyApiKeyResponse, type XStateTSOptions, contextSchemaToTSType, createPostMessageTransport, createStatelyClient, createStatelyEmbed, createStatelyInspector, createWebSocketTransport, eventsSchemaToTSType, fromStudioMachine, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine };
+export { type ActionLocation, type AdoptedActor, type AssetConfig, type CodeGenGraph, type CommentsConfig, type CreateInspectorOptions, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesResponse, type ExtractedMachine, type GetMachineOptions, type GraphPatch, type InitOptions, type Inspector, type InspectorEvents, type MachineConfigOptions, type ManualActorOptions, type PlanSyncOptions, type ProjectData, type ProjectMachine, type PullSyncResult, RawCode, type ResolvedSyncInput, type StateNodeJSONData, type StatelyAction, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StudioAction, StudioApiError, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioNode, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type UploadResult, type VerifyApiKeyResponse, type XStateTSOptions, contextSchemaToTSType, createPostMessageTransport, createStatelyClient, createStatelyEmbed, createStatelyInspector, createWebSocketTransport, eventsSchemaToTSType, fromStudioMachine, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine };

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-C1fRAuv-.mjs";
+import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-DoCHBLTu.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
 import { createStatelyInspector } from "./inspect.mjs";
 import { StudioApiError, createStatelyClient } from "./studio.mjs";
 import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
-import { a as graphToMachineConfig, c as serializeJS, i as jsonSchemaToTSType, n as contextSchemaToTSType, o as RawCode, r as eventsSchemaToTSType, s as raw, t as graphToXStateTS } from "./graphToXStateTS-Cfp_fxSH.mjs";
+import { a as graphToMachineConfig, c as serializeJS, i as jsonSchemaToTSType, n as contextSchemaToTSType, o as RawCode, r as eventsSchemaToTSType, s as raw, t as graphToXStateTS } from "./graphToXStateTS-CtecEESq.mjs";
 
 export { RawCode, StudioApiError, contextSchemaToTSType, createPostMessageTransport, createStatelyClient, createStatelyEmbed, createStatelyInspector, createWebSocketTransport, eventsSchemaToTSType, fromStudioMachine, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine };

package/dist/inspect-ttRIjoCu.d.mts

@@ -0,0 +1,206 @@
+import { c as ExportFormatMap, d as ProtocolMessage, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat } from "./protocol-BPuwbNCz.mjs";
+
+//#region src/transport.d.ts
+interface Transport {
+  send(msg: ProtocolMessage): void;
+  onMessage(handler: (msg: ProtocolMessage) => void): () => void;
+  destroy(): void;
+  readonly ready: boolean;
+  onReady(handler: () => void): () => void;
+}
+interface PostMessageTransportOptions {
+  iframe: HTMLIFrameElement;
+  targetOrigin: string;
+  /** Filter by source. Defaults to iframe.contentWindow. */
+  source?: Window;
+}
+declare function createPostMessageTransport(options: PostMessageTransportOptions): Transport;
+interface WebSocketTransportOptions {
+  url: string;
+  role: 'client' | 'viz';
+  sessionId: string;
+  metadata?: {
+    name?: string;
+    machineId?: string;
+  };
+  /** Reconnect on disconnect. Default true. */
+  reconnect?: boolean;
+  /** Max reconnect attempts. Default 10. */
+  maxReconnectAttempts?: number;
+}
+declare function createWebSocketTransport(options: WebSocketTransportOptions): Transport;
+//#endregion
+//#region src/inspect.d.ts
+interface MinimalActorRef {
+  id: string;
+  sessionId: string;
+  systemId?: string;
+  _parent?: MinimalActorRef;
+  logic?: {
+    config?: unknown;
+  };
+  getSnapshot(): MinimalSnapshot;
+  system: {
+    inspect: (observer: (event: InspectionEvent) => void) => {
+      unsubscribe: () => void;
+    };
+  };
+}
+interface MinimalSnapshot {
+  value: unknown;
+  status: unknown;
+  context?: unknown;
+  children?: Record<string, MinimalActorRef>;
+}
+type InspectionEvent = {
+  type: '@xstate.actor';
+  actorRef: MinimalActorRef;
+  rootId: string;
+} | {
+  type: '@xstate.snapshot';
+  actorRef: MinimalActorRef;
+  rootId: string;
+  snapshot: MinimalSnapshot;
+  event: unknown;
+} | {
+  type: '@xstate.event';
+  actorRef: MinimalActorRef;
+  rootId: string;
+  sourceRef?: MinimalActorRef;
+  event: unknown;
+} | {
+  type: '@xstate.microstep';
+  actorRef: MinimalActorRef;
+  rootId: string;
+  snapshot: MinimalSnapshot;
+  event: unknown;
+} | {
+  type: '@xstate.action';
+  actorRef: MinimalActorRef;
+  rootId: string;
+  action: {
+    type: string;
+    params: unknown;
+  };
+};
+interface AdoptedActor {
+  /** `actor.sessionId` from xstate. Unique across the system. */
+  actorId: string;
+  /** Parent actor's sessionId, or `null` for the root. */
+  parentActorId: string | null;
+  /** Root actor's sessionId (equal to `actorId` for the root). */
+  rootId: string;
+  /** `actor.id` — a human-facing local name. */
+  id: string;
+  /** `actor.systemId`, if registered under one. */
+  systemId: string | undefined;
+  /** Latest serialized snapshot streamed for this actor. */
+  snapshot: unknown | null;
+  /** Machine config sent to the visualizer, or `null` for non-machine actors. */
+  machineConfig: unknown;
+}
+interface InspectorEvents {
+  register: AdoptedActor;
+  snapshot: AdoptedActor;
+  stopped: {
+    actorId: string;
+  };
+  error: EmbedEventMap['error'];
+}
+type EventName = keyof InspectorEvents;
+type Handler<E extends EventName> = (data: InspectorEvents[E]) => void;
+interface ManualActorOptions {
+  /** Initial snapshot. */
+  snapshot?: unknown;
+  /** Machine config for the visualizer. Without this, the actor shows as a generic node. */
+  machine?: unknown;
+  /** Parent actor id (for hierarchy). */
+  parent?: string;
+  /** System-level id (optional alias). */
+  systemId?: string;
+}
+interface CreateInspectorOptions {
+  /**
+   * Root xstate actor to adopt. The inspector walks its `system`.
+   * Omit this for manual-only mode where you call `.actor()` / `.snapshot()`.
+   */
+  actor?: any;
+  /** WebSocket URL of the devtools server. Default: `'ws://localhost:4242'`. */
+  url?: string;
+  /** Auto-open browser to visualizer. Default: `true`. */
+  autoOpen?: boolean;
+  /**
+   * Relay session id. Defaults to the root actor's `sessionId` (auto mode)
+   * or a random id (manual mode). This is the `?session=<id>` value the viz
+   * iframe connects with.
+   */
+  sessionId?: string;
+  /** Display name for this system in the visualizer. */
+  name?: string;
+  /**
+   * Serialize a snapshot for the wire. Defaults to `{value, status}` —
+   * dropping context entirely because xstate contexts routinely contain
+   * spawned actor refs which are not JSON-safe.
+   */
+  serializeSnapshot?: (snapshot: MinimalSnapshot) => unknown;
+  /**
+   * Extract the machine config for a given actor. Defaults to reading
+   * `actor.logic.config`. Return `null` for non-machine actors.
+   */
+  extractMachineConfig?: (actor: any) => unknown;
+  /** Selected actor id to focus on first. Defaults to the root actor. */
+  selectedActorId?: string;
+  /** Panel layout forwarded into the system init message. */
+  panels?: {
+    leftPanels?: string[];
+    rightPanels?: string[];
+    activePanels?: string[];
+  };
+  theme?: 'light' | 'dark';
+  readOnly?: boolean;
+  depth?: number;
+  /**
+   * Advanced: inject a pre-built transport (e.g. a channel from a
+   * multiplexed connection). When provided, `url`/`name` are ignored and the
+   * inspector shares that transport instead of opening its own WebSocket.
+   */
+  transport?: Transport;
+}
+interface Inspector {
+  /** Snapshot of currently-adopted actors keyed by `actorId`. */
+  readonly actors: ReadonlyMap<string, AdoptedActor>;
+  /** The relay sessionId this inspector registered under. */
+  readonly sessionId: string;
+  /** Subscribe to lifecycle / error events. Returns an unsubscribe function. */
+  on<E extends EventName>(event: E, handler: Handler<E>): () => void;
+  off<E extends EventName>(event: E, handler: Handler<E>): void;
+  /** Export the currently-viewed machine in a given format. */
+  export<F extends ExportFormat>(format: F, options?: ExportCallOptions<F>): Promise<ExportFormatMap[F]['result']>;
+  /**
+   * Register a manual actor. In auto mode this adds an actor alongside the
+   * xstate-discovered ones; in manual mode it's the only way to add actors.
+   */
+  actor(id: string, options?: ManualActorOptions): void;
+  /**
+   * Push a snapshot update for an actor. The actor is auto-registered if
+   * it hasn't been `.actor()`'d yet.
+   */
+  snapshot(actorId: string, snapshot: unknown, event?: unknown): void;
+  /**
+   * Log an event targeting an actor. Sends a snapshot message with the
+   * actor's current snapshot + the new event so it appears in the event log.
+   */
+  event(actorId: string, event: string | {
+    type: string;
+    [key: string]: unknown;
+  }, options?: {
+    source?: string;
+  }): void;
+  /** Mark an actor as stopped and remove it from the tree. */
+  stop(actorId: string): void;
+  /** Tear down the WebSocket + xstate subscription. */
+  destroy(): void;
+}
+declare function createStatelyInspector(options: CreateInspectorOptions): Inspector;
+//#endregion
+export { ManualActorOptions as a, createPostMessageTransport as c, InspectorEvents as i, createWebSocketTransport as l, CreateInspectorOptions as n, createStatelyInspector as o, Inspector as r, Transport as s, AdoptedActor as t };