@statelyai/sdk 0.28.0 → 0.29.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -90,7 +90,6 @@ embed.init({
90
90
  export: false,
91
91
  ai: false,
92
92
  simulate: false,
93
- navigateHierarchy: false,
94
93
  maxDepth: 1,
95
94
  panels: ["structure", "details", "validations"],
96
95
  },
@@ -101,6 +100,9 @@ embed.on("capabilityDenied", (event) => {
101
100
  });
102
101
  ```
103
102
 
103
+ Hierarchy navigation is always available, including in read-only and
104
+ restricted embeds.
105
+
104
106
  `readOnlyReason: 'free-plan'` shows a persistent **Upgrade to edit** action.
105
107
  Use `access-unverified` when reopening or signing in, rather than upgrading, is
106
108
  the appropriate recovery action.
@@ -184,6 +186,9 @@ The client namespaces map one-to-one onto the server-owned `/api/v1` contract:
184
186
  `projects.ensure(input)` is a client workflow composed of `projects.list`,
185
187
  `projects.get`, and `projects.create`, not a route.
186
188
 
189
+ `machines.get(machineId)` preserves the stored `definition` and also exposes a
190
+ public `graph` property when the server can provide a canonical XGraph.
191
+
187
192
  `baseUrl` defaults to `https://editor.stately.ai`. Do not target
188
193
  `stately.ai/registry` directly: Registry URLs are deprecated for clients, and
189
194
  the server reaches the Registry itself when it is configured to.
@@ -298,7 +303,10 @@ relay. An explicit `url` wins over `STATELY_INSPECT_URL`, which wins over the
298
303
  hosted default. See `@statelyai/sdk/protocol` for the versioned message and
299
304
  `?r=` query contract. SDK producer registration also reports its SDK version
300
305
  and coarse browser, Node, or unknown runtime; it never adds inspection payloads
301
- to registration metadata.
306
+ to registration metadata. Protocol mismatches and registration errors reject
307
+ `ready` and close the connection without retrying. Browser transports use
308
+ application close code `4002`, with a fixed reason that stays within the
309
+ WebSocket UTF-8 length limit.
302
310
 
303
311
  ### CLI and sync
304
312
 
@@ -6,7 +6,6 @@ interface EditorCapabilities {
6
6
  ai?: boolean;
7
7
  simulate?: boolean;
8
8
  inspect?: boolean;
9
- navigateHierarchy?: boolean;
10
9
  maxDepth?: number;
11
10
  panels?: string[];
12
11
  commands?: string[];
@@ -14,7 +14,6 @@ const editorCapabilitiesSchema = object({
14
14
  ai: boolean().optional(),
15
15
  simulate: boolean().optional(),
16
16
  inspect: boolean().optional(),
17
- navigateHierarchy: boolean().optional(),
18
17
  maxDepth: number().optional(),
19
18
  panels: array(string()).optional(),
20
19
  commands: array(string()).optional()
@@ -1,5 +1,5 @@
1
1
  import { t as EmbedPanelConfig } from "./embedPanel-Bpbq4sfJ.mjs";
2
- import { a as EditorSyncParseRequest, d as EditorSyncTextReplacement, f as MachineSourceLocations, i as EditorSyncApplyResponse, n as EditorSyncAccess, o as EditorSyncParseResponse, r as EditorSyncApplyRequest, s as EditorSyncSourceDocument, t as EditorCapabilities } from "./editor-sync-types-CTKArS8n.mjs";
2
+ import { a as EditorSyncParseRequest, d as EditorSyncTextReplacement, f as MachineSourceLocations, i as EditorSyncApplyResponse, n as EditorSyncAccess, o as EditorSyncParseResponse, r as EditorSyncApplyRequest, s as EditorSyncSourceDocument, t as EditorCapabilities } from "./editor-sync-types-DB1N6QUK.mjs";
3
3
 
4
4
  //#region src/editorHostProtocol.d.ts
5
5
  declare const EDITOR_PROTOCOL_VERSION = 1;
@@ -1,2 +1,2 @@
1
- import { a as EditorSyncError, c as fetchEditorSyncAccess, d as EditorHostExportFormat, f as EditorHostInboundMessage, h as EditorHostValidationIssue, i as EditorSyncBackend, l as EDITOR_PROTOCOL_VERSION, m as EditorHostOutboundMessage, n as EditorHostSessionOptions, o as RemoteEditorSyncBackendOptions, p as EditorHostInitOptions, r as EditorSourceHost, s as createRemoteEditorSyncBackend, t as EditorHostSession, u as EditorHostDiagnostic } from "./editorHostSession-CWAuoMtC.mjs";
1
+ import { a as EditorSyncError, c as fetchEditorSyncAccess, d as EditorHostExportFormat, f as EditorHostInboundMessage, h as EditorHostValidationIssue, i as EditorSyncBackend, l as EDITOR_PROTOCOL_VERSION, m as EditorHostOutboundMessage, n as EditorHostSessionOptions, o as RemoteEditorSyncBackendOptions, p as EditorHostInitOptions, r as EditorSourceHost, s as createRemoteEditorSyncBackend, t as EditorHostSession, u as EditorHostDiagnostic } from "./editorHostSession-vSt07IJV.mjs";
2
2
  export { EDITOR_PROTOCOL_VERSION, EditorHostDiagnostic, EditorHostExportFormat, EditorHostInboundMessage, EditorHostInitOptions, EditorHostOutboundMessage, EditorHostSession, EditorHostSessionOptions, EditorHostValidationIssue, EditorSourceHost, EditorSyncBackend, EditorSyncError, RemoteEditorSyncBackendOptions, createRemoteEditorSyncBackend, fetchEditorSyncAccess };
@@ -1,5 +1,5 @@
1
1
  import "./openapi-BTDjYWXd.mjs";
2
2
  import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
3
- import { i as fetchEditorSyncAccess, n as EditorSyncError, r as createRemoteEditorSyncBackend, t as EditorHostSession } from "./editorHostSession-shrjfosC.mjs";
3
+ import { i as fetchEditorSyncAccess, n as EditorSyncError, r as createRemoteEditorSyncBackend, t as EditorHostSession } from "./editorHostSession-DNpXPNAc.mjs";
4
4
 
5
5
  export { EDITOR_PROTOCOL_VERSION, EditorHostSession, EditorSyncError, createRemoteEditorSyncBackend, fetchEditorSyncAccess };
package/dist/embed.d.mts CHANGED
@@ -1,5 +1,5 @@
1
- import { i as ProfileManifest } from "./index-D2I1qPsf.mjs";
2
- import { i as StatelyGraph } from "./graph-BwHnhzpC.mjs";
1
+ import { i as ProfileManifest } from "./index-D4pdeDpT.mjs";
2
+ import { i as StatelyGraph } from "./graph-C8E1Exad.mjs";
3
3
  import { n as EmbedPanelPosition, t as EmbedPanelConfig } from "./embedPanel-Bpbq4sfJ.mjs";
4
4
  import { CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExtensionsManifest, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, MachineInitOptions, MachineSourceLocations, MachineVersionAutoSaveOptions, ProjectEmbedMachine, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceProject, UploadResult } from "./protocol.mjs";
5
5
  import { AssetUploadAdapter } from "./assetStorage.mjs";
package/dist/embed.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-D_SqbrSy.mjs";
1
+ import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-DC3yW9Dk.mjs";
2
2
  import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
3
3
 
4
4
  //#region src/embed.ts
@@ -80,6 +80,7 @@ function extractInitOptions(options) {
80
80
  mode: options.mode,
81
81
  theme: options.theme,
82
82
  readOnly: options.readOnly,
83
+ readOnlyReason: options.readOnlyReason,
83
84
  depth: options.depth,
84
85
  capabilities: options.capabilities,
85
86
  examples: options.examples,
@@ -1,4 +1,4 @@
1
- import { t as CodeExpression } from "./index-D2I1qPsf.mjs";
1
+ import { t as CodeExpression } from "./index-D4pdeDpT.mjs";
2
2
  import * as _statelyai_graph0 from "@statelyai/graph";
3
3
  import { Graph } from "@statelyai/graph";
4
4
 
package/dist/graph.d.mts CHANGED
@@ -1,2 +1,2 @@
1
- import { _ as studioMachineConverter, a as StatelyGraphData, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, n as StatelyActorImplementation, o as StatelyGuard, p as StudioEventTypeData, r as StatelyEdgeData, s as StatelyImplementation, t as StatelyAction, u as StatelyTagImplementation, v as toStudioMachine } from "./graph-BwHnhzpC.mjs";
1
+ import { _ as studioMachineConverter, a as StatelyGraphData, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, n as StatelyActorImplementation, o as StatelyGuard, p as StudioEventTypeData, r as StatelyEdgeData, s as StatelyImplementation, t as StatelyAction, u as StatelyTagImplementation, v as toStudioMachine } from "./graph-C8E1Exad.mjs";
2
2
  export { StatelyAction, StatelyActorImplementation, StatelyEdgeData, StatelyGraph, StatelyGraphData, StatelyGuard, StatelyImplementation, StatelyInvoke, StatelyNodeData, StatelyTagImplementation, StudioAction, StudioEdge, StudioEventTypeData, StudioMachine, StudioNode, fromStudioMachine, studioMachineConverter, toStudioMachine };
@@ -2738,6 +2738,11 @@ interface CodeImport {
2738
2738
  importKind?: 'named' | 'default' | 'namespace';
2739
2739
  version?: string;
2740
2740
  }
2741
+ /**
2742
+ * A scalar `context`/`input`/`output` literal, kept verbatim from the source
2743
+ * instead of being wrapped as a code expression.
2744
+ */
2745
+ type ScalarGraphValue = string | number | boolean | null;
2741
2746
  interface CodeGenInvoke {
2742
2747
  src: string;
2743
2748
  /** Exact authored actor-logic expression for inline/direct actor sources. */
@@ -2746,19 +2751,19 @@ interface CodeGenInvoke {
2746
2751
  invocationId?: string;
2747
2752
  registryKey?: string;
2748
2753
  timeout?: number | string | CodeExpression;
2749
- input?: Record<string, unknown> | CodeExpression;
2750
- output?: Record<string, unknown> | CodeExpression;
2754
+ input?: Record<string, unknown> | CodeExpression | ScalarGraphValue;
2755
+ output?: Record<string, unknown> | CodeExpression | ScalarGraphValue;
2751
2756
  }
2752
2757
  interface CodeGenNodeData {
2753
2758
  nodeId?: string | null;
2754
2759
  key: string;
2755
2760
  type?: 'normal' | 'parallel' | 'final' | 'history' | 'choice' | null;
2756
2761
  initialId?: string | null;
2757
- initialInput?: Record<string, unknown> | CodeExpression;
2762
+ initialInput?: Record<string, unknown> | CodeExpression | ScalarGraphValue;
2758
2763
  timeout?: number | string | CodeExpression;
2759
2764
  route?: Record<string, unknown> | CodeExpression;
2760
2765
  history?: 'shallow' | 'deep' | boolean;
2761
- output?: Record<string, unknown> | CodeExpression;
2766
+ output?: Record<string, unknown> | CodeExpression | ScalarGraphValue;
2762
2767
  schemas?: {
2763
2768
  context?: Record<string, JSONSchema7> | null;
2764
2769
  input?: JSONSchema7 | null;
@@ -2782,7 +2787,7 @@ interface CodeGenEdgeData {
2782
2787
  transitionType?: 'normal' | 'targetless' | 'reenter';
2783
2788
  guard?: CodeGenGuard | null;
2784
2789
  context?: Record<string, unknown> | CodeExpression;
2785
- input?: Record<string, unknown> | CodeExpression;
2790
+ input?: Record<string, unknown> | CodeExpression | ScalarGraphValue;
2786
2791
  actions?: CodeGenAction[];
2787
2792
  description?: string | null;
2788
2793
  color?: string;
@@ -2865,6 +2870,13 @@ interface MachineConfigOptions {
2865
2870
  * "Guard 'undefined' is not implemented" the moment that transition is taken.
2866
2871
  */
2867
2872
  inlineGuardsAsTypeRef?: boolean;
2873
+ /**
2874
+ * Keep `xstate.choose` as a structured `{ type, params }` action instead of
2875
+ * lowering it to the v5 `enqueueActions` code expression. The v6 renderer
2876
+ * needs this: v6 has neither `choose` nor `enqueueActions`, so it lowers the
2877
+ * branches itself into the `enq` function body.
2878
+ */
2879
+ keepChooseStructured?: boolean;
2868
2880
  }
2869
2881
  declare function graphToMachineConfig(graph: CodeGenGraph, options?: MachineConfigOptions): UnknownMachineConfig; //#endregion
2870
2882
  //#region src/serializeJS.d.ts
@@ -2956,6 +2968,26 @@ interface XStateTSOptions extends MachineConfigOptions {
2956
2968
  xstateV6SchemaFormat?: 'types' | 'zod';
2957
2969
  }
2958
2970
  declare function graphToXStateTS(graph: CodeGenGraph, options?: XStateTSOptions): string; //#endregion
2971
+ //#region src/graphToXStateV4TS.d.ts
2972
+ interface XStateV4TSOptions extends MachineConfigOptions {
2973
+ exportStyle?: 'named' | 'default' | 'none';
2974
+ targetLanguage?: 'typescript' | 'javascript';
2975
+ }
2976
+ /**
2977
+ * Emits XState **v4** (deprecated) TypeScript for a graph.
2978
+ *
2979
+ * The v4 surface differs from v5 in ways this emitter downgrades:
2980
+ * `createMachine(config, options)` instead of `setup().createMachine()`,
2981
+ * `cond` instead of `guard`, `services` instead of `actors`, `internal: false`
2982
+ * instead of `reenter: true`, `done.invoke.X` / `error.platform.X` /
2983
+ * `done.state.X` event names, and positional `(context, event)` implementation
2984
+ * arguments (enabled by `predictableActionArguments`).
2985
+ *
2986
+ * Concepts with no v4 equivalent (`emit`, `spawnChild`, `enqueueActions`,
2987
+ * actor-logic creators such as `fromPromise`) are emitted verbatim with a
2988
+ * `// TODO: v5-only` marker rather than silently dropped.
2989
+ */
2990
+ declare function graphToXStateV4TS(graph: CodeGenGraph, options?: XStateV4TSOptions): string; //#endregion
2959
2991
  //#region src/graphToXStateFSM.d.ts
2960
2992
  interface XStateFSMOptions {
2961
2993
  exportStyle?: 'named' | 'default' | 'none';
@@ -2979,4 +3011,4 @@ declare function contextSchemaToTSType(context: Record<string, JSONSchema7> | nu
2979
3011
  declare function eventsSchemaToTSType(events: Record<string, JSONSchema7> | null | undefined): string | null; //#endregion
2980
3012
  //#region src/jsonSchemaToZod.d.ts
2981
3013
  //#endregion
2982
- export { ZodString as A, ZodEnum as C, ZodObject as D, ZodNumber as E, ZodUnknown as M, output as N, ZodOptional as O, $strip as P, ZodArray as S, ZodNullable as T, ActionLocation as _, RawCode as a, GraphPatch as b, contextSchemaToTSType as c, graphToMachineConfig as d, graphToXStateFSM as f, serializeJS as g, raw as h, ProfileManifest as i, ZodUnion as j, ZodRecord as k, eventsSchemaToTSType as l, jsonSchemaToTSType as m, CodeGenGraph as n, XStateFSMOptions as o, graphToXStateTS as p, MachineConfigOptions as r, XStateTSOptions as s, CodeExpression as t, getXStateFSMCompatibilityIssues as u, CanvasColor as v, ZodLiteral as w, ImplementationSourceType as x, EditorStateType as y };
3014
+ export { ZodObject as A, ImplementationSourceType as C, ZodLiteral as D, ZodEnum as E, ZodUnknown as F, output as I, $loose as L, ZodRecord as M, ZodString as N, ZodNullable as O, ZodUnion as P, $strip as R, GraphPatch as S, ZodBoolean as T, raw as _, RawCode as a, CanvasColor as b, XStateV4TSOptions as c, getXStateFSMCompatibilityIssues as d, graphToMachineConfig as f, jsonSchemaToTSType as g, graphToXStateV4TS as h, ProfileManifest as i, ZodOptional as j, ZodNumber as k, contextSchemaToTSType as l, graphToXStateTS as m, CodeGenGraph as n, XStateFSMOptions as o, graphToXStateFSM as p, MachineConfigOptions as r, XStateTSOptions as s, CodeExpression as t, eventsSchemaToTSType as u, serializeJS as v, ZodArray as w, EditorStateType as x, ActionLocation as y };
package/dist/index.d.mts CHANGED
@@ -1,14 +1,14 @@
1
1
  import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
2
- import { _ as ActionLocation, a as RawCode, b as GraphPatch, c as contextSchemaToTSType, d as graphToMachineConfig, f as graphToXStateFSM, g as serializeJS, h as raw, l as eventsSchemaToTSType, m as jsonSchemaToTSType, n as CodeGenGraph, o as XStateFSMOptions, p as graphToXStateTS, r as MachineConfigOptions, s as XStateTSOptions, u as getXStateFSMCompatibilityIssues } from "./index-D2I1qPsf.mjs";
3
- 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-BwHnhzpC.mjs";
2
+ import { S as GraphPatch, _ as raw, a as RawCode, c as XStateV4TSOptions, d as getXStateFSMCompatibilityIssues, f as graphToMachineConfig, g as jsonSchemaToTSType, h as graphToXStateV4TS, l as contextSchemaToTSType, m as graphToXStateTS, n as CodeGenGraph, o as XStateFSMOptions, p as graphToXStateFSM, r as MachineConfigOptions, s as XStateTSOptions, u as eventsSchemaToTSType, v as serializeJS, y as ActionLocation } from "./index-D4pdeDpT.mjs";
3
+ 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-C8E1Exad.mjs";
4
4
  import { n as EmbedPanelPosition, t as EmbedPanelConfig } from "./embedPanel-Bpbq4sfJ.mjs";
5
5
  import { CapabilityDeniedCapability, CapabilityDeniedEvent, CommentsConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExample, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitOptions, InspectionAction, InspectionSentEvent, InspectionTakenTransition, MachineVersionAutoSaveOptions, ProjectEmbedMachine, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceProject, UploadResult, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine } from "./protocol.mjs";
6
6
  import { AssetUploadAdapter, AssetUploadContext, AssetUploadRequest, CreateS3AssetUploadAdapterOptions, CreateSupabaseAssetUploadAdapterOptions, S3UploadTarget, SupabaseStorageClient, createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
7
7
  import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-BPyCCHYo.mjs";
8
- import { c as fetchEditorSyncAccess, d as EditorHostExportFormat, f as EditorHostInboundMessage, h as EditorHostValidationIssue, i as EditorSyncBackend, l as EDITOR_PROTOCOL_VERSION, m as EditorHostOutboundMessage, n as EditorHostSessionOptions, o as RemoteEditorSyncBackendOptions, p as EditorHostInitOptions, r as EditorSourceHost, s as createRemoteEditorSyncBackend, t as EditorHostSession, u as EditorHostDiagnostic } from "./editorHostSession-CWAuoMtC.mjs";
8
+ import { c as fetchEditorSyncAccess, d as EditorHostExportFormat, f as EditorHostInboundMessage, h as EditorHostValidationIssue, i as EditorSyncBackend, l as EDITOR_PROTOCOL_VERSION, m as EditorHostOutboundMessage, n as EditorHostSessionOptions, o as RemoteEditorSyncBackendOptions, p as EditorHostInitOptions, r as EditorSourceHost, s as createRemoteEditorSyncBackend, t as EditorHostSession, u as EditorHostDiagnostic } from "./editorHostSession-vSt07IJV.mjs";
9
9
  import { AssetConfig, EmbedEntity, EmbedFormatContext, EmbedFormatDefinition, EmbedGraph, EmbedProfileDefinition, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
10
10
  import { _ as createWebSocketTransport, a as InspectedTransition, c as InspectorDiscoveryEntry, d as ManualActorOptions, f as createInspector, g as createPostMessageTransport, h as TransportFailure, i as InspectedSnapshot, l as InspectorEvents, m as Transport, n as CreateInspectorOptions, o as Inspector, p as createStatelyInspector, r as InspectedEvent, s as InspectorConnection, t as AdoptedActor, u as InspectorInspectionEvent } from "./inspect-D61HS-t7.mjs";
11
- import { A as Machine, C as StudioMachineRecord, D as VerifyApiKeyResponse, E as UpdateProjectInput, F as ProjectVisibility, I as VerifyResult, L as XStateVersion, M as Project, N as ProjectMachineSummary, O as createStatelyClient, P as ProjectSummary, R as ResourceErrorCode, S as StudioClientOptions, T as UpdateMachineInput, _ as ProjectMachine, a as CreateMachineTemplate, b as StudioApiErrorOptions, c as EnsureProjectInput, d as ExtractedMachine, f as GetMachineOptions, g as ProjectData, h as LegacyUpdateMachineInput, i as CreateMachineInput, j as MachineVersion, k as ExtractedMachines, l as ExtractMachinesInput, m as LegacyProjectVisibility, n as CreateMachineFromDefinitionInput, o as CreateProjectInput, r as CreateMachineFromTemplateInput, s as DEFAULT_STATELY_BASE_URL, t as ConnectedRepo, u as ExtractMachinesResponse, v as RepoType, w as StudioRequestOptions, x as StudioClient, y as StudioApiError } from "./studio-B9-1Ynrx.mjs";
11
+ import { A as Machine, C as StudioMachineRecord, D as VerifyApiKeyResponse, E as UpdateProjectInput, F as ProjectVisibility, I as VerifyResult, L as XStateVersion, M as Project, N as ProjectMachineSummary, O as createStatelyClient, P as ProjectSummary, R as ResourceErrorCode, S as StudioClientOptions, T as UpdateMachineInput, _ as ProjectMachine, a as CreateMachineTemplate, b as StudioApiErrorOptions, c as EnsureProjectInput, d as ExtractedMachine, f as GetMachineOptions, g as ProjectData, h as LegacyUpdateMachineInput, i as CreateMachineInput, j as MachineVersion, k as ExtractedMachines, l as ExtractMachinesInput, m as LegacyProjectVisibility, n as CreateMachineFromDefinitionInput, o as CreateProjectInput, r as CreateMachineFromTemplateInput, s as DEFAULT_STATELY_BASE_URL, t as ConnectedRepo, u as ExtractMachinesResponse, v as RepoType, w as StudioRequestOptions, x as StudioClient, y as StudioApiError } from "./studio-D-yqFd0u.mjs";
12
12
  import { OAuthAuthorizationServerMetadata, OAuthClientRegistrationResponse, OAuthProtectedResourceMetadata, OAuthTokenResponse, PkcePair, buildAuthorizeUrl, createPkcePair, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, refreshToken, registerOAuthClient } from "./oauth.mjs";
13
13
  import { PlanSyncOptions, PullSyncResult, PushLocalMachineLinksResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";
14
14
  import { CreateInspectionRelayOptions, InspectionRelay, InspectionRelayEffect, InspectionRelayPeer, InspectionRelayRole, InspectionRelaySnapshot, createInspectionRelay } from "./relay.mjs";
@@ -34,4 +34,4 @@ declare function findStatelyPragmaAttachments(sourceText: string, fileName?: str
34
34
  declare function getStatelyPragma(sourceText: string, fileName?: string, machineIndex?: number): StatelyPragma | undefined;
35
35
  declare function upsertStatelyPragma(sourceText: string, id: string, options?: UpsertStatelyPragmaOptions): string;
36
36
  //#endregion
37
- export { type ActionLocation, type AdoptedActor, type AssetConfig, type AssetUploadAdapter, type AssetUploadContext, type AssetUploadRequest, type CapabilityDeniedCapability, type CapabilityDeniedEvent, type CodeGenGraph, type CommentsConfig, type ConnectedRepo, type CreateInspectionRelayOptions, type CreateInspectorOptions, type CreateMachineFromDefinitionInput, type CreateMachineFromTemplateInput, type CreateMachineInput, type CreateMachineTemplate, type CreateProjectInput, type CreateS3AssetUploadAdapterOptions, type CreateSupabaseAssetUploadAdapterOptions, DEFAULT_STATELY_BASE_URL, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, EDITOR_PROTOCOL_VERSION, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, type EditorCapabilities, type EditorHostDiagnostic, type EditorHostExportFormat, type EditorHostInboundMessage, type EditorHostInitOptions, type EditorHostOutboundMessage, EditorHostSession, type EditorHostSessionOptions, type EditorHostValidationIssue, type EditorSourceHost, type EditorSyncBackend, type EmbedDocument, type EmbedDocumentLanguage, type EmbedEntity, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedExample, type EmbedFormatContext, type EmbedFormatDefinition, type EmbedGraph, type EmbedMode, type EmbedPanelConfig, type EmbedPanelPosition, type EmbedProfileDefinition, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesInput, type ExtractMachinesResponse, type ExtractedMachine, type ExtractedMachines, type GetMachineOptions, type GraphPatch, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, type InitOptions, type InspectedEvent, type InspectedSnapshot, type InspectedTransition, type InspectionAction, type InspectionRelay, type InspectionRelayEffect, type InspectionRelayPeer, type InspectionRelayRole, type InspectionRelaySnapshot, type InspectionSentEvent, type InspectionTakenTransition, type Inspector, type InspectorConnection, type InspectorDiscoveryEntry, type InspectorEvents, type InspectorInspectionEvent, type LegacyProjectVisibility, type LegacyUpdateMachineInput, type Machine, type MachineConfigOptions, type MachineVersion, type MachineVersionAutoSaveOptions, type ManualActorOptions, type OAuthAuthorizationServerMetadata, type OAuthClientRegistrationResponse, type OAuthProtectedResourceMetadata, type OAuthTokenResponse, type PkcePair, type PlanSyncOptions, type Project, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectMachineSummary, type ProjectSummary, type ProjectVisibility, type ProjectWorkspaceAction, type ProjectWorkspaceActionIcon, type ProjectWorkspaceCapabilities, type ProjectWorkspaceConfig, type ProjectWorkspaceMachine, type ProjectWorkspaceMachineOrigin, type ProjectWorkspaceProject, type PullSyncResult, type PushLocalMachineLinksResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RemoteEditorSyncBackendOptions, type RepoType, type ResolvedSyncInput, type ResourceErrorCode, type S3UploadTarget, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyAuthMode, type StatelyCredential, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioApiErrorOptions, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type StudioRequestOptions, type SupabaseStorageClient, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type TransportFailure, type UpdateMachineInput, type UpdateProjectInput, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type VerifyResult, type XStateFSMOptions, type XStateTSOptions, type XStateVersion, assertEmbedExamples, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createRemoteEditorSyncBackend, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, fetchEditorSyncAccess, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, getXStateFSMCompatibilityIssues, graphToMachineConfig, graphToXStateFSM, graphToXStateTS, isEmbedExample, isEmbedExampleMachine, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
37
+ export { type ActionLocation, type AdoptedActor, type AssetConfig, type AssetUploadAdapter, type AssetUploadContext, type AssetUploadRequest, type CapabilityDeniedCapability, type CapabilityDeniedEvent, type CodeGenGraph, type CommentsConfig, type ConnectedRepo, type CreateInspectionRelayOptions, type CreateInspectorOptions, type CreateMachineFromDefinitionInput, type CreateMachineFromTemplateInput, type CreateMachineInput, type CreateMachineTemplate, type CreateProjectInput, type CreateS3AssetUploadAdapterOptions, type CreateSupabaseAssetUploadAdapterOptions, DEFAULT_STATELY_BASE_URL, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, EDITOR_PROTOCOL_VERSION, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, type EditorCapabilities, type EditorHostDiagnostic, type EditorHostExportFormat, type EditorHostInboundMessage, type EditorHostInitOptions, type EditorHostOutboundMessage, EditorHostSession, type EditorHostSessionOptions, type EditorHostValidationIssue, type EditorSourceHost, type EditorSyncBackend, type EmbedDocument, type EmbedDocumentLanguage, type EmbedEntity, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedExample, type EmbedFormatContext, type EmbedFormatDefinition, type EmbedGraph, type EmbedMode, type EmbedPanelConfig, type EmbedPanelPosition, type EmbedProfileDefinition, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesInput, type ExtractMachinesResponse, type ExtractedMachine, type ExtractedMachines, type GetMachineOptions, type GraphPatch, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, type InitOptions, type InspectedEvent, type InspectedSnapshot, type InspectedTransition, type InspectionAction, type InspectionRelay, type InspectionRelayEffect, type InspectionRelayPeer, type InspectionRelayRole, type InspectionRelaySnapshot, type InspectionSentEvent, type InspectionTakenTransition, type Inspector, type InspectorConnection, type InspectorDiscoveryEntry, type InspectorEvents, type InspectorInspectionEvent, type LegacyProjectVisibility, type LegacyUpdateMachineInput, type Machine, type MachineConfigOptions, type MachineVersion, type MachineVersionAutoSaveOptions, type ManualActorOptions, type OAuthAuthorizationServerMetadata, type OAuthClientRegistrationResponse, type OAuthProtectedResourceMetadata, type OAuthTokenResponse, type PkcePair, type PlanSyncOptions, type Project, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectMachineSummary, type ProjectSummary, type ProjectVisibility, type ProjectWorkspaceAction, type ProjectWorkspaceActionIcon, type ProjectWorkspaceCapabilities, type ProjectWorkspaceConfig, type ProjectWorkspaceMachine, type ProjectWorkspaceMachineOrigin, type ProjectWorkspaceProject, type PullSyncResult, type PushLocalMachineLinksResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RemoteEditorSyncBackendOptions, type RepoType, type ResolvedSyncInput, type ResourceErrorCode, type S3UploadTarget, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyAuthMode, type StatelyCredential, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioApiErrorOptions, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type StudioRequestOptions, type SupabaseStorageClient, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type TransportFailure, type UpdateMachineInput, type UpdateProjectInput, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type VerifyResult, type XStateFSMOptions, type XStateTSOptions, type XStateV4TSOptions, type XStateVersion, assertEmbedExamples, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createRemoteEditorSyncBackend, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, fetchEditorSyncAccess, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, getXStateFSMCompatibilityIssues, graphToMachineConfig, graphToXStateFSM, graphToXStateTS, graphToXStateV4TS, isEmbedExample, isEmbedExampleMachine, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
package/dist/index.mjs CHANGED
@@ -1,17 +1,17 @@
1
1
  import "./openapi-BTDjYWXd.mjs";
2
2
  import { EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine } from "./protocol.mjs";
3
- import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-D_SqbrSy.mjs";
3
+ import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-DC3yW9Dk.mjs";
4
4
  import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
5
5
  import { createStatelyEmbed } from "./embed.mjs";
6
- import { i as fetchEditorSyncAccess, r as createRemoteEditorSyncBackend, t as EditorHostSession } from "./editorHostSession-shrjfosC.mjs";
7
- import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-CNkxMZyz.mjs";
8
- import { a as RawCode, d as getXStateFSMCompatibilityIssues, g as jsonSchemaToTSType, h as graphToXStateTS, m as graphToXStateFSM, n as getStatelyPragma, p as graphToMachineConfig, r as upsertStatelyPragma, s as contextSchemaToTSType, t as findStatelyPragmaAttachments, u as eventsSchemaToTSType, v as raw, y as serializeJS } from "./statelyPragma-ByF0-L-N.mjs";
6
+ import { i as fetchEditorSyncAccess, r as createRemoteEditorSyncBackend, t as EditorHostSession } from "./editorHostSession-DNpXPNAc.mjs";
7
+ import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-rSI54Ese.mjs";
8
+ import { _ as jsonSchemaToTSType, a as RawCode, b as serializeJS, d as getXStateFSMCompatibilityIssues, g as graphToXStateV4TS, h as graphToXStateTS, m as graphToXStateFSM, n as getStatelyPragma, p as graphToMachineConfig, r as upsertStatelyPragma, s as contextSchemaToTSType, t as findStatelyPragmaAttachments, u as eventsSchemaToTSType, y as raw } from "./statelyPragma-p1vu8PmH.mjs";
9
9
  import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
10
- import { n as createStatelyInspector, t as createInspector } from "./inspect-DSDnyzZ5.mjs";
10
+ import { n as createStatelyInspector, t as createInspector } from "./inspect-dmCvrIl1.mjs";
11
11
  import { createAuthorizationHeader, getCredentialToken } from "./auth.mjs";
12
12
  import { buildAuthorizeUrl, createPkcePair, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, refreshToken, registerOAuthClient } from "./oauth.mjs";
13
13
  import { StatelyApiError, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
14
14
  import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
15
15
  import { createInspectionRelay } from "./relay.mjs";
16
16
 
17
- export { DEFAULT_STATELY_BASE_URL, EDITOR_PROTOCOL_VERSION, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorHostSession, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, RawCode, StatelyApiError, StudioApiError, assertEmbedExamples, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createRemoteEditorSyncBackend, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, fetchEditorSyncAccess, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, getXStateFSMCompatibilityIssues, graphToMachineConfig, graphToXStateFSM, graphToXStateTS, isEmbedExample, isEmbedExampleMachine, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
17
+ export { DEFAULT_STATELY_BASE_URL, EDITOR_PROTOCOL_VERSION, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorHostSession, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, RawCode, StatelyApiError, StudioApiError, assertEmbedExamples, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createRemoteEditorSyncBackend, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, fetchEditorSyncAccess, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, getXStateFSMCompatibilityIssues, graphToMachineConfig, graphToXStateFSM, graphToXStateTS, graphToXStateV4TS, isEmbedExample, isEmbedExampleMachine, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
@@ -1,5 +1,5 @@
1
1
  import { INSPECTION_PROTOCOL_VERSION, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
2
- import { a as createEventRegistry, i as createWebSocketTransport, n as inspectionRuntime, o as createPendingExportManager, t as SDK_VERSION } from "./version-D_SqbrSy.mjs";
2
+ import { a as createEventRegistry, i as createWebSocketTransport, n as inspectionRuntime, o as createPendingExportManager, t as SDK_VERSION } from "./version-DC3yW9Dk.mjs";
3
3
 
4
4
  //#region src/openBrowser.ts
5
5
  async function openBrowser(url) {
package/dist/inspect.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import "./version-D_SqbrSy.mjs";
2
- import { n as createStatelyInspector, t as createInspector } from "./inspect-DSDnyzZ5.mjs";
1
+ import "./version-DC3yW9Dk.mjs";
2
+ import { n as createStatelyInspector, t as createInspector } from "./inspect-dmCvrIl1.mjs";
3
3
 
4
4
  export { createInspector, createStatelyInspector };
@@ -1,2 +1,2 @@
1
- import { _ as ActionLocation, b as GraphPatch, v as CanvasColor, x as ImplementationSourceType, y as EditorStateType } from "./index-D2I1qPsf.mjs";
1
+ import { C as ImplementationSourceType, S as GraphPatch, b as CanvasColor, x as EditorStateType, y as ActionLocation } from "./index-D4pdeDpT.mjs";
2
2
  export { type ActionLocation, type CanvasColor, type EditorStateType, type GraphPatch, type ImplementationSourceType };
@@ -1,7 +1,7 @@
1
- import { i as ProfileManifest } from "./index-D2I1qPsf.mjs";
2
- import { i as StatelyGraph } from "./graph-BwHnhzpC.mjs";
1
+ import { i as ProfileManifest } from "./index-D4pdeDpT.mjs";
2
+ import { i as StatelyGraph } from "./graph-C8E1Exad.mjs";
3
3
  import { n as EmbedPanelPosition, t as EmbedPanelConfig } from "./embedPanel-Bpbq4sfJ.mjs";
4
- import { c as EditorSyncSourceLocation, f as MachineSourceLocations$1, l as EditorSyncSourceRange, t as EditorCapabilities$1, u as EditorSyncStateSourceLocation } from "./editor-sync-types-CTKArS8n.mjs";
4
+ import { c as EditorSyncSourceLocation, f as MachineSourceLocations$1, l as EditorSyncSourceRange, t as EditorCapabilities$1, u as EditorSyncStateSourceLocation } from "./editor-sync-types-DB1N6QUK.mjs";
5
5
 
6
6
  //#region src/protocol.d.ts
7
7
  /** Query parameter carrying the unguessable inspection room capability. */
@@ -144,10 +144,10 @@ interface ValidationIssue {
144
144
  }
145
145
  type EditorCapabilities = EditorCapabilities$1;
146
146
  type ReadOnlyReason = 'free-plan' | 'access-unverified';
147
- type CapabilityDeniedCapability = 'edit' | 'export' | 'ai' | 'simulate' | 'inspect' | 'navigateHierarchy' | 'panel' | 'mode';
147
+ type CapabilityDeniedCapability = 'edit' | 'export' | 'ai' | 'simulate' | 'inspect' | 'panel' | 'mode';
148
148
  interface CapabilityDeniedEvent {
149
149
  capability: CapabilityDeniedCapability;
150
- action: 'openPanel' | 'openDialog' | 'editSource' | 'navigateHierarchy' | 'setMode' | 'simulationStart' | 'inspectStart' | 'retrieve';
150
+ action: 'openPanel' | 'openDialog' | 'editSource' | 'setMode' | 'simulationStart' | 'inspectStart' | 'retrieve';
151
151
  requested?: string;
152
152
  message: string;
153
153
  dedupeKey: string;
@@ -369,6 +369,7 @@ interface ProjectInitOptions {
369
369
  mode?: EmbedMode;
370
370
  theme?: 'light' | 'dark';
371
371
  readOnly?: boolean;
372
+ readOnlyReason?: ReadOnlyReason;
372
373
  depth?: number;
373
374
  capabilities?: EditorCapabilities;
374
375
  examples?: readonly EmbedExample[];
@@ -451,6 +452,7 @@ interface ProjectInitMessage {
451
452
  mode?: EmbedMode;
452
453
  theme?: 'light' | 'dark';
453
454
  readOnly?: boolean;
455
+ readOnlyReason?: ReadOnlyReason;
454
456
  depth?: number;
455
457
  capabilities?: EditorCapabilities;
456
458
  examples?: readonly EmbedExample[];