@patterkit/runtime 0.22.0 → 0.24.0

package/dist/index.d.cts

@@ -1,8 +1,14 @@
 import { ScalarValue } from '@wildwinter/expr';
 import { ScopeRegistry, PropertyBag, ScopeDeclaration, LogMount, ScopeResolver, PropertyRow } from '@wildwinter/scoperegistry';
 export { PropertyRow } from '@wildwinter/scoperegistry';
-import { GameData, Bundle, CompiledGroup, CompiledSnippet, CompiledBlock, FlowSnapshot, EngineSave, SaveGame, SaveGameV2, PropertyType, ScalarValue as ScalarValue$1, GameDataNodeKind, GameDataField } from '@patterkit/model';
-export { Bundle, EngineSave, FlowCursor, FlowSnapshot, SaveEnvelope, SaveGame, SavedChoice, SavedChoiceOption, SavedChoicePrompt, SelectorSnapshot, StackFrame } from '@patterkit/model';
+import { GameData, Bundle, CompiledGroup, CompiledSnippet, CompiledBlock, FlowSnapshot, FlowState, EngineSave, SaveGame, SaveGameV2, PropertyType, ScalarValue as ScalarValue$1, GameDataNodeKind, GameDataField } from '@patterkit/model';
+export { Bundle, DEFAULT_PAD_AFTER, EngineSave, FlowCursor, FlowSnapshot, FlowState, FlowValues, SaveEnvelope, SaveGame, SavedChoice, SavedChoiceOption, SavedChoicePrompt, SelectorSnapshot, StackFrame } from '@patterkit/model';
+
+/** A beat's own `padAfter` (when it sets one) and its resolved one (always). */
+interface BeatPad {
+    own?: number;
+    resolved: number;
+}
 
 type SelectableNode = CompiledGroup | CompiledSnippet;
 
@@ -16,12 +22,14 @@ type StepResult = {
     direction?: string;
     qualifier?: string;
     qualifierName?: string;
+    padAfter: number;
     gameData?: GameData;
     tags?: string[];
 } | {
     type: "text";
     id: string;
     text: string;
+    padAfter: number;
     gameData?: GameData;
     tags?: string[];
 } | {
@@ -50,6 +58,11 @@ interface BeatInfo {
     qualifier?: string;
     /** The qualifier's shown name (source locale), e.g. `V.O.`. */
     qualifierName?: string;
+    /** The pause after this beat, in seconds, resolved from its own value and the defaults above it (line and
+     *  text only; see line padding). What a delivered step carries. */
+    padAfter?: number;
+    /** The beat's own `padAfter`, when it sets one (line and text only). */
+    ownPadAfter?: number;
     /** Source text, un-interpolated (line / text). Omitted for gameEvent and IDs-only bundles. */
     text?: string;
     /** Author gameData overrides on this beat (raw, as the step carries them). Omitted when empty. */
@@ -120,6 +133,9 @@ interface ChoicePrompt {
     /** The speaker qualifier's `gameId` (`vo`), and its resolved shown name (locale-aware). */
     qualifier?: string;
     qualifierName?: string;
+    /** The prompt's resolved pause, in seconds: when it is spoken (by `replayPromptOnChoose`, or by a game that
+     *  voices it), the wait before the reply, negative to cut in on the question (line padding). */
+    padAfter: number;
 }
 /** A single option of a pending `choice` group. */
 interface ChoiceOption {
@@ -374,6 +390,8 @@ interface FlowHost {
     blockGameIdToId: Map<string, Map<string, string>>;
     /** Author tags (#215): node id -> accumulated tags (own + every ancestor's, deduped). Built once. */
     tagIndex: Map<string, string[]>;
+    /** Every line and text beat's resolved pause (line padding), precomputed per bundle (pads.ts). */
+    padIndex: Map<string, BeatPad>;
     /** The game's one registry: `@patter` (the SHARED globals), host scopes, every instance bag. */
     registry: ScopeRegistry;
     /** True when the engine made the registry (a standalone game): `saveGame()` then carries its values. */
@@ -668,6 +686,20 @@ declare class Engine {
     /** Let go of what a closed checkpoint recorded, so a handle the game keeps holds nothing. */
     private static forget;
     private refuseInCheckpoint;
+    /**
+     * Take flow `id` out of the engine as plain data, to be put back later with {@link restoreFlow}: its snapshot as
+     * `saveGame` writes it, and its own property values without its id (so it can come back under another). Shared
+     * state is never in it. Doesn't close the flow; close it with {@link closeFlow} AFTER capturing, since closing
+     * drops its values. Only reads, so it is allowed while a checkpoint is open.
+     */
+    captureFlow(id: string): FlowState;
+    /**
+     * Open flow `id` from a {@link captureFlow} state, the per-flow half of `loadGame`: its values go into the
+     * registry as a load's do, and the flow is restored as a load restores each flow. `id` needn't be the id it was
+     * captured from. Against an edited bundle it re-finds its place by id, as a load does. Refused if a flow of
+     * that id is open, or while a checkpoint is.
+     */
+    restoreFlow(id: string, state: FlowState): Flow;
     /** Close (remove) a flow. The flow object is FINISHED, not merely unregistered, so a host still
      *  holding it cannot keep advancing it into the shared world (see {@link Flow.close}). */
     closeFlow(id: string): void;
@@ -1005,6 +1037,12 @@ declare class Flow {
      *  locale, else the authoring `displayName`. Undefined when the character has no display name at all
      *  (the host falls back to the `character` token itself). */
     private resolveCharacterName;
+    /** The resolved pause of the beat an option shows as its prompt (its authored prompt, else its first content
+     *  line), for a saved option that predates prompts carrying one. */
+    private promptPadOf;
+    /** A line or text beat's resolved pause (line padding): its own `padAfter`, else the nearest default above
+     *  it, else the project's, else the built-in one; clamped to zero on a snippet's last line. */
+    private padOf;
     /** A speaker qualifier's shown name, resolved as a character's is: the `qualifier:<gameId>` string in the
      *  active locale, else the default locale, else the authored name. Undefined in IDs-only mode (the game
      *  maps the `qualifier` gameId itself). */

package/dist/index.d.ts

@@ -1,8 +1,14 @@
 import { ScalarValue } from '@wildwinter/expr';
 import { ScopeRegistry, PropertyBag, ScopeDeclaration, LogMount, ScopeResolver, PropertyRow } from '@wildwinter/scoperegistry';
 export { PropertyRow } from '@wildwinter/scoperegistry';
-import { GameData, Bundle, CompiledGroup, CompiledSnippet, CompiledBlock, FlowSnapshot, EngineSave, SaveGame, SaveGameV2, PropertyType, ScalarValue as ScalarValue$1, GameDataNodeKind, GameDataField } from '@patterkit/model';
-export { Bundle, EngineSave, FlowCursor, FlowSnapshot, SaveEnvelope, SaveGame, SavedChoice, SavedChoiceOption, SavedChoicePrompt, SelectorSnapshot, StackFrame } from '@patterkit/model';
+import { GameData, Bundle, CompiledGroup, CompiledSnippet, CompiledBlock, FlowSnapshot, FlowState, EngineSave, SaveGame, SaveGameV2, PropertyType, ScalarValue as ScalarValue$1, GameDataNodeKind, GameDataField } from '@patterkit/model';
+export { Bundle, DEFAULT_PAD_AFTER, EngineSave, FlowCursor, FlowSnapshot, FlowState, FlowValues, SaveEnvelope, SaveGame, SavedChoice, SavedChoiceOption, SavedChoicePrompt, SelectorSnapshot, StackFrame } from '@patterkit/model';
+
+/** A beat's own `padAfter` (when it sets one) and its resolved one (always). */
+interface BeatPad {
+    own?: number;
+    resolved: number;
+}
 
 type SelectableNode = CompiledGroup | CompiledSnippet;
 
@@ -16,12 +22,14 @@ type StepResult = {
     direction?: string;
     qualifier?: string;
     qualifierName?: string;
+    padAfter: number;
     gameData?: GameData;
     tags?: string[];
 } | {
     type: "text";
     id: string;
     text: string;
+    padAfter: number;
     gameData?: GameData;
     tags?: string[];
 } | {
@@ -50,6 +58,11 @@ interface BeatInfo {
     qualifier?: string;
     /** The qualifier's shown name (source locale), e.g. `V.O.`. */
     qualifierName?: string;
+    /** The pause after this beat, in seconds, resolved from its own value and the defaults above it (line and
+     *  text only; see line padding). What a delivered step carries. */
+    padAfter?: number;
+    /** The beat's own `padAfter`, when it sets one (line and text only). */
+    ownPadAfter?: number;
     /** Source text, un-interpolated (line / text). Omitted for gameEvent and IDs-only bundles. */
     text?: string;
     /** Author gameData overrides on this beat (raw, as the step carries them). Omitted when empty. */
@@ -120,6 +133,9 @@ interface ChoicePrompt {
     /** The speaker qualifier's `gameId` (`vo`), and its resolved shown name (locale-aware). */
     qualifier?: string;
     qualifierName?: string;
+    /** The prompt's resolved pause, in seconds: when it is spoken (by `replayPromptOnChoose`, or by a game that
+     *  voices it), the wait before the reply, negative to cut in on the question (line padding). */
+    padAfter: number;
 }
 /** A single option of a pending `choice` group. */
 interface ChoiceOption {
@@ -374,6 +390,8 @@ interface FlowHost {
     blockGameIdToId: Map<string, Map<string, string>>;
     /** Author tags (#215): node id -> accumulated tags (own + every ancestor's, deduped). Built once. */
     tagIndex: Map<string, string[]>;
+    /** Every line and text beat's resolved pause (line padding), precomputed per bundle (pads.ts). */
+    padIndex: Map<string, BeatPad>;
     /** The game's one registry: `@patter` (the SHARED globals), host scopes, every instance bag. */
     registry: ScopeRegistry;
     /** True when the engine made the registry (a standalone game): `saveGame()` then carries its values. */
@@ -668,6 +686,20 @@ declare class Engine {
     /** Let go of what a closed checkpoint recorded, so a handle the game keeps holds nothing. */
     private static forget;
     private refuseInCheckpoint;
+    /**
+     * Take flow `id` out of the engine as plain data, to be put back later with {@link restoreFlow}: its snapshot as
+     * `saveGame` writes it, and its own property values without its id (so it can come back under another). Shared
+     * state is never in it. Doesn't close the flow; close it with {@link closeFlow} AFTER capturing, since closing
+     * drops its values. Only reads, so it is allowed while a checkpoint is open.
+     */
+    captureFlow(id: string): FlowState;
+    /**
+     * Open flow `id` from a {@link captureFlow} state, the per-flow half of `loadGame`: its values go into the
+     * registry as a load's do, and the flow is restored as a load restores each flow. `id` needn't be the id it was
+     * captured from. Against an edited bundle it re-finds its place by id, as a load does. Refused if a flow of
+     * that id is open, or while a checkpoint is.
+     */
+    restoreFlow(id: string, state: FlowState): Flow;
     /** Close (remove) a flow. The flow object is FINISHED, not merely unregistered, so a host still
      *  holding it cannot keep advancing it into the shared world (see {@link Flow.close}). */
     closeFlow(id: string): void;
@@ -1005,6 +1037,12 @@ declare class Flow {
      *  locale, else the authoring `displayName`. Undefined when the character has no display name at all
      *  (the host falls back to the `character` token itself). */
     private resolveCharacterName;
+    /** The resolved pause of the beat an option shows as its prompt (its authored prompt, else its first content
+     *  line), for a saved option that predates prompts carrying one. */
+    private promptPadOf;
+    /** A line or text beat's resolved pause (line padding): its own `padAfter`, else the nearest default above
+     *  it, else the project's, else the built-in one; clamped to zero on a snippet's last line. */
+    private padOf;
     /** A speaker qualifier's shown name, resolved as a character's is: the `qualifier:<gameId>` string in the
      *  active locale, else the default locale, else the authored name. Undefined in IDs-only mode (the game
      *  maps the `qualifier` gameId itself). */

package/dist/index.js

@@ -4,7 +4,7 @@ import { matchedSpecificity as scoreSpecificity } from "@wildwinter/expr-specifi
 import { ScopeRegistry } from "@wildwinter/scoperegistry";
 import { defaultFor, PropertyBag } from "@wildwinter/scoperegistry";
 import { patterDialect, interpolate, splitRef, stripCaptions } from "@patterkit/dialect";
-import { walkNodes, effectiveGameId, castStringKey, qualifierStringKey, DEFAULT_CAPTION_DELIMITERS, DEFAULT_CAPTION_CHARACTER } from "@patterkit/model";
+import { walkNodes, effectiveGameId, castStringKey, qualifierStringKey, DEFAULT_PAD_AFTER as DEFAULT_PAD_AFTER2, DEFAULT_CAPTION_DELIMITERS, DEFAULT_CAPTION_CHARACTER } from "@patterkit/model";
 
 // src/tags.ts
 function dedupe(tags) {
@@ -40,6 +40,45 @@ function buildTagIndex(bundle) {
   return index;
 }
 
+// src/pads.ts
+import { DEFAULT_PAD_AFTER } from "@patterkit/model";
+var spoken = (b) => b.kind === "line" || b.kind === "text";
+var num = (v) => typeof v === "number" && Number.isFinite(v) ? v : void 0;
+function buildPadIndex(bundle) {
+  const index = /* @__PURE__ */ new Map();
+  const set = (beat, inherited, clamp) => {
+    const own = beat.kind === "gameEvent" ? void 0 : num(beat.padAfter);
+    let resolved = own ?? inherited;
+    if (clamp && resolved < 0) resolved = 0;
+    index.set(beat.id, own !== void 0 ? { own, resolved } : { resolved });
+  };
+  const visit = (node, inherited) => {
+    const def = num(node.padAfterDefault) ?? inherited;
+    if (node.type === "group") {
+      if (node.prompt) set(node.prompt, def, false);
+      for (const child of node.children) visit(child, def);
+      return;
+    }
+    const beats = node.beats ?? [];
+    let last = -1;
+    beats.forEach((b, i) => {
+      if (spoken(b)) last = i;
+    });
+    beats.forEach((b, i) => {
+      if (spoken(b)) set(b, def, i === last);
+    });
+  };
+  const projectDefault = num(bundle.padAfterDefault) ?? DEFAULT_PAD_AFTER;
+  for (const scene of Object.values(bundle.scenes)) {
+    const sceneDefault = num(scene.padAfterDefault) ?? projectDefault;
+    for (const block of scene.blocks) {
+      const blockDefault = num(block.padAfterDefault) ?? sceneDefault;
+      for (const child of block.children) visit(child, blockDefault);
+    }
+  }
+  return index;
+}
+
 // src/engine.ts
 import { SAVE_VERSION } from "@patterkit/model";
 var astCache = /* @__PURE__ */ new WeakMap();
@@ -52,11 +91,21 @@ function tagIndexFor(bundle) {
   }
   return index;
 }
+var padIndexCache = /* @__PURE__ */ new WeakMap();
+function padIndexFor(bundle) {
+  let index = padIndexCache.get(bundle);
+  if (!index) {
+    index = buildPadIndex(bundle);
+    padIndexCache.set(bundle, index);
+  }
+  return index;
+}
 function tagsOf(host, id) {
   return host.tagIndex.get(id)?.slice();
 }
 var OWNER = "Patter";
 var esc = (id) => id.replace(/%/g, "%25").replace(/\//g, "%2F");
+var unesc = (key) => key.replace(/%2F/g, "/").replace(/%25/g, "%");
 var OWNS_REGISTRY = /* @__PURE__ */ Symbol("ownsRegistry");
 var keys = {
   /** A scene's SHARED `@scene` props (one bag per scene, every flow's). */
@@ -187,6 +236,7 @@ var Engine = class _Engine {
       blockGameIdToId: this.blockGameIdToId,
       // same instances the engine resolves with
       tagIndex: tagIndexFor(bundle),
+      padIndex: padIndexFor(bundle),
       registry,
       ownsRegistry,
       patterBag,
@@ -591,6 +641,9 @@ var Engine = class _Engine {
       }
     }
     if (beat.kind === "line" || beat.kind === "text") {
+      const pad = this.host.padIndex.get(beat.id);
+      info.padAfter = pad?.resolved ?? DEFAULT_PAD_AFTER2;
+      if (pad?.own !== void 0) info.ownPadAfter = pad.own;
       const source = this.host.defaultStrings[beat.id];
       if (source !== void 0) info.text = source;
     }
@@ -681,6 +734,45 @@ var Engine = class _Engine {
   refuseInCheckpoint(what) {
     if (this.host.journal) throw new Error(`${what} can't be undone, so it isn't allowed while a checkpoint is open`);
   }
+  /**
+   * Take flow `id` out of the engine as plain data, to be put back later with {@link restoreFlow}: its snapshot as
+   * `saveGame` writes it, and its own property values without its id (so it can come back under another). Shared
+   * state is never in it. Doesn't close the flow; close it with {@link closeFlow} AFTER capturing, since closing
+   * drops its values. Only reads, so it is allowed while a checkpoint is open.
+   */
+  captureFlow(id) {
+    const flow = this.flowsById.get(id);
+    if (!flow) throw new Error(`no open flow '${id}' to capture`);
+    return { version: SAVE_VERSION, ...flow.snapshot(), ...flowValuesFrom(id, this.host.registry.save()) };
+  }
+  /**
+   * Open flow `id` from a {@link captureFlow} state, the per-flow half of `loadGame`: its values go into the
+   * registry as a load's do, and the flow is restored as a load restores each flow. `id` needn't be the id it was
+   * captured from. Against an edited bundle it re-finds its place by id, as a load does. Refused if a flow of
+   * that id is open, or while a checkpoint is.
+   */
+  restoreFlow(id, state) {
+    this.refuseInCheckpoint("restoreFlow");
+    const version = state.version;
+    if (version !== 2 && version !== SAVE_VERSION) throw new Error(`unsupported flow state version: ${String(version)}`);
+    const cursor = state.cursor;
+    if (typeof cursor !== "object" || cursor === null) throw new Error("malformed flow state: no cursor");
+    if (this.flowsById.has(id)) throw new Error(`a flow '${id}' is already open; close it before restoring another under that id`);
+    this.assertExternalScopes();
+    const parked = keys.flow(id);
+    this.host.registry.discardParked(parked);
+    this.host.registry.load(flowSections(id, state), { keepParked: true });
+    const flow = new Flow(id, this.host, this.defaultSeed);
+    try {
+      flow.restore(state);
+    } catch (e) {
+      flow.close();
+      this.host.registry.discardParked(parked);
+      throw e;
+    }
+    this.flowsById.set(id, flow);
+    return flow;
+  }
   /** Close (remove) a flow. The flow object is FINISHED, not merely unregistered, so a host still
    *  holding it cannot keep advancing it into the shared world (see {@link Flow.close}). */
   closeFlow(id) {
@@ -1384,7 +1476,8 @@ var Flow = class {
         const node = this.host.nodeIndex.get(o.id);
         if (!node) continue;
         byId.set(o.id, node);
-        options.push({ ...o });
+        const { prompt: saved, ...rest } = o;
+        options.push({ ...rest, ...saved ? { prompt: { ...saved, padAfter: saved.padAfter ?? this.promptPadOf(node) } } : {} });
       }
       if (options.length > 0) this.pendingChoice = { groupId: c.pendingChoice.groupId, options, byId };
     }
@@ -1393,7 +1486,7 @@ var Flow = class {
     if (this.pendingPromptOwnerId) {
       const owner = this.host.nodeIndex.get(this.pendingPromptOwnerId);
       const beat = owner ? this.authoredPromptOf(owner) : void 0;
-      if (beat) this.pendingPrompt = { beat, ...c.pendingPrompt ? { shown: { ...c.pendingPrompt } } : {} };
+      if (beat) this.pendingPrompt = { beat, ...c.pendingPrompt ? { shown: { ...c.pendingPrompt, padAfter: c.pendingPrompt.padAfter ?? this.padOf(beat.id) } } : {} };
       else this.pendingPromptOwnerId = null;
     }
   }
@@ -1763,7 +1856,7 @@ var Flow = class {
       case "gameEvent":
         return { type: "gameEvent", id: beat.id, gameData: beat.gameData, ...withTags };
       case "text":
-        return { type: "text", id: beat.id, text: this.interpolate(this.resolveString(beat.id)), gameData: beat.gameData, ...withTags };
+        return { type: "text", id: beat.id, text: this.interpolate(this.resolveString(beat.id)), padAfter: this.padOf(beat.id), gameData: beat.gameData, ...withTags };
       case "line": {
         const raw = this.resolveString(beat.id);
         const off = !this.host.captionsOn;
@@ -1779,6 +1872,8 @@ var Flow = class {
           direction: silent ? void 0 : beat.direction,
           qualifier: silent ? void 0 : beat.qualifier,
           qualifierName: silent ? void 0 : this.resolveQualifierName(beat.qualifier),
+          padAfter: this.padOf(beat.id),
+          // a silent line still fires, so it still carries its pause
           gameData: beat.gameData,
           ...withTags
         };
@@ -1817,6 +1912,7 @@ var Flow = class {
     const beat = this.promptBeatOf(node);
     if (!beat) return void 0;
     const text = this.interpolate(this.resolveString(beat.id));
+    const padAfter = this.padOf(beat.id);
     return beat.kind === "line" ? {
       kind: "line",
       text: this.captionLine(text),
@@ -1824,8 +1920,9 @@ var Flow = class {
       characterName: this.resolveCharacterName(beat.character),
       direction: beat.direction,
       qualifier: beat.qualifier,
-      qualifierName: this.resolveQualifierName(beat.qualifier)
-    } : { kind: "text", text };
+      qualifierName: this.resolveQualifierName(beat.qualifier),
+      padAfter
+    } : { kind: "text", text, padAfter };
   }
   /** An option's AUTHORED prompt beat: an Option group's own `prompt`. The only prompt a replay speaks. */
   authoredPromptOf(node) {
@@ -1836,7 +1933,7 @@ var Flow = class {
   promptResult(beat, shown) {
     const tags = tagsOf(this.host, beat.id);
     const withTags = tags && tags.length ? { tags } : {};
-    if (shown.kind === "text") return { type: "text", id: beat.id, text: shown.text, gameData: beat.gameData, ...withTags };
+    if (shown.kind === "text") return { type: "text", id: beat.id, text: shown.text, padAfter: this.padOf(beat.id), gameData: beat.gameData, ...withTags };
     return {
       type: "line",
       id: beat.id,
@@ -1846,6 +1943,7 @@ var Flow = class {
       direction: shown.direction,
       qualifier: shown.qualifier,
       qualifierName: shown.qualifierName,
+      padAfter: this.padOf(beat.id),
       gameData: beat.gameData,
       ...withTags
     };
@@ -1882,6 +1980,17 @@ var Flow = class {
     const key = castStringKey(character);
     return this.host.strings[key] ?? this.host.defaultStrings[key] ?? this.host.castDisplay.get(character);
   }
+  /** The resolved pause of the beat an option shows as its prompt (its authored prompt, else its first content
+   *  line), for a saved option that predates prompts carrying one. */
+  promptPadOf(node) {
+    const beat = this.promptBeatOf(node);
+    return beat ? this.padOf(beat.id) : DEFAULT_PAD_AFTER2;
+  }
+  /** A line or text beat's resolved pause (line padding): its own `padAfter`, else the nearest default above
+   *  it, else the project's, else the built-in one; clamped to zero on a snippet's last line. */
+  padOf(beatId) {
+    return this.host.padIndex.get(beatId)?.resolved ?? DEFAULT_PAD_AFTER2;
+  }
   /** A speaker qualifier's shown name, resolved as a character's is: the `qualifier:<gameId>` string in the
    *  active locale, else the default locale, else the authored name. Undefined in IDs-only mode (the game
    *  maps the `qualifier` gameId itself). */
@@ -1989,6 +2098,7 @@ function savedPrompt(p) {
   if (p.direction !== void 0) out.direction = p.direction;
   if (p.qualifier !== void 0) out.qualifier = p.qualifier;
   if (p.qualifierName !== void 0) out.qualifierName = p.qualifierName;
+  if (typeof p.padAfter === "number") out.padAfter = p.padAfter;
   return out;
 }
 function serialiseSelectors(map) {
@@ -2066,9 +2176,23 @@ function sectionsFromV2(save) {
   const out = {};
   if (save.shared?.patter) out["patter"] = save.shared.patter;
   for (const [s, v] of Object.entries(save.stageBags ?? {})) out[keys.stage(s)] = v;
-  for (const [id, f] of Object.entries(save.flows ?? {})) {
-    if (f.scopes?.patter) out[keys.flowGlobals(id)] = f.scopes.patter;
-    for (const [s, v] of Object.entries(f.sceneBags ?? {})) out[keys.flowScene(id, s)] = v;
+  for (const [id, f] of Object.entries(save.flows ?? {})) Object.assign(out, flowSections(id, f));
+  return out;
+}
+function flowSections(id, f) {
+  const out = {};
+  if (f.scopes?.patter) out[keys.flowGlobals(id)] = f.scopes.patter;
+  for (const [s, v] of Object.entries(f.sceneBags ?? {})) out[keys.flowScene(id, s)] = v;
+  return out;
+}
+function flowValuesFrom(id, saved) {
+  const out = { scopes: {}, sceneBags: {} };
+  const prefix = keys.flow(id);
+  for (const [key, values] of Object.entries(saved)) {
+    if (!key.startsWith(prefix)) continue;
+    const rest = key.slice(prefix.length);
+    if (rest === "patter") out.scopes.patter = values;
+    else if (rest.startsWith("scene/")) out.sceneBags[unesc(rest.slice("scene/".length))] = values;
   }
   return out;
 }
@@ -2079,6 +2203,9 @@ function truthy(v) {
   return v.length > 0;
 }
 
+// src/index.ts
+import { DEFAULT_PAD_AFTER as DEFAULT_PAD_AFTER3 } from "@patterkit/model";
+
 // src/describe.ts
 import { effectiveGameId as effectiveGameId2 } from "@patterkit/model";
 var isShared = (d, scopeDefault) => d.shared ?? scopeDefault;
@@ -2201,6 +2328,7 @@ function effectiveGameData(fields, node) {
 }
 export {
   Checkpoint,
+  DEFAULT_PAD_AFTER3 as DEFAULT_PAD_AFTER,
   Engine,
   Flow,
   buildTagIndex,