@patterkit/model 0.16.0 → 0.18.0

package/dist/index.cjs

@@ -57,6 +57,7 @@ __export(index_exports, {
   gameIdify: () => gameIdify,
   isCaseOnlyPropertyName: () => import_expr.isCaseOnlyPropertyName,
   isContentlessBeat: () => isContentlessBeat,
+  isDialogueScene: () => isDialogueScene,
   isValidGameId: () => isValidGameId,
   isValidPropertyName: () => import_expr.isValidPropertyName,
   projectLayout: () => projectLayout,
@@ -64,6 +65,7 @@ __export(index_exports, {
   propertyNameify: () => import_expr.propertyNameify,
   qualifierStringKey: () => qualifierStringKey,
   speakerLabelKey: () => speakerLabelKey,
+  textIsAction: () => textIsAction,
   usedQualifiers: () => usedQualifiers,
   usedSpeakerPairs: () => usedSpeakerPairs,
   walkNodes: () => walkNodes
@@ -141,6 +143,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,6 +281,7 @@ var UNRESOLVED_KEY = "unresolved";
   gameIdify,
   isCaseOnlyPropertyName,
   isContentlessBeat,
+  isDialogueScene,
   isValidGameId,
   isValidPropertyName,
   projectLayout,
@@ -265,6 +289,7 @@ var UNRESOLVED_KEY = "unresolved";
   propertyNameify,
   qualifierStringKey,
   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
@@ -394,6 +399,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 +423,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 +600,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,13 +673,19 @@ 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
      * version, with its settings (the host fields its claims present, by setting name). The manifest itself
      * sits in `extensions/<id>.extension.json`, and the data in `.patterextension` shards. Authoring config:
-     * the bundle carries each one's compiled declarations and values, never this block. An extension named
-     * here whose manifest is missing is a warning, and its data is left untouched.
+     * the bundle carries each one's compiled declarations, values, and resolved settings
+     * (`BundleExtension.settings`), never this block itself. An extension named here whose manifest is missing
+     * is a warning, and its data is left untouched.
      */
     extensions?: Record<string, ProjectExtension>;
     /** Ordered writing-status ladder (not-done -> done); default `DEFAULT_WRITING_STATUSES`. */
@@ -706,6 +723,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>;
 }
@@ -918,7 +940,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). */
@@ -1072,9 +1094,9 @@ interface Bundle {
     gameDataFields?: GameDataFields;
     /**
      * The extensions the project takes, by id: each one's version and its compiled declarations by node kind,
-     * every default resolved (what `extensionDecls` reads), and the project node's own values. A node's values
-     * sit on the node, under `extensions`. Absent when the project takes none, so a bundle without them is
-     * byte for byte what it was.
+     * every default resolved (what `extensionDecls` reads), the project node's own values, and its settings,
+     * resolved (what `extensionSettings` reads). A node's values sit on the node, under `extensions`. Absent
+     * when the project takes none, so a bundle without them is byte for byte what it was.
      */
     extensions?: Record<string, BundleExtension>;
     scenes: Record<string, CompiledScene>;
@@ -1325,6 +1347,13 @@ interface BundleExtension {
     fields: Record<string, ExtensionFieldDecl[]>;
     /** The project node's values, raw, when it has any. */
     project?: Record<string, unknown>;
+    /**
+     * Every setting the manifest declares, by setting name, keys sorted: the project's value (`ProjectExtension.
+     * settings`), or else the setting's default (`@wildwinter/toolkit/extensions`' `settingValues`). A setting
+     * names a host field, so a game reads here which gameData field holds what the extension claims. Present
+     * only when the manifest declares settings.
+     */
+    settings?: Record<string, string>;
 }
 /**
  * A compiled extension field declaration (`@wildwinter/toolkit/extensions`' FieldDecl, less the editor's
@@ -1354,4 +1383,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, 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
@@ -394,6 +399,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 +423,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 +600,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,13 +673,19 @@ 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
      * version, with its settings (the host fields its claims present, by setting name). The manifest itself
      * sits in `extensions/<id>.extension.json`, and the data in `.patterextension` shards. Authoring config:
-     * the bundle carries each one's compiled declarations and values, never this block. An extension named
-     * here whose manifest is missing is a warning, and its data is left untouched.
+     * the bundle carries each one's compiled declarations, values, and resolved settings
+     * (`BundleExtension.settings`), never this block itself. An extension named here whose manifest is missing
+     * is a warning, and its data is left untouched.
      */
     extensions?: Record<string, ProjectExtension>;
     /** Ordered writing-status ladder (not-done -> done); default `DEFAULT_WRITING_STATUSES`. */
@@ -706,6 +723,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>;
 }
@@ -918,7 +940,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). */
@@ -1072,9 +1094,9 @@ interface Bundle {
     gameDataFields?: GameDataFields;
     /**
      * The extensions the project takes, by id: each one's version and its compiled declarations by node kind,
-     * every default resolved (what `extensionDecls` reads), and the project node's own values. A node's values
-     * sit on the node, under `extensions`. Absent when the project takes none, so a bundle without them is
-     * byte for byte what it was.
+     * every default resolved (what `extensionDecls` reads), the project node's own values, and its settings,
+     * resolved (what `extensionSettings` reads). A node's values sit on the node, under `extensions`. Absent
+     * when the project takes none, so a bundle without them is byte for byte what it was.
      */
     extensions?: Record<string, BundleExtension>;
     scenes: Record<string, CompiledScene>;
@@ -1325,6 +1347,13 @@ interface BundleExtension {
     fields: Record<string, ExtensionFieldDecl[]>;
     /** The project node's values, raw, when it has any. */
     project?: Record<string, unknown>;
+    /**
+     * Every setting the manifest declares, by setting name, keys sorted: the project's value (`ProjectExtension.
+     * settings`), or else the setting's default (`@wildwinter/toolkit/extensions`' `settingValues`). A setting
+     * names a host field, so a game reads here which gameData field holds what the extension claims. Present
+     * only when the manifest declares settings.
+     */
+    settings?: Record<string, string>;
 }
 /**
  * A compiled extension field declaration (`@wildwinter/toolkit/extensions`' FieldDecl, less the editor's
@@ -1354,4 +1383,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, speakerLabelKey, textIsAction, usedQualifiers, usedSpeakerPairs, walkNodes };

package/dist/index.js

@@ -76,6 +76,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,6 +213,7 @@ export {
   gameIdify,
   isCaseOnlyPropertyName,
   isContentlessBeat,
+  isDialogueScene,
   isValidGameId,
   isValidPropertyName,
   projectLayout,
@@ -199,6 +221,7 @@ export {
   propertyNameify,
   qualifierStringKey,
   speakerLabelKey,
+  textIsAction,
   usedQualifiers,
   usedSpeakerPairs,
   walkNodes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patterkit/model",
-  "version": "0.16.0",
+  "version": "0.18.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",