narraleaf-studio 0.6.0 → 0.7.0

package/dist/_api.d.ts

@@ -1422,197 +1422,6 @@ type StoryAlignPositionValue = {
 	xoffset?: number;
 	yoffset?: number;
 };
-type GameBuildPlatform = "windows" | "macos" | "linux" | "web" | "android" | "ios";
-type PluginPermissionPersistence = "temporary" | "permanent";
-type PluginFileSystemPermissionMode = "read" | "write" | "readwrite";
-/**
- * Install-time permissions split into two families, and the split is the whole
- * point:
- *
- * - **Author-declared** (`filesystem`, `api`) — privileged Studio controls the
- *   plugin asks for explicitly in `permissions[]`.
- * - **Derived** (`runtime`, `sidecar`, `buildDependency`, `externalLink`,
- *   `network`) — computed from `contributes` by {@link validatePluginManifest}
- *   and *rejected* if written by
- *   hand. A capability is declared in exactly one place, so what the prompt shows
- *   and what the plugin can actually reach cannot drift apart. Adding a
- *   capability widens the permission set, which makes the update re-prompt for
- *   free (see `isPermissionSubset`).
- */
-export type PluginInstallPermission = {
-	kind: "filesystem";
-	path: string;
-	mode: PluginFileSystemPermissionMode;
-	recursive: boolean;
-} | {
-	kind: "api";
-	capability: string;
-} | {
-	/** Derived from `contributes.runtimeCapabilities`. */
-	kind: "runtime";
-	capability: PluginRuntimeCapability;
-} | {
-	/** Derived from `contributes.sidecars`: a native child process shipped inside the author's game. */
-	kind: "sidecar";
-	id: string;
-	/**
-	 * Which of the two sidecar shapes this is, carried through from the manifest because the
-	 * two are different promises: `executable` starts a separate binary, `node` runs the
-	 * plugin's own JavaScript under the game's Electron as Node. An author told only "this
-	 * ships a helper program" has not been told which one they are approving.
-	 *
-	 * Named apart from `kind` above on purpose - that one says which permission this is, this
-	 * one says what the sidecar runs.
-	 */
-	sidecarKind: PluginSidecarKind;
-	/** `<platform>-<arch>` keys the sidecar ships binaries for. */
-	platforms: string[];
-} | {
-	/** Derived from `contributes.buildDependencies`: binaries downloaded at build time. */
-	kind: "buildDependency";
-	id: string;
-	/** Distinct hostnames the binaries are fetched from. */
-	hosts: string[];
-} | {
-	/**
-	 * Derived from `contributes.externalLinks`: addresses outside the game this plugin may open
-	 * in the player's browser or platform handler.
-	 *
-	 * One permission carrying every pattern rather than one permission each, because what the
-	 * author is deciding is a single question - "may this plugin send the player out to these
-	 * places" - and a prompt that asked it four times would be four chances to stop reading.
-	 * `isPermissionSubset` still compares the patterns one by one, so adding one to a later
-	 * version widens the set and re-prompts.
-	 *
-	 * The patterns are the author's own strings, unrewritten: this list is what the prompt
-	 * shows, and normalizing a permission before showing it to the person approving it would
-	 * make the prompt and the manifest two slightly different documents.
-	 */
-	kind: "externalLink";
-	patterns: string[];
-} | {
-	/**
-	 * Derived from `contributes.network`: hosts this plugin's runtime code requests bytes from.
-	 *
-	 * A separate question from `externalLink` and never folded into it. Opening a page hands an
-	 * address to the browser the player already uses and nothing comes back; this fetches, and
-	 * what comes back runs inside the game. An author deciding about one has not decided about
-	 * the other.
-	 *
-	 * The patterns are also what a project's network allowlist shows attributed to this plugin,
-	 * which is the point of declaring them: a build narrowed to a list still reaches what the
-	 * author approved here, and the list can say so rather than silently making room.
-	 */
-	kind: "network";
-	patterns: string[];
-};
-type PluginSidecarKind = "executable" | "node";
-declare const PluginRuntimeCapability: {
-	/** `app.game.store` — plugin-scoped persistent key/value storage. */
-	readonly Store: "store";
-	/** `app.game.events` — game lifecycle and engine event subscription. */
-	readonly Events: "events";
-	/** `app.game.state.get` — read story variables. */
-	readonly StateRead: "state.read";
-	/** `app.game.state.set` — write story variables. */
-	readonly StateWrite: "state.write";
-	/** `app.game.saves` — list and read save metadata. */
-	readonly SavesRead: "saves.read";
-	/**
-	 * `app.game.saves.write` / `.load` — overwrite a save slot and load one.
-	 *
-	 * Separate from (and heavier than) `saves.read`: this can destroy a
-	 * playthrough. It exists because quick-save/quick-load is an ordinary thing
-	 * for a visual novel to ship — the built-in Quick Save plugin is exactly
-	 * this — and a capability model that cannot express a feature the product
-	 * already has would just push authors back around it.
-	 */
-	readonly SavesWrite: "saves.write";
-	/** `app.game.ui.overlay` — draw on top of the game. */
-	readonly UiOverlay: "ui.overlay";
-	/** `app.game.assets` — resolve packaged asset URLs. */
-	readonly Assets: "assets";
-	/**
-	 * `app.game.locale` — read and observe the game language, and read the project's own
-	 * localized text through the same table and fallback chain the `Get Text` node uses.
-	 */
-	readonly Locale: "locale";
-	/**
-	 * `app.game.menu` — own the menu bar above the game.
-	 *
-	 * Its own capability rather than part of anything else, because what it grants is *the chrome
-	 * the player reads the game through*: every row on that bar, and what each one does, is this
-	 * plugin's to decide. The rows still act through the game's own vocabulary (see
-	 * `@shared/types/gameMenu`) - nothing here reaches past what a blueprint could already do - but
-	 * an author approving this is handing over a surface their players will read as the game's own,
-	 * which is worth a name at install rather than arriving with something else.
-	 *
-	 * Absent on shells with no bar to give (the web export, Dev Mode), which is reported the way
-	 * every environment difference is: the member is not there.
-	 */
-	readonly Menu: "menu";
-	/**
-	 * `app.game.story` — register a compile pass that observes each scene and injects engine
-	 * actions around its rows.
-	 *
-	 * The heaviest of the ten to read, and the one whose weight is easiest to miss: nothing here
-	 * touches the player's files, and the author still sees only their own document — but a pass
-	 * runs over *every* scene of the project, sees who speaks in each, and can put actions around
-	 * lines it did not write. That is a plugin editing the story, at the last moment before it
-	 * plays, and it is worth a name the author approves at install.
-	 *
-	 * It is not `state.write` in disguise and does not imply it: a pass builds actions, it does not
-	 * run them, and the one piece of runtime state it can touch is a scene-local flag the compiler
-	 * creates and owns (`SceneCompileContext.runtimeFlag`), never a story variable the author
-	 * declared.
-	 */
-	readonly StoryCompile: "story.compile";
-};
-type PluginRuntimeCapability = typeof PluginRuntimeCapability[keyof typeof PluginRuntimeCapability];
-/**
- * `app.game.sidecar` has no entry here on purpose: it exists exactly when
- * `contributes.sidecars` is non-empty. Declaring the sidecar *is* the request.
- */
-export interface PluginIdentity {
-	id: string;
-	name?: string;
-	version?: string;
-	publisher?: string;
-}
-interface PluginPermissionRequestBase {
-	requestId: string;
-	plugin: PluginIdentity;
-	reason?: string;
-	requestedAt?: number;
-}
-export type PluginPermissionRequest = (PluginPermissionRequestBase & {
-	kind: "trust";
-	persistence?: PluginPermissionPersistence;
-}) | (PluginPermissionRequestBase & {
-	kind: "filesystem";
-	path: string;
-	mode: PluginFileSystemPermissionMode;
-	recursive: boolean;
-	persistence: PluginPermissionPersistence;
-}) | (PluginPermissionRequestBase & {
-	kind: "install";
-	source: string;
-	permissions?: PluginInstallPermission[];
-	persistence?: PluginPermissionPersistence;
-}) | (PluginPermissionRequestBase & {
-	kind: "api";
-	capability: string;
-	persistence?: PluginPermissionPersistence;
-});
-interface PluginPermissionGrantResult {
-	requestId: string;
-	pluginId: string;
-	kind: PluginPermissionRequest["kind"];
-	approved: boolean;
-	persistence: PluginPermissionPersistence;
-	grantedAt?: number;
-}
-export type PluginPermissionPromptResult = PluginPermissionGrantResult | null;
 type BlueprintDebugEvent = {
 	type: "execution.started";
 	executionId: string;
@@ -1658,6 +1467,29 @@ type BlueprintDebugEvent = {
 	type: "devtools.log";
 	level: string;
 	message: string;
+} | {
+	/**
+	 * A node ran with one of its required data inputs left unconnected and no value on the
+	 * card, so the pin resolved to nothing.
+	 *
+	 * Its own event rather than a `devtools.log`, because it has a place: an issue list can
+	 * put it on a surface, and a repeat of it on the same pin is the same problem rather than
+	 * a second line of output. Carries the node's and the pin's English names off the
+	 * catalogue, which is what a host that has no node-title map (the shipped game) can still
+	 * write into a player's log.
+	 */
+	type: "node.input_missing";
+	executionId: string;
+	nodeId: string;
+	/** The node's display name as its definition declares it. */
+	nodeName: string;
+	/** The unwired pin's label as its definition declares it. */
+	pinLabel: string;
+	blueprintId?: string;
+	eventId?: string;
+	graphId?: string;
+	/** See the note on `execution.error`: what lets a host say "the Quick Menu". */
+	surfaceId?: string;
 } | {
 	type: "execution.error";
 	executionId: string;
@@ -1694,9 +1526,6 @@ type BlueprintOwnerRef = {
 	kind: "componentWidgetMain";
 	componentId: string;
 	elementId: string;
-} | {
-	kind: "sharedAsset";
-	assetId: string;
 }
 /**
  * Story Action Blueprint: an implicit project resource bound 1:1 to a single story action.
@@ -1717,17 +1546,22 @@ type BlueprintOwnerRef = {
 	blueprintId: string;
 	mode?: "action" | "value" | "condition";
 };
-type BlueprintFrontendKind = "visual" | "typescript";
-type BlueprintProgramKind = "graph" | "scriptModule";
 type Blueprint = {
 	id: string;
 	name: string;
 	owner: BlueprintOwnerRef;
-	frontend: BlueprintFrontendKind;
-	programKind: BlueprintProgramKind;
 	members?: BlueprintMemberIndex;
 	bindings?: Record<string, BindingDefinition>;
-	program: BlueprintProgram;
+	/**
+	 * The layers this slot runs, in the order the author arranged them.
+	 *
+	 * Reached directly rather than through a `program: { kind }` wrapper. The wrapper existed to
+	 * separate a graph blueprint from a script one, and there is no such division any more: a
+	 * blueprint is a container of layers, and each layer says for itself whether it is a graph or a
+	 * file. Three fields used to answer the same question - `frontend`, `programKind` and
+	 * `program.kind` - and none of them could answer it for a blueprint holding one of each.
+	 */
+	graphs: BlueprintGraphIndex;
 	meta?: Record<string, unknown>;
 };
 type BlueprintMemberIndex = {
@@ -1779,12 +1613,10 @@ type BlueprintFunctionSignature = {
 	returnType?: string;
 	meta?: Record<string, unknown>;
 };
-type BlueprintProgram = {
-	kind: "graph";
-	graphs: BlueprintGraphIndex;
-} | {
-	kind: "scriptModule";
-	source: TypeScriptBlueprintSource;
+type BlueprintLayerScript = {
+	scriptRef: string;
+	/** What the last compile of {@link scriptRef} said. Absent until one has run. */
+	diagnostics?: BlueprintDiagnostic[];
 };
 type BlueprintGraphIndex = {
 	/**
@@ -1803,7 +1635,7 @@ type BlueprintGraphIndex = {
 	 * listed. Write it through the service, never by hand.
 	 */
 	eventIds?: string[];
-	events: Record<string, BlueprintEventGraph>;
+	events: Record<string, BlueprintLayer>;
 	/**
 	 * Authored order of {@link functions}, on the same terms as {@link eventIds}.
 	 *
@@ -1861,11 +1693,13 @@ type BlueprintGraphEdge = {
 		port: string;
 	};
 };
-type BlueprintEventGraph = {
+type BlueprintLayer = {
 	id: string;
 	name?: string;
 	/** Event execution graph - may contain effectful nodes */
 	graph?: BlueprintGraphIr;
+	/** The author's file this layer runs, when it is a script layer rather than a graph one. */
+	script?: BlueprintLayerScript;
 	meta?: Record<string, unknown>;
 };
 type BlueprintFunctionGraph = {
@@ -1880,13 +1714,6 @@ type BlueprintMacroGraph = {
 	graph?: BlueprintGraphIr;
 	meta?: Record<string, unknown>;
 };
-type TypeScriptBlueprintSource = {
-	language: "typescript";
-	code: string;
-	compiledModuleId?: string;
-	outputPath?: string;
-	diagnostics?: BlueprintDiagnostic[];
-};
 type LiteralValue = string | number | boolean | null | LiteralValue[] | {
 	[key: string]: LiteralValue;
 };
@@ -1920,16 +1747,6 @@ type BlueprintDiagnostic = {
 	/** Source span or module location; M1 opaque */
 	location?: Record<string, unknown>;
 };
-type SharedBlueprintAsset = {
-	assetId: string;
-	name: string;
-	frontend: BlueprintFrontendKind;
-	blueprint: Blueprint;
-	meta?: {
-		tags?: string[];
-		category?: string;
-	};
-};
 type LocaleCode = string;
 type LocalizationLocaleEntry = {
 	code: LocaleCode;
@@ -1954,24 +1771,6 @@ type GameLocalizationBundle = {
 	 */
 	scenes?: Record<string, string>;
 };
-type VariableRegistryScope = "saved" | "persistent";
-type VariableRegistryEntry = {
-	id: string;
-	/** Author-facing, proper-case label. Displayed to users; the id/storageKey are never shown. */
-	name: string;
-	/**
-	 * Which project scope this definition belongs to. Decides which runtime table it lands in and
-	 * which channel reads it - the two never mix, so no consumer may treat the registry as one flat
-	 * list of persistent variables.
-	 */
-	scope: VariableRegistryScope;
-	valueType: StoryVariableValueType;
-	defaultValue?: StoryLiteralValue;
-	/** Stable save-file / host-persistence key; defaults to `id`, unchanged on rename. */
-	storageKey: string;
-	description?: string;
-};
-type PersistentVariableRuntimeTable = Record<string, VariableRegistryEntry>;
 type SaveRecordTimes = {
 	/** When this slot was last written, epoch milliseconds; 0 when the record carries no stamp. */
 	savedAt: number;
@@ -1990,6 +1789,12 @@ type SaveRecordLine = {
 	/** Who spoke it, or "" when the record carries no speaker (narration, or none yet). */
 	speaker: string;
 };
+type SaveRecordStory = {
+	/** The story the save was written in, as an opaque reference; "" when the record carries none. */
+	id: string;
+	/** That story's author-facing name; "" when this build ships no story under that reference. */
+	name: string;
+};
 type AutoSaveEntry = {
 	id: string;
 	/** Slot index within the ring. */
@@ -2022,64 +1827,269 @@ type AudioClipRegion = {
 	 * than clamped: clamping would invent a loop point the author never marked, while dropping
 	 * degrades to the plain loop the two other markers already describe.
 	 */
-	loopStartMs?: number;
-};
-type BlueprintOpenExternalRequest = {
-	url: string;
-};
-type BlueprintOpenExternalOutcome = "opened" | "refused" | "failed";
-type BlueprintOpenExternalResult = {
-	outcome: BlueprintOpenExternalOutcome;
-	/** Human-readable reason, null when the page was handed over. */
-	error: string | null;
-};
-type BlueprintPointerMoveOutcome = 
-/** The cursor is now at the requested point. */
-"moved"
-/** This shell cannot move the cursor: a web export, or a host with no platform support. */
- | "unsupported"
-/** The move was attempted and failed. */
- | "failed";
-type BlueprintPointerMoveResult = {
-	outcome: BlueprintPointerMoveOutcome;
-	error?: string;
-};
-declare const BLUEPRINT_POINTER_MOVE_EASINGS: readonly [
-	"linear",
-	"easeIn",
-	"easeOut",
-	"easeInOut"
-];
-type BlueprintPointerMoveEasing = (typeof BLUEPRINT_POINTER_MOVE_EASINGS)[number];
-type BlueprintGraphKind = "event" | "function" | "macro";
-declare const BLUEPRINT_NETWORK_METHODS: readonly [
-	"GET",
-	"POST",
-	"PUT",
-	"PATCH",
-	"DELETE",
-	"HEAD"
-];
-type BlueprintNetworkMethod = typeof BLUEPRINT_NETWORK_METHODS[number];
-type BlueprintNetworkFetchRequest = {
-	url: string;
-	method: BlueprintNetworkMethod;
-	/** Header name -> value. Null and `{}` both mean "send none". */
-	headers: Record<string, string> | null;
-	/** Request body, for the methods that carry one. */
-	body: string | null;
-	timeoutMs: number;
-};
-type BlueprintNetworkFetchOutcome = "success" | "httpError" | "networkError" | "timeout";
-type BlueprintNetworkFetchResult = {
-	outcome: BlueprintNetworkFetchOutcome;
-	/** HTTP status, or 0 when no response was received. */
-	status: number;
-	/** Response body text, present whenever a response arrived. */
-	body: string | null;
-	/** Human-readable failure reason, null on success. */
-	error: string | null;
+	loopStartMs?: number;
+};
+type BlueprintOpenExternalRequest = {
+	url: string;
+};
+type BlueprintOpenExternalOutcome = "opened" | "refused" | "failed";
+type BlueprintOpenExternalResult = {
+	outcome: BlueprintOpenExternalOutcome;
+	/** Human-readable reason, null when the page was handed over. */
+	error: string | null;
+};
+type BlueprintPointerMoveOutcome = 
+/** The cursor is now at the requested point. */
+"moved"
+/** This shell cannot move the cursor: a web export, or a host with no platform support. */
+ | "unsupported"
+/** The move was attempted and failed. */
+ | "failed";
+type BlueprintPointerMoveResult = {
+	outcome: BlueprintPointerMoveOutcome;
+	error?: string;
+};
+declare const BLUEPRINT_POINTER_MOVE_EASINGS: readonly [
+	"linear",
+	"easeIn",
+	"easeOut",
+	"easeInOut"
+];
+type BlueprintPointerMoveEasing = (typeof BLUEPRINT_POINTER_MOVE_EASINGS)[number];
+type BlueprintScreenshotOutcome = "saved" | "failed";
+type BlueprintScreenshotResult = {
+	outcome: BlueprintScreenshotOutcome;
+	/** The file that was written, absolute, or null when nothing was. */
+	path: string | null;
+	/** Why nothing was written. Null on success. */
+	error: string | null;
+};
+type BlueprintOpenScreenshotsResult = {
+	outcome: "opened" | "failed";
+	/** The folder that was opened, absolute, or null when none was. */
+	path: string | null;
+	error: string | null;
+};
+type BlueprintGraphKind = "event" | "function" | "macro";
+declare const BLUEPRINT_NETWORK_METHODS: readonly [
+	"GET",
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE",
+	"HEAD"
+];
+type BlueprintNetworkMethod = typeof BLUEPRINT_NETWORK_METHODS[number];
+type BlueprintNetworkFetchRequest = {
+	url: string;
+	method: BlueprintNetworkMethod;
+	/** Header name -> value. Null and `{}` both mean "send none". */
+	headers: Record<string, string> | null;
+	/** Request body, for the methods that carry one. */
+	body: string | null;
+	timeoutMs: number;
+};
+type BlueprintNetworkFetchOutcome = "success" | "httpError" | "networkError" | "timeout";
+type BlueprintNetworkFetchResult = {
+	outcome: BlueprintNetworkFetchOutcome;
+	/** HTTP status, or 0 when no response was received. */
+	status: number;
+	/** Response body text, present whenever a response arrived. */
+	body: string | null;
+	/** Human-readable failure reason, null on success. */
+	error: string | null;
+};
+type GameBuildPlatform = "windows" | "macos" | "linux" | "web" | "android" | "ios";
+type PluginPermissionPersistence = "temporary" | "permanent";
+type PluginFileSystemPermissionMode = "read" | "write" | "readwrite";
+/**
+ * Install-time permissions split into two families, and the split is the whole
+ * point:
+ *
+ * - **Author-declared** (`filesystem`, `api`) — privileged Studio controls the
+ *   plugin asks for explicitly in `permissions[]`.
+ * - **Derived** (`runtime`, `sidecar`, `buildDependency`, `externalLink`,
+ *   `network`) — computed from `contributes` by {@link validatePluginManifest}
+ *   and *rejected* if written by
+ *   hand. A capability is declared in exactly one place, so what the prompt shows
+ *   and what the plugin can actually reach cannot drift apart. Adding a
+ *   capability widens the permission set, which makes the update re-prompt for
+ *   free (see `isPermissionSubset`).
+ */
+export type PluginInstallPermission = {
+	kind: "filesystem";
+	path: string;
+	mode: PluginFileSystemPermissionMode;
+	recursive: boolean;
+} | {
+	kind: "api";
+	capability: string;
+} | {
+	/** Derived from `contributes.runtimeCapabilities`. */
+	kind: "runtime";
+	capability: PluginRuntimeCapability;
+} | {
+	/** Derived from `contributes.sidecars`: a native child process shipped inside the author's game. */
+	kind: "sidecar";
+	id: string;
+	/**
+	 * Which of the two sidecar shapes this is, carried through from the manifest because the
+	 * two are different promises: `executable` starts a separate binary, `node` runs the
+	 * plugin's own JavaScript under the game's Electron as Node. An author told only "this
+	 * ships a helper program" has not been told which one they are approving.
+	 *
+	 * Named apart from `kind` above on purpose - that one says which permission this is, this
+	 * one says what the sidecar runs.
+	 */
+	sidecarKind: PluginSidecarKind;
+	/** `<platform>-<arch>` keys the sidecar ships binaries for. */
+	platforms: string[];
+} | {
+	/** Derived from `contributes.buildDependencies`: binaries downloaded at build time. */
+	kind: "buildDependency";
+	id: string;
+	/** Distinct hostnames the binaries are fetched from. */
+	hosts: string[];
+} | {
+	/**
+	 * Derived from `contributes.externalLinks`: addresses outside the game this plugin may open
+	 * in the player's browser or platform handler.
+	 *
+	 * One permission carrying every pattern rather than one permission each, because what the
+	 * author is deciding is a single question - "may this plugin send the player out to these
+	 * places" - and a prompt that asked it four times would be four chances to stop reading.
+	 * `isPermissionSubset` still compares the patterns one by one, so adding one to a later
+	 * version widens the set and re-prompts.
+	 *
+	 * The patterns are the author's own strings, unrewritten: this list is what the prompt
+	 * shows, and normalizing a permission before showing it to the person approving it would
+	 * make the prompt and the manifest two slightly different documents.
+	 */
+	kind: "externalLink";
+	patterns: string[];
+} | {
+	/**
+	 * Derived from `contributes.network`: hosts this plugin's runtime code requests bytes from.
+	 *
+	 * A separate question from `externalLink` and never folded into it. Opening a page hands an
+	 * address to the browser the player already uses and nothing comes back; this fetches, and
+	 * what comes back runs inside the game. An author deciding about one has not decided about
+	 * the other.
+	 *
+	 * The patterns are also what a project's network allowlist shows attributed to this plugin,
+	 * which is the point of declaring them: a build narrowed to a list still reaches what the
+	 * author approved here, and the list can say so rather than silently making room.
+	 */
+	kind: "network";
+	patterns: string[];
+};
+type PluginSidecarKind = "executable" | "node";
+declare const PluginRuntimeCapability: {
+	/** `app.game.store` — plugin-scoped persistent key/value storage. */
+	readonly Store: "store";
+	/** `app.game.events` — game lifecycle and engine event subscription. */
+	readonly Events: "events";
+	/** `app.game.state.get` — read story variables. */
+	readonly StateRead: "state.read";
+	/** `app.game.state.set` — write story variables. */
+	readonly StateWrite: "state.write";
+	/** `app.game.saves` — list and read save metadata. */
+	readonly SavesRead: "saves.read";
+	/**
+	 * `app.game.saves.write` / `.load` — overwrite a save slot and load one.
+	 *
+	 * Separate from (and heavier than) `saves.read`: this can destroy a
+	 * playthrough. It exists because quick-save/quick-load is an ordinary thing
+	 * for a visual novel to ship — the built-in Quick Save plugin is exactly
+	 * this — and a capability model that cannot express a feature the product
+	 * already has would just push authors back around it.
+	 */
+	readonly SavesWrite: "saves.write";
+	/** `app.game.ui.overlay` — draw on top of the game. */
+	readonly UiOverlay: "ui.overlay";
+	/** `app.game.assets` — resolve packaged asset URLs. */
+	readonly Assets: "assets";
+	/**
+	 * `app.game.locale` — read and observe the game language, and read the project's own
+	 * localized text through the same table and fallback chain the `Get Text` node uses.
+	 */
+	readonly Locale: "locale";
+	/**
+	 * `app.game.menu` — own the menu bar above the game.
+	 *
+	 * Its own capability rather than part of anything else, because what it grants is *the chrome
+	 * the player reads the game through*: every row on that bar, and what each one does, is this
+	 * plugin's to decide. The rows still act through the game's own vocabulary (see
+	 * `@shared/types/gameMenu`) - nothing here reaches past what a blueprint could already do - but
+	 * an author approving this is handing over a surface their players will read as the game's own,
+	 * which is worth a name at install rather than arriving with something else.
+	 *
+	 * Absent on shells with no bar to give (the web export, Dev Mode), which is reported the way
+	 * every environment difference is: the member is not there.
+	 */
+	readonly Menu: "menu";
+	/**
+	 * `app.game.story` — register a compile pass that observes each scene and injects engine
+	 * actions around its rows.
+	 *
+	 * The heaviest of the ten to read, and the one whose weight is easiest to miss: nothing here
+	 * touches the player's files, and the author still sees only their own document — but a pass
+	 * runs over *every* scene of the project, sees who speaks in each, and can put actions around
+	 * lines it did not write. That is a plugin editing the story, at the last moment before it
+	 * plays, and it is worth a name the author approves at install.
+	 *
+	 * It is not `state.write` in disguise and does not imply it: a pass builds actions, it does not
+	 * run them, and the one piece of runtime state it can touch is a scene-local flag the compiler
+	 * creates and owns (`SceneCompileContext.runtimeFlag`), never a story variable the author
+	 * declared.
+	 */
+	readonly StoryCompile: "story.compile";
 };
+type PluginRuntimeCapability = typeof PluginRuntimeCapability[keyof typeof PluginRuntimeCapability];
+/**
+ * `app.game.sidecar` has no entry here on purpose: it exists exactly when
+ * `contributes.sidecars` is non-empty. Declaring the sidecar *is* the request.
+ */
+export interface PluginIdentity {
+	id: string;
+	name?: string;
+	version?: string;
+	publisher?: string;
+}
+interface PluginPermissionRequestBase {
+	requestId: string;
+	plugin: PluginIdentity;
+	reason?: string;
+	requestedAt?: number;
+}
+export type PluginPermissionRequest = (PluginPermissionRequestBase & {
+	kind: "trust";
+	persistence?: PluginPermissionPersistence;
+}) | (PluginPermissionRequestBase & {
+	kind: "filesystem";
+	path: string;
+	mode: PluginFileSystemPermissionMode;
+	recursive: boolean;
+	persistence: PluginPermissionPersistence;
+}) | (PluginPermissionRequestBase & {
+	kind: "install";
+	source: string;
+	permissions?: PluginInstallPermission[];
+	persistence?: PluginPermissionPersistence;
+}) | (PluginPermissionRequestBase & {
+	kind: "api";
+	capability: string;
+	persistence?: PluginPermissionPersistence;
+});
+interface PluginPermissionGrantResult {
+	requestId: string;
+	pluginId: string;
+	kind: PluginPermissionRequest["kind"];
+	approved: boolean;
+	persistence: PluginPermissionPersistence;
+	grantedAt?: number;
+}
+export type PluginPermissionPromptResult = PluginPermissionGrantResult | null;
 declare const PluginManifestVersion = 2;
 /**
  * Per-target plugin entry files. Each entry is a prebundled ESM file relative
@@ -2814,63 +2824,6 @@ type UILayout = {
 };
 type UIStyle = Record<string, unknown>;
 type GameStorageDurability = "durable" | "evictable" | "unknown";
-type UIGraphId = string;
-type UIGraph = {
-	id: UIGraphId;
-	name?: string;
-	entries: Record<string, UIGraphEntry>;
-	nodes: Record<string, UIGraphNode>;
-	edges: UIGraphEdge[];
-	variables?: Record<string, unknown>;
-	meta?: Record<string, unknown>;
-	/**
-	 * M2+ optional link: id of a Blueprint in `blueprintDocument.blueprints` that owns this graph IR.
-	 */
-	blueprintId?: string;
-	/** M2+ optional owner context for instance main blueprints */
-	ownerRef?: BlueprintOwnerRef;
-};
-type UIGraphEntry = {
-	start: {
-		nodeId: string;
-		port: string;
-	};
-	inputs?: Record<string, unknown>;
-	meta?: Record<string, unknown>;
-};
-type UIGraphNode = {
-	id: string;
-	type: string;
-	params?: Record<string, unknown>;
-	ports?: Record<string, UIGraphPort>;
-	meta?: Record<string, unknown>;
-	/**
-	 * What each asset set this node's stored params name resolves to, per locale.
-	 *
-	 * The same field `BlueprintGraphNode` declares, and the same object: `adaptBlueprintGraphIr`
-	 * hands the executor the bundle's own nodes rather than copies, so a node running here is
-	 * carrying whatever the package wrote onto it. Declared on both because a node reads it from
-	 * whichever of the two types its caller happens to hold.
-	 *
-	 * Never authored and never on disk under `editor/`.
-	 */
-	assetVariants?: AssetVariantMap;
-};
-type UIGraphPort = {
-	kind: "input" | "output";
-	type?: string;
-	label?: string;
-};
-type UIGraphEdge = {
-	from: {
-		nodeId: string;
-		port: string;
-	};
-	to: {
-		nodeId: string;
-		port: string;
-	};
-};
 type DevModeStartStoryRequest = {
 	storyId: StoryId;
 	sceneId: string;
@@ -2878,6 +2831,21 @@ type DevModeStartStoryRequest = {
 	startBlockId?: string;
 	/** Scene Snapshot (变量快照) whose variable overrides seed the launch. */
 	snapshotId?: string;
+	/**
+	 * Variable values lifted off a running game, laid over the launch's own stage walk.
+	 *
+	 * Set only by a hot reload resuming where the player was: the walk reconstructs what the values
+	 * would be had the story been played from the top down one path, and these are what they
+	 * actually were. Applied after the walk and after any Scene Snapshot, because they are the later
+	 * state - re-seeding either over them would rewind the player.
+	 *
+	 * Storage keys, the way the compiler names namespace entries, not variable ids. Persistent
+	 * values are absent by design: they outlive the run, so a reload has nothing to restore.
+	 */
+	resume?: {
+		sceneVariables: Record<string, StoryLiteralValue>;
+		savedVariables: Record<string, StoryLiteralValue>;
+	};
 };
 type GameTestLogLevel = "verbose" | "info" | "success" | "warning" | "error";
 type GameTestExitReason = 
@@ -3465,6 +3433,10 @@ declare const en: {
 			readonly keybindings: {
 				readonly label: "Keyboard shortcuts";
 			};
+			readonly projectTrust: {
+				readonly label: "Trusted projects";
+				readonly description: "Projects that Studio did not create, and whether they may run.";
+			};
 			readonly cacheInventory: {
 				readonly label: "Cached files";
 			};
@@ -3567,6 +3539,23 @@ declare const en: {
 			};
 		};
 		readonly data: {
+			readonly projectTrust: {
+				readonly loading: "Reading\u2026";
+				readonly empty: "Every project opened so far was created by Studio.";
+				readonly waiting: "Waiting for a decision";
+				readonly granted: "Trusted";
+				readonly trust: "Trust";
+				readonly remove: "Remove";
+				readonly reloadNote: "A project that is open reloads when its trust changes.";
+				readonly origin: {
+					readonly package: "From a package";
+					readonly remote: "From a remote source";
+					readonly opened: "Opened from a folder";
+					readonly created: "Created by Studio";
+					readonly recent: "Opened before";
+					readonly commandLine: "From the command line";
+				};
+			};
 			readonly cache: {
 				readonly measuring: "Measuring\u2026";
 				readonly unavailable: "Not available";
@@ -4091,6 +4080,10 @@ declare const en: {
 			readonly entry: {
 				readonly edit: "edit";
 				readonly storyEdit: "story edit";
+				readonly storyMoveRowsToScene: "move to another scene";
+				readonly storySplitScene: "scene split";
+				readonly storyMergeScenes: "scene merge";
+				readonly storySpeakerChange: "speaker change";
 				readonly storyMotionEdit: "motion edit";
 				readonly audioMarkers: "marker change";
 				readonly surfaceEdit: "interface edit";
@@ -4212,6 +4205,9 @@ declare const en: {
 			readonly errorOpenFailed: "Could not open that folder: {error}";
 			readonly notAProjectTitle: "This folder is not a NarraLeaf project";
 			readonly notAProjectDetail: "No .nlproj file was found.";
+			readonly projectLockedTitle: "This project is open in another NarraLeaf Studio";
+			readonly projectLockedHere: "Open on this computer since {time}. Retry once it has been closed there.";
+			readonly projectLockedElsewhere: "Open on {host} since {time}. Retry once it has been closed there.";
 			readonly openLauncher: "Open launcher";
 			readonly panelRenderError: "This panel hit a rendering error";
 			readonly mainEditorRegion: "Main editor";
@@ -4245,8 +4241,10 @@ declare const en: {
 				};
 			};
 			readonly panelMenu: {
-				readonly removeItem: "Remove this item";
+				readonly hideItem: "Hide this item";
 				readonly collapseItem: "Collapse into group";
+				readonly resetLayout: "Reset to default layout";
+				readonly resetLayoutDisabled: "Already in the default layout.";
 			};
 			readonly panelGroup: {
 				readonly title: "Collapsed panels";
@@ -4323,11 +4321,16 @@ declare const en: {
 				};
 			};
 			readonly statusBar: {
+				readonly distrusted: {
+					readonly label: "Not trusted";
+					readonly tooltip: "This project cannot run until it is trusted. Click to trust it.";
+				};
 				readonly devMode: "Dev Mode";
 				readonly preview: "Preview";
 				readonly production: "Production";
 				readonly phase: {
 					readonly starting: "Starting\u2026";
+					readonly checking: "Checking\u2026";
 					readonly preparing: "Preparing\u2026";
 					readonly compiling: "Compiling\u2026";
 					readonly launching: "Launching\u2026";
@@ -4357,6 +4360,7 @@ declare const en: {
 				readonly entries: {
 					readonly team: "NarraLeaf Team";
 					readonly runStatus: "Run status";
+					readonly projectTrust: "Project trust";
 					readonly studioTasks: "Background work";
 					readonly unsavedChanges: "Unsaved changes";
 					readonly wordCount: "Story stats";
@@ -4409,6 +4413,7 @@ declare const en: {
 					readonly characters: "characters";
 					readonly project: "project settings";
 					readonly assets: "asset library";
+					readonly openEditors: "the open editor";
 				};
 			};
 			readonly reload: {
@@ -4427,6 +4432,10 @@ declare const en: {
 				readonly unavailable: "Unavailable while the project is frozen. Unfreeze the project to use it.";
 				readonly unavailableLive: "Unavailable during a live session. Leave the session to use it.";
 			};
+			readonly distrust: {
+				readonly unavailable: "Unavailable until this project is trusted. Click Not trusted in the status bar to trust it.";
+				readonly refusedTitle: "This project is not trusted";
+			};
 			readonly revisionView: {
 				readonly showPrevious: "Show the Previous Version (Read-Only)";
 				readonly leave: "Stop Viewing History";
@@ -4475,6 +4484,7 @@ declare const en: {
 				readonly committing: "Submitting this version\u2026";
 				readonly nothingToCommit: "Nothing has changed since the last version.";
 				readonly closingWithApp: "Studio is closing. Try again after it restarts.";
+				readonly repositoryLocked: "Another program has this project's version history open. Close it to use versions here.";
 				readonly commitBeforeSync: "Submit a version before getting the server's.";
 				readonly branchDiverged: "This project and the server have both changed. Get the server's versions first, then send yours.";
 				readonly changesUnknown: "Not checked";
@@ -6119,6 +6129,12 @@ declare const en: {
 				readonly other: "Link speaker on {count} lines";
 			};
 			readonly playFromHere: "Play from here";
+			readonly moveToScene: "Move to scene";
+			readonly splitScene: "Split scene here\u2026";
+			readonly mergeWithNext: "Merge with next scene";
+			readonly mergeIntoPrevious: "Merge into previous scene";
+			readonly changeSpeaker: "Change speaker";
+			readonly speakerNameOnly: "{name} (name only)";
 			readonly openInspector: "Open inspector";
 			readonly delete: "Delete";
 		};
@@ -6130,6 +6146,50 @@ declare const en: {
 			readonly moveScene: "move scene {name}";
 			readonly moveChapter: "move chapter {name}";
 		};
+		readonly structuralOps: {
+			readonly moveRows: {
+				readonly done: {
+					readonly one: "{count} row moved to {scene}";
+					readonly other: "{count} rows moved to {scene}";
+				};
+				readonly refused: "Not available during a live session";
+			};
+			readonly splitScene: {
+				readonly title: "Split Scene";
+				readonly description: "The rows from here to the end become this scene.";
+				readonly placeholder: "Enter scene name";
+				readonly namePattern: "{name} {index}";
+				readonly done: {
+					readonly one: "{count} row moved to {scene}";
+					readonly other: "{count} rows moved to {scene}";
+				};
+				readonly jumpAdded: "jump added";
+				readonly refused: "The rows after this one still need what comes before it";
+				readonly refusedDetail: "Still in use after this row: {names}";
+			};
+			readonly mergeScenes: {
+				readonly confirm: "Merge \"{merged}\" into \"{surviving}\"?";
+				readonly detail: {
+					readonly one: "Its {count} row moves to the end of {surviving}.";
+					readonly other: "Its {count} rows move to the end of {surviving}.";
+				};
+				readonly done: {
+					readonly one: "{count} row merged into {scene}";
+					readonly other: "{count} rows merged into {scene}";
+				};
+				readonly refused: "\"{name}\" is still named elsewhere";
+				readonly refusedDetail: "Named by: {referrers}";
+				readonly referrerJump: "{scene} \u00B7 row {row}";
+				readonly referrerEntryScene: "the story's entry scene";
+				readonly noNeighbour: "There is no scene to merge with";
+			};
+			readonly speaker: {
+				readonly done: {
+					readonly one: "Speaker changed on {count} line";
+					readonly other: "Speaker changed on {count} lines";
+				};
+			};
+		};
 		readonly keybindings: {
 			readonly find: "Find and replace";
 			readonly deleteRows: "Delete selected story rows";
@@ -6182,6 +6242,7 @@ declare const en: {
 		};
 		reason: {
 			unknownCommand: string;
+			unknownCommandNear: string;
 			unknownParam: string;
 			duplicateParam: string;
 			extraPositional: string;
@@ -6700,6 +6761,7 @@ declare const en: {
 			readonly xOffset: "X offset";
 			readonly yOffset: "Y offset";
 			readonly params: "Params";
+			readonly fromCharacter: "From the character";
 		};
 		readonly background: {
 			readonly image: "Image";
@@ -6813,7 +6875,6 @@ declare const en: {
 			readonly audio: "Audio";
 			readonly video: "Videos";
 			readonly json: "JSON Files";
-			readonly blueprint: "Blueprints";
 			readonly font: "Fonts";
 			readonly model: "Models";
 			readonly other: "Other";
@@ -6830,6 +6891,11 @@ declare const en: {
 			readonly one: "{count} item";
 			readonly other: "{count} items";
 		};
+		readonly unreadable: {
+			readonly category: "This category could not be read. Its file is unchanged.";
+			readonly notSaved: "Changes are not being saved";
+			readonly notSavedDetail: "{file} could not be read. Nothing is written over it.";
+		};
 		readonly overview: {
 			readonly loading: "Reading the asset library\u2026";
 			readonly failed: "Could not read the asset library.";
@@ -7210,11 +7276,6 @@ declare const en: {
 			readonly paste: "Paste assets";
 			readonly rename: "Rename selected asset or group";
 		};
-		readonly lockReason: {
-			readonly character: "Asset is used by a character";
-			readonly scene: "Asset is used by a scene";
-			readonly editor: "Asset is used by the Editor";
-		};
 		readonly previewEditor: {
 			readonly loadFailed: "Failed to load this asset.";
 		};
@@ -7405,7 +7466,9 @@ declare const en: {
 			readonly node: {
 				readonly contextInvalid: "Node \"{name}\" is not allowed in this {ownerKind} {graphKind} graph.{hint}";
 				readonly contextValueReturnHint: " Return Value only belongs in Blueprint Value graphs.";
+				readonly contextListItemHint: " It reads the list row it runs for, and nothing here draws one.";
 				readonly noRuntime: "Node \"{node}\": no runtime for type \"{type}\".";
+				readonly inputMissing: "\"{node}\" has nothing connected to \"{pin}\".";
 				readonly unknownType: "Node \"{node}\": unknown type \"{type}\". Its plugin may be uninstalled or disabled.";
 				readonly variableIdInvalid: "Node \"{node}\": pick a variable.";
 				readonly persistentVariableIdInvalid: "Node \"{node}\": pick a persistent variable.";
@@ -7445,12 +7508,22 @@ declare const en: {
 			readonly selectDataType: "Select data type";
 		};
 		readonly eventLayer: {
-			readonly createTitle: "Create event layer";
-			readonly createInvalid: "Select an event and name the layer before creating it.";
-			readonly event: "Event";
+			readonly createTitle: "Add layer";
+			readonly createInvalid: "Name the layer before creating it.";
 			readonly layerName: "Layer name";
 			readonly defaultName: "Layer {index}";
 		};
+		readonly layerDialog: {
+			readonly graphDescription: "Wire nodes together on the canvas.";
+			readonly scriptDescription: "Run one of your own files.";
+			readonly scriptPickerLabel: "Which file this layer runs";
+			readonly newScript: "New script\u2026";
+			readonly newScriptDetail: "Writes a starter file under scripts/";
+			readonly alreadyRun: {
+				readonly one: "Already run by {count} layer";
+				readonly other: "Already run by {count} layers";
+			};
+		};
 		readonly owner: {
 			readonly global: "Global";
 			readonly storyAction: "Story Action";
@@ -7467,6 +7540,7 @@ declare const en: {
 			readonly renameLayerTitle: "Rename layer";
 			readonly layerNamePlaceholder: "Layer name";
 			readonly deleteLayer: "Delete layer\u2026";
+			readonly deleteScriptLayer: "Remove layer (the file stays)";
 			readonly deleteLayerConfirm: "Delete this layer?";
 			readonly deleteLayerDetail: "Linked UI events will be cleared.";
 			readonly deleteVariableLabel: "Delete variable \"{name}\"";
@@ -7490,16 +7564,9 @@ declare const en: {
 			readonly defaultVariableName: "Variable";
 			readonly defaultPersistentName: "Persistent";
 		};
-		readonly revisions: {
-			readonly sharedAssetSingle: "One revision per shared asset.";
-			readonly title: "Revisions";
-			readonly active: "\u00B7 active";
-			readonly unnamed: "Revision {index}";
-			readonly newTypeScript: "New TypeScript revision";
-			readonly newVisual: "New Visual revision";
-		};
 		readonly frontend: {
-			readonly visual: "Visual";
+			readonly visual: "Blueprint";
+			readonly script: "Script";
 		};
 		readonly literal: {
 			readonly string: "String";
@@ -7661,9 +7728,22 @@ declare const en: {
 			readonly unnamedInputAction: "Unnamed action";
 			readonly missingInputAction: "Missing action";
 		};
-		readonly tsPane: {
-			readonly importHint: "Allowed import: \"narraleaf-studio\"";
-			readonly sourceLabel: "TypeScript blueprint source";
+		readonly script: {
+			readonly fileLabel: "Script file";
+			readonly open: "Open in editor";
+			readonly openIn: "Open in {editor}";
+			readonly reveal: "Show in file manager";
+			readonly openFolder: "Open scripts folder";
+			readonly missing: "This file is missing.";
+			readonly changeFile: "Use another file";
+			readonly changeFileEmpty: "No other file under scripts/";
+			readonly readOnly: "Scripts are edited in your own editor.";
+			readonly sectionTitle: "Scripts";
+			readonly tabTitle: "Script";
+			readonly sectionEmpty: "No scripts yet. Open the logic of a page or a component, add a layer, and choose Script.";
+			readonly unbound: "Nothing runs this file";
+			readonly boundTo: "Runs as {name}";
+			readonly boundToMany: "Runs as {name} and {count} more";
 		};
 		readonly tool: {
 			readonly select: "Select tool";
@@ -7890,6 +7970,7 @@ declare const en: {
 			readonly isEntering: "Is Entering";
 			readonly isExiting: "Is Exiting";
 			readonly isFullscreen: "Is Fullscreen";
+			readonly isFocused: "Is Focused";
 			readonly isPicked: "Is Picked";
 			readonly isRead: "Is Read";
 			readonly isInstalled: "Is Installed";
@@ -7979,6 +8060,7 @@ declare const en: {
 			readonly skipDelay: "Skip Delay";
 			readonly skipInterval: "Skip Interval";
 			readonly skipReadText: "Skip Read Text";
+			readonly muteWhenUnfocused: "Mute When Unfocused";
 			readonly skipping: "Skipping";
 			readonly slider: "Slider";
 			readonly sound: "Sound";
@@ -7988,6 +8070,7 @@ declare const en: {
 			readonly status: "Status";
 			readonly step: "Step";
 			readonly story: "Story";
+			readonly storyName: "Story Name";
 			readonly success: "Success";
 			readonly string: "String";
 			readonly switch: "Switch";
@@ -8146,6 +8229,7 @@ declare const en: {
 			readonly getSkipDelay: "Get Skip Delay";
 			readonly getSkipInterval: "Get Skip Interval";
 			readonly getSkipReadText: "Get Skip Read Text";
+			readonly getMuteWhenUnfocused: "Get Mute When Unfocused";
 			readonly getSkipping: "Get Skipping";
 			readonly getSliderEnabled: "Get Slider Enabled";
 			readonly getSliderVisible: "Get Slider Visible";
@@ -8193,6 +8277,7 @@ declare const en: {
 			readonly setSkipDelay: "Set Skip Delay";
 			readonly setSkipInterval: "Set Skip Interval";
 			readonly setSkipReadText: "Set Skip Read Text";
+			readonly setMuteWhenUnfocused: "Set Mute When Unfocused";
 			readonly setSkipping: "Set Skipping";
 			readonly setSliderEnabled: "Set Slider Enabled";
 			readonly setSliderVisible: "Set Slider Visible";
@@ -8457,11 +8542,15 @@ declare const en: {
 			readonly onGameReady: "On Game Ready";
 			readonly onFullscreenChanged: "On Fullscreen Changed";
 			readonly onWindowCloseRequested: "On Window Close Requested";
+			readonly onWindowFocusChanged: "On Window Focus Changed";
 			readonly onAction: "On Action";
 			readonly onKeyDown: "On Key Down";
 			readonly onKeyUp: "On Key Up";
 			readonly onPreferenceChanged: "On Preference Changed";
 			readonly openLink: "Open Link";
+			readonly openScreenshotsFolder: "Open Screenshots Folder";
+			readonly saveScreenshot: "Save Screenshot";
+			readonly isWindowFocused: "Is Window Focused";
 			readonly openPage: "Open page";
 			readonly or: "Or";
 			readonly padEnd: "Pad End";
@@ -8599,6 +8688,7 @@ declare const en: {
 			readonly getTimeZone: "Get Time Zone";
 			readonly getSaveTime: "Get Save Time";
 			readonly getSaveLine: "Get Save Line";
+			readonly getSaveStory: "Get Save Story";
 			readonly getSavePlaytime: "Get Save Playtime";
 			readonly getPlaytime: "Get Playtime";
 			readonly getTotalPlaytime: "Get Total Playtime";
@@ -8631,12 +8721,18 @@ declare const en: {
 			readonly namePlaceholder: "Enter character name";
 			readonly groupNamePlaceholder: "Enter group name";
 			readonly deleteCharacterConfirm: "Delete character \"{name}\"?";
+			readonly renameSpokenRowsConfirm: {
+				readonly one: "Also rename {count} line that speaks as \"{name}\"?";
+				readonly other: "Also rename {count} lines that speak as \"{name}\"?";
+			};
+			readonly renameSpokenRowsDetail: "Those lines carry the name, not the character. They become \"{name}\".";
 			readonly deleteCharacterDetail: "Its dialogue keeps the name. Rows that place it on stage stop resolving.";
 			readonly deleteGroupConfirm: "Delete group \"{name}\"?";
 			readonly deleteGroupDetail: "Characters in this group will be unassigned.";
 		};
 		readonly history: {
 			readonly deleteCharacter: "delete character {name}";
+			readonly renameCharacter: "rename character {name}";
 			readonly deleteGroup: "delete group {name}";
 		};
 		readonly create: {
@@ -8682,6 +8778,7 @@ declare const en: {
 				readonly describeNoModel: "No model to read";
 				readonly describeNoBackend: "No runtime chosen";
 				readonly describeBackendMissing: "Runtime not installed here";
+				readonly describeDistrusted: "Project not trusted";
 				readonly describeNotSupported: "This runtime lists nothing";
 				readonly describeFailed: "The model could not be read";
 				readonly redescribe: "Read the model again";
@@ -8834,6 +8931,10 @@ declare const en: {
 			readonly voiceTrack: "Voice bus";
 			readonly voiceTrackMissing: "Missing bus";
 			readonly voiceTrackEmpty: "Add a bus under Voice in Project \u25B8 Game to give this character its own volume control.";
+			readonly entrance: "Entrance defaults";
+			readonly entranceEmpty: "Entrance rows use the stage's own values until this is set.";
+			readonly entranceDrag: "Drag to place";
+			readonly entranceZoom: "Drag to scale";
 			readonly select: "Select";
 			readonly thumbnailAlt: "thumbnail";
 			readonly color: "Color";
@@ -9096,6 +9197,9 @@ declare const en: {
 				readonly refresh: "Check for Updates";
 				readonly refreshFailedTitle: "Could not check the source";
 			};
+			readonly local: {
+				readonly origin: "The project holds a copy of a file on this machine. Studio does not track that file; Replace File imports it again.";
+			};
 			readonly image: {
 				readonly title: "Image Properties";
 				readonly info: "Image Information";
@@ -9412,7 +9516,8 @@ declare const en: {
 	};
 	readonly storySnapshot: {
 		readonly empty: "Open a story scene to manage its snapshots.";
-		readonly getStarted: "Add a snapshot to set launch values.";
+		readonly defaults: "Defaults";
+		readonly defaultsDetail: "Every variable starts at the value declared for it.";
 		readonly noVariables: "No variables in scope for this scene.";
 		readonly add: "Add snapshot";
 		readonly delete: "Delete snapshot";
@@ -9422,11 +9527,6 @@ declare const en: {
 			readonly true: "True";
 			readonly false: "False";
 		};
-		readonly launch: {
-			readonly needSnapshot: "A snapshot is needed to start the game here";
-			readonly needSnapshotDetail: "Playing from a row requires concrete variable values. Create a scene snapshot first.";
-			readonly createAction: "Create snapshot";
-		};
 	};
 	readonly uiEditor: {
 		readonly surfaceKind: {
@@ -9441,7 +9541,6 @@ declare const en: {
 			readonly surfaceMain: "Page logic";
 			readonly widgetMain: "Component logic";
 			readonly widgetValue: "Component value";
-			readonly sharedAsset: "Shared blueprint";
 			readonly storyAction: "Story action";
 		};
 		readonly stageSlot: {
@@ -9745,7 +9844,7 @@ declare const en: {
 			readonly interaction: "Interaction";
 		};
 		readonly blueprint: {
-			readonly controlLabel: "Control blueprint";
+			readonly controlLabel: "Component logic";
 		};
 		readonly appearance: {
 			readonly title: "Appearance";
@@ -9757,6 +9856,7 @@ declare const en: {
 		readonly horizontal: "Horizontal";
 		readonly vertical: "Vertical";
 		readonly gap: "Gap";
+		readonly wrap: "Wrap";
 		readonly perSidePx: "Per side (px)";
 		readonly sides: {
 			readonly top: "Top";
@@ -9924,6 +10024,10 @@ declare const en: {
 			readonly title: "Text";
 			readonly localizeText: "Localize text";
 		};
+		readonly textMarks: {
+			readonly title: "Marks";
+			readonly selectHint: "Select the text to mark";
+		};
 		readonly frame: {
 			readonly title: "Page";
 			readonly page: "Page";
@@ -10037,6 +10141,7 @@ declare const en: {
 			readonly describeNoModel: "Pick a model bundle to list its names.";
 			readonly describeNoBackend: "Pick a runtime to list the model's names.";
 			readonly describeBackendMissing: "That runtime is not installed in this project, so names must be typed.";
+			readonly describeDistrusted: "This project is not trusted, so its runtimes do not run. Trust it from the status bar.";
 			readonly describeNotSupported: "This runtime does not describe its models. Type the names.";
 			readonly describeFailed: "Could not read the model; type names by hand.";
 			readonly redescribe: "Re-read";
@@ -10047,6 +10152,7 @@ declare const en: {
 			readonly placeholderUnconfigured: "Select a model bundle and a runtime.";
 			readonly placeholderNoModel: "The model bundle is not available here.";
 			readonly placeholderBackendMissing: "No runtime named \u201C{backend}\u201D is installed in this project.";
+			readonly placeholderDistrusted: "Not drawn: this project is not trusted, so its runtime is not run.";
 			readonly placeholderLoading: "Loading the model\u2026";
 			readonly placeholderError: "The runtime failed: {error}";
 			readonly placeholderBudget: "Not drawn: {drawn} models are already drawn in this window.";
@@ -10864,6 +10970,10 @@ declare const en: {
 				readonly title: "Voice fade";
 				readonly description: "How long the fade lasts. Only used when the clip fades out.";
 			};
+			readonly muteOnWindowBlur: {
+				readonly title: "Mute when unfocused";
+				readonly description: "Silences the game while another window is in front.";
+			};
 		};
 		readonly audio: {
 			readonly add: "Add track";
@@ -10946,8 +11056,8 @@ declare const en: {
 				readonly sidecarNote: "A program a plugin ships runs outside the game process and is not covered by the allowlist.";
 			};
 			readonly encryptAssetsTitle: "Encrypt assets";
-			readonly encryptAssetsDescription: "Encrypt assets, plugin code and the story bundle in packaged and previewed builds. Does not affect Dev Mode.";
-			readonly encryptAssetsWebHint: "Web builds always ship without asset protection.";
+			readonly encryptAssetsDescription: "Encrypt assets, plugin code and the story bundle in packaged and previewed desktop builds. Does not affect Dev Mode.";
+			readonly encryptAssetsWebHint: "Web, Android and iOS builds always ship without asset protection.";
 			readonly signingDescription: "Which credential signs each platform. Certificates and passwords stay on this machine; the project stores only which one to use.";
 			readonly imageModeTitle: "Image compression settings";
 			readonly imageWebpQualityTitle: "WebP quality";
@@ -11022,7 +11132,7 @@ declare const en: {
 			readonly scanning: "Scanning project\u2026";
 			readonly empty: "No plugin dependencies.";
 			readonly banner: {
-				readonly blocked: "Some plugins are disabled. Their installed version is incompatible. Update or reinstall them.";
+				readonly blocked: "Some plugins are not loaded for this project. Their installed version is incompatible. Update or reinstall them.";
 				readonly warnings: "A plugin is outdated, or an optional dependency is unavailable.";
 			};
 			readonly status: {
@@ -11031,6 +11141,7 @@ declare const en: {
 				readonly missing: "Missing";
 				readonly incompatible: "Incompatible";
 				readonly disabled: "Disabled";
+				readonly suppressed: "Off for this project";
 			};
 			readonly meta: {
 				readonly requires: "Requires {version}";
@@ -11207,6 +11318,9 @@ declare const en: {
 			readonly runAs: "Run as";
 			readonly runWithDlc: "Run with DLC";
 			readonly dlcCount: "{active} of {total}";
+			readonly previewAsShipped: "Preview as shipped";
+			readonly previewAsShippedDetail: "Preview runs the protected form players receive, and takes longer to start.";
+			readonly asShipped: "As shipped";
 			readonly resetData: "Reset player data";
 			readonly resetWhileRunning: "Stop it to reset its data";
 			readonly resetDevModeConfirm: "Reset Dev Mode player data?";
@@ -11463,6 +11577,11 @@ declare const en: {
 			readonly atLine: "Line {line} \u00B7 {scene}";
 			readonly inScene: "In {scene}";
 			readonly onSurface: "On {surface}";
+			readonly onPlugin: "Plugin {plugin}";
+			readonly pluginNotDeclared: "{plugin} is installed but not among this project's plugin dependencies. It does not run in this session and is not included in a build. Rescan them in Project \u25B8 App.";
+			readonly pluginUnusable: "{plugin} is among this project's plugin dependencies and cannot be loaded. It does not run in this session and is not included in a build. Check its status in Project \u25B8 App.";
+			readonly pluginEntryFailed: "{plugin} failed to load: {error}. Its blueprint nodes and widgets are not registered in this session.";
+			readonly pluginListFailed: "The runtime plugin list could not be read: {error}. No plugin runs in this session.";
 			readonly noLocation: "Could not be traced to a line";
 			readonly viaPlayHead: "where playback was";
 			readonly stack: "Stack";
@@ -11586,6 +11705,11 @@ declare const en: {
 			readonly openWorkspace: "Workspace";
 			readonly cannotOpen: "This blueprint cannot be opened from preview.";
 			readonly openFailed: "Unable to open blueprint.";
+			readonly scriptLoaded: "Loaded";
+			readonly scriptNotLoaded: "Not loaded";
+			readonly scriptExports: "Exports: {names}";
+			readonly scriptCalls: "Called here: {names}";
+			readonly scriptExportsNone: "Exports nothing";
 		};
 		readonly output: {
 			readonly logLevel: "Log Level";
@@ -11730,6 +11854,18 @@ declare const en: {
 			readonly trust: "This authority was not trusted.";
 		};
 	};
+	readonly projectTrust: {
+		readonly window: "Project Trust";
+		readonly title: "Trust this project?";
+		readonly untrusted: "Studio did not create this project. Until it is trusted, it can be edited but not run, previewed, built or tested.";
+		readonly meaning: "Once trusted, the code this project ships runs on this machine.";
+		readonly later: "This can be changed under Trusted projects in Settings.";
+		readonly confirm: "Trust";
+		readonly cancel: "Not now";
+		readonly error: {
+			readonly load: "The project details could not be read.";
+		};
+	};
 	readonly plugins: {
 		readonly installLocal: "Install from folder";
 		readonly search: {
@@ -12135,6 +12271,7 @@ declare const en: {
 				readonly output: "Choose where to write the file.";
 				readonly reading: "Reading the build folder.";
 				readonly artifact: "That folder holds no build of this game.";
+				readonly artifactAccess: "Choose that folder with Browse to read it.";
 				readonly dlcBaseline: "Select the build this DLC adds to.";
 				readonly dlcVariant: "That build is not the variant this DLC attaches to.";
 			};
@@ -12249,6 +12386,7 @@ declare const en: {
 			readonly "sidecar-crossbuild-exec-bit": string;
 			readonly "encryption-key-unavailable": "Asset protection is on, but its key could not be read.";
 			readonly "web-unprotected": "Asset protection does not apply to the web export; its files ship unprotected.";
+			readonly "mobile-unprotected": "Asset protection does not apply to Android or iOS packages.";
 			readonly "progress-carry-unsupported": string;
 			readonly "lossy-images": "Images are re-encoded at quality {setting} and lose detail permanently.";
 			readonly "lossy-audio": "Audio is re-encoded at {setting} kbit/s and loses detail permanently.";
@@ -12323,6 +12461,7 @@ declare const en: {
 			readonly showAll: "Show all {count}";
 			readonly failure: "Reason";
 		};
+		readonly cancelled: "Build stopped";
 		readonly invalidCommand: "Invalid command in {story} / {scene}: {source}";
 		readonly invalidCommandSummary: {
 			readonly one: "Build stopped: {count} invalid command. See the console.";
@@ -12346,7 +12485,7 @@ declare const en: {
 			readonly other: "Build stopped: {count} cut points are not at the top level of their scene. See the console.";
 		};
 		readonly contentBlockedStartStory: "A Start Game node in {location} picks its scene while the game runs. Pick the scene in the inspector, or list the scenes it can start in the {variant} variant.";
-		readonly contentBlockedScript: "The blueprint {location} is written in TypeScript and can start any scene. List the scenes it can start in the {variant} variant.";
+		readonly contentBlockedScript: "The script {location} can start any scene. List the scenes it can start in the {variant} variant.";
 		readonly contentBlockedPlugin: "The {location} plugin can start any scene. List the scenes it can start in the {variant} variant.";
 		readonly contentBlockedSummary: {
 			readonly one: "Build stopped: {count} place can start a scene the {variant} build cannot read. See the console.";
@@ -12377,6 +12516,7 @@ declare const en: {
 		};
 		readonly networkNodeDisallowed: "{blueprint} makes a network request, which this project does not allow.";
 		readonly pointerNodeUnsupported: "{blueprint} moves the mouse cursor, which does not work on {platforms}.";
+		readonly screenshotNodeUnsupported: "{blueprint} saves screenshots, which does not work on {platforms}.";
 		readonly networkSummary: {
 			readonly one: "Build stopped: {count} network node cannot run. Change the network policy in project settings, or remove the node.";
 			readonly other: "Build stopped: {count} network nodes cannot run. Change the network policy in project settings, or remove the nodes.";
@@ -12569,6 +12709,10 @@ declare const en: {
 				readonly description: "A network node in a project whose network policy is off";
 				readonly message: "{blueprint} makes a network request, which this project does not allow";
 			};
+			readonly storyUnreadable: {
+				readonly title: "Unreadable story";
+				readonly description: "A story document this Studio cannot open";
+			};
 			readonly storyInvalidCommand: {
 				readonly title: "Invalid command";
 				readonly description: "A row the compiler refuses";
@@ -12677,6 +12821,11 @@ declare const en: {
 				readonly description: "A row naming a transition this version cannot play";
 				readonly message: "The transition {transition} is not available, so this change plays as a cut";
 			};
+			readonly storyBackgroundUnchanged: {
+				readonly title: "Unchanged background";
+				readonly description: "A row transitioning to the background already on screen";
+				readonly message: "This background is already on screen, so the transition changes nothing";
+			};
 			readonly blueprintReferenceMissing: {
 				readonly title: "Missing target";
 				readonly description: "A node naming something the project no longer has";
@@ -12762,6 +12911,11 @@ declare const en: {
 				readonly description: "A Save Game node that will run with a declared save field left empty";
 				readonly message: "{field} is empty, so this save is written with its default instead";
 			};
+			readonly blueprintRequiredInputUnwired: {
+				readonly title: "Empty input";
+				readonly description: "A node that will run with a required input left unconnected";
+				readonly message: "{node} has nothing connected to {pin}";
+			};
 			readonly blueprintStartSceneForeign: {
 				readonly title: "Scene from another story";
 				readonly description: "A Start Game node whose scene is not in the story it names";
@@ -12870,6 +13024,8 @@ declare const en: {
 		readonly message: {
 			readonly ruleFailed: "{rule} could not run";
 			readonly storyLoadFailed: "{story} could not be opened";
+			readonly storyTooOld: "{story} is in story format v{version}, and this Studio opens v{minimum} and later";
+			readonly storyTooNew: "{story} was written by a newer NarraLeaf Studio (story format v{version}); this Studio reads up to v{supported}";
 		};
 		readonly category: {
 			readonly assets: "Assets";
@@ -12918,6 +13074,7 @@ declare const en: {
 			readonly finding: "{location} {message} ({rule})";
 		};
 		readonly build: {
+			readonly started: "Checking the project\u2026";
 			readonly blocked: "Build stopped by {count} problems";
 			readonly blockedHint: "Change this in Project \u25B8 Project \u25B8 Check before building";
 			readonly skipped: "Project check skipped";
@@ -13115,7 +13272,10 @@ declare const en: {
 			readonly blueprintRemoved: "Blueprint removed ({nodes} nodes)";
 			readonly blueprintChanged: "Blueprint changed";
 			readonly blueprintRenamed: "Renamed";
-			readonly blueprintSource: "Code changed";
+			readonly blueprintSource: "Script file changed";
+			readonly scriptAdded: "Script added";
+			readonly scriptRemoved: "Script removed";
+			readonly scriptChanged: "Script changed";
 			readonly blueprintField: "{field} changed";
 			readonly graphAdded: "Graph added ({nodes} nodes)";
 			readonly graphRemoved: "Graph removed ({nodes} nodes)";
@@ -13379,7 +13539,6 @@ declare const en: {
 			readonly animation: "Motion";
 			readonly uiDocument: "Interface pages";
 			readonly uiGraphs: "Interface blueprints";
-			readonly blueprint: "Blueprint";
 			readonly variables: "Variables";
 			readonly audioTracks: "Audio tracks";
 			readonly brand: "Brand palette";
@@ -13601,6 +13760,7 @@ declare const en: {
 			readonly durationMinutes: "{minutes}m {seconds}s";
 		};
 		readonly reason: {
+			readonly distrusted: "Not available until this project is trusted in Settings";
 			readonly frozen: "Not available while the workspace is frozen";
 			readonly alreadyRunning: "Another run is in progress";
 			readonly parameterEmpty: "{parameter} has no values in this project";
@@ -13813,6 +13973,10 @@ declare const en: {
 				readonly title: "Assets";
 				readonly body: string;
 			};
+			readonly assetSources: {
+				readonly title: "Where an asset's file comes from";
+				readonly body: string;
+			};
 			readonly assetSets: {
 				readonly title: "Asset sets";
 				readonly body: string;
@@ -13885,6 +14049,10 @@ declare const en: {
 				readonly title: "Blueprints";
 				readonly body: string;
 			};
+			readonly scripts: {
+				readonly title: "Scripts";
+				readonly body: string;
+			};
 			readonly uiBindings: {
 				readonly title: "Values on a screen";
 				readonly body: string;
@@ -14174,7 +14342,10 @@ declare const en: {
 			readonly copyDetails: "Copy details";
 			readonly copied: "Copied to the clipboard.";
 			readonly copyFailed: "Could not copy: {error}";
-			readonly logAt: "The report is in {path}";
+			readonly saveReport: "Save report";
+			readonly reportSaved: "The report is in {path}";
+			readonly reportFailed: "Could not save the report: {error}";
+			readonly logAt: "The log is in {path}";
 			readonly bridgeUnavailable: "The game's runtime bridge did not load";
 		};
 		readonly session: {
@@ -14224,6 +14395,30 @@ declare const en: {
 			readonly quit: "Quit";
 		};
 	};
+	readonly documents: {
+		readonly tooNew: {
+			readonly message: "{subject} was written by a newer NarraLeaf Studio ({kind} format v{version}); this build reads up to v{supported}";
+			readonly kind: {
+				readonly story: "story";
+				readonly storyIndex: "story library";
+				readonly storyAnimation: "animation";
+				readonly uiDocument: "interface";
+				readonly uiGraphs: "interface blueprint";
+				readonly blueprints: "blueprint";
+				readonly variables: "variable";
+				readonly saveSchema: "save schema";
+				readonly localization: "translation";
+				readonly localizationKeys: "translation key";
+				readonly voice: "voice";
+				readonly brand: "design";
+				readonly appTags: "variant";
+				readonly dlc: "DLC";
+				readonly assetSets: "asset set";
+				readonly audioTracks: "audio track";
+				readonly characters: "character";
+			};
+		};
+	};
 };
 type Messages = typeof en;
 type Flatten<T, Prefix extends string = ""> = {
@@ -14317,7 +14512,6 @@ declare function createBoundPrivilegedFacade(token: PrivilegedFacadeToken): {
 		ensureRegularFile: (path: string, data: string, encoding?: BufferEncoding) => Promise<RequestStatus<FsRequestResult<void>>>;
 		writeFileNoFollow: (path: string, data: string, encoding?: BufferEncoding) => Promise<RequestStatus<FsRequestResult<void>>>;
 		writeFileNoFollowOrCreate: (path: string, data: string, encoding?: BufferEncoding) => Promise<RequestStatus<FsRequestResult<void>>>;
-		recoverCorruptedJsonFile: (path: string, replacement: string, encoding?: BufferEncoding) => Promise<RequestStatus<FsRequestResult<void>>>;
 		createDir: (path: string) => Promise<RequestStatus<FsRequestResult<void>>>;
 		deleteFile: (path: string) => Promise<RequestStatus<FsRequestResult<void>>>;
 		deleteDir: (path: string) => Promise<RequestStatus<FsRequestResult<void>>>;
@@ -14487,8 +14681,6 @@ export declare enum AssetType {
 	Audio = "audio",
 	Video = "video",
 	JSON = "json",
-	/** Shared blueprint asset (M2); content is {@link import("@shared/types/blueprint/document").SharedBlueprintAsset} JSON */
-	Blueprint = "blueprint",
 	Font = "font",
 	/**
 	 * A **model bundle**: many files that form one authored thing (a Live2D or Spine character),
@@ -14537,12 +14729,6 @@ type JSONAssetMetadata = {
 	isValid: boolean;
 	schema?: string;
 };
-type BlueprintAssetMetadata = {
-	size: number;
-	isValid: boolean;
-	/** Logical schema version of the on-disk JSON wrapper; not the instance BlueprintDocument schema */
-	schemaVersion?: number;
-};
 type FontAssetMetadata = {
 	family?: string;
 	style?: string;
@@ -14592,9 +14778,6 @@ export type AssetData<Type extends AssetType> = Type extends AssetType.Image ? {
 } : Type extends AssetType.JSON ? {
 	data: Record<string, any>;
 	metadata: JSONAssetMetadata;
-} : Type extends AssetType.Blueprint ? {
-	data: SharedBlueprintAsset;
-	metadata: BlueprintAssetMetadata;
 } : Type extends AssetType.Font ? {
 	data: Uint8Array;
 	metadata: FontAssetMetadata;
@@ -14625,7 +14808,6 @@ export declare const AssetExtensions: {
 	audio: string[];
 	video: string[];
 	json: string[];
-	blueprint: string[];
 	font: string[];
 	/**
 	 * A model bundle is picked as a *directory*, not by extension, so this list is never handed to a
@@ -14924,6 +15106,20 @@ export type TestAvailabilityContext = {
 	 * and there is nothing for the refusal to protect.
 	 */
 	readonly frozen: boolean;
+	/**
+	 * Whether this project is one Studio will not run anything for - it arrived from a package or a
+	 * remote source and nobody has vouched for it yet.
+	 *
+	 * Passed in for the reason above and one more of its own: the ledger that answers it lives in
+	 * the main process, so asking costs a round trip, and everything here is synchronous. The host
+	 * settles the answer when the workspace comes up and hands the settled copy down.
+	 *
+	 * `checkAvailability` will not normally see this true - the host refuses every test before it
+	 * asks a definition anything, because a run is an execution of the project. It is here because
+	 * `options` is *not* gated: a list that would cost real work to build can decline to build it
+	 * for a project that cannot run it.
+	 */
+	readonly distrusted: boolean;
 };
 export type TestAvailability = {
 	available: true;
@@ -15010,7 +15206,8 @@ export type TestDefinition = {
 	/**
 	 * Evaluated when the picker opens, so keep it synchronous and cheap. Absent means always
 	 * available; the host still applies its own gates (a `windowed` test is unavailable while the
-	 * workspace is frozen no matter what this returns).
+	 * workspace is frozen, and no test runs at all in a project that is not trusted, no matter what
+	 * this returns).
 	 */
 	checkAvailability?(ctx: TestAvailabilityContext): TestAvailability;
 	run(ctx: TestRunContext): Promise<TestVerdict> | TestVerdict;
@@ -15214,6 +15411,26 @@ interface CharacterEditorProfile extends CharacterBaseProfile {
 	 * survives a kind switch, which discards everything the kinds do not share.
 	 */
 	voiceTrackId?: string | null;
+	/**
+	 * The transform props this character's `enter` rows fall back to, channel by channel.
+	 *
+	 * How big a sprite is drawn, which way it faces and where its feet land are properties of the
+	 * artwork, not of the line that brings it on: the numbers come from the picture's pixel size
+	 * against the stage's, so an author who has to state them on every entrance is copying one
+	 * answer down the whole script. Absent means what it always meant - an entrance states
+	 * everything or takes the stage's own values.
+	 *
+	 * A row still wins on any channel it names, and only on that channel; see
+	 * `@shared/story/characterEntrance` for the merge, which channels a default may carry, and why
+	 * `move` and `exit` do not inherit.
+	 *
+	 * On the profile rather than the appearance because a kind switch discards everything the kinds
+	 * do not share, and a character is the same size on stage whichever way she is drawn.
+	 *
+	 * Additive: no character written before this carries one, so no schema bump - the same terms
+	 * `voiceTrackId` was added on.
+	 */
+	entranceTransform?: StoryTransformProps;
 }
 interface CharacterNamed {
 	readonly id: string;
@@ -15601,6 +15818,18 @@ declare class CharacterProfile {
 	 */
 	getVoiceTrackId(): string | null;
 	setVoiceTrackId(trackId: string | null): void;
+	/**
+	 * The transform props this character's entrances fall back to. `undefined` is "no defaults",
+	 * which is what every character had before the field existed.
+	 */
+	getEntranceTransform(): StoryTransformProps | undefined;
+	/**
+	 * Stored sanitized, so what the compiler reads back is what this setter accepted - a bag holding
+	 * only channels an entrance can act on. An empty bag is stored as no bag at all: "states
+	 * nothing" and "has no defaults" are the same instruction here, and keeping the empty record
+	 * would leave a key in the document that no longer means anything.
+	 */
+	setEntranceTransform(props: StoryTransformProps | undefined): void;
 	getNicknames(): string[];
 	addNickname(nickname: string): void;
 	removeNickname(nickname: string): void;
@@ -15894,6 +16123,11 @@ type UIDisplayableMotionOverride = {
 };
 type TextWritingMode = NlrTextWritingMode;
 type TextOrientation = TextGlyphOrientation;
+type UITextRunMarks = Pick<StoryTextMarks, "bold" | "italic" | "color" | "ruby" | "fontSizeStep" | "emphasis">;
+type UITextRun = {
+	text: string;
+	marks?: UITextRunMarks;
+};
 type EffectShadowLayerData = {
 	offsetX: number;
 	offsetY: number;
@@ -15934,6 +16168,15 @@ type TextVerticalAlign = "start" | "center" | "end";
 type TextWrapMode = "word" | "character" | "nowrap";
 type TextWidgetProps = {
 	text: string;
+	/**
+	 * The label's text as marked runs, when it carries any.
+	 *
+	 * `text` stays the plain string and stays what everything else reads - a value binding writes
+	 * it, a translation replaces it, a plain field edits it - and these runs are only drawn while
+	 * they still spell it (`resolveUITextRuns`). Absent on every label that has never been marked,
+	 * which is what keeps the drawing of a plain label exactly what it was.
+	 */
+	rich?: UITextRun[];
 	/** Game-localization opt-in: registers the implicit translation unit `ui:<elementId>.text`. */
 	localizable?: boolean;
 	/** Named localization key reference; takes precedence over the implicit unit. */
@@ -16088,6 +16331,11 @@ type BlueprintGamePreferenceKey = "autoForward" | "skip"
  * defaults through exactly the same plumbing as the twelve the engine defines.
  */
  | "skipReadText"
+/**
+ * Studio's own: the game's whole output goes quiet while its window is not the one the player is
+ * working in. What acts on it is the host's output gate (`focusMute`), not the engine.
+ */
+ | "muteOnWindowBlur"
 /**
  * Studio's own, and transient: the skip run is going. Writing it is the equivalent of holding
  * the skip key, and the host clears it whenever the run ends - a guard stopping it, the game
@@ -16139,6 +16387,22 @@ type BlueprintHostApiRuntime = {
 		 * `@shared/types/blueprint/externalLink`.
 		 */
 		openExternal: (request: BlueprintOpenExternalRequest) => Promise<BlueprintOpenExternalResult>;
+		/**
+		 * Write a picture of the frame the player is looking at, and say where it went.
+		 *
+		 * The shell decides where: a path chosen in a graph would be a path a graph could write
+		 * anywhere the player's account can. See `@shared/types/blueprint/screenshot`.
+		 */
+		saveScreenshot: () => Promise<BlueprintScreenshotResult>;
+		/** Show the player the folder those pictures are in. */
+		openScreenshotsFolder: () => Promise<BlueprintOpenScreenshotsResult>;
+		/**
+		 * Whether this game's window is the one the player is working in right now.
+		 *
+		 * True wherever the shell cannot tell, which is the honest reading of "there is no window
+		 * to be behind": a story preview inside Studio is always the thing being looked at.
+		 */
+		isWindowFocused: () => Promise<boolean>;
 	};
 	/** Surfaces stacked over the page lane. See the `layers` family in `@shared/types/blueprint/hostApi`. */
 	layers: {
@@ -16279,6 +16543,8 @@ type BlueprintHostApiRuntime = {
 		getSaveTimes: (id: string) => Promise<SaveRecordTimes | null>;
 		/** Where a slot stopped, or null when there is no such slot. */
 		getSaveLine: (id: string) => Promise<SaveRecordLine | null>;
+		/** Which story a slot was written in, or null when there is no such slot. */
+		getSaveStory: (id: string) => Promise<SaveRecordStory | null>;
 		/** How long a slot was played, or null when there is no such slot. */
 		getSavePlaytime: (id: string) => Promise<SaveRecordPlaytime | null>;
 		/** The running playthrough's playtime, in seconds. */
@@ -16624,83 +16890,10 @@ type BehaviorNodeExecuteResult = {
 	nextPorts?: string[];
 	outputValues?: Record<string, unknown>;
 };
-type BehaviorGraphExecutionTrace = {
-	executionId: string;
-	graphId: UIGraphId;
-	blueprintId?: string;
-	eventId?: string;
-	/**
-	 * Surface the graph belongs to, carried so an `execution.error` raised in here says where it
-	 * happened. The dispatcher reports the same failure a second time when it catches it, and the
-	 * two reports have to be the SAME report - a host that collapses repeats by their text would
-	 * otherwise list one failure twice, once with a place and once without.
-	 */
-	surfaceId?: string;
-	emit: (event: BlueprintDebugEvent) => void;
-};
-type BlueprintValueDependency = {
-	surfaceId: string;
-	elementId: string;
-	propPath: string;
-};
-type BehaviorGraphValueExecution = {
-	returnValue(value: unknown): void;
-	trackDependency?(dependency: BlueprintValueDependency): void;
-};
 type BehaviorGraphEventControl = {
 	stopPropagation(): void;
 	isPropagationStopped(): boolean;
 };
-type BehaviorNodeExecutionContext = {
-	graph: UIGraph;
-	entry: UIGraphEntry;
-	node: UIGraphNode;
-	params: Record<string, unknown>;
-	/**
-	 * Read one of this node's declared data input pins, following the wired
-	 * edge. Lazy - nothing is resolved unless a node asks. Returns undefined for
-	 * unwired or undeclared pins.
-	 *
-	 * Always supplied by both graph executors; optional only because tests build
-	 * partial contexts. Call it as `ctx.resolveInput?.(pinId)`.
-	 */
-	resolveInput?: (pinId: string) => unknown;
-	hostAdapter: UIHostAdapter;
-	trace?: BehaviorGraphExecutionTrace;
-	/** Per-event execution locals; initialized from blueprint member variables (M4 simplified editor). */
-	blueprintLocals?: Record<string, unknown>;
-	/** Runtime event slot currently being handled, for nodes that need to continue event propagation. */
-	eventName?: string;
-	eventPayload?: Record<string, unknown>;
-	eventControl?: BehaviorGraphEventControl;
-	signal?: AbortSignal;
-	listItemScope?: UIListItemScope | null;
-	instanceKey?: string;
-	executionOwner?: {
-		surfaceId?: string;
-		elementId?: string;
-		blueprintId?: string;
-		componentId?: string;
-		/**
-		 * Resolved params of the component instance this execution belongs to, by param id.
-		 *
-		 * Sits beside `componentId` rather than at the top of the context because owner identity and
-		 * the instance's own values are one answer to "which placement is running" - and because
-		 * every data-pin resolver already forwards this object as a unit, which is what lets a pure
-		 * node read it without thirty-odd call sites learning a new field.
-		 */
-		componentParams?: Record<string, string>;
-	};
-	persistentVariables?: PersistentVariableRuntimeTable;
-	valueExecution?: BehaviorGraphValueExecution;
-	/** Nesting depth of blueprint fn invocations; guards runaway recursion in the dispatcher. */
-	fnCallDepth?: number;
-};
-type BehaviorNodeDefinition = {
-	type: string;
-	displayName: string;
-	execute: (ctx: BehaviorNodeExecutionContext) => BehaviorNodeExecuteResult | void | Promise<BehaviorNodeExecuteResult | void>;
-};
 type StoryBlockSelection = {
 	editor: "story";
 	tabId: string;
@@ -18531,20 +18724,8 @@ type BlueprintInspectorParamDef = {
 		optionMetaKey: string;
 	};
 };
-type BlueprintNodeScopeOwnerKind = BlueprintOwnerRef["kind"];
-type BlueprintNodeScope = {
-	anyOf?: BlueprintNodeScope[];
-	ownerKinds?: BlueprintNodeScopeOwnerKind[];
-	/** When set, node only appears for widgetMain blueprints whose element.type matches. */
-	widgetElementTypes?: string[];
-};
 type BlueprintNodeRole = "normal" | "eventHead" | "fnHead" | "functionEntry" | "reroute" | "dataLiteral" | "elementLiteral" | "elementEventHead" | "imageAssetLiteral" | "valueReturn" | "comment";
-export type BlueprintNodeExecuteFn = BehaviorNodeDefinition["execute"];
-/**
- * Full node definition: editor pins + inspector + runtime execute.
- * Registered via defineBlueprintNode().
- */
-export type BlueprintNodeDef = {
+type BlueprintNodeDeclaration = {
 	type: string;
 	displayName: string;
 	category: string;
@@ -18575,7 +18756,12 @@ export type BlueprintNodeDef = {
 	 * built on one refreshes on the host's dependencies, never on the plugin's.
 	 */
 	allowInBlueprintValueGraph?: boolean;
-	/** Palette-only guard for nodes that read the active List item template scope. */
+	/**
+	 * The node reads the list row that is in scope while it runs, so it belongs only where a row can
+	 * be: on an element a list draws once per row, or on the list itself, whose item heads each run
+	 * for one row. Enforced by `isBlueprintNodeAllowedInGraphContext`, so the palette and the graph
+	 * validator answer it the same way.
+	 */
 	requiresListItemContext?: boolean;
 	/** Latent/async execution (delay, host awaits) - disallowed in function graphs */
 	isLatent?: boolean;
@@ -18594,20 +18780,7 @@ export type BlueprintNodeDef = {
 		kind: "input" | "output";
 	};
 	inspectorParams?: BlueprintInspectorParamDef[];
-	scope?: BlueprintNodeScope;
-	/**
-	 * This node reaches the blueprint host API, so it may only appear where a host serves one.
-	 *
-	 * Set at registration for whole families rather than per node (see `HOST_API_OWNER_KINDS`),
-	 * and deliberately NOT expressed as a {@link BlueprintNodeScope}: a scope answers "which
-	 * owners and which widget types", and `resolveEffectiveBlueprintNodePins` reads the mere
-	 * PRESENCE of one as "this is the widget-scoped variant, so hide the element pin". Writing
-	 * this restriction as a scope therefore stripped the element pin off every magic-element
-	 * node in the catalogue.
-	 */
-	requiresHostApi?: boolean;
 	role?: BlueprintNodeRole;
-	execute: BlueprintNodeExecuteFn;
 };
 interface WorkspaceContext {
 	project: Porject;
@@ -18907,6 +19080,7 @@ declare const HELP_TOPIC_IDS: readonly [
 	"dictionary",
 	"dictionaryMarks",
 	"assets",
+	"assetSources",
 	"assetSets",
 	"assetSetAxes",
 	"mediaConversion",
@@ -18925,6 +19099,7 @@ declare const HELP_TOPIC_IDS: readonly [
 	"inputActionsInBlueprints",
 	"uiComponents",
 	"blueprints",
+	"scripts",
 	"uiBindings",
 	"networkNodes",
 	"spellcheck",
@@ -20387,8 +20562,16 @@ declare const pluginUi: Readonly<{
 }>;
 export type PluginUiKit = typeof pluginUi;
 /**
- * A blueprint node as a *plugin* writes it: the editor's full palette metadata,
- * but with the narrowed execute of `narraleaf-studio/runtime`.
+ * A blueprint node as a *plugin* writes it: everything a node declares about itself, with the
+ * narrowed execute of `narraleaf-studio/runtime`.
+ *
+ * Built on `BlueprintNodeDeclaration` rather than on the host's `BlueprintNodeDef`, so the two
+ * fields that say *where* a node may appear — `scope` and `requiresHostApi` — are not merely
+ * omitted here but unreachable from the published package. `scope` in particular is a list of
+ * owner kinds taken from `BlueprintOwnerRef`; publishing it would let a plugin pin an internal
+ * union, and every later change to the blueprint model would break plugins that had. Both
+ * restrictions are the host's answer, decided by review for the built-in catalogue, and the host
+ * drops either one a plugin's compiled JavaScript still carries.
  *
  * The host's own `BlueprintNodeDef.execute` receives a `BehaviorNodeExecutionContext`,
  * which carries `hostAdapter` — and through it every host API: saves, localization,
@@ -20396,13 +20579,15 @@ export type PluginUiKit = typeof pluginUi;
  * declared and the user never approved. So a plugin's execute gets the very same
  * capability-gated context its runtime entry gets, in both targets: one node module
  * can be shared by the studio and runtime entries, and neither is the privileged one.
+ * That is also why `BlueprintNodeExecuteFn`, which names the host context, is not published:
+ * nothing a plugin can write would satisfy it.
  *
  * The editor is an environment that backs no game, so the gated domains on
  * `ctx.game` (`saves`, `store`, `state`, …) are absent while a node runs in Studio.
  * Nodes must degrade rather than assume them — the same discipline a plugin already
  * needs for the web export versus the desktop shell.
  */
-export type PluginBlueprintNodeDef = Omit<BlueprintNodeDef, "execute"> & {
+export type PluginBlueprintNodeDef = BlueprintNodeDeclaration & {
 	execute: RuntimeBlueprintNodeExecute;
 };
 /**