@statelyai/sdk 0.10.1 → 0.11.0

package/dist/index.d.mts

@@ -2,8 +2,8 @@ import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createS
 import { CommentsConfig, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, ProjectEmbedMachine, UploadResult } from "./protocol.mjs";
 import { AssetUploadAdapter, AssetUploadContext, AssetUploadRequest, CreateS3AssetUploadAdapterOptions, CreateSupabaseAssetUploadAdapterOptions, S3UploadTarget, SupabaseStorageClient, createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
 import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
-import { C as EventTypeData, E as JSONSchema7, S as DigraphNodeConfig, T as CodeGenGraph, _ 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-DmXh22Zu.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-BLlM3qKf.mjs";
+import { C as EventTypeData, E as JSONSchema7, S as DigraphNodeConfig, T as CodeGenGraph, _ 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-GeuH-mFK.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-CZ8iLJR7.mjs";
 import { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, EnsureProjectInput, ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, ProjectVisibility, RepoType, StudioApiError, StudioClient, StudioClientOptions, StudioMachineRecord, UpdateMachineInput, VerifyApiKeyResponse, XStateVersion, createStatelyClient } from "./studio.mjs";
 import { PlanSyncOptions, PullSyncResult, PushLocalMachineLinksResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";
 import { ActionLocation, GraphPatch } from "./patchTypes.mjs";
@@ -35,6 +35,14 @@ declare function upsertStatelyPragma(sourceText: string, id: string, options?: U
 interface MachineConfigOptions {
   showDescriptions?: boolean;
   showMeta?: boolean;
+  /**
+   * Emit inline-code guards as a `{ type }` reference instead of an inline code
+   * expression directive. The simulation needs this: it can't evaluate guard
+   * source, so it stubs each guard by `type` (see getSimImplementations). A
+   * code-expression guard has no `type`, so XState reads `undefined` and throws
+   * "Guard 'undefined' is not implemented" the moment that transition is taken.
+   */
+  inlineGuardsAsTypeRef?: boolean;
 }
 declare function graphToMachineConfig(graph: CodeGenGraph, options?: MachineConfigOptions): UnknownMachineConfig;
 //#endregion
@@ -42,6 +50,7 @@ declare function graphToMachineConfig(graph: CodeGenGraph, options?: MachineConf
 interface XStateTSOptions extends MachineConfigOptions {
   exportStyle?: 'named' | 'default' | 'none';
   targetLanguage?: 'typescript' | 'javascript';
+  xstateVersion?: 5 | 6;
 }
 declare function graphToXStateTS(graph: CodeGenGraph, options?: XStateTSOptions): string;
 //#endregion

package/dist/index.mjs

@@ -4,7 +4,7 @@ import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./
 import { createStatelyInspector } from "./inspect.mjs";
 import { StudioApiError, createStatelyClient } from "./studio.mjs";
 import { StatelyApiError, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
-import { a as graphToMachineConfig, c as serializeJS, d as upsertStatelyPragma, i as jsonSchemaToTSType, l as findStatelyPragmaAttachments, n as contextSchemaToTSType, o as RawCode, r as eventsSchemaToTSType, s as raw, t as graphToXStateTS, u as getStatelyPragma } from "./graphToXStateTS-moihsH_U.mjs";
+import { S as upsertStatelyPragma, a as graphToMachineConfig, b as findStatelyPragmaAttachments, c as serializeJS, i as jsonSchemaToTSType, n as contextSchemaToTSType, o as RawCode, r as eventsSchemaToTSType, s as raw, t as graphToXStateTS, x as getStatelyPragma } from "./graphToXStateTS-DV62vO_d.mjs";
 import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
 
 export { RawCode, StatelyApiError, StudioApiError, contextSchemaToTSType, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, eventsSchemaToTSType, findStatelyPragmaAttachments, fromStudioMachine, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/{inspect-BLlM3qKf.d.mts → inspect-CZ8iLJR7.d.mts}

@@ -120,19 +120,13 @@ interface ManualActorOptions {
   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.
+   * Relay session id. Defaults to a random id. This is the `?session=<id>`
+   * value the viz iframe connects with.
    */
   sessionId?: string;
   /** Display name for this system in the visualizer. */
@@ -148,7 +142,7 @@ interface CreateInspectorOptions {
    * `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. */
+  /** Selected actor id to focus on first. Defaults to the first inspected root. */
   selectedActorId?: string;
   /** Panel layout forwarded into the system init message. */
   panels?: {
@@ -171,6 +165,10 @@ interface Inspector {
   readonly actors: ReadonlyMap<string, AdoptedActor>;
   /** The relay sessionId this inspector registered under. */
   readonly sessionId: string;
+  /** Adopt an xstate actor system. Existing actors are backfilled immediately. */
+  inspect(actor: any): {
+    unsubscribe(): void;
+  };
   /** 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;
@@ -201,6 +199,6 @@ interface Inspector {
   /** Tear down the WebSocket + xstate subscription. */
   destroy(): void;
 }
-declare function createStatelyInspector(options: CreateInspectorOptions): Inspector;
+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 };

package/dist/inspect.d.mts

@@ -1,3 +1,3 @@
 import { EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap } from "./protocol.mjs";
-import { a as ManualActorOptions, i as InspectorEvents, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-BLlM3qKf.mjs";
+import { a as ManualActorOptions, i as InspectorEvents, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-CZ8iLJR7.mjs";
 export { AdoptedActor, CreateInspectorOptions, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, Inspector, InspectorEvents, ManualActorOptions, Transport, createStatelyInspector };

package/dist/inspect.mjs

@@ -10,12 +10,10 @@ let nextManualId = 0;
 function generateSessionId() {
 	return `manual-${Date.now()}-${nextManualId++}`;
 }
-function createStatelyInspector(options) {
-	const { url = "ws://localhost:4242", autoOpen = true, actor: rootActor, name, serializeSnapshot = defaultSerializeSnapshot, extractMachineConfig = defaultExtractMachineConfig, selectedActorId, panels, theme, readOnly, depth, transport: injectedTransport } = options;
-	const root = rootActor ? rootActor : null;
-	const rootActorId = root?.sessionId ?? generateSessionId();
-	const sessionId = options.sessionId ?? rootActorId;
-	const displayName = name ?? (root ? `system:${root.id}` : "system:manual");
+function createStatelyInspector(options = {}) {
+	const { url = "ws://localhost:4242", autoOpen = true, name, serializeSnapshot = defaultSerializeSnapshot, extractMachineConfig = defaultExtractMachineConfig, selectedActorId, panels, theme, readOnly, depth, transport: injectedTransport } = options;
+	const sessionId = options.sessionId ?? generateSessionId();
+	const displayName = name ?? "system:manual";
 	let destroyed = false;
 	let initSent = false;
 	const pendingMessages = [];
@@ -92,7 +90,7 @@ function createStatelyInspector(options) {
 			return null;
 		}
 	}
-	function toEntry(actorRef) {
+	function toEntry(actorRef, rootActorId) {
 		return {
 			actorId: actorRef.sessionId,
 			parentActorId: actorRef._parent?.sessionId ?? null,
@@ -116,22 +114,23 @@ function createStatelyInspector(options) {
 	* Walk the actor tree and populate the local `actors` map. Idempotent —
 	* existing entries stay in place but have their snapshot refreshed.
 	*/
-	function backfillActorTree(actorRef) {
+	function backfillActorTree(actorRef, rootActorId) {
 		const existing = actors.get(actorRef.sessionId);
-		const entry = existing ?? toEntry(actorRef);
+		const entry = existing ?? toEntry(actorRef, rootActorId);
 		if (existing) existing.snapshot = snapshotValue(actorRef);
 		else actors.set(entry.actorId, entry);
 		emitRegisterOnce(entry);
 		const children = actorRef.getSnapshot()?.children ?? {};
-		for (const child of Object.values(children)) if (child) backfillActorTree(child);
+		for (const child of Object.values(children)) if (child) backfillActorTree(child, rootActorId);
 	}
+	const inspectedRoots = /* @__PURE__ */ new Map();
 	function sendInit() {
-		if (root) backfillActorTree(root);
+		for (const [rootActorId, { actor }] of inspectedRoots) backfillActorTree(actor, rootActorId);
 		send({
 			type: "@statelyai.system.init",
 			mode: "inspecting",
 			actors: Array.from(actors.values()).map(toSystemEntry),
-			selectedActorId: selectedActorId ?? rootActorId,
+			selectedActorId: selectedActorId ?? inspectedRoots.keys().next().value ?? sessionId,
 			...theme && { theme },
 			...readOnly !== void 0 && { readOnly },
 			...depth !== void 0 && { depth },
@@ -141,9 +140,9 @@ function createStatelyInspector(options) {
 		});
 		initSent = true;
 	}
-	function handleActor(actorRef) {
+	function handleActor(actorRef, rootActorId) {
 		if (actors.has(actorRef.sessionId)) return;
-		const entry = toEntry(actorRef);
+		const entry = toEntry(actorRef, rootActorId);
 		actors.set(entry.actorId, entry);
 		if (!initSent) return;
 		send({
@@ -156,8 +155,8 @@ function createStatelyInspector(options) {
 		});
 		emitRegisterOnce(entry);
 	}
-	function handleSnapshot(actorRef, snapshot, triggeringEvent) {
-		if (!actors.has(actorRef.sessionId)) handleActor(actorRef);
+	function handleSnapshot(actorRef, snapshot, triggeringEvent, rootActorId) {
+		if (!actors.has(actorRef.sessionId)) handleActor(actorRef, rootActorId);
 		const entry = actors.get(actorRef.sessionId);
 		if (!entry) return;
 		const serialized = serializeSnapshot(snapshot);
@@ -183,28 +182,43 @@ function createStatelyInspector(options) {
 			emitLocal("stopped", { actorId: entry.actorId });
 		}
 	}
-	if (root) backfillActorTree(root);
-	const subscription = root ? root.system.inspect((inspectionEvent) => {
-		if (destroyed) return;
-		switch (inspectionEvent.type) {
-			case "@xstate.actor":
-				handleActor(inspectionEvent.actorRef);
-				break;
-			case "@xstate.event":
-				if (inspectionEvent.sourceRef) pendingEventSource.set(inspectionEvent.actorRef.sessionId, inspectionEvent.sourceRef.sessionId);
-				break;
-			case "@xstate.snapshot":
-				handleSnapshot(inspectionEvent.actorRef, inspectionEvent.snapshot, inspectionEvent.event);
-				break;
-			default: break;
-		}
-	}) : null;
+	function inspectActor(actor) {
+		const root = actor;
+		const rootActorId = root.sessionId;
+		const existing = inspectedRoots.get(rootActorId);
+		if (existing) return existing.subscription;
+		const subscription = root.system.inspect((inspectionEvent) => {
+			if (destroyed) return;
+			switch (inspectionEvent.type) {
+				case "@xstate.actor":
+					handleActor(inspectionEvent.actorRef, rootActorId);
+					break;
+				case "@xstate.event":
+					if (inspectionEvent.sourceRef) pendingEventSource.set(inspectionEvent.actorRef.sessionId, inspectionEvent.sourceRef.sessionId);
+					break;
+				case "@xstate.snapshot":
+					handleSnapshot(inspectionEvent.actorRef, inspectionEvent.snapshot, inspectionEvent.event, rootActorId);
+					break;
+				default: break;
+			}
+		});
+		inspectedRoots.set(rootActorId, {
+			actor: root,
+			subscription
+		});
+		backfillActorTree(root, rootActorId);
+		if (initSent) sendInit();
+		return { unsubscribe() {
+			subscription.unsubscribe();
+			inspectedRoots.delete(rootActorId);
+		} };
+	}
 	function manualRegister(id, opts) {
 		if (actors.has(id)) return;
 		const entry = {
 			actorId: id,
 			parentActorId: opts?.parent ?? null,
-			rootId: rootActorId,
+			rootId: sessionId,
 			id,
 			systemId: opts?.systemId,
 			snapshot: opts?.snapshot ?? null,
@@ -252,6 +266,7 @@ function createStatelyInspector(options) {
 		get sessionId() {
 			return sessionId;
 		},
+		inspect: inspectActor,
 		on(event, handler) {
 			if (!localListeners[event]) localListeners[event] = /* @__PURE__ */ new Set();
 			localListeners[event].add(handler);
@@ -273,12 +288,13 @@ function createStatelyInspector(options) {
 			if (destroyed) return;
 			destroyed = true;
 			try {
-				subscription?.unsubscribe();
+				for (const { subscription } of inspectedRoots.values()) subscription.unsubscribe();
 			} catch {}
 			if (ownsTransport) transport.destroy();
 			exportManager.clear("Inspector destroyed");
 			events.clear();
 			actors.clear();
+			inspectedRoots.clear();
 			pendingMessages.length = 0;
 			for (const set of Object.values(localListeners)) set?.clear();
 		}

package/dist/protocol.d.mts

@@ -45,6 +45,7 @@ interface StateSourceLocation extends SourceLocation {
 interface MachineSourceLocations {
   version: 1;
   root?: SourceLocation;
+  statesObject?: StateSourceLocation;
   states: StateSourceLocation[];
   staticValues?: Array<SourceLocation & {
     value: string;
@@ -78,6 +79,12 @@ interface ExportFormatMap {
     options: object;
     result: Record<string, unknown>;
   };
+  d2: {
+    options: {
+      includeLayout?: boolean;
+    };
+    result: string;
+  };
   mermaid: {
     options: object;
     result: string;
@@ -159,6 +166,7 @@ interface MachineInitOptions {
   };
   comments?: CommentsConfig;
   sourceLocations?: MachineSourceLocations;
+  settings?: Record<string, unknown>;
   /**
    * Show a persistent "Save to apply" pill in the embed whenever Viz has
    * local edits that have not yet been saved. Intended for contexts like
@@ -189,6 +197,7 @@ interface ProjectInitOptions {
     activePanels?: string[];
   };
   commentsByMachineId?: Record<string, CommentsConfig>;
+  settings?: Record<string, unknown>;
   unsavedIndicator?: {
     enabled?: boolean;
     mode?: "structural" | "all";
@@ -208,6 +217,7 @@ interface InitMessage {
   activePanels?: string[];
   comments?: CommentsConfig;
   sourceLocations?: MachineSourceLocations;
+  settings?: Record<string, unknown>;
   /** Mirror of `InitOptions.unsavedIndicator`. */
   unsavedIndicator?: {
     enabled?: boolean;
@@ -228,6 +238,7 @@ interface ProjectInitMessage {
   rightPanels?: string[];
   activePanels?: string[];
   commentsByMachineId?: Record<string, CommentsConfig>;
+  settings?: Record<string, unknown>;
   unsavedIndicator?: {
     enabled?: boolean;
     mode?: "structural" | "all";

package/dist/sync.d.mts

@@ -1,4 +1,4 @@
-import { b as DigraphConfig, i as StatelyGraph } from "./graph-DmXh22Zu.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-GeuH-mFK.mjs";
 import { CreateProjectInput, ProjectData, StudioClient, StudioMachineRecord, XStateVersion } from "./studio.mjs";
 import { GraphDiff } from "@statelyai/graph";