@patterkit/model 0.17.0 → 0.19.0

package/dist/index.cjs

@@ -57,13 +57,17 @@ __export(index_exports, {
   gameIdify: () => gameIdify,
   isCaseOnlyPropertyName: () => import_expr.isCaseOnlyPropertyName,
   isContentlessBeat: () => isContentlessBeat,
+  isDialogueScene: () => isDialogueScene,
   isValidGameId: () => isValidGameId,
   isValidPropertyName: () => import_expr.isValidPropertyName,
   projectLayout: () => projectLayout,
   projectQualifiers: () => projectQualifiers,
   propertyNameify: () => import_expr.propertyNameify,
   qualifierStringKey: () => qualifierStringKey,
+  resolveSceneRef: () => resolveSceneRef,
+  sceneAddressIndex: () => sceneAddressIndex,
   speakerLabelKey: () => speakerLabelKey,
+  textIsAction: () => textIsAction,
   usedQualifiers: () => usedQualifiers,
   usedSpeakerPairs: () => usedSpeakerPairs,
   walkNodes: () => walkNodes
@@ -94,6 +98,14 @@ function effectiveGameId(entity) {
   const g = entity.gameId?.trim();
   return g ? g : gameIdify(entity.name);
 }
+function sceneAddressIndex(scenes) {
+  const byAddress = /* @__PURE__ */ new Map();
+  for (const [id, scene] of Object.entries(scenes)) byAddress.set(effectiveGameId(scene), id);
+  return byAddress;
+}
+function resolveSceneRef(scenes, ref, byAddress) {
+  return (byAddress ?? sceneAddressIndex(scenes)).get(ref) ?? (Object.hasOwn(scenes, ref) ? ref : void 0);
+}
 var COMMON_GENDERS = ["male", "female", "neuter"];
 var DEFAULT_QUALIFIERS = [
   { gameId: "vo", name: "V.O.", description: "Voice-over: the character isn't in the scene (a thought, narration, a voice in the ear)." },
@@ -141,6 +153,27 @@ function usedSpeakerPairs(scenes) {
   }
   return out;
 }
+function isDialogueScene(scene) {
+  let found = false;
+  for (const block of scene.blocks) {
+    walkNodes(block.children, (node) => {
+      if (found) return;
+      if (node.type === "group") {
+        if (node.prompt?.kind === "line" && node.prompt.character) found = true;
+        return;
+      }
+      for (const beat of node.beats ?? []) if (beat.kind === "line" && beat.character) {
+        found = true;
+        return;
+      }
+    });
+    if (found) return true;
+  }
+  return false;
+}
+function textIsAction(project, scene) {
+  return !project.localiseDialogueText && isDialogueScene(scene);
+}
 var DEFAULT_PAD_AFTER = 0.6;
 var PAD_AFTER_MIN = -10;
 var PAD_AFTER_MAX = 60;
@@ -258,13 +291,17 @@ var UNRESOLVED_KEY = "unresolved";
   gameIdify,
   isCaseOnlyPropertyName,
   isContentlessBeat,
+  isDialogueScene,
   isValidGameId,
   isValidPropertyName,
   projectLayout,
   projectQualifiers,
   propertyNameify,
   qualifierStringKey,
+  resolveSceneRef,
+  sceneAddressIndex,
   speakerLabelKey,
+  textIsAction,
   usedQualifiers,
   usedSpeakerPairs,
   walkNodes

package/dist/index.d.cts

@@ -43,7 +43,7 @@ interface LineBeat {
     tags?: string[];
 }
 /**
- * Authorial voice / narration - speaker-less prose (spec §2). Never voiced; its
+ * Text - speaker-less prose (spec §2). Never voiced; its
  * localised text always permits inline `{@name}` interpolation (spec §16). This
  * is the on-screen-text role (e.g. "A door slams!") - distinct from a game-event
  * beat, which is a pure engine instruction with no localised content.
@@ -63,6 +63,11 @@ interface TextBeat {
     extensions?: NodeExtensions;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
+    /** Bundle only: this text beat is ACTION, a direction to the people staging the scene that the player
+     *  never sees (design/proposals/action-text.md). Set by the compiler on every text beat of a dialogue scene
+     *  (`isDialogueScene`) when the project's `localiseDialogueText` is off; its text is then the source in
+     *  every locale. Absent = shown text. Never in source. */
+    action?: true;
 }
 /**
  * A GAME EVENT (spec §2): a pure engine instruction with no player-facing text - just `gameData` the host
@@ -252,6 +257,25 @@ declare function effectiveGameId(entity: {
     gameId?: string;
     name: string;
 }): string;
+/** A bundle's scenes by their address (effective gameId), for `resolveSceneRef` to look up in. */
+declare function sceneAddressIndex(scenes: Readonly<Record<string, {
+    gameId?: string;
+    name: string;
+}>>): Map<string, string>;
+/**
+ * THE rule for resolving a scene reference to its internal id: its address (the effective gameId, the
+ * host-facing name, spec §6) first, then its internal id. Undefined when neither names a scene.
+ *
+ * One rule for the runtime's openFlow, goto and every engine lookup, and for every tool that has to land
+ * where the game will (the Storylet Engine's Board and pairing check, Patterpad's Show Card). Each used to
+ * keep a copy, and the copies tried the internal id first, so where one scene's id was another's gameId
+ * they picked a different scene from the one the game opened (family parity item 1). Pass `byAddress`
+ * (from `sceneAddressIndex`) to look up many references in one bundle without rebuilding it.
+ */
+declare function resolveSceneRef(scenes: Readonly<Record<string, {
+    gameId?: string;
+    name: string;
+}>>, ref: string, byAddress?: ReadonlyMap<string, string>): string | undefined;
 type PropertyType = "boolean" | "number" | "string" | "flags" | "enum" | "quality";
 interface PropertyDecl {
     name: string;
@@ -394,6 +418,12 @@ declare function usedSpeakerPairs(scenes: Scene[]): {
     character: string;
     qualifier: string;
 }[];
+/** A DIALOGUE scene (design/proposals/action-text.md): one with at least one line beat that names a
+ *  character, an option's prompt included. Any other scene is a TEXT scene. */
+declare function isDialogueScene(scene: Scene): boolean;
+/** Whether a scene's text beats are ACTION: a dialogue scene, in a project that doesn't localise dialogue
+ *  scenes' text (`localiseDialogueText` off, the default). Its option prompts never are. */
+declare function textIsAction(project: Pick<ProjectFile, "localiseDialogueText">, scene: Scene): boolean;
 /** The built-in `padAfter`, in seconds, for a project that sets no default of its own: the same on every runtime
  *  and in Patterpad's Play window (design/proposals/line-padding.md section 4). */
 declare const DEFAULT_PAD_AFTER = 0.6;
@@ -412,7 +442,7 @@ interface BundleQualifier {
  *  the bundle; this type states the resulting contract for anyone reading a bundle. */
 type BundleCastMember = Omit<CastMember, "notes" | "actor" | "gender">;
 /** A node TYPE that can carry author-defined gameData fields (the gameData schema, project-level).
- *  Beat kinds map straight through: dialogue = `line`, narration = `text`, game event = `gameEvent`.
+ *  Beat kinds map straight through: dialogue = `line`, text = `text`, game event = `gameEvent`.
  *  `option` is a choice's option: a group that is a direct child of a `choice` group, whose gameData the
  *  host reads off the option `getChoices` hands it. Any other group's gameData stays undeclared. */
 type GameDataNodeKind = "scene" | "block" | "snippet" | "line" | "text" | "gameEvent" | "option";
@@ -589,7 +619,7 @@ interface ProjectFile {
      *  opt-in even for a voiced project (a voiced story may want voice scripts without tracking recording status). */
     trackAudioStatus?: boolean;
     /**
-     * Inline text formatting. When true, authors can mark dialogue / narration / direction /
+     * Inline text formatting. When true, authors can mark dialogue / text / direction /
      * choice-prompt text bold, italic, or bold+italic; it is stored INSIDE the localised strings
      * (and the flow's `direction`) as `<b>…</b>`, `<i>…</i>`, `<bi>…</bi>`, with literal `<`, `>`,
      * `&` escaped to `&lt;` / `&gt;` / `&amp;`. The runtime treats the string as opaque - it is the
@@ -662,6 +692,11 @@ interface ProjectFile {
     /** The project's default `padAfter` for every line and text beat that sets none and has no default above it.
      *  Absent = `DEFAULT_PAD_AFTER`. */
     padAfterDefault?: number;
+    /** Localise text lines in dialogue scenes (design/proposals/action-text.md). Off (absent) by default: a
+     *  dialogue scene's text beats (`isDialogueScene`) are then ACTION, left out of the loc files and the
+     *  written word counts, and compiled with `action: true`. On: they're localised and shown as a text
+     *  scene's are. A text scene is localised whatever this says, and an option's prompt always is. */
+    localiseDialogueText?: boolean;
     gameDataFields?: GameDataFields;
     /**
      * The Patter extensions this project takes, by id (ruled 2026-10-18: the project opts in), each pinned to a
@@ -707,6 +742,11 @@ interface LocaleFile {
     scene: string;
     locale: string;
     default?: boolean;
+    /** A translated shard only: its scene's text beats were action (`textIsAction`) when loc import last wrote
+     *  it, so they aren't in it. Loc export and `patter validate` compare this with the scene now, to report
+     *  text that has dropped out of the loc files or come into them. Absent = shown text, or a shard written
+     *  before the setting existed. */
+    textAction?: true;
     /** beatId -> text. */
     strings: Record<string, string>;
 }
@@ -919,7 +959,7 @@ interface HandoffFile {
 }
 /** An editable line as sent. */
 interface HandoffLine {
-    /** The beat id (a line, a narration beat, or an option prompt). */
+    /** The beat id (a line, a text beat, or an option prompt). */
     id: string;
     kind: "line" | "narration" | "option";
     /** The speaker, speaker qualifier (`gameId`), and direction as sent (spoken lines only). */
@@ -1362,4 +1402,4 @@ interface ExtensionFieldDecl {
 /** A node's extension values in a bundle: extension id -> field -> value, raw. */
 type NodeExtensions = Record<string, Record<string, unknown>>;
 
-export { AUTHORING_SCHEMA, type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, type BundleExtension, type BundleQualifier, COMMON_GENDERS, type CaptionDelimiters, type CastMember, type Comment, type CommentMessage, type CommentRange, type CompiledBlock, type CompiledEffect, type CompiledGroup, type CompiledScene, type CompiledSnippet, type CoverageDriver, DEFAULT_CAPTION_CHARACTER, DEFAULT_CAPTION_DELIMITERS, DEFAULT_DOCUMENTATION_CLASSES, DEFAULT_LAYOUT, DEFAULT_PAD_AFTER, DEFAULT_QUALIFIERS, DEFAULT_RECORDING_STATUSES, DEFAULT_SPEAKER_PATTERN, DEFAULT_WRITING_STATUSES, type DocLine, type DocumentationClass, EXTENSIONS_DIR, EXTENSION_SCHEMA, EXTENSION_SHARD, type EditRecord, type Effect, type EngineSave, type EstimatingConfig, type Expression, type ExtensionFieldDecl, type ExtensionShard, FLOW_SCHEMA, type FlowCursor, type FlowFile, type FlowNode, type FlowSnapshot, type FlowSnapshotV2, type FlowState, type FlowValues, type GameData, type GameDataField, type GameDataFieldType, type GameDataFields, type GameDataNodeKind, type GameEventBeat, type GrammaticalGender, type Group, HANDOFF_SCHEMA, type HandoffFile, type HandoffImport, type HandoffLine, type HandoffRow, type HostScopeDecl, type HostScopeRegistry, type HostScopeSpec, type Jump, type JumpTarget, type LineBeat, type LocaleFile, MANIFEST_EXTENSION, type NodeExtensions, PAD_AFTER_MAX, PAD_AFTER_MIN, PROJECT_EXTENSION_STEM, PROJECT_LOCALE_SCENE, PROJECT_SCHEMA, type ProjectDictionary, type ProjectExtension, type ProjectFile, type ProjectLayout, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, type RecordingFolder, type RecordingStatusDecl, SAVE_SCHEMA, SAVE_VERSION, SPEAKER_PATTERN_KEY, STRINGS_SCHEMA, type SaveEnvelope, type SaveGame, type SaveGameV2, type SavedChoice, type SavedChoiceOption, type SavedChoicePrompt, type ScalarValue, type Scene, type Selector, type SelectorExhaust, type SelectorOrder, type SelectorSnapshot, type SequenceOptions, type Snippet, type SpeakerQualifier, type StackFrame, type Suggestion, type SuggestionSource, type TextBeat, UNRESOLVED_KEY, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, formatSpeakerLabel, gameIdify, isContentlessBeat, isValidGameId, projectLayout, projectQualifiers, qualifierStringKey, speakerLabelKey, usedQualifiers, usedSpeakerPairs, walkNodes };
+export { AUTHORING_SCHEMA, type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, type BundleExtension, type BundleQualifier, COMMON_GENDERS, type CaptionDelimiters, type CastMember, type Comment, type CommentMessage, type CommentRange, type CompiledBlock, type CompiledEffect, type CompiledGroup, type CompiledScene, type CompiledSnippet, type CoverageDriver, DEFAULT_CAPTION_CHARACTER, DEFAULT_CAPTION_DELIMITERS, DEFAULT_DOCUMENTATION_CLASSES, DEFAULT_LAYOUT, DEFAULT_PAD_AFTER, DEFAULT_QUALIFIERS, DEFAULT_RECORDING_STATUSES, DEFAULT_SPEAKER_PATTERN, DEFAULT_WRITING_STATUSES, type DocLine, type DocumentationClass, EXTENSIONS_DIR, EXTENSION_SCHEMA, EXTENSION_SHARD, type EditRecord, type Effect, type EngineSave, type EstimatingConfig, type Expression, type ExtensionFieldDecl, type ExtensionShard, FLOW_SCHEMA, type FlowCursor, type FlowFile, type FlowNode, type FlowSnapshot, type FlowSnapshotV2, type FlowState, type FlowValues, type GameData, type GameDataField, type GameDataFieldType, type GameDataFields, type GameDataNodeKind, type GameEventBeat, type GrammaticalGender, type Group, HANDOFF_SCHEMA, type HandoffFile, type HandoffImport, type HandoffLine, type HandoffRow, type HostScopeDecl, type HostScopeRegistry, type HostScopeSpec, type Jump, type JumpTarget, type LineBeat, type LocaleFile, MANIFEST_EXTENSION, type NodeExtensions, PAD_AFTER_MAX, PAD_AFTER_MIN, PROJECT_EXTENSION_STEM, PROJECT_LOCALE_SCENE, PROJECT_SCHEMA, type ProjectDictionary, type ProjectExtension, type ProjectFile, type ProjectLayout, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, type RecordingFolder, type RecordingStatusDecl, SAVE_SCHEMA, SAVE_VERSION, SPEAKER_PATTERN_KEY, STRINGS_SCHEMA, type SaveEnvelope, type SaveGame, type SaveGameV2, type SavedChoice, type SavedChoiceOption, type SavedChoicePrompt, type ScalarValue, type Scene, type Selector, type SelectorExhaust, type SelectorOrder, type SelectorSnapshot, type SequenceOptions, type Snippet, type SpeakerQualifier, type StackFrame, type Suggestion, type SuggestionSource, type TextBeat, UNRESOLVED_KEY, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, formatSpeakerLabel, gameIdify, isContentlessBeat, isDialogueScene, isValidGameId, projectLayout, projectQualifiers, qualifierStringKey, resolveSceneRef, sceneAddressIndex, speakerLabelKey, textIsAction, usedQualifiers, usedSpeakerPairs, walkNodes };

package/dist/index.d.ts

@@ -43,7 +43,7 @@ interface LineBeat {
     tags?: string[];
 }
 /**
- * Authorial voice / narration - speaker-less prose (spec §2). Never voiced; its
+ * Text - speaker-less prose (spec §2). Never voiced; its
  * localised text always permits inline `{@name}` interpolation (spec §16). This
  * is the on-screen-text role (e.g. "A door slams!") - distinct from a game-event
  * beat, which is a pure engine instruction with no localised content.
@@ -63,6 +63,11 @@ interface TextBeat {
     extensions?: NodeExtensions;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
+    /** Bundle only: this text beat is ACTION, a direction to the people staging the scene that the player
+     *  never sees (design/proposals/action-text.md). Set by the compiler on every text beat of a dialogue scene
+     *  (`isDialogueScene`) when the project's `localiseDialogueText` is off; its text is then the source in
+     *  every locale. Absent = shown text. Never in source. */
+    action?: true;
 }
 /**
  * A GAME EVENT (spec §2): a pure engine instruction with no player-facing text - just `gameData` the host
@@ -252,6 +257,25 @@ declare function effectiveGameId(entity: {
     gameId?: string;
     name: string;
 }): string;
+/** A bundle's scenes by their address (effective gameId), for `resolveSceneRef` to look up in. */
+declare function sceneAddressIndex(scenes: Readonly<Record<string, {
+    gameId?: string;
+    name: string;
+}>>): Map<string, string>;
+/**
+ * THE rule for resolving a scene reference to its internal id: its address (the effective gameId, the
+ * host-facing name, spec §6) first, then its internal id. Undefined when neither names a scene.
+ *
+ * One rule for the runtime's openFlow, goto and every engine lookup, and for every tool that has to land
+ * where the game will (the Storylet Engine's Board and pairing check, Patterpad's Show Card). Each used to
+ * keep a copy, and the copies tried the internal id first, so where one scene's id was another's gameId
+ * they picked a different scene from the one the game opened (family parity item 1). Pass `byAddress`
+ * (from `sceneAddressIndex`) to look up many references in one bundle without rebuilding it.
+ */
+declare function resolveSceneRef(scenes: Readonly<Record<string, {
+    gameId?: string;
+    name: string;
+}>>, ref: string, byAddress?: ReadonlyMap<string, string>): string | undefined;
 type PropertyType = "boolean" | "number" | "string" | "flags" | "enum" | "quality";
 interface PropertyDecl {
     name: string;
@@ -394,6 +418,12 @@ declare function usedSpeakerPairs(scenes: Scene[]): {
     character: string;
     qualifier: string;
 }[];
+/** A DIALOGUE scene (design/proposals/action-text.md): one with at least one line beat that names a
+ *  character, an option's prompt included. Any other scene is a TEXT scene. */
+declare function isDialogueScene(scene: Scene): boolean;
+/** Whether a scene's text beats are ACTION: a dialogue scene, in a project that doesn't localise dialogue
+ *  scenes' text (`localiseDialogueText` off, the default). Its option prompts never are. */
+declare function textIsAction(project: Pick<ProjectFile, "localiseDialogueText">, scene: Scene): boolean;
 /** The built-in `padAfter`, in seconds, for a project that sets no default of its own: the same on every runtime
  *  and in Patterpad's Play window (design/proposals/line-padding.md section 4). */
 declare const DEFAULT_PAD_AFTER = 0.6;
@@ -412,7 +442,7 @@ interface BundleQualifier {
  *  the bundle; this type states the resulting contract for anyone reading a bundle. */
 type BundleCastMember = Omit<CastMember, "notes" | "actor" | "gender">;
 /** A node TYPE that can carry author-defined gameData fields (the gameData schema, project-level).
- *  Beat kinds map straight through: dialogue = `line`, narration = `text`, game event = `gameEvent`.
+ *  Beat kinds map straight through: dialogue = `line`, text = `text`, game event = `gameEvent`.
  *  `option` is a choice's option: a group that is a direct child of a `choice` group, whose gameData the
  *  host reads off the option `getChoices` hands it. Any other group's gameData stays undeclared. */
 type GameDataNodeKind = "scene" | "block" | "snippet" | "line" | "text" | "gameEvent" | "option";
@@ -589,7 +619,7 @@ interface ProjectFile {
      *  opt-in even for a voiced project (a voiced story may want voice scripts without tracking recording status). */
     trackAudioStatus?: boolean;
     /**
-     * Inline text formatting. When true, authors can mark dialogue / narration / direction /
+     * Inline text formatting. When true, authors can mark dialogue / text / direction /
      * choice-prompt text bold, italic, or bold+italic; it is stored INSIDE the localised strings
      * (and the flow's `direction`) as `<b>…</b>`, `<i>…</i>`, `<bi>…</bi>`, with literal `<`, `>`,
      * `&` escaped to `&lt;` / `&gt;` / `&amp;`. The runtime treats the string as opaque - it is the
@@ -662,6 +692,11 @@ interface ProjectFile {
     /** The project's default `padAfter` for every line and text beat that sets none and has no default above it.
      *  Absent = `DEFAULT_PAD_AFTER`. */
     padAfterDefault?: number;
+    /** Localise text lines in dialogue scenes (design/proposals/action-text.md). Off (absent) by default: a
+     *  dialogue scene's text beats (`isDialogueScene`) are then ACTION, left out of the loc files and the
+     *  written word counts, and compiled with `action: true`. On: they're localised and shown as a text
+     *  scene's are. A text scene is localised whatever this says, and an option's prompt always is. */
+    localiseDialogueText?: boolean;
     gameDataFields?: GameDataFields;
     /**
      * The Patter extensions this project takes, by id (ruled 2026-10-18: the project opts in), each pinned to a
@@ -707,6 +742,11 @@ interface LocaleFile {
     scene: string;
     locale: string;
     default?: boolean;
+    /** A translated shard only: its scene's text beats were action (`textIsAction`) when loc import last wrote
+     *  it, so they aren't in it. Loc export and `patter validate` compare this with the scene now, to report
+     *  text that has dropped out of the loc files or come into them. Absent = shown text, or a shard written
+     *  before the setting existed. */
+    textAction?: true;
     /** beatId -> text. */
     strings: Record<string, string>;
 }
@@ -919,7 +959,7 @@ interface HandoffFile {
 }
 /** An editable line as sent. */
 interface HandoffLine {
-    /** The beat id (a line, a narration beat, or an option prompt). */
+    /** The beat id (a line, a text beat, or an option prompt). */
     id: string;
     kind: "line" | "narration" | "option";
     /** The speaker, speaker qualifier (`gameId`), and direction as sent (spoken lines only). */
@@ -1362,4 +1402,4 @@ interface ExtensionFieldDecl {
 /** A node's extension values in a bundle: extension id -> field -> value, raw. */
 type NodeExtensions = Record<string, Record<string, unknown>>;
 
-export { AUTHORING_SCHEMA, type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, type BundleExtension, type BundleQualifier, COMMON_GENDERS, type CaptionDelimiters, type CastMember, type Comment, type CommentMessage, type CommentRange, type CompiledBlock, type CompiledEffect, type CompiledGroup, type CompiledScene, type CompiledSnippet, type CoverageDriver, DEFAULT_CAPTION_CHARACTER, DEFAULT_CAPTION_DELIMITERS, DEFAULT_DOCUMENTATION_CLASSES, DEFAULT_LAYOUT, DEFAULT_PAD_AFTER, DEFAULT_QUALIFIERS, DEFAULT_RECORDING_STATUSES, DEFAULT_SPEAKER_PATTERN, DEFAULT_WRITING_STATUSES, type DocLine, type DocumentationClass, EXTENSIONS_DIR, EXTENSION_SCHEMA, EXTENSION_SHARD, type EditRecord, type Effect, type EngineSave, type EstimatingConfig, type Expression, type ExtensionFieldDecl, type ExtensionShard, FLOW_SCHEMA, type FlowCursor, type FlowFile, type FlowNode, type FlowSnapshot, type FlowSnapshotV2, type FlowState, type FlowValues, type GameData, type GameDataField, type GameDataFieldType, type GameDataFields, type GameDataNodeKind, type GameEventBeat, type GrammaticalGender, type Group, HANDOFF_SCHEMA, type HandoffFile, type HandoffImport, type HandoffLine, type HandoffRow, type HostScopeDecl, type HostScopeRegistry, type HostScopeSpec, type Jump, type JumpTarget, type LineBeat, type LocaleFile, MANIFEST_EXTENSION, type NodeExtensions, PAD_AFTER_MAX, PAD_AFTER_MIN, PROJECT_EXTENSION_STEM, PROJECT_LOCALE_SCENE, PROJECT_SCHEMA, type ProjectDictionary, type ProjectExtension, type ProjectFile, type ProjectLayout, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, type RecordingFolder, type RecordingStatusDecl, SAVE_SCHEMA, SAVE_VERSION, SPEAKER_PATTERN_KEY, STRINGS_SCHEMA, type SaveEnvelope, type SaveGame, type SaveGameV2, type SavedChoice, type SavedChoiceOption, type SavedChoicePrompt, type ScalarValue, type Scene, type Selector, type SelectorExhaust, type SelectorOrder, type SelectorSnapshot, type SequenceOptions, type Snippet, type SpeakerQualifier, type StackFrame, type Suggestion, type SuggestionSource, type TextBeat, UNRESOLVED_KEY, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, formatSpeakerLabel, gameIdify, isContentlessBeat, isValidGameId, projectLayout, projectQualifiers, qualifierStringKey, speakerLabelKey, usedQualifiers, usedSpeakerPairs, walkNodes };
+export { AUTHORING_SCHEMA, type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, type BundleExtension, type BundleQualifier, COMMON_GENDERS, type CaptionDelimiters, type CastMember, type Comment, type CommentMessage, type CommentRange, type CompiledBlock, type CompiledEffect, type CompiledGroup, type CompiledScene, type CompiledSnippet, type CoverageDriver, DEFAULT_CAPTION_CHARACTER, DEFAULT_CAPTION_DELIMITERS, DEFAULT_DOCUMENTATION_CLASSES, DEFAULT_LAYOUT, DEFAULT_PAD_AFTER, DEFAULT_QUALIFIERS, DEFAULT_RECORDING_STATUSES, DEFAULT_SPEAKER_PATTERN, DEFAULT_WRITING_STATUSES, type DocLine, type DocumentationClass, EXTENSIONS_DIR, EXTENSION_SCHEMA, EXTENSION_SHARD, type EditRecord, type Effect, type EngineSave, type EstimatingConfig, type Expression, type ExtensionFieldDecl, type ExtensionShard, FLOW_SCHEMA, type FlowCursor, type FlowFile, type FlowNode, type FlowSnapshot, type FlowSnapshotV2, type FlowState, type FlowValues, type GameData, type GameDataField, type GameDataFieldType, type GameDataFields, type GameDataNodeKind, type GameEventBeat, type GrammaticalGender, type Group, HANDOFF_SCHEMA, type HandoffFile, type HandoffImport, type HandoffLine, type HandoffRow, type HostScopeDecl, type HostScopeRegistry, type HostScopeSpec, type Jump, type JumpTarget, type LineBeat, type LocaleFile, MANIFEST_EXTENSION, type NodeExtensions, PAD_AFTER_MAX, PAD_AFTER_MIN, PROJECT_EXTENSION_STEM, PROJECT_LOCALE_SCENE, PROJECT_SCHEMA, type ProjectDictionary, type ProjectExtension, type ProjectFile, type ProjectLayout, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, type RecordingFolder, type RecordingStatusDecl, SAVE_SCHEMA, SAVE_VERSION, SPEAKER_PATTERN_KEY, STRINGS_SCHEMA, type SaveEnvelope, type SaveGame, type SaveGameV2, type SavedChoice, type SavedChoiceOption, type SavedChoicePrompt, type ScalarValue, type Scene, type Selector, type SelectorExhaust, type SelectorOrder, type SelectorSnapshot, type SequenceOptions, type Snippet, type SpeakerQualifier, type StackFrame, type Suggestion, type SuggestionSource, type TextBeat, UNRESOLVED_KEY, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, formatSpeakerLabel, gameIdify, isContentlessBeat, isDialogueScene, isValidGameId, projectLayout, projectQualifiers, qualifierStringKey, resolveSceneRef, sceneAddressIndex, speakerLabelKey, textIsAction, usedQualifiers, usedSpeakerPairs, walkNodes };

package/dist/index.js

@@ -29,6 +29,14 @@ function effectiveGameId(entity) {
   const g = entity.gameId?.trim();
   return g ? g : gameIdify(entity.name);
 }
+function sceneAddressIndex(scenes) {
+  const byAddress = /* @__PURE__ */ new Map();
+  for (const [id, scene] of Object.entries(scenes)) byAddress.set(effectiveGameId(scene), id);
+  return byAddress;
+}
+function resolveSceneRef(scenes, ref, byAddress) {
+  return (byAddress ?? sceneAddressIndex(scenes)).get(ref) ?? (Object.hasOwn(scenes, ref) ? ref : void 0);
+}
 var COMMON_GENDERS = ["male", "female", "neuter"];
 var DEFAULT_QUALIFIERS = [
   { gameId: "vo", name: "V.O.", description: "Voice-over: the character isn't in the scene (a thought, narration, a voice in the ear)." },
@@ -76,6 +84,27 @@ function usedSpeakerPairs(scenes) {
   }
   return out;
 }
+function isDialogueScene(scene) {
+  let found = false;
+  for (const block of scene.blocks) {
+    walkNodes(block.children, (node) => {
+      if (found) return;
+      if (node.type === "group") {
+        if (node.prompt?.kind === "line" && node.prompt.character) found = true;
+        return;
+      }
+      for (const beat of node.beats ?? []) if (beat.kind === "line" && beat.character) {
+        found = true;
+        return;
+      }
+    });
+    if (found) return true;
+  }
+  return false;
+}
+function textIsAction(project, scene) {
+  return !project.localiseDialogueText && isDialogueScene(scene);
+}
 var DEFAULT_PAD_AFTER = 0.6;
 var PAD_AFTER_MIN = -10;
 var PAD_AFTER_MAX = 60;
@@ -192,13 +221,17 @@ export {
   gameIdify,
   isCaseOnlyPropertyName,
   isContentlessBeat,
+  isDialogueScene,
   isValidGameId,
   isValidPropertyName,
   projectLayout,
   projectQualifiers,
   propertyNameify,
   qualifierStringKey,
+  resolveSceneRef,
+  sceneAddressIndex,
   speakerLabelKey,
+  textIsAction,
   usedQualifiers,
   usedSpeakerPairs,
   walkNodes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patterkit/model",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Patter data-model types: source (scene/block/group/snippet/beat/jump), project, locale, authoring. The shape source-of-truth.",
   "type": "module",
   "license": "MIT",