@patterkit/model 0.11.0 → 0.13.0

package/dist/index.cjs

@@ -26,11 +26,14 @@ __export(index_exports, {
   DEFAULT_CAPTION_DELIMITERS: () => DEFAULT_CAPTION_DELIMITERS,
   DEFAULT_DOCUMENTATION_CLASSES: () => DEFAULT_DOCUMENTATION_CLASSES,
   DEFAULT_LAYOUT: () => DEFAULT_LAYOUT,
+  DEFAULT_PAD_AFTER: () => DEFAULT_PAD_AFTER,
   DEFAULT_QUALIFIERS: () => DEFAULT_QUALIFIERS,
   DEFAULT_RECORDING_STATUSES: () => DEFAULT_RECORDING_STATUSES,
   DEFAULT_WRITING_STATUSES: () => DEFAULT_WRITING_STATUSES,
   FLOW_SCHEMA: () => FLOW_SCHEMA,
   HANDOFF_SCHEMA: () => HANDOFF_SCHEMA,
+  PAD_AFTER_MAX: () => PAD_AFTER_MAX,
+  PAD_AFTER_MIN: () => PAD_AFTER_MIN,
   PROJECT_LOCALE_SCENE: () => PROJECT_LOCALE_SCENE,
   PROJECT_SCHEMA: () => PROJECT_SCHEMA,
   RERECORD_STATUS: () => RERECORD_STATUS,
@@ -104,6 +107,9 @@ function usedQualifiers(project, scenes) {
   }
   return projectQualifiers(project).filter((q) => used.has(q.gameId));
 }
+var DEFAULT_PAD_AFTER = 0.6;
+var PAD_AFTER_MIN = -10;
+var PAD_AFTER_MAX = 60;
 var DEFAULT_WRITING_STATUSES = [
   { name: "stub", colour: 0 },
   // red
@@ -173,11 +179,14 @@ var AUTHORING_SCHEMA = "patter/authoring@0";
   DEFAULT_CAPTION_DELIMITERS,
   DEFAULT_DOCUMENTATION_CLASSES,
   DEFAULT_LAYOUT,
+  DEFAULT_PAD_AFTER,
   DEFAULT_QUALIFIERS,
   DEFAULT_RECORDING_STATUSES,
   DEFAULT_WRITING_STATUSES,
   FLOW_SCHEMA,
   HANDOFF_SCHEMA,
+  PAD_AFTER_MAX,
+  PAD_AFTER_MIN,
   PROJECT_LOCALE_SCENE,
   PROJECT_SCHEMA,
   RERECORD_STATUS,

package/dist/index.d.cts

@@ -27,6 +27,11 @@ interface LineBeat {
      *  how the line is delivered (`TAM (O.S.)`), not who says it. Absent = none. The speaker is still
      *  `character` for every authoring and reporting purpose. See `SpeakerQualifier`. */
     qualifier?: string;
+    /** The pause after this beat, before the next, in seconds (`padAfter`, design/proposals/line-padding.md):
+     *  positive waits, zero follows at once, negative starts the next line that long before this one ends (a
+     *  cut-in). Absent = the nearest `padAfterDefault` above it, else the project's, else `DEFAULT_PAD_AFTER`.
+     *  Never negative on a snippet's last line or text beat: the runtime clamps it to zero there. */
+    padAfter?: number;
     gameData?: GameData;
     /** Author-defined freeform tags (#215): a cross-cutting label layer that travels to the runtime.
      *  At runtime a beat's tags are the UNION of its own and every ancestor's (scene → block → group(s) →
@@ -42,6 +47,11 @@ interface LineBeat {
 interface TextBeat {
     id: string;
     kind: "text";
+    /** The pause after this beat, before the next, in seconds (`padAfter`, design/proposals/line-padding.md):
+     *  positive waits, zero follows at once, negative starts the next line that long before this one ends (a
+     *  cut-in). Absent = the nearest `padAfterDefault` above it, else the project's, else `DEFAULT_PAD_AFTER`.
+     *  Never negative on a snippet's last line or text beat: the runtime clamps it to zero there. */
+    padAfter?: number;
     gameData?: GameData;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
@@ -89,6 +99,9 @@ interface Snippet {
     beats?: Beat[];
     onEnter?: Effect[];
     onExit?: Effect[];
+    /** The default `padAfter` for the line and text beats inside it that set none (the nearest default wins:
+     *  snippet, then each group, innermost first, then block, then scene, then the project). */
+    padAfterDefault?: number;
     gameData?: GameData;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
@@ -123,6 +136,9 @@ interface Group {
     /** `sequence` config (order × exhaust, spec §4). */
     options?: SequenceOptions;
     children: Array<Group | Snippet>;
+    /** The default `padAfter` for the line and text beats inside it that set none (the nearest default wins:
+     *  snippet, then each group, innermost first, then block, then scene, then the project). */
+    padAfterDefault?: number;
     gameData?: GameData;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
@@ -153,6 +169,9 @@ interface Block {
      */
     gameId?: string;
     children: Array<Group | Snippet>;
+    /** The default `padAfter` for the line and text beats inside it that set none (the nearest default wins:
+     *  snippet, then each group, innermost first, then block, then scene, then the project). */
+    padAfterDefault?: number;
     gameData?: GameData;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
@@ -169,6 +188,9 @@ interface Scene {
     gameId?: string;
     /** Host metadata - e.g. `location` lives here, not as a core field. */
     gameData?: GameData;
+    /** The default `padAfter` for the line and text beats inside it that set none (the nearest default wins:
+     *  snippet, then each group, innermost first, then block, then scene, then the project). */
+    padAfterDefault?: number;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
     /** Entry behaviour / setup (spec §15). */
@@ -350,6 +372,12 @@ declare const DEFAULT_QUALIFIERS: SpeakerQualifier[];
 declare function projectQualifiers(project: Pick<ProjectFile, "qualifiers">): SpeakerQualifier[];
 /** The project's qualifiers that some line (or line prompt) in these scenes uses, in the project's order. */
 declare function usedQualifiers(project: Pick<ProjectFile, "qualifiers">, scenes: Scene[]): SpeakerQualifier[];
+/** 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;
+/** The range validation keeps a `padAfter` or `padAfterDefault` within, in seconds. */
+declare const PAD_AFTER_MIN = -10;
+declare const PAD_AFTER_MAX = 60;
 /** A qualifier as it reaches a compiled bundle: its `gameId` and authored name (the unlocalised fallback). */
 interface BundleQualifier {
     gameId: string;
@@ -595,6 +623,9 @@ interface ProjectFile {
     /** The speaker qualifiers a line can pick from, in display order; default `DEFAULT_QUALIFIERS`. An empty
      *  list means the project uses none. */
     qualifiers?: SpeakerQualifier[];
+    /** 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;
     gameDataFields?: GameDataFields;
     /** Ordered writing-status ladder (not-done -> done); default `DEFAULT_WRITING_STATUSES`. */
     writingStatuses?: WritingStatusDecl[];
@@ -836,6 +867,10 @@ interface HandoffLine {
     /** The speaker, speaker qualifier (`gameId`), and direction as sent (spoken lines only). */
     character?: string;
     qualifier?: string;
+    /** The qualifier's name as the cue printed it (`O.S.` in `TAM (O.S.)`), so a returned cue is read against
+     *  what the editor saw even after the name changes in settings. Absent in handoffs written before it was
+     *  recorded, which compare against the qualifier's current name. */
+    qualifierName?: string;
     direction?: string;
     /** The text as sent: the baseline for every comparison on reimport. */
     baseline: string;
@@ -880,6 +915,7 @@ interface CompiledSnippet {
     beats?: Beat[];
     onEnter?: CompiledEffect[];
     onExit?: CompiledEffect[];
+    padAfterDefault?: number;
     gameData?: GameData;
     tags?: string[];
     jump?: Jump;
@@ -899,6 +935,7 @@ interface CompiledGroup {
     shared?: boolean;
     options?: SequenceOptions;
     children: Array<CompiledGroup | CompiledSnippet>;
+    padAfterDefault?: number;
     gameData?: GameData;
     tags?: string[];
     /** Option-position fields (spec §5) - only when a direct child of a `choice`. */
@@ -916,6 +953,7 @@ interface CompiledBlock {
     /** Host-facing address (spec §6); the runtime resolves it to `id`. Absent = derived from `name`. */
     gameId?: string;
     children: Array<CompiledGroup | CompiledSnippet>;
+    padAfterDefault?: number;
     gameData?: GameData;
     tags?: string[];
 }
@@ -925,6 +963,7 @@ interface CompiledScene {
     name: string;
     /** Host-facing address (spec §6); the runtime resolves it to `id`. Absent = derived from `name`. */
     gameId?: string;
+    padAfterDefault?: number;
     gameData?: GameData;
     tags?: string[];
     onEntry?: CompiledEffect[];
@@ -952,6 +991,8 @@ interface Bundle {
     /** The speaker qualifiers the content uses, in the project's order. Absent when no line has one, so a
      *  bundle without qualifiers is exactly as before. */
     qualifiers?: BundleQualifier[];
+    /** The project's own `padAfterDefault`, when it sets one; absent = `DEFAULT_PAD_AFTER`. */
+    padAfterDefault?: number;
     properties?: PropertyDecl[];
     /** Host / world scope declarations, baked from the project so the runtime can self-back a declared
      *  scope (`@world`, ...) when no host resolver claims its token. Absent = no host scopes. */
@@ -1035,6 +1076,8 @@ interface SavedChoicePrompt {
     direction?: string;
     qualifier?: string;
     qualifierName?: string;
+    /** The prompt's resolved pause (line padding). Absent in a save written before it existed. */
+    padAfter?: number;
 }
 /** One option of a pending choice, saved VERBATIM: re-deriving on load would re-evaluate conditions. */
 interface SavedChoiceOption {
@@ -1092,13 +1135,26 @@ interface SaveGame {
     /** Each live flow's snapshot, keyed by flow id. */
     flows: Record<string, FlowSnapshot>;
 }
-/** A version 2 flow snapshot, which carried the flow's property values itself. Still read. */
-interface FlowSnapshotV2 extends FlowSnapshot {
+/** One flow's own property values, without its id: the sections a version 2 save carried per flow, and a
+ *  `FlowState` carries now. */
+interface FlowValues {
     /** The NOT-shared `@patter` globals, under token "patter". */
     scopes: EngineSave;
     /** Per-scene NOT-shared `@scene` bags (scene id -> name -> value). */
     sceneBags: Record<string, Record<string, ScalarValue>>;
 }
+/** A version 2 flow snapshot, which carried the flow's property values itself. Still read. */
+interface FlowSnapshotV2 extends FlowSnapshot, FlowValues {
+}
+/**
+ * One flow taken out of an engine (`engine.captureFlow`) to be put back later (`engine.restoreFlow`), under the
+ * same id or another: its snapshot as a save writes it, and its own property values without its id. Plain data
+ * in the save's spelling, so a game saves it as it saves anything else. Shared state (shared properties, world
+ * visit counts, shared selectors) is never in it, so restoring one rewinds nothing else.
+ */
+interface FlowState extends FlowSnapshot, FlowValues {
+    version: typeof SAVE_VERSION;
+}
 /** A version 2 save, from before the registry held the properties. Every runtime still reads it: its
  *  property sections move into the registry (under the keys in the header above) as it loads. */
 interface SaveGameV2 {
@@ -1136,4 +1192,4 @@ declare const PROJECT_SCHEMA = "patter/project@0";
 declare const STRINGS_SCHEMA = "patter/strings@0";
 declare const AUTHORING_SCHEMA = "patter/authoring@0";
 
-export { AUTHORING_SCHEMA, type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, 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_QUALIFIERS, DEFAULT_RECORDING_STATUSES, DEFAULT_WRITING_STATUSES, type DocLine, type DocumentationClass, type EditRecord, type Effect, type EngineSave, type EstimatingConfig, type Expression, FLOW_SCHEMA, type FlowCursor, type FlowFile, type FlowNode, type FlowSnapshot, type FlowSnapshotV2, 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, PROJECT_LOCALE_SCENE, PROJECT_SCHEMA, type ProjectDictionary, type ProjectFile, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, type RecordingFolder, type RecordingStatusDecl, SAVE_SCHEMA, SAVE_VERSION, 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, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, gameIdify, isContentlessBeat, isValidGameId, projectLayout, projectQualifiers, qualifierStringKey, usedQualifiers, walkNodes };
+export { AUTHORING_SCHEMA, type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, 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_WRITING_STATUSES, type DocLine, type DocumentationClass, type EditRecord, type Effect, type EngineSave, type EstimatingConfig, type Expression, 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, PAD_AFTER_MAX, PAD_AFTER_MIN, PROJECT_LOCALE_SCENE, PROJECT_SCHEMA, type ProjectDictionary, type ProjectFile, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, type RecordingFolder, type RecordingStatusDecl, SAVE_SCHEMA, SAVE_VERSION, 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, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, gameIdify, isContentlessBeat, isValidGameId, projectLayout, projectQualifiers, qualifierStringKey, usedQualifiers, walkNodes };

package/dist/index.d.ts

@@ -27,6 +27,11 @@ interface LineBeat {
      *  how the line is delivered (`TAM (O.S.)`), not who says it. Absent = none. The speaker is still
      *  `character` for every authoring and reporting purpose. See `SpeakerQualifier`. */
     qualifier?: string;
+    /** The pause after this beat, before the next, in seconds (`padAfter`, design/proposals/line-padding.md):
+     *  positive waits, zero follows at once, negative starts the next line that long before this one ends (a
+     *  cut-in). Absent = the nearest `padAfterDefault` above it, else the project's, else `DEFAULT_PAD_AFTER`.
+     *  Never negative on a snippet's last line or text beat: the runtime clamps it to zero there. */
+    padAfter?: number;
     gameData?: GameData;
     /** Author-defined freeform tags (#215): a cross-cutting label layer that travels to the runtime.
      *  At runtime a beat's tags are the UNION of its own and every ancestor's (scene → block → group(s) →
@@ -42,6 +47,11 @@ interface LineBeat {
 interface TextBeat {
     id: string;
     kind: "text";
+    /** The pause after this beat, before the next, in seconds (`padAfter`, design/proposals/line-padding.md):
+     *  positive waits, zero follows at once, negative starts the next line that long before this one ends (a
+     *  cut-in). Absent = the nearest `padAfterDefault` above it, else the project's, else `DEFAULT_PAD_AFTER`.
+     *  Never negative on a snippet's last line or text beat: the runtime clamps it to zero there. */
+    padAfter?: number;
     gameData?: GameData;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
@@ -89,6 +99,9 @@ interface Snippet {
     beats?: Beat[];
     onEnter?: Effect[];
     onExit?: Effect[];
+    /** The default `padAfter` for the line and text beats inside it that set none (the nearest default wins:
+     *  snippet, then each group, innermost first, then block, then scene, then the project). */
+    padAfterDefault?: number;
     gameData?: GameData;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
@@ -123,6 +136,9 @@ interface Group {
     /** `sequence` config (order × exhaust, spec §4). */
     options?: SequenceOptions;
     children: Array<Group | Snippet>;
+    /** The default `padAfter` for the line and text beats inside it that set none (the nearest default wins:
+     *  snippet, then each group, innermost first, then block, then scene, then the project). */
+    padAfterDefault?: number;
     gameData?: GameData;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
@@ -153,6 +169,9 @@ interface Block {
      */
     gameId?: string;
     children: Array<Group | Snippet>;
+    /** The default `padAfter` for the line and text beats inside it that set none (the nearest default wins:
+     *  snippet, then each group, innermost first, then block, then scene, then the project). */
+    padAfterDefault?: number;
     gameData?: GameData;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
@@ -169,6 +188,9 @@ interface Scene {
     gameId?: string;
     /** Host metadata - e.g. `location` lives here, not as a core field. */
     gameData?: GameData;
+    /** The default `padAfter` for the line and text beats inside it that set none (the nearest default wins:
+     *  snippet, then each group, innermost first, then block, then scene, then the project). */
+    padAfterDefault?: number;
     /** Author tags (#215). See LineBeat.tags. */
     tags?: string[];
     /** Entry behaviour / setup (spec §15). */
@@ -350,6 +372,12 @@ declare const DEFAULT_QUALIFIERS: SpeakerQualifier[];
 declare function projectQualifiers(project: Pick<ProjectFile, "qualifiers">): SpeakerQualifier[];
 /** The project's qualifiers that some line (or line prompt) in these scenes uses, in the project's order. */
 declare function usedQualifiers(project: Pick<ProjectFile, "qualifiers">, scenes: Scene[]): SpeakerQualifier[];
+/** 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;
+/** The range validation keeps a `padAfter` or `padAfterDefault` within, in seconds. */
+declare const PAD_AFTER_MIN = -10;
+declare const PAD_AFTER_MAX = 60;
 /** A qualifier as it reaches a compiled bundle: its `gameId` and authored name (the unlocalised fallback). */
 interface BundleQualifier {
     gameId: string;
@@ -595,6 +623,9 @@ interface ProjectFile {
     /** The speaker qualifiers a line can pick from, in display order; default `DEFAULT_QUALIFIERS`. An empty
      *  list means the project uses none. */
     qualifiers?: SpeakerQualifier[];
+    /** 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;
     gameDataFields?: GameDataFields;
     /** Ordered writing-status ladder (not-done -> done); default `DEFAULT_WRITING_STATUSES`. */
     writingStatuses?: WritingStatusDecl[];
@@ -836,6 +867,10 @@ interface HandoffLine {
     /** The speaker, speaker qualifier (`gameId`), and direction as sent (spoken lines only). */
     character?: string;
     qualifier?: string;
+    /** The qualifier's name as the cue printed it (`O.S.` in `TAM (O.S.)`), so a returned cue is read against
+     *  what the editor saw even after the name changes in settings. Absent in handoffs written before it was
+     *  recorded, which compare against the qualifier's current name. */
+    qualifierName?: string;
     direction?: string;
     /** The text as sent: the baseline for every comparison on reimport. */
     baseline: string;
@@ -880,6 +915,7 @@ interface CompiledSnippet {
     beats?: Beat[];
     onEnter?: CompiledEffect[];
     onExit?: CompiledEffect[];
+    padAfterDefault?: number;
     gameData?: GameData;
     tags?: string[];
     jump?: Jump;
@@ -899,6 +935,7 @@ interface CompiledGroup {
     shared?: boolean;
     options?: SequenceOptions;
     children: Array<CompiledGroup | CompiledSnippet>;
+    padAfterDefault?: number;
     gameData?: GameData;
     tags?: string[];
     /** Option-position fields (spec §5) - only when a direct child of a `choice`. */
@@ -916,6 +953,7 @@ interface CompiledBlock {
     /** Host-facing address (spec §6); the runtime resolves it to `id`. Absent = derived from `name`. */
     gameId?: string;
     children: Array<CompiledGroup | CompiledSnippet>;
+    padAfterDefault?: number;
     gameData?: GameData;
     tags?: string[];
 }
@@ -925,6 +963,7 @@ interface CompiledScene {
     name: string;
     /** Host-facing address (spec §6); the runtime resolves it to `id`. Absent = derived from `name`. */
     gameId?: string;
+    padAfterDefault?: number;
     gameData?: GameData;
     tags?: string[];
     onEntry?: CompiledEffect[];
@@ -952,6 +991,8 @@ interface Bundle {
     /** The speaker qualifiers the content uses, in the project's order. Absent when no line has one, so a
      *  bundle without qualifiers is exactly as before. */
     qualifiers?: BundleQualifier[];
+    /** The project's own `padAfterDefault`, when it sets one; absent = `DEFAULT_PAD_AFTER`. */
+    padAfterDefault?: number;
     properties?: PropertyDecl[];
     /** Host / world scope declarations, baked from the project so the runtime can self-back a declared
      *  scope (`@world`, ...) when no host resolver claims its token. Absent = no host scopes. */
@@ -1035,6 +1076,8 @@ interface SavedChoicePrompt {
     direction?: string;
     qualifier?: string;
     qualifierName?: string;
+    /** The prompt's resolved pause (line padding). Absent in a save written before it existed. */
+    padAfter?: number;
 }
 /** One option of a pending choice, saved VERBATIM: re-deriving on load would re-evaluate conditions. */
 interface SavedChoiceOption {
@@ -1092,13 +1135,26 @@ interface SaveGame {
     /** Each live flow's snapshot, keyed by flow id. */
     flows: Record<string, FlowSnapshot>;
 }
-/** A version 2 flow snapshot, which carried the flow's property values itself. Still read. */
-interface FlowSnapshotV2 extends FlowSnapshot {
+/** One flow's own property values, without its id: the sections a version 2 save carried per flow, and a
+ *  `FlowState` carries now. */
+interface FlowValues {
     /** The NOT-shared `@patter` globals, under token "patter". */
     scopes: EngineSave;
     /** Per-scene NOT-shared `@scene` bags (scene id -> name -> value). */
     sceneBags: Record<string, Record<string, ScalarValue>>;
 }
+/** A version 2 flow snapshot, which carried the flow's property values itself. Still read. */
+interface FlowSnapshotV2 extends FlowSnapshot, FlowValues {
+}
+/**
+ * One flow taken out of an engine (`engine.captureFlow`) to be put back later (`engine.restoreFlow`), under the
+ * same id or another: its snapshot as a save writes it, and its own property values without its id. Plain data
+ * in the save's spelling, so a game saves it as it saves anything else. Shared state (shared properties, world
+ * visit counts, shared selectors) is never in it, so restoring one rewinds nothing else.
+ */
+interface FlowState extends FlowSnapshot, FlowValues {
+    version: typeof SAVE_VERSION;
+}
 /** A version 2 save, from before the registry held the properties. Every runtime still reads it: its
  *  property sections move into the registry (under the keys in the header above) as it loads. */
 interface SaveGameV2 {
@@ -1136,4 +1192,4 @@ declare const PROJECT_SCHEMA = "patter/project@0";
 declare const STRINGS_SCHEMA = "patter/strings@0";
 declare const AUTHORING_SCHEMA = "patter/authoring@0";
 
-export { AUTHORING_SCHEMA, type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, 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_QUALIFIERS, DEFAULT_RECORDING_STATUSES, DEFAULT_WRITING_STATUSES, type DocLine, type DocumentationClass, type EditRecord, type Effect, type EngineSave, type EstimatingConfig, type Expression, FLOW_SCHEMA, type FlowCursor, type FlowFile, type FlowNode, type FlowSnapshot, type FlowSnapshotV2, 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, PROJECT_LOCALE_SCENE, PROJECT_SCHEMA, type ProjectDictionary, type ProjectFile, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, type RecordingFolder, type RecordingStatusDecl, SAVE_SCHEMA, SAVE_VERSION, 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, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, gameIdify, isContentlessBeat, isValidGameId, projectLayout, projectQualifiers, qualifierStringKey, usedQualifiers, walkNodes };
+export { AUTHORING_SCHEMA, type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, 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_WRITING_STATUSES, type DocLine, type DocumentationClass, type EditRecord, type Effect, type EngineSave, type EstimatingConfig, type Expression, 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, PAD_AFTER_MAX, PAD_AFTER_MIN, PROJECT_LOCALE_SCENE, PROJECT_SCHEMA, type ProjectDictionary, type ProjectFile, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, type RecordingFolder, type RecordingStatusDecl, SAVE_SCHEMA, SAVE_VERSION, 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, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, gameIdify, isContentlessBeat, isValidGameId, projectLayout, projectQualifiers, qualifierStringKey, usedQualifiers, walkNodes };

package/dist/index.js

@@ -53,6 +53,9 @@ function usedQualifiers(project, scenes) {
   }
   return projectQualifiers(project).filter((q) => used.has(q.gameId));
 }
+var DEFAULT_PAD_AFTER = 0.6;
+var PAD_AFTER_MIN = -10;
+var PAD_AFTER_MAX = 60;
 var DEFAULT_WRITING_STATUSES = [
   { name: "stub", colour: 0 },
   // red
@@ -121,11 +124,14 @@ export {
   DEFAULT_CAPTION_DELIMITERS,
   DEFAULT_DOCUMENTATION_CLASSES,
   DEFAULT_LAYOUT,
+  DEFAULT_PAD_AFTER,
   DEFAULT_QUALIFIERS,
   DEFAULT_RECORDING_STATUSES,
   DEFAULT_WRITING_STATUSES,
   FLOW_SCHEMA,
   HANDOFF_SCHEMA,
+  PAD_AFTER_MAX,
+  PAD_AFTER_MIN,
   PROJECT_LOCALE_SCENE,
   PROJECT_SCHEMA,
   RERECORD_STATUS,

package/package.json

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