narraleaf-studio 1.4.0 → 1.4.2

package/dist/_api.d.ts

@@ -1736,1336 +1736,6 @@ type BlueprintAssetPinRef = {
 	 */
 	origin?: "stored" | "published";
 };
-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;
-	/**
-	 * Playback gain in decibels, never above 0: the engine cannot raise a clip past its own level, so
-	 * balancing loudness means bringing the loud clips down. Absent is unity. Folded into a volume
-	 * only by {@link clipVolume}.
-	 */
-	gainDb?: number;
-};
-type StoredAudioClipRegion = Pick<AudioClipRegion, "inMs" | "outMs" | "loopStartMs">;
-type StoredAudioGain = {
-	db: 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 BlueprintGraphKind = "event" | "function" | "macro";
-type GameBuildPlatform = "windows" | "macos" | "linux" | "web" | "android" | "ios";
-declare const UI_STRUCT_FIELD_TYPES: readonly [
-	"string",
-	"number",
-	"boolean",
-	"image",
-	"color",
-	"json"
-];
-type UIStructFieldType = (typeof UI_STRUCT_FIELD_TYPES)[number];
-type UIStructField = {
-	/**
-	 * Stable identity. Value bindings, node params and generated pins all address a field by this,
-	 * so renaming `key` costs nothing and reshuffling the list costs nothing.
-	 */
-	id: string;
-	/** The property name this field occupies inside an item object. */
-	key: string;
-	/**
-	 * What the author called it, shown in the item table header and in every field picker.
-	 *
-	 * Optional because `key` is usually already the readable name; a label is what lets a field
-	 * whose key has to stay ASCII (it travels in JSON to a plugin, a save file, a story variable)
-	 * still read as words in the editor.
-	 */
-	label?: string;
-	type: UIStructFieldType;
-};
-type UIStructId = string;
-type UIStructDef = {
-	id: UIStructId;
-	fields: UIStructField[];
-};
-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";
-	/**
-	 * `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";
-	/**
-	 * `app.game.process.memory()` — read how much memory the game's processes hold, as the
-	 * operating system counts it.
-	 *
-	 * Its own capability rather than a member of `diagnostics`, because what it reports is not the
-	 * game's: `diagnostics` describes the engine's caches, which are the game's own bookkeeping,
-	 * while this is the player's machine - how much of its memory every process of the game is
-	 * holding, the main process and the GPU process included. An author who approved the first did
-	 * not approve the second, and a plugin that already holds `diagnostics` must not gain this by
-	 * an update without being asked again - which is what a capability of its own guarantees.
-	 *
-	 * Read-only, and numbers only: sizes and what each process is for, never a path, an id or a
-	 * command line. Nothing is sent anywhere by the host; what a plugin does with a reading is
-	 * visible in the code the author installed.
-	 *
-	 * Absent where there are no processes to count - the web export - and narrowed in Dev Mode to
-	 * the window's own renderer, since everything around it is Studio's.
-	 */
-	readonly ProcessMemory: "process.memory";
-};
-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
- * to the plugin package root. At least one target must be declared.
- *
- * - `studio`: loaded in the workspace window only; talks to the
- *   `narraleaf-studio/plugin` host API (editor extensions).
- * - `runtime`: loaded in every game execution environment (Dev Mode window,
- *   Preview, Production); talks to the `narraleaf-studio/runtime` host API
- *   (game logic such as blueprint node execute bindings).
- */
-export type PluginManifestEntries = {
-	studio?: string;
-	runtime?: string;
-};
-type PluginLocaleContribution = {
-	code: string;
-	nativeName?: string;
-	englishName?: string;
-	intl?: string;
-	dir?: "ltr" | "rtl";
-	messages: string;
-};
-type PluginBinaryPlatformKey = string;
-type PluginSidecarTargetContribution = {
-	/** Executable (or, for `kind: "node"`, the .js file) to run. Must appear in `include`. */
-	entry: string;
-	/**
-	 * Everything shipped for this platform. Entries are package-relative paths,
-	 * or `dep:<buildDependencyId>/<path>` to pull an artifact produced by a
-	 * declared build dependency (that is how third-party redistributables that
-	 * we may not vendor ourselves reach the pack).
-	 */
-	include: string[];
-	/**
-	 * `sha256` of every package-relative entry in `include`, hex. Verified at
-	 * install and again at pack time, so a tampered package fails to install
-	 * instead of silently shipping a different binary. `dep:` entries are covered
-	 * by the build dependency's own digest instead.
-	 */
-	sha256: Record<string, string>;
-};
-type PluginSidecarContribution = {
-	/** Prefixed with the plugin id, like every other contributed identifier. */
-	id: string;
-	/**
-	 * `executable` spawns the binary directly and talks to it over stdin/stdout; `node` runs the
-	 * .js as an Electron utility process and talks to it over `process.parentPort`, which is the
-	 * one channel a utility process has - it has no stdin.
-	 */
-	kind: PluginSidecarKind;
-	/**
-	 * Newline-delimited JSON, which is the framing and not the channel: where the frames travel is
-	 * {@link kind}'s business, and only an executable sidecar's travel over stdio. Either way
-	 * stderr stays a plain log channel.
-	 *
-	 * `stdio-jsonl` is the older spelling of the same thing, from when there was only one channel
-	 * it could mean. Manifests that say it keep working and always will - a published plugin is a
-	 * file somebody already shipped - but a new one should say `jsonl`.
-	 */
-	transport: "jsonl" | "stdio-jsonl";
-	/** `onGameStart` spawns with the window; `onRequest` waits for the first call. */
-	autostart: "onGameStart" | "onRequest";
-	/** How long the handshake may take before the sidecar counts as unavailable. */
-	startupTimeoutMs: number;
-	/** Grace period between the shutdown message and SIGTERM. */
-	shutdownTimeoutMs: number;
-	restart: {
-		maxRetries: number;
-		backoffMs: number;
-	};
-	targets: Record<PluginBinaryPlatformKey, PluginSidecarTargetContribution>;
-};
-type PluginBuildDependencyTargetContribution = {
-	url: string;
-	/** Mandatory. Doubles as the cache key, so re-pointing the URL at identical bytes never re-downloads. */
-	sha256: string;
-	archive: "zip";
-	/** Archive-internal path -> path inside the produced dependency directory. */
-	files: Record<string, string>;
-} | {
-	url: string;
-	sha256: string;
-	archive: "none";
-	/** Name the downloaded file takes inside the produced dependency directory. */
-	fileName: string;
-};
-type PluginBuildDependencyContribution = {
-	/** Prefixed with the plugin id. Referenced from sidecar `include` as `dep:<id>/<path>`. */
-	id: string;
-	/** Shown to the author at install and in build logs; say what the binaries are. */
-	description?: string;
-	targets: Record<PluginBinaryPlatformKey, PluginBuildDependencyTargetContribution>;
-};
-declare const PLUGIN_BUILD_CONFIG_TYPES: readonly [
-	"text",
-	"secret"
-];
-type PluginBuildConfigType = (typeof PLUGIN_BUILD_CONFIG_TYPES)[number];
-declare const PLUGIN_BUILD_CONFIG_SCOPES: readonly [
-	"global",
-	"variant",
-	"platform",
-	"variant-platform"
-];
-type PluginBuildConfigScope = (typeof PLUGIN_BUILD_CONFIG_SCOPES)[number];
-type PluginBuildConfigFieldContribution = {
-	/** Unique within the plugin. Keys the stored value; never displayed. */
-	key: string;
-	/** Author-facing name of the field. */
-	label: string;
-	/** One line saying what the value is for. */
-	description?: string;
-	/** `text` is stored in the project; `secret` is not - the project stores a handle. */
-	type: PluginBuildConfigType;
-	/** Which builds share one value. */
-	scope: PluginBuildConfigScope;
-	/** Platforms the field applies to. Absent means every platform. */
-	platforms?: GameBuildPlatform[];
-	/** A build that would ship without a value for this field is refused. */
-	required?: boolean;
-};
-export type PluginContributes = {
-	/** Blueprint node types this plugin provides (editor def + runtime execute). */
-	blueprintNodes?: string[];
-	/** Widget element types this plugin provides (editor module + runtime renderer). */
-	widgets?: string[];
-	/** Studio language packs: locales this plugin adds or fills. */
-	locales?: PluginLocaleContribution[];
-	/**
-	 * Plugin storage namespaces to publish with the game, readable at runtime
-	 * through `app.game.data.readJson(namespace)`.
-	 *
-	 * Plugin stores live under the project's `editor/` directory, which is never
-	 * packaged. A plugin whose runtime needs authored data (catalogs, tables)
-	 * must list those namespaces here. The list is an explicit allowlist so
-	 * editor-only plugin state cannot leak into a shipped game by accident.
-	 */
-	runtimeData?: string[];
-	/**
-	 * Test ids this plugin registers with `app.services.tests` (see
-	 * `docs/plugin-test-protocol.md`). Declaring them lets the Launcher say what
-	 * a plugin checks before any of its code runs, and registering an
-	 * undeclared id throws at load.
-	 *
-	 * Unlike every other code-backed contribution here, this one derives no
-	 * install permission — a test only ever executes because the author picked
-	 * it out of the Run > Test dialog and pressed Start, so there is no ambient
-	 * capability to consent to at install time.
-	 */
-	tests?: string[];
-	/**
-	 * Save ids the plugin keeps for its own bookkeeping - a quick-save slot, a checkpoint - rather
-	 * than slots a player chose.
-	 *
-	 * The game leaves them out of `List Saves`, and so out of every save screen built on it, the way
-	 * it leaves out its own autosave ring. Nothing else changes for them: the plugin still writes,
-	 * loads and finds them through `app.game.saves` (whose `listIds` is the raw store listing and
-	 * still includes them), and the explicit-id save nodes - `Load Save`, `Delete Save`, the
-	 * `Get Save` readers - take them like any other id.
-	 *
-	 * Prefixed with the plugin id like the type lists above, so a plugin can only reserve ids in its
-	 * own namespace and can never hide a slot the author's own `Save Game` wrote. That is also why it
-	 * derives no install permission: it reaches nothing the plugin did not already own.
-	 */
-	reservedSaveIds?: string[];
-	/**
-	 * Capability domains the `runtime` entry may use. Each maps 1:1 onto a
-	 * namespace on `app.game`, and an undeclared domain is absent from that
-	 * object rather than present-and-throwing — so what the install prompt
-	 * listed and what the plugin can reach are the same set by construction.
-	 */
-	runtimeCapabilities?: PluginRuntimeCapability[];
-	/** Native child processes shipped inside the author's game. */
-	sidecars?: PluginSidecarContribution[];
-	/** External binaries fetched (and cached) at build time. */
-	buildDependencies?: PluginBuildDependencyContribution[];
-	/**
-	 * Values the author supplies before a build can ship. Declaration only - see
-	 * {@link PluginBuildConfigFieldContribution} for why there is no registration API and why this
-	 * grants the plugin nothing.
-	 */
-	buildConfig?: PluginBuildConfigFieldContribution[];
-	/**
-	 * Address patterns this plugin may hand to the player's browser or platform handler, through
-	 * `app.game.navigation.openExternal`.
-	 *
-	 * Unlike everything else here, this one is *not* a list of identifiers the plugin owns - it is a
-	 * list of places outside the game it may reach, so it derives an install permission the author
-	 * approves by name (see `PluginInstallPermission` `kind: "externalLink"`) and adding one to a
-	 * later version re-prompts.
-	 *
-	 * Patterns are matched structurally, never as strings: see `isExternalLinkPatternDeclared` in
-	 * `@shared/types/externalLinkPattern` for the exact semantics. Wildcards are allowed
-	 * (`https://*.example.com/app/*`) and the scheme is not restricted to `http(s)`, because the
-	 * storefronts a plugin integrates with speak their own (`steam://run/480`). A handful of schemes
-	 * are refused at validation whatever a manifest says; that list and its reasoning live in the
-	 * same module.
-	 *
-	 * This is separate from, and grants nothing towards, {@link network}: opening a page and
-	 * fetching bytes are different acts, and the Open Link node the author writes is a third thing
-	 * again, governed only by its scheme.
-	 */
-	externalLinks?: string[];
-	/**
-	 * Address patterns this plugin's runtime code requests bytes from.
-	 *
-	 * Like {@link externalLinks} and unlike everything else here, this is a list of places outside
-	 * the game rather than identifiers the plugin owns, so it derives an install permission the
-	 * author approves by name (`PluginInstallPermission` `kind: "network"`) and adding one to a
-	 * later version re-prompts.
-	 *
-	 * Two rules narrower than the external-link patterns, both for the same reason - what comes
-	 * back from a fetch runs inside the game, while an opened page does not:
-	 *
-	 *  - **`http(s)` only.** There is no storefront-scheme case here; a plugin that fetches speaks
-	 *    HTTP.
-	 *  - **The path is written out.** `https://api.example.com/*` is a declaration and
-	 *    `https://api.example.com` is not, because the pattern language reads the second as the
-	 *    single path `/`. It is refused rather than rewritten: this string is what the install
-	 *    prompt shows, and a manifest whose text differs from what was approved is the one thing
-	 *    this whole mechanism exists to prevent.
-	 *
-	 * What this reaches is *not* widened by the project's own network allowlist and does not widen
-	 * it. A build narrowed to a list still reaches these hosts - the author approved them at
-	 * install - and the list shows them attributed to this plugin rather than quietly making room.
-	 */
-	network?: string[];
-	/**
-	 * The props of a contributed widget that hold words a player reads, by widget type.
-	 *
-	 * Each type named here must also be in {@link widgets}. A declared prop is treated as Studio's own
-	 * text and button labels are: the properties panel offers its words written directly or read
-	 * from a translation key, the canvas draws a key's words, the words go into the project's
-	 * translation table and exports, the project checks report a missing translation or key, and
-	 * the glyph check reads them. In the game the widget's renderer is handed the words already in
-	 * the player's language, in the prop it declared - it never resolves a key itself.
-	 *
-	 * Declared in the manifest rather than at registration because both entries need it - the
-	 * studio entry's widget is edited by it and the runtime entry's is drawn by it - and a
-	 * declaration only one of them made would be the half that drifts.
-	 */
-	widgetText?: Record<string, PluginWidgetTextContribution[]>;
-	/**
-	 * The shapes of the rows this plugin's nodes hand out, so a list can be given one and a field
-	 * read from one by name.
-	 *
-	 * A node pin carrying them says `struct:<id>` or `array<struct:<id>>` - `Get Gallery` answers
-	 * `array<struct:narraleaf.gallery.entry>` - and from then on the plugin's rows are what the
-	 * engine's own are: a list picks the shape under Edit content and its fields are the plugin's
-	 * and locked, Get Field offers them, and a list handed rows that lack them is reported.
-	 *
-	 * Declared in the manifest rather than at registration because the editor, the running game and
-	 * the command-line checker all need the shape, and only the manifest is read by all three before
-	 * any plugin code runs. Ids must start with the plugin id.
-	 */
-	structs?: PluginStructContribution[];
-};
-type PluginStructContribution = {
-	/** Prefixed with the plugin id: `narraleaf.gallery.entry`. */
-	id: string;
-	/** What the editor calls the shape - "Gallery entry". */
-	name: string;
-	/** `name` per editor locale, matched exactly as `localized` names are. */
-	localized?: Record<string, string>;
-	/** In the order the rows are read: the list's content editor shows them in this order. */
-	fields: {
-		key: string;
-		type: UIStructFieldType;
-	}[];
-};
-/**
- * One prop of a contributed widget whose value is words a player reads.
- *
- * `keyProp` is the prop the widget's translation key is kept in when the author reads the words from
- * one. It defaults to `<prop>LocalizationKey`, and it is the host's to write: the widget never reads it
- * to draw, because the words in `prop` already come from the key when there is one.
- */
-export type PluginWidgetTextContribution = {
-	/** The prop holding the words. */
-	prop: string;
-	/** The prop the translation key is kept in; `<prop>LocalizationKey` when not declared. */
-	keyProp?: string;
-	/** What the properties panel calls the words. The prop name when not declared. */
-	label?: string;
-	/** `label` per editor locale, matched exactly as `localized` names are. */
-	localized?: Record<string, string>;
-	/** Whether the words may run over several lines; one line when not declared. */
-	multiline?: boolean;
-};
-/**
- * The plugin's name and description in one editor language. Either may be left out, and the plain
- * manifest field is shown in its place.
- */
-export type PluginManifestLocalizedText = {
-	name?: string;
-	description?: string;
-};
-/**
- * `name` and `description` per editor locale, keyed by the exact code Studio's language setting
- * stores (`zh`, `ja`, or a code a language pack adds). There is no region matching: an entry under
- * `zh-CN` is never shown, because no Studio locale is called that.
- */
-export type PluginManifestLocalized = Record<string, PluginManifestLocalizedText>;
-export type PluginManifestV2 = Omit<PluginIdentity, "id" | "name" | "version"> & Required<Pick<PluginIdentity, "id" | "name" | "version">> & {
-	manifestVersion: typeof PluginManifestVersion;
-	description?: string;
-	/**
-	 * Translations of `name` and `description`, shown wherever Studio names the plugin to an author
-	 * whose editor is set to that language. The plain fields stay the plugin's identity: command
-	 * lines, project files and built games name it by them.
-	 */
-	localized?: PluginManifestLocalized;
-	/**
-	 * Package-relative path to the thumbnail shown beside the plugin's name in
-	 * the Launcher list. Square, at most 512x512, and one of the extensions in
-	 * `PLUGIN_ICON_EXTENSIONS`. Plugins without one keep the name monogram.
-	 */
-	icon?: string;
-	entries: PluginManifestEntries;
-	contributes?: PluginContributes;
-	permissions?: PluginInstallPermission[];
-};
-export type NormalizedPluginManifestV2 = PluginManifestV2 & {
-	contributes: Required<PluginContributes>;
-	permissions: PluginInstallPermission[];
-};
-type PluginInstallSource = {
-	kind: "local-directory";
-	path: string;
-} | {
-	kind: "builtin";
-	path: string;
-} | {
-	kind: "registry";
-	url: string;
-};
-export type PluginInstallRecord = {
-	pluginId: string;
-	installPath: string;
-	enabled: boolean;
-	builtIn: boolean;
-	manifest: NormalizedPluginManifestV2;
-	installSource: PluginInstallSource;
-	installedAt: number;
-	updatedAt: number;
-	grantedManifestVersion?: string | null;
-	/**
-	 * The permission set the user actually approved, recorded so a later version
-	 * that does not widen it can inherit the grant instead of re-prompting.
-	 * Absent on records written before this was tracked — the manifest at
-	 * `grantedManifestVersion` is the fallback source of truth for those.
-	 */
-	grantedPermissions?: PluginInstallPermission[] | null;
-	lastError?: string | null;
-};
-type PluginStatus = "enabled" | "disabled" | "needsAuthorization" | "error";
-export type PluginListItem = {
-	pluginId: string;
-	manifest: NormalizedPluginManifestV2;
-	/**
-	 * `app://` address of the declared icon, absent when the plugin ships none.
-	 * Resolved here rather than in the renderer because only the main process
-	 * knows where the package landed on disk.
-	 */
-	iconUrl?: string;
-	installPath: string;
-	enabled: boolean;
-	builtIn: boolean;
-	status: PluginStatus;
-	installSource: PluginInstallSource;
-	installedAt: number;
-	updatedAt: number;
-	grantedManifestVersion?: string | null;
-	lastError?: string | null;
-};
-/** Descriptor handed to the workspace window: plugins with a studio entry. */
-export type WorkspacePluginDescriptor = {
-	plugin: PluginIdentity;
-	manifest: NormalizedPluginManifestV2;
-	entryUrl: string;
-};
-/** Descriptor handed to game execution environments: plugins with a runtime entry. */
-export type RuntimePluginDescriptor = {
-	plugin: PluginIdentity;
-	manifest: NormalizedPluginManifestV2;
-	entryUrl: string;
-	/**
-	 * Published plugin storage, keyed by the namespaces declared in
-	 * `contributes.runtimeData`. Absent namespaces simply have no entry - a
-	 * plugin must tolerate missing data (the project may never have written it).
-	 */
-	data?: Record<string, unknown>;
-	/**
-	 * This plugin's own `contributes.buildConfig` values, as the build that produced the pack
-	 * resolved them, keyed by field key. Only ever the declaring plugin's own values: the pack
-	 * holds one record per plugin and a descriptor is built from one entry.
-	 *
-	 * Absent outside a compiled pack - the editor and Dev Mode hand out descriptors that were never
-	 * built for a variant, so there is nothing resolved to carry.
-	 */
-	buildConfig?: Record<string, string>;
-};
-type GameMenuLabel = {
-	readonly key?: string | null;
-	readonly text: string;
-	readonly words?: string | null;
-};
-declare const GAME_MENU_DYNAMIC_SOURCES: readonly [
-	"textLanguage",
-	"voiceLanguage",
-	"windowScale"
-];
-type GameMenuDynamicSource = typeof GAME_MENU_DYNAMIC_SOURCES[number];
-type GameMenuAction = 
-/** Open an app surface as a page. */
-{
-	readonly type: "openPage";
-	readonly surfaceId: string;
-}
-/** Open an app surface as a layer over whatever is on screen. */
- | {
-	readonly type: "openLayer";
-	readonly surfaceId: string;
-	readonly modal?: boolean;
-	readonly dismissible?: boolean;
-	readonly group?: string | null;
-}
-/** End the playthrough and hand the screen to a page - the same act as the story's quit row. */
- | {
-	readonly type: "quitToPage";
-	readonly surfaceId: string;
-}
-/**
- * Close the game.
- *
- * The same act as the Quit Application node, which means the same terms: a graceful quit that
- * does NOT run the author's close handler (`On Window Close Requested` answers the window
- * frame's own close, and the node deliberately stands the guard aside so a quit the game asked
- * for is not asked back about). An author who wants their own "really quit?" screen binds a
- * function instead and calls the node at the end of it - which is the same answer this menu
- * gives for every other confirmation.
- */
- | {
-	readonly type: "quitApp";
-}
-/** Advance the line on screen. */
- | {
-	readonly type: "next";
-}
-/** Auto-forward on/off. Ticked while on. */
- | {
-	readonly type: "toggleAutoForward";
-}
-/** Skipping on/off. Ticked while running. */
- | {
-	readonly type: "toggleSkipping";
-}
-/** Which lines skipping stops at. The two values are a radio pair, never one switch. */
- | {
-	readonly type: "setSkipReadText";
-	readonly value: boolean;
-}
-/** Show or hide the dialogue box. Ticked while shown. */
- | {
-	readonly type: "toggleDialog";
-}
-/** Step back one line of history. Greyed out when there is none. */
- | {
-	readonly type: "historyUndo";
-}
-/** Step forward again after an undo. Greyed out when there is none. */
- | {
-	readonly type: "historyRedo";
-}
-/** Full-screen on/off. Ticked while full-screen, including when the OS did it. */
- | {
-	readonly type: "toggleFullscreen";
-}
-/**
- * Call a function declared in the global blueprint.
- *
- * `fnRef` is the catalogue's own reference (see `fnCatalog`), and `args` are keyed by the head's
- * parameter pin ids. Everything the named actions above do not cover goes through here -
- * including every confirmation, because what a game asks before losing a playthrough is the
- * author's screen and not a native box in a language the game may not even be running in.
- */
- | {
-	readonly type: "fn";
-	readonly fnRef: string;
-	readonly args?: Readonly<Record<string, unknown>>;
-};
-type GameMenuItemSpec = {
-	readonly kind: "separator";
-} | {
-	readonly kind: "submenu";
-	readonly label: GameMenuLabel;
-	readonly items: readonly GameMenuItemSpec[];
-} | {
-	readonly kind: "action";
-	readonly label: GameMenuLabel;
-	readonly action: GameMenuAction;
-} | {
-	readonly kind: "dynamic";
-	readonly source: GameMenuDynamicSource;
-};
-type GameMenuSpecMenu = {
-	readonly label: GameMenuLabel;
-	readonly items: readonly GameMenuItemSpec[];
-};
-type GameMenuSpec = {
-	readonly menus: readonly GameMenuSpecMenu[];
-};
-/**
- * How much memory a running game costs the machine it runs on, process by process.
- *
- * Read in the main process from Electron's process metrics (`app.getAppMetrics()`), which is the
- * operating system's own account: the same working set a task manager shows. Nothing a page can
- * read gives this. `performance.memory` describes one JavaScript heap, and in Electron it is also
- * rounded to coarse buckets - the two arms of a measured comparison both read exactly 92.9 MB -
- * while the memory a visual novel actually spends is mostly outside any heap:
- * decoded pictures, textures in the GPU process, audio buffers, the main process serving and
- * decrypting assets. The whole game is several processes, and only the process that owns them can
- * see all of them.
- *
- * `process.memoryUsage()` in the main process was the other candidate and answers a narrower
- * question - the main process's own heap and buffers - which is the one process a game's pictures
- * are not in.
- *
- * Comments in English per project convention.
- */
-/** What a process is for, in the words a reader of a memory report needs. */
-type GameProcessKind = "main" | "renderer" | "gpu" | "utility" | "other";
-type GameProcessMemoryEntry = {
-	kind: GameProcessKind;
-	/**
-	 * What the platform calls it, when it says: a utility process names its service ("Network
-	 * Service", "Audio Service", a sidecar's own name). Absent for the rest.
-	 */
-	name?: string;
-	/** Whether this is the process the asking page runs in. */
-	current: boolean;
-	/** Memory currently resident in physical RAM, in bytes. */
-	workingSetBytes: number;
-	/** The most this process has ever had resident, in bytes. */
-	peakWorkingSetBytes: number;
-	/** Memory no other process shares, in bytes. Windows reports it; other platforms do not. */
-	privateBytes?: number;
-};
-type GameProcessMemoryReading = {
-	/**
-	 * What the processes below add up to.
-	 *
-	 * - `game` - every process the game is made of. A packaged game and a preview.
-	 * - `window` - only the process that draws this window. Dev Mode: the window is Studio's, and
-	 *   the processes around it (Studio's main process, its GPU process, its other windows) are
-	 *   shared with everything else Studio has open, so counting them would report Studio.
-	 */
-	scope: "game" | "window";
-	processes: GameProcessMemoryEntry[];
-	/** The sum of every process's working set, in bytes. */
-	workingSetBytes: number;
-	/** The sum of every process's private bytes, or null where the platform does not report them. */
-	privateBytes: number | null;
-};
-declare const UI_INPUT_POINTER_GESTURES: readonly [
-	"click",
-	"doubleClick",
-	"rightClick",
-	"wheelUp",
-	"wheelDown",
-	"wheelLeft",
-	"wheelRight",
-	"longPress",
-	"middleClick"
-];
-type UIInputPointerGesture = (typeof UI_INPUT_POINTER_GESTURES)[number];
-type UIInputBinding = {
-	kind: "pointer";
-	gesture: UIInputPointerGesture;
-} | {
-	kind: "key";
-	key: string;
-} | {
-	kind: "gamepad";
-	button: string;
-};
-type UIInputActionDef = {
-	id: string;
-	/** Author-facing name. */
-	name: string;
-	/** The bindings a surface gets unless it overrides them. */
-	bindings: UIInputBinding[];
-};
-type UISurfaceActionEnablement = {
-	actionId: string;
-	/** Whether firing this action stops the input here. Default true. */
-	consume?: boolean;
-};
-declare const UI_PAGE_ANIMATION_PRESETS: readonly [
-	"none",
-	"fade",
-	"slide",
-	"push",
-	"zoom",
-	"pop",
-	"blur"
-];
-declare const UI_PAGE_ANIMATION_DIRECTIONS: readonly [
-	"auto",
-	"left",
-	"right",
-	"up",
-	"down",
-	"angle"
-];
-type UIPageAnimationPreset = (typeof UI_PAGE_ANIMATION_PRESETS)[number];
-type UIPageAnimationDirection = (typeof UI_PAGE_ANIMATION_DIRECTIONS)[number];
-type UIPageAnimationSettings = {
-	enter: UIPageAnimationPreset;
-	exit: UIPageAnimationPreset;
-	enterDirection: UIPageAnimationDirection;
-	exitDirection: UIPageAnimationDirection;
-	enterAngleDegrees: number;
-	exitAngleDegrees: number;
-	enterDurationSeconds: number;
-	exitDurationSeconds: number;
-	/** Held before this host's own enter starts, counted from the moment its subtree begins entering. */
-	enterDelaySeconds: number;
-	/** Held before this host's own exit starts, counted from the moment its subtree begins exiting. */
-	exitDelaySeconds: number;
-	/** Added to each successive direct child, so a row of children arrives (and leaves) one after another. */
-	childStaggerSeconds: number;
-	/** Hold this host's own exit until every child has finished leaving. Chains through nested parents. */
-	exitWaitsForChildren: boolean;
-	/** Surfaces only: hold the incoming Page until this exit has finished. */
-	exitBlocking: boolean;
-};
-type UISurfaceBackgroundFillMode = "cover" | "contain" | "stretch" | "tile";
-type UISurfaceBackgroundImage = {
-	/** Image library asset id. Absent background = absent field, so this is never empty. */
-	assetId: string;
-	fillMode: UISurfaceBackgroundFillMode;
-};
-type UIDocumentVersion = number;
-type UIDocumentId = string;
-type UISurfaceId = string;
-type UIElementId = string;
-type UIDocument = {
-	schemaVersion: UIDocumentVersion;
-	id: UIDocumentId;
-	name: string;
-	surfaces: UISurface[];
-	components?: UIComponentDefinition[];
-	elements: Record<UIElementId, UIElement>;
-	/**
-	 * The shapes this document's widgets describe their data with, keyed by id.
-	 *
-	 * No authoring surface manages this table: an author edits the fields on the widget that uses
-	 * them, and a widget stores only the id. It is a document-level table rather than a copy on each
-	 * widget so that a shape has one spelling for the whole project - which is what lets one list's
-	 * content feed another's, and what a Break node's pins are generated from. The rules that keep
-	 * an implicit library safe to edit are in `struct.ts`.
-	 */
-	structs?: Record<UIStructId, UIStructDef>;
-	/**
-	 * What the gestures of this project mean, keyed by id.
-	 *
-	 * The vocabulary half of the input model: "advance", "skip", "open the menu" - named once for
-	 * the whole project, with the bindings a surface gets unless it says otherwise. A surface stores
-	 * only the id, in {@link UISurface.actions}, so renaming an action here renames it everywhere
-	 * and rebinding it rebinds every surface that took the default. The rules are in
-	 * `inputAction.ts`.
-	 */
-	actions?: Record<string, UIInputActionDef>;
-	/**
-	 * The page the game starts on, by id.
-	 *
-	 * Absent means the page carrying `MAIN_APP_SURFACE_ID` - the id a new document gives its first
-	 * page, and the only entry a document had before this field existed - so a document whose author
-	 * never moved the entry stays exactly as short as it was. Read only through `resolveEntrySurface`
-	 * (`entrySurface.ts`), which also says what a pointer that has lost its page falls back to.
-	 *
-	 * A pointer rather than an id swap: a page's id is what its blueprints are filed under and what
-	 * every `Go Page` names, so making another page the entry must not change which id it has.
-	 *
-	 * Carries no schema bump, for the reason `actions` and `structs` did not: absence already means a
-	 * defined answer, so a document written before this field reads correctly without one.
-	 */
-	entrySurfaceId?: UISurfaceId;
-	meta?: UIDocumentMeta;
-};
-type UIDocumentMeta = {
-	createdAt?: string;
-	updatedAt?: string;
-};
-type UIHost = "app" | "player";
-type UISurfaceKind = "appSurface" | "stageSurface";
-type UIStageSlotId = "onStage" | "dialog" | "notification" | "choice" | "nvl";
-type UIStageSurfaceMount = {
-	kind: "slot";
-	slotId: UIStageSlotId;
-};
-type UIAppSurface = {
-	id: UISurfaceId;
-	name: string;
-	host: "app";
-	kind: "appSurface";
-	designSize: UISurfaceDesignSize;
-	rootElementId: UIElementId;
-	settings?: UISurfaceSettings;
-	/**
-	 * Which of the project's actions this surface answers. An id here names an entry of
-	 * {@link UIDocument.actions}; absent means it answers none of them.
-	 *
-	 * Input that lands on this surface's content stops here whether or not an action answered it,
-	 * unless the action that answered says otherwise. There is no surface-wide setting for that: a
-	 * surface drawn over another is drawn over it, and an action is the only thing that knows
-	 * whether what it just did leaves anything for the surface behind to do.
-	 */
-	actions?: UISurfaceActionEnablement[];
-	/** The values this page is opened with, in author order. See {@link UIPageParam}. */
-	params?: UIPageParam[];
-};
-type UIPageParam = {
-	id: string;
-	name: string;
-	type: UIPageParamType;
-	/**
-	 * For a `list`: the shape each row has, as a struct id (an engine shape such as `nl.confirmButton`,
-	 * a plugin's, or one of the project's). It types the value on both ends - the inputs that give it
-	 * and `Get Page Param` - and a list on the page bound to it is checked against it. Absent for
-	 * every other type, and for a list of rows of no declared shape.
-	 */
-	struct?: string;
-	/**
-	 * What the page reads when whoever opened it gave nothing for this name, in the declared type.
-	 * Absent reads as the type's empty value (`uiPageParamDefaultValue`).
-	 */
-	defaultValue?: unknown;
-};
-type UIPageParamType = "string" | "text" | "number" | "boolean" | "list" | "json";
-type UIStageSurface = {
-	id: UISurfaceId;
-	name: string;
-	host: "player";
-	kind: "stageSurface";
-	designSize: UISurfaceDesignSize;
-	rootElementId: UIElementId;
-	settings?: UISurfaceSettings;
-	mount: UIStageSurfaceMount;
-	slots?: Record<string, UISlotDefinition>;
-	/** @see UIAppSurface.actions */
-	actions?: UISurfaceActionEnablement[];
-};
-type UISurface = UIAppSurface | UIStageSurface;
-type UISurfaceDesignSize = {
-	width: number;
-	height: number;
-};
-type UISurfaceSettings = {
-	backgroundColor?: string;
-	/**
-	 * Painted over {@link backgroundColor}, inside the design area only - the letterbox bars around
-	 * a scaled Surface keep showing the colour, so the two settings are not alternatives.
-	 */
-	backgroundImage?: UISurfaceBackgroundImage;
-	pageAnimation?: UIPageAnimationSettings;
-	/**
-	 * What the asset set this Surface's own background names resolves to, per locale. Build-written
-	 * exactly as {@link UIElement.assetVariants} is, and here rather than on the Surface so the
-	 * answer sits beside the only asset a Surface names by itself.
-	 */
-	assetVariants?: AssetVariantMap;
-};
-type UISlotDefinition = {
-	id: string;
-	name: string;
-	rootElementId?: UIElementId;
-};
-type UIComponentId = string;
-type UIComponentDefinition = {
-	id: UIComponentId;
-	name: string;
-	rootElementId: UIElementId;
-	elements: Record<UIElementId, UIElement>;
-	/** Declared in the component's own inspector; each instance supplies its own values. */
-	params?: UIComponentParam[];
-	previewMeta?: {
-		width?: number;
-		height?: number;
-	};
-	createdAt?: string;
-	updatedAt?: string;
-};
-type UIComponentParam = {
-	/** Stable identity. Blueprints and instance values reference this, so renaming `name` is free. */
-	id: string;
-	/** What the author called it, shown in the instance's inspector. */
-	name: string;
-	type: UIComponentParamType;
-	/**
-	 * Used by an instance that has not overridden it, and by the definition's own preview. For a
-	 * `text` parameter these are words written directly, translated through the definition's own unit
-	 * (`uiComponentParamUnitId(componentId, paramId)`).
-	 */
-	defaultValue: string;
-};
-type UIComponentParamType = "string" | "text";
-type UIElement = {
-	id: UIElementId;
-	type: string;
-	name?: string;
-	parentId: UIElementId | null;
-	childrenIds: UIElementId[];
-	layout: UILayout;
-	style?: UIStyle;
-	props?: Record<string, unknown>;
-	valueBindings?: Record<string, UIElementValueBinding>;
-	/**
-	 * How this element arrives and leaves - the same record a Surface uses for its page animation.
-	 * Absent means it does neither. Read it through `elementAnimation.ts` rather than directly.
-	 *
-	 * Its own field rather than a `props` key, because it belongs to the placement and not to the
-	 * widget: every type has one, no renderer reads it, and a linked component instance may set it
-	 * even though its props come from the definition.
-	 */
-	animation?: UIPageAnimationSettings;
-	extra?: Record<string, unknown>;
-	/**
-	 * What each asset set THIS element names resolves to, per locale.
-	 *
-	 * **Never authored and never on disk under `editor/`.** It is written while a package is being
-	 * assembled (`@shared/build/uiAssetSets`) and exists only in the bundle a game runs from, which
-	 * is why editing a widget cannot produce one and why version control never sees it.
-	 *
-	 * It sits on the element rather than in a document-wide table for the reason the story row's
-	 * copy gives: a table would enumerate every localized asset the project has, which is the one
-	 * thing a protected pack refuses to disclose. One element discloses the variants of the sets
-	 * that element itself uses, which is what drawing the widget already discloses.
-	 *
-	 * Keyed by the set id the props still name - the prop keeps the set id, so a widget whose map is
-	 * missing fails loudly at a resolver rather than quietly fetching one language's picture.
-	 */
-	assetVariants?: AssetVariantMap;
-};
-type UIElementValueBindingValueType = "string" | "json" | "float" | "boolean";
-type UIElementValueBinding = {
-	kind: "blueprintValue";
-	blueprintId: string;
-	valueType: UIElementValueBindingValueType;
-}
-/**
- * Read one declared field of the list item this element is being drawn for.
- *
- * The whole reason the struct model exists. Reaching a row's own data used to take a private
- * blueprint per element - Get List Item Props into Get JSON Field with the key typed into a
- * string pin - which is three abstractions deep for "show the title". This is the same read with
- * none of them: the field is picked from a dropdown, and an element outside an item template
- * simply has nothing to bind to.
- *
- * No `valueType` of its own. The field declares one and the bound prop declares one, and the
- * conversion between them belongs to the target, not to the binding - the same reason the
- * slider's binding does not restate that a slider holds a number.
- */
- | {
-	kind: "listItemField";
-	fieldId: string;
-}
-/**
- * Show the value one placement gives a text parameter of the component this element is part of.
- *
- * The component's counterpart of `listItemField`, and the same kind of read: no graph, nothing
- * kept alive - the value is taken from the placement being drawn (`resolveUIComponentTextParams`),
- * so the editing canvas draws each placement with its own words, and the game translates each
- * through the placement's own unit or reads the key it names. Only a text parameter answers one,
- * and only a widget's words take one; outside a placement (the component's own editor) the
- * element's own words are drawn, as sample text.
- */
- | {
-	kind: "componentParam";
-	paramId: string;
-}
-/**
- * Show the value the page this element is on was opened with for one of its text parameters.
- *
- * The page's counterpart of `componentParam`, read the same way: no graph - the value is taken from
- * the props the page was opened with (`resolveUIPageTextParams`), words given at the opening shown
- * as given, the declared default translated through the page's own unit. Only a text parameter
- * answers one, only a widget's words take one, and only on a page: a component's insides and a
- * Game UI have no page parameters to show. The editing canvas, where the page has not been opened,
- * draws the default, or the element's own words as sample text while the default is empty.
- */
- | {
-	kind: "pageParam";
-	paramId: string;
-};
-type UILayout = {
-	x: number;
-	y: number;
-	width: number;
-	height: number;
-	rotation?: number;
-	opacity?: number;
-	visible?: boolean;
-	/** When true, width and height stay proportional in the inspector and on-canvas resize. */
-	lockAspectRatio?: boolean;
-};
-type UIStyle = Record<string, unknown>;
-type GameTestLogLevel = "verbose" | "info" | "success" | "warning" | "error";
-type GameTestExitReason = 
-/** Closed from inside the game - the window's own close, or the engine quitting itself. */
-"closed-by-user"
-/** The host asked: an explicit stop, or the run being cancelled. */
- | "stopped-by-host"
-/** Non-zero exit code, a fatal signal, or an uncaught exception in the game's main process. */
- | "crashed"
-/** Never got far enough to run: compile failed, or the runner binary would not spawn. */
- | "failed-to-start";
-type GameTestExit = {
-	reason: GameTestExitReason;
-	code: number | null;
-	signal: string | null;
-};
-type GameTestChoiceOption = {
-	index: number;
-	text: string;
-	/** Offered but not selectable: the option's `disabledWhen` condition holds. */
-	disabled: boolean;
-};
-type GameTestEvent = {
-	kind: "console";
-	level: GameTestLogLevel;
-	source: string;
-	message: string;
-}
-/**
- * An uncaught error inside the running game - `window.onerror` / `unhandledrejection` in its
- * renderer, `uncaughtException` / `unhandledRejection` in its main process. The game runtime had
- * no such hook before this pipeline; an uncaught renderer exception was reported nowhere.
- */
- | {
-	kind: "runtime-error";
-	scope: "renderer" | "main";
-	message: string;
-	stack?: string;
-}
-/** The engine reached an ending (`event:state.end`), forwarded out of the game's renderer. */
- | {
-	kind: "game-end";
-}
-/**
- * An `/ending` row ran, naming the ending it declares.
- *
- * Beside `game-end` rather than replacing it: `game-end` also fires for a story that simply ran
- * out of rows, which has no ending to name. A test whose pass condition is "*this* ending" can
- * only be written against this one.
- */
- | {
-	kind: "ending";
-	endingId: string;
-	name: string;
-}
-/**
- * A choice menu is on screen, with every option it evaluated.
- *
- * Fires each time a menu mounts, so a rollback into the same choice reports it again. The list
- * is what `choose` addresses; see {@link GameTestChoiceOption}.
- */
- | {
-	kind: "choice";
-	options: GameTestChoiceOption[];
-} | {
-	kind: "exit";
-	exit: GameTestExit;
-};
-type GameTestCommand = 
-/**
- * Begin a story at a scene.
- *
- * Necessary because a test session boots to the main app surface - the title screen - and no
- * story runs until something starts one. The caller supplies the target, exactly as the
- * blueprint behind a Start button does.
- */
-{
-	kind: "start";
-	storyId: string;
-	sceneId: string;
-}
-/** One click on the dialogue: finish the line being typed, or move to the next. */
- | {
-	kind: "advance";
-}
-/** Pick an option of the choice currently on screen, by the index the `choice` event reported. */
- | {
-	kind: "choose";
-	index: number;
-};
-type UITemplateSurfacePlacement = {
-	kind: UISurfaceKind;
-	/** Required for `stageSurface`; the game-UI slot the surface mounts into. */
-	slotId?: UIStageSlotId;
-};
-interface AssetTransferManifestEntry {
-	/**
-	 * The asset's id in the source project, which the importing project reuses.
-	 *
-	 * Reusing it is what lets the rows that travelled alongside keep pointing at their files
-	 * without being rewritten, and it makes a second paste of the same clipboard a no-op: the id
-	 * is already in the library, so there is nothing to import.
-	 */
-	assetId: string;
-	/** Author-facing file name, extension included: what the file is called once imported. */
-	fileName: string;
-	/**
-	 * The `AssetType` value as a string.
-	 *
-	 * Structural for the reason `assetSet.ts` gives for the same field: the enum lives under the
-	 * renderer and cannot be imported here.
-	 */
-	type: string;
-	/** Size in bytes, when the offering side already knew it. */
-	size?: number;
-	/**
-	 * Whether the payload is a directory rather than a single file.
-	 *
-	 * True for model bundles, the one asset type whose contents are a tree. It decides both halves
-	 * of the transfer: the grant covering the entry reaches everything below the path, and the
-	 * importing project copies the tree instead of writing bytes.
-	 */
-	isDirectory?: boolean;
-}
 declare const en: {
 	readonly common: {
 		readonly appName: "NarraLeaf Studio";
@@ -3152,6 +1822,16 @@ declare const en: {
 				readonly other: "{count} info";
 			};
 		};
+		readonly flowCanvas: {
+			readonly nodeHelp: "Press Enter or Space to select a node. Press Delete to remove it and Escape to cancel.";
+			readonly movableNodeHelp: "Press Enter or Space to select a node, then move it with the arrow keys. Press Delete to remove it and Escape to cancel.";
+			readonly wireHelp: "Press Enter or Space to select a wire. Press Delete to remove it and Escape to cancel.";
+			readonly nodeMoved: "Moved the selected node {direction}. Position x {x}, y {y}";
+			readonly up: "up";
+			readonly down: "down";
+			readonly left: "left";
+			readonly right: "right";
+		};
 	};
 	readonly menu: {
 		readonly app: {
@@ -3995,6 +2675,8 @@ declare const en: {
 				readonly characterSpeaker: "Character";
 				readonly scenesGroup: "Scenes";
 				readonly sceneSpeaker: "Scene";
+				readonly endingsGroup: "Endings";
+				readonly endingSpeaker: "Ending";
 				readonly addKey: "Add";
 				readonly keyNamePlaceholder: "Key (menu.start\u2026)";
 				readonly keySourcePlaceholder: "Source text";
@@ -4037,6 +2719,24 @@ declare const en: {
 				readonly statusReviewed: "Reviewed";
 				readonly statusStale: "To review";
 				readonly findPlaceholder: "Find in translations";
+				readonly orphans: {
+					readonly source: "Orphan translations ({count})";
+					readonly summary: {
+						readonly one: "{count} translation belongs to a line that is not in the game";
+						readonly other: "{count} translations belong to lines that are not in the game";
+					};
+					readonly none: "No orphan translations";
+					readonly disabledLine: "Disabled line";
+					readonly deletedLine: "Deleted line";
+					readonly delete: "Delete";
+					readonly deleteAll: "Delete all";
+					readonly deleteConfirm: {
+						readonly one: "Delete {count} orphan translation?";
+						readonly other: "Delete {count} orphan translations?";
+					};
+					readonly deleteDetail: "This cannot be undone. A line that is enabled or restored later needs translating again.";
+					readonly unknown: "A story cannot be read, so orphan translations are not listed.";
+				};
 			};
 			readonly live: {
 				readonly entryClaimed: "{name} is translating this line";
@@ -4128,6 +2828,21 @@ declare const en: {
 				readonly notePlaceholder: "Note\u2026";
 				readonly dropHint: "Drop audio to assign";
 				readonly findPlaceholder: "Find in lines";
+				readonly orphans: {
+					readonly source: "Orphan voice ({count})";
+					readonly summary: {
+						readonly one: "{count} recording is linked to a line that is not in the game";
+						readonly other: "{count} recordings are linked to lines that are not in the game";
+					};
+					readonly none: "No orphan voice";
+					readonly removeAll: "Remove all";
+					readonly removeConfirm: {
+						readonly one: "Remove {count} orphan recording?";
+						readonly other: "Remove {count} orphan recordings?";
+					};
+					readonly removeDetail: "The audio files stay in the asset library. A line that is enabled or restored later needs its audio assigned again.";
+					readonly unknown: "A story cannot be read, so orphan voice is not listed.";
+				};
 			};
 		};
 		readonly textSourceMigration: {
@@ -6088,6 +4803,9 @@ declare const en: {
 			readonly pip: "Picture-in-picture";
 			readonly selectRow: "Select a story row to preview its stage state.";
 			readonly failed: "Preview failed";
+			readonly settleTimeout: "The stage did not finish setting up in time.";
+			readonly gameUiBlueprintError: "Game UI blueprint error: {message}";
+			readonly previousSessionError: "Previous preview session: {message}";
 			readonly playFromHere: "Play from here";
 			readonly restart: "Restart";
 			readonly stop: "Stop playback";
@@ -6537,6 +5255,7 @@ declare const en: {
 			readonly parallel: "Parallel";
 			readonly race: "Race, first to finish";
 			readonly sequence: "In order";
+			readonly noWait: "Doesn't wait";
 			readonly nvl: "NVL";
 			readonly menu: "Menu";
 			readonly option: "Option";
@@ -6623,6 +5342,7 @@ declare const en: {
 			readonly vfx: "{operation} ambience {name}";
 			readonly nvl: "NVL block";
 			readonly blueprint: "Blueprint";
+			readonly blueprintNamed: "Blueprint {name}";
 			readonly pluginAction: "Plugin action";
 			readonly cameraOp: {
 				readonly transform: "Camera";
@@ -7222,6 +5942,7 @@ declare const en: {
 		};
 		readonly blueprint: {
 			readonly storyActionTitle: "Story Action";
+			readonly name: "Blueprint name";
 		};
 		readonly audio: {
 			readonly track: "Track";
@@ -7327,13 +6048,9 @@ declare const en: {
 			readonly parallel: "Parallel";
 			readonly race: "Race";
 			readonly repeat: "Repeat";
-			readonly mode: {
-				readonly do: "Do";
-				readonly doAsync: "Do async";
-				readonly all: "All";
-				readonly allAsync: "All async";
-				readonly any: "Any";
-			};
+			readonly rowsAfter: "Rows after";
+			readonly rowsAfterWait: "Start when the group finishes";
+			readonly rowsAfterStart: "Start with the group";
 			readonly times: "Times";
 			readonly loopKind: "Loop";
 			readonly loopKindTimes: "A number of times";
@@ -8127,9 +6844,9 @@ declare const en: {
 			};
 			readonly graph: {
 				readonly noNodes: "Graph has no nodes yet.";
-				readonly pinMultipleInput: "Pin {node}.{port} has multiple input connections; a pin takes one connection.";
-				readonly pinMultipleOutput: "Pin {node}.{port} has multiple output connections; a pin takes one connection.";
-				readonly entryMissingNode: "Entry points to missing node \"{node}\".";
+				readonly pinMultipleInput: "Pin \"{pin}\" has multiple input connections; a pin takes one connection.";
+				readonly pinMultipleOutput: "Pin \"{pin}\" has multiple output connections; a pin takes one connection.";
+				readonly entryMissingNode: "The entry points to a node that does not exist.";
 				readonly entryInvalid: "Function entry not found.";
 			};
 			readonly event: {
@@ -8142,21 +6859,21 @@ declare const en: {
 			};
 			readonly edge: {
 				readonly selfConnection: "Node \"{node}\" cannot connect to itself.";
-				readonly fromUnknown: "Missing source node \"{node}\".";
-				readonly toUnknown: "Missing target node \"{node}\".";
+				readonly fromUnknown: "A wire starts at a node that does not exist.";
+				readonly toUnknown: "A wire ends at a node that does not exist.";
 				readonly portMismatch: "Pin mismatch on {from} \u2192 {to}.";
 				readonly connectionInvalid: "Invalid connection {from} -> {to}.{detail}";
 				readonly connectionTypeDetail: " Type mismatch: {from} -> {to}.";
 			};
 			readonly node: {
-				readonly contextInvalid: "Node \"{name}\" is not allowed in this {ownerKind} {graphKind} graph.{hint}";
+				readonly contextInvalid: "Node \"{name}\" is not allowed in {owner}.{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 noRuntime: "Node \"{node}\" has no runtime.";
 				readonly inputMissing: "\"{node}\" has nothing connected to \"{pin}\".";
 				readonly stepLimit: "\"{head}\" stopped at \"{node}\" after {steps} steps without a wait.";
 				readonly stepLimitGlobal: "\"{head}\" in App logic stopped at \"{node}\" after {steps} steps without a wait.";
-				readonly unknownType: "Node \"{node}\": unknown type \"{type}\". Its plugin may be uninstalled or disabled.";
+				readonly unknownType: "Unknown node type \"{type}\". Its plugin may be uninstalled or disabled.";
 				readonly variableIdInvalid: "Node \"{node}\": pick a variable.";
 				readonly persistentVariableIdInvalid: "Node \"{node}\": pick a persistent variable.";
 				readonly savedVariableIdInvalid: "Node \"{node}\": pick a saved variable.";
@@ -8167,11 +6884,11 @@ declare const en: {
 				readonly pageParamMissing: "\"{node}\": the page does not declare this param.";
 			};
 			readonly fn: {
-				readonly nameMissing: "Fn \"{node}\": set a function name.";
+				readonly nameMissing: "\"{node}\": set a function name.";
 				readonly duplicateName: "Fn name \"{name}\" is used by another function in scope.";
 				readonly returnOrphan: "Fn Return must be reachable from a Fn head.";
 				readonly returnMultipleHeads: "Fn Return is reachable from multiple Fn heads.";
-				readonly returnSignatureConflict: "Fn Return \"{node}\" declares different results than the first Return of this fn.";
+				readonly returnSignatureConflict: "\"{node}\" declares different results than the first Return of this fn.";
 				readonly callUnset: "Node \"{node}\": pick a function.";
 				readonly callTargetNotFound: "Fn \"{name}\" does not exist in this scope.";
 				readonly callSignatureStale: "Function signature changed; re-select \"{name}\" to update its pins.";
@@ -8438,6 +7155,8 @@ declare const en: {
 			readonly removeOutput: "Remove output pin";
 			readonly jsonFieldName: "JSON object field name";
 			readonly readsRow: "Current row";
+			readonly newParamName: "param{n}";
+			readonly newResultName: "result{n}";
 		};
 		readonly comment: {
 			readonly color: {
@@ -9939,6 +8658,9 @@ declare const en: {
 			readonly type: "Type";
 			readonly typeString: "String";
 			readonly typeText: "Text";
+			readonly typeAudioTrack: "Audio track";
+			readonly trackMissing: "Missing track";
+			readonly trackNone: "No track";
 			readonly bindLabel: "Parameter";
 			readonly bindNone: "No parameter";
 			readonly bindMissing: "Missing parameter";
@@ -10046,6 +8768,7 @@ declare const en: {
 			readonly unknown: "Usage could not be determined";
 			readonly unknownDetail: "{location} could not be read";
 			readonly unknownComputed: "{location} picks its asset by a name assembled at run time";
+			readonly defaultFonts: "Default fonts";
 			readonly count: {
 				readonly one: "{count} reference";
 				readonly other: "{count} references";
@@ -10415,6 +9138,7 @@ declare const en: {
 		};
 		readonly row: {
 			readonly nameAria: "Variable name";
+			readonly defaultName: "Variable";
 			readonly defaultPlaceholder: "default";
 			readonly defaultAria: "Default value";
 			readonly delete: "Delete variable";
@@ -10516,6 +9240,8 @@ declare const en: {
 		readonly history: {
 			readonly moveSurface: "move interface {name}";
 			readonly setEntryPage: "set entry page {name}";
+			readonly setRootElement: "set root element {name}";
+			readonly wrapRoot: "wrap {name} in a container";
 			readonly createComponent: "create component {name}";
 			readonly duplicateComponent: "duplicate component {name}";
 			readonly duplicateComponents: "duplicate {count} components";
@@ -10625,6 +9351,9 @@ declare const en: {
 		readonly canvas: {
 			readonly unknownWidget: "Unknown widget";
 			readonly widgetRenderFailed: "Widget failed to draw";
+			readonly componentMissing: "Missing component";
+			readonly componentLoopBlocked: "Component loop blocked";
+			readonly componentRootMissing: "Component root missing";
 			readonly wordsFromRowField: "These words come from the list row field \u201C{field}\u201D.";
 			readonly wordsFromBlueprintValue: "These words come from the blueprint value \u201C{name}\u201D.";
 			readonly wordsFromComponentParam: "These words come from the component parameter \u201C{param}\u201D, set on each placement.";
@@ -10687,6 +9416,14 @@ declare const en: {
 			readonly showSelected: "Show selected";
 			readonly hideSelected: "Hide selected";
 			readonly addToComponentLibrary: "Add to Component Library";
+			readonly setAsRoot: "Set as root element";
+			readonly wrapRootInContainer: "Wrap in container";
+			readonly setAsRootNotContainer: "Available when the root element is a container";
+			readonly setAsRootNotAlone: "Available when this is the only element in the root container";
+			readonly setAsRootNotFree: "Available when the root container's child layout is Free";
+			readonly addedToComponentLibrary: "Added \u201C{name}\u201D to the Component Library.";
+			readonly cannotHoldChildren: "{name} cannot contain child elements";
+			readonly linkedInstanceContents: "The contents of a linked instance are edited in its component";
 			readonly group: "Group";
 			readonly ungroup: "Ungroup";
 			readonly addState: "Add state";
@@ -11804,6 +10541,8 @@ declare const en: {
 			readonly ending: {
 				readonly title: "Page shown when the story ends";
 				readonly none: "Show nothing";
+				readonly unset: "Not chosen";
+				readonly missing: "Deleted page";
 			};
 			readonly usedBy: {
 				readonly one: "Used by {count} reference";
@@ -12007,6 +10746,11 @@ declare const en: {
 				readonly one: "{count} track under it moves to {parent}.";
 				readonly other: "{count} tracks under it move to {parent}.";
 			};
+			readonly builtinName: {
+				readonly bgm: "Music";
+				readonly sound: "SFX";
+				readonly voice: "Voice";
+			};
 			readonly slider: {
 				readonly bgm: "Music volume";
 				readonly sound: "SFX volume";
@@ -13197,7 +11941,7 @@ declare const en: {
 		readonly rootName: "Root";
 		readonly componentName: "Component";
 		readonly pageName: "Page";
-		readonly pageCopy: "{name} Copy";
+		readonly nameCopy: "{name} Copy";
 		readonly speaker: "Speaker";
 		readonly dialog: {
 			readonly interactionLayer: "Dialog Interaction Layer";
@@ -13384,6 +12128,7 @@ declare const en: {
 			readonly contentLabel: "Variant the content comes from";
 			readonly contentHint: "The scenes, variant conditions and art of this variant go into the patch.";
 			readonly sameVariant: "The content and the build it updates are the same variant. The patch carries no changes.";
+			readonly sameProject: "The build it updates is made from the current project. The patch carries no changes. For a build already released, choose An existing build folder.";
 			readonly outputLabel: "Save as";
 			readonly nameLabel: "Name";
 			readonly namePlaceholder: "Shown in the game's log";
@@ -14342,6 +13087,7 @@ declare const en: {
 		};
 		readonly message: {
 			readonly ruleFailed: "{rule} could not run";
+			readonly listSeparator: ", ";
 			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}";
@@ -15228,13 +13974,14 @@ declare const en: {
 				readonly finding: {
 					readonly sceneUnreachable: "No path can satisfy the conditions leading to \"{scene}\"";
 					readonly optionUnreachable: "No path can satisfy the condition for offering \"{option}\"";
+					readonly conditionUnreachable: "No path can satisfy \"{condition}\"";
 					readonly branchUnreachable: "No path can satisfy the condition for taking this branch";
 					readonly endingUnreachable: "\"{name}\" is written but no path can satisfy the conditions to reach it";
 					readonly endingUnreachableUnnamed: "This ending is written but no path can satisfy the conditions to reach it";
 				};
 				readonly summary: {
 					readonly passed: "Everything the script leads to can be reached";
-					readonly failed: "Unreachable: scenes {scenes}, options {options}, endings {endings}";
+					readonly failed: "Unreachable: scenes {scenes}, options {options}, condition branches {conditions}, endings {endings}";
 				};
 			};
 			readonly reachableEndings: {
@@ -15667,6 +14414,19 @@ declare const en: {
 			};
 			readonly preview: "Preview in";
 			readonly excluded: "Not used for {language}";
+			readonly builtin: {
+				readonly group: "Built-in fonts";
+				readonly systemUi: "System UI";
+				readonly sansSerif: "Sans-serif (generic)";
+				readonly serif: "Serif (generic)";
+				readonly monospace: "Monospace (generic)";
+				readonly kind: {
+					readonly system: "System font";
+					readonly sansSerif: "Sans-serif";
+					readonly serif: "Serif";
+					readonly monospace: "Monospace";
+				};
+			};
 		};
 		readonly panel: {
 			readonly add: "Add color";
@@ -15794,6 +14554,10 @@ declare const en: {
 			readonly detail: "It is running in another browser tab. Close that tab, then reload this page.";
 			readonly reload: "Reload";
 		};
+		readonly words: {
+			readonly option: "Option";
+			readonly unknownSpeaker: "Unknown";
+		};
 	};
 	readonly crash: {
 		readonly screen: {
@@ -15836,36 +14600,1366 @@ 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";
-			};
-		};
+	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 = ""> = {
+	[K in keyof T & string]: T[K] extends string ? `${Prefix}${K}` : Flatten<T[K], `${Prefix}${K}.`>;
+}[keyof T & string];
+type TranslationKey = Flatten<Messages> | (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;
+	/**
+	 * Playback gain in decibels, never above 0: the engine cannot raise a clip past its own level, so
+	 * balancing loudness means bringing the loud clips down. Absent is unity. Folded into a volume
+	 * only by {@link clipVolume}.
+	 */
+	gainDb?: number;
+};
+type StoredAudioClipRegion = Pick<AudioClipRegion, "inMs" | "outMs" | "loopStartMs">;
+type StoredAudioGain = {
+	db: 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 BlueprintGraphKind = "event" | "function" | "macro";
+type GameBuildPlatform = "windows" | "macos" | "linux" | "web" | "android" | "ios";
+declare const UI_STRUCT_FIELD_TYPES: readonly [
+	"string",
+	"number",
+	"boolean",
+	"image",
+	"color",
+	"json"
+];
+type UIStructFieldType = (typeof UI_STRUCT_FIELD_TYPES)[number];
+type UIStructField = {
+	/**
+	 * Stable identity. Value bindings, node params and generated pins all address a field by this,
+	 * so renaming `key` costs nothing and reshuffling the list costs nothing.
+	 */
+	id: string;
+	/** The property name this field occupies inside an item object. */
+	key: string;
+	/**
+	 * What the author called it, shown in the item table header and in every field picker.
+	 *
+	 * Optional because `key` is usually already the readable name; a label is what lets a field
+	 * whose key has to stay ASCII (it travels in JSON to a plugin, a save file, a story variable)
+	 * still read as words in the editor.
+	 */
+	label?: string;
+	type: UIStructFieldType;
+};
+type UIStructId = string;
+type UIStructDef = {
+	id: UIStructId;
+	fields: UIStructField[];
+};
+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";
+	/**
+	 * `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";
+	/**
+	 * `app.game.process.memory()` — read how much memory the game's processes hold, as the
+	 * operating system counts it.
+	 *
+	 * Its own capability rather than a member of `diagnostics`, because what it reports is not the
+	 * game's: `diagnostics` describes the engine's caches, which are the game's own bookkeeping,
+	 * while this is the player's machine - how much of its memory every process of the game is
+	 * holding, the main process and the GPU process included. An author who approved the first did
+	 * not approve the second, and a plugin that already holds `diagnostics` must not gain this by
+	 * an update without being asked again - which is what a capability of its own guarantees.
+	 *
+	 * Read-only, and numbers only: sizes and what each process is for, never a path, an id or a
+	 * command line. Nothing is sent anywhere by the host; what a plugin does with a reading is
+	 * visible in the code the author installed.
+	 *
+	 * Absent where there are no processes to count - the web export - and narrowed in Dev Mode to
+	 * the window's own renderer, since everything around it is Studio's.
+	 */
+	readonly ProcessMemory: "process.memory";
+};
+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
+ * to the plugin package root. At least one target must be declared.
+ *
+ * - `studio`: loaded in the workspace window only; talks to the
+ *   `narraleaf-studio/plugin` host API (editor extensions).
+ * - `runtime`: loaded in every game execution environment (Dev Mode window,
+ *   Preview, Production); talks to the `narraleaf-studio/runtime` host API
+ *   (game logic such as blueprint node execute bindings).
+ */
+export type PluginManifestEntries = {
+	studio?: string;
+	runtime?: string;
+};
+type PluginLocaleContribution = {
+	code: string;
+	nativeName?: string;
+	englishName?: string;
+	intl?: string;
+	dir?: "ltr" | "rtl";
+	messages: string;
+};
+type PluginBinaryPlatformKey = string;
+type PluginSidecarTargetContribution = {
+	/** Executable (or, for `kind: "node"`, the .js file) to run. Must appear in `include`. */
+	entry: string;
+	/**
+	 * Everything shipped for this platform. Entries are package-relative paths,
+	 * or `dep:<buildDependencyId>/<path>` to pull an artifact produced by a
+	 * declared build dependency (that is how third-party redistributables that
+	 * we may not vendor ourselves reach the pack).
+	 */
+	include: string[];
+	/**
+	 * `sha256` of every package-relative entry in `include`, hex. Verified at
+	 * install and again at pack time, so a tampered package fails to install
+	 * instead of silently shipping a different binary. `dep:` entries are covered
+	 * by the build dependency's own digest instead.
+	 */
+	sha256: Record<string, string>;
+};
+type PluginSidecarContribution = {
+	/** Prefixed with the plugin id, like every other contributed identifier. */
+	id: string;
+	/**
+	 * `executable` spawns the binary directly and talks to it over stdin/stdout; `node` runs the
+	 * .js as an Electron utility process and talks to it over `process.parentPort`, which is the
+	 * one channel a utility process has - it has no stdin.
+	 */
+	kind: PluginSidecarKind;
+	/**
+	 * Newline-delimited JSON, which is the framing and not the channel: where the frames travel is
+	 * {@link kind}'s business, and only an executable sidecar's travel over stdio. Either way
+	 * stderr stays a plain log channel.
+	 *
+	 * `stdio-jsonl` is the older spelling of the same thing, from when there was only one channel
+	 * it could mean. Manifests that say it keep working and always will - a published plugin is a
+	 * file somebody already shipped - but a new one should say `jsonl`.
+	 */
+	transport: "jsonl" | "stdio-jsonl";
+	/** `onGameStart` spawns with the window; `onRequest` waits for the first call. */
+	autostart: "onGameStart" | "onRequest";
+	/** How long the handshake may take before the sidecar counts as unavailable. */
+	startupTimeoutMs: number;
+	/** Grace period between the shutdown message and SIGTERM. */
+	shutdownTimeoutMs: number;
+	restart: {
+		maxRetries: number;
+		backoffMs: number;
+	};
+	targets: Record<PluginBinaryPlatformKey, PluginSidecarTargetContribution>;
+};
+type PluginBuildDependencyTargetContribution = {
+	url: string;
+	/** Mandatory. Doubles as the cache key, so re-pointing the URL at identical bytes never re-downloads. */
+	sha256: string;
+	archive: "zip";
+	/** Archive-internal path -> path inside the produced dependency directory. */
+	files: Record<string, string>;
+} | {
+	url: string;
+	sha256: string;
+	archive: "none";
+	/** Name the downloaded file takes inside the produced dependency directory. */
+	fileName: string;
+};
+type PluginBuildDependencyContribution = {
+	/** Prefixed with the plugin id. Referenced from sidecar `include` as `dep:<id>/<path>`. */
+	id: string;
+	/** Shown to the author at install and in build logs; say what the binaries are. */
+	description?: string;
+	targets: Record<PluginBinaryPlatformKey, PluginBuildDependencyTargetContribution>;
+};
+declare const PLUGIN_BUILD_CONFIG_TYPES: readonly [
+	"text",
+	"secret"
+];
+type PluginBuildConfigType = (typeof PLUGIN_BUILD_CONFIG_TYPES)[number];
+declare const PLUGIN_BUILD_CONFIG_SCOPES: readonly [
+	"global",
+	"variant",
+	"platform",
+	"variant-platform"
+];
+type PluginBuildConfigScope = (typeof PLUGIN_BUILD_CONFIG_SCOPES)[number];
+type PluginBuildConfigFieldContribution = {
+	/** Unique within the plugin. Keys the stored value; never displayed. */
+	key: string;
+	/** Author-facing name of the field. */
+	label: string;
+	/** One line saying what the value is for. */
+	description?: string;
+	/** `text` is stored in the project; `secret` is not - the project stores a handle. */
+	type: PluginBuildConfigType;
+	/** Which builds share one value. */
+	scope: PluginBuildConfigScope;
+	/** Platforms the field applies to. Absent means every platform. */
+	platforms?: GameBuildPlatform[];
+	/** A build that would ship without a value for this field is refused. */
+	required?: boolean;
+};
+export type PluginContributes = {
+	/** Blueprint node types this plugin provides (editor def + runtime execute). */
+	blueprintNodes?: string[];
+	/** Widget element types this plugin provides (editor module + runtime renderer). */
+	widgets?: string[];
+	/** Studio language packs: locales this plugin adds or fills. */
+	locales?: PluginLocaleContribution[];
+	/**
+	 * Plugin storage namespaces to publish with the game, readable at runtime
+	 * through `app.game.data.readJson(namespace)`.
+	 *
+	 * Plugin stores live under the project's `editor/` directory, which is never
+	 * packaged. A plugin whose runtime needs authored data (catalogs, tables)
+	 * must list those namespaces here. The list is an explicit allowlist so
+	 * editor-only plugin state cannot leak into a shipped game by accident.
+	 */
+	runtimeData?: string[];
+	/**
+	 * Test ids this plugin registers with `app.services.tests` (see
+	 * `docs/plugin-test-protocol.md`). Declaring them lets the Launcher say what
+	 * a plugin checks before any of its code runs, and registering an
+	 * undeclared id throws at load.
+	 *
+	 * Unlike every other code-backed contribution here, this one derives no
+	 * install permission — a test only ever executes because the author picked
+	 * it out of the Run > Test dialog and pressed Start, so there is no ambient
+	 * capability to consent to at install time.
+	 */
+	tests?: string[];
+	/**
+	 * Save ids the plugin keeps for its own bookkeeping - a quick-save slot, a checkpoint - rather
+	 * than slots a player chose.
+	 *
+	 * The game leaves them out of `List Saves`, and so out of every save screen built on it, the way
+	 * it leaves out its own autosave ring. Nothing else changes for them: the plugin still writes,
+	 * loads and finds them through `app.game.saves` (whose `listIds` is the raw store listing and
+	 * still includes them), and the explicit-id save nodes - `Load Save`, `Delete Save`, the
+	 * `Get Save` readers - take them like any other id.
+	 *
+	 * Prefixed with the plugin id like the type lists above, so a plugin can only reserve ids in its
+	 * own namespace and can never hide a slot the author's own `Save Game` wrote. That is also why it
+	 * derives no install permission: it reaches nothing the plugin did not already own.
+	 */
+	reservedSaveIds?: string[];
+	/**
+	 * Capability domains the `runtime` entry may use. Each maps 1:1 onto a
+	 * namespace on `app.game`, and an undeclared domain is absent from that
+	 * object rather than present-and-throwing — so what the install prompt
+	 * listed and what the plugin can reach are the same set by construction.
+	 */
+	runtimeCapabilities?: PluginRuntimeCapability[];
+	/** Native child processes shipped inside the author's game. */
+	sidecars?: PluginSidecarContribution[];
+	/** External binaries fetched (and cached) at build time. */
+	buildDependencies?: PluginBuildDependencyContribution[];
+	/**
+	 * Values the author supplies before a build can ship. Declaration only - see
+	 * {@link PluginBuildConfigFieldContribution} for why there is no registration API and why this
+	 * grants the plugin nothing.
+	 */
+	buildConfig?: PluginBuildConfigFieldContribution[];
+	/**
+	 * Address patterns this plugin may hand to the player's browser or platform handler, through
+	 * `app.game.navigation.openExternal`.
+	 *
+	 * Unlike everything else here, this one is *not* a list of identifiers the plugin owns - it is a
+	 * list of places outside the game it may reach, so it derives an install permission the author
+	 * approves by name (see `PluginInstallPermission` `kind: "externalLink"`) and adding one to a
+	 * later version re-prompts.
+	 *
+	 * Patterns are matched structurally, never as strings: see `isExternalLinkPatternDeclared` in
+	 * `@shared/types/externalLinkPattern` for the exact semantics. Wildcards are allowed
+	 * (`https://*.example.com/app/*`) and the scheme is not restricted to `http(s)`, because the
+	 * storefronts a plugin integrates with speak their own (`steam://run/480`). A handful of schemes
+	 * are refused at validation whatever a manifest says; that list and its reasoning live in the
+	 * same module.
+	 *
+	 * This is separate from, and grants nothing towards, {@link network}: opening a page and
+	 * fetching bytes are different acts, and the Open Link node the author writes is a third thing
+	 * again, governed only by its scheme.
+	 */
+	externalLinks?: string[];
+	/**
+	 * Address patterns this plugin's runtime code requests bytes from.
+	 *
+	 * Like {@link externalLinks} and unlike everything else here, this is a list of places outside
+	 * the game rather than identifiers the plugin owns, so it derives an install permission the
+	 * author approves by name (`PluginInstallPermission` `kind: "network"`) and adding one to a
+	 * later version re-prompts.
+	 *
+	 * Two rules narrower than the external-link patterns, both for the same reason - what comes
+	 * back from a fetch runs inside the game, while an opened page does not:
+	 *
+	 *  - **`http(s)` only.** There is no storefront-scheme case here; a plugin that fetches speaks
+	 *    HTTP.
+	 *  - **The path is written out.** `https://api.example.com/*` is a declaration and
+	 *    `https://api.example.com` is not, because the pattern language reads the second as the
+	 *    single path `/`. It is refused rather than rewritten: this string is what the install
+	 *    prompt shows, and a manifest whose text differs from what was approved is the one thing
+	 *    this whole mechanism exists to prevent.
+	 *
+	 * What this reaches is *not* widened by the project's own network allowlist and does not widen
+	 * it. A build narrowed to a list still reaches these hosts - the author approved them at
+	 * install - and the list shows them attributed to this plugin rather than quietly making room.
+	 */
+	network?: string[];
+	/**
+	 * The props of a contributed widget that hold words a player reads, by widget type.
+	 *
+	 * Each type named here must also be in {@link widgets}. A declared prop is treated as Studio's own
+	 * text and button labels are: the properties panel offers its words written directly or read
+	 * from a translation key, the canvas draws a key's words, the words go into the project's
+	 * translation table and exports, the project checks report a missing translation or key, and
+	 * the glyph check reads them. In the game the widget's renderer is handed the words already in
+	 * the player's language, in the prop it declared - it never resolves a key itself.
+	 *
+	 * Declared in the manifest rather than at registration because both entries need it - the
+	 * studio entry's widget is edited by it and the runtime entry's is drawn by it - and a
+	 * declaration only one of them made would be the half that drifts.
+	 */
+	widgetText?: Record<string, PluginWidgetTextContribution[]>;
+	/**
+	 * The shapes of the rows this plugin's nodes hand out, so a list can be given one and a field
+	 * read from one by name.
+	 *
+	 * A node pin carrying them says `struct:<id>` or `array<struct:<id>>` - `Get Gallery` answers
+	 * `array<struct:narraleaf.gallery.entry>` - and from then on the plugin's rows are what the
+	 * engine's own are: a list picks the shape under Edit content and its fields are the plugin's
+	 * and locked, Get Field offers them, and a list handed rows that lack them is reported.
+	 *
+	 * Declared in the manifest rather than at registration because the editor, the running game and
+	 * the command-line checker all need the shape, and only the manifest is read by all three before
+	 * any plugin code runs. Ids must start with the plugin id.
+	 */
+	structs?: PluginStructContribution[];
+};
+type PluginStructContribution = {
+	/** Prefixed with the plugin id: `narraleaf.gallery.entry`. */
+	id: string;
+	/** What the editor calls the shape - "Gallery entry". */
+	name: string;
+	/** `name` per editor locale, matched exactly as `localized` names are. */
+	localized?: Record<string, string>;
+	/** In the order the rows are read: the list's content editor shows them in this order. */
+	fields: {
+		key: string;
+		type: UIStructFieldType;
+	}[];
+};
+/**
+ * One prop of a contributed widget whose value is words a player reads.
+ *
+ * `keyProp` is the prop the widget's translation key is kept in when the author reads the words from
+ * one. It defaults to `<prop>LocalizationKey`, and it is the host's to write: the widget never reads it
+ * to draw, because the words in `prop` already come from the key when there is one.
+ */
+export type PluginWidgetTextContribution = {
+	/** The prop holding the words. */
+	prop: string;
+	/** The prop the translation key is kept in; `<prop>LocalizationKey` when not declared. */
+	keyProp?: string;
+	/** What the properties panel calls the words. The prop name when not declared. */
+	label?: string;
+	/** `label` per editor locale, matched exactly as `localized` names are. */
+	localized?: Record<string, string>;
+	/** Whether the words may run over several lines; one line when not declared. */
+	multiline?: boolean;
+};
+/**
+ * The plugin's name and description in one editor language. Either may be left out, and the plain
+ * manifest field is shown in its place.
+ */
+export type PluginManifestLocalizedText = {
+	name?: string;
+	description?: string;
+};
+/**
+ * `name` and `description` per editor locale, keyed by the exact code Studio's language setting
+ * stores (`zh`, `ja`, or a code a language pack adds). There is no region matching: an entry under
+ * `zh-CN` is never shown, because no Studio locale is called that.
+ */
+export type PluginManifestLocalized = Record<string, PluginManifestLocalizedText>;
+export type PluginManifestV2 = Omit<PluginIdentity, "id" | "name" | "version"> & Required<Pick<PluginIdentity, "id" | "name" | "version">> & {
+	manifestVersion: typeof PluginManifestVersion;
+	description?: string;
+	/**
+	 * Translations of `name` and `description`, shown wherever Studio names the plugin to an author
+	 * whose editor is set to that language. The plain fields stay the plugin's identity: command
+	 * lines, project files and built games name it by them.
+	 */
+	localized?: PluginManifestLocalized;
+	/**
+	 * Package-relative path to the thumbnail shown beside the plugin's name in
+	 * the Launcher list. Square, at most 512x512, and one of the extensions in
+	 * `PLUGIN_ICON_EXTENSIONS`. Plugins without one keep the name monogram.
+	 */
+	icon?: string;
+	entries: PluginManifestEntries;
+	contributes?: PluginContributes;
+	permissions?: PluginInstallPermission[];
+};
+export type NormalizedPluginManifestV2 = PluginManifestV2 & {
+	contributes: Required<PluginContributes>;
+	permissions: PluginInstallPermission[];
+};
+type PluginInstallSource = {
+	kind: "local-directory";
+	path: string;
+} | {
+	kind: "builtin";
+	path: string;
+} | {
+	kind: "registry";
+	url: string;
+};
+export type PluginInstallRecord = {
+	pluginId: string;
+	installPath: string;
+	enabled: boolean;
+	builtIn: boolean;
+	manifest: NormalizedPluginManifestV2;
+	installSource: PluginInstallSource;
+	installedAt: number;
+	updatedAt: number;
+	grantedManifestVersion?: string | null;
+	/**
+	 * The permission set the user actually approved, recorded so a later version
+	 * that does not widen it can inherit the grant instead of re-prompting.
+	 * Absent on records written before this was tracked — the manifest at
+	 * `grantedManifestVersion` is the fallback source of truth for those.
+	 */
+	grantedPermissions?: PluginInstallPermission[] | null;
+	lastError?: string | null;
+};
+type PluginStatus = "enabled" | "disabled" | "needsAuthorization" | "error";
+export type PluginListItem = {
+	pluginId: string;
+	manifest: NormalizedPluginManifestV2;
+	/**
+	 * `app://` address of the declared icon, absent when the plugin ships none.
+	 * Resolved here rather than in the renderer because only the main process
+	 * knows where the package landed on disk.
+	 */
+	iconUrl?: string;
+	installPath: string;
+	enabled: boolean;
+	builtIn: boolean;
+	status: PluginStatus;
+	installSource: PluginInstallSource;
+	installedAt: number;
+	updatedAt: number;
+	grantedManifestVersion?: string | null;
+	lastError?: string | null;
+};
+/** Descriptor handed to the workspace window: plugins with a studio entry. */
+export type WorkspacePluginDescriptor = {
+	plugin: PluginIdentity;
+	manifest: NormalizedPluginManifestV2;
+	entryUrl: string;
+};
+/** Descriptor handed to game execution environments: plugins with a runtime entry. */
+export type RuntimePluginDescriptor = {
+	plugin: PluginIdentity;
+	manifest: NormalizedPluginManifestV2;
+	entryUrl: string;
+	/**
+	 * Published plugin storage, keyed by the namespaces declared in
+	 * `contributes.runtimeData`. Absent namespaces simply have no entry - a
+	 * plugin must tolerate missing data (the project may never have written it).
+	 */
+	data?: Record<string, unknown>;
+	/**
+	 * This plugin's own `contributes.buildConfig` values, as the build that produced the pack
+	 * resolved them, keyed by field key. Only ever the declaring plugin's own values: the pack
+	 * holds one record per plugin and a descriptor is built from one entry.
+	 *
+	 * Absent outside a compiled pack - the editor and Dev Mode hand out descriptors that were never
+	 * built for a variant, so there is nothing resolved to carry.
+	 */
+	buildConfig?: Record<string, string>;
+};
+type GameMenuLabel = {
+	readonly key?: string | null;
+	readonly text: string;
+	readonly words?: string | null;
+};
+declare const GAME_MENU_DYNAMIC_SOURCES: readonly [
+	"textLanguage",
+	"voiceLanguage",
+	"windowScale"
+];
+type GameMenuDynamicSource = typeof GAME_MENU_DYNAMIC_SOURCES[number];
+type GameMenuAction = 
+/** Open an app surface as a page. */
+{
+	readonly type: "openPage";
+	readonly surfaceId: string;
+}
+/** Open an app surface as a layer over whatever is on screen. */
+ | {
+	readonly type: "openLayer";
+	readonly surfaceId: string;
+	readonly modal?: boolean;
+	readonly dismissible?: boolean;
+	readonly group?: string | null;
+}
+/** End the playthrough and hand the screen to a page - the same act as the story's quit row. */
+ | {
+	readonly type: "quitToPage";
+	readonly surfaceId: string;
+}
+/**
+ * Close the game.
+ *
+ * The same act as the Quit Application node, which means the same terms: a graceful quit that
+ * does NOT run the author's close handler (`On Window Close Requested` answers the window
+ * frame's own close, and the node deliberately stands the guard aside so a quit the game asked
+ * for is not asked back about). An author who wants their own "really quit?" screen binds a
+ * function instead and calls the node at the end of it - which is the same answer this menu
+ * gives for every other confirmation.
+ */
+ | {
+	readonly type: "quitApp";
+}
+/** Advance the line on screen. */
+ | {
+	readonly type: "next";
+}
+/** Auto-forward on/off. Ticked while on. */
+ | {
+	readonly type: "toggleAutoForward";
+}
+/** Skipping on/off. Ticked while running. */
+ | {
+	readonly type: "toggleSkipping";
+}
+/** Which lines skipping stops at. The two values are a radio pair, never one switch. */
+ | {
+	readonly type: "setSkipReadText";
+	readonly value: boolean;
+}
+/** Show or hide the dialogue box. Ticked while shown. */
+ | {
+	readonly type: "toggleDialog";
+}
+/** Step back one line of history. Greyed out when there is none. */
+ | {
+	readonly type: "historyUndo";
+}
+/** Step forward again after an undo. Greyed out when there is none. */
+ | {
+	readonly type: "historyRedo";
+}
+/** Full-screen on/off. Ticked while full-screen, including when the OS did it. */
+ | {
+	readonly type: "toggleFullscreen";
+}
+/**
+ * Call a function declared in the global blueprint.
+ *
+ * `fnRef` is the catalogue's own reference (see `fnCatalog`), and `args` are keyed by the head's
+ * parameter pin ids. Everything the named actions above do not cover goes through here -
+ * including every confirmation, because what a game asks before losing a playthrough is the
+ * author's screen and not a native box in a language the game may not even be running in.
+ */
+ | {
+	readonly type: "fn";
+	readonly fnRef: string;
+	readonly args?: Readonly<Record<string, unknown>>;
+};
+type GameMenuItemSpec = {
+	readonly kind: "separator";
+} | {
+	readonly kind: "submenu";
+	readonly label: GameMenuLabel;
+	readonly items: readonly GameMenuItemSpec[];
+} | {
+	readonly kind: "action";
+	readonly label: GameMenuLabel;
+	readonly action: GameMenuAction;
+} | {
+	readonly kind: "dynamic";
+	readonly source: GameMenuDynamicSource;
+};
+type GameMenuSpecMenu = {
+	readonly label: GameMenuLabel;
+	readonly items: readonly GameMenuItemSpec[];
+};
+type GameMenuSpec = {
+	readonly menus: readonly GameMenuSpecMenu[];
+};
+/**
+ * How much memory a running game costs the machine it runs on, process by process.
+ *
+ * Read in the main process from Electron's process metrics (`app.getAppMetrics()`), which is the
+ * operating system's own account: the same working set a task manager shows. Nothing a page can
+ * read gives this. `performance.memory` describes one JavaScript heap, and in Electron it is also
+ * rounded to coarse buckets - the two arms of a measured comparison both read exactly 92.9 MB -
+ * while the memory a visual novel actually spends is mostly outside any heap:
+ * decoded pictures, textures in the GPU process, audio buffers, the main process serving and
+ * decrypting assets. The whole game is several processes, and only the process that owns them can
+ * see all of them.
+ *
+ * `process.memoryUsage()` in the main process was the other candidate and answers a narrower
+ * question - the main process's own heap and buffers - which is the one process a game's pictures
+ * are not in.
+ *
+ * Comments in English per project convention.
+ */
+/** What a process is for, in the words a reader of a memory report needs. */
+type GameProcessKind = "main" | "renderer" | "gpu" | "utility" | "other";
+type GameProcessMemoryEntry = {
+	kind: GameProcessKind;
+	/**
+	 * What the platform calls it, when it says: a utility process names its service ("Network
+	 * Service", "Audio Service", a sidecar's own name). Absent for the rest.
+	 */
+	name?: string;
+	/** Whether this is the process the asking page runs in. */
+	current: boolean;
+	/** Memory currently resident in physical RAM, in bytes. */
+	workingSetBytes: number;
+	/** The most this process has ever had resident, in bytes. */
+	peakWorkingSetBytes: number;
+	/** Memory no other process shares, in bytes. Windows reports it; other platforms do not. */
+	privateBytes?: number;
+};
+type GameProcessMemoryReading = {
+	/**
+	 * What the processes below add up to.
+	 *
+	 * - `game` - every process the game is made of. A packaged game and a preview.
+	 * - `window` - only the process that draws this window. Dev Mode: the window is Studio's, and
+	 *   the processes around it (Studio's main process, its GPU process, its other windows) are
+	 *   shared with everything else Studio has open, so counting them would report Studio.
+	 */
+	scope: "game" | "window";
+	processes: GameProcessMemoryEntry[];
+	/** The sum of every process's working set, in bytes. */
+	workingSetBytes: number;
+	/** The sum of every process's private bytes, or null where the platform does not report them. */
+	privateBytes: number | null;
+};
+declare const UI_INPUT_POINTER_GESTURES: readonly [
+	"click",
+	"doubleClick",
+	"rightClick",
+	"wheelUp",
+	"wheelDown",
+	"wheelLeft",
+	"wheelRight",
+	"longPress",
+	"middleClick"
+];
+type UIInputPointerGesture = (typeof UI_INPUT_POINTER_GESTURES)[number];
+type UIInputBinding = {
+	kind: "pointer";
+	gesture: UIInputPointerGesture;
+} | {
+	kind: "key";
+	key: string;
+} | {
+	kind: "gamepad";
+	button: string;
+};
+type UIInputActionDef = {
+	id: string;
+	/** Author-facing name. */
+	name: string;
+	/** The bindings a surface gets unless it overrides them. */
+	bindings: UIInputBinding[];
+};
+type UISurfaceActionEnablement = {
+	actionId: string;
+	/** Whether firing this action stops the input here. Default true. */
+	consume?: boolean;
+};
+declare const UI_PAGE_ANIMATION_PRESETS: readonly [
+	"none",
+	"fade",
+	"slide",
+	"push",
+	"zoom",
+	"pop",
+	"blur"
+];
+declare const UI_PAGE_ANIMATION_DIRECTIONS: readonly [
+	"auto",
+	"left",
+	"right",
+	"up",
+	"down",
+	"angle"
+];
+type UIPageAnimationPreset = (typeof UI_PAGE_ANIMATION_PRESETS)[number];
+type UIPageAnimationDirection = (typeof UI_PAGE_ANIMATION_DIRECTIONS)[number];
+type UIPageAnimationSettings = {
+	enter: UIPageAnimationPreset;
+	exit: UIPageAnimationPreset;
+	enterDirection: UIPageAnimationDirection;
+	exitDirection: UIPageAnimationDirection;
+	enterAngleDegrees: number;
+	exitAngleDegrees: number;
+	enterDurationSeconds: number;
+	exitDurationSeconds: number;
+	/** Held before this host's own enter starts, counted from the moment its subtree begins entering. */
+	enterDelaySeconds: number;
+	/** Held before this host's own exit starts, counted from the moment its subtree begins exiting. */
+	exitDelaySeconds: number;
+	/** Added to each successive direct child, so a row of children arrives (and leaves) one after another. */
+	childStaggerSeconds: number;
+	/** Hold this host's own exit until every child has finished leaving. Chains through nested parents. */
+	exitWaitsForChildren: boolean;
+	/** Surfaces only: hold the incoming Page until this exit has finished. */
+	exitBlocking: boolean;
+};
+type UISurfaceBackgroundFillMode = "cover" | "contain" | "stretch" | "tile";
+type UISurfaceBackgroundImage = {
+	/** Image library asset id. Absent background = absent field, so this is never empty. */
+	assetId: string;
+	fillMode: UISurfaceBackgroundFillMode;
+};
+type UIDocumentVersion = number;
+type UIDocumentId = string;
+type UISurfaceId = string;
+type UIElementId = string;
+type UIDocument = {
+	schemaVersion: UIDocumentVersion;
+	id: UIDocumentId;
+	name: string;
+	surfaces: UISurface[];
+	components?: UIComponentDefinition[];
+	elements: Record<UIElementId, UIElement>;
+	/**
+	 * The shapes this document's widgets describe their data with, keyed by id.
+	 *
+	 * No authoring surface manages this table: an author edits the fields on the widget that uses
+	 * them, and a widget stores only the id. It is a document-level table rather than a copy on each
+	 * widget so that a shape has one spelling for the whole project - which is what lets one list's
+	 * content feed another's, and what a Break node's pins are generated from. The rules that keep
+	 * an implicit library safe to edit are in `struct.ts`.
+	 */
+	structs?: Record<UIStructId, UIStructDef>;
+	/**
+	 * What the gestures of this project mean, keyed by id.
+	 *
+	 * The vocabulary half of the input model: "advance", "skip", "open the menu" - named once for
+	 * the whole project, with the bindings a surface gets unless it says otherwise. A surface stores
+	 * only the id, in {@link UISurface.actions}, so renaming an action here renames it everywhere
+	 * and rebinding it rebinds every surface that took the default. The rules are in
+	 * `inputAction.ts`.
+	 */
+	actions?: Record<string, UIInputActionDef>;
+	/**
+	 * The page the game starts on, by id.
+	 *
+	 * Absent means the page carrying `MAIN_APP_SURFACE_ID` - the id a new document gives its first
+	 * page, and the only entry a document had before this field existed - so a document whose author
+	 * never moved the entry stays exactly as short as it was. Read only through `resolveEntrySurface`
+	 * (`entrySurface.ts`), which also says what a pointer that has lost its page falls back to.
+	 *
+	 * A pointer rather than an id swap: a page's id is what its blueprints are filed under and what
+	 * every `Go Page` names, so making another page the entry must not change which id it has.
+	 *
+	 * Carries no schema bump, for the reason `actions` and `structs` did not: absence already means a
+	 * defined answer, so a document written before this field reads correctly without one.
+	 */
+	entrySurfaceId?: UISurfaceId;
+	meta?: UIDocumentMeta;
+};
+type UIDocumentMeta = {
+	createdAt?: string;
+	updatedAt?: string;
+};
+type UIHost = "app" | "player";
+type UISurfaceKind = "appSurface" | "stageSurface";
+type UIStageSlotId = "onStage" | "dialog" | "notification" | "choice" | "nvl";
+type UIStageSurfaceMount = {
+	kind: "slot";
+	slotId: UIStageSlotId;
+};
+type UIAppSurface = {
+	id: UISurfaceId;
+	name: string;
+	host: "app";
+	kind: "appSurface";
+	designSize: UISurfaceDesignSize;
+	rootElementId: UIElementId;
+	settings?: UISurfaceSettings;
+	/**
+	 * Which of the project's actions this surface answers. An id here names an entry of
+	 * {@link UIDocument.actions}; absent means it answers none of them.
+	 *
+	 * Input that lands on this surface's content stops here whether or not an action answered it,
+	 * unless the action that answered says otherwise. There is no surface-wide setting for that: a
+	 * surface drawn over another is drawn over it, and an action is the only thing that knows
+	 * whether what it just did leaves anything for the surface behind to do.
+	 */
+	actions?: UISurfaceActionEnablement[];
+	/** The values this page is opened with, in author order. See {@link UIPageParam}. */
+	params?: UIPageParam[];
+};
+type UIPageParam = {
+	id: string;
+	name: string;
+	type: UIPageParamType;
+	/**
+	 * For a `list`: the shape each row has, as a struct id (an engine shape such as `nl.confirmButton`,
+	 * a plugin's, or one of the project's). It types the value on both ends - the inputs that give it
+	 * and `Get Page Param` - and a list on the page bound to it is checked against it. Absent for
+	 * every other type, and for a list of rows of no declared shape.
+	 */
+	struct?: string;
+	/**
+	 * What the page reads when whoever opened it gave nothing for this name, in the declared type.
+	 * Absent reads as the type's empty value (`uiPageParamDefaultValue`).
+	 */
+	defaultValue?: unknown;
+};
+type UIPageParamType = "string" | "text" | "number" | "boolean" | "list" | "json";
+type UIStageSurface = {
+	id: UISurfaceId;
+	name: string;
+	host: "player";
+	kind: "stageSurface";
+	designSize: UISurfaceDesignSize;
+	rootElementId: UIElementId;
+	settings?: UISurfaceSettings;
+	mount: UIStageSurfaceMount;
+	slots?: Record<string, UISlotDefinition>;
+	/** @see UIAppSurface.actions */
+	actions?: UISurfaceActionEnablement[];
+};
+type UISurface = UIAppSurface | UIStageSurface;
+type UISurfaceDesignSize = {
+	width: number;
+	height: number;
+};
+type UISurfaceSettings = {
+	backgroundColor?: string;
+	/**
+	 * Painted over {@link backgroundColor}, inside the design area only - the letterbox bars around
+	 * a scaled Surface keep showing the colour, so the two settings are not alternatives.
+	 */
+	backgroundImage?: UISurfaceBackgroundImage;
+	pageAnimation?: UIPageAnimationSettings;
+	/**
+	 * What the asset set this Surface's own background names resolves to, per locale. Build-written
+	 * exactly as {@link UIElement.assetVariants} is, and here rather than on the Surface so the
+	 * answer sits beside the only asset a Surface names by itself.
+	 */
+	assetVariants?: AssetVariantMap;
+};
+type UISlotDefinition = {
+	id: string;
+	name: string;
+	rootElementId?: UIElementId;
+};
+type UIComponentId = string;
+type UIComponentDefinition = {
+	id: UIComponentId;
+	name: string;
+	rootElementId: UIElementId;
+	elements: Record<UIElementId, UIElement>;
+	/** Declared in the component's own inspector; each instance supplies its own values. */
+	params?: UIComponentParam[];
+	previewMeta?: {
+		width?: number;
+		height?: number;
 	};
+	createdAt?: string;
+	updatedAt?: string;
+};
+type UIComponentParam = {
+	/** Stable identity. Blueprints and instance values reference this, so renaming `name` is free. */
+	id: string;
+	/** What the author called it, shown in the instance's inspector. */
+	name: string;
+	type: UIComponentParamType;
+	/**
+	 * Used by an instance that has not overridden it, and by the definition's own preview. For a
+	 * `text` parameter these are words written directly, translated through the definition's own unit
+	 * (`uiComponentParamUnitId(componentId, paramId)`).
+	 */
+	defaultValue: string;
+};
+type UIComponentParamType = "string" | "text" | "audioTrack";
+type UIElement = {
+	id: UIElementId;
+	type: string;
+	name?: string;
+	parentId: UIElementId | null;
+	childrenIds: UIElementId[];
+	layout: UILayout;
+	style?: UIStyle;
+	props?: Record<string, unknown>;
+	valueBindings?: Record<string, UIElementValueBinding>;
+	/**
+	 * How this element arrives and leaves - the same record a Surface uses for its page animation.
+	 * Absent means it does neither. Read it through `elementAnimation.ts` rather than directly.
+	 *
+	 * Its own field rather than a `props` key, because it belongs to the placement and not to the
+	 * widget: every type has one, no renderer reads it, and a linked component instance may set it
+	 * even though its props come from the definition.
+	 */
+	animation?: UIPageAnimationSettings;
+	extra?: Record<string, unknown>;
+	/**
+	 * What each asset set THIS element names resolves to, per locale.
+	 *
+	 * **Never authored and never on disk under `editor/`.** It is written while a package is being
+	 * assembled (`@shared/build/uiAssetSets`) and exists only in the bundle a game runs from, which
+	 * is why editing a widget cannot produce one and why version control never sees it.
+	 *
+	 * It sits on the element rather than in a document-wide table for the reason the story row's
+	 * copy gives: a table would enumerate every localized asset the project has, which is the one
+	 * thing a protected pack refuses to disclose. One element discloses the variants of the sets
+	 * that element itself uses, which is what drawing the widget already discloses.
+	 *
+	 * Keyed by the set id the props still name - the prop keeps the set id, so a widget whose map is
+	 * missing fails loudly at a resolver rather than quietly fetching one language's picture.
+	 */
+	assetVariants?: AssetVariantMap;
 };
-type Messages = typeof en;
-type Flatten<T, Prefix extends string = ""> = {
-	[K in keyof T & string]: T[K] extends string ? `${Prefix}${K}` : Flatten<T[K], `${Prefix}${K}.`>;
-}[keyof T & string];
-type TranslationKey = Flatten<Messages> | (string & {});
+type UIElementValueBindingValueType = "string" | "json" | "float" | "boolean";
+type UIElementValueBinding = {
+	kind: "blueprintValue";
+	blueprintId: string;
+	valueType: UIElementValueBindingValueType;
+}
+/**
+ * Read one declared field of the list item this element is being drawn for.
+ *
+ * The whole reason the struct model exists. Reaching a row's own data used to take a private
+ * blueprint per element - Get List Item Props into Get JSON Field with the key typed into a
+ * string pin - which is three abstractions deep for "show the title". This is the same read with
+ * none of them: the field is picked from a dropdown, and an element outside an item template
+ * simply has nothing to bind to.
+ *
+ * No `valueType` of its own. The field declares one and the bound prop declares one, and the
+ * conversion between them belongs to the target, not to the binding - the same reason the
+ * slider's binding does not restate that a slider holds a number.
+ */
+ | {
+	kind: "listItemField";
+	fieldId: string;
+}
+/**
+ * Show the value one placement gives a text parameter of the component this element is part of.
+ *
+ * The component's counterpart of `listItemField`, and the same kind of read: no graph, nothing
+ * kept alive - the value is taken from the placement being drawn (`resolveUIComponentTextParams`),
+ * so the editing canvas draws each placement with its own words, and the game translates each
+ * through the placement's own unit or reads the key it names. Only a text parameter answers one,
+ * and only a widget's words take one; outside a placement (the component's own editor) the
+ * element's own words are drawn, as sample text.
+ */
+ | {
+	kind: "componentParam";
+	paramId: string;
+}
+/**
+ * Show the value the page this element is on was opened with for one of its text parameters.
+ *
+ * The page's counterpart of `componentParam`, read the same way: no graph - the value is taken from
+ * the props the page was opened with (`resolveUIPageTextParams`), words given at the opening shown
+ * as given, the declared default translated through the page's own unit. Only a text parameter
+ * answers one, only a widget's words take one, and only on a page: a component's insides and a
+ * Game UI have no page parameters to show. The editing canvas, where the page has not been opened,
+ * draws the default, or the element's own words as sample text while the default is empty.
+ */
+ | {
+	kind: "pageParam";
+	paramId: string;
+};
+type UILayout = {
+	x: number;
+	y: number;
+	width: number;
+	height: number;
+	rotation?: number;
+	opacity?: number;
+	visible?: boolean;
+	/** When true, width and height stay proportional in the inspector and on-canvas resize. */
+	lockAspectRatio?: boolean;
+};
+type UIStyle = Record<string, unknown>;
+type GameTestLogLevel = "verbose" | "info" | "success" | "warning" | "error";
+type GameTestExitReason = 
+/** Closed from inside the game - the window's own close, or the engine quitting itself. */
+"closed-by-user"
+/** The host asked: an explicit stop, or the run being cancelled. */
+ | "stopped-by-host"
+/** Non-zero exit code, a fatal signal, or an uncaught exception in the game's main process. */
+ | "crashed"
+/** Never got far enough to run: compile failed, or the runner binary would not spawn. */
+ | "failed-to-start";
+type GameTestExit = {
+	reason: GameTestExitReason;
+	code: number | null;
+	signal: string | null;
+};
+type GameTestChoiceOption = {
+	index: number;
+	text: string;
+	/** Offered but not selectable: the option's `disabledWhen` condition holds. */
+	disabled: boolean;
+};
+type GameTestEvent = {
+	kind: "console";
+	level: GameTestLogLevel;
+	source: string;
+	message: string;
+}
+/**
+ * An uncaught error inside the running game - `window.onerror` / `unhandledrejection` in its
+ * renderer, `uncaughtException` / `unhandledRejection` in its main process. The game runtime had
+ * no such hook before this pipeline; an uncaught renderer exception was reported nowhere.
+ */
+ | {
+	kind: "runtime-error";
+	scope: "renderer" | "main";
+	message: string;
+	stack?: string;
+}
+/** The engine reached an ending (`event:state.end`), forwarded out of the game's renderer. */
+ | {
+	kind: "game-end";
+}
+/**
+ * An `/ending` row ran, naming the ending it declares.
+ *
+ * Beside `game-end` rather than replacing it: `game-end` also fires for a story that simply ran
+ * out of rows, which has no ending to name. A test whose pass condition is "*this* ending" can
+ * only be written against this one.
+ */
+ | {
+	kind: "ending";
+	endingId: string;
+	name: string;
+}
+/**
+ * A choice menu is on screen, with every option it evaluated.
+ *
+ * Fires each time a menu mounts, so a rollback into the same choice reports it again. The list
+ * is what `choose` addresses; see {@link GameTestChoiceOption}.
+ */
+ | {
+	kind: "choice";
+	options: GameTestChoiceOption[];
+} | {
+	kind: "exit";
+	exit: GameTestExit;
+};
+type GameTestCommand = 
+/**
+ * Begin a story at a scene.
+ *
+ * Necessary because a test session boots to the main app surface - the title screen - and no
+ * story runs until something starts one. The caller supplies the target, exactly as the
+ * blueprint behind a Start button does.
+ */
+{
+	kind: "start";
+	storyId: string;
+	sceneId: string;
+}
+/** One click on the dialogue: finish the line being typed, or move to the next. */
+ | {
+	kind: "advance";
+}
+/** Pick an option of the choice currently on screen, by the index the `choice` event reported. */
+ | {
+	kind: "choose";
+	index: number;
+};
+type UITemplateSurfacePlacement = {
+	kind: UISurfaceKind;
+	/** Required for `stageSurface`; the game-UI slot the surface mounts into. */
+	slotId?: UIStageSlotId;
+};
+interface AssetTransferManifestEntry {
+	/**
+	 * The asset's id in the source project, which the importing project reuses.
+	 *
+	 * Reusing it is what lets the rows that travelled alongside keep pointing at their files
+	 * without being rewritten, and it makes a second paste of the same clipboard a no-op: the id
+	 * is already in the library, so there is nothing to import.
+	 */
+	assetId: string;
+	/** Author-facing file name, extension included: what the file is called once imported. */
+	fileName: string;
+	/**
+	 * The `AssetType` value as a string.
+	 *
+	 * Structural for the reason `assetSet.ts` gives for the same field: the enum lives under the
+	 * renderer and cannot be imported here.
+	 */
+	type: string;
+	/** Size in bytes, when the offering side already knew it. */
+	size?: number;
+	/**
+	 * Whether the payload is a directory rather than a single file.
+	 *
+	 * True for model bundles, the one asset type whose contents are a tree. It decides both halves
+	 * of the transfer: the grant covering the entry reaches everything below the path, and the
+	 * importing project copies the tree instead of writing bytes.
+	 */
+	isDirectory?: boolean;
+}
 type PrivilegedWriteBatchEntry = {
 	path: string;
 	encoding?: FsTextEncoding;
@@ -16160,6 +16254,19 @@ export type SearchJumpTarget = {
 	unitId?: string;
 	storyId?: string;
 }
+/**
+ * A translation table showing its orphans: the translations of one language whose line is no
+ * longer in the game (deleted, or disabled), where they are listed and can be deleted.
+ */
+ | {
+	kind: "translationOrphans";
+	locale: string;
+}
+/** A voice table showing its orphans: the takes of one voice language whose line is no longer in the game. */
+ | {
+	kind: "voiceOrphans";
+	locale: string;
+}
 /** A story motion, open in its own editor. */
  | {
 	kind: "storyMotion";
@@ -17497,7 +17604,14 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	updateElementLayouts(layoutPatches: Record<string, Partial<UILayout>>, options?: {
 		mergeKey?: string;
 	}): void;
-	updateElementProps(elementId: string, propsPatch: Record<string, unknown>): void;
+	/**
+	 * `skipHistory` is for bookkeeping writes nobody asked for - an inspector filling in the
+	 * appearance keys an element predates, the moment it is selected. Recorded, that left an undo
+	 * step behind every first selection, so Ctrl+Z after looking around a page did nothing visible.
+	 */
+	updateElementProps(elementId: string, propsPatch: Record<string, unknown>, options?: {
+		skipHistory?: boolean;
+	}): void;
 	/**
 	 * Every widget that reads its words from `keyName`, turned into one that holds `words` itself.
 	 *
@@ -17755,11 +17869,16 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	 * (`resolveWorkspaceUndoScope`). A definition's own stack holds edits *inside* it, and a deleted
 	 * definition has no tab to press Ctrl+Z in.
 	 *
+	 * `scopeId` names another stack for the one library operation that is made from inside a page's
+	 * editor - {@link createComponentFromElements}, from the canvas or the outline. The same rule
+	 * puts that step on the page's stack: Ctrl+Z pressed where the gesture was made has to take it
+	 * back, and on the project's stack it instead undid whatever the page's last edit had been.
+	 *
 	 * Each step is a command over whole records, not a snapshot of the library: whichever direction
 	 * runs reads the records as they stand at that moment and writes them back exactly, and nothing
 	 * else in the library is touched. Tagged, so a live session drops these steps with the interface
 	 * editors' stacks (`LiveSessionService`): taking back an addition after a session would remove
-	 * whatever the room built inside it.
+	 * whatever the room built inside it. (A page's stack is cleared whole when a session starts.)
 	 */
 	private pushLibraryStep;
 	/**
@@ -17992,8 +18111,13 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	/**
 	 * A new definition made of copies of elements on a page, with the logic they carry.
 	 *
-	 * The page is not changed, so the step that takes this back is the library's - the project's
-	 * stack, the one {@link createEmptyComponent} uses - rather than the page's.
+	 * The page is not changed, but the step that takes this back goes on the page's stack all the
+	 * same: it is made from the page's canvas or outline, and that is where Ctrl+Z and the Edit menu
+	 * reach (`resolveWorkspaceUndoScope`). On the project's stack - the one {@link createEmptyComponent}
+	 * uses, from the rail - Ctrl+Z right after it undid the page's previous edit and left the copy.
+	 *
+	 * `name` names the definition; without one it takes the element's name, or the catalog's word for
+	 * a component when there are several elements or the one has no name.
 	 */
 	createComponentFromElements(surfaceId: string, elementIds: string[], name?: string): UIComponentDefinition | null;
 	/** Recorded in the definition's own undo stack, as a page's name is in the page's. */
@@ -18088,7 +18212,10 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	 * element on a page has no parameters to show and is left alone.
 	 */
 	setElementComponentParamBinding(elementId: string, propPath: string, paramId: string | null): void;
-	updateComponentElementProps(componentId: string, elementId: string, propsPatch: Record<string, unknown>): void;
+	/** `skipHistory` as {@link updateElementProps} takes it. */
+	updateComponentElementProps(componentId: string, elementId: string, propsPatch: Record<string, unknown>, options?: {
+		skipHistory?: boolean;
+	}): void;
 	updateComponentElementAnimation(componentId: string, elementId: string, animation: UIPageAnimationSettings | null, options?: {
 		mergeKey?: string;
 	}): void;
@@ -18107,6 +18234,23 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	 * document made of the component alone, as `moveComponentElements` does.
 	 */
 	groupComponentElements(componentId: string, elementIds: readonly string[]): string | null;
+	/**
+	 * Make an element its definition's root, taking off the container it sat alone in.
+	 *
+	 * One step in the definition's history, and the one step there that reaches the pages: every
+	 * placement is given the box the element took up inside it (`promoteElementToComponentRoot`), and
+	 * taking the step back gives the boxes back with the definition.
+	 */
+	promoteComponentElementToRoot(componentId: string, elementId: string): boolean;
+	/**
+	 * Put an empty container around a definition's root, as its new root. Returns the container's id.
+	 *
+	 * The container takes the root's size and draws nothing of its own, so the definition and every
+	 * placement look as they did, and the root can now be given siblings.
+	 */
+	wrapComponentRoot(componentId: string): string | null;
+	/** An element as an Edit menu step names it: its own name, or its widget's. */
+	private describeElementForHistory;
 	createComponentElement(componentId: string, parentId: string, type: string, layoutPatch?: Partial<UILayout>): UIElement | null;
 	pasteComponentClipboardPayload(componentId: string, targetParentId: string, beforeChildId: string | null, incoming: UIEditorClipboardPayload): {
 		ok: true;
@@ -18145,6 +18289,15 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	private createNotificationStageTemplate;
 	private createChoiceStageTemplate;
 	private createNvlStageTemplate;
+	/**
+	 * The actions the project's dialogue box reads on with, as far as a new NVL page can follow them.
+	 *
+	 * Read from the box's graphs the way the engine's own NVL page reads them
+	 * (`resolveDialogueAdvanceActionIds`), and kept to actions the project still defines - an
+	 * enablement naming a missing one does nothing, and copying it onto a new surface would only
+	 * carry the dead entry further.
+	 */
+	private resolveDialogueAdvanceActionsForStarter;
 	/** Value graph: `Init -> Return Value` fed by `Get List Item Props -> Get JSON Field(propsPath)`. */
 	private createListItemPropsValueGraph;
 	/**
@@ -18159,8 +18312,24 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	 * Panel (`nl.container`) because collection widgets like `nl.nvl.list` do not expose a
 	 * `Mouse Click` head; the panel's own Mouse Click plus Element Click on the interaction layer
 	 * and the list cover every click region.
+	 *
+	 * The page's wiring when the project has no action its dialogue box reads on with; see
+	 * {@link createNvlActionNextGraph} for the one it gets when it has.
 	 */
 	private createNvlNextGraph;
+	/**
+	 * Event graph for an NVL page in a project whose dialogue box reads on with actions: each of
+	 * those actions runs `Next`, and so does a click on the NVL list.
+	 *
+	 * The actions bring the keys, the gamepad and a click anywhere on the page that is not on a
+	 * control - the same presses that read the box on. The list is the exception: it is a control,
+	 * and an action stands down over a control (`pointerInputClaimedByControl`), so a click on the
+	 * lines would otherwise do nothing. `Element Click` on the list hears exactly that click and no
+	 * other, so no press reads on twice and no widget answers a gesture the page answers as well.
+	 *
+	 * On the surface's blueprint, because only a surface answers an action.
+	 */
+	private createNvlActionNextGraph;
 	private configureDefaultNotificationBlueprints;
 	private configureDefaultChoiceBlueprints;
 	private configureDefaultNvlBlueprints;
@@ -19465,7 +19634,9 @@ interface IUIDocumentService extends IService {
 	updateElementLayouts(layoutPatches: Record<string, Partial<UILayout>>, options?: {
 		mergeKey?: string;
 	}): void;
-	updateElementProps(elementId: string, propsPatch: Record<string, unknown>): void;
+	updateElementProps(elementId: string, propsPatch: Record<string, unknown>, options?: {
+		skipHistory?: boolean;
+	}): void;
 	ensureElementBlueprintValueBinding(elementId: string, propPath: string, input: {
 		valueType: UIElementValueBindingValueType;
 		displayName?: string;
@@ -19505,7 +19676,9 @@ interface IUIDocumentService extends IService {
 	updateComponentElementLayouts(componentId: string, layoutPatches: Record<string, Partial<UILayout>>, options?: {
 		mergeKey?: string;
 	}): void;
-	updateComponentElementProps(componentId: string, elementId: string, propsPatch: Record<string, unknown>): void;
+	updateComponentElementProps(componentId: string, elementId: string, propsPatch: Record<string, unknown>, options?: {
+		skipHistory?: boolean;
+	}): void;
 	updateComponentElementExtra(componentId: string, elementId: string, extraPatch: Record<string, unknown>): void;
 	renameComponentElement(componentId: string, elementId: string, name: string): void;
 	reorderComponentChildren(componentId: string, parentId: string, orderedChildIds: string[]): void;