narraleaf-studio 0.6.0 → 0.8.0

package/dist/_api.d.ts

@@ -11,7 +11,6 @@
 // Generated by dts-bundle-generator v9.5.1
 
 import { LucideIcon } from 'lucide-react';
-import { TextGlyphOrientation, TextWritingMode as NlrTextWritingMode } from 'narraleaf-react';
 import React$1 from 'react';
 import { ComponentType, InputHTMLAttributes, ReactElement, ReactNode, RefObject } from 'react';
 
@@ -1422,260 +1421,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;
-	blueprintId: string;
-} | {
-	type: "execution.finished";
-	executionId: string;
-	blueprintId: string;
-} | {
-	type: "execution.cancelled";
-	executionId: string;
-	blueprintId?: string;
-	eventId?: string;
-	graphId?: string;
-	nodeId?: string;
-	reason?: string;
-} | {
-	type: "node.enter";
-	executionId: string;
-	nodeId: string;
-} | {
-	type: "node.exit";
-	executionId: string;
-	nodeId: string;
-} | {
-	type: "state.read";
-	scope: string;
-	key: string;
-} | {
-	type: "state.write";
-	scope: string;
-	key: string;
-} | {
-	type: "binding.evaluated";
-	bindingId: string;
-} | {
-	type: "function.call";
-	functionId: string;
-} | {
-	type: "function.return";
-	functionId: string;
-} | {
-	type: "devtools.log";
-	level: string;
-	message: string;
-} | {
-	type: "execution.error";
-	executionId: string;
-	message: string;
-	blueprintId?: string;
-	eventId?: string;
-	graphId?: string;
-	nodeId?: string;
-	/**
-	 * The UI surface whose graph failed, when the failure happened on one.
-	 *
-	 * The rest of this event names OUR ids - a blueprint, a graph, a node - none of which an
-	 * author can find their way back from. A surface id resolves against the document they
-	 * drew, which is what lets a host say "the Quick Menu" rather than "bp:8f2c1a…". Absent on
-	 * the global blueprint, which belongs to no surface.
-	 */
-	surfaceId?: string;
-};
 type BlueprintOwnerRef = {
 	kind: "globalMain";
 } | {
@@ -1694,9 +1439,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 +1459,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 +1526,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 +1548,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 +1606,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 +1627,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,166 +1660,243 @@ 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 AudioClipRegion = {
+	/** Offset from the start of the clip, in milliseconds. Where playback starts. */
+	inMs?: number;
+	/** Offset from the start of the clip, in milliseconds. Where playback stops, or where a loop turns around. */
+	outMs?: number;
+	/**
+	 * Offset from the start of the clip, in milliseconds. Where each repeat returns to.
+	 *
+	 * Absent means "return to {@link inMs}" - a plain loop, and exactly what every record written
+	 * before this field existed means. Set past the in point it describes the standard VN
+	 * **intro→loop**: `inMs..loopStartMs` plays once, then `loopStartMs..outMs` repeats forever.
+	 *
+	 * Constrained to `inMs <= loopStartMs < outMs`. A value outside that window is dropped rather
+	 * 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 LocaleCode = string;
-type LocalizationLocaleEntry = {
-	code: LocaleCode;
-	/** Author-facing autonym shown to players (e.g. "日本語", never "Japanese"). */
-	displayName: string;
-	/** Optional intermediate fallback locale tried before the source locale. */
-	fallback?: LocaleCode;
+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 GameLocalizationBundle = {
-	sourceLocale: LocaleCode;
-	locales: LocalizationLocaleEntry[];
-	tables: Record<LocaleCode, Record<string, string>>;
-	/** Named-key source texts (key name → source-language text). */
-	keys?: Record<string, string>;
+type BlueprintGraphKind = "event" | "function" | "macro";
+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";
 	/**
-	 * Scene-name source texts (scene id → source-language name), for the scenes this build ships.
+	 * `app.game.saves.write` / `.load` — overwrite a save slot and load one.
 	 *
-	 * The same job `keys` does for named keys: a translation table only holds the *target* side, so
-	 * without this a `scene:` reference read while the game is in the source language has nothing to
-	 * render but the id. Assembled from the story documents the bundle carries, so a scene a variant
-	 * dropped is absent here too.
+	 * 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.
 	 */
-	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;
+	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";
 	/**
-	 * 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.
+	 * `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.
 	 */
-	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;
-	/** When this slot was first written, epoch milliseconds; 0 when the record carries no stamp. */
-	createdAt: number;
-};
-type SaveRecordPlaytime = {
-	/** Seconds of play behind the slot; 0 when nothing was recorded. */
-	seconds: number;
-	/** False when the slot carries no reading at all. */
-	recorded: boolean;
-};
-type SaveRecordLine = {
-	/** The last sentence shown, or "" when the record carries none. */
-	line: string;
-	/** Who spoke it, or "" when the record carries no speaker (narration, or none yet). */
-	speaker: string;
-};
-type AutoSaveEntry = {
-	id: string;
-	/** Slot index within the ring. */
-	slot: number;
-	/** When this slot was last written, epoch milliseconds. */
-	timestamp: number;
-	/** When this slot was first written, epoch milliseconds. */
-	createdAt: number;
-	/** Whatever the writer attached as user metadata (null when none). */
-	metadata: unknown;
-};
-type VoiceLocaleEntry = {
-	code: LocaleCode;
-	/** Author-facing autonym shown for this voice language (e.g. "日本語"). */
-	displayName: string;
-};
-type AudioClipRegion = {
-	/** Offset from the start of the clip, in milliseconds. Where playback starts. */
-	inMs?: number;
-	/** Offset from the start of the clip, in milliseconds. Where playback stops, or where a loop turns around. */
-	outMs?: number;
+	readonly Locale: "locale";
 	/**
-	 * Offset from the start of the clip, in milliseconds. Where each repeat returns to.
+	 * `app.game.menu` — own the menu bar above the game.
 	 *
-	 * Absent means "return to {@link inMs}" - a plain loop, and exactly what every record written
-	 * before this field existed means. Set past the in point it describes the standard VN
-	 * **intro→loop**: `inMs..loopStartMs` plays once, then `loopStartMs..outMs` repeats forever.
+	 * 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.
 	 *
-	 * Constrained to `inMs <= loopStartMs < outMs`. A value outside that window is dropped rather
-	 * 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.
+	 * 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.
 	 */
-	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;
+	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";
+	/**
+	 * `app.game.diagnostics` — read what the player's caches are holding.
+	 *
+	 * The lightest of the list to grant and the easiest to misread as heavier than it is. Nothing
+	 * here is authored data: it reports how many images the engine is holding, how many bytes those
+	 * cost, and what budgets they are being held against. It reads no story, no save and no
+	 * variable, and every member is a read - there is nothing to set.
+	 *
+	 * It is its own capability rather than free like `data` and `config` because a plugin that
+	 * watches memory is a plugin that runs continuously and reports numbers about the player's
+	 * machine, and an author should see that named at install. The performance inspector is the
+	 * plugin this exists for.
+	 *
+	 * Absent until a game session is live, which is the same rule every other engine-backed member
+	 * follows: a plugin's `setup()` runs during boot, and asking then answers null rather than
+	 * throwing.
+	 */
+	readonly Diagnostics: "diagnostics";
 };
+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
@@ -2387,11 +2204,6 @@ export type RuntimePluginDescriptor = {
 	 */
 	buildConfig?: Record<string, string>;
 };
-type GameProgressImportOutcome = {
-	outcome: "found" | "missing" | "failed";
-	sceneId: string;
-	error: string;
-};
 type GameMenuLabel = {
 	readonly key?: string | null;
 	readonly text: string;
@@ -2501,13 +2313,6 @@ type GameMenuSpecMenu = {
 type GameMenuSpec = {
 	readonly menus: readonly GameMenuSpecMenu[];
 };
-type UIInputActionSource = "pointer" | "key" | "gamepad" | "touch";
-type UIInputActionEventPayload = {
-	actionId: string;
-	source: UIInputActionSource;
-	x?: number;
-	y?: number;
-};
 declare const UI_INPUT_POINTER_GESTURES: readonly [
 	"click",
 	"doubleClick",
@@ -2813,72 +2618,6 @@ type UILayout = {
 	lockAspectRatio?: boolean;
 };
 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;
-	/** Row-precise "play from here": enter the game pre-posed at this block and play forward. */
-	startBlockId?: string;
-	/** Scene Snapshot (变量快照) whose variable overrides seed the launch. */
-	snapshotId?: string;
-};
 type GameTestLogLevel = "verbose" | "info" | "success" | "warning" | "error";
 type GameTestExitReason = 
 /** Closed from inside the game - the window's own close, or the engine quitting itself. */
@@ -3465,6 +3204,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 +3310,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 +3851,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 +3976,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 +4012,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 +4092,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 +4131,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 +4184,7 @@ declare const en: {
 					readonly characters: "characters";
 					readonly project: "project settings";
 					readonly assets: "asset library";
+					readonly openEditors: "the open editor";
 				};
 			};
 			readonly reload: {
@@ -4427,6 +4203,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 +4255,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 +5900,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 +5917,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 +6013,7 @@ declare const en: {
 		};
 		reason: {
 			unknownCommand: string;
+			unknownCommandNear: string;
 			unknownParam: string;
 			duplicateParam: string;
 			extraPositional: string;
@@ -6700,6 +6532,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 +6646,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 +6662,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 +7047,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 +7237,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 +7279,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 +7311,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 +7335,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 +7499,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 +7741,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 +7831,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 +7841,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 +8000,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 +8048,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 +8313,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 +8459,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 +8492,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 +8549,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 +8702,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 +8968,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 +9287,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 +9298,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 +9312,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: {
@@ -9581,6 +9451,10 @@ declare const en: {
 			};
 			readonly refs: "{count} refs";
 		};
+		readonly canvas: {
+			readonly unknownWidget: "Unknown widget";
+			readonly widgetRenderFailed: "Widget failed to draw";
+		};
 		readonly editor: {
 			readonly componentNotFound: "Component not found";
 			readonly interfaceNotFound: "Interface not found";
@@ -9745,7 +9619,7 @@ declare const en: {
 			readonly interaction: "Interaction";
 		};
 		readonly blueprint: {
-			readonly controlLabel: "Control blueprint";
+			readonly controlLabel: "Component logic";
 		};
 		readonly appearance: {
 			readonly title: "Appearance";
@@ -9757,6 +9631,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 +9799,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 +9916,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 +9927,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.";
@@ -10418,6 +10299,7 @@ declare const en: {
 			readonly insert: "Insert {name}";
 			readonly drawing: "Drawing {name}: drag on canvas to create";
 			readonly moreInsertElements: "More insert elements";
+			readonly fromPlugin: "From {plugin}";
 			readonly components: "Components";
 			readonly openComponentLibrary: "Open Component Library";
 			readonly componentLibrary: "Component Library";
@@ -10864,6 +10746,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 +10832,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 +10908,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 +10917,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 +11094,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 +11353,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 +11481,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";
@@ -11701,6 +11601,7 @@ declare const en: {
 				readonly locale: "Read the game language and the project's localized text";
 				readonly menu: "Provide the game's menu bar";
 				readonly storyCompile: "Take part in compiling stories, and add actions to lines it did not write";
+				readonly diagnostics: "Read how much memory the game\u2019s caches are using";
 			};
 		};
 		readonly button: {
@@ -11730,6 +11631,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: {
@@ -11800,6 +11713,25 @@ declare const en: {
 			readonly registry: "Failed to reach the plugin registry";
 			readonly download: "Failed to download plugin";
 		};
+		readonly dependencies: {
+			readonly title: "Project dependencies";
+			readonly unavailable: {
+				readonly one: "{count} plugin this project needs is not available.";
+				readonly other: "{count} plugins this project needs are not available.";
+			};
+			readonly allReady: "Every plugin this project needs is available.";
+			readonly open: "Open dependencies";
+			readonly installAll: "Install all";
+			readonly updated: "Updated";
+			readonly authorized: "Authorized";
+			readonly notInRegistry: "Not in the registry";
+			readonly noCompatibleVersion: "No compatible version";
+			readonly task: {
+				readonly running: "Installing dependencies\u2026";
+				readonly done: "Dependencies installed.";
+				readonly partial: "Some plugins were not installed.";
+			};
+		};
 		readonly workspace: {
 			readonly reload: "Reload in this workspace";
 			readonly activity: {
@@ -11811,7 +11743,6 @@ declare const en: {
 				readonly suppressedHint: "The installed version is incompatible with the one this project was authored against. Update it, or update the project's dependency table from Project \u25B8 App.";
 				readonly failed: "Failed to load";
 			};
-			readonly suppressedNotice: "Not loaded for this project: {names}. The installed version is incompatible with the one the project was authored against. See the Plugins panel.";
 			readonly pendingReopen: "Takes effect the next time this project opens.";
 			readonly restartHint: "Some plugin changes take effect only after the workspace is restarted.";
 			readonly restart: "Restart";
@@ -12135,6 +12066,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 +12181,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 +12256,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 +12280,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 +12311,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 +12504,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 +12616,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";
@@ -12737,6 +12681,11 @@ declare const en: {
 				readonly description: "A clickable widget nothing listens to";
 				readonly message: "Nothing runs when this is clicked";
 			};
+			readonly uiUnknownWidget: {
+				readonly title: "Unknown widget type";
+				readonly description: "A widget whose type the project cannot load";
+				readonly message: "{type} is not loaded, so this widget will not be drawn in the game";
+			};
 			readonly uiComponentMissing: {
 				readonly title: "Missing component";
 				readonly description: "An instance of a component the project does not have";
@@ -12762,6 +12711,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 +12824,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 +12874,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 +13072,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 +13339,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 +13560,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 +13773,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 +13849,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 +14142,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 +14195,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 +14312,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 +14481,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 +14529,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 +14578,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 +14608,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
@@ -14636,26 +14618,6 @@ export declare const AssetExtensions: {
 	model: string[];
 	other: string[];
 };
-type BlueprintVector2D = {
-	x: number;
-	y: number;
-};
-type BlueprintRect = {
-	x: number;
-	y: number;
-	width: number;
-	height: number;
-};
-type BlueprintRGBAColor = {
-	r: number;
-	g: number;
-	b: number;
-	a: number;
-};
-type BlueprintImageAsset = {
-	kind: "imageAsset";
-	assetId: string;
-};
 type BlueprintAssetPinKind = "image" | "audio" | "font";
 type BlueprintAssetPinRef = {
 	kind: BlueprintAssetPinKind;
@@ -14674,10 +14636,6 @@ type BlueprintAssetPinRef = {
 	 */
 	origin?: "stored" | "published";
 };
-type BlueprintSoundHandle = {
-	kind: "soundHandle";
-	id: string;
-};
 interface ProjectProps {
 	projectPath: string;
 }
@@ -14923,7 +14881,21 @@ export type TestAvailabilityContext = {
 	 * participant is the working tree, so a game launched from it runs what everybody is looking at
 	 * and there is nothing for the refusal to protect.
 	 */
-	readonly frozen: boolean;
+	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 +14982,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 +15187,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 +15594,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;
@@ -15666,33 +15671,6 @@ type UIElementSelection = {
 	elementIds: UIElementId[];
 	primaryId?: UIElementId;
 };
-type GradientKind = "linear" | "radial" | "conic";
-interface GradientStop {
-	/** 0..1 along the gradient line. */
-	offset: number;
-	/**
-	 * A stored colour string: a literal, or `nlbrand:<id>[/<alpha>]`. Deliberately unresolved - see
-	 * the file comment.
-	 */
-	color: string;
-}
-interface GradientFill {
-	kind: GradientKind;
-	/** Normalised to two or more, sorted by offset, offsets clamped to 0..1. */
-	stops: GradientStop[];
-	/** Linear and conic. Degrees, CSS convention: 0 points to the top, 90 to the right. */
-	angle?: number;
-	/** Radial and conic. 0..1 of the painted box. */
-	center?: {
-		x: number;
-		y: number;
-	};
-	/** Radial. 0..1 of the painted box, one radius per axis. */
-	radius?: {
-		x: number;
-		y: number;
-	};
-}
 type ImageFillMode = "cover" | "contain" | "stretch" | "crop" | "tile";
 interface ImageFillCropPlacement {
 	leftPct: number;
@@ -15727,980 +15705,11 @@ type UIListItemScope = {
 	 */
 	struct?: UIStructDef | null;
 };
-type UIListScrollMetrics = {
-	offset: number;
-	maxOffset: number;
-	progress: number;
-};
-declare const BLUEPRINT_HOST_API_CONTRACT_VERSION: 39;
-type BlueprintHostApiContractVersion = typeof BLUEPRINT_HOST_API_CONTRACT_VERSION;
-type BlueprintCharacterInfo = {
-	id: string;
-	/** Author-facing display name. Empty when the character is unnamed - never falls back to `id`, which is a UUID. */
-	name: string;
-	/**
-	 * The author's accent colour, already in pin shape. Null when the character has no colour set,
-	 * which is a different thing from "white" - see {@link blueprintCharacterColorOrDefault} for
-	 * what a non-nullable colour pin does with it.
-	 */
-	color: BlueprintRGBAColor | null;
-	/** The character's default dialog avatar, or null when it has none. */
-	avatar: BlueprintImageAsset | null;
-};
-type AppearanceSystemCondition = Partial<{
-	hovered: boolean;
-	active: boolean;
-	disabled: boolean;
-	focused: boolean;
-	/** Inside the row a list has selected. */
-	selected: boolean;
-}>;
-type AppearanceRowValue = string | number | boolean | null | ImageFill | GradientFill | Record<string, unknown>;
-type AppearanceValueRow = {
-	conditions?: AppearanceSystemCondition | null;
-	value: AppearanceRowValue;
-};
-type AppearanceTransitionTweenEasing = "linear" | "easeIn" | "easeOut" | "easeInOut" | "circIn" | "circOut" | "circInOut";
-type AppearanceFieldTransition = {
-	type: "tween";
-	durationMs: number;
-	delayMs?: number;
-	easing: AppearanceTransitionTweenEasing;
-} | {
-	type: "spring";
-	delayMs?: number;
-	stiffness: number;
-	damping: number;
-	mass: number;
-};
-type ContainerAppearancePropertyKey = "backgroundColor" | "borderRadius" | "borderRadiusTL" | "borderRadiusTR" | "borderRadiusBL" | "borderRadiusBR" | "borderRadiusLinked" | "borderColor" | "borderWidth" | "borderStyle" | "backgroundImage" | "backgroundFit" | "imageFill" | "gradientFill" | "fillType" | "fillVisible" | "fillOpacity" | "strokeVisible" | "strokeOpacity" | "strokeAlign" | "strokeSide" | "borderJoin" | "cornerAdvanced" | "transformOffsetX" | "transformOffsetY" | "transformScale" | "transformRotation" | "transformOpacity" | "effectBlur" | "effectBackgroundBlur" | "effectShadow" | "effectInnerShadow" | "effectBlend" | "effectGlow" | "effectFilter";
-declare const BUTTON_CURSOR_VALUES: readonly [
-	"auto",
-	"default",
-	"pointer",
-	"text",
-	"move",
-	"grab",
-	"grabbing",
-	"crosshair",
-	"help",
-	"wait",
-	"progress",
-	"not-allowed"
-];
-type ButtonCursorValue = (typeof BUTTON_CURSOR_VALUES)[number];
-type ButtonAppearancePropertyKey = "fontAssetId" | "fontSize" | "fontWeight" | "color" | "lineHeight" | "backgroundColor" | "fillType" | "fillOpacity" | "fillVisible" | "imageFill" | "gradientFill" | "backgroundImage" | "backgroundFit" | "borderRadius" | "borderWidth" | "borderColor" | "borderStyle" | "strokeOpacity" | "strokeSide" | "borderJoin" | "strokeAlign" | "paddingX" | "paddingY" | "clipContent" | "cursor" | "transformOffsetX" | "transformOffsetY" | "transformScale" | "transformRotation" | "transformOpacity" | "effectBlur" | "effectBackgroundBlur" | "effectShadow" | "effectTextShadow" | "effectInnerShadow" | "effectBlend" | "effectGlow" | "effectFilter";
-type TextAppearancePropertyKey = "fontAssetId" | "fontSize" | "fontWeight" | "fontStyle" | "color" | "lineHeight" | "transformOffsetX" | "transformOffsetY" | "transformScale" | "transformRotation" | "transformOpacity" | "effectBlur" | "effectTextShadow" | "effectBlend" | "effectFilter";
-type AppearancePropertyGroup = {
-	key: ContainerAppearancePropertyKey;
-	rows: AppearanceValueRow[];
-	transition?: AppearanceFieldTransition | null;
-} | {
-	key: ButtonAppearancePropertyKey;
-	rows: AppearanceValueRow[];
-	transition?: AppearanceFieldTransition | null;
-} | {
-	key: TextAppearancePropertyKey;
-	rows: AppearanceValueRow[];
-	transition?: AppearanceFieldTransition | null;
-};
-type AppearanceVariant = {
-	id: string;
-	name: string;
-	propertyGroups: AppearancePropertyGroup[];
-};
-type AppearanceModel = {
-	defaultVariantId: string;
-	variants: AppearanceVariant[];
-};
-type UISliderOrientation = "horizontal" | "vertical";
-type UISliderWidgetProps = {
-	value: number;
-	min: number;
-	max: number;
-	step: number;
-	orientation: UISliderOrientation;
-	trackElementId?: string | null;
-	handleElementId?: string | null;
-};
-type UISliderRange = {
-	min: number;
-	max: number;
-	step: number;
-};
-type UISliderRuntimeValue = UISliderRange & {
-	value: number;
-	normalizedValue: number;
-};
-type UISwitchWidgetProps = {
-	/** The author's starting state. What the player toggles lives in WidgetRuntimeStateStore. */
-	checked: boolean;
-	/** Blocks pointer and keyboard toggling. Looks are the `disabled` appearance signal's job. */
-	interactionDisabled: boolean;
-	trackElementId?: string | null;
-	thumbElementId?: string | null;
-};
-type UISwitchRuntimeValue = {
-	checked: boolean;
-};
-type UITextInputMode = "text" | "password" | "number";
-type UITextInputWidgetProps = {
-	value: string;
-	placeholder: string;
-	/** i18n attach-layer key for `placeholder`; player-facing text is never a Studio catalog key. */
-	placeholderLocalizationKey?: string | null;
-	inputMode: UITextInputMode;
-	/** 0 = unlimited. */
-	maxLength: number;
-	readOnly: boolean;
-	disabled: boolean;
-	textAlign: "left" | "center" | "right";
-};
-type UITextInputRuntimeValue = {
-	value: string;
-	/** Length in code points, so an emoji counts once - this is what `maxLength` is measured in. */
-	length: number;
-};
-type UIDisplayableMotionFromCurrentValue = {
-	from: "current";
-	to: number;
-};
-type UIDisplayableMotionValue = number | number[] | UIDisplayableMotionFromCurrentValue;
-type UIDisplayableMotionTarget = {
-	x?: UIDisplayableMotionValue;
-	y?: UIDisplayableMotionValue;
-	scale?: UIDisplayableMotionValue;
-	rotate?: UIDisplayableMotionValue;
-	opacity?: UIDisplayableMotionValue;
-};
-type UIDisplayableMotionTransition = {
-	type: "tween";
-	durationMs: number;
-	delayMs?: number;
-	easing?: string;
-} | {
-	type: "spring";
-	delayMs?: number;
-	stiffness: number;
-	damping: number;
-	mass: number;
-};
-type UIDisplayableMotionOverride = {
-	id: string;
-	target: UIDisplayableMotionTarget;
-	transition: UIDisplayableMotionTransition;
-	/** One-shot effects such as shake/pulse should hand control back to authored layout when finished. */
-	resetOnComplete?: boolean;
-};
-type TextWritingMode = NlrTextWritingMode;
-type TextOrientation = TextGlyphOrientation;
-type EffectShadowLayerData = {
-	offsetX: number;
-	offsetY: number;
-	blur: number;
-	spread: number;
-	color: string;
-};
-type FilterPresetId = "brightness" | "contrast" | "saturate" | "grayscale";
-type EffectShadowLayer = EffectShadowLayerData;
-type EffectShadowStored = {
-	storage: "layer";
-	layer: EffectShadowLayer;
-} | {
-	storage: "css";
-	css: string;
-};
-type EffectFilterStored = {
-	storage: "preset";
-	preset: FilterPresetId;
-	amount: number;
-} | {
-	storage: "css";
-	css: string;
-};
-type ElementEffectValues = {
-	effectBlur: number;
-	effectBackgroundBlur: number;
-	effectShadow: EffectShadowStored | null;
-	/** Text widgets: CSS text-shadow (separate from box-shadow `effectShadow`). */
-	effectTextShadow: EffectShadowStored | null;
-	effectInnerShadow: EffectShadowStored | null;
-	effectBlend: string;
-	effectGlow: EffectShadowStored | null;
-	effectFilter: EffectFilterStored | null;
-};
-type TextAlign = "left" | "center" | "right";
-type TextVerticalAlign = "start" | "center" | "end";
-type TextWrapMode = "word" | "character" | "nowrap";
-type TextWidgetProps = {
-	text: string;
-	/** Game-localization opt-in: registers the implicit translation unit `ui:<elementId>.text`. */
-	localizable?: boolean;
-	/** Named localization key reference; takes precedence over the implicit unit. */
-	localizationKey?: string;
-	fontSize: number;
-	color: string;
-	fontWeight: "normal" | "bold" | "600";
-	fontStyle: "normal" | "italic";
-	textAlign: TextAlign;
-	textVerticalAlign: TextVerticalAlign;
-	lineHeight: number;
-	/** Project font asset id when using a custom typeface in the editor; null inherits canvas default */
-	fontAssetId: string | null;
-	textWrapMode: TextWrapMode;
-	/**
-	 * Shrink the rendered text until it fits the element's box.
-	 *
-	 * The authored `fontSize` becomes a ceiling rather than a fixed value: the text is never set
-	 * larger than it, and never smaller than {@link TextWidgetProps.textAutoFitMinFontSize}. A line
-	 * that still does not fit at the floor is clipped, which is what every line does today.
-	 */
-	textAutoFit: boolean;
-	/** Smallest size auto fit may set, in px. */
-	textAutoFitMinFontSize: number;
-	/** Block flow. `horizontal-tb` leaves every other vertical setting inert. */
-	writingMode: TextWritingMode;
-	textOrientation: TextOrientation;
-	/**
-	 * 縦中横: sets a short Latin or digit run upright across the column instead of on its side,
-	 * the way a Japanese novel sets a two-digit number. Only read while writing vertically.
-	 */
-	tateChuYoko: boolean;
-	/** Longest run tate-chu-yoko combines, in characters. Two is the typographic convention. */
-	tateChuYokoMaxLength: number;
-	transformOffsetX: number;
-	transformOffsetY: number;
-	transformScale: number;
-	transformRotation: number;
-	transformOpacity: number;
-	/** Static baseline effects; appearance overlays may override per variant / state. */
-	effects: ElementEffectValues;
-	/** Optional variant + conditional row visuals; when absent, flat props are the sole source. */
-	appearance?: AppearanceModel | null;
-};
-type BlueprintPointerMoveOptions = {
-	durationSeconds?: number;
-	easing?: BlueprintPointerMoveEasing;
-};
-type BlueprintTextProperties = Pick<TextWidgetProps, "text" | "fontAssetId" | "fontSize" | "fontWeight" | "color" | "textAlign" | "textVerticalAlign" | "lineHeight" | "textWrapMode" | "effects">;
-type BlueprintTextPropertiesPatch = Partial<BlueprintTextProperties>;
-type BlueprintSliderProperties = UISliderRuntimeValue;
-type BlueprintSliderPropertiesPatch = Partial<Pick<UISliderWidgetProps, "value" | "min" | "max" | "step">>;
-type BlueprintSwitchProperties = UISwitchRuntimeValue;
-type BlueprintSwitchPropertiesPatch = Partial<Pick<UISwitchWidgetProps, "checked">>;
-type BlueprintTextInputProperties = UITextInputRuntimeValue;
-type BlueprintTextInputPropertiesPatch = Partial<Pick<UITextInputWidgetProps, "value">>;
-type BlueprintListProperties = {
-	items: unknown[];
-	selectedIndex: number;
-	/**
-	 * The shape the list declares, or null when it declares none.
-	 *
-	 * Carried with the items rather than fetched separately, because every node that reads a field
-	 * needs both and reading them apart is how the two drift: a graph that sorted by a field the
-	 * list no longer declares would sort by nothing and report success.
-	 */
-	struct: UIStructDef | null;
-	/**
-	 * Where the list has got to along its axis, as it last measured itself.
-	 *
-	 * A list that has not been rendered - or has been rendered somewhere with no runtime store, like
-	 * a Surface thumbnail - reports at-rest rather than nothing, so a graph asking gets the answer
-	 * for a list that cannot scroll instead of an undefined it has no way to branch on.
-	 */
-	scroll: UIListScrollMetrics;
-};
-type BlueprintDisplayableProperties = {
-	position: {
-		x: number;
-		y: number;
-	};
-	offset: {
-		x: number;
-		y: number;
-	};
-	/**
-	 * The extent the widget covers, never negative. The authored layout may hold a negative width
-	 * or height - that is how a widget dragged past its own origin is stored - and `position`
-	 * already reports the true top-left, so reporting the raw sign here would have described a
-	 * rectangle whose right edge sits left of its left edge.
-	 */
-	size: {
-		width: number;
-		height: number;
-	};
-	bounds: BlueprintRect;
-	rotation: number;
-	opacity: number;
-	display: boolean;
-	visible: boolean;
-};
-type BlueprintDisplayablePropertiesPatch = Partial<{
-	x: number;
-	y: number;
-	offsetX: number;
-	offsetY: number;
-	width: number;
-	height: number;
-	rotation: number;
-	opacity: number;
-	display: boolean;
-	visible: boolean;
-}>;
-type BlueprintDisplayableMotionRequest = {
-	id?: string;
-	target: UIDisplayableMotionTarget;
-	transition: UIDisplayableMotionTransition;
-	resetOnComplete?: boolean;
-	commitLayoutOnComplete?: Partial<Pick<BlueprintDisplayablePropertiesPatch, "x" | "y">>;
-};
-type BlueprintWidgetCommonProperties = {
-	visible: boolean;
-	enabled: boolean;
-	variantId: string | null;
-};
-type BlueprintButtonProperties = {
-	label: string;
-	cursor: ButtonCursorValue;
-};
-type BlueprintContainerProperties = {
-	clipContent: boolean;
-};
-type BlueprintImageProperties = {
-	asset: BlueprintImageAsset | null;
-	/** Legacy patch/read alias kept so older saved graph nodes can still run. */
-	assetId: string | null;
-	fitMode: ImageFillMode;
-	cropRect: ImageFillCropPlacement;
-	flipX: boolean;
-	flipY: boolean;
-};
-type BlueprintFrameProperties = {
-	targetSurfaceId: string | null;
-	params: Record<string, unknown>;
-};
-type BlueprintGamePreferenceKey = "autoForward" | "skip"
-/**
- * Studio's own, not the engine's: skipping stops at a line the player has not read.
- *
- * It lives in the engine's preference store all the same (see `preferenceRuntime`), which is
- * what lets it reach this API, the `gamePreferenceChanged` event and the project's preference
- * defaults through exactly the same plumbing as the twelve the engine defines.
- */
- | "skipReadText"
-/**
- * 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
- * leaving the stage, the window losing focus. Never persisted (see `@shared/types/preference`).
- */
- | "skipping"
-/**
- * Studio's own: the engine keeps this in `game.config`, not in its preference store, so the
- * host copies it across on every change (see `preferenceRuntime`).
- */
- | "autoForwardDelay" | "showDialog" | "gameSpeed" | "cps"
-/** Milliseconds a newly typed character takes to fade in; `0` types it at full strength. */
- | "textRevealDuration" | "voiceVolume" | "voiceFadeDuration" | "voiceEndMode" | "bgmVolume" | "soundVolume" | "globalVolume" | "skipDelay" | "skipInterval";
-type BlueprintGamePreferenceVoiceEndMode = "fade" | "stop" | "none";
-type BlueprintGamePreferenceValue = boolean | number | BlueprintGamePreferenceVoiceEndMode;
-type BlueprintLayerShowOptions = {
-	/** Everything below goes inert and the keys belong to this layer. */
-	modal?: boolean;
-	/** Whether Go back closes it. Default true. */
-	dismissible?: boolean;
-	/** Mutual-exclusion group; a second layer of an occupied group queues behind the first. */
-	group?: string | null;
-};
-type BlueprintHostApiRuntime = {
-	navigation: {
-		openSurface: (surfaceId: string, props?: unknown) => Promise<void>;
-		getPageProps: () => Record<string, unknown>;
-		pageBack: () => Promise<void>;
-		clearPages: () => Promise<void>;
-		clearGameOverlay: () => Promise<void>;
-		quitApplication: () => Promise<void>;
-		getFullscreen: () => Promise<boolean>;
-		setFullscreen: (fullscreen: boolean) => Promise<void>;
-		/** The sizes worth offering, ascending. Empty where the shell has no window to size. */
-		getWindowScaleOptions: () => Promise<number[]>;
-		getWindowScale: () => Promise<number>;
-		setWindowScale: (scale: number) => Promise<void>;
-		getWindowSize: () => Promise<{
-			width: number;
-			height: number;
-		}>;
-		setWindowSize: (width: number, height: number) => Promise<void>;
-		/**
-		 * Open one web address in the player's browser.
-		 *
-		 * The host does not decide: it hands the request to whatever the shell supplied, and the
-		 * shell's own process checks it against the addresses the build declared. Nothing here
-		 * consults the project's network setting, because no request is made - see
-		 * `@shared/types/blueprint/externalLink`.
-		 */
-		openExternal: (request: BlueprintOpenExternalRequest) => Promise<BlueprintOpenExternalResult>;
-	};
-	/** Surfaces stacked over the page lane. See the `layers` family in `@shared/types/blueprint/hostApi`. */
-	layers: {
-		/** Put a page up as a layer and return the handle that names it. */
-		show: (surfaceId: string, props?: unknown, options?: BlueprintLayerShowOptions) => Promise<string>;
-		/** Take that layer down, settling once it has finished animating out. */
-		hide: (handle: string) => Promise<void>;
-		/** Take a whole group down - what is on screen and what is queued behind it. */
-		hideGroup: (group: string) => Promise<void>;
-		/** Wait for that layer to close and read what it closed with. Null for a handle already gone. */
-		wait: (handle: string) => Promise<unknown>;
-		/** Close the layer the calling graph runs in. A no-op with a warning anywhere else. */
-		closeSelf: (result?: unknown) => Promise<void>;
-		isMounted: (handle: string) => boolean;
-	};
-	widget: {
-		setVisible: (elementId: string, visible: boolean) => Promise<void>;
-		setEnabled: (elementId: string, enabled: boolean) => Promise<void>;
-		/** `null` clears runtime override and restores authored default variant resolution. */
-		setVariant: (elementId: string, variantId: string | null, options?: {
-			waitForTransition?: boolean;
-		}) => Promise<void>;
-		getCommonProperties: (elementId: string) => BlueprintWidgetCommonProperties;
-		getTextProperties: (elementId: string) => BlueprintTextProperties;
-		setTextProperties: (elementId: string, patch: BlueprintTextPropertiesPatch) => Promise<void>;
-		getButtonProperties: (elementId: string) => BlueprintButtonProperties;
-		setButtonProperties: (elementId: string, patch: Partial<BlueprintButtonProperties>) => Promise<void>;
-		getContainerProperties: (elementId: string) => BlueprintContainerProperties;
-		setContainerProperties: (elementId: string, patch: Partial<BlueprintContainerProperties>) => Promise<void>;
-		getImageProperties: (elementId: string) => BlueprintImageProperties;
-		setImageProperties: (elementId: string, patch: Partial<BlueprintImageProperties>) => Promise<void>;
-		getSliderProperties: (elementId: string) => BlueprintSliderProperties;
-		setSliderProperties: (elementId: string, patch: BlueprintSliderPropertiesPatch) => Promise<void>;
-		getSwitchProperties: (elementId: string) => BlueprintSwitchProperties;
-		setSwitchProperties: (elementId: string, patch: BlueprintSwitchPropertiesPatch) => Promise<void>;
-		getTextInputProperties: (elementId: string) => BlueprintTextInputProperties;
-		setTextInputProperties: (elementId: string, patch: BlueprintTextInputPropertiesPatch) => Promise<void>;
-		getListProperties: (elementId: string) => BlueprintListProperties;
-		setListItems: (elementId: string, items: readonly unknown[]) => Promise<void>;
-		setListSelectedIndex: (elementId: string, index: number) => Promise<void>;
-		scrollListToIndex: (elementId: string, index: number) => Promise<void>;
-		scrollListToTop: (elementId: string) => Promise<void>;
-		scrollListToBottom: (elementId: string) => Promise<void>;
-		getDisplayableProperties: (elementId: string) => BlueprintDisplayableProperties;
-		/**
-		 * What the widget currently covers on screen, in the coordinates of the surface it is on,
-		 * or `null` when nothing is painted for it.
-		 *
-		 * Separate from {@link getDisplayableProperties} because the two answer different
-		 * questions. That one reads the document - where the author put the widget - and is the
-		 * right answer for layout arithmetic. This one measures the DOM, so it accounts for a
-		 * motion in flight, an appearance variant that shifted the widget, a text box sized to its
-		 * own words, and which row of a list an instance ended up on.
-		 */
-		getMeasuredRect: (elementId: string) => BlueprintRect | null;
-		setDisplayableProperties: (elementId: string, patch: BlueprintDisplayablePropertiesPatch) => Promise<void>;
-		animateDisplayable: (elementId: string, request: BlueprintDisplayableMotionRequest) => Promise<UIDisplayableMotionOverride>;
-		stopDisplayableAnimation: (animationId: string) => Promise<void>;
-		getFrameProperties: (elementId: string) => BlueprintFrameProperties;
-		setFrameProperties: (elementId: string, patch: Partial<BlueprintFrameProperties>) => Promise<void>;
-	};
-	state: {
-		get: (scope: string, key: string) => unknown;
-		set: (scope: string, key: string, value: unknown) => void;
-	};
-	persistence: {
-		get: (key: string) => Promise<unknown>;
-		set: (key: string, value: unknown) => Promise<void>;
-	};
-	localization: {
-		/** Localization setup of the running game, or null when the project has none. */
-		getConfig: () => GameLocalizationConfigSnapshot | null;
-		/** Effective current locale (stored player choice, else the source locale). */
-		getLocale: () => Promise<string>;
-		/** Persist the player's language choice; callers validate against getConfig(). */
-		setLocale: (code: string) => Promise<void>;
-	};
-	/**
-	 * Voice-over: which dub the player hears, and replaying a take on demand.
-	 *
-	 * Separate from `localization` because dub language and subtitle language are separate player
-	 * choices - a game may be read in English and heard in Japanese.
-	 */
-	voice: {
-		/** The dub languages this build ships, in project order. Empty when the game has no voice. */
-		listLocales: () => VoiceLocaleEntry[];
-		/** Effective dub language: the stored player choice when the build ships it, else the first. */
-		getLocale: () => Promise<string>;
-		/** Persist the player's dub choice. Takes effect from the next spoken line - no restart. */
-		setLocale: (code: string) => Promise<void>;
-		/**
-		 * Play one line's take in the current dub language, on that speaker's bus.
-		 *
-		 * The id is a voice unit id - the same id a backlog entry reports as `voiceId` - which is why
-		 * a replay button is built from this rather than from the entry's resolved URL. Resolves to
-		 * false when the line has no take in the current language.
-		 */
-		play: (unitId: string) => Promise<boolean>;
-		/**
-		 * Play one choice option's take, at most one instance of that option at a time.
-		 *
-		 * Same clip and same bus as {@link play}; what differs is the bookkeeping a menu needs. A
-		 * hover fires as often as the pointer crosses a row, so a line already speaking is left
-		 * alone rather than restarted, and it answers false. `interruptOthers` stops the takes of
-		 * the *other* options - the author's call, because a menu that reads each option over the
-		 * last is as deliberate a design as one that speaks a single line at a time.
-		 */
-		playChoice: (unitId: string, options?: {
-			interruptOthers?: boolean;
-		}) => Promise<boolean>;
-	};
-	frame: {
-		getParam: (key: string) => unknown;
-		emit: (eventName: string, data: unknown) => Promise<void>;
-	};
-	game: {
-		/**
-		 * Begin a story. `options.inheritSavedGame` carries a save's saved-scope values and visited
-		 * scenes into the new game - see the `Inherit From` pin - and carries nothing else.
-		 */
-		startStory: (request: DevModeStartStoryRequest, options?: {
-			inheritSavedGame?: unknown;
-		}) => Promise<void>;
-		/** The running playthrough as a serialized game, or null when none is running. */
-		captureRun: () => unknown | null;
-		/** The serialized game stored in a slot, or null when there is no such slot. */
-		readSaveGame: (id: string) => Promise<unknown | null>;
-		isInGame: () => boolean;
-		isGameOverlay: () => boolean;
-		quit: (surfaceId: string) => Promise<void>;
-		writeSave: (id: string, metadata?: unknown, screenshot?: boolean) => Promise<void>;
-		/** False when the save was not applied - the player and the author have both been told. */
-		loadSave: (id: string) => Promise<boolean>;
-		deleteSave: (id: string) => Promise<void>;
-		listSaveIds: () => Promise<string[]>;
-		getSaveMetadata: (id: string) => Promise<unknown>;
-		/** When a slot was written, or null when there is no such slot. */
-		getSaveTimes: (id: string) => Promise<SaveRecordTimes | null>;
-		/** Where a slot stopped, or null when there is no such slot. */
-		getSaveLine: (id: string) => Promise<SaveRecordLine | 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. */
-		getPlaytime: () => number;
-		/** Seconds ever spent in this project, across every playthrough. */
-		getTotalPlaytime: () => number;
-		getSavePreview: (id: string) => Promise<BlueprintImageAsset | null>;
-		/** Write an autosave into the reserved ring now, regardless of the timer. */
-		writeAutoSave: () => Promise<void>;
-		/** The reserved autosave ring, newest first. Never overlaps `listSaveIds`. */
-		listAutoSaves: () => Promise<AutoSaveEntry[]>;
-		/**
-		 * The backlog behind the play head, oldest first.
-		 *
-		 * From engine 0.26.0 this stops at the head: after the player steps back, the lines they
-		 * stepped past are no longer in here, they are in {@link getFuture}. Before anyone steps
-		 * back - which is every ordinary playthrough - the two are the whole backlog and nothing.
-		 */
-		getHistory: () => Promise<BlueprintGameHistoryEntry[]>;
-		/** The lines ahead of the play head, nearest first. Empty until the player steps back. */
-		getFuture: () => Promise<BlueprintGameHistoryEntry[]>;
-		/** Jump back to a history entry by id; omit the id to undo the last entry. */
-		restoreHistory: (id?: string) => Promise<void>;
-		/** Step the play head forward one line, back over a line the player has already read. */
-		redoHistory: () => Promise<void>;
-		canUndoHistory: () => boolean;
-		canRedoHistory: () => boolean;
-		getNametag: () => string | null;
-		/**
-		 * The speaking character's dialog avatar, or null. Already keyed on the differential the
-		 * character is currently wearing - the engine resolves it off the live portrait element.
-		 */
-		getSpeakerAvatar: () => BlueprintImageAsset | null;
-		/**
-		 * The speaking character's authored accent colour, already in pin shape. Opaque white when
-		 * nobody is speaking, the narrator is, or the character has no colour - the pin it feeds is
-		 * a non-nullable RGBAColor, so "no colour" and "the default colour" are the same answer.
-		 */
-		getSpeakerColor: () => BlueprintRGBAColor;
-		/**
-		 * Has the line on screen finished revealing, with the dialog now waiting for the player.
-		 *
-		 * False while it is still typing, and false again the moment the next line mounts, so an
-		 * indicator bound to it needs no timer of its own. False with no dialog on screen at all.
-		 */
-		isDialogWaiting: () => boolean;
-		/**
-		 * The current line's text - the whole line, not the part revealed so far. Empty string when
-		 * no line is on screen.
-		 */
-		getDialogText: () => string;
-		/**
-		 * Does the current line have no speaker. Distinct from a null nametag, which a character
-		 * with a blank name also reports. False when no line is on screen.
-		 */
-		isNarrator: () => boolean;
-		/**
-		 * Any character by id, from the table mirrored into global state - the addressable read the
-		 * speaker-scoped getters above cannot do. Null when the id is empty, or names a character
-		 * that is not (or is no longer) in the project.
-		 */
-		getCharacter: (characterId: string) => BlueprintCharacterInfo | null;
-		getNotifications: () => BlueprintGameNotification[];
-		getChoiceCount: () => number;
-		isNvlMode: () => boolean;
-		/** True while a dialog line is on screen and its message is marked read. */
-		isCurrentTextRead: () => boolean;
-		isTextRead: (textId: string) => boolean;
-		/** Wipe the persisted text-read record (all stories). */
-		clearTextRead: () => Promise<void>;
-		/**
-		 * Has the player ever ENTERED this scene, by Studio scene id.
-		 *
-		 * Not the same question as `isTextRead`: that record is written when a line is displayed,
-		 * this one when a scene actually starts. Saved-domain, so loading an older save rewinds it.
-		 */
-		isSceneVisited: (sceneId: string) => boolean;
-		/**
-		 * One saved variable of the running playthrough, by the id a `savedVariableRef` names.
-		 *
-		 * `found` is false with no game running, and with an id this build's story does not
-		 * declare. The two are worth telling apart from a value: `null` and the declared default
-		 * are both real values a variable can hold, so neither can double as "there was nothing to
-		 * read". See the capability's own note for why this is read-only.
-		 */
-		getSavedVariable: (variableId: string) => {
-			value: unknown;
-			found: boolean;
-		};
-		/**
-		 * Write one saved variable of the running playthrough.
-		 *
-		 * Throws when there is no game, when the id names nothing this build declares, and when the
-		 * value cannot go into a save file. All three are authoring errors a button would otherwise
-		 * swallow; see the capability's own note for what a write from a screen does and does not do.
-		 */
-		setSavedVariable: (variableId: string, value: unknown) => void;
-		/**
-		 * Has the player ever PICKED this choice option, by the option row's Studio block id. The
-		 * one thing the text-read record structurally cannot answer - a menu that merely appeared
-		 * marks every option of it read.
-		 */
-		isOptionPicked: (optionId: string) => boolean;
-		/**
-		 * Wipe the visited record of the running game.
-		 *
-		 * Synchronous, unlike `clearTextRead`: the record lives in the live `Storable`, not in host
-		 * persistence, so there is nothing to await. It is also scoped to the running session - with
-		 * no game up there is no record, and the call is a no-op instead of an error.
-		 */
-		clearVisited: () => void;
-		/**
-		 * Has the player ever reached this ending, by the `ending` row's Studio block id.
-		 *
-		 * Project persistence rather than the save file, unlike the visited record above: an endings
-		 * screen reports what this player has ever seen, so loading an older save must not re-lock
-		 * anything. Needs no running story - a title screen asks it before the first game exists.
-		 */
-		isEndingReached: (endingId: string) => boolean;
-		/**
-		 * Is this DLC installed beside the running build, by the id the author gave it.
-		 *
-		 * The whole of what a game may ask about its DLC, and deliberately not "does the player own
-		 * it". Ownership is a storefront's fact and a plugin's to answer; what decides whether the
-		 * content is here is whether its file is, which is the question this asks. A build with no
-		 * DLC beside it answers false to everything, which is what a title screen wants before the
-		 * player has bought anything.
-		 */
-		isDlcInstalled: (dlcId: string) => boolean;
-		/**
-		 * Every ending one story declares, in document order, each row already carrying whether it
-		 * was reached. Empty for an unknown or unnamed story rather than an error.
-		 *
-		 * The list comes from the story document this build ships, so it can never offer an ending
-		 * the compiler does not emit, and it is available with no game running for the same reason
-		 * the reader above is.
-		 */
-		listEndings: (storyId: string) => BlueprintStoryEnding[];
-		/**
-		 * Forget one ending. Awaited, unlike `clearVisited`: this writes host persistence rather
-		 * than a live `Storable`, and a caller that navigates away on the next beat has to know the
-		 * write landed.
-		 */
-		clearEndingState: (endingId: string) => Promise<void>;
-		/** Wipe the whole endings record. The `Clear Text Read` of this family. */
-		clearEndings: () => Promise<void>;
-		choose: (index: number) => Promise<void>;
-		next: () => Promise<void>;
-		skip: () => Promise<void>;
-		showDialog: () => Promise<void>;
-		hideDialog: () => Promise<void>;
-		toggleDialogDisplay: () => Promise<void>;
-		setSentenceSpeed: (cps: number) => Promise<void>;
-		getPreference: (key: BlueprintGamePreferenceKey) => BlueprintGamePreferenceValue;
-		setPreference: (key: BlueprintGamePreferenceKey, value: BlueprintGamePreferenceValue) => Promise<void>;
-	};
-	sound: {
-		play: (input: BlueprintSoundPlayInput) => Promise<BlueprintSoundHandle | null>;
-		stop: (handle: BlueprintSoundHandle | null, fadeMs?: number) => Promise<void>;
-		pause: (handle: BlueprintSoundHandle) => Promise<void>;
-		resume: (handle: BlueprintSoundHandle) => Promise<void>;
-		/** Ramp rather than jump when `fadeMs` is set - this is also the fade-out/duck node. */
-		setVolume: (handle: BlueprintSoundHandle, volume: number, fadeMs?: number) => Promise<void>;
-		/** Milliseconds from the start of the file, not from the clip's in point. */
-		seek: (handle: BlueprintSoundHandle, timeMs: number) => Promise<void>;
-		isPlaying: (handle: BlueprintSoundHandle) => boolean;
-		/**
-		 * The volume a **host-owned** media element (the `nl.video` widget's `<video>`) must be set
-		 * to so it obeys the same mixer everything else does.
-		 *
-		 * A DOM element the host created sits on none of the engine's gain nodes, so the whole
-		 * product has to be computed and written to `element.volume`: the authored volume, times
-		 * every bus in the track's chain, times the player's slider for whichever seeded bus that
-		 * chain runs through, times master. Without this a muted game keeps playing video at full
-		 * volume. Pair it with {@link subscribeMixerChanges} - a value read once goes stale the
-		 * moment the player drags a slider, bus faders included.
-		 */
-		resolveElementVolume: (input: {
-			audioTrackId?: string | null;
-			volume?: number | null;
-		}) => number;
-		/** Fires when any preference feeding `resolveElementVolume` changes. Returns a disposer. */
-		subscribeMixerChanges: (listener: () => void) => () => void;
-		/**
-		 * An audio **track**'s own volume, 0..1 - one strip of the player's mixer.
-		 *
-		 * The player-facing counterpart of {@link setVolume}, which addresses one playing clip by
-		 * handle. A track is a bus every clip beneath it is routed through, so setting one applies
-		 * live to everything already playing and survives the clip that provoked it. This is what
-		 * makes "turn Alice down" expressible at all: the four fixed volume preferences can only
-		 * reach the three buses the engine seeds.
-		 *
-		 * An unknown or deleted track id reads as unity and writes nowhere, so a settings page
-		 * built against a track the author later removed degrades to an inert slider.
-		 */
-		getTrackVolume: (trackId: string) => number;
-		setTrackVolume: (trackId: string, volume: number) => Promise<void>;
-	};
-	/**
-	 * HTTP, for the Fetch node.
-	 *
-	 * The host does not issue the request itself: it hands it to whatever the shell supplied, which
-	 * on desktop and in Dev Mode is the main process (`onNetworkFetch`). Nothing here calls
-	 * `fetch()` - see `@shared/utils/blueprintNetworkFetch` for why the renderer must not.
-	 */
-	network: {
-		fetch: (request: BlueprintNetworkFetchRequest) => Promise<BlueprintNetworkFetchResult>;
-	};
-	/**
-	 * The read side of input routing, for `Is Action Held` and `Get Input Device`.
-	 *
-	 * The only part of the input model a graph can ask about rather than be told about. Everything
-	 * else in it is a dispatch - an action fires, a head runs - and none of that can answer "while
-	 * the gesture is down" or "with which hand", because a fired event leaves nothing behind that
-	 * says whether the hand is still there or what it was.
-	 *
-	 * Structural rather than a declared family in `@shared/types/blueprint/hostApi`, matching how
-	 * both nodes reach for it (see `BlueprintInputActionHostApi`): the contract there names
-	 * capabilities a host may or may not implement, and these are answered by the window every host
-	 * already has.
-	 */
-	input: {
-		isActionHeld: (actionId: string) => boolean;
-		/**
-		 * Which device the player is using at this moment.
-		 *
-		 * One of the four values the `On Action` head's `source` pin carries, typed as a plain
-		 * string so a graph compares both against the same literals.
-		 */
-		getDevice: () => string;
-	};
-	/**
-	 * Moving the player's real cursor, for the Move Mouse family.
-	 *
-	 * The author names a point in a surface's own coordinates, which is the only frame they have
-	 * reason to think in. Turning that into a point in the window happens here, off the same
-	 * surface shell every mouse event's payload is divided by, so "the centre of this button"
-	 * measured by `widget.getMeasuredRect` and the point the cursor lands on are the same place.
-	 *
-	 * `surfaceId` is the surface the point belongs to; `null` means the active one. A point on a
-	 * surface that is not currently laid out has nowhere to be, and reports `failed` rather than
-	 * being guessed at against a different surface's scale.
-	 */
-	pointer: {
-		moveTo: (surfaceId: string | null, point: BlueprintVector2D, options?: BlueprintPointerMoveOptions) => Promise<BlueprintPointerMoveResult>;
-		/**
-		 * The same act aimed at a widget's centre, measured rather than computed from the document.
-		 *
-		 * A method of its own rather than something a caller assembles out of `getMeasuredRect` and
-		 * `moveTo`, because the two halves have to agree about which surface the widget turned out
-		 * to be painted on. A component instance renders its contents wherever it was placed, so
-		 * the answer is not always the surface the element was authored under, and a caller
-		 * stitching the halves together would have to know that to get it right.
-		 */
-		moveToElementCenter: (elementId: string, options?: BlueprintPointerMoveOptions) => Promise<BlueprintPointerMoveResult>;
-	};
-	/**
-	 * Carrying a playthrough between two editions of one title, for the Export/Import Progress
-	 * nodes.
-	 *
-	 * The host does not decide where the document is: it hands the act to whatever the shell
-	 * supplied, and the shell's own process resolves the file from the build's progress key. What
-	 * this side states is what the playthrough holds, never where it goes.
-	 *
-	 * `import` answers with a scene id rather than going anywhere with it. The node deliberately
-	 * does not jump - `Start Game` is what starts a story, and an author's graph usually has
-	 * something to do first.
-	 */
-	progress: {
-		export: () => Promise<{
-			outcome: "written" | "failed";
-			error: string;
-		}>;
-		import: () => Promise<GameProgressImportOutcome>;
-	};
-	/**
-	 * What the shell can promise about the data it writes, for the `Check Storage Durability` node.
-	 *
-	 * A fact about where the game is running, not about the playthrough: a packaged desktop game
-	 * keeps files nothing reclaims, a web export holds whatever grant the browser gave it. Stated,
-	 * never acted on - what a player is told about it belongs to the title.
-	 */
-	storage: {
-		durability: () => Promise<GameStorageDurability>;
-	};
-	devtools: {
-		log: (level: string, message: string) => void;
-	};
-};
-type BlueprintSoundPlayInput = {
-	assetId: string;
-	/**
-	 * Project audio track (`ProjectAudioTrack.id`), which **is** the engine bus this clip is routed
-	 * into, and whose own gain is applied live by the gain graph rather than folded in here. It also
-	 * supplies the loop default below. Absent resolves to the seeded SFX bus, which is what an
-	 * unqualified "play this clip" has always meant.
-	 */
-	audioTrackId?: string | null;
-	/** Author override; absent means the track's own default. */
-	loop?: boolean | null;
-	/** Author override, 0..1 as authored; absent means unity. Never pre-multiplied by a bus gain. */
-	volume?: number | null;
-	/** Fade-in in milliseconds; absent means a hard start (a fade belongs to the moment). */
-	fadeInMs?: number | null;
-};
-type GameLocalizationConfigSnapshot = Pick<GameLocalizationBundle, "sourceLocale" | "locales"> & Partial<Pick<GameLocalizationBundle, "tables" | "keys" | "scenes">>;
-type BlueprintGameNotification = {
-	id: string;
-	message: string;
-};
-type BlueprintStoryEnding = {
-	endingId: string;
-	name: string;
-	sceneId: string;
-	/** The scene the ending row sits in, so a row can be grouped or captioned without a lookup. */
-	sceneName: string;
-	isReached: boolean;
-};
-type BlueprintGameHistoryEntry = {
-	/** History token; pass to Restore From History to jump the game back to this point. */
-	id: string;
-	/** "say" for spoken lines, "menu" for a resolved choice. */
-	type: "say" | "menu";
-	/** Sentence text (say) or the menu prompt (menu); empty string when the source had none. */
-	text: string;
-	/** Speaker nametag for a say entry; null for menu entries or narration. */
-	character: string | null;
-	/** Resolved voice clip URL for a say entry; null when absent. Not addressable - see `voiceId`. */
-	voice: string | null;
-	/**
-	 * The voice unit id this line's take is filed under; null when the line was not voiced through
-	 * the voice module. This is the replayable handle: feed it to the Play Voice node. `voice` is a
-	 * URL the player already heard and nothing in the runtime accepts a URL.
-	 */
-	voiceId: string | null;
-	/** Chosen option text for a menu entry; null for say entries or an unresolved menu. */
-	selected: string | null;
-	/** True while the entry is the line currently being shown (not yet committed). */
-	isPending: boolean;
-};
 type BehaviorNodeExecuteResult = {
 	nextPort?: string;
 	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;
@@ -16885,176 +15894,6 @@ type SelectionState = {
 	type: "storyBlock";
 	data: StoryBlockSelection;
 };
-type ViewportTransform = {
-	scale: number;
-	offsetX: number;
-	offsetY: number;
-};
-type CanvasFitMode = "contain" | "cover" | "width" | "actual";
-type SurfaceViewportFit = {
-	mode: CanvasFitMode;
-	/**
-	 * True when the mode came from the zoom menu. It survives a resize the same way, and only this
-	 * one escapes {@link SURFACE_FIT_MAX_SCALE}.
-	 */
-	chosen: boolean;
-};
-type UITool = {
-	kind: "select";
-} | {
-	kind: "pan";
-} | {
-	kind: "insert";
-	nodeType: string;
-	componentId?: string;
-};
-type SnapGuideKind = "surface-edge" | "surface-center" | "element-edge" | "element-center";
-type ActiveSnapGuideSegment = {
-	value: number;
-	kind: SnapGuideKind;
-};
-type ActiveSnapGuides = {
-	surfaceId: string;
-	vertical: ActiveSnapGuideSegment[];
-	horizontal: ActiveSnapGuideSegment[];
-};
-type SmartSnapDetailSettings = {
-	/** Snap selection edges/centers to other elements' center lines. */
-	snapElementLayout: boolean;
-	/** Snap element edges to other elements' edges. */
-	snapElementBorder: boolean;
-	/** Snap to canvas (surface) edges and center lines. */
-	snapCanvasLayout: boolean;
-};
-declare class UIEditorStateService extends Service<UIEditorStateService> implements IUIEditorStateService {
-	private uiStore;
-	private documentService;
-	private settingsService;
-	private readonly events;
-	private selection;
-	private tool;
-	private viewport;
-	/** Which interface {@link viewport} currently describes - it is one transform shared by every tab. */
-	private viewportSurfaceId;
-	/**
-	 * Set while {@link viewport} is a computed zoom - a fit mode rather than somewhere the author
-	 * zoomed or panned to by hand. `null` means the transform is theirs and nothing may revise it.
-	 */
-	private viewportFit;
-	/** Hand-set transforms, so switching back to an interface returns to the view it was left at. */
-	private readonly viewportBySurfaceId;
-	/** Fit modes, so switching back to an interface resumes the mode it was left following. */
-	private readonly viewportFitBySurfaceId;
-	private interactionOverride;
-	private selectionUnsubscribe?;
-	private enteredState;
-	/** Only stores `true` keys; missing id => collapsed. */
-	private readonly appearanceBorderSidesExpandedByElementId;
-	private appearanceInspectorUiCachePersistTimer;
-	/** Presence means the outline branch is collapsed. */
-	private readonly outlineCollapsedBranchIds;
-	private outlinePanelCollapsed;
-	private outlineCollapsePersistTimer;
-	private smartSnapEnabled;
-	private smartSnapDetail;
-	private snapGuides;
-	/** Pure view state: screen-ratio preview frame preset id, `null` = off. Never touches the UIDocument. */
-	private previewAspectId;
-	/** Pure view state: safe-area preview frame device preset id, `null` = off. Never touches the UIDocument. */
-	private previewSafeAreaId;
-	protected init(ctx: WorkspaceContext, depend: (services: Service[]) => Promise<void>): Promise<void>;
-	dispose(_ctx: WorkspaceContext): void;
-	getTool(): UITool;
-	setTool(tool: UITool): void;
-	getViewportTransform(): ViewportTransform;
-	/**
-	 * A hand gesture: a wheel zoom, a pan, or a zoom the author typed. It ends whatever fit mode
-	 * was running, because from here on the author has said where they want to be looking and a
-	 * pane resize must not overrule that.
-	 */
-	updateViewport(transform: Partial<ViewportTransform>): ViewportTransform;
-	/** Which interface the current transform describes; `null` before any editor tab claimed it. */
-	getViewportSurfaceId(): string | null;
-	/**
-	 * The fit mode the viewport is currently following, or `null` once the author has zoomed or
-	 * panned by hand. Only while it is set may the editor recompute the transform on its own, when
-	 * the pane resizes or the design size changes.
-	 */
-	getViewportFit(): SurfaceViewportFit | null;
-	/**
-	 * Installs a computed zoom as the viewport for `surfaceId`.
-	 *
-	 * Separate from {@link updateViewport} because the two carry opposite intent: this one is a
-	 * mode being applied, and it stays live across resizes; that one is a place the author chose,
-	 * and nothing may move it.
-	 */
-	applyFittedViewport(surfaceId: string, transform: ViewportTransform, fit: SurfaceViewportFit): ViewportTransform;
-	/**
-	 * Hands the shared viewport to `surfaceId` when opening or re-showing its tab.
-	 *
-	 * One transform serves every surface editor tab, so switching tabs would otherwise show the
-	 * next interface through the last one's zoom.
-	 *
-	 * Returns `null` when this interface was left at a hand-set transform - it has been restored
-	 * and the caller has nothing to do. Otherwise returns the mode the caller must recompute for
-	 * the space it has now, which for an interface being opened for the first time is the plain
-	 * fit nobody asked for.
-	 */
-	adoptSurfaceViewport(surfaceId: string): SurfaceViewportFit | null;
-	getSelection(): SelectionState;
-	setSelection(selection: SelectionState): void;
-	setUIElementSelection(selection: UIElementSelection): void;
-	getInteractionOverride(): InteractionOverride | null;
-	setInteractionOverride(next: InteractionOverride | null): void;
-	getDocument(): UIDocument;
-	getSurface(surfaceId: string): UISurface | undefined;
-	getEnteredState(): UIEditorEnteredState | null;
-	setEnteredState(next: UIEditorEnteredState | null): void;
-	getAppearanceBorderSidesExpanded(elementId: string): boolean;
-	setAppearanceBorderSidesExpanded(elementId: string, expanded: boolean): void;
-	isOutlineBranchCollapsed(elementId: string): boolean;
-	setOutlineBranchCollapsed(elementId: string, collapsed: boolean): void;
-	getOutlinePanelCollapsed(): boolean;
-	setOutlinePanelCollapsed(collapsed: boolean): void;
-	getSmartSnapEnabled(): boolean;
-	setSmartSnapEnabled(enabled: boolean): void;
-	getSmartSnapDetailSettings(): SmartSnapDetailSettings;
-	patchSmartSnapDetailSettings(patch: Partial<SmartSnapDetailSettings>): void;
-	getPreviewAspectId(): string | null;
-	/**
-	 * Pure view state — persisted in global settings only. Deliberately does NOT go through
-	 * `UIDocumentService`, so toggling a preview frame never dirties the project, never emits
-	 * `documentChanged` and never enters the undo stack.
-	 */
-	setPreviewAspectId(aspectId: string | null): void;
-	getPreviewSafeAreaId(): string | null;
-	/** Pure view state — see `setPreviewAspectId`. */
-	setPreviewSafeAreaId(safeAreaId: string | null): void;
-	getSnapGuides(): ActiveSnapGuides | null;
-	setSnapGuides(guides: ActiveSnapGuides | null): void;
-	on<K extends keyof UIEditorStateEvents>(event: K, handler: (data: UIEditorStateEvents[K]) => void): () => void;
-	private ensureUIStore;
-	private normalizeViewport;
-	private persistViewport;
-	private scheduleAppearanceInspectorUiCachePersistence;
-	private persistAppearanceInspectorUiCachesNow;
-	private flushAppearanceInspectorUiCachePersistence;
-	private scheduleOutlineCollapsePersistence;
-	private persistOutlineCollapsedBranchesNow;
-	private flushOutlineCollapsePersistence;
-	private areSnapGuidesEqual;
-	/**
-	 * Drops the entered state when the author moves to another interface.
-	 *
-	 * Selection is left alone on purpose. A canvas click on a widget's part promotes the selection to
-	 * the parent it drills from, so exiting on "the selection left the subtree" exits on the very
-	 * click an author makes to grab what they are editing - the state flickered away under them, and
-	 * whatever they did next landed somewhere they were not looking.
-	 */
-	private ensureEnteredStateValid;
-	private ensureInteractionOverrideValid;
-	private areOverridesEqual;
-}
 type LiveUIComponentShell = Omit<UIComponentDefinition, "elements">;
 type LiveUIParts = {
 	/** Records of the shared element map. */
@@ -18065,53 +16904,6 @@ interface PropertyEditorSchema<TData = any> {
 	/** Whether to show saving indicator */
 	showSavingIndicator?: boolean;
 }
-type WidgetRendererProps = {
-	element: UIElement;
-	surface: UISurface;
-	document: UIDocument;
-	hostAdapter: UIHostAdapter;
-	children?: React$1.ReactNode;
-	/** Stable suffix for repeated structural renderers such as list item previews. */
-	instanceKey?: string;
-	/** Current list item scope when this element renders inside a list-like item template. */
-	listItemScope?: UIListItemScope | null;
-	/**
-	 * Structural widgets may render children lazily with an instance scope.
-	 * `nl.list` uses this to repeat one authored item template without cloning UIDocument elements.
-	 */
-	renderChildren?: (options?: {
-		childrenIds?: string[];
-		listItemScope?: UIListItemScope | null;
-		instanceKey?: string;
-		elementOverrides?: Record<string, UIElement>;
-	}) => React$1.ReactNode[];
-	/**
-	 * Render another Page surface inside the current element without using an iframe.
-	 * Runtime hosts may isolate state/lifecycle by frame instance.
-	 */
-	renderSurface?: (options: {
-		targetSurfaceId: string | null;
-		frameElement: UIElement;
-		params?: Record<string, unknown>;
-		instanceKey?: string;
-	}) => React$1.ReactNode;
-	/** Runtime state readers exposed to structural widgets that resolve their own data source. */
-	runtimeData?: {
-		surfaceState?: {
-			get(key: string): unknown;
-		};
-		globalState?: {
-			get(key: string): unknown;
-		};
-		/** Props the current page was opened with; fixed for the life of the page instance. */
-		pageProps?: Readonly<Record<string, unknown>>;
-	};
-	/**
-	 * When true, canvas appearance resolves the variant from the inspector cache (editing-area preview).
-	 * Dev Mode and other hosts omit this so runtime/blueprint variant overrides stay authoritative.
-	 */
-	useAppearanceInspectorPreview?: boolean;
-};
 type UIInspectorData = {
 	element: UIElement;
 	elements: UIElement[];
@@ -18120,10 +16912,6 @@ type UIInspectorData = {
 	/** Set when inspecting a canvas widget; required for Blueprint M2 binding UI. */
 	surfaceId?: string;
 };
-type InspectorContext = {
-	element: UIElement;
-	documentService: UIDocumentService;
-};
 type DockerBarItem = DockerBarButton | DockerBarSelect | DockerBarNumberInput | DockerBarSeparator;
 type DockerBarButton = {
 	kind: "button";
@@ -18168,17 +16956,6 @@ type DockerBarSeparator = {
 	kind: "separator";
 	id: string;
 };
-type DockerBarContext = {
-	element: UIElement;
-	documentService: UIDocumentService;
-	stateService?: UIEditorStateService;
-	surfaceId?: string;
-};
-type WidgetContextMenuContext = {
-	element: UIElement;
-	documentService: UIDocumentService;
-	surfaceId: string;
-};
 type FloatingToolbarButton = {
 	kind: "button";
 	id: string;
@@ -18189,18 +16966,6 @@ type FloatingToolbarButton = {
 	onClick: () => void;
 };
 type FloatingToolbarItem = FloatingToolbarButton;
-type FloatingToolbarContext = {
-	element: UIElement;
-	documentService: UIDocumentService;
-	surfaceId: string;
-	openSurfaceEditor?: (surfaceId: string) => void;
-};
-type LayoutSizeFieldContext = {
-	element: UIElement;
-	documentService: UIDocumentService;
-	surfaceId?: string;
-	primaryId: string;
-};
 type DefaultChildElementContext = {
 	element: UIElement;
 	generateId: () => string;
@@ -18209,203 +16974,6 @@ type DefaultChildElementResult = {
 	elementPatch?: Partial<UIElement>;
 	children: UIElement[];
 };
-interface UIWidgetModule {
-	/** Unique type identifier (e.g. "nl.container") */
-	readonly type: string;
-	/**
-	 * Widget type this module specialises, set by `extendWidgetModule`.
-	 *
-	 * Mirrors the entry in `WIDGET_TYPE_PARENTS`, which is the shared table the capability lookups
-	 * (effect kinds, logic API, appearance backfill) read - `shared` cannot see a renderer module.
-	 */
-	readonly extends?: string;
-	/** Shared logic capability schema for editor, runtime, and blueprint tooling. */
-	readonly logicApi?: WidgetLogicApi;
-	/** Human-readable display name */
-	readonly displayName: string;
-	/** Icon shown in the docker bar's element palette */
-	readonly icon: LucideIcon;
-	/**
-	 * Creates the default partial element when the user inserts this widget.
-	 * The returned object is merged with system defaults (id, parentId, etc.).
-	 */
-	createDefaultElement(): Partial<UIElement>;
-	/**
-	 * Creates structural child elements that must be present immediately after inserting the widget.
-	 * The service applies the returned parent patch and child list in the same UIDocument mutation.
-	 */
-	createDefaultChildElements?(context: DefaultChildElementContext): DefaultChildElementResult;
-	/**
-	 * The states this widget can be shown in, when they belong to the widget rather than to an
-	 * appearance model.
-	 *
-	 * A switch is on or off whatever its parts look like, and it carries no appearance of its own, so
-	 * there are no variants for the state bar to list. Declaring them here puts the bar on the widget
-	 * itself; entering one broadcasts that variant id to the subtree, which is where the parts that
-	 * do carry variants pick it up. `id: null` is the state the widget rests in.
-	 */
-	listEditorStates?(element: UIElement): {
-		id: string | null;
-		name: string;
-	}[];
-	/**
-	 * Renders the element on the editor canvas.
-	 */
-	render(props: WidgetRendererProps): React$1.ReactElement | null;
-	/**
-	 * Returns property inspector fields for the properties panel.
-	 * These fields are appended after the common layout fields.
-	 * Return `undefined` to show only layout fields.
-	 */
-	createInspector?(context: InspectorContext): PropertyEditorSchema<UIInspectorData> | undefined;
-	/**
-	 * Returns docker bar items shown when this element is selected.
-	 * Return `undefined` or empty array for no element-specific docker items.
-	 */
-	createDockerBarItems?(context: DockerBarContext): DockerBarItem[];
-	/**
-	 * Returns docker bar items used when multiple elements of this type are selected.
-	 * The final multi-select docker bar shows only the items whose `id` exists for every selected module.
-	 */
-	createMultiSelectDockerBarItems?(context: DockerBarContext): DockerBarItem[];
-	/**
-	 * Extra context menu items when this element is the sole selection (canvas or outline).
-	 */
-	createContextMenuItems?(context: WidgetContextMenuContext): ContextMenuItemDef[];
-	/**
-	 * Returns icon actions rendered as one floating toolbar above the selected element's transform box.
-	 * Keep actions concise; all modules share the same group renderer.
-	 */
-	createFloatingToolbarItems?(context: FloatingToolbarContext): FloatingToolbarItem[];
-	/**
-	 * Override the common Width / Height row in the layout inspector.
-	 * Return `undefined` to use the default row, or `null` to hide the row.
-	 */
-	createLayoutSizeField?(context: LayoutSizeFieldContext): FieldDefinition<UIInspectorData> | null | undefined;
-	/**
-	 * Optional hook to register additional blueprint nodes (via `defineBlueprintNode`) when the module loads.
-	 * Keep side effects idempotent - the host may call this once per session.
-	 */
-	registerBlueprintNodes?(): void;
-}
-type UIEditorReadOnly = {
-	/** Whether every write gesture on this surface is inert right now. */
-	readonly active: boolean;
-	/** Hover text for the controls this state disables. The workspace passes the freeze reason. */
-	readonly reason?: string;
-};
-type UIHost$1 = "app" | "player";
-type UIHostAdapterElementEventOptions = {
-	listItemScope?: UIListItemScope | null;
-	instanceKey?: string;
-	componentId?: UIComponentId;
-	/** Resolved values by param id: the instance's own, falling back to the declared default. */
-	componentParams?: Record<string, string>;
-	eventControl?: BehaviorGraphEventControl;
-	allowClosedScopeExecution?: boolean;
-};
-type UIHostAdapterBlueprintRuntime = {
-	surfaceId: string;
-	/** Instance-specific scope id. Defaults to `surfaceId` for top-level surfaces. */
-	runtimeScopeId?: string;
-	setSurfaceState: (key: string, value: unknown) => void;
-	getSurfaceState: (key: string) => unknown;
-	emitDebug: (event: BlueprintDebugEvent) => void;
-	getSurfaceTransitionState?: () => {
-		isEntering: boolean;
-		isExiting: boolean;
-	};
-	/** Dispatch a widget private event slot (for example `init` or `mouseClick`) on the owner-local blueprint. */
-	dispatchElementBlueprintEvent: (elementId: string, eventName: string, payload?: Record<string, unknown>, options?: UIHostAdapterElementEventOptions) => Promise<void>;
-	/** Continue the current widget event from this element to its structural parent. */
-	continueElementEventBubble?: (elementId: string, eventName: string, payload?: Record<string, unknown>, options?: UIHostAdapterElementEventOptions) => Promise<boolean>;
-	/** Dispatch a surface-level event on the current surfaceMain blueprint. */
-	dispatchSurfaceBlueprintEvent?: (eventName: string, payload?: Record<string, unknown>) => Promise<void>;
-	/**
-	 * Raise one of this surface's declared input actions on its surfaceMain blueprint.
-	 *
-	 * The seam between routing and authoring: routing decides that this click, wheel or key means
-	 * "advance" on this surface (see `runtime/input/surfaceInputActions`), and this hands that
-	 * decision to the graph. Named rather than positional because the payload is what the action's
-	 * head node reads its pins from.
-	 *
-	 * It resolves when the action's graphs have run, which is what lets a lane walk stay sequential.
-	 */
-	dispatchSurfaceInputAction?: (payload: UIInputActionEventPayload) => Promise<void>;
-	dispatchBroadcastEvent?: (eventName: string, data: unknown, sender?: string) => Promise<void>;
-	getBroadcastListenerCount?: (eventName: string) => number;
-	/** Invoke a declared blueprint fn (Call Fn node); awaits the fn body and returns its Fn Return values. */
-	invokeBlueprintFn?: (input: {
-		fnRef: string;
-		args: Record<string, unknown>;
-		depth: number;
-		/** Surface of the calling execution; global callers omit it and only see global fns. */
-		callerSurfaceId?: string;
-		/** Component definition of the calling execution, when it is running inside one. */
-		callerComponentId?: string;
-		/** That instance's resolved params, which the fn body runs with. */
-		callerComponentParams?: Record<string, string>;
-		/** Which drawing the call came from, so the body's widget writes land on it. */
-		callerInstanceKey?: string;
-		signal?: AbortSignal;
-		callerExecutionId?: string;
-	}) => Promise<{
-		returns: Record<string, unknown>;
-	}>;
-	frame?: {
-		getParam: (key: string) => unknown;
-		emit: (eventName: string, data: unknown) => Promise<void> | void;
-	};
-	/** M3-full: Dev Mode host API (graphs + TS ctx); absent in editor preview. */
-	hostApi?: BlueprintHostApiRuntime;
-};
-type UIHostAdapter = {
-	host: UIHost$1;
-	navigate?: (target: unknown) => Promise<void> | void;
-	resolveSlot?: (slotId: string) => {
-		mount: (node: React$1.ReactNode) => void;
-	} | null;
-	gameUiRuntime?: {
-		slotId: UIStageSlotId;
-	};
-	/**
-	 * M1 latch: which frozen BlueprintHostApiContract generation this adapter targets.
-	 * Does not imply all capabilities are implemented yet.
-	 */
-	blueprintHostApiVersion?: BlueprintHostApiContractVersion;
-	/** M3-min: optional Blueprint runtime surface (Dev Mode). */
-	blueprintRuntime?: UIHostAdapterBlueprintRuntime;
-	/**
-	 * Story Action Blueprint runtime surface. Present only while a story-action blueprint graph
-	 * runs inside a compiled NLR `Script`; resolves scene/saved variable ids to their NLR backing
-	 * (`Scene.local` / `Storable`). Absent for UI blueprints.
-	 */
-	storyRuntime?: UIHostAdapterStoryRuntime;
-	/** Editor preview: use the active workspace service instance for canvas-local interaction overrides. */
-	editorStateService?: UIEditorStateService;
-	/** Editor preview: use the active document service, including component-editor adapters. */
-	editorDocumentService?: UIDocumentService;
-	/**
-	 * Whether the surface this adapter renders is read-only right now (a frozen workspace).
-	 *
-	 * The two services above are the only thing a widget renderer needs in order to write the
-	 * document from inside its own markup, and the interaction layer's gesture table cannot reach
-	 * those handlers - a widget's `onDoubleClick` is attached by the widget, not by the canvas. So
-	 * the state travels on the adapter beside them, and {@link resolveInlineTextEditHost} is where
-	 * the two are read together.
-	 */
-	editorReadOnly?: UIEditorReadOnly;
-};
-type StoryVariableRuntimeAccess = {
-	/** Resolve `variableId` to its stored value, or the declared default when unset. */
-	get: (variableId: string) => unknown;
-	/** Resolve `variableId` and write `value` to the backing store. */
-	set: (variableId: string, value: unknown) => void;
-};
-type UIHostAdapterStoryRuntime = {
-	sceneVar: StoryVariableRuntimeAccess;
-	savedVar: StoryVariableRuntimeAccess;
-};
 type BlueprintPinSemantic = "exec" | "data";
 export type BlueprintNodePinDef = {
 	id: string;
@@ -18531,20 +17099,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 +17131,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 +17155,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;
@@ -18784,98 +17332,6 @@ interface IUIDocumentService extends IService {
 	};
 	renameElement(elementId: string, name: string): void;
 }
-type InteractionOverride = {
-	kind: "imageCrop";
-	surfaceId: string;
-	elementId: string;
-	source: string;
-} | {
-	kind: "textEdit";
-	surfaceId: string;
-	elementId: string;
-};
-type InteractionOverrideChange = {
-	previous: InteractionOverride | null;
-	next: InteractionOverride | null;
-};
-type UIEditorEnteredState = {
-	surfaceId: string;
-	elementId: string;
-	variantId: string | null;
-};
-interface UIEditorStateEvents {
-	toolChanged: UITool;
-	viewportChanged: ViewportTransform;
-	selectionChanged: SelectionState;
-	interactionOverrideChanged: InteractionOverrideChange;
-	/** Editor-only: which element is showing one of its states, and which; drives canvas preview. */
-	enteredStateChanged: UIEditorEnteredState | null;
-	/** Outline panel expand/collapse memory (persisted); payload unused. */
-	outlineExpansionChanged: null;
-	/** Outline panel chrome collapsed state (persisted). */
-	outlinePanelCollapsedChanged: boolean;
-	/** Smart snap / smart guides toggle (persisted in project settings). */
-	smartSnapEnabledChanged: boolean;
-	/** Per-category snap targets when smart snap is enabled (persisted). */
-	smartSnapDetailSettingsChanged: SmartSnapDetailSettings;
-	/** Ephemeral snap guide lines in surface space (viewport overlay). */
-	snapGuidesChanged: ActiveSnapGuides | null;
-	/** Screen-ratio preview frame preset id, `null` = off (pure view state, global settings). */
-	previewAspectChanged: string | null;
-	/** Safe-area preview frame device preset id, `null` = off (pure view state, global settings). */
-	previewSafeAreaChanged: string | null;
-}
-interface IUIEditorStateService extends IService {
-	getTool(): UITool;
-	setTool(tool: UITool): void;
-	getViewportTransform(): ViewportTransform;
-	/** A hand gesture (zoom, pan, or a typed zoom); ends the fit mode the interface was following. */
-	updateViewport(transform: Partial<ViewportTransform>): ViewportTransform;
-	/** Which interface the current transform describes; `null` before any editor tab claimed it. */
-	getViewportSurfaceId(): string | null;
-	/** The fit mode in force, or `null` once the author moved the view by hand. */
-	getViewportFit(): SurfaceViewportFit | null;
-	/** Installs a computed zoom for an interface (stays live across resizes, unlike a hand gesture). */
-	applyFittedViewport(surfaceId: string, transform: ViewportTransform, fit: SurfaceViewportFit): ViewportTransform;
-	/** Restores a hand-set view (`null`), or returns the mode the caller must recompute. */
-	adoptSurfaceViewport(surfaceId: string): SurfaceViewportFit | null;
-	getSelection(): SelectionState;
-	setSelection(selection: SelectionState): void;
-	setUIElementSelection(selection: UIElementSelection): void;
-	getDocument(): UIDocument;
-	getSurface(surfaceId: string): UISurface | undefined;
-	/** The state being shown on the canvas right now, or null while every element rests. */
-	getEnteredState(): UIEditorEnteredState | null;
-	setEnteredState(next: UIEditorEnteredState | null): void;
-	/** Whether compact Border panel "sides" row is expanded (per element, persisted with project settings). */
-	getAppearanceBorderSidesExpanded(elementId: string): boolean;
-	setAppearanceBorderSidesExpanded(elementId: string, expanded: boolean): void;
-	/** Outline: branch is collapsed when true (editor-only, project settings). */
-	isOutlineBranchCollapsed(elementId: string): boolean;
-	setOutlineBranchCollapsed(elementId: string, collapsed: boolean): void;
-	/** Outline panel chrome: collapsed when true (editor-only global settings). */
-	getOutlinePanelCollapsed(): boolean;
-	setOutlinePanelCollapsed(collapsed: boolean): void;
-	/** When true, dragging/resizing/inserting snaps to surface and sibling guides (project settings). */
-	getSmartSnapEnabled(): boolean;
-	setSmartSnapEnabled(enabled: boolean): void;
-	/** Which guide categories participate when smart snap is on (persisted). */
-	getSmartSnapDetailSettings(): SmartSnapDetailSettings;
-	patchSmartSnapDetailSettings(patch: Partial<SmartSnapDetailSettings>): void;
-	/**
-	 * Screen-ratio preview frame preset id (`null` = off). Pure view state: persisted in global
-	 * settings, never in the UIDocument, so toggling it cannot dirty the project.
-	 */
-	getPreviewAspectId(): string | null;
-	setPreviewAspectId(aspectId: string | null): void;
-	/** Safe-area preview frame device preset id (`null` = off). Pure view state, see above. */
-	getPreviewSafeAreaId(): string | null;
-	setPreviewSafeAreaId(safeAreaId: string | null): void;
-	/** Active snap guides for the current interaction (null clears overlay). */
-	getSnapGuides(): ActiveSnapGuides | null;
-	setSnapGuides(guides: ActiveSnapGuides | null): void;
-	on<K extends keyof UIEditorStateEvents>(event: K, handler: (data: UIEditorStateEvents[K]) => void): () => void;
-}
 export type StoryPluginActionCreateInput = {
 	generateId: () => string;
 	initialText?: string;
@@ -18907,6 +17363,7 @@ declare const HELP_TOPIC_IDS: readonly [
 	"dictionary",
 	"dictionaryMarks",
 	"assets",
+	"assetSources",
 	"assetSets",
 	"assetSetAxes",
 	"mediaConversion",
@@ -18925,6 +17382,7 @@ declare const HELP_TOPIC_IDS: readonly [
 	"inputActionsInBlueprints",
 	"uiComponents",
 	"blueprints",
+	"scripts",
 	"uiBindings",
 	"networkNodes",
 	"spellcheck",
@@ -19681,6 +18139,49 @@ export type RuntimePluginLocale = {
 export type RuntimePluginMenu = {
 	set(spec: GameMenuSpec): Promise<void>;
 };
+/**
+ * What the engine's image cache is holding, against what it is allowed to hold. All sizes in bytes.
+ *
+ * Restated here rather than re-exported from the engine because a plugin cannot import
+ * `narraleaf-react` - the only module specifiers it can resolve are `narraleaf-studio/*` and React.
+ * The shape is the engine's `ImageCacheStats`; if that grows a field, this is the second place.
+ */
+export type RuntimePluginImageCacheStats = {
+	/** Sources the cache holds a url for. */
+	entries: number;
+	/**
+	 * Bytes of fetched image data the cache is keeping alive.
+	 *
+	 * **Zero is a real answer, not a missing one.** A host that serves its own assets hands the
+	 * player urls instead of bytes, and then the player holds none: what the images cost lives in
+	 * the browser's cache, outside anything this can count. A reader that shows this as "memory
+	 * used" will report an improvement that did not happen - see {@link entries}, which still
+	 * counts, and the decoded figures below, which are the ones with a budget behind them.
+	 */
+	blobBytes: number;
+	/** Sources whose decoded bitmap the cache is holding. */
+	decodedEntries: number;
+	/** Estimated size of those bitmaps, at width x height x 4 bytes each. */
+	decodedBytes: number;
+	/** Entries nothing may evict right now: shown by a mounted element, or pinned by the scene. */
+	pinned: number;
+	/** The budgets in force. `Infinity` where the game removed one. */
+	budget: {
+		blobBytes: number;
+		decodedBytes: number;
+	};
+};
+/**
+ * `diagnostics` — what the player's caches weigh.
+ *
+ * Every member answers null before a game session exists, which is the ordinary state during
+ * `setup()`. A plugin polls this; there is no change event, because a cache that announced every
+ * eviction would cost more to watch than to run.
+ */
+export type RuntimePluginDiagnostics = {
+	/** The engine's image cache, or null when no session is live. */
+	imageCache(): RuntimePluginImageCacheStats | null;
+};
 /** `assets` — turn an asset id from the pack into a URL this shell can load. */
 export type RuntimePluginAssets = {
 	url(assetId: string): string;
@@ -19811,6 +18312,8 @@ export type RuntimePluginGame = {
 	menu?: RuntimePluginMenu;
 	/** Present with `"story.compile"`. */
 	story?: RuntimePluginStory;
+	/** Present with `"diagnostics"`. */
+	diagnostics?: RuntimePluginDiagnostics;
 	/** Present when `contributes.sidecars` is non-empty. */
 	sidecar?: RuntimePluginSidecars;
 	/** Present when `contributes.externalLinks` is non-empty. */
@@ -19831,6 +18334,163 @@ export type RuntimePluginDefinition = {
 };
 export declare function defineRuntimePlugin(definition: RuntimePluginDefinition): RuntimePluginDefinition;
 export declare function isRuntimePluginDefinition(value: unknown): value is RuntimePluginDefinition;
+/**
+ * The interface-editor extension surface a plugin actually gets.
+ *
+ * Studio's own widgets are described by `UIWidgetModule`, whose callbacks are handed the live
+ * `UIDocumentService` and `UIEditorStateService`. Those are `Service` instances, and `getContext()`
+ * on a service is public - so `documentService.getContext().services.get(...)` returns the workspace
+ * service registry, and with it a `FileSystemService` that speaks to the main process under the
+ * window's default privileged facade: recursive read and write over the author's whole project,
+ * authorised as the window rather than as the plugin. That is the same escalation
+ * `pluginWorkspaceGuard` closed on `ActionDefinition.onClick`, reached through the widget door.
+ *
+ * A class instance cannot be made safe by wrapping one method, either: `service.constructor` is the
+ * real class, `Service` extends `Singleton`, and `Singleton.instances` is an ordinary static
+ * property holding every service that has ever been constructed. Anything with that prototype chain
+ * hands over the registry however many members are trapped on the way past.
+ *
+ * So the types below are what a widget is handed instead - plain objects with named methods,
+ * built by `pluginWidgetGuard` and enforced there rather than here. **These declarations state the
+ * contract; they do not impose it.** A plugin ships compiled JavaScript and can cast anything to
+ * anything; the guard is what makes the cast find nothing.
+ *
+ * The surface is derived from what the built-in widgets do, which is the only honest measure of what
+ * a widget needs: read the interface document, write the element's own props, layout, animation,
+ * extra and list-item wiring, group a burst of those into one undo step, and move the selection.
+ * Nothing here reaches outside `uidoc.json`.
+ */
+/**
+ * Interface-document access for a plugin widget.
+ *
+ * Whole-document reads are deliberate: a structural widget cannot resolve its own parts without
+ * looking them up, which is why the game side hands plugin renderers the document too. The document
+ * is authored content the editor is already drawing, not a host power - and it is one document, not
+ * an index that leads to unrelated resources.
+ *
+ * Writes are element-scoped by signature. They are not restricted to the element being inspected: a
+ * widget with parts edits its parts, exactly as the built-in switch and list do, and there is no
+ * honest way to tell "my part" from "someone else's element" from here.
+ */
+export type PluginWidgetDocumentApi = {
+	/** The whole interface document, as the editor currently holds it. */
+	getDocument(): UIDocument;
+	/** A fresh element id, for a widget that builds child elements of its own. */
+	generateId(): string;
+	/** One component definition by id, for a widget that draws a linked component instance. */
+	getComponent(componentId: string): UIComponentDefinition | undefined;
+	createElement(parentId: string, type: string, layoutPatch?: Partial<UILayout>): UIElement;
+	updateElementProps(elementId: string, propsPatch: Record<string, unknown>): void;
+	updateElementExtra(elementId: string, extraPatch: Record<string, unknown>): void;
+	updateElementLayout(elementId: string, layoutPatch: Partial<UILayout>, options?: {
+		skipHistory?: boolean;
+	}): void;
+	updateElementAnimation(elementId: string, animation: UIPageAnimationSettings | null, options?: {
+		mergeKey?: string;
+	}): void;
+	/** Collapse everything the callback writes into one undo entry on that surface. */
+	runSurfaceHistoryTransaction(surfaceId: string, action: () => void): void;
+	setListItemStructFields(elementId: string, fields: readonly UIStructField[]): void;
+	setElementListItemFieldBinding(elementId: string, propPath: string, fieldId: string | null): void;
+	ensureElementBlueprintValueBinding(elementId: string, propPath: string, input: {
+		valueType: UIElementValueBindingValueType;
+		displayName?: string;
+		literalValue?: unknown;
+	}): {
+		blueprintId: string;
+	};
+	clearElementBlueprintValueBinding(elementId: string, propPath: string): void;
+};
+/**
+ * Editor state a plugin widget's docker bar may read and move.
+ *
+ * Selection only. The interaction overrides (inline text edit, image crop) are not here because the
+ * host honours them in built-in renderers alone - offering a plugin a switch that turns nothing on
+ * would be worse than not having it.
+ */
+export type PluginWidgetEditorStateApi = {
+	getSelection(): SelectionState;
+	setUIElementSelection(selection: UIElementSelection): void;
+	getEnteredState(): {
+		surfaceId: string;
+		elementId: string;
+		variantId: string | null;
+	} | null;
+	setEnteredState(next: {
+		surfaceId: string;
+		elementId: string;
+		variantId: string | null;
+	} | null): void;
+};
+/** What a plugin widget's property fields read and write through. */
+export type PluginWidgetInspectorData = {
+	element: UIElement;
+	elements: UIElement[];
+	documentService: PluginWidgetDocumentApi;
+	surfaceId?: string;
+};
+export type PluginWidgetInspectorContext = {
+	element: UIElement;
+	documentService: PluginWidgetDocumentApi;
+};
+export type PluginWidgetDockerBarContext = {
+	element: UIElement;
+	documentService: PluginWidgetDocumentApi;
+	stateService?: PluginWidgetEditorStateApi;
+	surfaceId?: string;
+};
+export type PluginWidgetContextMenuContext = {
+	element: UIElement;
+	documentService: PluginWidgetDocumentApi;
+	surfaceId: string;
+};
+export type PluginWidgetFloatingToolbarContext = {
+	element: UIElement;
+	documentService: PluginWidgetDocumentApi;
+	surfaceId: string;
+	openSurfaceEditor?: (surfaceId: string) => void;
+};
+export type PluginWidgetLayoutSizeFieldContext = {
+	element: UIElement;
+	documentService: PluginWidgetDocumentApi;
+	surfaceId?: string;
+	primaryId: string;
+};
+/**
+ * A widget type contributed by a plugin.
+ *
+ * `render` takes the same {@link RuntimeWidgetRendererProps} the game hands a plugin renderer,
+ * rather than the editor's wider props: one render function, drawn the same way in both places, and
+ * no `hostAdapter` on either side. See `create-plugin.md` for the shared-module pattern that relies
+ * on it.
+ *
+ * `registerBlueprintNodes` is absent on purpose. It exists on the built-in module type and the host
+ * only ever calls it for built-ins; a plugin registers nodes through `app.services.blueprintNodes`,
+ * where the execute context is narrowed the same way this is.
+ */
+export type PluginWidgetModule = {
+	/** Unique type id; must start with the plugin id and be declared in `contributes.widgets`. */
+	readonly type: string;
+	/** Widget type this one specialises. */
+	readonly extends?: string;
+	/** Event and effect capabilities, shared with the blueprint tooling. */
+	readonly logicApi?: WidgetLogicApi;
+	readonly displayName: string;
+	readonly icon: LucideIcon;
+	createDefaultElement(): Partial<UIElement>;
+	createDefaultChildElements?(context: DefaultChildElementContext): DefaultChildElementResult;
+	listEditorStates?(element: UIElement): {
+		id: string | null;
+		name: string;
+	}[];
+	render(props: RuntimeWidgetRendererProps): React$1.ReactElement | null;
+	createInspector?(context: PluginWidgetInspectorContext): PropertyEditorSchema<PluginWidgetInspectorData> | undefined;
+	createDockerBarItems?(context: PluginWidgetDockerBarContext): DockerBarItem[];
+	createMultiSelectDockerBarItems?(context: PluginWidgetDockerBarContext): DockerBarItem[];
+	createContextMenuItems?(context: PluginWidgetContextMenuContext): ContextMenuItemDef[];
+	createFloatingToolbarItems?(context: PluginWidgetFloatingToolbarContext): FloatingToolbarItem[];
+	createLayoutSizeField?(context: PluginWidgetLayoutSizeFieldContext): FieldDefinition<PluginWidgetInspectorData> | null | undefined;
+};
 /**
  * Caller-defined section (e.g. built-in presets) shown as a collapsible group in the asset list.
  * Workspace filter chips do not apply; only the search box filters `assets` (same rules as project assets).
@@ -20387,8 +19047,30 @@ 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`.
+ * What a plugin can learn about a widget type it did not register.
+ *
+ * The registry itself holds host objects, so what comes back is the answer to the question a plugin
+ * can act on - does this type exist, and what is it called - rather than the module behind it.
+ */
+export type PluginWidgetTypeInfo = {
+	type: string;
+	displayName: string;
+	/** The widget type this one specialises, when it specialises one. */
+	extends?: string;
+	/** The plugin that contributed it, absent for Studio's own widgets. */
+	ownerPluginId?: string;
+};
+/**
+ * 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 +19078,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;
 };
 /**
@@ -20627,7 +19311,7 @@ export type PluginAssetsService = {
 	revokeObjectUrl(url: string): void;
 };
 /** An active editor locale code (built-in like "en"/"zh", or a plugin-provided locale). */
-type LocaleCode$1 = string;
+export type LocaleCode = string;
 /**
  * A plugin's own message tables: `locale code -> (message key -> string)`. This
  * is the plugin's private catalog, unrelated to Studio's own translations.
@@ -20647,7 +19331,7 @@ export type PluginMessageBundle = {
  * {@link PluginI18n.onLocaleChange} to re-render on a language switch.
  */
 export type PluginTranslator = {
-	readonly locale: LocaleCode$1;
+	readonly locale: LocaleCode;
 	t(key: string, params?: Record<string, string | number>): string;
 };
 /**
@@ -20657,14 +19341,14 @@ export type PluginTranslator = {
  */
 export type PluginI18n = {
 	/** The editor's active locale code. */
-	readonly locale: LocaleCode$1;
+	readonly locale: LocaleCode;
 	/**
 	 * Subscribe to editor-language changes. The listener fires with the new
 	 * locale code whenever the active editor language changes. Returns a
 	 * {@link PluginCleanup} (also tracked by the host, so it is reclaimed on
 	 * unload even if you forget to call it).
 	 */
-	onLocaleChange(listener: (locale: LocaleCode$1) => void): PluginCleanup;
+	onLocaleChange(listener: (locale: LocaleCode) => void): PluginCleanup;
 	/** Locale-aware number formatting bound to the editor's active locale. */
 	formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
 	/** Locale-aware date formatting bound to the editor's active locale. */
@@ -20798,11 +19482,18 @@ export type PluginServices = {
 			error(message: string): void;
 		};
 	};
+	/**
+	 * Contribute a widget type to the interface editor; see {@link PluginWidgetModule}.
+	 *
+	 * `get` and `list` answer with a type's name rather than with its module. A widget module is
+	 * the host's own object - Studio's built-ins carry the editor services in their callbacks - and
+	 * "which types exist" is the whole of what a plugin can act on.
+	 */
 	widgets: {
-		register(module: UIWidgetModule): PluginCleanup;
-		registerMany(modules: UIWidgetModule[]): PluginCleanup;
-		get(type: string): UIWidgetModule | undefined;
-		list(): UIWidgetModule[];
+		register(module: PluginWidgetModule): PluginCleanup;
+		registerMany(modules: PluginWidgetModule[]): PluginCleanup;
+		get(type: string): PluginWidgetTypeInfo | undefined;
+		list(): PluginWidgetTypeInfo[];
 		has(type: string): boolean;
 	};
 	story: {
@@ -20851,7 +19542,6 @@ export declare function isPluginDefinition(value: unknown): value is PluginDefin
 
 export {
 	BehaviorNodeExecuteResult as RuntimeBlueprintNodeResult,
-	LocaleCode$1 as LocaleCode,
 	SelectOption$1 as SelectOption,
 };