narraleaf-studio 1.6.2 → 1.7.0

package/dist/_api.d.ts

@@ -812,13 +812,26 @@ type StoryActionPayload = {
 	transform?: StoryTransformRef;
 } | {
 	action: "text";
-	operation: "create" | "setText" | "show" | "hide" | "setFontSize" | "setFontColor";
+	/**
+	 * `setFont` is the combined op: it sets whichever of {@link fontSize}, {@link fontColor} and
+	 * {@link outline} the row states, so one `/font` line can say all three. The two single ops
+	 * stay for the rows that hold them and for a line that names one value alone.
+	 *
+	 * Additive: no document written before it carries the value, so no schema bump - the same
+	 * rule `bringToFront` came in under.
+	 */
+	operation: "create" | "setText" | "show" | "hide" | "setFontSize" | "setFontColor" | "setFont";
 	objectName: string;
 	/** Which text a non-`create` op acts on. Same rule as the `image` arm's `target`. */
 	target?: StoryDisplayableTargetRef;
 	text?: string;
 	fontSize?: number;
 	fontColor?: string;
+	/**
+	 * The outline drawn round the glyphs, read by `setFont`. `null` takes an outline away
+	 * (`outline=0`); absent leaves whatever the text has.
+	 */
+	outline?: StoryTextOutline | null;
 	layer?: StoryLayerRef;
 	transform?: StoryTransformRef;
 } | {
@@ -1059,7 +1072,29 @@ type StoryActionPayload = {
 	params: Record<string, StoryPluginActionParamValue>;
 }
 /** The player's hands: a pad that shakes, a locked passage, a row that waits for a gesture. */
- | StoryInputActionPayload;
+ | StoryInputActionPayload | {
+	/**
+	 * Open one of the project's pages over the stage (`/page`), hold the story until the page
+	 * closes, and go on from the row after it - a phone, a map, a letter the player reads.
+	 *
+	 * The page is shown exactly as `Show Layer` shows one from a blueprint, so the page closes
+	 * itself with `Close This Layer`, and what it closes with is the row's answer. Unlike
+	 * `/quit`, the scene is not left: the story is where it was when the page goes away.
+	 */
+	action: "page";
+	/**
+	 * The page, by id - never by name, so a rename keeps the row on the same page, as `/quit`
+	 * keeps naming its page.
+	 */
+	surfaceId: string;
+	/**
+	 * A variable to write what the page closed with. A boolean, a number or a text variable
+	 * takes the result converted to its own type; a page closed with no result (Back on a
+	 * dismissible page, a load, the story rolled back past the row) writes nothing, so the
+	 * variable keeps the value it had. Absent writes nothing at all.
+	 */
+	resultTarget?: StoryVariableRef;
+};
 type StoryPluginActionParamValue = string | number | boolean | null | StoryPluginActionParamValue[] | {
 	[key: string]: StoryPluginActionParamValue;
 };
@@ -1557,6 +1592,10 @@ declare const STORY_TRANSFORM_REPEAT_TYPES: readonly [
 	"mirror"
 ];
 type StoryTransformRepeatType = (typeof STORY_TRANSFORM_REPEAT_TYPES)[number];
+type StoryTextOutline = {
+	width: number;
+	color: string;
+};
 type StoryTransformRef = {
 	/** Absent means `"props"`. Only a Story Motion has to say which it is. */
 	mode?: "props" | "animation";
@@ -1649,6 +1688,11 @@ type StoryAlignPositionValue = {
 	xoffset?: number;
 	yoffset?: number;
 };
+interface CharacterFrameSequence {
+	frameAssetIds: string[];
+	fps: number;
+	loop: boolean;
+}
 type BlueprintOwnerRef = {
 	kind: "globalMain";
 } | {
@@ -2305,6 +2349,14 @@ declare const en: {
 					readonly command: "Highlight commands";
 				};
 			};
+			readonly characterListGrouping: {
+				readonly label: "Character lists";
+				readonly description: "How the cast is arranged where a character is picked.";
+				readonly options: {
+					readonly grouped: "Group by cast group";
+					readonly all: "Show all characters";
+				};
+			};
 			readonly dictionaries: {
 				readonly label: "Spelling dictionaries";
 			};
@@ -2888,7 +2940,7 @@ declare const en: {
 				readonly languagesTitle: "Languages";
 				readonly languagesHint: "Languages of the game itself. The source language is the one the story is written in; the rest are translated against it.";
 				readonly addLanguage: "Add language";
-				readonly codePlaceholder: "Code (en, ja, zh-CN\u2026)";
+				readonly codePlaceholder: "Code, e.g. ja";
 				readonly namePlaceholder: "Display name";
 				readonly invalidCode: "Language codes may only contain letters, digits, and hyphens.";
 				readonly sourceBadge: "Source";
@@ -3044,7 +3096,7 @@ declare const en: {
 				readonly languagesTitle: "Voice languages";
 				readonly languagesHint: "Languages with voice-over. Independent of the text languages.";
 				readonly addLanguage: "Add voice language";
-				readonly codePlaceholder: "Code (ja, en, zh-CN\u2026)";
+				readonly codePlaceholder: "Code, e.g. ja";
 				readonly namePlaceholder: "Display name";
 				readonly invalidCode: "Language codes may only contain letters, digits, and hyphens.";
 				readonly more: "More";
@@ -3066,6 +3118,14 @@ declare const en: {
 					readonly other: "{count} takes";
 				};
 				readonly importFailed: "Could not import the audio files";
+				readonly replaceTakesTitle: "Replace existing takes";
+				readonly replaceTakesMessage: {
+					readonly one: "{count} file is named for a line that already has a take.";
+					readonly other: "{count} files are named for lines that already have a take.";
+				};
+				readonly replaceTakesDetail: "Replacing writes each new file into the take it matches. Importing as new audio leaves the old takes in the asset library, linked to no line.";
+				readonly replaceTakesImport: "Import as new audio";
+				readonly replaceTakesReplace: "Replace takes";
 				readonly importScript: "Import recording script\u2026";
 				readonly importScriptCounts: "Applied {applied} ({unchanged} unchanged, {unknown} not voiced)";
 				readonly scriptRowCount: {
@@ -3098,6 +3158,9 @@ declare const en: {
 				readonly auditionFilterAll: "All";
 				readonly auditionFilterApproved: "Approved";
 				readonly auditionFilterPending: "Pending";
+				readonly filterSpeakerAll: "All speakers";
+				readonly speakerFilterLabel: "Speaker";
+				readonly searchPlaceholder: "Search lines";
 				readonly narrationSpeaker: "Narration";
 				readonly narrationGroup: "Narration";
 				readonly choiceSpeaker: "Choice";
@@ -3106,8 +3169,9 @@ declare const en: {
 				readonly assign: "Assign audio";
 				readonly replace: "Replace audio";
 				readonly remove: "Remove voice";
-				readonly play: "Play";
-				readonly stop: "Stop";
+				readonly play: "Play take";
+				readonly showInStory: "Show in story";
+				readonly stop: "Stop take";
 				readonly approve: "Approve";
 				readonly reject: "Return";
 				readonly clipMissing: "Clip missing";
@@ -3140,6 +3204,17 @@ declare const en: {
 					readonly unknown: "A story cannot be read, so orphan voice is not listed.";
 				};
 			};
+			readonly script: {
+				readonly column: {
+					readonly filename: "File name";
+					readonly character: "Speaker";
+					readonly scene: "Scene";
+					readonly line: "Line";
+					readonly status: "Status";
+					readonly note: "Note";
+					readonly unitId: "Line ID";
+				};
+			};
 		};
 		readonly textSourceMigration: {
 			readonly message: {
@@ -3269,6 +3344,8 @@ declare const en: {
 				readonly replaceText: "text replacement";
 				readonly agentEdit: "agent edit";
 				readonly agentPluginEdit: "agent: {tool}";
+				readonly importPsd: "PSD import";
+				readonly importAudio: "audio import";
 			};
 		};
 		readonly agent: {
@@ -3476,6 +3553,7 @@ declare const en: {
 				readonly playtest_hover: "Hover in the game";
 				readonly playtest_key: "Press a key in the game";
 				readonly playtest_stop: "Stop playing";
+				readonly playtest_variables: "Read the game's variables";
 				readonly console_read: "Read Studio's console";
 				readonly build: "Build the game";
 			};
@@ -4146,6 +4224,7 @@ declare const en: {
 					readonly localization: "Translation Table";
 					readonly voice: "Voice Table";
 					readonly lint: "Problems";
+					readonly search: "Search";
 					readonly other: "Other";
 				};
 				readonly catalog: {
@@ -4203,6 +4282,10 @@ declare const en: {
 						readonly cut: "Cut Nodes";
 						readonly paste: "Paste Nodes";
 					};
+					readonly search: {
+						readonly undo: "Undo Replace";
+						readonly redo: "Redo Replace";
+					};
 					readonly storyMotion: {
 						readonly undo: "Undo";
 						readonly redo: "Redo";
@@ -4366,6 +4449,23 @@ declare const en: {
 				readonly replaceAll: "Replace all";
 				readonly replaceRow: "Replace this line";
 				readonly replaceStale: "The project changed. Search again.";
+				readonly replacedInScene: {
+					readonly one: "Replaced {count} occurrence in {scene}";
+					readonly other: "Replaced {count} occurrences in {scene}";
+				};
+				readonly replacedInScenes: {
+					readonly one: "Replaced {count} occurrence in {scenes} scenes";
+					readonly other: "Replaced {count} occurrences in {scenes} scenes";
+				};
+				readonly replacedUndoHint: "{key} in the Search panel undoes it in every scene.";
+				readonly undoSkipped: {
+					readonly one: "Replace not undone in {count} scene edited after it";
+					readonly other: "Replace not undone in {count} scenes edited after it";
+				};
+				readonly redoSkipped: {
+					readonly one: "Replace not redone in {count} scene edited after the undo";
+					readonly other: "Replace not redone in {count} scenes edited after the undo";
+				};
 				readonly groups: {
 					readonly scene: "Scenes";
 					readonly story: "Stories";
@@ -4592,6 +4692,7 @@ declare const en: {
 			readonly reason: {
 				readonly blueprintAction: "A blueprint runs this row, and a blueprint has no script form.";
 				readonly inputAction: "This row works with the player's input or the controller's rumble, and has no script form.";
+				readonly pageAction: "This row opens a page over the story and waits for it, and has no script form.";
 				readonly blueprintCondition: "A blueprint decides this condition.";
 				readonly blueprintInterpolation: "A blueprint computes a value inside this text.";
 				readonly inlineEvent: "The text carries an event that fires while it is being typed out.";
@@ -4833,6 +4934,20 @@ declare const en: {
 		readonly stage: {
 			readonly notOnStage: "Not on stage";
 			readonly builtin: "Built-in";
+			readonly reserved: {
+				readonly camera: "Camera";
+				readonly background: "Scene background";
+				readonly backgroundLayer: "Background layer";
+				readonly displayableLayer: "Base layer";
+			};
+			readonly defaultName: {
+				readonly text: "text";
+			};
+			readonly reservedHint: {
+				readonly background: "The scene's background image";
+				readonly backgroundLayer: "Built-in layer, behind everything";
+				readonly displayableLayer: "Built-in default layer";
+			};
 		};
 		readonly targetField: {
 			readonly label: "Target";
@@ -4972,10 +5087,6 @@ declare const en: {
 			readonly removeStarred: "Remove from starred";
 			readonly starredEmpty: "Starred commands are listed first in the \u201C/\u201D menu.";
 		};
-		readonly music: {
-			readonly missingAudio: "Missing audio";
-			readonly none: "No music";
-		};
 		readonly background: {
 			readonly missingImage: "Missing image";
 			readonly none: "No background";
@@ -4993,7 +5104,7 @@ declare const en: {
 			readonly times: "Times";
 			readonly character: "Character";
 			readonly speaker: "Speaker";
-			readonly form: "Expression";
+			readonly form: "Appearance";
 			readonly motion: "Motion";
 			readonly skin: "Skin";
 			readonly puppetParam: "Parameter";
@@ -5046,6 +5157,8 @@ declare const en: {
 			readonly hold: "Hold Seconds";
 			readonly opacity: "Opacity";
 			readonly size: "Font Size";
+			readonly outline: "Outline px";
+			readonly outlineColor: "Outline Color";
 			readonly xOffset: "X Offset px";
 			readonly yOffset: "Y Offset px";
 			readonly zoom: "Zoom";
@@ -5266,9 +5379,9 @@ declare const en: {
 				readonly video: "Video asset";
 				readonly character: "Character";
 				readonly characterOrName: "Character, or any name";
-				readonly characterForm: "One of that character's expressions";
+				readonly characterForm: "One of that character's appearances";
 				readonly puppet: {
-					readonly motion: "A motion provided by the runtime (blank returns it to rest)";
+					readonly motion: "A motion provided by the runtime, played in a loop (blank returns it to rest)";
 					readonly expression: "An expression provided by the runtime (blank clears it)";
 					readonly skin: "A skin provided by the runtime (blank restores the default)";
 					readonly param: "A numeric parameter of the model, by id";
@@ -5343,8 +5456,8 @@ declare const en: {
 			readonly createCharacterUnavailable: "Unavailable in a live session. Choose an existing character.";
 			readonly voiceOutdated: "Voice outdated, open voice table";
 			readonly voiceManage: "Open voice table";
-			readonly voicePlay: "Play voice take";
-			readonly voiceStop: "Stop voice take";
+			readonly voicePlay: "Play take";
+			readonly voiceStop: "Stop take";
 		};
 		readonly sceneEditor: {
 			readonly defaultSceneName: "Untitled Scene";
@@ -5357,16 +5470,6 @@ declare const en: {
 			readonly noDescription: "No description";
 			readonly defaultBackground: "Default background";
 			readonly clearBackground: "Clear background";
-			readonly sceneMusic: "Scene music";
-			readonly clearSceneMusic: "Clear scene music";
-			readonly selectSceneMusic: "Select Scene Music";
-			readonly sceneMusicVolume: "Volume";
-			readonly sceneMusicLoop: "Loop";
-			readonly sceneMusicFade: "Fade in (s)";
-			readonly sceneMusicLoopRegion: "Loops {from}s to {to}s";
-			readonly sceneMusicIntroLoop: "Plays {from}s, loops {loop}s to {to}s";
-			readonly sceneMusicFromIn: "Starts at {from}s";
-			readonly sceneMusicWholeClip: "Whole clip";
 			readonly selectDefaultBackground: "Select Default Background";
 			readonly tabInvalid: "Story scene editor tab is invalid.";
 			readonly loadingScene: "Loading story scene\u2026";
@@ -5656,7 +5759,7 @@ declare const en: {
 			};
 			readonly motion: {
 				readonly label: "Motion";
-				readonly detail: "Set the motion a runtime-drawn character plays";
+				readonly detail: "Set the motion a runtime-drawn character loops until another row changes it";
 			};
 			readonly param: {
 				readonly label: "Parameter";
@@ -5684,7 +5787,7 @@ declare const en: {
 			};
 			readonly vfx: {
 				readonly label: "Ambience";
-				readonly detail: "Declare a looping full-screen overlay: petals, rain, dust, light";
+				readonly detail: "Declare a looping full-screen overlay (petals, rain, dust, light); /show reveals it";
 			};
 			readonly layer: {
 				readonly label: "Layer";
@@ -5822,6 +5925,10 @@ declare const en: {
 				readonly label: "Quit to page";
 				readonly detail: "End this playthrough at this line and show a page. No ending is recorded";
 			};
+			readonly page: {
+				readonly label: "Open page";
+				readonly detail: "Open a page over the story and wait until it closes. What the page closes with can be written into a variable";
+			};
 			readonly rumble: {
 				readonly label: "Rumble";
 				readonly detail: "Vibrate the player's controller. Pick a preset, or set each motor";
@@ -5904,6 +6011,7 @@ declare const en: {
 			readonly cut: "Cut point";
 			readonly ending: "Ending";
 			readonly quit: "Quit to page";
+			readonly page: "Page";
 			readonly rumble: "Rumble";
 			readonly input: "Input";
 			readonly jump: "Jump";
@@ -5972,6 +6080,8 @@ declare const en: {
 			readonly cutUnknown: "Cut point";
 			readonly ending: "Ending {name}";
 			readonly quit: "Quit to {page}";
+			readonly page: "Open {page}";
+			readonly pageUnset: "Open page";
 			readonly rumble: "Rumble: {shape}";
 			readonly rumbleStop: "Stop rumble";
 			readonly inputLock: "Lock player input";
@@ -6020,6 +6130,7 @@ declare const en: {
 			readonly changeSpeaker: "Change speaker";
 			readonly speakerNameOnly: "{name} (name only)";
 			readonly openInspector: "Open inspector";
+			readonly editAsText: "Edit as text";
 			readonly delete: "Delete";
 		};
 		readonly history: {
@@ -6082,6 +6193,7 @@ declare const en: {
 			readonly undo: "Undo story scene edit";
 			readonly redo: "Redo story scene edit";
 			readonly editRow: "Edit the active row (or open its inspector)";
+			readonly editRowAsText: "Edit the active row as text";
 			readonly closeInspector: "Close the property editor";
 			readonly insertRow: "Insert a new story row below the active row";
 			readonly indent: "Indent selected story rows";
@@ -6150,6 +6262,7 @@ declare const en: {
 			unknownVariable: string;
 			unknownForm: string;
 			notPuppetCharacter: string;
+			puppetNoExpressions: string;
 			ambiguousName: string;
 			conflictingParams: string;
 			positionOutOfRange: string;
@@ -6525,6 +6638,7 @@ declare const en: {
 			readonly setText: "Set text";
 			readonly setFontSize: "Set font size";
 			readonly setFontColor: "Set font color";
+			readonly setFont: "Set font";
 		};
 		readonly layerOperation: {
 			readonly setZIndex: "Set z-index";
@@ -6607,6 +6721,8 @@ declare const en: {
 			readonly textName: "Text name";
 			readonly fontSize: "Font size";
 			readonly fontColor: "Font color";
+			readonly outlineWidth: "Outline width";
+			readonly outlineColor: "Outline color";
 			readonly text: "Text";
 		};
 		readonly layer: {
@@ -6724,6 +6840,8 @@ declare const en: {
 			readonly quitPage: "Page shown afterwards";
 			readonly quitPageUnset: "Not set";
 			readonly quitHint: "This playthrough ends at this line and the page takes the screen. No ending is recorded.";
+			readonly pagePage: "Page";
+			readonly pageHint: "The page opens over the story, and the story waits until the page closes itself with Close This Layer. What it closes with is written into the result variable, converted to the variable's type; a page closed with nothing leaves the variable as it was.";
 			readonly branch: "Branch";
 			readonly elseHint: "Else branch runs when previous branches do not match.";
 		};
@@ -6753,6 +6871,9 @@ declare const en: {
 		readonly history: {
 			readonly deleteAsset: "delete {name}";
 			readonly deleteGroup: "delete folder {name}";
+			readonly replaceContent: "replace {name}";
+			readonly convert: "convert {name}";
+			readonly restoreFailed: "Could not restore \u201C{name}\u201D.";
 		};
 		readonly delete: {
 			readonly inUseTitle: "These assets are still in use";
@@ -6785,6 +6906,10 @@ declare const en: {
 			readonly confirmAction: "Replace";
 			readonly failedTitle: "Failed to replace asset contents";
 			readonly remoteUnsupported: "Remote assets have no local file to replace.";
+			readonly notKept: "Could not replace \u201C{name}\u201D.";
+			readonly reason: {
+				readonly notKept: "A copy of the current file could not be saved.";
+			};
 		};
 		readonly types: {
 			readonly image: "Images";
@@ -6971,7 +7096,7 @@ declare const en: {
 			readonly familyNoRuntime: "No runtime is installed here. The drawing runtime is set on the character.";
 			readonly family: {
 				readonly live2d: "Live2D Cubism";
-				readonly live2dHint: "A folder holding a .model3.json, or Cubism 2's model.json.";
+				readonly live2dHint: "A folder holding a .model3.json (Cubism 3 or later).";
 				readonly spine: "Spine";
 				readonly spineHint: "A folder holding a .skel or .json skeleton beside its .atlas.";
 			};
@@ -6999,7 +7124,7 @@ declare const en: {
 				readonly one: "Import {count} model";
 				readonly other: "Import {count} models";
 			};
-			readonly blockedHint: "Models with missing files start unticked. Tick one to import it as-is.";
+			readonly blockedHint: "Models marked in red start unticked. Tick one to import it as-is.";
 			readonly problemCount: {
 				readonly one: "{count} problem";
 				readonly other: "{count} problems";
@@ -7011,6 +7136,7 @@ declare const en: {
 				readonly atlasMissing: "No atlas beside the skeleton; {path} was expected.";
 				readonly atlasEmpty: "{path} names no image.";
 				readonly nestedModel: "Holds another model, {path}, which would be copied with it.";
+				readonly cubism2: "{path} is a Cubism 2 model. The Live2D Cubism runtime draws Cubism 3 and later models only.";
 			};
 			readonly role: {
 				readonly moc: "model file";
@@ -7643,6 +7769,7 @@ declare const en: {
 			readonly unknownVariant: "\u201C{element}\u201D has no such variant.";
 			readonly pageNotFound: "The page was not found in this project.";
 			readonly notALayer: "\u201C{node}\u201D: this page is not a layer, so nothing was closed.";
+			readonly pageMusicInGame: "\u201C{node}\u201D: a game is running, and the story decides the music while it does. The page's music was not changed.";
 			readonly persistentVariableMissing: "The persistent variable this node uses no longer exists.";
 			readonly persistentVariableNoKey: "The persistent variable \u201C{name}\u201D has no storage key.";
 			readonly slotIsRunningGame: "This node needs a save in storage. The slot it received is the running game, which only \u201C{node}\u201D can inherit from.";
@@ -8497,6 +8624,7 @@ declare const en: {
 			readonly getVoiceVolume: "Get Voice Volume";
 			readonly hasReadText: "Has Read Text";
 			readonly playSound: "Play Sound";
+			readonly playPageMusic: "Play Page Music";
 			readonly setAutoForward: "Set Auto Forward";
 			readonly setAutoForwardDelay: "Set Auto Forward Delay";
 			readonly setTextRevealDuration: "Set Text Fade In";
@@ -8543,6 +8671,7 @@ declare const en: {
 			readonly setVoiceFadeDuration: "Set Voice Fade Duration";
 			readonly setVoiceVolume: "Set Voice Volume";
 			readonly stopSound: "Stop Sound";
+			readonly stopPageMusic: "Stop Page Music";
 			readonly pauseSound: "Pause Sound";
 			readonly resumeSound: "Resume Sound";
 			readonly setSoundVolume: "Set Sound Volume";
@@ -8801,6 +8930,8 @@ declare const en: {
 			readonly onFullscreenChanged: "On Fullscreen Changed";
 			readonly onWindowCloseRequested: "On Window Close Requested";
 			readonly onWindowFocusChanged: "On Window Focus Changed";
+			readonly onSavedVarChanged: "On Saved Var Changed";
+			readonly onPersistentChanged: "On Persistent Changed";
 			readonly onAction: "On Action";
 			readonly onKeyDown: "On Key Down";
 			readonly onKeyUp: "On Key Up";
@@ -8972,6 +9103,8 @@ declare const en: {
 			readonly getTotalPlaytime: "Get Total Playtime";
 		};
 		readonly nodeDescription: {
+			readonly playPageMusic: "Makes this the music of the page this graph runs on, for as long as the page is open, in place of the music set in its properties. The music playing hands over to it, and the same music already playing carries on. Going back to a page underneath brings that page's music back. Does nothing while a game is running: the story decides the music then.";
+			readonly stopPageMusic: "Silences the page this graph runs on, for as long as it is open. The music playing fades out over Fade (s), or over its own fade when Fade (s) is not connected. Does nothing while a game is running: the story decides the music then.";
 			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 getPageParam: "The value the page was opened with for the chosen param, or the param's default when it was given none. Params are declared in the page's properties.";
 			readonly compareEqual: "True when A and B are the same value of the same type. Lists and objects are compared by their contents, an element by which element it is. The number 1 and the text \"1\" are not equal; an input left unconnected counts as Null.";
@@ -9089,6 +9222,15 @@ declare const en: {
 			readonly colorReset: "Compute from the name";
 		};
 		readonly editor: {
+			readonly sequenceTitle: "Frame sequence";
+			readonly sequenceImport: "Import PNG frames";
+			readonly sequenceFps: "Frames per second";
+			readonly sequenceLoop: "Loop";
+			readonly sequenceStatic: "Use first frame only";
+			readonly sequenceMoveUp: "Move frame up";
+			readonly sequenceMoveDown: "Move frame down";
+			readonly sequencePngOnly: "All frames must be PNG images.";
+			readonly sequenceSizeMismatch: "All frames must have the same dimensions.";
 			readonly kind: {
 				readonly preset: "Preset sprites";
 				readonly layered: "Layered sprite";
@@ -9123,6 +9265,7 @@ declare const en: {
 				readonly redescribe: "Read the model again";
 				readonly previewFailed: "This model could not be drawn";
 				readonly setupTitle: "Two things to set up";
+				readonly setupTitleOne: "Left to set up: {item}";
 				readonly stepRuntime: "Drawing runtime";
 				readonly stepModel: "Model";
 				readonly runtimeInstalled: "Installed";
@@ -9275,6 +9418,7 @@ declare const en: {
 			readonly thumbnail: "Thumbnail";
 			readonly preview: "Preview";
 			readonly defaultAvatar: "Default dialog avatar";
+			readonly defaultAvatarRuntimeHint: "A character drawn by a runtime has no generated avatar. Dialogue shows this one.";
 			readonly voiceTrack: "Voice track";
 			readonly voiceTrackMissing: "Missing track";
 			readonly voiceTrackEmpty: "Add a track under Voice in Project \u25B8 Game to give this character its own volume control.";
@@ -9285,6 +9429,12 @@ declare const en: {
 			readonly select: "Select";
 			readonly thumbnailAlt: "thumbnail";
 			readonly color: "Color";
+			readonly aliases: "Aliases";
+			readonly aliasesTip: "A story line whose speaker is written as an alias belongs to this character. The game still shows the character's name.";
+			readonly addAliasPlaceholder: "Add alias\u2026";
+			readonly aliasIsName: "\"{alias}\" is this character's name.";
+			readonly aliasTakenByName: "\"{alias}\" is the name of {names}. Lines spoken as \"{alias}\" belong to {names}.";
+			readonly aliasShared: "\"{alias}\" is also an alias of {names}. Lines spoken as \"{alias}\" cannot be assigned to one character.";
 			readonly namePlaceholder: "Character name";
 			readonly descriptionPlaceholder: "Character description\u2026";
 			readonly tags: "Tags";
@@ -9311,7 +9461,8 @@ declare const en: {
 			readonly variant: "Variant: {name}";
 			readonly loading: "Loading preview\u2026";
 			readonly failed: "Preview failed";
-			readonly placeholder: "Select a variant with an image to preview";
+			readonly emptyLayered: "Add a layer with an image, or import a PSD, to preview";
+			readonly emptyPreset: "Set an image for this pose to preview";
 			readonly noSize: "No size";
 			readonly noMetadata: "No metadata";
 			readonly zoomOut: "Zoom Out";
@@ -9436,6 +9587,26 @@ declare const en: {
 			readonly chooseClick: "Choose click sound";
 			readonly missing: "Missing sound";
 		};
+		readonly music: {
+			readonly title: "Music";
+			readonly none: "No music";
+			readonly keep: "Keep current music";
+			readonly silent: "No music";
+			readonly choosePage: "Choose page music";
+			readonly chooseScene: "Choose scene music";
+			readonly missing: "Missing music";
+			readonly loop: "Loop";
+			readonly fade: "Fade";
+			readonly loops: "Loops";
+			readonly loopRegion: "Loops {from}s to {to}s";
+			readonly loopToEnd: "Loops {from}s to the end";
+			readonly introLoopRegion: "Plays from {start}s, loops {from}s to {to}s";
+			readonly introLoopToEnd: "Plays from {start}s, loops {from}s to the end";
+			readonly once: "Plays once";
+			readonly onceFrom: "Plays once from {from}s";
+			readonly onceRegion: "Plays once {from}s to {to}s";
+			readonly fadeSummary: "Fade {seconds}s";
+		};
 		readonly linkedComponent: {
 			readonly missing: "Missing component";
 			readonly info: "Linked instance. Only its params and its position, size and rotation can be changed before unlinking.";
@@ -9596,6 +9767,9 @@ declare const en: {
 			readonly descriptionPlaceholder: "Enter description\u2026";
 			readonly info: {
 				readonly dimensions: "Dimensions";
+				readonly animation: "Animation";
+				readonly animationLoops: "{frames} frames, loops forever";
+				readonly animationPlays: "{frames} frames, plays {plays} \u00D7";
 				readonly format: "Format";
 				readonly size: "Size";
 				readonly hash: "Hash";
@@ -11883,6 +12057,8 @@ declare const en: {
 			readonly title: "Setup complete";
 			readonly expectation: "Every setting asked for here is in Settings. F1 opens help for whatever is under the cursor.";
 			readonly docs: "Open the documentation";
+			readonly bilibili: "Follow us on Bilibili";
+			readonly youtube: "Follow us on YouTube";
 		};
 		readonly skipConfirm: {
 			readonly title: "Skip setup?";
@@ -12122,8 +12298,9 @@ declare const en: {
 			readonly name: "Project Name";
 			readonly namePlaceholder: "Project name";
 			readonly appIdPlaceholder: "App identifier";
-			readonly appIdHelper: "Lowercase letters, digits and hyphens, or a reverse-domain id such as com.studio.game. Cannot be changed after creation.";
+			readonly appIdHelper: "Identifies the released game on the player's device. Lowercase letters, digits and hyphens, or a reverse-domain ID such as com.studio.game. Cannot be changed after the project is created.";
 			readonly appIdRequired: "App ID is required";
+			readonly appIdInUse: "Already used by the project \u201C{name}\u201D on this machine";
 			readonly appIdInvalid: "App ID can only contain lowercase letters, numbers and hyphens, with dots only between the parts of a reverse-domain id such as com.studio.game";
 			readonly locationPlaceholder: "Project location";
 			readonly browseLocation: "Choose folder";
@@ -13431,6 +13608,12 @@ declare const en: {
 				readonly message: "{asset} is {size}, over the {limit} a build should carry";
 				readonly help: string;
 			};
+			readonly assetsSpriteAnimationFinite: {
+				readonly title: "Sprite animation that stops";
+				readonly description: "A character sprite that is an animated PNG set to play a fixed number of times";
+				readonly message: "{asset} is an animated PNG that plays {plays} \u00D7 and then holds its last frame";
+				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";
@@ -13544,6 +13727,13 @@ declare const en: {
 				readonly message: "This row comes after an ending and is never played. Move it before the ending, or delete it";
 				readonly help: string;
 			};
+			readonly storyPageMissing: {
+				readonly title: "Open page with no page";
+				readonly description: "A /page row that names no page, or one the project no longer has";
+				readonly message: "This row names no page, so nothing opens and the story goes straight on";
+				readonly deleted: "The page this row names is no longer in the project, so nothing opens and the story goes straight on";
+				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";
@@ -13626,6 +13816,18 @@ declare const en: {
 				readonly message: "This background is already on screen, so the transition changes nothing";
 				readonly help: string;
 			};
+			readonly storyTagNameShared: {
+				readonly title: "Tag name on two axes";
+				readonly description: "A character with layered sprites using one tag name on two axes";
+				readonly message: "The tag \"{tag}\" is on both \"{first}\" and \"{second}\"";
+				readonly help: string;
+			};
+			readonly storyParallelSameTarget: {
+				readonly title: "One object in two parallel branches";
+				readonly description: "A /parallel group whose branches act on the same stage object";
+				readonly message: "Another branch of this /parallel group also acts on \"{object}\"";
+				readonly help: string;
+			};
 			readonly blueprintReferenceMissing: {
 				readonly title: "Missing target";
 				readonly description: "A node naming something the project no longer has";
@@ -13907,13 +14109,13 @@ declare const en: {
 			readonly voiceMissing: {
 				readonly title: "Missing voice";
 				readonly description: "A line with no recording in a voiced language";
-				readonly message: "No {locale} recording";
+				readonly message: "No {language} 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 message: "{language} recording predates a change to the line";
 				readonly help: string;
 			};
 			readonly voiceOrphan: {
@@ -13921,8 +14123,8 @@ declare const en: {
 				readonly description: "A recording whose line no longer exists";
 				readonly message: "{recordings} with no line";
 				readonly recordingCount: {
-					readonly one: "{count} {locale} recording";
-					readonly other: "{count} {locale} recordings";
+					readonly one: "{count} {language} recording";
+					readonly other: "{count} {language} recordings";
 				};
 				readonly help: string;
 			};
@@ -14196,7 +14398,6 @@ declare const en: {
 			readonly groupAdded: "Group added";
 			readonly groupRemoved: "Group removed";
 			readonly fields: {
-				readonly nicknames: "Nicknames";
 				readonly group: "Group";
 				readonly canvas: "Canvas";
 				readonly avatarAxes: "Avatar axes";
@@ -15069,6 +15270,10 @@ declare const en: {
 				readonly title: "Focus navigation";
 				readonly body: string;
 			};
+			readonly pageMusic: {
+				readonly title: "Page music";
+				readonly body: string;
+			};
 			readonly focusNavigationSettings: {
 				readonly title: "Navigation settings";
 				readonly body: string;
@@ -16588,6 +16793,22 @@ type UIPageAnimationSettings = {
 	/** Surfaces only: hold the incoming Page until this exit has finished. */
 	exitBlocking: boolean;
 };
+type UIPageMusic = {
+	/** Audio library asset id, or an audio asset set's id. */
+	assetId: string;
+	/** The project audio track it plays on (`ProjectAudioTrack.id`). Absent = the Music track. */
+	audioTrackId?: string;
+	/** 0-1 as authored. Absent = 1. */
+	volume?: number;
+	/** Absent = the track's own loop default (Music loops). */
+	loop?: boolean;
+	/** Fade-in as the page brings it in, and fade-out as it hands over, in milliseconds. Absent = 0. */
+	fadeMs?: number;
+};
+type UIPageSilence = {
+	silent: true;
+};
+type UIPageMusicSetting = UIPageMusic | UIPageSilence;
 type UISurfaceBackgroundFillMode = "cover" | "contain" | "stretch" | "tile";
 type UISurfaceBackgroundImage = {
 	/** Image library asset id. Absent background = absent field, so this is never empty. */
@@ -16717,6 +16938,12 @@ type UISurfaceSettings = {
 	 * a scaled Surface keep showing the colour, so the two settings are not alternatives.
 	 */
 	backgroundImage?: UISurfaceBackgroundImage;
+	/**
+	 * What a page does to the music while it is the page on screen: play this, or silence. Absent
+	 * keeps whatever is playing (see `pageMusic.ts`). Read for pages only: a Game UI is drawn over
+	 * the running scene, whose own music is what plays there.
+	 */
+	music?: UIPageMusicSetting;
 	pageAnimation?: UIPageAnimationSettings;
 	/** Where the focus starts when this Surface opens, and whether it is put there. See `navigation.ts`. */
 	navigation?: UISurfaceNavigation;
@@ -17010,6 +17237,11 @@ type PsdFingerprintSlot = {
 	layerId: string;
 	/** The tag it feeds, when that layer is bound to an axis. Absent for a constant layer. */
 	tagId?: string;
+	/**
+	 * The image this import put in that slot. A re-import writes the layer's new bytes into it, as
+	 * long as the slot still shows it. Absent in a fingerprint written before it was recorded.
+	 */
+	assetId?: string;
 };
 type PsdFingerprint = {
 	fileName: string;
@@ -17324,6 +17556,10 @@ export type SearchJumpTarget = {
 	storyId: string;
 	storyName: string;
 };
+type PngAnimation = {
+	frames: number;
+	plays: number;
+};
 type ModelBundleFormat = "live2d-cubism4" | "live2d-cubism2" | "spine-binary" | "spine-json" | "unknown";
 export declare enum AssetType {
 	Image = "image",
@@ -17357,6 +17593,8 @@ type ImageAssetMetadata = {
 	height: number;
 	format: string;
 	size: number;
+	/** What an APNG declares about its frames and loops; null for a still image. */
+	animation?: PngAnimation | null;
 };
 type AudioAssetMetadata = {
 	duration: number;
@@ -17729,6 +17967,7 @@ interface CharacterNamed {
 	name: string;
 }
 interface CharacterPose extends CharacterNamed {
+	sequence?: CharacterFrameSequence;
 	/** Groups the list in the editor. Never consulted when resolving. */
 	folder?: string;
 	assetId: string | null;
@@ -17933,6 +18172,7 @@ declare class CharacterAppearance {
 	createPose(name: string, folder?: string): CharacterPose | null;
 	removePose(poseId: string): boolean;
 	setPoseAsset(poseId: string, assetId: string | null): void;
+	setPoseSequence(poseId: string, input: CharacterFrameSequence): void;
 	setPoseFolder(poseId: string, folder: string | undefined): void;
 	setPosePortrait(poseId: string, portrait: PortraitCrop | undefined): void;
 	/**
@@ -19822,6 +20062,7 @@ declare const HELP_TOPIC_IDS: readonly [
 	"inputActionsInBlueprints",
 	"focusNavigation",
 	"focusNavigationSettings",
+	"pageMusic",
 	"uiComponents",
 	"blueprints",
 	"scripts",
@@ -20105,6 +20346,17 @@ interface TagsFieldDefinition<TData = any> extends BaseFieldDefinition<TData> {
 	 * that are not drawn, and removing a chip removes exactly the tag it stands for.
 	 */
 	formatTag?: (data: TData, tag: string) => string | null;
+	/**
+	 * Why a stored tag will not do what it is there for, or null when it will. A tag with an issue
+	 * is drawn in the warning tone and the sentence is printed under the field. It is still stored:
+	 * the field warns rather than refusing, because the fix may be on another record.
+	 */
+	tagIssue?: (data: TData, tag: string) => string | null;
+	/**
+	 * A tag the field drops instead of adding, as it drops a repeat. Absent: only repeats are
+	 * dropped.
+	 */
+	rejectTag?: (data: TData, tag: string) => boolean;
 }
 interface InfoFieldDefinition<TData = any> extends BaseFieldDefinition<TData> {
 	type: "info";
@@ -22445,6 +22697,7 @@ export type PluginWidgetModule = {
 	createFloatingToolbarItems?(context: PluginWidgetFloatingToolbarContext): FloatingToolbarItem[];
 	createLayoutSizeField?(context: PluginWidgetLayoutSizeFieldContext): FieldDefinition<PluginWidgetInspectorData> | null | undefined;
 };
+type ModelFamily = "live2d" | "spine";
 /**
  * Caller-defined section (e.g. built-in presets) shown as a collapsible group in the asset list.
  * Workspace filter chips do not apply; only the search box filters `assets` (same rules as project assets).
@@ -22472,6 +22725,11 @@ export interface AssetSelectorProps {
 	 * Return null/undefined to fall back to the default fetch path.
 	 */
 	resolveAssetPreviewUrl?: (asset: Asset) => Promise<string | null | undefined>;
+	/**
+	 * For a model picker: the kind of model the caller draws, which the import wizard opens on. Left
+	 * out, the wizard asks.
+	 */
+	modelFamily?: ModelFamily;
 	onClose: () => void;
 	onConfirm: (assets: Asset[]) => void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "narraleaf-studio",
-  "version": "1.6.2",
+  "version": "1.7.0",
   "description": "TypeScript declarations for the NarraLeaf Studio plugin API (narraleaf-studio/plugin and narraleaf-studio/runtime).",
   "license": "MPL-2.0",
   "type": "module",