narraleaf-studio 1.2.0 → 1.3.0

package/dist/_api.d.ts

@@ -1707,6 +1707,17 @@ type BlueprintDiagnostic = {
 	/** Source span or module location; M1 opaque */
 	location?: Record<string, unknown>;
 };
+type LocaleCode = string;
+type LocalizationUnitStatus = "untranslated" | "machine" | "translated" | "reviewed";
+type LocalizationUnit = {
+	/** Translated text; `{n}` placeholders map to the source segment's inline interpolations. */
+	target: string;
+	/** Hash of the source text at translation time (see shared/utils/localizationText). */
+	sourceHash: string;
+	status: LocalizationUnitStatus;
+	/** Optional translator note. */
+	note?: string;
+};
 type BlueprintAssetPinKind = "image" | "audio" | "font";
 type BlueprintAssetPinRef = {
 	kind: BlueprintAssetPinKind;
@@ -2113,7 +2124,7 @@ type PluginBuildConfigFieldContribution = {
 	/** A build that would ship without a value for this field is refused. */
 	required?: boolean;
 };
-type PluginContributes = {
+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). */
@@ -2219,6 +2230,40 @@ type PluginContributes = {
 	 * 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[]>;
+};
+/**
+ * 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
@@ -2336,6 +2381,7 @@ export type RuntimePluginDescriptor = {
 type GameMenuLabel = {
 	readonly key?: string | null;
 	readonly text: string;
+	readonly words?: string | null;
 };
 declare const GAME_MENU_DYNAMIC_SOURCES: readonly [
 	"textLanguage",
@@ -2738,10 +2784,15 @@ type UIComponentParam = {
 	id: string;
 	/** What the author called it, shown in the instance's inspector. */
 	name: string;
-	type: "string";
-	/** Used by an instance that has not overridden it, and by the definition's own preview. */
+	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;
@@ -2801,6 +2852,20 @@ type UIElementValueBinding = {
  | {
 	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;
 };
 type UILayout = {
 	x: number;
@@ -3849,7 +3914,7 @@ declare const en: {
 			readonly table: {
 				readonly storyLabel: "Source";
 				readonly sourceUi: "Interface text";
-				readonly sourceKeys: "Named keys";
+				readonly sourceKeys: "Translation keys";
 				readonly modeTranslate: "Translate";
 				readonly modeReview: "Review";
 				readonly filterAll: "All";
@@ -3870,11 +3935,12 @@ declare const en: {
 				readonly removeKey: "Remove key";
 				readonly removeKeyConfirm: "Remove {name}?";
 				readonly removeKeyConfirmDetail: "Existing translations of this key stay in the language files.";
-				readonly removeKeyUsedBy: "Used by:";
+				readonly removeKeyWidgets: "These widgets keep the key's words and translations as their own:";
+				readonly removeKeyBlueprints: "Blueprints that use the key:";
 				readonly removeKeyUsedByElement: "{owner} \u25B8 {element}";
 				readonly removeKeyUsedByBlueprint: "Blueprint \u201C{name}\u201D";
 				readonly removeKeyUsedByMore: "and {count} more";
-				readonly removeKeyUsedByAfter: "Once the key is removed, the project check reports each of them.";
+				readonly removeKeyUsedByAfter: "Once the key is removed, the project check reports each of these blueprints.";
 				readonly sourceColumn: "Source";
 				readonly targetColumn: "Translation";
 				readonly targetPlaceholder: "Translate\u2026";
@@ -3996,6 +4062,18 @@ declare const en: {
 				readonly findPlaceholder: "Find in lines";
 			};
 		};
+		readonly textSourceMigration: {
+			readonly message: {
+				readonly one: "Interface text was upgraded. The words of {count} widget now come from a different source.";
+				readonly other: "Interface text was upgraded. The words of {count} widgets now come from a different source.";
+			};
+			readonly place: "{n}. {owner} \u25B8 {element}: {change}";
+			readonly marksKept: "now Direct, keeping its marks, and no longer uses the key {key}";
+			readonly bindingDropped: "a binding that never showed was removed, and the key {key} shows";
+			readonly missingKey: "the key {key} does not exist, so it is now Direct, with the same words and translations";
+			readonly keyDiffered: "now Direct, keeping the words it showed, and no longer uses the key {key}";
+			readonly locate: "Locate {n}";
+		};
 		readonly recovery: {
 			readonly enter: "Open in recovery mode";
 			readonly enterFailed: "Could not open recovery mode: {error}";
@@ -4205,7 +4283,7 @@ declare const en: {
 				readonly liveCheckpointNone: "There was nothing uncommitted to record.";
 				readonly livePendingOne: "1 change is waiting for the host.";
 				readonly livePendingMany: "{count} changes are waiting for the host.";
-				readonly liveFrozenWhat: "The stories, the cast, the translations, the whole asset library - files included - and the project's own tables (the dictionary, the audio tracks, the asset sets, the variables, the named strings, the build variants, the DLC and the palette) are saved. Everything else here is current and read-only until the session ends.";
+				readonly liveFrozenWhat: "The stories, the cast, the translations, the whole asset library - files included - and the project's own tables (the dictionary, the audio tracks, the asset sets, the variables, the translation keys, the build variants, the DLC and the palette) are saved. Everything else here is current and read-only until the session ends.";
 				readonly liveUnavailableHere: "Unavailable in a live session.";
 				readonly liveClaimsLabel: "Lines being written";
 				readonly liveClaimOne: "{name} is writing 1 line.";
@@ -4407,6 +4485,7 @@ declare const en: {
 					readonly runStatus: "Run status";
 					readonly projectTrust: "Project trust";
 					readonly studioTasks: "Background work";
+					readonly problems: "Problems";
 					readonly unsavedChanges: "Unsaved changes";
 					readonly wordCount: "Story stats";
 					readonly shortcuts: "Shortcuts and mouse actions";
@@ -4941,7 +5020,7 @@ declare const en: {
 				readonly placeholder: "Search project\u2026";
 				readonly titleBarPlaceholder: "Search in {name}";
 				readonly building: "Building search index\u2026";
-				readonly idle: "Search scenes, characters, story text, assets and blueprints.";
+				readonly idle: "Search scenes, characters, story text, interface text, assets and blueprints.";
 				readonly empty: "No results";
 				readonly more: "{count} more";
 				readonly caseSensitive: "Match case";
@@ -4961,8 +5040,9 @@ declare const en: {
 					readonly blueprint: "Blueprints";
 					readonly asset: "Assets";
 					readonly storyText: "Story Text";
+					readonly uiText: "Interface Text";
 					readonly variable: "Variables";
-					readonly uiTextKey: "UI Text Keys";
+					readonly uiTextKey: "Translation Keys";
 					readonly blueprintNode: "Blueprint Nodes";
 				};
 				readonly occurrences: "\u00D7{count}";
@@ -5866,6 +5946,7 @@ declare const en: {
 			readonly cutPointTitle: "The {name} build ends at this line. No other build contains this line.";
 			readonly cutPointInactive: "variant deleted";
 			readonly cutPointInactiveTitle: "The variant this line ended has been deleted, so it ends nothing.";
+			readonly problem: "{message} ({rule})";
 			readonly tempSpeaker: "name only";
 			readonly createCharacter: "Create character \u201C{name}\u201D";
 			readonly createCharacterUnavailable: "Unavailable in a live session. Choose an existing character.";
@@ -6646,7 +6727,7 @@ declare const en: {
 		};
 	};
 	readonly storyInspector: {
-		readonly textId: "Localization key";
+		readonly textId: "Unit ID";
 		readonly advanced: "Advanced";
 		readonly advancedParams: "Advanced params";
 		readonly noVariablesDeclared: "No variables declared";
@@ -7864,6 +7945,7 @@ declare const en: {
 			readonly goTo: "Go to {target}";
 			readonly goToNth: "Go to {target} ({n})";
 			readonly goToConnected: "Go to connected node";
+			readonly name: "Wire from {from} to {to}";
 		};
 		readonly crossProject: {
 			readonly pasted: {
@@ -7965,7 +8047,7 @@ declare const en: {
 				readonly noRuntime: "Node \"{node}\": no runtime for type \"{type}\".";
 				readonly inputMissing: "\"{node}\" has nothing connected to \"{pin}\".";
 				readonly stepLimit: "\"{head}\" stopped at \"{node}\" after {steps} steps without a wait.";
-				readonly stepLimitGlobal: "\"{head}\" in the global blueprint 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 variableIdInvalid: "Node \"{node}\": pick a variable.";
 				readonly persistentVariableIdInvalid: "Node \"{node}\": pick a persistent variable.";
@@ -9263,6 +9345,7 @@ declare const en: {
 			readonly toggle: "Toggle";
 			readonly toggleDialogDisplay: "Toggle Dialog Display";
 			readonly toggleSwitch: "Toggle Switch";
+			readonly translationKeyText: "Translation Key Text";
 			readonly trim: "Trim";
 			readonly trimEnd: "Trim End";
 			readonly trimStart: "Trim Start";
@@ -9302,6 +9385,7 @@ declare const en: {
 			readonly getTotalPlaytime: "Get Total Playtime";
 		};
 		readonly nodeDescription: {
+			readonly getComponentParam: "The value this placement sets for the chosen parameter, or the parameter's default when it sets none. A Text parameter that reads from a translation key gives the key's name; Translation Key Text gives its words.";
 			readonly compareEqual: "True when A and B are the same value of the same type. The number 1 and the text \"1\" are not equal.";
 			readonly compareNotEqual: "True when A and B differ in value or in type. The number 1 and the text \"1\" count as different.";
 			readonly compareGreaterThan: "True when A is greater than B. Both sides are compared as numbers; a side that cannot be read as a number gives false.";
@@ -9316,7 +9400,11 @@ declare const en: {
 			readonly gameReady: "Runs when the game is ready, before any story starts and before the first screen shows; the screen waits for it to finish. Runs before App Boot, and can run again when a game is started or loaded.";
 			readonly goBack: "Closes the current page and returns to the page beneath it. On the bottom page it does nothing.";
 			readonly replacePage: "Opens a page in place of the current page, and closes the current page. Go back and Go Page set to None do not return to it.";
-			readonly isGameOverlay: "True when this page, layer or Game UI is shown over a running game. In the global blueprint, true while a page or a modal layer covers the story.";
+			readonly isGameOverlay: "True when this page, layer or Game UI is shown over a running game. In App logic, true while a page or a modal layer covers the story.";
+			readonly localizationGetText: "Gets a translation key's text in the player's current language, or its source text when that language has no translation. A key that does not exist gives its name. Translation Key Text gives the same text and can also be used in Blueprint Value and functions.";
+			readonly translationKeyText: "A translation key's text in the player's current language, or its source text when that language has no translation. A key that does not exist gives its name. The same text as Get Text, and also usable in Blueprint Value and functions. A Blueprint Value that shows it updates when the player changes language.";
+			readonly format: "Replaces the placeholders in Template with values: {0}, {1} and so on with the items of an array, {name} with the field of that name in an object. A placeholder with no value becomes empty. A translated template comes from Translation Key Text.";
+			readonly formatText: "Replaces {0}, {1} and so on in Text with the items of Values. Format does the same, also fills {name} from an object, and can be used in Blueprint Value and functions.";
 		};
 		readonly live: {
 			readonly nodeClaimed: "{name} is editing this node";
@@ -9721,6 +9809,12 @@ declare const en: {
 			readonly remove: "Remove param";
 			readonly namePlaceholder: "Name";
 			readonly defaultPlaceholder: "Default";
+			readonly type: "Type";
+			readonly typeString: "String";
+			readonly typeText: "Text";
+			readonly bindLabel: "Parameter";
+			readonly bindNone: "No parameter";
+			readonly bindMissing: "Missing parameter";
 		};
 		readonly binding: {
 			readonly notReady: "Blueprint not ready for this control.";
@@ -10237,8 +10331,8 @@ declare const en: {
 			readonly createGameUi: "Create Game UI";
 			readonly globalSubtitle: "Global";
 			readonly blueprintType: "Blueprint";
-			readonly openGlobalBlueprint: "Open global blueprint";
-			readonly globalBlueprintUnavailable: "Global blueprint unavailable";
+			readonly openGlobalBlueprint: "Open App logic";
+			readonly globalBlueprintUnavailable: "App logic unavailable";
 			readonly openSurface: "Open {label}";
 			readonly renameSurface: "Rename {label}";
 			readonly duplicateSurface: "Duplicate {label}";
@@ -10368,6 +10462,7 @@ declare const en: {
 			readonly widgetRenderFailed: "Widget failed to draw";
 			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.";
 		};
 		readonly editor: {
 			readonly componentNotFound: "Component not found";
@@ -10598,14 +10693,22 @@ declare const en: {
 			readonly hint: "Shown in the editor only. The game shows the story's current line.";
 			readonly bindingNoEffect: "This binding has no effect in the {slot} slot.";
 			readonly removeBinding: "Remove";
+			readonly hintBlueprintValue: "Shown in the editor only. The game shows the Blueprint Value's result.";
+			readonly hintComponentParam: "Shown while editing the component only. Each placement shows the value it sets for the parameter.";
+		};
+		readonly textWriters: {
+			readonly title: "Written in the game by";
+			readonly entry: "{blueprint} \u203A {node}";
+			readonly count: "\u00D7{count}";
+			readonly defaultValue: "Default value";
+			readonly defaultValueHint: "The game shows this text until one of the blueprints below writes to it.";
 		};
 		readonly localization: {
 			readonly direct: "Direct";
 			readonly translationKey: "Translation key";
-			readonly noSourceLanguage: "The project has no source language";
 			readonly none: "None";
 			readonly createKey: "Create new key\u2026";
-			readonly createKeyTitle: "New localization key";
+			readonly createKeyTitle: "New translation key";
 			readonly keyName: "Key name";
 			readonly keyNamePlaceholder: "menu.start\u2026";
 			readonly keyNameHint: "Letters, digits, and dots/underscores/hyphens between them.";
@@ -10714,11 +10817,9 @@ declare const en: {
 			readonly sectionColor: "Color";
 			readonly sectionBehavior: "Behavior";
 			readonly interactionDisabled: "Interaction disabled";
-			readonly localizeLabel: "Localize label";
 		};
 		readonly text: {
 			readonly title: "Text";
-			readonly localizeText: "Localize text";
 		};
 		readonly textMarks: {
 			readonly title: "Marks";
@@ -12157,6 +12258,7 @@ declare const en: {
 			readonly voice: "Voice";
 			readonly assets: "Assets";
 			readonly console: "Console";
+			readonly problems: "Problems";
 			readonly storyMotion: "Story Motion";
 			readonly dashboard: "Dashboard";
 			readonly audioPreview: "Audio Preview";
@@ -13194,6 +13296,8 @@ declare const en: {
 		readonly mirror: {
 			readonly official: "official source";
 			readonly change: "Change";
+			readonly downloadFailed: "A file the build needed could not be downloaded. If this network reaches github.com slowly or not at all, choose a mirror for the build's downloads in Settings \u203A {section} and build again.";
+			readonly certificateFailed: "The download's certificate could not be verified. That usually means a proxy, network accelerator or antivirus program on this computer is intercepting HTTPS; turning it off may fix this without a mirror.";
 		};
 		readonly preflight: {
 			readonly "no-targets": "Select at least one platform and format.";
@@ -13506,185 +13610,209 @@ declare const en: {
 				readonly description: "Nothing in the project references this asset";
 				readonly message: "{asset} is not used anywhere";
 				readonly messageIndexUnresolved: "Unused assets not listed: {location} points at an asset that cannot be identified";
-				readonly messageIndexUnreadable: "Unused assets not listed: {location} could not be read";
+				readonly messageIndexUnreadable: "Unused assets not listed: which assets {location} uses could not be determined";
 				readonly messageIndexNotBuilt: "Unused assets not listed: the project could not be scanned";
+				readonly help: string;
 			};
 			readonly assetsMissing: {
 				readonly title: "Missing asset";
 				readonly description: "A reference names an asset the library no longer has";
 				readonly message: "{location} references a missing asset";
+				readonly help: string;
 			};
 			readonly assetsUnreadable: {
 				readonly title: "Unreadable asset";
 				readonly description: "The file cannot be read or decoded";
-				readonly message: "{asset} cannot be decoded";
+				readonly message: "{asset} is damaged or is not in a format Studio can open";
 				readonly messageMissingBytes: "{asset} cannot be read from disk";
+				readonly help: string;
 			};
 			readonly assetsOversized: {
 				readonly title: "Large file";
 				readonly description: "A file a build carries that is over the size this project allows";
 				readonly message: "{asset} is {size}, over the {limit} a build should carry";
+				readonly help: string;
 			};
 			readonly assetsGroupIncomplete: {
 				readonly title: "Unfinished asset set";
 				readonly description: "A set that does not resolve to exactly one file for every variant it declares";
 				readonly message: "{set} has no file for {variant}";
 				readonly messageAmbiguous: "{set} has {count} files for {variant}";
-				readonly messageResidency: "{set} resolves {axis} while the game runs, inside {outerAxis}, which the build resolves";
-				readonly messageDeclaration: "{set} declares no variants to resolve";
-				readonly messageFallback: "{set} does not say which variant the others fall back to";
-			};
-			readonly portabilityAssetName: {
-				readonly title: "Unsafe file name";
-				readonly description: "Characters or names some filesystems reject";
-				readonly message: "{asset} cannot be written on every platform";
-			};
-			readonly portabilityCaseCollision: {
-				readonly title: "Case collision";
-				readonly description: "Names that differ only by letter case";
-				readonly message: "{asset} collides with {other} on case-insensitive filesystems";
+				readonly messageResidency: "{set} varies by variant and sits under a set that varies by language, which no build can resolve";
+				readonly messageDeclaration: "{set} declares no values to resolve";
+				readonly messageFallback: "{set} does not say which value the others fall back to";
+				readonly help: string;
 			};
 			readonly portabilityMediaFormat: {
 				readonly title: "Unplayable format";
 				readonly description: "A codec some selected build targets cannot play";
 				readonly message: "{asset} does not play on {platform}";
+				readonly help: string;
 			};
 			readonly portabilityVfxAlpha: {
 				readonly title: "Transparent overlay clip";
 				readonly description: "An overlay clip whose transparency some selected build targets ignore";
 				readonly message: "{asset} covers the stage on {platform}";
+				readonly help: string;
 			};
 			readonly networkFetchNotAllowlisted: {
 				readonly title: "Address not on the allowlist";
 				readonly description: "A Fetch node aimed at an address this project does not allow";
 				readonly message: "{url} is not on this project's network request allowlist";
+				readonly help: string;
 			};
 			readonly networkFetchDisallowed: {
 				readonly title: "Network node without network access";
 				readonly description: "A network node in a project whose network policy is off";
 				readonly message: "{blueprint} makes a network request, which this project does not allow";
+				readonly help: string;
 			};
 			readonly storyUnreadable: {
 				readonly title: "Unreadable story";
 				readonly description: "A story document this Studio cannot open";
+				readonly help: string;
 			};
 			readonly storyInvalidCommand: {
 				readonly title: "Invalid command";
 				readonly description: "A row the compiler refuses";
 				readonly message: "This row does not compile";
+				readonly help: string;
 			};
 			readonly storyGotoMissing: {
 				readonly title: "Missing label";
 				readonly description: "A goto naming a label the scene does not declare";
 				readonly message: "Jumps to {label}, which this scene never declares";
+				readonly messageEmpty: "Names no label to go to";
+				readonly help: string;
 			};
 			readonly storyLabelDuplicate: {
 				readonly title: "Duplicate label";
 				readonly description: "Two declarations of one label; only the first is reached";
-				readonly message: "{label} is already declared above, so this one is never reached";
+				readonly message: "{label} is already declared above, so every /goto to it lands there and not here";
+				readonly help: string;
 			};
 			readonly storyLabelUnused: {
 				readonly title: "Unused label";
 				readonly description: "A label nothing jumps to";
 				readonly message: "Nothing jumps to {label}";
+				readonly help: string;
 			};
 			readonly storyJumpMissing: {
 				readonly title: "Missing scene";
 				readonly description: "A jump naming a scene the project does not have";
-				readonly message: "Jumps to a scene the story no longer has";
+				readonly message: "The target scene is not set, or is not in this story";
+				readonly help: string;
 			};
 			readonly storyEmptyChoice: {
 				readonly title: "Empty choice";
 				readonly description: "A choice with nothing the player can pick";
 				readonly message: "This choice has no options";
 				readonly messageEmptyOption: "This option has no text";
+				readonly help: string;
 			};
 			readonly storyDeadEnd: {
 				readonly title: "Dead end";
 				readonly description: "A scene that leaves on some paths and reaches its end on another";
 				readonly message: "Play runs off the end of the scene here";
+				readonly help: string;
 			};
 			readonly storyCallCycle: {
 				readonly title: "Circular call";
 				readonly description: "A returnable jump reaching a scene that can call its own back";
 				readonly message: "Calls a scene that can call this one back";
+				readonly help: string;
 			};
 			readonly storyUnreachableScene: {
 				readonly title: "Unreachable scene";
 				readonly description: "A scene nothing can reach from the start";
 				readonly message: "Nothing reaches this scene";
+				readonly help: string;
 			};
 			readonly storyEmptyScene: {
 				readonly title: "Empty scene";
 				readonly description: "A scene with no content";
-				readonly message: "This scene has no rows";
+				readonly message: "This scene has no enabled rows";
+				readonly help: string;
 			};
 			readonly storyAppTagUnknown: {
 				readonly title: "Unknown build variant";
 				readonly description: "A row compared with a variant the project does not have";
-				readonly message: "No build variant is named \"{name}\", so this row is in no build";
+				readonly message: "No build variant is named \"{name}\", so this comparison has the same result in every build";
+				readonly help: string;
 			};
 			readonly storyRowsAfterEnding: {
 				readonly title: "Rows after an ending";
 				readonly description: "Rows written after an /ending row in the same list, which never play";
 				readonly message: "This row comes after an ending and is never played. Move it before the ending, or delete it";
+				readonly help: string;
 			};
 			readonly storyQuitPageMissing: {
 				readonly title: "Quit with no page";
 				readonly description: "A /quit row that names no page, or one the project no longer has";
-				readonly message: "This row names no page, so the playthrough ends with nothing on screen";
-				readonly deleted: "This project has no page \"{page}\", so the playthrough ends with nothing on screen";
+				readonly message: "This row names no page, so no page opens and the rows after it in this list never play";
+				readonly deleted: "The page this row names is no longer in the project, so the playthrough ends with nothing on screen";
+				readonly help: string;
 			};
 			readonly storyEndingNameDuplicate: {
 				readonly title: "Two endings with one name";
 				readonly description: "More than one ending sharing a display name";
 				readonly message: "Another ending is also called \"{name}\". A screen listing endings shows the name twice";
+				readonly help: string;
 			};
 			readonly storyCutPointOrphan: {
 				readonly title: "Cut point with no variant";
 				readonly description: "A cut point written while the project has no build variant";
 				readonly message: "This project has no build variant, so this cut point ends nothing. Add a variant, or delete the row";
+				readonly help: string;
 			};
 			readonly storyCutPointUnreachable: {
 				readonly title: "Cut point out of reach";
 				readonly description: "A cut point in a scene nothing can get to";
 				readonly message: "Nothing can reach this scene, so this cut point never ends a build";
+				readonly help: string;
 			};
 			readonly storyStageObjectMissing: {
 				readonly title: "Missing stage object";
 				readonly description: "A row acting on an object no row in the scene creates";
-				readonly message: "Nothing creates {object}, so this row has nothing to act on";
-				readonly messageCharacter: "Nothing brings {object} on stage, so this row has nothing to act on";
+				readonly message: "No row in this scene creates {object}, so this row has nothing to act on";
+				readonly messageCharacter: "No row in this scene brings {object} on stage, so this row has nothing to act on";
+				readonly help: string;
 			};
 			readonly storyDeclaredNeverShown: {
 				readonly title: "Unshown stage object";
 				readonly description: "A create row declares an object no row shows";
 				readonly message: "{object} is declared here and no row shows it";
+				readonly help: string;
 			};
 			readonly storyStageObjectDuplicate: {
 				readonly title: "Duplicate stage object";
 				readonly description: "Two rows creating one stage name; the second reuses the first";
 				readonly message: "{object} is already created above, so this row acts on that one";
+				readonly help: string;
 			};
 			readonly storyVideoControlAfterEnd: {
 				readonly title: "Video already finished";
 				readonly description: "A row pausing, resuming, seeking or stopping a video after a play that waits for its end";
 				readonly message: "{object} has already finished playing at this line; to continue while it plays, turn off \u201CWait for the video\u201D on its play row";
+				readonly help: string;
 			};
 			readonly storyCharacterMissing: {
 				readonly title: "Missing character";
 				readonly description: "A row naming a character the project does not have";
 				readonly message: "This row names a character the project does not have";
+				readonly help: string;
 			};
 			readonly storyTransitionUnavailable: {
 				readonly title: "Unavailable transition";
 				readonly description: "A row naming a transition this version cannot play";
 				readonly message: "The transition {transition} is not available, so this change plays as a cut";
+				readonly help: string;
 			};
 			readonly storyBackgroundUnchanged: {
 				readonly title: "Unchanged background";
 				readonly description: "A row transitioning to the background already on screen";
 				readonly message: "This background is already on screen, so the transition changes nothing";
+				readonly help: string;
 			};
 			readonly blueprintReferenceMissing: {
 				readonly title: "Missing target";
@@ -13696,40 +13824,47 @@ declare const en: {
 				readonly messageChoice: "Names a choice that no longer exists";
 				readonly messageEnding: "Names an ending that no longer exists";
 				readonly messageCharacter: "Names a character that no longer exists";
-				readonly messageTextKey: "Names a text key the project does not declare";
+				readonly messageTextKey: "Names a translation key the project does not declare";
 				readonly messageDlc: "Names a DLC the project does not have";
 				readonly messageInputAction: "Names an input action the project does not declare";
+				readonly help: string;
 			};
 			readonly blueprintElementRefMissing: {
 				readonly title: "Missing widget";
 				readonly description: "A node bound to a widget the project no longer has";
 				readonly message: "Bound to a widget that no longer exists";
+				readonly help: string;
 			};
 			readonly blueprintFnTargetMissing: {
 				readonly title: "Missing function";
 				readonly description: "A Call Fn node whose function does not exist in its scope";
 				readonly message: "Calls a function that does not exist in this scope";
 				readonly messageNamed: "Calls {name}, which does not exist in this scope";
+				readonly help: string;
 			};
 			readonly blueprintUnreachableNode: {
 				readonly title: "Unreachable node";
 				readonly description: "A node no entry point in its graph can reach";
 				readonly message: "Nothing reaches this node, so it never runs";
+				readonly help: string;
 			};
 			readonly blueprintDlcEntranceUnguarded: {
 				readonly title: "Unguarded DLC entrance";
-				readonly description: "A Start Story into a DLC's story, with nothing asking whether the DLC is here";
-				readonly message: "Nothing in this graph asks whether the DLC is installed";
+				readonly description: "A Start Game node starting a DLC's story, with nothing asking whether the DLC is installed";
+				readonly message: "No Is DLC Installed in this layer asks about this story's DLC";
+				readonly help: string;
 			};
 			readonly blueprintEmptyEvent: {
 				readonly title: "Empty event";
 				readonly description: "An event layer with nothing wired to run";
 				readonly message: "This event runs nothing";
+				readonly help: string;
 			};
 			readonly blueprintUnknownNode: {
 				readonly title: "Unknown node type";
 				readonly description: "A node whose type the project cannot load";
 				readonly message: "{type} is not loaded, so this node will not run in the game";
+				readonly help: string;
 			};
 			readonly blueprintAssembledAssetName: {
 				readonly title: "Asset name assembled at run time";
@@ -13738,105 +13873,130 @@ declare const en: {
 				readonly messageBinding: "\"{prop}\" on \"{element}\" is bound to an asset name assembled at run time (from \"{origin}\"). A game package carries only the assets whose names are written in the project, so nothing will be there in the released game. Choose the asset in the asset picker, or read one already chosen from a list row or a variable";
 				readonly messageUnloadedNode: "\"{pin}\" on \"{node}\" receives an asset name from {origin}, which is not loaded, so the asset it names will not be in the released game. Install or switch on the plugin that provides this node type, then build again";
 				readonly messageUnloadedNodeBinding: "\"{prop}\" on \"{element}\" is bound to an asset name from {origin}, which is not loaded, so the asset it names will not be in the released game. Install or switch on the plugin that provides this node type, then build again";
-			};
-			readonly uiUnlocalizedText: {
-				readonly title: "Unlocalized text";
-				readonly description: "Text written straight onto a widget in a project that has a second language";
-				readonly message: "{text} is not bound to a localization key";
+				readonly help: string;
 			};
 			readonly uiPageUnreachable: {
 				readonly title: "Unreachable page";
 				readonly description: "A page nothing opens, embeds, or starts on";
 				readonly message: "Nothing opens this page";
+				readonly help: string;
 			};
 			readonly uiEmptyBehavior: {
 				readonly title: "Button with no handler";
 				readonly description: "A clickable widget nothing listens to";
 				readonly message: "Nothing runs when this is clicked";
+				readonly help: string;
 			};
 			readonly uiUnknownWidget: {
 				readonly title: "Unknown widget type";
 				readonly description: "A widget whose type the project cannot load";
 				readonly message: "{type} is not loaded, so this widget will not be drawn in the game";
+				readonly help: string;
 			};
 			readonly uiComponentMissing: {
 				readonly title: "Missing component";
 				readonly description: "An instance of a component the project does not have";
 				readonly message: "This instance points at a component the project does not have";
+				readonly help: string;
 			};
 			readonly uiFrameTargetMissing: {
 				readonly title: "Missing embedded page";
 				readonly description: "A Page widget embedding a page the project does not have";
 				readonly message: "This Page widget embeds a page the project does not have";
+				readonly help: string;
 			};
 			readonly uiFrameLoop: {
 				readonly title: "Circular embedded page";
 				readonly description: "A Page widget embedding a page that leads back to it";
 				readonly message: "This Page widget embeds a page that leads back to it";
+				readonly help: string;
 			};
 			readonly uiListItemFieldMissing: {
 				readonly title: "Missing item field";
 				readonly description: "A widget bound to an item field the list drawing it does not declare";
 				readonly message: "This is bound to an item field the list does not declare, so every row shows the same value";
+				readonly help: string;
+			};
+			readonly uiComponentParamMissing: {
+				readonly title: "Missing text parameter";
+				readonly description: "A widget in a component showing a parameter the component does not declare as text";
+				readonly message: "This shows a parameter the component does not declare as text, so every placement shows no words here";
+				readonly messageOutside: "This shows a component parameter but is not inside a component, so the game shows no words here";
+				readonly help: string;
 			};
 			readonly uiListTextUntranslated: {
 				readonly title: "Untranslated list content";
 				readonly description: "Words written into a list's content in a project that has a second language";
 				readonly message: "{text} and the rest of this list's content show as written in every language";
+				readonly help: string;
 			};
 			readonly uiLocalizationKeyMissing: {
-				readonly title: "Missing localization key";
+				readonly title: "Missing translation key";
 				readonly description: "A widget reading its words from a key the project does not have";
 				readonly message: "Reads its words from {key}, which the project does not have";
+				readonly help: string;
 			};
 			readonly uiGestureAnsweredTwice: {
 				readonly title: "Gesture answered twice";
 				readonly description: "A widget with a pointer handler of its own, on a page whose action answers the same gesture";
 				readonly message: "{action} on this page answers the same gesture this widget does, so both run";
+				readonly help: string;
 			};
 			readonly blueprintSaveFieldEmpty: {
 				readonly title: "Empty save field";
 				readonly description: "A Save Game node that will run with a declared save field left empty";
 				readonly message: "{field} is empty, so this save is written with its default instead";
+				readonly help: string;
 			};
 			readonly blueprintRequiredInputUnwired: {
 				readonly title: "Empty input";
 				readonly description: "A node that will run with a required input left unconnected";
 				readonly message: "{node} has nothing connected to {pin}";
+				readonly help: string;
 			};
 			readonly blueprintStartSceneForeign: {
 				readonly title: "Scene from another story";
 				readonly description: "A Start Game node whose scene is not in the story it names";
-				readonly message: "This scene is in {owner}, not in {story}, so starting the game here stops it";
+				readonly message: "This scene is in {owner}, not in {story}, so the game cannot start from it";
+				readonly help: string;
 			};
 			readonly variablesUndeclared: {
 				readonly title: "Undeclared variable";
 				readonly description: "A variable used without a declaration";
 				readonly message: "{variable} is used but never declared";
+				readonly messageUnnamed: "This row uses a variable that is not declared anywhere";
+				readonly help: string;
 			};
 			readonly variablesUnused: {
 				readonly title: "Unused variable";
 				readonly description: "A variable declared but never read or written";
 				readonly message: "{variable} is declared but never used";
+				readonly help: string;
 			};
 			readonly variablesNameCollision: {
 				readonly title: "Variable name collision";
 				readonly description: "One name declared in two places";
 				readonly message: "{variable} is declared twice as a persistent variable";
+				readonly messageSaved: "{variable} is declared twice as a saved variable";
+				readonly help: string;
 			};
 			readonly variablesConditionNeverHolds: {
 				readonly title: "Condition no path can satisfy";
 				readonly description: "A condition whose variable can never reach the value it tests for";
-				readonly message: "{variable} is never more than {bound} here, so this condition cannot hold";
+				readonly message: "{variable} is always within {bound} here, so this condition cannot hold";
+				readonly messageUnnamed: "A variable with no declaration is always within {bound} here, so this condition cannot hold";
+				readonly help: string;
 			};
 			readonly variablesReadNeverWritten: {
 				readonly title: "Condition nothing can change";
 				readonly description: "A variable a condition tests, that nothing in the project ever assigns";
 				readonly message: "{variable} is tested by {conditions} but nothing ever sets it";
+				readonly messageUnnamed: "A variable with no declaration is tested by {conditions} and nothing ever sets it";
 				readonly conditionCount: {
 					readonly one: "{count} condition";
 					readonly other: "{count} conditions";
 				};
+				readonly help: string;
 			};
 			readonly variablesRandomOutsideAssignment: {
 				readonly title: "Random outside an assignment";
@@ -13844,33 +14004,39 @@ declare const en: {
 				readonly message: "{fn}() is re-rolled every time this condition is tested, so the branch can change between checks. Roll it once with /set, then test that variable";
 				readonly messageChoiceOption: "{fn}() is re-rolled every time the menu draws, so this option flickers. Roll it once with /set, then test that variable";
 				readonly messageInterpolation: "{fn}() is re-rolled every time this line draws, so the value changes on every redraw. Roll it once with /set, then show that variable";
+				readonly help: string;
 			};
 			readonly textOverlong: {
 				readonly title: "Overlong line";
 				readonly description: "A line wider than the dialogue box holds";
-				readonly message: "{width} characters wide, over {max}";
+				readonly message: "{width} columns wide, over {max}";
+				readonly help: string;
 			};
 			readonly textEmpty: {
 				readonly title: "Empty line";
-				readonly description: "A dialogue row with no text";
+				readonly description: "A narration, dialogue or choice option row with no text";
 				readonly message: "This line has no text";
+				readonly help: string;
 			};
 			readonly localizationMissing: {
 				readonly title: "Missing translation";
 				readonly description: "A line or interface text with no translation in a target language";
 				readonly message: "No {locale} translation";
 				readonly messageInterface: "No {locale} translation of {text}";
+				readonly help: string;
 			};
 			readonly localizationStale: {
 				readonly title: "Stale translation";
 				readonly description: "The source line changed after it was translated";
 				readonly message: "{locale} translation is older than the line";
 				readonly messageInterface: "{locale} translation of {text} is older than the text";
+				readonly help: string;
 			};
 			readonly localizationMarkup: {
 				readonly title: "Translation drops styling";
-				readonly description: "The line is styled and the translation renders it plainly";
-				readonly message: "{locale} translation does not carry this line's styling";
+				readonly description: "The line has styling, pauses or inline events the translation does not carry";
+				readonly message: "{locale} translation does not carry all of this line's styling, pauses and inline events";
+				readonly help: string;
 			};
 			readonly localizationOrphan: {
 				readonly title: "Orphan translation";
@@ -13880,16 +14046,19 @@ declare const en: {
 					readonly one: "{count} {locale} translation";
 					readonly other: "{count} {locale} translations";
 				};
+				readonly help: string;
 			};
 			readonly voiceMissing: {
 				readonly title: "Missing voice";
 				readonly description: "A line with no recording in a voiced language";
 				readonly message: "No {locale} recording";
+				readonly help: string;
 			};
 			readonly voiceStale: {
 				readonly title: "Stale voice";
 				readonly description: "The line changed after it was recorded";
 				readonly message: "{locale} recording is older than the line";
+				readonly help: string;
 			};
 			readonly voiceOrphan: {
 				readonly title: "Orphan voice";
@@ -13899,13 +14068,15 @@ declare const en: {
 					readonly one: "{count} {locale} recording";
 					readonly other: "{count} {locale} recordings";
 				};
+				readonly help: string;
 			};
 			readonly brandBrokenLink: {
 				readonly title: "Broken color link";
 				readonly description: "A color pointing at a palette entry that resolves to nothing";
-				readonly message: "{where} uses {color}, which the palette does not have";
-				readonly messageChain: "{where} uses {color}, which links on to {missing}, a color the palette does not have";
+				readonly message: "{where} uses a color the palette does not have";
+				readonly messageChain: "{where} uses {color}, which follows a color the palette does not have";
 				readonly messageCycle: "{where} uses {color}, whose links lead back to themselves";
+				readonly help: string;
 			};
 			readonly typographyGlyphCoverage: {
 				readonly title: "Missing glyphs";
@@ -13916,19 +14087,23 @@ declare const en: {
 					readonly other: "{count} times";
 				};
 				readonly messageInLanguage: "No project font can draw \u201C{character}\u201D in {language} ({occurrences})";
+				readonly messageInState: "No project font can draw \u201C{character}\u201D in the \u201C{state}\u201D state ({occurrences})";
+				readonly messageInLanguageInState: "No project font can draw \u201C{character}\u201D in {language} in the \u201C{state}\u201D state ({occurrences})";
 				readonly messageMore: "{characters} no project font can draw";
 				readonly moreCharacterCount: {
 					readonly one: "{count} more character";
 					readonly other: "{count} more characters";
 				};
 				readonly messageMoreInLanguage: "{characters} no project font can draw in {language}";
-				readonly messageUnreadable: "{font} could not be read, so glyph coverage was not checked";
+				readonly messageUnreadable: "{font} could not be read, so no character was checked";
 				readonly messageUnloadable: "{font} is a .{format} font, which the game cannot draw with";
+				readonly help: string;
 			};
 			readonly typographyLocaleNoFont: {
 				readonly title: "Language with no font";
 				readonly description: "A language every font of the project is restricted away from";
-				readonly message: "No project font is set for {language}";
+				readonly message: "Every project font is limited to languages other than {language}";
+				readonly help: string;
 			};
 		};
 		readonly message: {
@@ -13974,6 +14149,22 @@ declare const en: {
 			readonly showAll: "Show all {count}";
 			readonly lineAria: "Line {line}";
 			readonly findPlaceholder: "Find in problems";
+			readonly scopeProject: "Whole project";
+			readonly scopeOpenEditors: "Open editors";
+			readonly scopeActiveEditor: "Current editor";
+			readonly scopeAria: "Show problems from";
+			readonly severityAria: "Severity";
+			readonly groupAria: "Group";
+			readonly emptyOpenEditors: "No problems in the open editors";
+			readonly emptyActiveEditor: "No problems in the current editor";
+			readonly emptyFiltered: "No problems at the selected severity";
+			readonly explain: "About this rule";
+			readonly settings: "Check settings";
+			readonly rerunHint: "Check the whole project again, re-reading the asset files on disk";
+			readonly jumpFailed: "This location can no longer be opened";
+		};
+		readonly statusBar: {
+			readonly counts: "Problems: {errors}, {warnings}, {infos}";
 		};
 		readonly command: {
 			readonly runProject: "Check project";
@@ -13996,6 +14187,7 @@ declare const en: {
 			};
 			readonly blockedHint: "Change this in Project \u25B8 Project \u25B8 Check before building";
 			readonly skipped: "Project check skipped";
+			readonly viewProblems: "View problems";
 		};
 		readonly settings: {
 			readonly runOnBuild: "Check before building";
@@ -14005,6 +14197,8 @@ declare const en: {
 			readonly failBuildOnWarning: "Warnings and errors";
 			readonly optionMaxChars: "Maximum width";
 			readonly optionCountMode: "Counting";
+			readonly optionMaxMegabytes: "Largest file (MB)";
+			readonly optionMaxCharacters: "Characters listed";
 			readonly countModeEastAsianWidth: "Wide = 2 columns";
 			readonly countModeCodePoints: "All = 1 column";
 		};
@@ -14066,7 +14260,7 @@ declare const en: {
 			readonly characters: "Characters";
 			readonly dictionaryTerms: "Dictionary terms";
 			readonly transformPresets: "Transform presets";
-			readonly localizationKeys: "Localization keys";
+			readonly localizationKeys: "Translation keys";
 			readonly projectLanguages: "Languages";
 			readonly projectPlugins: "Plugins";
 			readonly saveFields: "Save fields";
@@ -14165,9 +14359,9 @@ declare const en: {
 			readonly statusReviewed: "Now reviewed";
 		};
 		readonly localizationKeys: {
-			readonly added: "Named string added";
-			readonly removed: "Named string removed";
-			readonly changed: "Named string changed";
+			readonly added: "Translation key added";
+			readonly removed: "Translation key removed";
+			readonly changed: "Translation key changed";
 		};
 		readonly uiDocument: {
 			readonly renamed: "Interface renamed";
@@ -14840,6 +15034,7 @@ declare const en: {
 			readonly quality: "Checks";
 			readonly version: "Versions";
 			readonly ship: "Shipping";
+			readonly checks: "Check rules";
 		};
 		readonly ui: {
 			readonly title: "Help";
@@ -15643,14 +15838,25 @@ export type SearchJumpTarget = {
 } | {
 	kind: "character";
 	characterId: string;
-} | {
+}
+/**
+ * A page or a stage layer. With `elementId`, the widget on it to select once its editor opens - an
+ * optional field rather than a variant of its own, so every consumer that opens the page keeps
+ * opening it and only the ones that can say which widget say so.
+ */
+ | {
 	kind: "uiSurface";
 	surfaceId: string;
+	elementId?: string;
 }
-/** A component definition: its own editor tab, the one the component library opens. */
+/**
+ * A component definition: its own editor tab, the one the component library opens. With
+ * `elementId`, the widget inside the definition to select, as for a page.
+ */
  | {
 	kind: "uiComponent";
 	componentId: string;
+	elementId?: string;
 } | {
 	kind: "asset";
 	assetId: string;
@@ -15676,21 +15882,72 @@ export type SearchJumpTarget = {
 	focusEventId?: string;
 	focusFunctionId?: string;
 	focusNodeId?: string;
-} | {
+}
+/**
+ * A named string: its row in a translation table, which is the one place its words are edited.
+ * Opens the table of the project's first translated language; a project with none has no table,
+ * and the jump shows the Localization panel instead, where a language is added.
+ */
+ | {
 	kind: "localizationKey";
 	keyName: string;
 }
 /**
- * A project-level story variable — the panel that owns it, since no row declares one.
- *
- * Carries the identity even though the jump can only reveal the panel today, for the reason
- * `localizationKey` carries its key: the target says what it points at, and the day the panel can
- * be told which row to reveal, nothing that produces one of these has to change.
+ * A project-level story variable: its row in the Variables panel, selected and scrolled into view.
+ * `variableId` is the registry entry's id, or the declaration row's for one a story declares.
  */
  | {
 	kind: "storyVariable";
 	scope: "saved" | "persistent";
 	variableId: string;
+}
+/**
+ * A translation table - one language's - and, with `unitId`, the row of one translation unit in
+ * it, scrolled into view and marked.
+ *
+ * The table lists one source at a time, so a row is found under the source it belongs to:
+ * `storyId` for a story's lines and scene names, absent for the interface's words, the named keys
+ * and the plugins' words. A character's name heads every story's rows and needs neither.
+ */
+ | {
+	kind: "translation";
+	locale: string;
+	unitId?: string;
+	storyId?: string;
+}
+/**
+ * A voice table - one voiced language's - and, with `unitId` (a line's text id), that line's row,
+ * where its take is linked. `storyId` names the story the line is in; without it the table looks
+ * the line up itself.
+ */
+ | {
+	kind: "voiceLine";
+	locale: string;
+	unitId?: string;
+	storyId?: string;
+}
+/** A story motion, open in its own editor. */
+ | {
+	kind: "storyMotion";
+	animationId: string;
+}
+/**
+ * A page of Project settings - the panel's sub-pages - and, with `part`, the part of it to scroll
+ * into view: `fonts` is the project's font stack on the Design page.
+ */
+ | {
+	kind: "projectPage";
+	page: "app" | "game" | "design" | "project" | "runtimes" | "settings";
+	part?: "fonts";
+}
+/**
+ * A story's own row in the Story panel's list, selected and scrolled into view - the place a story
+ * is renamed or deleted, and the one way into a story whose document cannot be opened.
+ */
+ | {
+	kind: "storyEntry";
+	storyId: string;
+	storyName: string;
 };
 type ModelBundleFormat = "live2d-cubism4" | "live2d-cubism2" | "spine-binary" | "spine-json" | "unknown";
 export declare enum AssetType {
@@ -16726,6 +16983,23 @@ type SelectionState = {
 	type: "storyBlock";
 	data: StoryBlockSelection;
 };
+type UITextMigrationChangeKind = "marksKept" | "bindingDropped" | "missingKey" | "keyDiffered";
+type UITextMigrationChange = {
+	kind: UITextMigrationChangeKind;
+	elementId: string;
+	/** The prop the words are in (`text`, `label`, `placeholder`). */
+	prop: string;
+	/** The key the element named. */
+	keyName: string;
+	/** Where the element is: a page, or a component definition. Absent for an element on neither. */
+	surfaceId?: string;
+	componentId?: string;
+};
+type UITextCarriedKeys = Record<string, {
+	words: string;
+	translations?: Record<string, LocalizationUnit>;
+}>;
+type CarriedTranslations = Record<LocaleCode, Record<string, LocalizationUnit>>;
 type LiveUIComponentShell = Omit<UIComponentDefinition, "elements">;
 type LiveUIParts = {
 	/** Records of the shared element map. */
@@ -16811,6 +17085,20 @@ type UIEditorClipboardPayload = {
 	source?: UIEditorClipboardSource;
 	/** Absent when the copied selection references no importable file. */
 	assets?: UIEditorClipboardAssets;
+	/**
+	 * The words and translations of the translation keys the copied widgets name, filled when the copy
+	 * is published for other windows. A project that lacks one of the keys receives its words on the
+	 * widgets instead (`settleIncomingUITextSources`); absent on an in-window copy, whose project
+	 * has every key it names.
+	 */
+	textKeys?: UITextCarriedKeys;
+	/**
+	 * What every language of the copying project says about the words the copied widgets write
+	 * directly, by unit id under the originals' ids (`listUITextOwnUnits`). Filled when the copy is
+	 * published; the paste writes them under the copies' ids. A paste without them - an in-window copy
+	 * not yet published, a duplicate - reads the originals' translations from the project itself.
+	 */
+	translations?: CarriedTranslations;
 	sourceSurfaceId: string;
 	/** Top-level roots in the copied selection (original ids). */
 	topLevelElementIds: UIElementId[];
@@ -16851,6 +17139,18 @@ type ImportTemplateBundleInput = {
 	graphs: unknown;
 	placement: ImportTemplatePlacement;
 	assetIdMap?: Record<string, string>;
+	/**
+	 * The words, and translations, of the keys the document's widgets name - for the ones this
+	 * project lacks, which arrive holding those words themselves (`settleIncomingUITextSources`).
+	 */
+	textKeys?: UITextCarriedKeys;
+	/**
+	 * What every language says about the words the document's widgets write directly, by unit id
+	 * under the ids the widgets have in `document` - a page copied in another window brings them.
+	 * Without it, widgets whose ids this project already translates (a page copied in this window)
+	 * take those translations.
+	 */
+	translations?: CarriedTranslations;
 };
 declare class UIDocumentService extends Service<UIDocumentService> implements IUIDocumentService {
 	private document;
@@ -16864,6 +17164,8 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	private opSink;
 	private historySuppressionDepth;
 	private readonly contentRevisions;
+	/** What the v13 step changed that an author can see, until the workspace has said so. */
+	private textSourceMigrationChanges;
 	protected init(ctx: WorkspaceContext, depend: (services: Service[]) => Promise<void>): Promise<void>;
 	getDocument(): UIDocument;
 	/**
@@ -16946,6 +17248,60 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	}): void;
 	updateElementLayouts(layoutPatches: Record<string, Partial<UILayout>>): void;
 	updateElementProps(elementId: string, propsPatch: Record<string, unknown>): void;
+	/**
+	 * Every widget that reads its words from `keyName`, turned into one that holds `words` itself.
+	 *
+	 * What removing a key does to the widgets that use it: each keeps showing what it showed, and none
+	 * is left naming a key the project no longer has. Component definitions' widgets are included; an
+	 * instance holds none of its definition's words, but a text parameter's value it reads from the key
+	 * becomes the key's words, given directly (prop `param.<paramId>`). One change to the document,
+	 * outside any page's undo history, like the removal of the key it goes with. Returns each site it
+	 * converted, for the translations that go with the words (`ui:<elementId>.<prop>`).
+	 */
+	giveKeyedWidgetsTheirWords(keyName: string, words: string): {
+		elementId: string;
+		prop: string;
+	}[];
+	/**
+	 * Whether this project has a named key, for settling elements that arrive from elsewhere. A key
+	 * registry that has not been read answers yes for every key, so nothing is converted on a guess.
+	 */
+	private readonly hasTextKey;
+	/**
+	 * The translations of the keys arriving widgets were turned away from, filed under the widgets'
+	 * own units in this project's languages. `converted` carries the widgets' ids in this document.
+	 *
+	 * In the background: a language's library may still have to be read, and the elements have
+	 * arrived already. A language the keys came with no translation for gets none.
+	 */
+	private adoptArrivingTranslations;
+	/**
+	 * Give copied widgets the translations their originals' own words have, under the copies' ids.
+	 *
+	 * A widget's own words are translated through a unit named after the widget, so a copy - pasted,
+	 * duplicated, inside a duplicated page or component - would otherwise arrive translated in no
+	 * language. `table` is the arriving elements under their old ids, `idMap` what each became; `skip`
+	 * are the sites whose words came from a key this project lacks, which bring the key's translations
+	 * instead (`adoptArrivingTranslations`). `extra` are units owned by something other than an element
+	 * - a copied component's parameter defaults - already re-keyed, old id to new.
+	 *
+	 * `carried` is what a clipboard brought with it, which is what a paste from another project has
+	 * to go on, and a copy as it was when it was made. Without it the originals are this project's own
+	 * and their translations are read from its documents. Either way only languages this project
+	 * declares are written, a review is not inherited, and the write is not part of the paste's undo
+	 * step (`carriedTranslations.ts`).
+	 */
+	private carryCopiedTranslations;
+	/**
+	 * The changes the v13 step made on opening this document that an author can see, handed over
+	 * once: the workspace tells the author about them in one notice, and a second ask is empty.
+	 */
+	takeTextSourceMigrationChanges(): UITextMigrationChange[];
+	/**
+	 * The words a widget inserted into this project is given: in the project's source language, the
+	 * language its game is written in (`widgetDefaultWordsFor`).
+	 */
+	private widgetDefaultWords;
 	/** A fresh id for something this document will own. */
 	generateId(): string;
 	/**
@@ -17104,6 +17460,22 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	private getCommonSurfaceIdForElements;
 	private filterLinkedComponentLayoutPatch;
 	private migrateIfNeeded;
+	/**
+	 * The v13 step, for the project's own document as it is opened (`textSourceMigration.ts`).
+	 *
+	 * Not part of {@link migrateIfNeeded}, which is also how a template or a page copied from another
+	 * project comes in: this step reads the project's key registry and translation files, and the
+	 * translation edits it makes are written here, through the localization service, before the
+	 * document itself is saved by `load`. Written first so that a document still at v12 on disk -
+	 * its own save failed - is migrated again on the next open, and the edits are such that applying
+	 * them twice changes nothing.
+	 *
+	 * A key registry or a language file that cannot be read stops the open rather than being read
+	 * as empty: an element whose key could not be found is turned into one that holds its own words,
+	 * and a registry that is merely unreadable today would turn every keyed element in the project
+	 * into one, for good.
+	 */
+	private migrateTextSources;
 	/**
 	 * Every `nl.image` written in the shape that came before `imageFill`, rewritten into it.
 	 *
@@ -17292,11 +17664,38 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	 * deletion, and sweeping would make that a data loss with no warning.
 	 */
 	setComponentParams(componentId: string, params: UIComponentParam[]): void;
-	/** Set one param value on one instance. An empty string is a value, not a reset. */
+	/**
+	 * Set one param value on one instance. An empty string is a value, not a reset.
+	 *
+	 * Words written for a text parameter replace a key the instance named for it: a value holds one
+	 * or the other (`UIComponentLink.paramKeys`).
+	 */
 	setComponentInstanceParam(elementId: string, paramId: string, value: string): void;
+	/**
+	 * Name the translation key one instance's text parameter is read from, or (`null`) name none.
+	 *
+	 * Naming a key removes the words the instance held for the parameter - a value holds one source -
+	 * and naming none leaves the parameter with neither, which falls back to the definition's default.
+	 */
+	setComponentInstanceParamKey(elementId: string, paramId: string, keyName: string | null): void;
 	deleteComponents(componentIds: string[]): void;
 	duplicateComponent(componentId: string): UIComponentDefinition | null;
 	updateComponentElementLayout(componentId: string, elementId: string, layoutPatch: Partial<UILayout>): void;
+	/**
+	 * Bind one prop of one element of a component definition to a field of its list row or to a text
+	 * parameter of the component - the two value bindings that need no blueprint - or (`null`) unbind
+	 * it. A definition's elements take no Blueprint Value (`ComponentDocumentServiceAdapter`), so there
+	 * is no blueprint to clear on the way.
+	 */
+	setComponentElementValueBinding(componentId: string, elementId: string, propPath: string, binding: Extract<UIElementValueBinding, {
+		kind: "listItemField" | "componentParam";
+	}> | null): void;
+	/**
+	 * Show one of a component's text parameters in the words of an element of its definition, or
+	 * (`null`) stop showing one. The component is the one whose definition holds the element; an
+	 * 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;
 	updateComponentElementAnimation(componentId: string, elementId: string, animation: UIPageAnimationSettings | null): void;
 	updateComponentElementExtra(componentId: string, elementId: string, extraPatch: Record<string, unknown>): void;
@@ -17315,7 +17714,7 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	 */
 	groupComponentElements(componentId: string, elementIds: readonly string[]): string | null;
 	createComponentElement(componentId: string, parentId: string, type: string, layoutPatch?: Partial<UILayout>): UIElement | null;
-	pasteComponentClipboardPayload(componentId: string, targetParentId: string, beforeChildId: string | null, payload: UIEditorClipboardPayload): {
+	pasteComponentClipboardPayload(componentId: string, targetParentId: string, beforeChildId: string | null, incoming: UIEditorClipboardPayload): {
 		ok: true;
 		newRootIds: string[];
 	} | {
@@ -17325,7 +17724,7 @@ declare class UIDocumentService extends Service<UIDocumentService> implements IU
 	createComponentInstance(parentId: string, componentId: string, layoutPatch?: Partial<UILayout>): UIElement;
 	unlinkComponentInstance(elementId: string): string[];
 	createElement(parentId: string, type: string, layoutPatch?: Partial<UILayout>): UIElement;
-	pasteClipboardPayload(surfaceId: string, targetParentId: string, beforeChildId: string | null, payload: UIEditorClipboardPayload): {
+	pasteClipboardPayload(surfaceId: string, targetParentId: string, beforeChildId: string | null, incoming: UIEditorClipboardPayload): {
 		ok: true;
 		newRootIds: string[];
 	} | {
@@ -18815,7 +19214,9 @@ declare const HELP_TOPIC_IDS: readonly [
 	"screenEffects",
 	"plugins"
 ];
-type HelpTopicId = (typeof HELP_TOPIC_IDS)[number];
+type StaticHelpTopicId = (typeof HELP_TOPIC_IDS)[number];
+type LintRuleHelpTopicId = `lintRule.${string}`;
+type HelpTopicId = StaticHelpTopicId | LintRuleHelpTopicId;
 interface PanelComponentProps<TPayload = any> {
 	panelId: string;
 	payload?: TPayload;
@@ -19678,6 +20079,13 @@ export type RuntimePluginLocale = {
 	 * added after the plugin was installed. `null` when the project declares no such key.
 	 */
 	text(key: string): string | null;
+	/**
+	 * Words this plugin wrote directly and offered for translation from its studio entry
+	 * (`app.services.localization.registerWords`), in the language the game is running in: the
+	 * translation of the unit `id` names along the language's fallback chain, else `text` - the words
+	 * as written, which the plugin passes because the game carries translations and not source words.
+	 */
+	words(id: string, text: string): string;
 };
 /**
  * `menu` - the whole menu bar above the game, declared at once.
@@ -20572,6 +20980,22 @@ export type FreezeGuard = {
 	run<A extends unknown[], R>(handler: (...args: A) => R): (...args: A) => R | undefined;
 };
 declare function useFreezeGuard(scope?: string | readonly string[]): FreezeGuard;
+type WordsSourceValue = {
+	/** The words written directly; with a key, what shows if the key is not in the running game. */
+	text: string;
+	/** The translation key the words are read from, or null for words written directly. */
+	key: string | null;
+};
+type WordsSourceFieldProps = {
+	value: WordsSourceValue;
+	onChange: (next: WordsSourceValue) => void;
+	/** Words over several lines; one line when absent. */
+	multiline?: boolean;
+	disabled?: boolean;
+	/** Resets the box's draft when it changes - the id of whatever the words belong to. */
+	draftResetKey?: string;
+};
+declare function WordsSourceField({ value, onChange, multiline, disabled, draftResetKey }: WordsSourceFieldProps): React$1.ReactElement;
 type DivProps = React$1.HTMLAttributes<HTMLDivElement>;
 declare function PluginAssetSelector(props: AssetSelectorProps): React$1.JSX.Element | null;
 export type PluginPanelRootProps = DivProps & {
@@ -20660,6 +21084,14 @@ declare const pluginUi: Readonly<{
 	CardFooter: typeof CardFooter;
 	InteractiveCard: typeof InteractiveCard;
 	AssetSelector: typeof PluginAssetSelector;
+	/**
+	 * Words a player reads, written directly or read from one of the project's translation keys - the
+	 * same choice, key list and in-place key editing as Studio's own text and button labels. Controlled:
+	 * `value` is `{ text, key }` with `key` null for words written directly, and `onChange` is
+	 * handed the next one. Words written directly are translated when the plugin offers them with
+	 * `app.services.localization.registerWords`; words read from a key are translated as the key.
+	 */
+	WordsField: typeof WordsSourceField;
 	Panel: Readonly<{
 		Root: typeof PluginPanelRoot;
 		Header: typeof PluginPanelHeader;
@@ -20758,6 +21190,7 @@ export declare const ui: Readonly<{
 	CardFooter: typeof CardFooter;
 	InteractiveCard: typeof InteractiveCard;
 	AssetSelector: typeof PluginAssetSelector;
+	WordsField: typeof WordsSourceField;
 	Panel: Readonly<{
 		Root: typeof PluginPanelRoot;
 		Header: typeof PluginPanelHeader;
@@ -20939,7 +21372,7 @@ export type PluginAssetsService = {
 	revokeObjectUrl(url: string): void;
 };
 /** An active editor locale code (built-in like "en"/"zh", or a plugin-provided locale). */
-export type LocaleCode = string;
+type LocaleCode$1 = string;
 /**
  * A plugin's own message tables: `locale code -> (message key -> string)`. This
  * is the plugin's private catalog, unrelated to Studio's own translations.
@@ -20959,7 +21392,7 @@ export type PluginMessageBundle = {
  * {@link PluginI18n.onLocaleChange} to re-render on a language switch.
  */
 export type PluginTranslator = {
-	readonly locale: LocaleCode;
+	readonly locale: LocaleCode$1;
 	t(key: string, params?: Record<string, string | number>): string;
 };
 /**
@@ -20969,14 +21402,14 @@ export type PluginTranslator = {
  */
 export type PluginI18n = {
 	/** The editor's active locale code. */
-	readonly locale: LocaleCode;
+	readonly locale: LocaleCode$1;
 	/**
 	 * Subscribe to editor-language changes. The listener fires with the new
 	 * locale code whenever the active editor language changes. Returns a
 	 * {@link PluginCleanup} (also tracked by the host, so it is reclaimed on
 	 * unload even if you forget to call it).
 	 */
-	onLocaleChange(listener: (locale: LocaleCode) => void): PluginCleanup;
+	onLocaleChange(listener: (locale: LocaleCode$1) => void): PluginCleanup;
 	/** Locale-aware number formatting bound to the editor's active locale. */
 	formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
 	/** Locale-aware date formatting bound to the editor's active locale. */
@@ -21056,15 +21489,45 @@ export type PluginInterfaceService = {
 	listGlobalFns(): PluginBlueprintFnEntry[];
 };
 /**
- * The project's own localization keys, read-only.
+ * One of the words a plugin puts in front of a player, offered for translation.
+ *
+ * `id` is the plugin's own (letters, digits, and `.` `_` `-` between them) and has to stay the same
+ * while the words are the same thing - a translation is kept against it, so an id made from the words
+ * themselves would lose every translation the moment the author corrected a letter. The translation
+ * unit is `plugin:<pluginId>/<id>`, scoped to the plugin by the host.
+ */
+export type PluginWordsEntry = {
+	id: string;
+	/** The words, in the project's source language. */
+	text: string;
+	/** Where a player meets them, for a translator: "File › Save". The plugin's name when absent. */
+	context?: string;
+};
+/** A plugin's words as they are now, and a way for the host to hear that they changed. */
+export type PluginWordsSource = {
+	list(): readonly PluginWordsEntry[];
+	subscribe?(listener: () => void): () => void;
+};
+/**
+ * The project's own localization keys, read-only, and a place to offer the plugin's own words.
  *
- * A plugin that puts words in front of a player writes them as keys through this list rather than
- * as literals, so they travel with everything else the project translates. Empty before the keys
- * document has loaded, which is a moment rather than a state - subscribe through
- * `services.workspace.registerReloader` if a panel has to re-read it.
+ * A plugin that puts words in front of a player either names a key from this list - one of the
+ * project's shared words - or writes them directly and offers them with `registerWords`, so they
+ * travel with everything else the project translates. Empty before the keys document has loaded,
+ * which is a moment rather than a state - subscribe through `services.workspace.registerReloader` if
+ * a panel has to re-read it.
  */
 export type PluginLocalizationService = {
 	listKeys(): PluginLocalizationKeyEntry[];
+	/**
+	 * Offer the plugin's own words to the project's translation table and exports.
+	 *
+	 * Each listed entry with a letter in it gets a row under the plugin's name; the runtime entry
+	 * reads a word back in the player's language with `app.game.locale.words(id, text)`. List what
+	 * the author wrote directly; words read from a key are translated as the key and need no entry.
+	 * Call `subscribe`'s listener whenever the list would answer differently.
+	 */
+	registerWords(source: PluginWordsSource): PluginCleanup;
 };
 export type PluginServices = {
 	storage: PluginStorageService;
@@ -21182,6 +21645,7 @@ export {
 	GameSurfaceMountDetail as RuntimePluginSurfaceMountTimelineDetail,
 	GameTimelineSpanDetails as RuntimePluginTimelineSpanDetails,
 	GameTimelineSpanName as RuntimePluginTimelineSpanName,
+	LocaleCode$1 as LocaleCode,
 	SelectOption$1 as SelectOption,
 };