@patterkit/ops 0.24.1 → 0.25.0

package/dist/index.js

@@ -972,7 +972,7 @@ var arrEq = (a, b) => a.length === b.length && a.every((x, i) => x === b[i]);
 
 // src/validate.ts
 import { validateProject } from "@patterkit/core";
-import { validateConditions, validateInterpolation, hostScopesToSpec, projectScopes, extensionPass } from "@patterkit/compiler";
+import { validateConditions, validateInterpolation, hostScopesToSpec as hostScopesToSpec2, projectScopes as projectScopes2, extensionPass } from "@patterkit/compiler";
 
 // src/compile.ts
 import { basename as basename2, extname, isAbsolute, resolve as resolve3 } from "path";
@@ -1193,14 +1193,14 @@ function reachabilityIssues(loaded, compiled) {
 import { basename as basename3, join as join3, sep } from "path";
 import { canonicalStringify as canonicalStringify3 } from "@patterkit/core";
 import {
-  walkNodes,
+  walkNodes as walkNodes2,
   textIsAction,
   castStringKey,
   qualifierStringKey,
   speakerLabelKey,
   usedQualifiers,
   usedSpeakerPairs,
-  projectQualifiers,
+  projectQualifiers as projectQualifiers2,
   SPEAKER_PATTERN_KEY,
   DEFAULT_SPEAKER_PATTERN,
   PROJECT_LOCALE_SCENE,
@@ -1315,379 +1315,877 @@ function resolveDocumentation(loaded, channel) {
   return out;
 }
 
-// src/localisation.ts
-var SETTING_NAME = `"Localise text lines in dialogue scenes" (Project Settings, Language; \`localiseDialogueText\` in the project file)`;
-function describeLocExport(loaded, opts = {}) {
-  const source = tableFor(loaded, loaded.project.locales.default);
-  let lines = 0, scenes = 0;
-  for (const ids of actionTextIds(loaded).values()) {
-    const n = [...ids].filter((id) => source[id]).length;
-    if (n) {
-      lines += n;
-      scenes++;
-    }
-  }
-  const out = [];
-  if (lines) {
-    out.push(`Left out ${lines} text line${lines === 1 ? "" : "s"} in ${scenes} dialogue scene${scenes === 1 ? "" : "s"}: ${lines === 1 ? "it's" : "they're"} action, a direction for whoever stages the scene, because ${SETTING_NAME} is off. Turn it on to translate ${lines === 1 ? "it" : "them"}.`);
-  }
-  return [...out, ...describeActionTextChanges(loaded, actionTextChanges(loaded, opts))];
+// src/script-doc.ts
+import { DEFAULT_DOCUMENTATION_CLASSES as DEFAULT_DOCUMENTATION_CLASSES2, projectQualifiers } from "@patterkit/model";
+import { humanizeNodeRefs } from "@patterkit/core";
+import { splitRef } from "@patterkit/dialect";
+import { parse as parse2 } from "@wildwinter/expr";
+
+// src/stages.ts
+import { parse, renameStageInExpression, stageGateCount as gatesIn } from "@wildwinter/expr";
+import { dialectWithForeignScopes } from "@patterkit/dialect";
+import { hostScopesToSpec, projectScopes } from "@patterkit/compiler";
+import { walkNodes } from "@patterkit/model";
+function stageDialect(project, gameScopes) {
+  return dialectWithForeignScopes(hostScopesToSpec(projectScopes(project, gameScopes?.merged).host));
 }
-function describeActionTextChanges(loaded, changes) {
-  const nameOf = new Map(loaded.scenes.map((sc) => [sc.id, sc.name]));
-  const out = [];
-  const groups = /* @__PURE__ */ new Map();
-  for (const c of changes) {
-    const key = `${c.locale}|${c.change}`;
-    (groups.get(key) ?? groups.set(key, []).get(key)).push(c);
-  }
-  for (const [key, list] of groups) {
-    const [locale, change] = key.split("|");
-    const n = `${list.length} text line${list.length === 1 ? "" : "s"}`;
-    out.push(change === "dropped" ? `${n} now action, so left out of '${locale}': the next loc import drops ${list.length === 1 ? "its translation" : "their translations"} (turn on ${SETTING_NAME} to keep ${list.length === 1 ? "it" : "them"})` : `${n} no longer action, so new to '${locale}' and untranslated`);
-    for (const c of list) out.push(`  ${c.id} in '${nameOf.get(c.scene) ?? c.scene}'`);
+var refersTo = (target) => (scope, name) => scope === target.scope && name === target.name;
+function effectTarget(ref, dialect) {
+  try {
+    const n = parse(ref, dialect);
+    return n.kind === "scopedvar" ? { scope: n.scope, name: n.name } : void 0;
+  } catch {
+    return void 0;
   }
-  return out;
 }
-function sceneTextIds(scene) {
-  const out = [];
+function sceneSites(scene) {
+  const sites = [];
+  const effects = (list) => {
+    for (const e of list ?? []) {
+      sites.push({ get: () => e.value, set: (src) => {
+        e.value = src;
+      }, assignedTo: e.target });
+    }
+  };
+  effects(scene.onEntry);
   for (const block of scene.blocks) {
     walkNodes(block.children, (node) => {
+      if (typeof node.condition === "string") {
+        sites.push({ get: () => node.condition, set: (src) => {
+          node.condition = src;
+        } });
+      }
       if (node.type === "snippet") {
-        for (const beat of node.beats ?? []) if (beat.kind === "text") out.push(beat.id);
+        effects(node.onEnter);
+        effects(node.onExit);
       }
     });
   }
-  return out;
-}
-function actionTextIds(loaded) {
-  const out = /* @__PURE__ */ new Map();
-  for (const scene of loaded.scenes) if (textIsAction(loaded.project, scene)) out.set(scene.id, new Set(sceneTextIds(scene)));
-  return out;
+  return sites;
 }
-function actionTextChanges(loaded, opts = {}) {
-  const defaultLocale = loaded.project.locales.default;
-  const locales = opts.locale !== void 0 ? opts.locale === defaultLocale ? [] : [opts.locale] : loaded.project.locales.all.filter((l) => l !== defaultLocale);
-  const source = tableFor(loaded, defaultLocale);
-  const out = [];
-  for (const locale of locales) {
-    for (const scene of loaded.scenes) {
-      const path = existingLocPath(loaded, scene.id, locale);
-      const shard = path ? findFile(loaded.localeFiles, loaded.locales, path) : void 0;
-      if (!shard) continue;
-      const action = textIsAction(loaded.project, scene);
-      for (const id of sceneTextIds(scene)) {
-        if (action && shard.strings[id]) out.push({ id, scene: scene.id, locale, change: "dropped" });
-        else if (!action && shard.textAction && source[id]) out.push({ id, scene: scene.id, locale, change: "added" });
-      }
+var reach = (scenes, target) => target.scope === "scene" ? scenes.filter((s) => s.id === target.scene) : scenes;
+function renameStage(scenes, target, from, to, dialect) {
+  const result = { scenes: [], expressions: 0 };
+  if (to.trim() === "" || from === to) return result;
+  const isTarget = refersTo(target);
+  for (const scene of reach(scenes, target)) {
+    let changed = false;
+    for (const site of sceneSites(scene)) {
+      const src = site.get();
+      if (src === void 0) continue;
+      const t = site.assignedTo !== void 0 ? effectTarget(site.assignedTo, dialect) : void 0;
+      const next = renameStageInExpression(src, dialect, isTarget, from, to, t !== void 0 && isTarget(t.scope, t.name));
+      if (next === void 0) continue;
+      site.set(next);
+      result.expressions++;
+      changed = true;
     }
+    if (changed) result.scenes.push(scene);
   }
-  return out;
+  return result;
 }
-function projectStringSources(project, sourceTable) {
-  const out = {};
-  const put = (id, authored) => {
-    if (authored) out[id] = sourceTable[id] ?? authored;
-  };
-  for (const c of project.cast ?? []) {
-    put(castStringKey(c.name), c.displayName);
-    for (const [q, label] of Object.entries(c.qualifierLabels ?? {})) put(speakerLabelKey(c.name, q), label);
+function stageGateCount(scenes, target, dialect) {
+  const isTarget = refersTo(target);
+  let count = 0;
+  for (const scene of reach(scenes, target)) {
+    for (const site of sceneSites(scene)) {
+      const src = site.get();
+      if (src !== void 0) count += gatesIn(src, dialect, isTarget);
+    }
   }
-  for (const q of projectQualifiers(project)) put(qualifierStringKey(q.gameId), q.name);
-  put(SPEAKER_PATTERN_KEY, project.speakerPattern ?? DEFAULT_SPEAKER_PATTERN);
-  return out;
+  return count;
 }
-function extractLoc(loaded, opts = {}) {
-  const defaultLocale = loaded.project.locales.default;
-  const isTemplate = opts.locale === void 0 || opts.locale === defaultLocale;
-  const targetLocale = isTemplate ? void 0 : opts.locale;
-  const source = tableFor(loaded, defaultLocale);
-  const target = targetLocale ? tableFor(loaded, targetLocale) : {};
-  const edits = mergeAuthoring2(loaded).edits;
-  const projectSources = projectStringSources(loaded.project, source);
-  const docs = resolveDocumentation(loaded, "loc");
-  const commentsOf = (id) => (docs.get(id) ?? []).map((d) => d.text);
-  const staleFor = (id, translation) => {
-    if (isTemplate || !translation) return false;
-    const e = edits.get(id);
-    const localised = e?.localisedAt?.[targetLocale];
-    return !!(e?.modifiedAt && localised && e.modifiedAt > localised);
-  };
-  const genderOf = /* @__PURE__ */ new Map();
-  for (const c of loaded.project.cast ?? []) if (c.gender) genderOf.set(c.name, c.gender);
-  const withGender = (context) => {
-    const g = context?.character ? genderOf.get(context.character) : void 0;
-    return g ? { ...context, gender: g } : context;
-  };
-  const qualifierName = new Map(projectQualifiers(loaded.project).map((q) => [q.gameId, q.name]));
-  const lineContext = (b) => {
-    const q = b.kind === "line" && b.qualifier ? qualifierName.get(b.qualifier) ?? b.qualifier : void 0;
-    return { character: b.kind === "line" ? b.character : void 0, kind: b.kind, ...q ? { qualifier: q } : {} };
-  };
-  const entries = [];
-  const push = (id, scene, context) => {
-    const src = source[id];
-    if (src === void 0) return;
-    const translation = isTemplate ? "" : target[id] ?? "";
-    entries.push({ id, scene, source: src, translation, comments: commentsOf(id), context: withGender(context), stale: staleFor(id, translation) });
-  };
-  for (const scene of loaded.scenes) {
-    const action = textIsAction(loaded.project, scene);
+function renameGameDataStage(scenes, kind, field, from, to) {
+  const result = { scenes: [], values: 0 };
+  if (to.trim() === "" || from === to) return result;
+  for (const scene of scenes) {
+    let changed = false;
+    const visit = (holder) => {
+      if (holder.gameData?.[field] !== from) return;
+      holder.gameData[field] = to;
+      result.values++;
+      changed = true;
+    };
+    if (kind === "scene") visit(scene);
     for (const block of scene.blocks) {
+      if (kind === "block") visit(block);
       walkNodes(block.children, (node) => {
-        if (node.type === "group") {
-          const p = node.prompt;
-          if (p) push(p.id, scene.id, lineContext(p));
+        if (node.type !== "snippet") {
+          if (kind === "option" && node.selector === "choice") {
+            for (const option of node.children) if (option.type === "group") visit(option);
+          }
           return;
         }
-        for (const beat of node.beats ?? []) {
-          if (beat.kind === "gameEvent" || action && beat.kind === "text") continue;
-          push(beat.id, scene.id, lineContext(beat));
-        }
+        if (kind === "snippet") visit(node);
+        for (const beat of node.beats ?? []) if (beat.kind === kind) visit(beat);
       });
     }
+    if (changed) result.scenes.push(scene);
   }
-  for (const c of loaded.project.cast ?? []) {
-    if (!c.displayName) continue;
-    const id = castStringKey(c.name);
-    const src = projectSources[id];
-    const translation = isTemplate ? "" : target[id] ?? "";
-    entries.push({ id, scene: PROJECT_LOCALE_SCENE, source: src, translation, comments: commentsOf(id), context: withGender({ character: c.name }), stale: staleFor(id, translation) });
-  }
-  for (const q of usedQualifiers(loaded.project, loaded.scenes)) {
-    const id = qualifierStringKey(q.gameId);
-    const src = projectSources[id] ?? q.name;
-    const translation = isTemplate ? "" : target[id] ?? "";
-    entries.push({ id, scene: PROJECT_LOCALE_SCENE, source: src, translation, comments: commentsOf(id), context: { kind: "qualifier" }, stale: staleFor(id, translation) });
-  }
-  const pairs = usedSpeakerPairs(loaded.scenes);
-  if (pairs.length > 0) {
-    const id = SPEAKER_PATTERN_KEY;
-    const src = projectSources[id];
-    const translation = isTemplate ? "" : target[id] ?? "";
-    entries.push({ id, scene: PROJECT_LOCALE_SCENE, source: src, translation, comments: [SPEAKER_PATTERN_NOTE, ...commentsOf(id)], context: { kind: "speaker pattern" }, stale: staleFor(id, translation) });
-    const labelsOf = new Map((loaded.project.cast ?? []).map((c) => [c.name, c.qualifierLabels]));
-    for (const p of pairs) {
-      const label = labelsOf.get(p.character)?.[p.qualifier];
-      if (!label) continue;
-      const pid = speakerLabelKey(p.character, p.qualifier);
-      const psrc = projectSources[pid] ?? label;
-      const ptranslation = isTemplate ? "" : target[pid] ?? "";
-      const qualifier = qualifierName.get(p.qualifier) ?? p.qualifier;
-      entries.push({ id: pid, scene: PROJECT_LOCALE_SCENE, source: psrc, translation: ptranslation, comments: commentsOf(pid), context: withGender({ character: p.character, kind: "speaker", qualifier }), stale: staleFor(pid, ptranslation) });
-    }
-  }
-  return { project: loaded.project.project.id, defaultLocale, locale: targetLocale, entries };
-}
-var SPEAKER_PATTERN_NOTE = "{name} and {qualifier} are filled in with the speaker's name and the qualifier, so keep both as they are. You can put them in any order.";
-var layoutOf = (loaded) => projectLayout2(loaded.project);
-function existingLocPath(loaded, scene, locale) {
-  for (let i = 0; i < loaded.locales.length; i++) {
-    const l = loaded.locales[i];
-    if (l.scene === scene && l.locale === locale) return loaded.localeFiles[i] ?? null;
-  }
-  return null;
-}
-function targetLocPath(loaded, scene, locale, defaultLocale) {
-  const existing = existingLocPath(loaded, scene, locale);
-  if (existing) return existing;
-  const fromDefault = existingLocPath(loaded, scene, defaultLocale);
-  if (fromDefault) {
-    const parts = fromDefault.split(sep);
-    for (let i = parts.length - 2; i >= 0; i--) {
-      if (parts[i] === defaultLocale) {
-        parts[i] = locale;
-        return parts.join(sep);
-      }
-    }
-  }
-  const stem = scene === PROJECT_LOCALE_SCENE ? "_project" : scene;
-  return join3(loaded.root, layoutOf(loaded).strings, locale, `${stem}.patterloc`);
-}
-function authoringPath(loaded, scene) {
-  const dir = join3(loaded.root, layoutOf(loaded).authoring);
-  if (scene === PROJECT_LOCALE_SCENE) return join3(dir, "_project.patterx");
-  const flow = loaded.sceneFiles[scene];
-  const stem = flow ? basename3(flow).replace(/\.patterflow$/, "") : scene;
-  return join3(dir, `${stem}.patterx`);
+  return result;
 }
-var findFile = (files, items, path) => {
-  const i = files.indexOf(path);
-  return i >= 0 ? items[i] : void 0;
-};
-function applyLoc(loaded, catalog, opts = {}) {
-  const locale = catalog.locale;
-  if (!locale || locale === loaded.project.locales.default) {
-    return { writes: [], stats: { updated: 0, files: 0, dropped: 0 } };
-  }
-  if (!loaded.project.locales.all.includes(locale)) {
-    throw new Error(`'${locale}' is not one of the project's languages (${loaded.project.locales.all.join(", ")}); add it to the project first`);
-  }
-  const known = /* @__PURE__ */ new Set([...loaded.scenes.map((sc) => sc.id), PROJECT_LOCALE_SCENE]);
-  const unknown = [...new Set(catalog.entries.filter((e) => e.translation.trim() && !known.has(e.scene)).map((e) => e.scene))];
-  if (unknown.length) {
-    throw new Error(`the file names scene(s) this project does not have: ${unknown.map((u) => `'${u}'`).join(", ")}; nothing was imported`);
-  }
-  const now = opts.now ?? (/* @__PURE__ */ new Date()).toISOString();
-  const action = actionTextIds(loaded);
-  const bySceneText = /* @__PURE__ */ new Map();
-  const bySceneFresh = /* @__PURE__ */ new Map();
-  for (const e of catalog.entries) {
-    if (!e.translation.trim()) continue;
-    if (action.get(e.scene)?.has(e.id)) continue;
-    (bySceneText.get(e.scene) ?? bySceneText.set(e.scene, /* @__PURE__ */ new Map()).get(e.scene)).set(e.id, e.translation);
-    if (!e.stale) (bySceneFresh.get(e.scene) ?? bySceneFresh.set(e.scene, /* @__PURE__ */ new Set()).get(e.scene)).add(e.id);
-  }
-  const writes = [];
-  let updated = 0;
-  let dropped = 0;
-  let files = 0;
-  const scenes = new Set(bySceneText.keys());
-  for (const l of loaded.locales) if (l.locale === locale && l.scene !== PROJECT_LOCALE_SCENE && known.has(l.scene)) scenes.add(l.scene);
-  for (const scene of scenes) {
-    const strings = bySceneText.get(scene) ?? /* @__PURE__ */ new Map();
-    const path = targetLocPath(loaded, scene, locale, loaded.project.locales.default);
-    const existing = findFile(loaded.localeFiles, loaded.locales, path);
-    const merged = { ...existing?.strings ?? {} };
-    for (const [id, text] of strings) {
-      if (merged[id] !== text) updated++;
-      merged[id] = text;
-    }
-    const actionIds = action.get(scene);
-    for (const id of actionIds ?? []) if (id in merged) {
-      delete merged[id];
-      dropped++;
-    }
-    const file = {
-      schema: existing?.schema ?? STRINGS_SCHEMA,
-      scene,
-      locale,
-      ...actionIds ? { textAction: true } : {},
-      strings: merged
-    };
-    const content = canonicalStringify3(file);
-    if (!existing || strings.size > 0 || canonicalStringify3(existing) !== content) {
-      writes.push({ path, content });
-      files++;
-    }
-    const fresh = bySceneFresh.get(scene);
-    if (!fresh?.size) continue;
-    const aPath = authoringPath(loaded, scene);
-    const aExisting = findFile(loaded.authoringFiles, loaded.authoring, aPath);
-    const authoring = aExisting ? { ...aExisting, edits: { ...aExisting.edits } } : { schema: AUTHORING_SCHEMA };
-    const editsMap = { ...authoring.edits ?? {} };
-    for (const id of fresh) editsMap[id] = { ...editsMap[id], localisedAt: { ...editsMap[id]?.localisedAt, [locale]: now } };
-    authoring.edits = editsMap;
-    writes.push({ path: aPath, content: canonicalStringify3(authoring) });
+
+// src/script-doc.ts
+var TOKENS = {
+  ink: "26221c",
+  // near-black warm ink (headings)
+  inkRead: "3a352d",
+  // dialogue body (ink ~84% + muted)
+  inkSoft: "5c554b",
+  // text (ink ~68% + muted) - a step softer than dialogue
+  muted: "8c8479",
+  // labels, quiet tags
+  accent: "8a5a34",
+  // structural marks: conditions, options, jumps, game events
+  line: "e4dfd5"
+  // hairlines / rules / the group rail
+};
+var CHAR_PALETTE = [
+  "b23b3b",
+  "b5642b",
+  "927524",
+  "6b7a31",
+  "3f7d49",
+  "2c7d6e",
+  "2d7791",
+  "3a6aa8",
+  "5a5ba6",
+  "7e4e9c",
+  "9c4486",
+  "a83e5c"
+];
+function colourIndex(name) {
+  let h = 2166136261;
+  for (let i = 0; i < name.length; i++) {
+    h ^= name.charCodeAt(i);
+    h = Math.imul(h, 16777619);
   }
-  return { writes, stats: { updated, files, dropped } };
+  h ^= h >>> 16;
+  h = Math.imul(h, 2246822507);
+  h ^= h >>> 13;
+  h = Math.imul(h, 3266489909);
+  h ^= h >>> 16;
+  return (h >>> 0) % 12;
 }
-
-// src/pack.ts
-import JSZip from "jszip";
-import { readFileSync as readFileSync4, readdirSync as readdirSync3 } from "fs";
-import { dirname as dirname5, join as join5, relative as relative2, sep as sep2 } from "path";
-import { parseSource as parseSource3 } from "@patterkit/core";
-import { EXTENSION_SHARD as EXTENSION_SHARD2, EXTENSIONS_DIR as EXTENSIONS_DIR2, MANIFEST_EXTENSION as MANIFEST_EXTENSION2 } from "@patterkit/model";
-import { ARCHIVE_ENTRY_OPTS } from "@wildwinter/toolkit/archive";
-
-// src/handoff.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
-import { basename as basename4, join as join4 } from "path";
-import { HANDOFF_SCHEMA } from "@patterkit/model";
-var HANDOFF_DIR = "handoffs";
-var HANDOFF_EXT = ".json";
-function handoffPath(root, id) {
-  return join4(root, HANDOFF_DIR, `${id}${HANDOFF_EXT}`);
+function isColourSlot(v) {
+  return typeof v === "number" && Number.isInteger(v) && v >= 0 && v < CHAR_PALETTE.length;
 }
-function serialiseHandoff(handoff) {
-  return JSON.stringify(handoff, null, 2) + "\n";
+function characterColour(name, stored) {
+  return CHAR_PALETTE[isColourSlot(stored) ? stored : colourIndex(name)];
 }
-function handoffWrite(root, handoff) {
-  return { path: handoffPath(root, handoff.id), content: serialiseHandoff(handoff) };
+function castColours(cast) {
+  return new Map((cast ?? []).filter((c) => isColourSlot(c.colour)).map((c) => [c.name, c.colour]));
 }
-function parseHandoff(text) {
-  const h = JSON.parse(text);
-  if (h.schema !== HANDOFF_SCHEMA) throw new Error(`not a handoff record (schema ${JSON.stringify(h.schema)})`);
-  if (typeof h.id !== "string" || !h.lines || !Array.isArray(h.skeleton)) throw new Error("handoff record is missing its id, lines, or skeleton");
-  return h;
+function cueLabel(character, qualifierName) {
+  return qualifierName ? `${character.toUpperCase()} (${qualifierName.toUpperCase()})` : character.toUpperCase();
 }
-function readHandoffs(root) {
-  const handoffs = [];
-  const issues = [];
-  for (const file of walkFiles(join4(root, HANDOFF_DIR), HANDOFF_EXT)) {
-    try {
-      handoffs.push(parseHandoff(readFileSync3(file, "utf8")));
-    } catch (e) {
-      issues.push({ file, message: `${basename4(file)}: ${e instanceof Error ? e.message : String(e)}` });
+function qualifierNamer(project) {
+  const names = new Map(projectQualifiers(project).map((q) => [q.gameId, q.name]));
+  return (gameId) => gameId ? names.get(gameId) ?? gameId : void 0;
+}
+var MARKUP_RE = /<(b|i|bi)>([\s\S]*?)<\/\1>/g;
+var INTERP_RE = /\{@[^}]*\}/g;
+function textRuns(text) {
+  const marked = [];
+  let last = 0;
+  let m;
+  MARKUP_RE.lastIndex = 0;
+  while ((m = MARKUP_RE.exec(text)) !== null) {
+    if (m.index > last) marked.push({ text: text.slice(last, m.index), bold: false, italic: false });
+    const tag = m[1];
+    marked.push({ text: m[2], bold: tag === "b" || tag === "bi", italic: tag === "i" || tag === "bi" });
+    last = MARKUP_RE.lastIndex;
+  }
+  if (last < text.length) marked.push({ text: text.slice(last), bold: false, italic: false });
+  if (!marked.length) marked.push({ text, bold: false, italic: false });
+  const out = [];
+  for (const r of marked) {
+    let li = 0;
+    let im;
+    INTERP_RE.lastIndex = 0;
+    while ((im = INTERP_RE.exec(r.text)) !== null) {
+      if (im.index > li) out.push({ text: r.text.slice(li, im.index), bold: r.bold, italic: r.italic, code: false });
+      out.push({ text: im[0], bold: r.bold, italic: r.italic, code: true });
+      li = INTERP_RE.lastIndex;
     }
+    if (li < r.text.length) out.push({ text: r.text.slice(li), bold: r.bold, italic: r.italic, code: false });
   }
-  handoffs.sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
-  return { handoffs, issues };
-}
-function readHandoff(root, id) {
-  const path = handoffPath(root, id);
-  if (!existsSync3(path)) return void 0;
-  return parseHandoff(readFileSync3(path, "utf8"));
-}
-var ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-function checkChar(body) {
-  let sum = 0;
-  for (let i = 0; i < body.length; i++) sum += (i + 1) * ALPHABET.indexOf(body[i]);
-  return ALPHABET[sum % 31];
-}
-function randomBody(length, random) {
-  let s = "";
-  for (let i = 0; i < length; i++) s += ALPHABET[Math.floor(random() * ALPHABET.length)];
-  return s;
+  return out.length ? out : [{ text, bold: false, italic: false, code: false }];
 }
-function markerLength(count) {
-  let length = 3;
-  while (ALPHABET.length ** length < Math.max(1, count) * 1e3) length++;
-  return length;
+function targetLabel(to, sceneOf, blockTrail) {
+  if (to === "END") return "END";
+  return blockTrail.get(to) ?? sceneOf.get(to) ?? to;
 }
-function issueMarkerCodes(count, random = Math.random) {
-  const length = markerLength(count);
-  const codes = /* @__PURE__ */ new Set();
-  while (codes.size < count) {
-    const body = randomBody(length, random);
-    codes.add(body + checkChar(body));
+function gameEventLabel(beat) {
+  const gd = beat.gameData;
+  if (gd && typeof gd === "object") {
+    const parts = Object.entries(gd).map(([k, v]) => {
+      const val = v == null ? "" : typeof v === "object" ? JSON.stringify(v) : String(v);
+      return val === "" ? k : `${k}: ${val}`;
+    });
+    if (parts.length) return `game event: ${parts.join(", ")}`;
   }
-  return [...codes];
+  return "game event";
 }
-function formatMarker(code) {
-  return `[#${code}]`;
+function optionTag(node) {
+  const parts = [];
+  if (node.fallback) parts.push("fallback");
+  parts.push(node.sticky ? "repeatable" : "once only");
+  if (node.secretUntilEligible) parts.push("hidden");
+  return parts.join(", ");
 }
-function newHandoffId(taken = [], random = Math.random) {
-  const used = new Set(taken);
-  for (; ; ) {
-    const id = `H-${randomBody(4, random)}`;
-    if (!used.has(id)) return id;
-  }
+function sequenceLabel(node) {
+  const o = node.options ?? {};
+  const bits = [];
+  if ((o.order ?? "sequential") === "shuffle") bits.push("shuffled");
+  const ex = o.exhaust ?? "once";
+  if (ex === "repeat") bits.push("repeating");
+  else if (ex === "stick") bits.push("holds on the last");
+  return bits.length ? `In sequence (${bits.join(", ")})` : "In sequence";
+}
+var EFFECT_PHASE_LABEL = { begin: "On begin", end: "On end" };
+var REF_RE = /@[A-Za-z_][A-Za-z0-9_]*(?:\.[A-Za-z_][A-Za-z0-9_]*)?/g;
+var andList = (xs) => xs.length <= 2 ? xs.join(" and ") : `${xs.slice(0, -1).join(", ")}, and ${xs[xs.length - 1]}`;
+function effectDescriber(dialect, nodeLabel = (id) => id) {
+  const scopes = new Set(dialect.scopes.map((s) => s.token));
+  const isScope = (t) => scopes.has(t);
+  const refText = (ref) => {
+    const body = ref.slice(1);
+    const dot = body.indexOf(".");
+    if (dot < 0) return body;
+    return body.slice(0, dot) === "patter" ? body.slice(dot + 1) : ref;
+  };
+  const prose = (src) => {
+    let out = "", i = 0;
+    while (i < src.length) {
+      const q = src[i];
+      if (q === '"' || q === "'") {
+        let j2 = i + 1;
+        while (j2 < src.length && src[j2] !== q) j2 += src[j2] === "\\" ? 2 : 1;
+        out += src.slice(i, j2 + 1);
+        i = j2 + 1;
+        continue;
+      }
+      let j = i;
+      while (j < src.length && src[j] !== '"' && src[j] !== "'") j++;
+      out += src.slice(i, j).replace(REF_RE, refText);
+      i = j;
+    }
+    return humanizeNodeRefs(out.trim(), nodeLabel);
+  };
+  const sameRef = (n, target) => n?.kind === "scopedvar" && n.scope === target.scope && n.name.toLowerCase() === target.name;
+  return (effect) => {
+    const shown2 = refText(effect.target);
+    let ast;
+    try {
+      ast = parse2(effect.value, dialect);
+    } catch {
+      ast = void 0;
+    }
+    const target = splitRef(effect.target, isScope);
+    if (ast?.kind === "call" && ast.name === "advance" && ast.args.length === 1 && sameRef(ast.args[0], target)) return `Advances ${shown2}`;
+    if (ast?.kind === "call" && ast.name === "set_flags" && sameRef(ast.args[0], target) && ast.args.length > 1 && ast.args.slice(1).every((a) => a.kind === "flagdelta")) {
+      const deltas = ast.args.slice(1);
+      const adds = deltas.filter((d) => d.sign === "+").map((d) => d.name), removes = deltas.filter((d) => d.sign === "-").map((d) => d.name);
+      if (adds.length && removes.length) return `Adds ${andList(adds)} to ${shown2} and removes ${andList(removes)}`;
+      return adds.length ? `Adds ${andList(adds)} to ${shown2}` : `Removes ${andList(removes)} from ${shown2}`;
+    }
+    if (ast?.kind === "string") return `Sets ${shown2} to ${ast.value}`;
+    return `Sets ${shown2} to ${prose(effect.value)}`;
+  };
 }
-function readMarker(text) {
-  const m = /\[\s*#?\s*([0-9A-Za-z]{2,9})\s*\]/.exec(text);
-  if (!m) return void 0;
-  const code = m[1].toUpperCase().replace(/O/g, "0").replace(/[IL]/g, "1");
-  if ([...code].some((c) => !ALPHABET.includes(c))) return { code, valid: false };
-  const body = code.slice(0, -1);
-  return { code, valid: body.length >= 2 && checkChar(body) === code.slice(-1) };
+function effectLine(phase, effects, describe) {
+  const clauses = effects.map((e) => {
+    const t = describe(e);
+    return t.charAt(0).toLowerCase() + t.slice(1);
+  });
+  return `${EFFECT_PHASE_LABEL[phase]}: ${clauses.join("; ")}`;
 }
-
-// src/pack.ts
-var SHARD_EXTENSIONS = [".patterflow", ".patterloc", ".patterx", ".patterproj", EXTENSION_SHARD2];
-var ENTRY_OPTS = ARCHIVE_ENTRY_OPTS;
-async function runPack(startPath) {
-  const projectFile = findProjectFile(startPath);
-  const root = dirname5(projectFile);
-  const project = parseSource3(readFileSync4(projectFile, "utf8"));
-  const unresolved = sidecarIssues(walkFiles(root, CONFLICT_SIDECAR));
-  if (unresolved.length) {
-    throw new Error(
-      `${unresolved.length} unresolved merge conflict(s) - resolve them before packing, or the recipient gets your side of a disagreement with no sign of it:
-` + unresolved.map((i) => `  ${i.file}`).join("\n")
-    );
-  }
+function runScriptDoc(loaded, opts = {}) {
+  const { project } = loaded;
+  const source = sourceStrings(loaded);
+  const { cut, documentation } = mergeAuthoring2(loaded);
+  const noteClasses = opts.notes === void 0 || opts.notes === "all" ? void 0 : classesForChannel(project.documentationClasses ?? DEFAULT_DOCUMENTATION_CLASSES2, opts.notes.channel);
+  const ownNotes = (id) => opts.notes === void 0 ? [] : (documentation.get(id) ?? []).filter((l) => l.type !== void 0 && (noteClasses === void 0 || noteClasses.has(l.type)));
+  const sceneOf = /* @__PURE__ */ new Map();
+  const blockTrail = /* @__PURE__ */ new Map();
+  const blockName = /* @__PURE__ */ new Map();
+  for (const scene of loaded.scenes) {
+    sceneOf.set(scene.id, scene.name);
+    for (const block of scene.blocks) {
+      blockTrail.set(block.id, `${scene.name} \u203A ${block.name}`);
+      blockName.set(block.id, block.name);
+    }
+  }
+  const humanize = (cond) => humanizeNodeRefs(cond, (id) => blockName.get(id) ?? sceneOf.get(id) ?? id);
+  const describeEffect = effectDescriber(stageDialect(project, loaded.gameScopes), (id) => blockName.get(id) ?? sceneOf.get(id) ?? id);
+  const els = [];
+  const nameOf = qualifierNamer(project);
+  const colours = castColours(project.cast);
+  const speaker = (beat) => ({
+    character: beat.character ?? "",
+    ...colours.has(beat.character ?? "") ? { colour: colours.get(beat.character ?? "") } : {},
+    ...beat.qualifier ? { qualifier: beat.qualifier, qualifierName: nameOf(beat.qualifier) } : {},
+    direction: beat.direction
+  });
+  const textOf = (id) => source[id] ?? "";
+  const notes = (id, indent, sid) => {
+    for (const l of ownNotes(id)) els.push({ kind: "note", id, indent, snippet: sid, text: l.text, class: l.type });
+  };
+  const jumpText = (j) => {
+    const dest = targetLabel(j.to, sceneOf, blockTrail);
+    return j.mode === "call" ? `${dest} (and return)` : dest;
+  };
+  let snippetSeq = 0;
+  const nextSid = () => ++snippetSeq;
+  const effects = (id, phase, list, indent, sid) => {
+    if (list?.length) els.push({ kind: "effect", id, phase, indent, snippet: sid, text: effectLine(phase, list, describeEffect) });
+  };
+  const emitBeats = (node, indent, sid) => {
+    effects(node.id, "begin", node.onEnter, indent, sid);
+    for (const beat of node.beats ?? []) {
+      if (cut.has(beat.id)) continue;
+      if (beat.kind === "line") els.push({ kind: "line", id: beat.id, indent, snippet: sid, ...speaker(beat), runs: textRuns(textOf(beat.id)) });
+      else if (beat.kind === "text") els.push({ kind: "narration", id: beat.id, indent, snippet: sid, runs: textRuns(textOf(beat.id)) });
+      else if (beat.kind === "gameEvent") els.push({ kind: "gameEvent", id: beat.id, indent, snippet: sid, text: gameEventLabel(beat) });
+      else continue;
+      notes(beat.id, indent, sid);
+    }
+    effects(node.id, "end", node.onExit, indent, sid);
+    if (node.jump) els.push({ kind: "jump", id: node.id, to: node.jump.to, indent, snippet: sid, text: jumpText(node.jump) });
+  };
+  const walk = (node, indent, sid) => {
+    if (cut.has(node.id)) return;
+    if (node.type === "snippet") {
+      if (node.condition) els.push({ kind: "condition", id: node.id, indent, snippet: sid, text: `if ${humanize(node.condition)}` });
+      notes(node.id, indent, sid);
+      emitBeats(node, indent, sid);
+      return;
+    }
+    if (node.condition) els.push({ kind: "condition", id: node.id, indent, snippet: sid, text: `if ${humanize(node.condition)}` });
+    if (node.selector === "choice" || node.selector === "branch" || node.selector === "sequence") {
+    } else notes(node.id, indent, sid);
+    if (node.selector === "choice") {
+      els.push({ kind: "group", id: node.id, indent, label: "Choose" });
+      notes(node.id, indent, sid);
+      for (const child2 of node.children ?? []) {
+        if (cut.has(child2.id)) continue;
+        const cid = nextSid();
+        if (child2.type === "group" && child2.prompt) {
+          if (child2.condition) els.push({ kind: "condition", id: child2.id, indent, snippet: cid, text: `if ${humanize(child2.condition)}` });
+          els.push({ kind: "option", id: child2.prompt.id, node: child2.id, indent, snippet: cid, runs: textRuns(textOf(child2.prompt.id) || "(option)"), tag: optionTag(child2) });
+          notes(child2.id, indent, cid);
+          notes(child2.prompt.id, indent, cid);
+          for (const c of child2.children ?? []) walk(c, indent + 1, cid);
+        } else if (child2.type === "snippet") {
+          const beats = child2.beats ?? [];
+          const first = beats.find((b) => b.kind === "line" || b.kind === "text");
+          if (child2.condition) els.push({ kind: "condition", id: child2.id, indent, snippet: cid, text: `if ${humanize(child2.condition)}` });
+          els.push({ kind: "option", id: first?.id ?? child2.id, node: child2.id, indent, snippet: cid, runs: textRuns(first ? textOf(first.id) || "(option)" : "(option)"), tag: optionTag(child2) });
+          notes(child2.id, indent, cid);
+          if (first) notes(first.id, indent, cid);
+          effects(child2.id, "begin", child2.onEnter, indent + 1, cid);
+          let seenPrompt = false;
+          for (const beat of beats) {
+            if (!seenPrompt && beat === first) {
+              seenPrompt = true;
+              continue;
+            }
+            if (cut.has(beat.id)) continue;
+            if (beat.kind === "line") els.push({ kind: "line", id: beat.id, indent: indent + 1, snippet: cid, ...speaker(beat), runs: textRuns(textOf(beat.id)) });
+            else if (beat.kind === "text") els.push({ kind: "narration", id: beat.id, indent: indent + 1, snippet: cid, runs: textRuns(textOf(beat.id)) });
+            else if (beat.kind === "gameEvent") els.push({ kind: "gameEvent", id: beat.id, indent: indent + 1, snippet: cid, text: gameEventLabel(beat) });
+            else continue;
+            notes(beat.id, indent + 1, cid);
+          }
+          effects(child2.id, "end", child2.onExit, indent + 1, cid);
+          if (child2.jump) els.push({ kind: "jump", id: child2.id, to: child2.jump.to, indent: indent + 1, snippet: cid, text: jumpText(child2.jump) });
+        } else {
+          walk(child2, indent + 1, cid);
+        }
+      }
+      return;
+    }
+    if (node.selector === "branch") {
+      els.push({ kind: "group", id: node.id, indent, label: "One of (first match wins)" });
+      notes(node.id, indent, sid);
+      const kids2 = (node.children ?? []).filter((c) => !cut.has(c.id));
+      kids2.forEach((child2, i) => {
+        const isCatchAll = i === kids2.length - 1 && kids2.length > 1 && !("condition" in child2 && child2.condition);
+        if (isCatchAll) els.push({ kind: "else", id: child2.id, indent });
+        walk(child2, indent, nextSid());
+      });
+      return;
+    }
+    if (node.selector === "sequence") {
+      els.push({ kind: "group", id: node.id, indent, label: sequenceLabel(node) });
+      notes(node.id, indent, sid);
+      for (const child2 of node.children ?? []) walk(child2, indent, nextSid());
+      return;
+    }
+    for (const child2 of node.children ?? []) walk(child2, indent, sid);
+  };
+  const only = opts.scenes ? new Set(opts.scenes) : void 0;
+  for (const scene of loaded.scenes) {
+    if (cut.has(scene.id) || only && !only.has(scene.id)) continue;
+    els.push({ kind: "scene", id: scene.id, text: scene.name });
+    notes(scene.id, 0, void 0);
+    effects(scene.id, "begin", scene.onEntry, 0, void 0);
+    for (const block of scene.blocks) {
+      if (cut.has(block.id)) continue;
+      els.push({ kind: "block", id: block.id, text: block.name });
+      notes(block.id, 0, void 0);
+      for (const child2 of block.children ?? []) walk(child2, 0, void 0);
+    }
+  }
+  return { project: project.project.name, elements: els };
+}
+
+// src/localisation.ts
+var SETTING_NAME = `"Localise text lines in dialogue scenes" (Project Settings, Language; \`localiseDialogueText\` in the project file)`;
+function describeLocExport(loaded, opts = {}) {
+  const source = tableFor(loaded, loaded.project.locales.default);
+  let lines = 0, scenes = 0;
+  for (const ids of actionTextIds(loaded).values()) {
+    const n = [...ids].filter((id) => source[id]).length;
+    if (n) {
+      lines += n;
+      scenes++;
+    }
+  }
+  const out = [];
+  if (lines) {
+    out.push(`Left out ${lines} text line${lines === 1 ? "" : "s"} in ${scenes} dialogue scene${scenes === 1 ? "" : "s"}: ${lines === 1 ? "it's" : "they're"} action, a direction for whoever stages the scene, because ${SETTING_NAME} is off. Turn it on to translate ${lines === 1 ? "it" : "them"}.`);
+  }
+  return [...out, ...describeActionTextChanges(loaded, actionTextChanges(loaded, opts))];
+}
+function describeActionTextChanges(loaded, changes) {
+  const nameOf = new Map(loaded.scenes.map((sc) => [sc.id, sc.name]));
+  const out = [];
+  const groups = /* @__PURE__ */ new Map();
+  for (const c of changes) {
+    const key = `${c.locale}|${c.change}`;
+    (groups.get(key) ?? groups.set(key, []).get(key)).push(c);
+  }
+  for (const [key, list] of groups) {
+    const [locale, change] = key.split("|");
+    const n = `${list.length} text line${list.length === 1 ? "" : "s"}`;
+    out.push(change === "dropped" ? `${n} now action, so left out of '${locale}': the next loc import drops ${list.length === 1 ? "its translation" : "their translations"} (turn on ${SETTING_NAME} to keep ${list.length === 1 ? "it" : "them"})` : `${n} no longer action, so new to '${locale}' and untranslated`);
+    for (const c of list) out.push(`  ${c.id} in '${nameOf.get(c.scene) ?? c.scene}'`);
+  }
+  return out;
+}
+function sceneTextIds(scene) {
+  const out = [];
+  for (const block of scene.blocks) {
+    walkNodes2(block.children, (node) => {
+      if (node.type === "snippet") {
+        for (const beat of node.beats ?? []) if (beat.kind === "text") out.push(beat.id);
+      }
+    });
+  }
+  return out;
+}
+function actionTextIds(loaded) {
+  const out = /* @__PURE__ */ new Map();
+  for (const scene of loaded.scenes) if (textIsAction(loaded.project, scene)) out.set(scene.id, new Set(sceneTextIds(scene)));
+  return out;
+}
+function actionTextChanges(loaded, opts = {}) {
+  const defaultLocale = loaded.project.locales.default;
+  const locales = opts.locale !== void 0 ? opts.locale === defaultLocale ? [] : [opts.locale] : loaded.project.locales.all.filter((l) => l !== defaultLocale);
+  const source = tableFor(loaded, defaultLocale);
+  const out = [];
+  for (const locale of locales) {
+    for (const scene of loaded.scenes) {
+      const path = existingLocPath(loaded, scene.id, locale);
+      const shard = path ? findFile(loaded.localeFiles, loaded.locales, path) : void 0;
+      if (!shard) continue;
+      const action = textIsAction(loaded.project, scene);
+      for (const id of sceneTextIds(scene)) {
+        if (action && shard.strings[id]) out.push({ id, scene: scene.id, locale, change: "dropped" });
+        else if (!action && shard.textAction && source[id]) out.push({ id, scene: scene.id, locale, change: "added" });
+      }
+    }
+  }
+  return out;
+}
+function projectStringSources(project, sourceTable) {
+  const out = {};
+  const put = (id, authored) => {
+    if (authored) out[id] = sourceTable[id] ?? authored;
+  };
+  for (const c of project.cast ?? []) {
+    put(castStringKey(c.name), c.displayName);
+    for (const [q, label] of Object.entries(c.qualifierLabels ?? {})) put(speakerLabelKey(c.name, q), label);
+  }
+  for (const q of projectQualifiers2(project)) put(qualifierStringKey(q.gameId), q.name);
+  put(SPEAKER_PATTERN_KEY, project.speakerPattern ?? DEFAULT_SPEAKER_PATTERN);
+  return out;
+}
+function extractLoc(loaded, opts = {}) {
+  const defaultLocale = loaded.project.locales.default;
+  const isTemplate = opts.locale === void 0 || opts.locale === defaultLocale;
+  const targetLocale = isTemplate ? void 0 : opts.locale;
+  const source = tableFor(loaded, defaultLocale);
+  const target = targetLocale ? tableFor(loaded, targetLocale) : {};
+  const edits = mergeAuthoring2(loaded).edits;
+  const projectSources = projectStringSources(loaded.project, source);
+  const docs = resolveDocumentation(loaded, "loc");
+  const commentsOf = (id) => (docs.get(id) ?? []).map((d) => d.text);
+  const staleFor = (id, translation) => {
+    if (isTemplate || !translation) return false;
+    const e = edits.get(id);
+    const localised = e?.localisedAt?.[targetLocale];
+    return !!(e?.modifiedAt && localised && e.modifiedAt > localised);
+  };
+  const genderOf = /* @__PURE__ */ new Map();
+  for (const c of loaded.project.cast ?? []) if (c.gender) genderOf.set(c.name, c.gender);
+  const withGender = (context) => {
+    const g = context?.character ? genderOf.get(context.character) : void 0;
+    return g ? { ...context, gender: g } : context;
+  };
+  const qualifierName = new Map(projectQualifiers2(loaded.project).map((q) => [q.gameId, q.name]));
+  const lineContext = (b) => {
+    const q = b.kind === "line" && b.qualifier ? qualifierName.get(b.qualifier) ?? b.qualifier : void 0;
+    return { character: b.kind === "line" ? b.character : void 0, kind: b.kind, ...q ? { qualifier: q } : {} };
+  };
+  const entries = [];
+  const push = (id, scene, context) => {
+    const src = source[id];
+    if (src === void 0) return;
+    const translation = isTemplate ? "" : target[id] ?? "";
+    entries.push({ id, scene, source: src, translation, comments: commentsOf(id), context: withGender(context), stale: staleFor(id, translation) });
+  };
+  for (const scene of loaded.scenes) {
+    const action = textIsAction(loaded.project, scene);
+    for (const block of scene.blocks) {
+      walkNodes2(block.children, (node) => {
+        if (node.type === "group") {
+          const p = node.prompt;
+          if (p) push(p.id, scene.id, lineContext(p));
+          return;
+        }
+        for (const beat of node.beats ?? []) {
+          if (beat.kind === "gameEvent" || action && beat.kind === "text") continue;
+          push(beat.id, scene.id, lineContext(beat));
+        }
+      });
+    }
+  }
+  for (const c of loaded.project.cast ?? []) {
+    if (!c.displayName) continue;
+    const id = castStringKey(c.name);
+    const src = projectSources[id];
+    const translation = isTemplate ? "" : target[id] ?? "";
+    entries.push({ id, scene: PROJECT_LOCALE_SCENE, source: src, translation, comments: commentsOf(id), context: withGender({ character: c.name }), stale: staleFor(id, translation) });
+  }
+  for (const q of usedQualifiers(loaded.project, loaded.scenes)) {
+    const id = qualifierStringKey(q.gameId);
+    const src = projectSources[id] ?? q.name;
+    const translation = isTemplate ? "" : target[id] ?? "";
+    entries.push({ id, scene: PROJECT_LOCALE_SCENE, source: src, translation, comments: commentsOf(id), context: { kind: "qualifier" }, stale: staleFor(id, translation) });
+  }
+  const pairs = usedSpeakerPairs(loaded.scenes);
+  if (pairs.length > 0) {
+    const id = SPEAKER_PATTERN_KEY;
+    const src = projectSources[id];
+    const translation = isTemplate ? "" : target[id] ?? "";
+    entries.push({ id, scene: PROJECT_LOCALE_SCENE, source: src, translation, comments: [SPEAKER_PATTERN_NOTE, ...commentsOf(id)], context: { kind: "speaker pattern" }, stale: staleFor(id, translation) });
+    const labelsOf = new Map((loaded.project.cast ?? []).map((c) => [c.name, c.qualifierLabels]));
+    for (const p of pairs) {
+      const label = labelsOf.get(p.character)?.[p.qualifier];
+      if (!label) continue;
+      const pid = speakerLabelKey(p.character, p.qualifier);
+      const psrc = projectSources[pid] ?? label;
+      const ptranslation = isTemplate ? "" : target[pid] ?? "";
+      const qualifier = qualifierName.get(p.qualifier) ?? p.qualifier;
+      entries.push({ id: pid, scene: PROJECT_LOCALE_SCENE, source: psrc, translation: ptranslation, comments: commentsOf(pid), context: withGender({ character: p.character, kind: "speaker", qualifier }), stale: staleFor(pid, ptranslation) });
+    }
+  }
+  return { project: loaded.project.project.id, defaultLocale, locale: targetLocale, entries };
+}
+var SPEAKER_PATTERN_NOTE = "{name} and {qualifier} are filled in with the speaker's name and the qualifier, so keep both as they are. You can put them in any order.";
+var layoutOf = (loaded) => projectLayout2(loaded.project);
+function existingLocPath(loaded, scene, locale) {
+  for (let i = 0; i < loaded.locales.length; i++) {
+    const l = loaded.locales[i];
+    if (l.scene === scene && l.locale === locale) return loaded.localeFiles[i] ?? null;
+  }
+  return null;
+}
+function targetLocPath(loaded, scene, locale, defaultLocale) {
+  const existing = existingLocPath(loaded, scene, locale);
+  if (existing) return existing;
+  const fromDefault = existingLocPath(loaded, scene, defaultLocale);
+  if (fromDefault) {
+    const parts = fromDefault.split(sep);
+    for (let i = parts.length - 2; i >= 0; i--) {
+      if (parts[i] === defaultLocale) {
+        parts[i] = locale;
+        return parts.join(sep);
+      }
+    }
+  }
+  const stem = scene === PROJECT_LOCALE_SCENE ? "_project" : scene;
+  return join3(loaded.root, layoutOf(loaded).strings, locale, `${stem}.patterloc`);
+}
+function authoringPath(loaded, scene) {
+  const dir = join3(loaded.root, layoutOf(loaded).authoring);
+  if (scene === PROJECT_LOCALE_SCENE) return join3(dir, "_project.patterx");
+  const flow = loaded.sceneFiles[scene];
+  const stem = flow ? basename3(flow).replace(/\.patterflow$/, "") : scene;
+  return join3(dir, `${stem}.patterx`);
+}
+var findFile = (files, items, path) => {
+  const i = files.indexOf(path);
+  return i >= 0 ? items[i] : void 0;
+};
+function locLineHomes(loaded, sourceTable) {
+  const out = /* @__PURE__ */ new Map();
+  for (const scene of loaded.scenes) {
+    for (const block of scene.blocks) {
+      walkNodes2(block.children, (node) => {
+        if (node.type === "group") {
+          if (node.prompt) out.set(node.prompt.id, scene.id);
+          return;
+        }
+        for (const beat of node.beats ?? []) if (beat.kind !== "gameEvent") out.set(beat.id, scene.id);
+      });
+    }
+  }
+  for (const id of Object.keys(projectStringSources(loaded.project, sourceTable))) out.set(id, PROJECT_LOCALE_SCENE);
+  return out;
+}
+function textTokens(text) {
+  const out = [...text.matchAll(INTERP_RE)].map((m) => m[0]);
+  for (const m of text.matchAll(MARKUP_RE)) out.push(`<${m[1]}>`);
+  return out;
+}
+function compareLocTokens(source, translation) {
+  const count = (list) => {
+    const m = /* @__PURE__ */ new Map();
+    for (const t of list) m.set(t, (m.get(t) ?? 0) + 1);
+    return m;
+  };
+  const a = count(textTokens(source)), b = count(textTokens(translation));
+  const short = (x, y) => [...x].flatMap(([t, n]) => Array(Math.max(0, n - (y.get(t) ?? 0))).fill(t)).sort();
+  const missing = short(a, b), extra = short(b, a);
+  return missing.length || extra.length ? { missing, extra } : null;
+}
+function importLocale(fileLocale, chosen, opts = {}) {
+  if (fileLocale && chosen && fileLocale !== chosen && !opts.force) {
+    return { ok: false, reason: "mismatch", error: `This file is for '${fileLocale}', not '${chosen}', so nothing was imported.` };
+  }
+  const locale = chosen ?? fileLocale;
+  if (!locale) return { ok: false, reason: "none", error: "This file doesn't say which language it's for, so nothing was imported." };
+  if (!fileLocale) return { ok: true, locale, warning: `This file doesn't say which language it's for, so it was imported as '${locale}'. Check that's the right language.` };
+  return { ok: true, locale };
+}
+function describeLocImport(loaded, report) {
+  const nameOf = new Map(loaded.scenes.map((sc) => [sc.id, sc.name]));
+  const where = (scene) => scene === PROJECT_LOCALE_SCENE ? "the project's strings" : `'${nameOf.get(scene) ?? scene}'`;
+  const out = [];
+  const u = report.unknown.length;
+  if (u) {
+    out.push(`Skipped ${u} line${u === 1 ? "" : "s"} this project doesn't have, so ${u === 1 ? "its translation wasn't" : "their translations weren't"} imported:`);
+    for (const l of report.unknown) out.push(`  ${l.id} in ${where(l.scene)}`);
+  }
+  const m = report.mismatched.length;
+  if (m) {
+    out.push(`${m} translation${m === 1 ? "" : "s"} ${m === 1 ? "doesn't" : "don't"} match the source's placeholders or formatting. ${m === 1 ? "It was" : "They were"} imported, but check ${m === 1 ? "it" : "them"}:`);
+    for (const l of report.mismatched) {
+      const parts = [l.missing.length ? `missing ${l.missing.join(", ")}` : "", l.extra.length ? `extra ${l.extra.join(", ")}` : ""].filter(Boolean);
+      out.push(`  ${l.id} in ${where(l.scene)}: ${parts.join("; ")}`);
+    }
+  }
+  return out;
+}
+function applyLoc(loaded, catalog, opts = {}) {
+  const report = { unknown: [], mismatched: [] };
+  const locale = catalog.locale;
+  if (!locale || locale === loaded.project.locales.default) {
+    return { writes: [], stats: { updated: 0, files: 0, dropped: 0 }, report };
+  }
+  if (!loaded.project.locales.all.includes(locale)) {
+    throw new Error(`'${locale}' is not one of the project's languages (${loaded.project.locales.all.join(", ")}); add it to the project first`);
+  }
+  const known = /* @__PURE__ */ new Set([...loaded.scenes.map((sc) => sc.id), PROJECT_LOCALE_SCENE]);
+  const unknown = [...new Set(catalog.entries.filter((e) => e.translation.trim() && !known.has(e.scene)).map((e) => e.scene))];
+  if (unknown.length) {
+    throw new Error(`the file names scene(s) this project does not have: ${unknown.map((u) => `'${u}'`).join(", ")}; nothing was imported`);
+  }
+  const now = opts.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const sourceTable = tableFor(loaded, loaded.project.locales.default);
+  const projectSources = projectStringSources(loaded.project, sourceTable);
+  const homes = locLineHomes(loaded, sourceTable);
+  const action = actionTextIds(loaded);
+  const bySceneText = /* @__PURE__ */ new Map();
+  const bySceneFresh = /* @__PURE__ */ new Map();
+  for (const e of catalog.entries) {
+    if (!e.translation.trim()) continue;
+    const scene = homes.get(e.id);
+    if (scene === void 0) {
+      report.unknown.push({ id: e.id, scene: e.scene });
+      continue;
+    }
+    if (action.get(scene)?.has(e.id)) continue;
+    const source = sourceTable[e.id] ?? projectSources[e.id];
+    const diff = source === void 0 ? null : compareLocTokens(source, e.translation);
+    if (diff) report.mismatched.push({ id: e.id, scene, ...diff });
+    (bySceneText.get(scene) ?? bySceneText.set(scene, /* @__PURE__ */ new Map()).get(scene)).set(e.id, e.translation);
+    if (!e.stale) (bySceneFresh.get(scene) ?? bySceneFresh.set(scene, /* @__PURE__ */ new Set()).get(scene)).add(e.id);
+  }
+  const writes = [];
+  let updated = 0;
+  let dropped = 0;
+  let files = 0;
+  const scenes = new Set(bySceneText.keys());
+  for (const l of loaded.locales) if (l.locale === locale && l.scene !== PROJECT_LOCALE_SCENE && known.has(l.scene)) scenes.add(l.scene);
+  for (const scene of scenes) {
+    const strings = bySceneText.get(scene) ?? /* @__PURE__ */ new Map();
+    const path = targetLocPath(loaded, scene, locale, loaded.project.locales.default);
+    const existing = findFile(loaded.localeFiles, loaded.locales, path);
+    const merged = { ...existing?.strings ?? {} };
+    for (const [id, text] of strings) {
+      if (merged[id] !== text) updated++;
+      merged[id] = text;
+    }
+    const actionIds = action.get(scene);
+    for (const id of actionIds ?? []) if (id in merged) {
+      delete merged[id];
+      dropped++;
+    }
+    const file = {
+      schema: existing?.schema ?? STRINGS_SCHEMA,
+      scene,
+      locale,
+      ...actionIds ? { textAction: true } : {},
+      strings: merged
+    };
+    const content = canonicalStringify3(file);
+    if (!existing || strings.size > 0 || canonicalStringify3(existing) !== content) {
+      writes.push({ path, content });
+      files++;
+    }
+    const fresh = bySceneFresh.get(scene);
+    if (!fresh?.size) continue;
+    const aPath = authoringPath(loaded, scene);
+    const aExisting = findFile(loaded.authoringFiles, loaded.authoring, aPath);
+    const authoring = aExisting ? { ...aExisting, edits: { ...aExisting.edits } } : { schema: AUTHORING_SCHEMA };
+    const editsMap = { ...authoring.edits ?? {} };
+    for (const id of fresh) editsMap[id] = { ...editsMap[id], localisedAt: { ...editsMap[id]?.localisedAt, [locale]: now } };
+    authoring.edits = editsMap;
+    writes.push({ path: aPath, content: canonicalStringify3(authoring) });
+  }
+  return { writes, stats: { updated, files, dropped }, report };
+}
+
+// src/pack.ts
+import JSZip from "jszip";
+import { readFileSync as readFileSync4, readdirSync as readdirSync3 } from "fs";
+import { dirname as dirname5, join as join5, relative as relative2, sep as sep2 } from "path";
+import { parseSource as parseSource3 } from "@patterkit/core";
+import { EXTENSION_SHARD as EXTENSION_SHARD2, EXTENSIONS_DIR as EXTENSIONS_DIR2, MANIFEST_EXTENSION as MANIFEST_EXTENSION2 } from "@patterkit/model";
+import { ARCHIVE_ENTRY_OPTS } from "@wildwinter/toolkit/archive";
+
+// src/handoff.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
+import { basename as basename4, join as join4 } from "path";
+import { HANDOFF_SCHEMA } from "@patterkit/model";
+var HANDOFF_DIR = "handoffs";
+var HANDOFF_EXT = ".json";
+function handoffPath(root, id) {
+  return join4(root, HANDOFF_DIR, `${id}${HANDOFF_EXT}`);
+}
+function serialiseHandoff(handoff) {
+  return JSON.stringify(handoff, null, 2) + "\n";
+}
+function handoffWrite(root, handoff) {
+  return { path: handoffPath(root, handoff.id), content: serialiseHandoff(handoff) };
+}
+function parseHandoff(text) {
+  const h = JSON.parse(text);
+  if (h.schema !== HANDOFF_SCHEMA) throw new Error(`not a handoff record (schema ${JSON.stringify(h.schema)})`);
+  if (typeof h.id !== "string" || !h.lines || !Array.isArray(h.skeleton)) throw new Error("handoff record is missing its id, lines, or skeleton");
+  return h;
+}
+function readHandoffs(root) {
+  const handoffs = [];
+  const issues = [];
+  for (const file of walkFiles(join4(root, HANDOFF_DIR), HANDOFF_EXT)) {
+    try {
+      handoffs.push(parseHandoff(readFileSync3(file, "utf8")));
+    } catch (e) {
+      issues.push({ file, message: `${basename4(file)}: ${e instanceof Error ? e.message : String(e)}` });
+    }
+  }
+  handoffs.sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
+  return { handoffs, issues };
+}
+function readHandoff(root, id) {
+  const path = handoffPath(root, id);
+  if (!existsSync3(path)) return void 0;
+  return parseHandoff(readFileSync3(path, "utf8"));
+}
+var ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+function checkChar(body) {
+  let sum = 0;
+  for (let i = 0; i < body.length; i++) sum += (i + 1) * ALPHABET.indexOf(body[i]);
+  return ALPHABET[sum % 31];
+}
+function randomBody(length, random) {
+  let s = "";
+  for (let i = 0; i < length; i++) s += ALPHABET[Math.floor(random() * ALPHABET.length)];
+  return s;
+}
+function markerLength(count) {
+  let length = 3;
+  while (ALPHABET.length ** length < Math.max(1, count) * 1e3) length++;
+  return length;
+}
+function issueMarkerCodes(count, random = Math.random) {
+  const length = markerLength(count);
+  const codes = /* @__PURE__ */ new Set();
+  while (codes.size < count) {
+    const body = randomBody(length, random);
+    codes.add(body + checkChar(body));
+  }
+  return [...codes];
+}
+function formatMarker(code) {
+  return `[#${code}]`;
+}
+function newHandoffId(taken = [], random = Math.random) {
+  const used = new Set(taken);
+  for (; ; ) {
+    const id = `H-${randomBody(4, random)}`;
+    if (!used.has(id)) return id;
+  }
+}
+function readMarker(text) {
+  const m = /\[\s*#?\s*([0-9A-Za-z]{2,9})\s*\]/.exec(text);
+  if (!m) return void 0;
+  const code = m[1].toUpperCase().replace(/O/g, "0").replace(/[IL]/g, "1");
+  if ([...code].some((c) => !ALPHABET.includes(c))) return { code, valid: false };
+  const body = code.slice(0, -1);
+  return { code, valid: body.length >= 2 && checkChar(body) === code.slice(-1) };
+}
+
+// src/pack.ts
+var SHARD_EXTENSIONS = [".patterflow", ".patterloc", ".patterx", ".patterproj", EXTENSION_SHARD2];
+var ENTRY_OPTS = ARCHIVE_ENTRY_OPTS;
+async function runPack(startPath) {
+  const projectFile = findProjectFile(startPath);
+  const root = dirname5(projectFile);
+  const project = parseSource3(readFileSync4(projectFile, "utf8"));
+  const unresolved = sidecarIssues(walkFiles(root, CONFLICT_SIDECAR));
+  if (unresolved.length) {
+    throw new Error(
+      `${unresolved.length} unresolved merge conflict(s) - resolve them before packing, or the recipient gets your side of a disagreement with no sign of it:
+` + unresolved.map((i) => `  ${i.file}`).join("\n")
+    );
+  }
   const shardFiles = SHARD_EXTENSIONS.flatMap((ext) => walkFiles(root, ext)).map((abs) => ({ abs, rel: relative2(root, abs).split(sep2).join("/") }));
   const marked = [...new Set(unresolvedMarkIssues(shardFiles.map((f) => ({ file: f.rel, text: readFileSync4(f.abs, "utf8") }))).map((i) => i.file))];
   if (marked.length) {
@@ -1738,8 +2236,8 @@ function runValidate(loaded) {
   const { project, scenes, locales } = loaded;
   const structural = validateProject({ project, scenes, authoring: loaded.authoring });
   const merged = loaded.gameScopes?.merged;
-  const scopes = projectScopes(project, merged);
-  const foreignScopes = hostScopesToSpec(scopes.host);
+  const scopes = projectScopes2(project, merged);
+  const foreignScopes = hostScopesToSpec2(scopes.host);
   const conditions = validateConditions({ project, scenes }, { foreignScopes, gameScopes: merged });
   const interpolation = validateInterpolation({ project, scenes, locales }, { foreignScopes, gameScopes: merged });
   const gameScopes = gameScopesIssues(loaded, scopes.notes);
@@ -1778,7 +2276,7 @@ var isError = (i) => i.severity === "error";
 function exportBlockers(loaded) {
   const { project, scenes, locales } = loaded;
   const merged = loaded.gameScopes?.merged;
-  const foreignScopes = hostScopesToSpec(projectScopes(project, merged).host);
+  const foreignScopes = hostScopesToSpec2(projectScopes2(project, merged).host);
   const structural = validateProject({ project, scenes, authoring: loaded.authoring }).filter((i) => i.severity !== "warning");
   const conditions = validateConditions({ project, scenes }, { foreignScopes, gameScopes: merged }).filter(isError);
   const interpolation = validateInterpolation({ project, scenes, locales }, { foreignScopes, gameScopes: merged }).filter(isError);
@@ -2131,7 +2629,7 @@ import { canonicalStringify as canonicalStringify5 } from "@patterkit/core";
 import { DEFAULT_PAD_AFTER } from "@patterkit/model";
 
 // src/playable-runtime.ts
-var PLAYABLE_RUNTIME_JS = 'var Patterplay=(()=>{var oe=Object.defineProperty;var ft=Object.getOwnPropertyDescriptor;var ht=Object.getOwnPropertyNames;var mt=Object.prototype.hasOwnProperty;var yt=(r,e)=>{for(var t in e)oe(r,t,{get:e[t],enumerable:!0})},St=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of ht(e))!mt.call(r,s)&&s!==t&&oe(r,s,{get:()=>e[s],enumerable:!(n=ft(e,s))||n.enumerable});return r};var wt=r=>St(oe({},"__esModule",{value:!0}),r);var Ht={};yt(Ht,{Checkpoint:()=>H,DEFAULT_PAD_AFTER:()=>E,Engine:()=>re,Flow:()=>O,buildTagIndex:()=>ne,compareStages:()=>N,describeBundle:()=>ot,effectiveGameData:()=>ct,extensionDecls:()=>lt,extensionsOf:()=>dt,gameDataFields:()=>at,gameDataValue:()=>we,nextStage:()=>B,resolveSceneRef:()=>Z,sceneAddressIndex:()=>fe,stageIndex:()=>P});function F(r,e){return r!==void 0&&Object.prototype.hasOwnProperty.call(r,e)?r[e]:void 0}function R(r){switch(r[0]){case"b":return{kind:"bool",value:r[1]};case"n":return{kind:"number",value:r[1]};case"s":return{kind:"string",value:r[1]};case"sv":return{kind:"scopedvar",scope:r[1],name:r[2]};case"u":return{kind:"unary",op:r[1],operand:R(r[2])};case"bin":return{kind:"binary",op:r[1],left:R(r[2]),right:R(r[3])};case"call":{let e=r.slice(2).map(R);return{kind:"call",name:r[1],args:e}}case"fd":return{kind:"flagdelta",sign:r[1],name:r[2]}}}var u=class extends Error{constructor(e){super(e),this.name="EvalError"}};function J(r,e,t){let n=new Map(t.scopes.map(i=>[i.token,i.missing??"false"])),s=i=>{switch(i.kind){case"bool":return i.value;case"number":return i.value;case"string":return i.value;case"scopedvar":{let o=F(e.scopes,i.scope);if(o===void 0)return!1;let a=typeof o.get=="function"?o.get(i.name):F(o,i.name);if(a===void 0){if(n.get(i.scope)==="throw")throw new u(`@${i.scope}.${i.name} is not declared on the current ${i.scope}.`);return!1}return a}case"call":{if(i.name==="advance"&&!F(t.functions,i.name)){let a=i.args[0];if(i.args.length!==1||a===void 0)throw new u(`advance() takes exactly 1 argument, got ${i.args.length}`);let c=ae(a,e);if(c===void 0)throw new u("advance() needs a quality reference (@scope.name of a quality property)");let l=v(s(a),c,"advance");return c[Math.min(l+1,c.length-1)]}let o=F(t.functions,i.name);if(!o)throw new u(`unknown function \'${i.name}\'`);return o.eval(i.args,{evaluate:s,ctx:e})}case"flagdelta":throw new u("flagdelta node is only valid as an argument to a flag-delta function");case"unary":{if(i.op==="not"){let a=s(i.operand);if(typeof a!="boolean")throw new u(`\'not\' requires a boolean operand, got ${typeof a}`);return!a}let o=s(i.operand);if(typeof o!="number")throw new u(`unary \'-\' requires a numeric operand, got ${typeof o}`);return-o}case"binary":{if(i.op==="and"){let h=s(i.left);if(typeof h!="boolean")throw new u(`\'and\' requires boolean operands, left is ${typeof h}`);if(!h)return!1;let f=s(i.right);if(typeof f!="boolean")throw new u(`\'and\' requires boolean operands, right is ${typeof f}`);return f}if(i.op==="or"){let h=s(i.left);if(typeof h!="boolean")throw new u(`\'or\' requires boolean operands, left is ${typeof h}`);if(h)return!0;let f=s(i.right);if(typeof f!="boolean")throw new u(`\'or\' requires boolean operands, right is ${typeof f}`);return f}let o=s(i.left),a=s(i.right),c=ae(i.left,e),l=ae(i.right,e),d=c??l;if(d!==void 0){if(c&&l&&!vt(c,l)&&(i.op===">"||i.op===">="||i.op==="<"||i.op==="<="))throw new u(`\'${i.op}\' compares two different qualities, whose stage orders are unrelated`);switch(i.op){case">":return v(o,d,">")>v(a,d,">");case">=":return v(o,d,">=")>=v(a,d,">=");case"<":return v(o,d,"<")<v(a,d,"<");case"<=":return v(o,d,"<=")<=v(a,d,"<=");case"+":case"-":case"*":case"/":throw new u(`\'${i.op}\' cannot be applied to a quality - a stage is a position, not a number; use advance() to move it`);default:break}}switch(i.op){case"==":return Ce(o,a);case"!=":return!Ce(o,a);case">":return D(o,a,">"),o>a;case">=":return D(o,a,">="),o>=a;case"<":return D(o,a,"<"),o<a;case"<=":return D(o,a,"<="),o<=a;case"+":if(typeof o=="number"&&typeof a=="number"||typeof o=="string"&&typeof a=="string")return o+a;throw new u(`\'+\' requires two numbers or two strings, got ${typeof o} and ${typeof a}`);case"-":return D(o,a,"-"),o-a;case"*":return D(o,a,"*"),o*a;case"/":if(D(o,a,"/"),a===0)throw new u("division by zero");return o/a}}}};return s(r)}function Ce(r,e){if(Array.isArray(r)||Array.isArray(e)){if(!Array.isArray(r)||!Array.isArray(e)||r.length!==e.length)return!1;let t=[...r].sort(),n=[...e].sort();for(let s=0;s<t.length;s++)if(t[s]!==n[s])return!1;return!0}return r===e}function D(r,e,t){if(typeof r!="number"||typeof e!="number")throw new u(`\'${t}\' requires numeric operands, got ${typeof r} and ${typeof e}`)}function ae(r,e){if(!(r.kind!=="scopedvar"||e.qualities===void 0))return e.qualities(r.scope,r.name)}function v(r,e,t){if(typeof r!="string")throw new u(`\'${t}\' on a quality compares stages, got ${typeof r}`);let n=e.indexOf(r);if(n<0)throw new u(`"${r}" is not a stage of this quality (stages: ${e.join(", ")})`);return n}var vt=(r,e)=>r.length===e.length&&r.every((t,n)=>t===e[n]);function T(r){if(Number.isNaN(r)||!Number.isFinite(r))return 0;let e=Math.trunc(r)%4294967296;return e<0?e+4294967296:e}function ce(r){let e=T(r);return{next(){e=e+1831565813>>>0;let t=Math.imul(e^e>>>15,1|e);return t=t+Math.imul(t^t>>>7,61|t)^t,((t^t>>>14)>>>0)/4294967296},state(){return e}}}var de=r=>Array.isArray(r)?r:r.stages??[],bt=r=>Array.isArray(r)?"flags":r==null?"nothing":typeof r;function P(r,e){return typeof e=="string"?de(r).indexOf(e):-1}function le(r,e){if(typeof e!="string")throw new u(`a stage is a name, got ${bt(e)}`);let t=r.indexOf(e);if(t<0)throw new u(`"${e}" is not a stage of this quality (stages: ${r.join(", ")})`);return t}function N(r,e,t){let n=de(r),s=le(n,e)-le(n,t);return s<0?-1:s>0?1:0}function B(r,e){let t=de(r);return t[Math.min(le(t,e)+1,t.length-1)]}function pe(r,e,t){switch(r.type){case"boolean":return typeof e=="boolean";case"number":return typeof e=="number";case"string":case"text":case"multiline":return typeof e=="string";case"enum":return typeof e!="string"?!1:e===""&&t?.noneChosen?!0:!Array.isArray(r.values)||r.values.includes(e);case"flags":return Array.isArray(e)&&e.every(n=>typeof n=="string"&&(!Array.isArray(r.values)||r.values.includes(n)));case"quality":return typeof e=="string"&&(!Array.isArray(r.stages)||r.stages.includes(e));default:return!0}}var xt={name:"check_flags",count:r=>Math.max(1,r.args.length-1)},kt=[xt];function Ie(r,e,t){let n=t?.countingCalls??kt;return Q(r,t?.want??!0,e,n)}function Q(r,e,t,n){if(r.kind==="binary"&&(r.op==="and"||r.op==="or")){let s=Q(r.left,e,t,n),i=Q(r.right,e,t,n);return r.op==="and"===e?s>0&&i>0?s+i:0:Math.max(s,i)}if(r.kind==="unary"&&r.op==="not")return Q(r.operand,!e,t,n);if(r.kind==="call"){let s=n.find(i=>i.name===r.name);if(s){let i=s.count(r),o=t(r);return e?o?i:0:o?0:1}}return t(r)===e?1:0}var k=class r{values=Object.create(null);decls=new Map;subscribers=new Set;auditors=new Set;norm;pathPrefix;constructor(e=[],t){this.norm=t?.normalise??(n=>n.toLowerCase()),this.pathPrefix=t?.pathPrefix??"",this.seed(e)}seed(e){for(let t of e){let n=this.norm(t.name);this.decls.set(n,t),this.values[n]=structuredClone(t.default??A(t))}}get(e){return this.values[this.norm(e)]}normalise(e){return this.norm(e)}writable(e){return this.decls.get(this.norm(e))?.writable!==!1}set(e,t,n){let s=this.norm(e);if(!n?.host&&!this.writable(s))throw new Error(`\'${e}\' is read-only`);let i={name:s,prev:this.values[s],next:t,silent:n?.silent??!1,reason:n?.reason};this.values[s]=t;for(let o of[...this.auditors])o(i);if(!i.silent)for(let o of[...this.subscribers])o(i);return i}subscribe(e){return this.subscribers.add(e),()=>this.subscribers.delete(e)}onAudit(e){return this.auditors.add(e),()=>this.auditors.delete(e)}rows(){return[...this.decls.entries()].map(([e,t])=>Pe(t,this.get(e),void 0,e,this.pathPrefix))}declarations(){return[...this.decls.values()]}clone(){let e=new r([],{normalise:this.norm,pathPrefix:this.pathPrefix});return e.decls=new Map(this.decls),Object.assign(e.values,structuredClone(this.values)),e}reseed(e){for(let t of Object.keys(this.values))delete this.values[t];this.decls.clear(),this.seed(e)}save(){return structuredClone(this.values)}load(e,t){let n=new Map;for(let[i,o]of Object.entries(e)){let a=this.norm(i);this.values[a]=structuredClone(o),n.set(a,o)}let s=[];if(!t?.refit)return s;for(let[i,o]of this.decls){if(!n.has(i))continue;let a=n.get(i);pe(o,a)||(this.values[i]=structuredClone(A(o)),s.push({name:i,value:a}))}return s}};function Pe(r,e,t,n,s=""){let i=n??r.name.toLowerCase();return{name:i,path:s+i,type:r.type,value:e,default:r.default??A(r),...r.values!==void 0?{values:r.values}:{},...r.stages!==void 0?{stages:r.stages}:{},writable:t??r.writable??!0}}var Et=r=>r.toLowerCase(),ue=1,z=class{scopes=new Map;parked=new Map;parkedRefit=new Set;misfits=[];rev=0;get revision(){return this.rev}defineOwned(e,t,n){let s=typeof n=="string"?{pathPrefix:n}:n??{},i=new k(t,{pathPrefix:s.pathPrefix??`${e}.`,...s.normalise?{normalise:s.normalise}:{}});return this.mountOwned(e,i,s.owner!==void 0?{owner:s.owner}:void 0)}mountOwned(e,t,n){this.assertFree(e,n?.owner),this.scopes.set(e,{kind:"owned",bag:t,...n?.owner!==void 0?{owner:n.owner}:{}}),this.rev++;let s=this.parked.get(e);return s&&(this.note(e,t.load(s,{refit:this.parkedRefit.has(e)})),this.parked.delete(e),this.parkedRefit.delete(e)),this}remove(e,t){let n=this.scopes.get(e);if(!n)throw new Error(`unknown scope \'@${e}\'`);return t?.keep&&n.kind==="owned"&&(this.parked.set(e,n.bag.save()),this.parkedRefit.delete(e)),this.scopes.delete(e),this.rev++,this}discardParked(e){if(e===void 0)this.parked.clear(),this.parkedRefit.clear();else for(let t of[...this.parked.keys()])t.startsWith(e)&&(this.parked.delete(t),this.parkedRefit.delete(t));return this}takeMisfits(e){if(!e){let n=this.misfits;return this.misfits=[],n}let t=this.misfits.filter(n=>e(n.scope));return this.misfits=this.misfits.filter(n=>!e(n.scope)),t}note(e,t){for(let n of t)this.misfits.push({scope:e,name:n.name,value:n.value})}ownedBag(e){let t=this.scopes.get(e);if(!t||t.kind!=="owned")throw new Error(`\'@${e}\' is not an owned scope`);return t.bag}reseedOwned(e,t){return this.ownedBag(e).reseed(t),this}defineForeign(e,t,n=[],s=!0){let i=typeof s=="boolean"?{writable:s}:s;this.assertFree(e,i.owner);let o=i.normalise??Et,a=new Map;for(let c of n)a.set(o(c.name),c);return this.scopes.set(e,{kind:"foreign",resolver:t,decls:a,scopeWritable:i.writable??!0,norm:o,...i.owner!==void 0?{owner:i.owner}:{}}),this.rev++,this}has(e){return this.scopes.has(e)}get(e,t){let n=this.scopes.get(e);if(n)return n.kind==="owned"?n.bag.get(t):n.resolver.get(n.norm(t))}set(e,t,n,s){let i=this.scopes.get(e);if(!i)throw new Error(`unknown scope \'@${e}\'`);if(i.kind==="owned"){if(!s?.host&&!i.bag.writable(t))throw new Error(`\'@${e}.${t}\' is read-only`);i.bag.set(t,n,s?.host?{host:!0}:void 0);return}let o=i.norm(t);if(!i.resolver.set)throw new Error(`\'@${e}.${t}\' is read-only`);if(!s?.host&&!this.foreignWritable(i,o))throw new Error(`\'@${e}.${t}\' is read-only`);i.resolver.set(o,n)}foreignWritable(e,t){return e.resolver.set?e.decls.get(t)?.writable??e.scopeWritable:!1}listProperties(){let e=[];for(let[t,n]of this.scopes){let s=n.owner!==void 0?{owner:n.owner}:{};if(n.kind==="owned")for(let i of n.bag.rows())e.push({scope:t,...s,...i});else for(let[i,o]of n.decls)e.push({scope:t,...s,...Pe(o,n.resolver.get(i),this.foreignWritable(n,i),i,`${t}.`)})}return e}toEvalContext(e,t){let n=this.view(t?.aliases),s={};for(let[o,a]of n)s[o]=a.kind==="owned"?a.bag.values:a.resolver;let i=this.qualityLadders(n);return i.size===0?{scopes:s,host:e}:{scopes:s,host:e,qualities:(o,a)=>{let c=n.get(o);return c?i.get(o)?.get(Rt(c)(a)):void 0}}}view(e){let t=new Map(this.scopes);for(let[n,s]of Object.entries(e??{})){let i=this.scopes.get(s);if(!i)throw new Error(`alias \'@${n}\' names \'${s}\', which is not registered`);t.set(n,i)}return t}qualityLadders(e){let t=new Map;for(let[n,s]of e)for(let[i,o]of Oe(s)){if(o.type!=="quality"||o.stages===void 0)continue;let a=t.get(n);a||(a=new Map,t.set(n,a)),a.set(i,o.stages)}return t}toSchema(e){let t=new Map;for(let[n,s]of this.view(e?.aliases)){let i=Oe(s);if(i.length===0)continue;let o=new Map;for(let[a,c]of i)o.set(a,{type:c.type,enumValues:c.values,...c.stages!==void 0?{stages:c.stages}:{}});t.set(n,o)}return{properties:t}}save(){let e={};for(let[t,n]of this.scopes)n.kind==="owned"&&(e[t]=n.bag.save());for(let[t,n]of this.parked)e[t]=structuredClone(n);return e}load(e,t){t?.keepParked||(this.parked.clear(),this.parkedRefit.clear());let n=t?.refit===!0;for(let[s,i]of Object.entries(e)){let o=this.scopes.get(s);o?.kind==="owned"?this.note(s,o.bag.load(i,{refit:n})):o||(this.parked.set(s,structuredClone(i)),n?this.parkedRefit.add(s):this.parkedRefit.delete(s))}}saveFragment(){return{version:ue,scopes:this.save()}}loadFragment(e){if(e.version!==ue)throw new Error(`unsupported owned-state fragment version ${e.version} (supported: ${ue})`);this.load(e.scopes)}assertFree(e,t){let n=this.scopes.get(e);if(!n)return;let s=n.owner!==void 0?` by ${n.owner}`:"",i=t!==void 0?` (wanted by ${t})`:"";throw new Error(`scope \'@${e}\' is already registered${s}${i}`)}};function Oe(r){return r.kind==="foreign"?[...r.decls.entries()]:r.bag.declarations().map(e=>[r.bag.normalise(e.name),e])}function Rt(r){return r.kind==="foreign"?r.norm:e=>r.bag.normalise(e)}function A(r){if(r.default!==void 0)return r.default;switch(r.type){case"boolean":return!1;case"number":return 0;case"string":case"text":case"multiline":return"";case"enum":return r.values?.[0]??"";case"flags":return[];case"quality":return r.stages?.[0]??"";default:return!1}}var Ne=[{token:"patter",engine:"Patterplay",means:"Patter\'s shared globals"},{token:"story",engine:"Storylet Engine",means:"the Storylet Engine\'s shared @story properties"}];function L(r){return r.ctx.host??{}}var ge={defaultScope:"patter",scopes:[{token:"patter"},{token:"scene"}],functions:{random:{minArgs:2,maxArgs:2,returnType:"number",eval(r,e){if(r.length!==2)throw new u("random(a, b) requires exactly 2 arguments");let t=L(e).nextRandom;if(!t)throw new u("random() called without a PRNG in context");let n=e.evaluate(r[0]),s=e.evaluate(r[1]);if(typeof n!="number"||typeof s!="number")throw new u("random(a, b) arguments must be numbers");if(!Number.isInteger(n)||!Number.isInteger(s))throw new u("random(a, b) arguments must be integers");let i=Math.min(n,s),o=Math.max(n,s);return Math.floor(t()*(o-i+1))+i}},check_flags:{minArgs:1,returnType:"boolean",flagDeltaArgs:!0,validate:Ae("check_flags"),eval(r,e){let t=Be(r[0],e,"check_flags");for(let n=1;n<r.length;n++){let s=r[n];if(s.kind!=="flagdelta")throw new u("check_flags() flag args must be +flagName or -flagName");if(s.sign==="+"?!t.includes(s.name):t.includes(s.name))return!1}return!0}},set_flags:{minArgs:1,returnType:"flags",flagDeltaArgs:!0,validate:Ae("set_flags"),eval(r,e){let t=[...Be(r[0],e,"set_flags")];for(let n=1;n<r.length;n++){let s=r[n];if(s.kind!=="flagdelta")throw new u("set_flags() flag args must be +flagName or -flagName");if(s.sign==="+")t.includes(s.name)||t.push(s.name);else{let i=t.indexOf(s.name);i>=0&&t.splice(i,1)}}return t}},visits:{minArgs:1,maxArgs:1,returnType:"number",validate:X("visits"),eval:(r,e)=>L(e).visits?.(Y(r,e,"visits"))??0},seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:X("seen"),eval:(r,e)=>(L(e).visits?.(Y(r,e,"seen"))??0)>0},patter_visits:{minArgs:1,maxArgs:1,returnType:"number",validate:X("patter_visits"),eval:(r,e)=>L(e).patterVisits?.(Y(r,e,"patter_visits"))??0},patter_seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:X("patter_seen"),eval:(r,e)=>(L(e).patterVisits?.(Y(r,e,"patter_seen"))??0)>0}}},wn=Ne.map(r=>r.token).filter(r=>r!=="patter"&&r!=="scene");function Fe(r,e){let t=r.replace(/^@/,"").split(".");return t.length===2&&e(t[0])?{scope:t[0],name:t[1].toLowerCase()}:{scope:"patter",name:t.join(".").toLowerCase()}}function Y(r,e,t){let n=e.evaluate(r[0]);if(typeof n!="string")throw new u(`${t}(id) requires a string node id`);return n}function X(r){return(e,t)=>{let n=e[0];n&&n.kind!=="string"&&t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${r}(id): the argument must be a string id literal (a scene / block / node id)`})}}function Be(r,e,t){if(!r)throw new u(`${t}() requires at least one argument (the flags variable)`);let n=e.evaluate(r);if(Array.isArray(n))return n;if(n===!1||n===null||n===void 0)return[];throw new u(`${t}() first argument must be a flags property`)}function Ae(r){return(e,t)=>{if(e.length===0)return;let n=e[0];if(n.kind!=="scopedvar"){t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${r}(): first argument must be a flags property reference (@name or @scope.name)`});return}let s=t.schema.properties.get(n.scope)?.get(n.name);if(s&&s.type!=="flags"){let i=n.scope===t.defaultScope?n.name:`${n.scope}.${n.name}`;t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${r}(): \'@${i}\' is not a flags property (got ${s.type})`});return}for(let i=1;i<e.length;i++){let o=e[i];o.kind!=="flagdelta"?t.report({path:[...t.path,"args",i],kind:"wrong-arg-type",severity:"error",message:`${r}(): argument ${i+1} must be +flagName or -flagName`}):s?.type==="flags"&&s.enumValues&&!s.enumValues.includes(o.name)&&t.report({path:[...t.path,"args",i],kind:"unknown-flag-name",severity:"error",message:`${r}(): unknown flag \'${o.name}\'`,reference:o.name})}}}var Dt=/^@[A-Za-z0-9_.]+$/;function*Ct(r){let e="",t=0;for(;t<r.length;){let n=r[t];if(n==="{"&&r[t+1]==="{"){e+="{",t+=2;continue}if(n==="}"&&r[t+1]==="}"){e+="}",t+=2;continue}if(n==="{"){let s=r.indexOf("}",t+1);if(s!==-1){let i=r.slice(t,s+1),o=r.slice(t+1,s).trim();if(o.startsWith("@")){e&&(yield{kind:"text",value:e},e=""),yield{kind:"slot",raw:i,inner:o,ref:Dt.test(o)?o:void 0},t=s+1;continue}e+=i,t=s+1;continue}}e+=n,t+=1}e&&(yield{kind:"text",value:e})}function It(r){return Array.isArray(r)?r.join(", "):typeof r=="boolean"?r?"true":"false":String(r)}function Ot(r){return r===" "||r==="	"||r===`\n`||r==="\\r"||r==="\\f"||r==="\\v"}function Pt(r){let e="",t=!1;for(let n of r){if(Ot(n)){t=!0;continue}t&&e.length>0&&(e+=" "),t=!1,e+=n}return e}function Te(r,e,t){if(e.length===0||r.indexOf(e)<0)return r;let n="",s=0,i=!1;for(;s<r.length;){if(r.startsWith(e,s)){let o=r.indexOf(t,s+e.length);if(o>=0){s=o+t.length,i=!0;continue}n+=r.slice(s);break}n+=r[s],s+=1}return i?Pt(n):r}function Le(r,e){if(r.indexOf("{")<0)return r;let t="";for(let n of Ct(r)){if(n.kind==="text"){t+=n.value;continue}if(!n.ref){t+=n.raw;continue}let s=e(n.ref);t+=s===void 0?"":It(s)}return t}function C(r,e){for(let t of r){e(t);let n=t.children;n&&C(n,e)}}function Nt(r){return r.toLowerCase().replace(/[\'\u2019]/g,"").replace(/[^a-z0-9-]+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function m(r){let e=r.gameId?.trim();return e||Nt(r.name)}function fe(r){let e=new Map;for(let[t,n]of Object.entries(r))e.set(m(n),t);return e}function Z(r,e,t){return(t??fe(r)).get(e)??(Object.hasOwn(r,e)?e:void 0)}var E=.6;function ee(r){return`cast:${r}`}function te(r){return`qualifier:${r}`}function je(r,e){return`speaker:${r}:${e}`}var Me="speaker:pattern",Ve="{name} ({qualifier})";function Ge(r,e,t){return r.split("{name}").map(n=>n.split("{qualifier}").join(t)).join(e)}var he={open:"[",close:"]"},qe="SFX";var j=3;function M(r){let e=new Set,t=[];for(let n of r)e.has(n)||(e.add(n),t.push(n));return t}function ne(r){let e=new Map,t=(n,s)=>{let i=M([...s,...n.tags??[]]);if(e.set(n.id,i),n.type==="group"&&n.prompt&&e.set(n.prompt.id,M([...i,...n.prompt.tags??[]])),n.type==="group")for(let o of n.children)t(o,i);else for(let o of n.beats??[])e.set(o.id,M([...i,...o.tags??[]]))};for(let n of Object.values(r.scenes)){let s=M(n.tags??[]);e.set(n.id,s);for(let i of n.blocks){let o=M([...s,...i.tags??[]]);e.set(i.id,o);for(let a of i.children)t(a,o)}}return e}var $e=r=>r.kind==="line"||r.kind==="text",V=r=>typeof r=="number"&&Number.isFinite(r)?r:void 0;function _e(r){let e=new Map,t=(i,o,a)=>{let c=i.kind==="gameEvent"?void 0:V(i.padAfter),l=c??o;a&&l<0&&(l=0),e.set(i.id,c!==void 0?{own:c,resolved:l}:{resolved:l})},n=(i,o)=>{let a=V(i.padAfterDefault)??o;if(i.type==="group"){i.prompt&&t(i.prompt,a,!1);for(let d of i.children)n(d,a);return}let c=i.beats??[],l=-1;c.forEach((d,h)=>{$e(d)&&(l=h)}),c.forEach((d,h)=>{$e(d)&&t(d,a,h===l)})},s=V(r.padAfterDefault)??E;for(let i of Object.values(r.scenes)){let o=V(i.padAfterDefault)??s;for(let a of i.blocks){let c=V(a.padAfterDefault)??o;for(let l of a.children)n(l,c)}}return e}var He=new WeakMap,Ue=new WeakMap;function Bt(r){let e=Ue.get(r);return e||(e=ne(r),Ue.set(r,e)),e}var We=new WeakMap;function At(r){let e=We.get(r);return e||(e=_e(r),We.set(r,e)),e}var Ke=new WeakMap;function Ft(r){let e=Ke.get(r);if(e)return e;e=new Map;for(let t of Object.values(r.scenes))for(let n of t.blocks)C(n.children,s=>{if(s.type==="group"){s.prompt&&e.set(s.prompt.id,s.prompt);return}for(let i of s.beats??[])e.set(i.id,i)});return Ke.set(r,e),e}function I(r,e){return r.tagIndex.get(e)?.slice()}var $="Patter",G=r=>r.replace(/%/g,"%25").replace(/\\//g,"%2F"),Tt=r=>r.replace(/%2F/g,"/").replace(/%25/g,"%"),Je=Symbol("ownsRegistry"),w={stage:r=>`patter/scene/${G(r)}`,flow:r=>`patter/flow/${G(r)}/`,flowGlobals:r=>`patter/flow/${G(r)}/patter`,flowScene:(r,e)=>`patter/flow/${G(r)}/scene/${G(e)}`},H=class{constructor(e){this.journal=e}journal},re=class r{host;defaultSeed;flowsById=new Map;allStrings;currentLocale;sourceDebug;sceneGameIdToId=new Map;blockGameIdToId=new Map;creationOptions;engineLog=[];engineSeq=0;engineTraceHandlers=new Set;constructor(e,t={}){this.creationOptions=t;let n=t.locale??e.locales.default,s=e.strings;this.allStrings=s,this.currentLocale=n;let i=s[n]??{},o=s[e.locales.default]??{},a=e.localisation,c=a?.mode==="ids"&&!a.sourceDebug;this.sourceDebug=a?.mode==="ids"&&!!a.sourceDebug,this.sourceDebug&&typeof console<"u"&&console.warn("[Patterplay] source-only DEBUG build: strings are the source language for debugging, not a shippable localised build.");let l=new Map;for(let p of e.cast??[])p.displayName&&l.set(p.name,p.displayName);let d=new Map;for(let p of e.qualifiers??[])p?.gameId&&d.set(p.gameId,p.name);let h=new Map;for(let p of e.cast??[])for(let[g,S]of Object.entries(p.qualifierLabels??{}))typeof S=="string"&&h.set(`${p.name}\\0${g}`,S);let f=e.speakerPattern??Ve;this.defaultSeed=(t.seed??2654435769)>>>0;let ve=new Map,be=new Map,xe=new Map;for(let[p,g]of Object.entries(e.scenes)){this.sceneGameIdToId.set(m(g),p);let S=new Map;for(let y of g.blocks)be.set(y.id,{sceneId:p}),xe.set(y.id,y),S.set(m(y),y.id),C(y.children,K=>ve.set(K.id,K));this.blockGameIdToId.set(p,S)}let ke=e.properties??[],se=ke.filter(p=>p.shared??!0).map(Xe),pt=ke.filter(p=>!(p.shared??!0)).map(Xe),ut=new Set(se.map(p=>p.name.toLowerCase())),x=t.registry??new z,Ee=!t.registry||t[Je]===!0,Re=new k(se,{pathPrefix:"@patter."}),ie=[],W=[];try{x.mountOwned("patter",Re,{owner:$}),W.push("patter");let p=new Set;for(let[g,S]of Object.entries(Ze(t))){let y=e.scopeRegistry?.scopes.find(gt=>gt.token===g),K=(y?.declarations??[]).map(rt);x.defineForeign(g,S,K,{writable:y?.writable??!0,owner:$}),W.push(g),p.add(g)}for(let g of Ee?e.scopeRegistry?.scopes??[]:[]){if(p.has(g.token)||x.has(g.token))continue;let S=(g.declarations??[]).map(y=>Mt(y,g.writable));x.defineOwned(g.token,S,{owner:$}),W.push(g.token),ie.push(g.token)}}catch(p){for(let g of W)x.remove(g,{keep:!0});throw p}let De=new Map;for(let[p,g]of Object.entries(e.scenes)){let S=new Set((g.sceneProps??[]).filter(y=>y.shared??!1).map(y=>y.name.toLowerCase()));De.set(p,S)}this.host={logEnabled:t.log??!1,tracing:t.log??!1,emitEngine:(p,g,S)=>this.emitEngine(p,g,S),bundle:e,emitIds:c,strings:i,defaultStrings:o,castDisplay:l,qualifierDisplay:d,speakerLabels:h,speakerPattern:f,nodeIndex:ve,blockIndex:be,blockById:xe,sceneGameIdToId:this.sceneGameIdToId,blockGameIdToId:this.blockGameIdToId,tagIndex:Bt(e),padIndex:At(e),registry:x,ownsRegistry:Ee,patterBag:Re,hostScopes:ie,patterSharedDecls:se,patterLocalDecls:pt,patterSharedNames:ut,sceneSharedNames:De,sharedVisits:new Map,qualityLadders:new Map,sharedSelectors:new Map,stageBags:new Map,journal:null,customRng:t.rng,onDryChoice:t.onDryChoice,onError:t.onError??(p=>console.warn(`Patterplay: ${p.kind} on ${p.node} in flow \'${p.flow}\' failed, played through: ${p.message}`)),reportRefits:()=>{let p=x.takeMisfits(g=>g==="patter"||g.startsWith("patter/")||ie.includes(g));if(p.length!==0)if(t.onRefit)t.onRefit(p);else for(let g of p)console.warn(`Patterplay: the save\'s ${g.scope}.${g.name} was ${JSON.stringify(g.value)}, which no longer fits its declaration; it is back at its default`)},replayPromptOnChoose:t.replayPromptOnChoose??!1,captionsOn:t.closedCaptions??!0,captionOpen:(e.closedCaptions??he).open,captionClose:(e.closedCaptions??he).close,captionCharacter:e.closedCaptions?.character||qe,refSplitCache:new Map,refSplitRevision:x.revision},this.host.reportRefits()}get locale(){return this.currentLocale}get isSourceDebug(){return this.sourceDebug}get buildId(){return this.host.bundle.content?.hash??""}setLocale(e){this.currentLocale=e,this.host.strings=this.allStrings[e]??{}}replaceStrings(e){this.allStrings=e.strings,this.host.strings=this.allStrings[this.currentLocale]??{},this.host.defaultStrings=this.allStrings[this.host.bundle.locales.default]??{}}hotSwap(e){this.refuseInCheckpoint("hotSwap");let t=this.saveGame(),n=c=>(c.setLocale(this.currentLocale),c.setClosedCaptions(this.host.captionsOn),c),s=()=>new r(e,{...this.creationOptions,registry:this.host.registry,[Je]:this.host.ownsRegistry}),i=new Set(["patter",...this.host.hostScopes]),o=this.host.ownsRegistry?void 0:Object.fromEntries(Object.entries(this.host.registry.save()).filter(([c])=>i.has(c)||c.startsWith("patter/")));this.release(!0),o&&this.host.registry.load(o,{keepParked:!0,refit:!0});let a=s();try{return a.loadGame(t),n(a)}catch{a.release(!0);let c=this.host.ownsRegistry?t.registry:o;c&&this.host.registry.load(c,{keepParked:!0,refit:!0});let l=s();for(let[d,h]of Object.entries(t.flows)){let f=h.cursor.currentSceneId;try{l.openFlow(d,f!==null?{scene:f}:{})}catch{}}return n(l)}}get closedCaptions(){return this.host.captionsOn}setClosedCaptions(e){this.host.captionsOn=e}openFlow(e,t={}){this.assertExternalScopes();let{sceneId:n,blockId:s}=this.resolveOpenAddress(t.scene,t.block),i=this.flowsById.get(e),o=this.host.journal;if(o&&i&&!i.isClosed)throw new Error(`openFlow would replace the open flow \'${e}\', which can\'t be undone while a checkpoint is open`);i?.close();let a=new O(e,this.host,t.seed??this.defaultSeed);return o&&(o.flows.add(a),o.opened.add(a),o.undo.push(()=>{a.close(),i?this.flowsById.set(e,i):this.flowsById.delete(e)})),this.flowsById.set(e,a),a.begin(n,s),a}runFlow(e,t,n){let s=this.flowsById.get(e);if(!s)return this.openFlow(e,{scene:t,block:n}).advanceToStop().played;if(!s.goto(t,n))throw new Error(`runFlow: address not found: ${t}${n===void 0?"":` / ${n}`}`);return s.advanceToStop().played}assertExternalScopes(){for(let e of this.host.bundle.externalScopes??[])if(!this.host.registry.has(e))throw new Error(`this content names @${e}, which no engine on this registry registered: give every engine the game\'s one registry`)}resolveOpenAddress(e,t){if(e!==void 0){let n=me(this.host,e);if(n===void 0)throw new Error(`unknown scene: ${e}`);if(t===void 0)return{sceneId:n};let s=ye(this.host,n,t);if(s===void 0)throw new Error(`unknown block: ${t}`);return{sceneId:n,blockId:s}}if(t!==void 0){if(!this.host.blockIndex.has(t))throw new Error(`unknown block: ${t}`);return{blockId:t}}if(Object.keys(this.host.bundle.scenes).length===0)throw new Error("no scenes in bundle");return{}}resolveSceneRef(e){if(e!=null)return me(this.host,e)??e}resolveBlockRef(e,t){if(t!=null)return e==null?t:ye(this.host,e,t)}sceneAddress(e){let t=this.host.bundle.scenes[e];return t?m(t):void 0}blockAddress(e){let t=this.host.blockById.get(e);return t?m(t):void 0}tagsForBeat(e){return I(this.host,e)??[]}tagsForScene(e){let t=this.resolveSceneRef(e);return(t!=null?I(this.host,t):void 0)??[]}tagsForBlock(e,t){let n=this.resolveSceneRef(e),s=this.resolveBlockRef(n,t);return(s!=null?I(this.host,s):void 0)??[]}gameDataForScene(e){let t=this.resolveSceneRef(e);return{...(t!=null?this.host.bundle.scenes[t]:void 0)?.gameData}}gameDataForBlock(e,t){let n=this.resolveBlockRef(this.resolveSceneRef(e),t);return{...(n!=null?this.host.blockById.get(n):void 0)?.gameData}}extensionsForScene(e){let t=this.resolveSceneRef(e);return{...(t!=null?this.host.bundle.scenes[t]:void 0)?.extensions}}extensionsForBlock(e,t){let n=this.resolveBlockRef(this.resolveSceneRef(e),t);return{...(n!=null?this.host.blockById.get(n):void 0)?.extensions}}extensionsForSnippet(e){let t=this.host.nodeIndex.get(e);return t?.type==="snippet"?{...t.extensions}:{}}getCast(){let e=[];for(let t of this.host.bundle.cast??[])t?.name&&e.push(t.name);return e}castForScene(e){let t=this.resolveSceneRef(e),n=t!=null?this.host.bundle.scenes[t]:void 0;if(!n)return[];let s=new Set;for(let i of n.blocks)Qe(i.children,s);return[...s]}castForBlock(e,t){let n=this.resolveSceneRef(e),s=this.resolveBlockRef(n,t),i=s!=null?this.host.blockById.get(s):void 0;if(!i)return[];let o=new Set;return Qe(i.children,o),[...o]}getOutline(){return Object.values(this.host.bundle.scenes).map(e=>({id:e.id,...m(e)?{gameId:m(e)}:{},name:e.name,...ze(e.gameData),...b(e.extensions),...this.tagsField(e.id),blocks:e.blocks.map(t=>({id:t.id,...m(t)?{gameId:m(t)}:{},name:t.name,...ze(t.gameData),...b(t.extensions),...this.tagsField(t.id),children:t.children.map(n=>this.outlineNode(n))}))}))}getBeatSequence(){let e=[];for(let t of Object.values(this.host.bundle.scenes))for(let n of t.blocks)C(n.children,s=>{if(s.type==="snippet")for(let i of s.beats??[])e.push({sceneId:t.id,blockId:n.id,snippetId:s.id,beat:this.beatInfo(i)})});return e}outlineNode(e){return e.type==="group"?{type:"group",id:e.id,...this.tagsField(e.id),...e.selector?{selector:e.selector}:{},...e.prompt?{prompt:this.beatInfo(e.prompt)}:{},children:e.children.map(t=>this.outlineNode(t))}:{type:"snippet",id:e.id,...this.tagsField(e.id),beats:(e.beats??[]).map(t=>this.beatInfo(t)),...e.jump?{jumpTo:e.jump.to,...e.jump.mode?{jumpMode:e.jump.mode}:{}}:{}}}beatInfo(e){let t=I(this.host,e.id),n={id:e.id,kind:e.kind};if(e.kind==="line"){if(e.character!==void 0){n.character=e.character;let i=this.host.defaultStrings[ee(e.character)]??this.host.castDisplay.get(e.character);i!==void 0&&(n.characterName=i)}if(e.direction!==void 0&&(n.direction=e.direction),e.qualifier!==void 0){n.qualifier=e.qualifier;let i=this.host.defaultStrings[te(e.qualifier)]??this.host.qualifierDisplay.get(e.qualifier);i!==void 0&&(n.qualifierName=i)}let s=q(this.host,e.character,e.qualifier,!0);s!==void 0&&(n.speakerLabel=s)}if(e.kind==="line"||e.kind==="text"){let s=this.host.padIndex.get(e.id);n.padAfter=s?.resolved??E,s?.own!==void 0&&(n.ownPadAfter=s.own);let i=this.host.defaultStrings[e.id];i!==void 0&&(n.text=i)}return e.gameData&&Object.keys(e.gameData).length&&(n.gameData=e.gameData),e.extensions&&Object.keys(e.extensions).length&&(n.extensions=e.extensions),t&&t.length&&(n.tags=t),n}tagsField(e){let t=I(this.host,e);return t&&t.length?{tags:t}:{}}getFlow(e){return this.flowsById.get(e)}flows(){return[...this.flowsById.values()]}listBags(){let e=[{bag:this.host.patterBag}];for(let[t,n]of this.host.stageBags)e.push({bag:n,pathPrefix:`@scene:${t}.`});return e}checkpoint(){if(this.host.journal)throw new Error("a checkpoint is already open: roll it back or commit it first");let e={undo:[],flows:new Set,opened:new Set,selectors:new Set,flowSelectors:new Map};return this.host.journal=e,new H(e)}rollback(e){this.endCheckpoint(e);let t=e.journal.undo;for(let n=t.length-1;n>=0;n--)t[n]();r.forget(e.journal)}commit(e){this.endCheckpoint(e),r.forget(e.journal)}get inCheckpoint(){return this.host.journal!==null}endCheckpoint(e){if(this.host.journal!==e.journal)throw new Error("that checkpoint is not the open one");this.host.journal=null}static forget(e){e.undo=[],e.flows.clear(),e.opened.clear(),e.selectors.clear(),e.flowSelectors.clear()}refuseInCheckpoint(e){if(this.host.journal)throw new Error(`${e} can\'t be undone, so it isn\'t allowed while a checkpoint is open`)}captureFlow(e){let t=this.flowsById.get(e);if(!t)throw new Error(`no open flow \'${e}\' to capture`);return{version:j,...t.snapshot(),...Gt(e,this.host.registry.save())}}restoreFlow(e,t){this.refuseInCheckpoint("restoreFlow");let n=t.version;if(n!==2&&n!==j)throw new Error(`unsupported flow state version: ${String(n)}`);let s=t.cursor;if(typeof s!="object"||s===null)throw new Error("malformed flow state: no cursor");if(this.flowsById.has(e))throw new Error(`a flow \'${e}\' is already open; close it before restoring another under that id`);this.assertExternalScopes();let i=w.flow(e);this.host.registry.discardParked(i),this.host.registry.load(it(e,t),{keepParked:!0,refit:!0});let o=new O(e,this.host,this.defaultSeed);try{o.restore(t)}catch(a){throw o.close(),this.host.registry.discardParked(i),a}return this.flowsById.set(e,o),this.host.reportRefits(),o}closeFlow(e){this.refuseInCheckpoint("closeFlow"),this.flowsById.get(e)?.close(),this.flowsById.delete(e)}reset(){this.refuseInCheckpoint("reset");for(let e of this.flowsById.values())e.close();this.flowsById.clear(),this.host.patterBag.reseed(this.host.patterSharedDecls),this.host.sharedVisits.clear(),this.host.sharedSelectors.clear();for(let e of this.host.stageBags.keys())this.host.registry.remove(w.stage(e));this.host.stageBags.clear(),this.host.registry.discardParked("patter/")}release(e){for(let n of this.flowsById.values())n.releaseBags(e),n.close();this.flowsById.clear();let t=this.host.registry;for(let n of this.host.stageBags.keys())t.remove(w.stage(n),{keep:e});this.host.stageBags.clear();for(let n of["patter",...this.host.hostScopes])t.has(n)&&t.remove(n,{keep:e});for(let n of Object.keys(Ze(this.creationOptions)))t.has(n)&&t.remove(n)}getProperty(e){let{scope:t,name:n}=this.splitShared(e);return this.host.registry.get(t,n)}setProperty(e,t){let{scope:n,name:s}=this.splitShared(e),i=this.host.journal?this.host.registry.get(n,s):void 0;this.host.registry.set(n,s,t,{host:!0}),this.host.journal&&i!==void 0&&this.host.journal.undo.push(()=>this.host.registry.set(n,s,i,{host:!0}))}stageIndex(e,t){return P(this.ladderOf(e),t)}compareStages(e,t,n){return N(this.ladderOf(e),t,n)}nextStage(e,t){return B(this.ladderOf(e),t)}ladderOf(e){let{scope:t,name:n}=this.splitShared(e),s=jt(this.host,t,n);if(!s)throw new Error(`\'${e}\' is not a quality`);return s}log(){return this.engineLog}clearLog(){this.engineLog.length=0}onTrace(e){return this.engineTraceHandlers.add(e),this.host.tracing=!0,()=>{this.engineTraceHandlers.delete(e),this.host.tracing=this.host.logEnabled||this.engineTraceHandlers.size>0}}emitEngine(e,t,n){for(let s of this.engineTraceHandlers)s(e,t);this.host.logEnabled&&this.engineLog.push({...t,flow:e,seq:this.engineSeq++,...n?{scene:n}:{}})}getVisitCounts(){return Object.fromEntries(this.host.sharedVisits)}listProperties(){return this.host.patterSharedDecls.map(e=>({name:e.name,path:`@patter.${e.name}`,type:e.type,values:e.values,stages:e.stages,value:this.getProperty(`@${e.name}`),default:A(e),writable:e.writable??!0}))}splitShared(e){let t=st(this.host,e);if(t.scope==="scene")throw new Error(`\'${e}\': @scene properties are scene-scoped - read/write them on a Flow, not the Engine`);return t}save(){return{patter:this.host.patterBag.save()}}load(e){e.patter&&this.host.patterBag.load(e.patter)}saveGame(){let e={};for(let[t,n]of this.flowsById)e[t]=n.snapshot();return{version:j,...this.host.ownsRegistry?{registry:this.host.registry.save()}:{},sharedVisits:Object.fromEntries(this.host.sharedVisits),sharedSelectors:tt(this.host.sharedSelectors),flows:e}}loadGame(e){this.refuseInCheckpoint("loadGame");let t=e.version;if(t!==2&&t!==j)throw new Error(`unsupported save version: ${String(t)}`);let n=e.flows;if(typeof n!="object"||n===null||Array.isArray(n))throw new Error("malformed save: no flows");this.assertExternalScopes();let s=this.host.registry;for(let[o,a]of this.flowsById)a.releaseBags(o in e.flows),a.close();this.flowsById.clear();for(let o of this.host.stageBags.keys())s.remove(w.stage(o),{keep:!0});this.host.stageBags.clear();let i=e.version===2?Vt(e):e.registry;i&&(this.host.ownsRegistry?s.load(i,{refit:!0}):s.load(i,{keepParked:!0,refit:!0})),this.host.sharedVisits.clear();for(let[o,a]of Object.entries(e.sharedVisits??{}))this.host.sharedVisits.set(o,a);this.host.sharedSelectors.clear();for(let[o,a]of nt(e.sharedSelectors))this.host.sharedSelectors.set(o,a);for(let[o,a]of Object.entries(e.flows)){let c=new O(o,this.host,this.defaultSeed);c.restore(a),this.flowsById.set(o,c)}this.host.reportRefits()}},O=class{id;host;local;registered=new Set;rngState;started=!1;flowEnded=!1;closed=!1;currentSceneId=null;stack=[];activeSnippet=null;beatIndex=0;pendingChoice=null;pendingPrompt=null;pendingPromptOwnerId=null;selectors=new Map;visitCounts=new Map;sceneBags=new Map;patterResolver={get:e=>this.host.patterSharedNames.has(e)?this.host.patterBag.get(e):this.local.get(e),set:(e,t)=>{this.host.patterSharedNames.has(e)?this.host.registry.set("patter",e,t):this.local.set(e,t)}};sceneResolver={get:e=>{let t=this.currentSceneId;if(t!==null)return this.sceneBagFor(t,e)?.get(e)},set:(e,t)=>{let n=this.currentSceneId;if(n===null)return;let s=this.sceneBagFor(n,e);s&&s.set(e,t)}};evalCtx;ctxRevision=-1;registryQualities;flowLog=[];flowSeq=0;constructor(e,t,n){this.id=e,this.host=t,this.rngState=T(n),this.local=this.newLocal(),this.evalCtx={scopes:{},host:{nextRandom:this.rng,visits:s=>this.visitCounts.get(s)??0,patterVisits:s=>this.host.sharedVisits.get(s)??0},qualities:(s,i)=>this.stagesFor(s,i)}}context(){let e=this.host.registry;if(e.revision!==this.ctxRevision){let t=e.toEvalContext(),n=this.evalCtx.scopes;for(let s of Object.keys(n))delete n[s];Object.assign(n,t.scopes),n.patter=this.patterResolver,n.scene=this.sceneResolver,this.registryQualities=t.qualities,this.ctxRevision=e.revision}return this.evalCtx}stagesFor(e,t){let n=t.toLowerCase();if(e==="patter")return _(this.host,"patter",()=>[...this.host.patterSharedDecls,...this.host.patterLocalDecls]).get(n);if(e==="scene"){let s=this.currentSceneId;return s==null?void 0:_(this.host,`scene/${s}`,()=>this.host.bundle.scenes[s]?.sceneProps).get(n)}return this.registryQualities?.(e,t)??_(this.host,`host/${e}`,()=>this.host.bundle.scopeRegistry?.scopes.find(s=>s.token===e)?.declarations).get(n)}begin(e,t){if(this.host.journal&&!this.host.journal.opened.has(this))throw new Error("a flow can\'t be started or reset while a checkpoint is open");if(this.releaseBags(!1),this.host.registry.discardParked(w.flow(this.id)),this.mountLocal(),this.selectors.clear(),this.visitCounts.clear(),this.stack=[],this.currentSceneId=null,this.flowEnded=!1,this.activeSnippet=null,this.beatIndex=0,this.clearPending(),this.started=!0,t){let n=this.host.blockIndex.get(t);if(!n)throw new Error(`unknown block: ${t}`);this.enterSceneSetup(n.sceneId),this.stack=[{sceneId:n.sceneId,containerId:t,index:0}],this.enter(t)}else{let n=e??Object.keys(this.host.bundle.scenes)[0],s=n?this.host.bundle.scenes[n]:void 0;if(!s)throw new Error(n?`unknown scene: ${n}`:"no scenes in bundle");this.enterSceneSetup(n);let i=s.blocks[0];i&&(this.stack=[{sceneId:n,containerId:i.id,index:0}],this.enter(i.id))}this.settle()}reset(e,t){this.begin(e,t)}start(e,t){this.reset(e,t)}goto(e,t){if(this.closed)return!1;if(this.touch(),e==="END")return this.started=!0,this.clearPending(),this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!0,this.stack=[],!0;let n=me(this.host,e);if(n===void 0)return!1;let s;return t!==void 0&&(s=ye(this.host,n,t),s===void 0)?!1:this.started?(this.clearPending(),this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!1,this.enterTarget(s??n,"jump"),this.settle(),!0):(this.begin(n,s),!0)}close(){this.releaseBags(!1),this.closed=!0,this.flowEnded=!0,this.stack=[],this.activeSnippet=null,this.beatIndex=0,this.clearPending()}clearPending(){this.pendingChoice=null,this.pendingPrompt=null,this.pendingPromptOwnerId=null}touch(){let e=this.host.journal;if(!e||e.flows.has(this))return;e.flows.add(this);let{rngState:t,started:n,flowEnded:s,currentSceneId:i,activeSnippet:o,beatIndex:a,pendingChoice:c,pendingPrompt:l,pendingPromptOwnerId:d}=this,h=this.stack.map(f=>({...f}));e.undo.push(()=>{Object.assign(this,{rngState:t,started:n,flowEnded:s,currentSceneId:i,activeSnippet:o,beatIndex:a,pendingChoice:c,pendingPrompt:l,pendingPromptOwnerId:d,stack:h})})}get isClosed(){return this.closed}get currentScene(){return this.currentSceneId}advance(){if(this.closed)return{type:"end"};if(!this.started)throw new Error("flow has not been started");if(this.touch(),this.pendingPrompt){let e=this.pendingPrompt;return this.pendingPrompt=null,this.pendingPromptOwnerId=null,e.shown?this.promptResult(e.beat,e.shown):this.beatResult(e.beat)}return this.settle(),this.flowEnded?{type:"end"}:this.pendingChoice?{type:"choice",groupId:this.pendingChoice.groupId,options:this.pendingChoice.options}:this.activeSnippet?this.beatResult(this.activeSnippet.beats[this.beatIndex++]):(this.flowEnded=!0,{type:"end"})}advanceToStop(){let e=[];for(;;){let t=this.advance();if(t.type==="choice"||t.type==="end")return{played:e,stop:t};e.push(t)}}settle(){let e=0;for(;;){if(++e>1e4)throw new Error("flow did not settle after 10000 transitions - likely a jump cycle with no deliverable content");if(this.flowEnded||this.pendingChoice)return;if(this.activeSnippet){if(this.beatIndex<(this.activeSnippet.beats?.length??0))return;this.runEffects(this.activeSnippet.onExit,this.activeSnippet.id);let i=this.activeSnippet.jump;this.activeSnippet=null,this.beatIndex=0,this.resolveJump(i);continue}let t=this.stack[this.stack.length-1];if(!t){this.flowEnded=!0;return}t.sceneId!==this.currentSceneId&&(this.currentSceneId=t.sceneId);let n=this.childrenOf(t.containerId);if(!n){this.stack.pop();continue}let s=t.index;for(;t.index<n.length&&!this.eligible(n[t.index]);)t.index++;if(this.host.tracing&&t.index!==s&&this.emit({type:"select",group:t.containerId,selector:"run",children:n.slice(s,t.index+1).map((i,o)=>({id:i.id,eligible:s+o===t.index})),picked:n[t.index]?.id??null}),t.index>=n.length){this.stack.pop();continue}this.enterChild(n[t.index++])}}listBags(){let e=[{bag:this.local,pathPrefix:`${this.id}/@patter.`}];for(let[t,n]of this.sceneBags)e.push({bag:n,pathPrefix:`${this.id}/@scene:${t}.`});return e}log(){return this.flowLog}clearLog(){this.flowLog.length=0}emit(e){let t=this.currentSceneId??void 0;this.host.emitEngine(this.id,e,t),this.host.logEnabled&&this.flowLog.push({...e,seq:this.flowSeq++,...t?{scene:t}:{}})}getVisitCounts(){return Object.fromEntries(this.visitCounts)}stepFor(e){let t=Ft(this.host.bundle).get(e);return t?this.beatResult(t):void 0}getChoices(){return this.pendingChoice?.options??[]}choose(e){let t=this.pendingChoice;if(!t)throw new Error("no choice is pending");let n=t.options.find(o=>o.id===e);if(!n)throw new Error(`unknown choice option: ${e}`);if(!n.eligible)throw new Error(`choice option is not eligible: ${e}`);this.touch();let s=t.byId.get(e);this.host.tracing&&this.emit({type:"chose",group:t.groupId,option:e}),this.pendingChoice=null;let i=this.host.replayPromptOnChoose?this.authoredPromptOf(s):void 0;this.pendingPrompt=i&&n.prompt?{beat:i,shown:{...n.prompt}}:null,this.pendingPromptOwnerId=this.pendingPrompt?s.id:null,this.enterChild(s)}isEnded(){return this.flowEnded}getProperty(e){let{scope:t,name:n}=this.splitRef(e);return t==="patter"?this.patterResolver.get(n):t==="scene"?this.sceneResolver.get(n):this.host.registry.get(t,n)}setProperty(e,t){this.writeProperty(e,t,!0)}stageIndex(e,t){return P(this.ladderOf(e),t)}compareStages(e,t,n){return N(this.ladderOf(e),t,n)}nextStage(e,t){return B(this.ladderOf(e),t)}ladderOf(e){let{scope:t,name:n}=this.splitRef(e);this.context();let s=this.stagesFor(t,n);if(!s)throw new Error(`\'${e}\' is not a quality`);return s}writeProperty(e,t,n){let{scope:s,name:i}=this.splitRef(e),o=this.host.journal;if(s==="patter"){if(o){let a=this.host.patterSharedNames.has(i),c=a?this.host.patterBag.get(i):this.local.get(i),l=this.local;c!==void 0&&o.undo.push(a?()=>this.host.registry.set("patter",i,c):()=>l.set(i,c))}this.patterResolver.set(i,t)}else if(s==="scene"){if(this.currentSceneId===null)throw new Error(`\'${e}\': the flow has not entered a scene yet`);if(o){let a=this.sceneBagFor(this.currentSceneId,i),c=a?.get(i);a&&c!==void 0&&o.undo.push(()=>a.set(i,c))}this.sceneResolver.set(i,t)}else{let a=o?this.host.registry.get(s,i):void 0;this.host.registry.set(s,i,t,n?{host:!0}:void 0),o&&a!==void 0&&o.undo.push(()=>this.host.registry.set(s,i,a,{host:!0}))}}snapshot(){return{rngState:this.rngState,visits:Object.fromEntries(this.visitCounts),cursor:{flowEnded:this.flowEnded,currentSceneId:this.currentSceneId,stack:this.stack.map(e=>{let t=this.childrenOf(e.containerId)?.[e.index];return t?{...e,nextId:t.id}:{...e}}),activeSnippetId:this.activeSnippet?.id??null,beatIndex:this.beatIndex,pendingChoice:this.pendingChoice?{groupId:this.pendingChoice.groupId,options:this.pendingChoice.options.map(({extensions:e,...t})=>({...t}))}:null,pendingPromptOwnerId:this.pendingPromptOwnerId,...this.pendingPrompt?.shown?{pendingPrompt:Lt(this.pendingPrompt.shown)}:{},selectors:tt(this.selectors)}}}restore(e){if(this.host.journal)throw new Error("a flow can\'t be restored while a checkpoint is open");this.restoreCursor(e),this.releaseBags(!0),this.mountLocal();for(let t of new Set([this.currentSceneId,...this.stack.map(n=>n.sceneId)]))t!==null&&this.host.bundle.scenes[t]&&this.ensureSceneBags(t)}restoreCursor(e){this.rngState=T(e.rngState),this.visitCounts=new Map(Object.entries(e.visits??{}));let t=e.cursor;if(this.started=!0,this.flowEnded=t.flowEnded,this.beatIndex=t.beatIndex,this.currentSceneId=t.currentSceneId,this.stack=t.stack.map(n=>{let{nextId:s,...i}=n;if(s!==void 0){let o=this.childrenOf(i.containerId)?.findIndex(a=>a.id===s)??-1;if(o>=0)return{...i,index:o}}return{...i}}),this.activeSnippet=null,t.activeSnippetId!==null){let n=this.host.nodeIndex.get(t.activeSnippetId);n&&n.type==="snippet"&&(this.activeSnippet=n)}if(this.selectors=nt(t.selectors),this.pendingChoice=null,t.pendingChoice!==null){let n=new Map,s=[];for(let i of t.pendingChoice.options){let o=this.host.nodeIndex.get(i.id);if(!o)continue;n.set(i.id,o);let{prompt:a,extensions:c,...l}=i,d=a?.kind==="line"&&a.speakerLabel===void 0?q(this.host,a.character,a.qualifier):void 0;s.push({...l,...a?{prompt:{...a,padAfter:a.padAfter??this.promptPadOf(o),...d!==void 0?{speakerLabel:d}:{}}}:{},...b(o.extensions)})}s.length>0&&(this.pendingChoice={groupId:t.pendingChoice.groupId,options:s,byId:n})}if(this.pendingPrompt=null,this.pendingPromptOwnerId=t.pendingPromptOwnerId??null,this.pendingPromptOwnerId){let n=this.host.nodeIndex.get(this.pendingPromptOwnerId),s=n?this.authoredPromptOf(n):void 0,i=t.pendingPrompt,o=i?.kind==="line"&&i.speakerLabel===void 0?q(this.host,i.character,i.qualifier):void 0;s?this.pendingPrompt={beat:s,...i?{shown:{...i,padAfter:i.padAfter??this.padOf(s.id),...o!==void 0?{speakerLabel:o}:{}}}:{}}:this.pendingPromptOwnerId=null}}enterSceneSetup(e){let t=this.host.bundle.scenes[e];if(!t)throw new Error(`unknown scene: ${e}`);this.currentSceneId=e,this.enter(e),this.seedScene(t),this.runEffects(t.onEntry,t.id)}enterChild(e){if(this.enter(e.id),e.type==="snippet"){this.beginSnippet(e);return}let t=e.selector??"run";if(t==="run"){this.stack.push({sceneId:this.currentSceneId,containerId:e.id,index:0});return}if(t==="choice"){this.setupChoice(e);return}let n=this.selectChild(e);n&&this.enterChild(n)}childrenOf(e){let t=this.host.blockById.get(e);if(t)return t.children;let n=this.host.nodeIndex.get(e);if(n&&n.type==="group")return n.children}beginSnippet(e){this.runEffects(e.onEnter,e.id),this.activeSnippet=e,this.beatIndex=0}setupChoice(e){let t=[],n=new Map,s=[];for(let o of e.children){if(o.fallback===!0){s.push(o);continue}if(o.sticky!==!0&&(this.visitCounts.get(o.id)??0)>=1)continue;let a=this.eligible(o),c=o.secretUntilEligible===!0;!a&&c||(t.push({id:o.id,prompt:this.promptFor(o),eligible:a,gameData:o.gameData,...b(o.extensions)}),n.set(o.id,o))}if(t.some(o=>o.eligible)){this.host.tracing&&this.emit({type:"choice",group:e.id,options:t.map(o=>({id:o.id,eligible:o.eligible}))}),this.pendingChoice={groupId:e.id,options:t,byId:n};return}let i=s.find(o=>this.eligible(o));if(i){this.enterChild(i);return}this.host.tracing&&this.emit({type:"dry",group:e.id}),this.host.onDryChoice?.(e.id)}resolveJump(e){e&&this.enterTarget(e.to,e.mode==="call"?"call":"jump")}enterTarget(e,t){if(this.host.tracing&&this.emit({type:"jump",to:e,mode:t}),e==="END"){this.flowEnded=!0,this.stack=[];return}let n,s,i=this.host.bundle.scenes[e];if(i){this.enterSceneSetup(e);let a=i.blocks[0];if(!a){t==="jump"&&(this.stack=[]);return}n=e,s=a.id}else{let a=this.host.blockIndex.get(e);if(!a)throw new Error(`jump target not found: ${e}`);a.sceneId!==this.currentSceneId&&this.enterSceneSetup(a.sceneId),n=a.sceneId,s=e}this.enter(s);let o={sceneId:n,containerId:s,index:0};t==="call"?this.stack.push(o):this.stack=[o]}selectChild(e){let t=e.children.map(c=>({id:c.id,eligible:this.eligible(c)})),n=e.children.filter((c,l)=>t[l].eligible),s=e.options?.order??"sequential",i=e.options?.exhaust??"once",o=c=>(this.host.tracing&&this.emit({type:"select",group:e.id,selector:e.selector??"default",...e.selector==="sequence"?{order:s,exhaust:i}:{},children:t,picked:c?.id??null}),c);if(n.length===0)return o(null);let a=this.selectorState(e);switch(e.selector){case"branch":return o(n[0]);case"sequence":return o(s==="shuffle"?this.pickShuffle(n,i,a):s==="specificity"?this.pickSpecificity(n,i,a):this.pickSequential(n,i,a));default:return null}}pickSequential(e,t,n){let s=e.length,i=n.seq??0;return n.seq=i+1,t==="repeat"?e[i%s]:i<s?e[i]:t==="stick"?e[s-1]:null}pickShuffle(e,t,n){let s=e.length,i=t==="stick",o=()=>(i?e.slice(0,s-1):e).map(f=>f.id),a=new Set(e.map(f=>f.id));if(n.bag===void 0&&(n.bag=o()),!n.bag.some(f=>a.has(f))){if(t==="once")return null;if(i){let f=e[s-1];return n.last=f.id,f}if(n.bag=o(),n.bag.length===0)return null}let c=n.bag.filter(f=>a.has(f)),l=n.last!==void 0&&c.length>1?c.indexOf(n.last):-1,d=Math.floor(this.rng()*(l>=0?c.length-1:c.length));l>=0&&d>=l&&d++;let h=c[d];return n.bag.splice(n.bag.indexOf(h),1),n.last=h,e.find(f=>f.id===h)}pickSpecificity(e,t,n){let s=e;if(t!=="repeat"){n.bag===void 0&&(n.bag=e.map(d=>d.id));let l=new Set(n.bag);if(s=e.filter(d=>l.has(d.id)),s.length===0)return t==="stick"&&n.last!==void 0?e.find(d=>d.id===n.last)??null:null}let i=-1,a=s.map(l=>{let d=this.specScore(l);return d>i&&(i=d),{c:l,s:d}}).filter(l=>l.s===i).map(l=>l.c),c;if(a.length===1)c=a[0];else{let l=n.last!==void 0?a.findIndex(h=>h.id===n.last):-1,d=Math.floor(this.rng()*(l>=0?a.length-1:a.length));l>=0&&d>=l&&d++,c=a[d]}return t!=="repeat"&&(n.bag=n.bag.filter(l=>l!==c.id)),n.last=c.id,c}specScore(e){return e.condition?this.matchedSpec(this.conditionAst(e.condition),!0,e):0}matchedSpec(e,t,n){return Ie(e,i=>{try{return et(J(i,this.context(),ge))}catch(o){return this.reportError("best-match",n.id,n.condition,o),!1}},{want:t})}selectorState(e){let t=e.shared?this.host.sharedSelectors:this.selectors,n=this.host.journal,s;if(n&&(s=e.shared?n.selectors:n.flowSelectors.get(this),s||(s=new Set,n.flowSelectors.set(this,s))),n&&s&&!s.has(e.id)){s.add(e.id);let o=t.get(e.id),a=o?{...o,...o.bag?{bag:[...o.bag]}:{}}:void 0;n.undo.push(()=>{a?t.set(e.id,a):t.delete(e.id)})}let i=t.get(e.id);return i||(i={},t.set(e.id,i)),i}runEffects(e,t){for(let n of e??[]){let s;try{s=this.evalExpr(n.value);let i=this.host.tracing?this.getProperty(n.target):void 0;this.writeProperty(n.target,s,!1),this.host.tracing&&this.emit({type:"write",target:n.target,value:s,...i!==void 0?{prev:i}:{}})}catch(i){this.reportError("effect",t,n.value,i)}}}eligible(e){if(!e.condition)return!0;try{return et(this.evalExpr(e.condition))}catch(t){return this.reportError("condition",e.id,e.condition,t),!1}}reportError(e,t,n,s){let i=s instanceof Error?s.message:String(s),o=n?.src;this.host.onError({flow:this.id,kind:e,node:t,...o?{source:o}:{},message:i}),this.host.tracing&&this.emit({type:"diagnostic",kind:e,node:t,...o?{source:o}:{},message:i})}evalExpr(e){return J(this.conditionAst(e),this.context(),ge)}conditionAst(e){let t=He.get(e);return t||(t=R(e.ast),He.set(e,t)),t}enter(e){let t=this.visitCounts,n=t.get(e);t.set(e,(n??0)+1);let s=this.host.sharedVisits,i=s.get(e);s.set(e,(i??0)+1),this.host.journal&&this.host.journal.undo.push(()=>{n===void 0?t.delete(e):t.set(e,n),i===void 0?s.delete(e):s.set(e,i)})}rng=()=>{if(this.host.customRng)return this.host.customRng();let e=ce(this.rngState),t=e.next();return this.rngState=e.state(),t};beatResult(e){let t=I(this.host,e.id),n=t&&t.length?{tags:t}:{};switch(e.kind){case"gameEvent":return{type:"gameEvent",id:e.id,gameData:e.gameData,...b(e.extensions),...n};case"text":return{type:"text",id:e.id,text:this.interpolate(this.resolveString(e.id)),padAfter:this.padOf(e.id),...e.action?{action:!0}:{},gameData:e.gameData,...b(e.extensions),...n};case"line":{let s=this.resolveString(e.id),i=!this.host.captionsOn,a=i&&e.character===this.host.captionCharacter?"":this.captionLine(this.host.bundle.voiced?s:this.interpolate(s)),c=i&&a.length===0;return{type:"line",id:e.id,text:a,character:c?void 0:e.character,characterName:c?void 0:this.resolveCharacterName(e.character),direction:c?void 0:e.direction,qualifier:c?void 0:e.qualifier,qualifierName:c?void 0:this.resolveQualifierName(e.qualifier),speakerLabel:c?void 0:q(this.host,e.character,e.qualifier),padAfter:this.padOf(e.id),gameData:e.gameData,...b(e.extensions),...n}}}}interpolate(e){return Le(e,t=>this.getProperty(t))}stripCaptions(e){return Te(e,this.host.captionOpen,this.host.captionClose)}captionLine(e){return this.host.captionsOn?e:this.stripCaptions(e)}promptFor(e){let t=this.promptBeatOf(e);if(!t)return;let n=this.interpolate(this.resolveString(t.id)),s=this.padOf(t.id);return t.kind==="line"?{kind:"line",text:this.captionLine(n),character:t.character,characterName:this.resolveCharacterName(t.character),direction:t.direction,qualifier:t.qualifier,qualifierName:this.resolveQualifierName(t.qualifier),speakerLabel:q(this.host,t.character,t.qualifier),padAfter:s}:{kind:"text",text:n,padAfter:s}}authoredPromptOf(e){return e.type==="group"?e.prompt:void 0}promptResult(e,t){let n=I(this.host,e.id),s=n&&n.length?{tags:n}:{};return t.kind==="text"?{type:"text",id:e.id,text:t.text,padAfter:this.padOf(e.id),gameData:e.gameData,...b(e.extensions),...s}:{type:"line",id:e.id,text:t.text,character:t.character,characterName:t.characterName,direction:t.direction,qualifier:t.qualifier,qualifierName:t.qualifierName,speakerLabel:t.speakerLabel,padAfter:this.padOf(e.id),gameData:e.gameData,...b(e.extensions),...s}}promptBeatOf(e){return e.type==="group"&&e.prompt?e.prompt:((e.type==="snippet"?e:this.firstTextSnippetIn(e.children))?.beats??[]).find(n=>n.kind==="line"||n.kind==="text")}firstTextSnippetIn(e){let t;return C(e,n=>{!t&&n.type==="snippet"&&(n.beats??[]).some(s=>s.kind==="line"||s.kind==="text")&&(t=n)}),t}resolveString(e){if(this.host.emitIds)return e;let t=this.host.strings[e];if(t!==void 0)return t;let n=this.host.defaultStrings[e];return n!==void 0?`<Untranslated: ${e}> ${n}`:e}resolveCharacterName(e){if(e===void 0||this.host.emitIds)return;let t=ee(e);return this.host.strings[t]??this.host.defaultStrings[t]??this.host.castDisplay.get(e)}promptPadOf(e){let t=this.promptBeatOf(e);return t?this.padOf(t.id):E}padOf(e){return this.host.padIndex.get(e)?.resolved??E}resolveQualifierName(e){if(e===void 0||this.host.emitIds)return;let t=te(e);return this.host.strings[t]??this.host.defaultStrings[t]??this.host.qualifierDisplay.get(e)}splitRef(e){return st(this.host,e)}newLocal(){return new k(this.host.patterLocalDecls,{pathPrefix:"@patter."})}mountLocal(){this.local=this.newLocal();let e=w.flowGlobals(this.id);this.host.registry.mountOwned(e,this.local,{owner:$}),this.registered.add(e),this.host.reportRefits()}releaseBags(e){for(let t of this.registered)this.host.registry.remove(t,{keep:e});this.registered.clear(),this.sceneBags.clear()}sceneBagFor(e,t){if(this.host.bundle.scenes[e])return this.ensureSceneBags(e),this.host.sceneSharedNames.get(e)?.has(t.toLowerCase())?this.host.stageBags.get(e):this.sceneBags.get(e)}ensureSceneBags(e){let t=this.host.sceneSharedNames.get(e)??new Set,n=this.host.bundle.scenes[e]?.sceneProps??[],s=this.host.journal,i=!this.sceneBags.has(e)||!this.host.stageBags.has(e);if(!this.sceneBags.has(e)){let o=new k(n.filter(l=>!t.has(l.name.toLowerCase())),{pathPrefix:"@scene."}),a=w.flowScene(this.id,e),c=Ye(this.host.registry,a,o,s!==null);this.registered.add(a),this.sceneBags.set(e,o),s&&s.undo.push(()=>{this.sceneBags.get(e)===o&&(this.host.registry.remove(a,c?{keep:!0}:void 0),this.registered.delete(a),this.sceneBags.delete(e))})}if(!this.host.stageBags.has(e)){let o=new k(n.filter(c=>t.has(c.name.toLowerCase())),{pathPrefix:"@scene."}),a=Ye(this.host.registry,w.stage(e),o,s!==null);this.host.stageBags.set(e,o),s&&s.undo.push(()=>{this.host.stageBags.get(e)===o&&(this.host.registry.remove(w.stage(e),a?{keep:!0}:void 0),this.host.stageBags.delete(e))})}i&&this.host.reportRefits()}seedScene(e){let t=this.host.sceneSharedNames.get(e.id)??new Set;this.ensureSceneBags(e.id);for(let n of e.sceneProps??[]){if(!n.temporary)continue;let s=n.name.toLowerCase(),i=t.has(s)?this.host.stageBags.get(e.id):this.sceneBags.get(e.id);if(!i)continue;let o=this.host.journal?i.get(s):void 0;o!==void 0&&this.host.journal.undo.push(()=>i.set(s,o)),i.set(s,A(n))}}};function Qe(r,e){C(r,t=>{if(t.type==="group"){t.prompt?.kind==="line"&&t.prompt.character&&e.add(t.prompt.character);return}for(let n of t.beats??[])n.kind==="line"&&n.character&&e.add(n.character)})}function q(r,e,t,n=!1){if(!e||r.emitIds)return;let s=c=>(n?void 0:r.strings[c])??r.defaultStrings[c],i=s(ee(e))??r.castDisplay.get(e)??e;if(t===void 0)return i;let o=r.speakerLabels.get(`${e}\\0${t}`);if(o!==void 0)return s(je(e,t))??o;let a=s(te(t))??r.qualifierDisplay.get(t)??t;return Ge(s(Me)??r.speakerPattern,i,a)}function ze(r){return r&&Object.keys(r).length?{gameData:r}:{}}function b(r){return r&&Object.keys(r).length?{extensions:r}:{}}function Lt(r){let e={kind:r.kind,text:r.text};return r.character!==void 0&&(e.character=r.character),r.characterName!==void 0&&(e.characterName=r.characterName),r.direction!==void 0&&(e.direction=r.direction),r.qualifier!==void 0&&(e.qualifier=r.qualifier),r.qualifierName!==void 0&&(e.qualifierName=r.qualifierName),r.speakerLabel!==void 0&&(e.speakerLabel=r.speakerLabel),typeof r.padAfter=="number"&&(e.padAfter=r.padAfter),e}function tt(r){let e={};for(let[t,n]of r){let s={};n.seq!==void 0&&(s.seq=n.seq),n.bag&&(s.bag=[...n.bag]),n.last!==void 0&&(s.last=n.last),e[t]=s}return e}function nt(r){let e=new Map;for(let[t,n]of Object.entries(r??{})){let s={};n.seq!==void 0&&(s.seq=n.seq),n.bag&&(s.bag=[...n.bag]),n.last!==void 0&&(s.last=n.last),e.set(t,s)}return e}function Ye(r,e,t,n){let s=n?JSON.stringify(t.save()):"";return r.mountOwned(e,t,{owner:$}),n&&JSON.stringify(t.save())!==s}function Xe(r){return{name:r.name,type:r.type,values:r.values,stages:r.stages,default:r.default}}function Ze(r){return{...r.world?{world:r.world}:{},...r.hostScopes}}function _(r,e,t){let n=r.qualityLadders.get(e);if(!n){n=new Map;for(let s of t()??[]){let i=s.name.toLowerCase();s.type==="quality"&&s.stages&&!n.has(i)&&n.set(i,s.stages)}r.qualityLadders.set(e,n)}return n}function jt(r,e,t){let n=t.toLowerCase();return e==="patter"?_(r,"patter",()=>[...r.patterSharedDecls,...r.patterLocalDecls]).get(n):r.registry.toEvalContext().qualities?.(e,t)??_(r,`host/${e}`,()=>r.bundle.scopeRegistry?.scopes.find(s=>s.token===e)?.declarations).get(n)}function rt(r){return{name:r.name,type:r.type,values:r.values,stages:r.stages,default:r.default,writable:r.writable}}function Mt(r,e){let t=rt(r),n=r.writable??e;return n===void 0?t:{...t,writable:n}}function me(r,e){return Z(r.bundle.scenes,e,r.sceneGameIdToId)}function ye(r,e,t){return r.blockGameIdToId.get(e)?.get(t)??(r.blockIndex.get(t)?.sceneId===e?t:void 0)}function st(r,e){r.refSplitRevision!==r.registry.revision&&(r.refSplitCache.clear(),r.refSplitRevision=r.registry.revision);let t=r.refSplitCache.get(e);return t||(t=Fe(e,n=>n==="scene"||r.registry.has(n)||(r.bundle.externalScopes?.includes(n)??!1)),r.refSplitCache.set(e,t)),t}function Vt(r){let e={};r.shared?.patter&&(e.patter=r.shared.patter);for(let[t,n]of Object.entries(r.stageBags??{}))e[w.stage(t)]=n;for(let[t,n]of Object.entries(r.flows??{}))Object.assign(e,it(t,n));return e}function it(r,e){let t={};e.scopes?.patter&&(t[w.flowGlobals(r)]=e.scopes.patter);for(let[n,s]of Object.entries(e.sceneBags??{}))t[w.flowScene(r,n)]=s;return t}function Gt(r,e){let t={scopes:{},sceneBags:{}},n=w.flow(r);for(let[s,i]of Object.entries(e)){if(!s.startsWith(n))continue;let o=s.slice(n.length);o==="patter"?t.scopes.patter=i:o.startsWith("scene/")&&(t.sceneBags[Tt(o.slice(6))]=i)}return t}function et(r){return typeof r=="boolean"?r:typeof r=="number"?r!==0:typeof r=="string"?r!=="":r.length>0}var qt=(r,e)=>r.shared??e;function Se(r,e){return{name:r.name,type:r.type,hasDefault:r.default!==void 0,...r.default!==void 0?{default:r.default}:{},shared:qt(r,e)}}function $t(r){return{name:r.name,type:r.type,hasDefault:r.default!==void 0,...r.values?{values:[...r.values]}:{},...r.purpose?{purpose:r.purpose}:{}}}function _t(r,e){e.blocks++;let t=[...r.children];for(;t.length;){let n=t.pop();if(n.type==="group"){e.groups++,n.prompt&&e.prompts++,t.push(...n.children);continue}e.snippets++;for(let s of n.beats??[])e.beats++,s.kind==="gameEvent"&&e.gameEvents++}}function ot(r){let e={scenes:0,blocks:0,groups:0,snippets:0,beats:0,prompts:0,gameEvents:0,cast:r.cast?.length??0},t=[],n=[];for(let o of Object.values(r.scenes)){e.scenes++;let a=m(o);t.push({gameId:a,name:o.name,blocks:o.blocks.map(c=>({gameId:m(c),name:c.name}))});for(let c of o.blocks)_t(c,e);o.sceneProps?.length&&n.push({gameId:a,properties:o.sceneProps.map(c=>Se(c,!1))})}let s=(r.scopeRegistry?.scopes??[]).map(o=>({token:o.token,writable:o.writable??!0,opaque:o.declarations===void 0,properties:(o.declarations??[]).map(a=>Se(a,!0))})),i=Object.entries(r.gameDataFields??{}).filter(([,o])=>(o?.length??0)>0).map(([o,a])=>({kind:o,fields:(a??[]).map($t)}));return{identity:{schema:r.schema,project:r.content.project,...r.content.version!==void 0?{version:r.content.version}:{},...r.content.hash!==void 0?{hash:r.content.hash}:{},...r.content.structureHash!==void 0?{structureHash:r.content.structureHash}:{},voiced:r.voiced,defaultLocale:r.locales.default,locales:[...r.locales.included],localisation:r.localisation?.mode??"embedded",sourceDebug:r.localisation?.sourceDebug??!1},addresses:t,hostScopes:s,properties:{patter:(r.properties??[]).map(o=>Se(o,!0)),scene:n},gameData:i,counts:e}}var U=(r,e)=>Object.prototype.hasOwnProperty.call(r,e);function at(r,e){return r.gameDataFields?.[e]??[]}function we(r,e,t){return e&&U(e,t)?e[t]:r.find(n=>n.name===t)?.default}function ct(r,e){let t={};for(let n of r){let s=we(r,e,n.name);s!==void 0&&(t[n.name]=s)}for(let[n,s]of Object.entries(e??{}))U(t,n)||(t[n]=s);return t}function lt(r,e,t){let n=r.extensions!==void 0&&U(r.extensions,e)?r.extensions[e]:void 0;return n!==void 0&&U(n.fields,t)?n.fields[t]??[]:[]}function dt(r,e,t=""){let n=o=>({...o?.extensions??{}}),s=Object.values(r.scenes??{}),i=o=>(U(r.scenes??{},o)?r.scenes[o]:void 0)??s.find(a=>m(a)===o);switch(e){case"project":{let o={};for(let[a,c]of Object.entries(r.extensions??{}))c.project!==void 0&&(o[a]=c.project);return o}case"scene":return n(i(t));case"block":{let o=t.indexOf("/");if(o<0)return{};let a=i(t.slice(0,o))?.blocks??[],c=t.slice(o+1);return n(a.find(l=>l.id===c)??a.find(l=>m(l)===c))}case"snippet":case"option":case"line":case"text":case"gameEvent":{let o,a=(c,l)=>{for(let d of c??[]){if(o!==void 0)return;if(d.type==="group"){if(l&&d.id===t&&e==="option"){o=d;return}if(l&&d.prompt?.id===t&&d.prompt.kind===e){o=d.prompt;return}a(d.children??[],d.selector==="choice");continue}if(d.id===t&&e==="snippet"){o=d;return}let h=(d.beats??[]).find(f=>f.id===t);if(h!==void 0){h.kind===e&&(o=h);return}}};for(let c of s)for(let l of c.blocks??[])o===void 0&&a(l.children??[],!1);return n(o)}default:return{}}}return wt(Ht);})();\n';
+var PLAYABLE_RUNTIME_JS = 'var Patterplay=(()=>{var de=Object.defineProperty;var vt=Object.getOwnPropertyDescriptor;var xt=Object.getOwnPropertyNames;var kt=Object.prototype.hasOwnProperty;var Et=(r,e)=>{for(var t in e)de(r,t,{get:e[t],enumerable:!0})},Ct=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of xt(e))!kt.call(r,s)&&s!==t&&de(r,s,{get:()=>e[s],enumerable:!(n=vt(e,s))||n.enumerable});return r};var Dt=r=>Ct(de({},"__esModule",{value:!0}),r);var Zt={};Et(Zt,{Checkpoint:()=>K,DEFAULT_PAD_AFTER:()=>O,Engine:()=>ae,Flow:()=>N,buildTagIndex:()=>ie,compareStages:()=>B,describeBundle:()=>ut,effectiveGameData:()=>ft,extensionDecls:()=>ht,extensionsOf:()=>mt,gameDataFields:()=>gt,gameDataValue:()=>ke,nextStage:()=>F,resolveSceneRef:()=>ne,sceneAddressIndex:()=>ye,stageIndex:()=>A});function j(r,e){return r!==void 0&&Object.prototype.hasOwnProperty.call(r,e)?r[e]:void 0}function I(r){switch(r[0]){case"b":return{kind:"bool",value:r[1]};case"n":return{kind:"number",value:r[1]};case"s":return{kind:"string",value:r[1]};case"sv":return{kind:"scopedvar",scope:r[1],name:r[2]};case"u":return{kind:"unary",op:r[1],operand:I(r[2])};case"bin":return{kind:"binary",op:r[1],left:I(r[2]),right:I(r[3])};case"call":{let e=r.slice(2).map(I);return{kind:"call",name:r[1],args:e}}case"fd":return{kind:"flagdelta",sign:r[1],name:r[2]}}}var u=class extends Error{constructor(e){super(e),this.name="EvalError"}};function Y(r,e,t){let n=new Map(t.scopes.map(i=>[i.token,i.missing??"false"])),s=i=>{switch(i.kind){case"bool":return i.value;case"number":return i.value;case"string":return i.value;case"scopedvar":{let o=j(e.scopes,i.scope);if(o===void 0)return!1;let a=typeof o.get=="function"?o.get(i.name):j(o,i.name);if(a===void 0){if(n.get(i.scope)==="throw")throw new u(`@${i.scope}.${i.name} is not declared on the current ${i.scope}.`);return!1}return a}case"call":{if(i.name==="advance"&&!j(t.functions,i.name)){let a=i.args[0];if(i.args.length!==1||a===void 0)throw new u(`advance() takes exactly 1 argument, got ${i.args.length}`);let c=pe(a,e);if(c===void 0)throw new u("advance() needs a quality reference (@scope.name of a quality property)");let l=v(s(a),c,"advance");return c[Math.min(l+1,c.length-1)]}let o=j(t.functions,i.name);if(!o)throw new u(`unknown function \'${i.name}\'`);return o.eval(i.args,{evaluate:s,ctx:e})}case"flagdelta":throw new u("flagdelta node is only valid as an argument to a flag-delta function");case"unary":{if(i.op==="not"){let a=s(i.operand);if(typeof a!="boolean")throw new u(`\'not\' requires a boolean operand, got ${typeof a}`);return!a}let o=s(i.operand);if(typeof o!="number")throw new u(`unary \'-\' requires a numeric operand, got ${typeof o}`);return-o}case"binary":{if(i.op==="and"){let g=s(i.left);if(typeof g!="boolean")throw new u(`\'and\' requires boolean operands, left is ${typeof g}`);if(!g)return!1;let f=s(i.right);if(typeof f!="boolean")throw new u(`\'and\' requires boolean operands, right is ${typeof f}`);return f}if(i.op==="or"){let g=s(i.left);if(typeof g!="boolean")throw new u(`\'or\' requires boolean operands, left is ${typeof g}`);if(g)return!0;let f=s(i.right);if(typeof f!="boolean")throw new u(`\'or\' requires boolean operands, right is ${typeof f}`);return f}let o=s(i.left),a=s(i.right),c=pe(i.left,e),l=pe(i.right,e),d=c??l;if(d!==void 0){if(c&&l&&!It(c,l)&&(i.op===">"||i.op===">="||i.op==="<"||i.op==="<="))throw new u(`\'${i.op}\' compares two different qualities, whose stage orders are unrelated`);switch(i.op){case">":return v(o,d,">")>v(a,d,">");case">=":return v(o,d,">=")>=v(a,d,">=");case"<":return v(o,d,"<")<v(a,d,"<");case"<=":return v(o,d,"<=")<=v(a,d,"<=");case"+":case"-":case"*":case"/":throw new u(`\'${i.op}\' cannot be applied to a quality - a stage is a position, not a number; use advance() to move it`);default:break}}switch(i.op){case"==":return Pe(o,a);case"!=":return!Pe(o,a);case">":return R(o,a,">"),o>a;case">=":return R(o,a,">="),o>=a;case"<":return R(o,a,"<"),o<a;case"<=":return R(o,a,"<="),o<=a;case"+":if(typeof o=="number"&&typeof a=="number"||typeof o=="string"&&typeof a=="string")return o+a;throw new u(`\'+\' requires two numbers or two strings, got ${typeof o} and ${typeof a}`);case"-":return R(o,a,"-"),o-a;case"*":return R(o,a,"*"),o*a;case"/":if(R(o,a,"/"),a===0)throw new u("division by zero");return o/a}}}};return s(r)}function Pe(r,e){if(Array.isArray(r)||Array.isArray(e)){if(!Array.isArray(r)||!Array.isArray(e)||r.length!==e.length)return!1;let t=[...r].sort(),n=[...e].sort();for(let s=0;s<t.length;s++)if(t[s]!==n[s])return!1;return!0}return r===e}function R(r,e,t){if(typeof r!="number"||typeof e!="number")throw new u(`\'${t}\' requires numeric operands, got ${typeof r} and ${typeof e}`)}function pe(r,e){if(!(r.kind!=="scopedvar"||e.qualities===void 0))return e.qualities(r.scope,r.name)}function v(r,e,t){if(typeof r!="string")throw new u(`\'${t}\' on a quality compares stages, got ${typeof r}`);let n=e.indexOf(r);if(n<0)throw new u(`"${r}" is not a stage of this quality (stages: ${e.join(", ")})`);return n}var It=(r,e)=>r.length===e.length&&r.every((t,n)=>t===e[n]);function M(r){if(Number.isNaN(r)||!Number.isFinite(r))return 0;let e=Math.trunc(r)%4294967296;return e<0?e+4294967296:e}function ue(r){let e=M(r);return{next(){e=e+1831565813>>>0;let t=Math.imul(e^e>>>15,1|e);return t=t+Math.imul(t^t>>>7,61|t)^t,((t^t>>>14)>>>0)/4294967296},state(){return e}}}var fe=r=>Array.isArray(r)?r:r.stages??[],Rt=r=>Array.isArray(r)?"flags":r==null?"nothing":typeof r;function A(r,e){return typeof e=="string"?fe(r).indexOf(e):-1}function ge(r,e){if(typeof e!="string")throw new u(`a stage is a name, got ${Rt(e)}`);let t=r.indexOf(e);if(t<0)throw new u(`"${e}" is not a stage of this quality (stages: ${r.join(", ")})`);return t}function B(r,e,t){let n=fe(r),s=ge(n,e)-ge(n,t);return s<0?-1:s>0?1:0}function F(r,e){let t=fe(r);return t[Math.min(ge(t,e)+1,t.length-1)]}function $(r,e,t){switch(r.type){case"boolean":return typeof e=="boolean";case"number":return typeof e=="number";case"string":case"text":case"multiline":return typeof e=="string";case"enum":return typeof e!="string"?!1:e===""&&t?.noneChosen?!0:!Array.isArray(r.values)||r.values.includes(e);case"flags":return Array.isArray(e)&&e.every(n=>typeof n=="string"&&(!Array.isArray(r.values)||r.values.includes(n)));case"quality":return typeof e=="string"&&(!Array.isArray(r.stages)||r.stages.includes(e));default:return!0}}var Ot={name:"check_flags",count:r=>Math.max(1,r.args.length-1)},Pt=[Ot];function Ne(r,e,t){let n=t?.countingCalls??Pt;return X(r,t?.want??!0,e,n)}function X(r,e,t,n){if(r.kind==="binary"&&(r.op==="and"||r.op==="or")){let s=X(r.left,e,t,n),i=X(r.right,e,t,n);return r.op==="and"===e?s>0&&i>0?s+i:0:Math.max(s,i)}if(r.kind==="unary"&&r.op==="not")return X(r.operand,!e,t,n);if(r.kind==="call"){let s=n.find(i=>i.name===r.name);if(s){let i=s.count(r),o=t(r);return e?o?i:0:o?0:1}}return t(r)===e?1:0}var E=class r{values=Object.create(null);decls=new Map;subscribers=new Set;auditors=new Set;norm;pathPrefix;constructor(e=[],t){this.norm=t?.normalise??(n=>n.toLowerCase()),this.pathPrefix=t?.pathPrefix??"",this.seed(e)}seed(e){for(let t of e){let n=this.norm(t.name);this.decls.set(n,t),this.values[n]=structuredClone(t.default??L(t))}}get(e){return this.values[this.norm(e)]}normalise(e){return this.norm(e)}writable(e){return this.decls.get(this.norm(e))?.writable!==!1}set(e,t,n){let s=this.norm(e);if(!n?.host&&!this.writable(s))throw new Error(`\'${e}\' is read-only`);let i={name:s,prev:this.values[s],next:t,silent:n?.silent??!1,reason:n?.reason};this.values[s]=t;for(let o of[...this.auditors])o(i);if(!i.silent)for(let o of[...this.subscribers])o(i);return i}subscribe(e){return this.subscribers.add(e),()=>this.subscribers.delete(e)}onAudit(e){return this.auditors.add(e),()=>this.auditors.delete(e)}rows(){return[...this.decls.entries()].map(([e,t])=>Be(t,this.get(e),void 0,e,this.pathPrefix))}declarations(){return[...this.decls.values()]}clone(){let e=new r([],{normalise:this.norm,pathPrefix:this.pathPrefix});return e.decls=new Map(this.decls),Object.assign(e.values,structuredClone(this.values)),e}reseed(e){for(let t of Object.keys(this.values))delete this.values[t];this.decls.clear(),this.seed(e)}save(){return structuredClone(this.values)}load(e,t){let n=new Map;for(let[i,o]of Object.entries(e)){let a=this.norm(i);this.values[a]=structuredClone(o),n.set(a,o)}let s=[];if(!t?.refit)return s;for(let[i,o]of this.decls){if(!n.has(i))continue;let a=n.get(i);$(o,a,{noneChosen:o.type==="enum"&&o.default===""})||(this.values[i]=structuredClone(L(o)),s.push({name:i,value:a}))}return s}};function Be(r,e,t,n,s=""){let i=n??r.name.toLowerCase();return{name:i,path:s+i,type:r.type,value:e,default:r.default??L(r),...r.values!==void 0?{values:r.values}:{},...r.stages!==void 0?{stages:r.stages}:{},writable:t??r.writable??!0}}var Nt=r=>r.toLowerCase(),he=1,Z=class{scopes=new Map;parked=new Map;parkedRefit=new Set;misfits=[];rev=0;get revision(){return this.rev}defineOwned(e,t,n){let s=typeof n=="string"?{pathPrefix:n}:n??{},i=new E(t,{pathPrefix:s.pathPrefix??`${e}.`,...s.normalise?{normalise:s.normalise}:{}});return this.mountOwned(e,i,s.owner!==void 0?{owner:s.owner}:void 0)}mountOwned(e,t,n){this.assertFree(e,n?.owner),this.scopes.set(e,{kind:"owned",bag:t,...n?.owner!==void 0?{owner:n.owner}:{}}),this.rev++;let s=this.parked.get(e);return s&&(this.note(e,t.load(s,{refit:this.parkedRefit.has(e)})),this.parked.delete(e),this.parkedRefit.delete(e)),this}remove(e,t){let n=this.scopes.get(e);if(!n)throw new Error(`unknown scope \'@${e}\'`);return t?.keep&&n.kind==="owned"&&(this.parked.set(e,n.bag.save()),this.parkedRefit.delete(e)),this.scopes.delete(e),this.rev++,this}discardParked(e){if(e===void 0)this.parked.clear(),this.parkedRefit.clear();else for(let t of[...this.parked.keys()])t.startsWith(e)&&(this.parked.delete(t),this.parkedRefit.delete(t));return this}takeMisfits(e){if(!e){let n=this.misfits;return this.misfits=[],n}let t=this.misfits.filter(n=>e(n.scope));return this.misfits=this.misfits.filter(n=>!e(n.scope)),t}note(e,t){for(let n of t)this.misfits.push({scope:e,name:n.name,value:n.value})}ownedBag(e){let t=this.scopes.get(e);if(!t||t.kind!=="owned")throw new Error(`\'@${e}\' is not an owned scope`);return t.bag}reseedOwned(e,t){return this.ownedBag(e).reseed(t),this}defineForeign(e,t,n=[],s=!0){let i=typeof s=="boolean"?{writable:s}:s;this.assertFree(e,i.owner);let o=i.normalise??Nt,a=new Map;for(let c of n)a.set(o(c.name),c);return this.scopes.set(e,{kind:"foreign",resolver:t,decls:a,scopeWritable:i.writable??!0,norm:o,...i.owner!==void 0?{owner:i.owner}:{}}),this.rev++,this}has(e){return this.scopes.has(e)}get(e,t){let n=this.scopes.get(e);if(n)return n.kind==="owned"?n.bag.get(t):n.resolver.get(n.norm(t))}set(e,t,n,s){let i=this.scopes.get(e);if(!i)throw new Error(`unknown scope \'@${e}\'`);if(i.kind==="owned"){if(!s?.host&&!i.bag.writable(t))throw new Error(`\'@${e}.${t}\' is read-only`);i.bag.set(t,n,s?.host?{host:!0}:void 0);return}let o=i.norm(t);if(!i.resolver.set)throw new Error(`\'@${e}.${t}\' is read-only`);if(!s?.host&&!this.foreignWritable(i,o))throw new Error(`\'@${e}.${t}\' is read-only`);i.resolver.set(o,n)}foreignWritable(e,t){return e.resolver.set?e.decls.get(t)?.writable??e.scopeWritable:!1}listProperties(){let e=[];for(let[t,n]of this.scopes){let s=n.owner!==void 0?{owner:n.owner}:{};if(n.kind==="owned")for(let i of n.bag.rows())e.push({scope:t,...s,...i});else for(let[i,o]of n.decls)e.push({scope:t,...s,...Be(o,n.resolver.get(i),this.foreignWritable(n,i),i,`${t}.`)})}return e}toEvalContext(e,t){let n=this.view(t?.aliases),s={};for(let[o,a]of n)s[o]=a.kind==="owned"?a.bag.values:a.resolver;let i=this.qualityLadders(n);return i.size===0?{scopes:s,host:e}:{scopes:s,host:e,qualities:(o,a)=>{let c=n.get(o);return c?i.get(o)?.get(At(c)(a)):void 0}}}view(e){let t=new Map(this.scopes);for(let[n,s]of Object.entries(e??{})){let i=this.scopes.get(s);if(!i)throw new Error(`alias \'@${n}\' names \'${s}\', which is not registered`);t.set(n,i)}return t}qualityLadders(e){let t=new Map;for(let[n,s]of e)for(let[i,o]of Ae(s)){if(o.type!=="quality"||o.stages===void 0)continue;let a=t.get(n);a||(a=new Map,t.set(n,a)),a.set(i,o.stages)}return t}toSchema(e){let t=new Map;for(let[n,s]of this.view(e?.aliases)){let i=Ae(s);if(i.length===0)continue;let o=new Map;for(let[a,c]of i)o.set(a,{type:c.type,enumValues:c.values,...c.stages!==void 0?{stages:c.stages}:{}});t.set(n,o)}return{properties:t}}save(){let e={};for(let[t,n]of this.scopes)n.kind==="owned"&&(e[t]=n.bag.save());for(let[t,n]of this.parked)e[t]=structuredClone(n);return e}load(e,t){t?.keepParked||(this.parked.clear(),this.parkedRefit.clear());let n=t?.refit===!0;for(let[s,i]of Object.entries(e)){let o=this.scopes.get(s);o?.kind==="owned"?this.note(s,o.bag.load(i,{refit:n})):o||(this.parked.set(s,structuredClone(i)),n?this.parkedRefit.add(s):this.parkedRefit.delete(s))}}saveFragment(){return{version:he,scopes:this.save()}}loadFragment(e){if(e.version!==he)throw new Error(`unsupported owned-state fragment version ${e.version} (supported: ${he})`);this.load(e.scopes)}assertFree(e,t){let n=this.scopes.get(e);if(!n)return;let s=n.owner!==void 0?` by ${n.owner}`:"",i=t!==void 0?` (wanted by ${t})`:"";throw new Error(`scope \'@${e}\' is already registered${s}${i}`)}};function Ae(r){return r.kind==="foreign"?[...r.decls.entries()]:r.bag.declarations().map(e=>[r.bag.normalise(e.name),e])}function At(r){return r.kind==="foreign"?r.norm:e=>r.bag.normalise(e)}function L(r){if(r.default!==void 0)return r.default;switch(r.type){case"boolean":return!1;case"number":return 0;case"string":case"text":case"multiline":return"";case"enum":return r.values?.[0]??"";case"flags":return[];case"quality":return r.stages?.[0]??"";default:return!1}}var Fe=[{token:"patter",engine:"Patterplay",means:"Patter\'s shared globals"},{token:"story",engine:"Storylet Engine",means:"the Storylet Engine\'s shared @story properties"}];function G(r){return r.ctx.host??{}}var me={defaultScope:"patter",scopes:[{token:"patter"},{token:"scene"}],functions:{random:{minArgs:2,maxArgs:2,returnType:"number",eval(r,e){if(r.length!==2)throw new u("random(a, b) requires exactly 2 arguments");let t=G(e).nextRandom;if(!t)throw new u("random() called without a PRNG in context");let n=e.evaluate(r[0]),s=e.evaluate(r[1]);if(typeof n!="number"||typeof s!="number")throw new u("random(a, b) arguments must be numbers");if(!Number.isInteger(n)||!Number.isInteger(s))throw new u("random(a, b) arguments must be integers");let i=Math.min(n,s),o=Math.max(n,s);return Math.floor(t()*(o-i+1))+i}},check_flags:{minArgs:1,returnType:"boolean",flagDeltaArgs:!0,validate:Te("check_flags"),eval(r,e){let t=Le(r[0],e,"check_flags");for(let n=1;n<r.length;n++){let s=r[n];if(s.kind!=="flagdelta")throw new u("check_flags() flag args must be +flagName or -flagName");if(s.sign==="+"?!t.includes(s.name):t.includes(s.name))return!1}return!0}},set_flags:{minArgs:1,returnType:"flags",flagDeltaArgs:!0,validate:Te("set_flags"),eval(r,e){let t=[...Le(r[0],e,"set_flags")];for(let n=1;n<r.length;n++){let s=r[n];if(s.kind!=="flagdelta")throw new u("set_flags() flag args must be +flagName or -flagName");if(s.sign==="+")t.includes(s.name)||t.push(s.name);else{let i=t.indexOf(s.name);i>=0&&t.splice(i,1)}}return t}},visits:{minArgs:1,maxArgs:1,returnType:"number",validate:te("visits"),eval:(r,e)=>G(e).visits?.(ee(r,e,"visits"))??0},seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:te("seen"),eval:(r,e)=>(G(e).visits?.(ee(r,e,"seen"))??0)>0},patter_visits:{minArgs:1,maxArgs:1,returnType:"number",validate:te("patter_visits"),eval:(r,e)=>G(e).patterVisits?.(ee(r,e,"patter_visits"))??0},patter_seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:te("patter_seen"),eval:(r,e)=>(G(e).patterVisits?.(ee(r,e,"patter_seen"))??0)>0}}},Rn=Fe.map(r=>r.token).filter(r=>r!=="patter"&&r!=="scene");function je(r,e){let t=r.replace(/^@/,"").split(".");return t.length===2&&e(t[0])?{scope:t[0],name:t[1].toLowerCase()}:{scope:"patter",name:t.join(".").toLowerCase()}}function ee(r,e,t){let n=e.evaluate(r[0]);if(typeof n!="string")throw new u(`${t}(id) requires a string node id`);return n}function te(r){return(e,t)=>{let n=e[0];n&&n.kind!=="string"&&t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${r}(id): the argument must be a string id literal (a scene / block / node id)`})}}function Le(r,e,t){if(!r)throw new u(`${t}() requires at least one argument (the flags variable)`);let n=e.evaluate(r);if(Array.isArray(n))return n;if(n===!1||n===null||n===void 0)return[];throw new u(`${t}() first argument must be a flags property`)}function Te(r){return(e,t)=>{if(e.length===0)return;let n=e[0];if(n.kind!=="scopedvar"){t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${r}(): first argument must be a flags property reference (@name or @scope.name)`});return}let s=t.schema.properties.get(n.scope)?.get(n.name);if(s&&s.type!=="flags"){let i=n.scope===t.defaultScope?n.name:`${n.scope}.${n.name}`;t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${r}(): \'@${i}\' is not a flags property (got ${s.type})`});return}for(let i=1;i<e.length;i++){let o=e[i];o.kind!=="flagdelta"?t.report({path:[...t.path,"args",i],kind:"wrong-arg-type",severity:"error",message:`${r}(): argument ${i+1} must be +flagName or -flagName`}):s?.type==="flags"&&s.enumValues&&!s.enumValues.includes(o.name)&&t.report({path:[...t.path,"args",i],kind:"unknown-flag-name",severity:"error",message:`${r}(): unknown flag \'${o.name}\'`,reference:o.name})}}}var Bt=/^@[A-Za-z0-9_.]+$/;function*Ft(r){let e="",t=0;for(;t<r.length;){let n=r[t];if(n==="{"&&r[t+1]==="{"){e+="{",t+=2;continue}if(n==="}"&&r[t+1]==="}"){e+="}",t+=2;continue}if(n==="{"){let s=r.indexOf("}",t+1);if(s!==-1){let i=r.slice(t,s+1),o=r.slice(t+1,s).trim();if(o.startsWith("@")){e&&(yield{kind:"text",value:e},e=""),yield{kind:"slot",raw:i,inner:o,ref:Bt.test(o)?o:void 0},t=s+1;continue}e+=i,t=s+1;continue}}e+=n,t+=1}e&&(yield{kind:"text",value:e})}function Lt(r){return Array.isArray(r)?r.join(", "):typeof r=="boolean"?r?"true":"false":String(r)}function Tt(r){return r===" "||r==="	"||r===`\n`||r==="\\r"||r==="\\f"||r==="\\v"}function jt(r){let e="",t=!1;for(let n of r){if(Tt(n)){t=!0;continue}t&&e.length>0&&(e+=" "),t=!1,e+=n}return e}function Me(r,e,t){if(e.length===0||r.indexOf(e)<0)return r;let n="",s=0,i=!1;for(;s<r.length;){if(r.startsWith(e,s)){let o=r.indexOf(t,s+e.length);if(o>=0){s=o+t.length,i=!0;continue}n+=r.slice(s);break}n+=r[s],s+=1}return i?jt(n):r}function $e(r,e){if(r.indexOf("{")<0)return r;let t="";for(let n of Ft(r)){if(n.kind==="text"){t+=n.value;continue}if(!n.ref){t+=n.raw;continue}let s=e(n.ref);t+=s===void 0?"":Lt(s)}return t}function Ge(r){return r.toLowerCase().replace(/[\'\u2019]/g,"").replace(/[^a-z0-9-]+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function C(r,e){for(let t of r){e(t);let n=t.children;n&&C(n,e)}}function y(r){let e=r.gameId?.trim();return e||Ge(r.name)}function ye(r){let e=new Map;for(let[t,n]of Object.entries(r))e.set(y(n),t);return e}function ne(r,e,t){return(t??ye(r)).get(e)??(Object.hasOwn(r,e)?e:void 0)}var O=.6;function re(r){return`cast:${r}`}function se(r){return`qualifier:${r}`}function Ve(r,e){return`speaker:${r}:${e}`}var qe="speaker:pattern",_e="{name} ({qualifier})";function He(r,e,t){return r.split("{name}").map(n=>n.split("{qualifier}").join(t)).join(e)}var Se={open:"[",close:"]"},Ue="SFX";var V=4;function q(r){let e=new Set,t=[];for(let n of r)e.has(n)||(e.add(n),t.push(n));return t}function ie(r){let e=new Map,t=(n,s)=>{let i=q([...s,...n.tags??[]]);if(e.set(n.id,i),n.type==="group"&&n.prompt&&e.set(n.prompt.id,q([...i,...n.prompt.tags??[]])),n.type==="group")for(let o of n.children)t(o,i);else for(let o of n.beats??[])e.set(o.id,q([...i,...o.tags??[]]))};for(let n of Object.values(r.scenes)){let s=q(n.tags??[]);e.set(n.id,s);for(let i of n.blocks){let o=q([...s,...i.tags??[]]);e.set(i.id,o);for(let a of i.children)t(a,o)}}return e}var We=r=>r.kind==="line"||r.kind==="text",_=r=>typeof r=="number"&&Number.isFinite(r)?r:void 0;function Ke(r){let e=new Map,t=(i,o,a)=>{let c=i.kind==="gameEvent"?void 0:_(i.padAfter),l=c??o;a&&l<0&&(l=0),e.set(i.id,c!==void 0?{own:c,resolved:l}:{resolved:l})},n=(i,o)=>{let a=_(i.padAfterDefault)??o;if(i.type==="group"){i.prompt&&t(i.prompt,a,!1);for(let d of i.children)n(d,a);return}let c=i.beats??[],l=-1;c.forEach((d,g)=>{We(d)&&(l=g)}),c.forEach((d,g)=>{We(d)&&t(d,a,g===l)})},s=_(r.padAfterDefault)??O;for(let i of Object.values(r.scenes)){let o=_(i.padAfterDefault)??s;for(let a of i.blocks){let c=_(a.padAfterDefault)??o;for(let l of a.children)n(l,c)}}return e}var Je=new WeakMap,Qe=new WeakMap;function Mt(r){let e=Qe.get(r);return e||(e=ie(r),Qe.set(r,e)),e}var ze=new WeakMap;function $t(r){let e=ze.get(r);return e||(e=Ke(r),ze.set(r,e)),e}var Ye=new WeakMap;function Gt(r){let e=Ye.get(r);if(e)return e;e=new Map;for(let t of Object.values(r.scenes))for(let n of t.blocks)C(n.children,s=>{if(s.type==="group"&&s.selector==="choice")for(let i of s.children)e.set(i.id,s.id)});return Ye.set(r,e),e}var Xe=new WeakMap;function Vt(r){let e=Xe.get(r);if(e)return e;e=new Map;for(let t of Object.values(r.scenes))for(let n of t.blocks)C(n.children,s=>{if(s.type==="group"){s.prompt&&e.set(s.prompt.id,s.prompt);return}for(let i of s.beats??[])e.set(i.id,i)});return Xe.set(r,e),e}function b(r){if(r===void 0)return;let e={};for(let[t,n]of Object.entries(r))e[t]=Array.isArray(n)?[...n]:n;return e}function P(r,e){return r.tagIndex.get(e)?.slice()}var U="Patter",H=r=>r.replace(/%/g,"%25").replace(/\\//g,"%2F"),qt=r=>r.replace(/%2F/g,"/").replace(/%25/g,"%"),Ze=Symbol("ownsRegistry"),et=Symbol("setupReported"),w={stage:r=>`patter/scene/${H(r)}`,flow:r=>`patter/flow/${H(r)}/`,flowGlobals:r=>`patter/flow/${H(r)}/patter`,flowScene:(r,e)=>`patter/flow/${H(r)}/scene/${H(e)}`},K=class{constructor(e){this.journal=e}journal},ae=class r{host;defaultSeed;flowsById=new Map;allStrings;currentLocale;requestedLocale;sourceDebug;sceneGameIdToId=new Map;blockGameIdToId=new Map;creationOptions;engineLog=[];engineSeq=0;engineTraceHandlers=new Set;constructor(e,t={}){this.creationOptions=t;let n=[];for(let p of Object.keys(t))Ht.has(p)||n.push({node:p,message:p==="world"?\'the engine option "world" has gone: bind the scope as hostScopes: { world }\':`"${p}" isn\'t an engine option, so it\'s ignored`});let s=e.strings;this.allStrings=s,this.requestedLocale=t.locale,this.currentLocale=we(e,t.locale),this.currentLocale.problem&&n.push({node:t.locale,message:this.currentLocale.problem});let i=it(s,this.currentLocale),o=s[e.locales.default]??{},a=e.localisation,c=a?.mode==="ids"&&!a.sourceDebug;this.sourceDebug=a?.mode==="ids"&&!!a.sourceDebug,this.sourceDebug&&typeof console<"u"&&console.warn("[Patterplay] source-only DEBUG build: strings are the source language for debugging, not a shippable localised build.");let l=new Map;for(let p of e.cast??[])p.displayName&&l.set(p.name,p.displayName);let d=new Map;for(let p of e.qualifiers??[])p?.gameId&&d.set(p.gameId,p.name);let g=new Map;for(let p of e.cast??[])for(let[m,h]of Object.entries(p.qualifierLabels??{}))typeof h=="string"&&g.set(`${p.name}\\0${m}`,h);let f=e.speakerPattern??_e;this.defaultSeed=(t.seed??2654435769)>>>0;let T=new Map,Ee=new Map,Ce=new Map;for(let[p,m]of Object.entries(e.scenes)){this.sceneGameIdToId.set(y(m),p);let h=new Map;for(let S of m.blocks)Ee.set(S.id,{sceneId:p}),Ce.set(S.id,S),h.set(y(S),S.id),C(S.children,k=>T.set(k.id,k));this.blockGameIdToId.set(p,h)}let De=e.properties??[],ce=De.filter(p=>p.shared??!0).map(st),yt=De.filter(p=>!(p.shared??!0)).map(st),St=new Set(ce.map(p=>p.name.toLowerCase())),x=t.registry??new Z,Ie=!t.registry||t[Ze]===!0,Re=new E(ce,{pathPrefix:"@patter."}),le=[],Q=[];try{x.mountOwned("patter",Re,{owner:U}),Q.push("patter");let p=new Set,m=e.scopeRegistry?.scopes??[];for(let[h,S]of Object.entries(t.hostScopes??{})){let k=m.find(z=>z.token===h);if(!k&&!(e.externalScopes??[]).includes(h)){let z=m.find(bt=>bt.token.toLowerCase()===h.toLowerCase());n.push({node:h,message:z?`hostScopes binds "${h}", which this bundle doesn\'t declare: it declares "${z.token}", and a scope\'s token is case-sensitive`:`hostScopes binds "${h}", which this bundle doesn\'t declare`})}let wt=(k?.declarations??[]).map(dt);x.defineForeign(h,S,wt,{writable:k?.writable??!0,owner:U}),Q.push(h),p.add(h)}for(let h of Ie?e.scopeRegistry?.scopes??[]:[]){if(p.has(h.token)||x.has(h.token))continue;let S=(h.declarations??[]).map(k=>Kt(k,h.writable));x.defineOwned(h.token,S,{owner:U}),Q.push(h.token),le.push(h.token)}}catch(p){for(let m of Q)x.remove(m,{keep:!0});throw p}let Oe=new Map;for(let[p,m]of Object.entries(e.scenes)){let h=new Set((m.sceneProps??[]).filter(S=>S.shared??!1).map(S=>S.name.toLowerCase()));Oe.set(p,h)}if(this.host={logEnabled:t.log??!1,tracing:t.log??!1,emitEngine:(p,m,h)=>this.emitEngine(p,m,h),bundle:e,emitIds:c,strings:i,defaultStrings:o,castDisplay:l,qualifierDisplay:d,speakerLabels:g,speakerPattern:f,nodeIndex:T,blockIndex:Ee,blockById:Ce,sceneGameIdToId:this.sceneGameIdToId,blockGameIdToId:this.blockGameIdToId,tagIndex:Mt(e),padIndex:$t(e),registry:x,ownsRegistry:Ie,patterBag:Re,hostScopes:le,patterSharedDecls:ce,patterLocalDecls:yt,patterSharedNames:St,sceneSharedNames:Oe,sharedVisits:new Map,qualityLadders:new Map,sharedSelectors:new Map,stageBags:new Map,journal:null,customRng:t.rng,onDryChoice:t.onDryChoice,onError:t.onError??(p=>console.warn(p.kind==="setup"?`Patterplay: ${p.message}`:p.kind==="save"?`Patterplay: flow \'${p.flow}\': ${p.message}`:`Patterplay: ${p.kind} on ${p.node} in flow \'${p.flow}\' failed, played through: ${p.message}`)),reportRefits:()=>{let p=x.takeMisfits(m=>m==="patter"||m.startsWith("patter/")||le.includes(m));if(p.length!==0)if(t.onRefit)t.onRefit(p);else for(let m of p)console.warn(`Patterplay: the save\'s ${m.scope}.${m.name} was ${JSON.stringify(m.value)}, which no longer fits its declaration; it is back at its default`)},replayPromptOnChoose:t.replayPromptOnChoose??!1,captionsOn:t.closedCaptions??!0,captionOpen:(e.closedCaptions??Se).open,captionClose:(e.closedCaptions??Se).close,captionCharacter:e.closedCaptions?.character||Ue,refSplitCache:new Map,refSplitRevision:x.revision},this.host.reportRefits(),t[et]!==!0)for(let p of n)this.reportSetup(p.node,p.message)}reportSetup(e,t){this.host.onError({flow:"",kind:"setup",node:e,message:t}),this.host.tracing&&this.emitEngine("",{type:"diagnostic",kind:"setup",node:e,message:t})}get locale(){return this.currentLocale.locale}get locales(){let{default:e,included:t}=this.host.bundle.locales;return{default:e,included:[...t]}}get isSourceDebug(){return this.sourceDebug}get buildId(){return this.host.bundle.content?.hash??""}setLocale(e){this.requestedLocale=e,this.useLocale(we(this.host.bundle,e)),this.currentLocale.problem&&this.reportSetup(e,this.currentLocale.problem)}useLocale(e){this.currentLocale=e,this.host.strings=it(this.allStrings,e)}replaceStrings(e){this.allStrings=e.strings;let t=this.currentLocale.problem;this.useLocale(we(e,this.requestedLocale)),this.host.defaultStrings=this.allStrings[this.host.bundle.locales.default]??{};let n=this.currentLocale.problem;n&&n!==t&&this.reportSetup(this.requestedLocale,n)}hotSwap(e){this.refuseInCheckpoint("hotSwap");let t=this.saveGame(),n=l=>(l.setClosedCaptions(this.host.captionsOn),l),s=this.requestedLocale,i=(l=!1)=>new r(e,{...this.creationOptions,...s!==void 0?{locale:s}:{},registry:this.host.registry,[Ze]:this.host.ownsRegistry,[et]:l}),o=new Set(["patter",...this.host.hostScopes]),a=this.host.ownsRegistry?void 0:Object.fromEntries(Object.entries(this.host.registry.save()).filter(([l])=>o.has(l)||l.startsWith("patter/")));this.release(!0),a&&this.host.registry.load(a,{keepParked:!0,refit:!0});let c=i();try{return c.loadGame(t),n(c)}catch{c.release(!0);let l=this.host.ownsRegistry?t.registry:a;l&&this.host.registry.load(l,{keepParked:!0,refit:!0});let d=i(!0);for(let[g,f]of Object.entries(t.flows)){let T=f.cursor.currentSceneId;try{d.openFlow(g,T!==null?{scene:T}:{})}catch{}}return n(d)}}get closedCaptions(){return this.host.captionsOn}setClosedCaptions(e){this.host.captionsOn=e}openFlow(e,t={}){this.assertExternalScopes();let{sceneId:n,blockId:s}=this.resolveOpenAddress(t.scene,t.block),i=this.flowsById.get(e),o=this.host.journal;if(o&&i&&!i.isClosed)throw new Error(`openFlow would replace the open flow \'${e}\', which can\'t be undone while a checkpoint is open`);i?.close();let a=new N(e,this.host,t.seed??this.defaultSeed);return o&&(o.flows.add(a),o.opened.add(a),o.undo.push(()=>{a.close(),i?this.flowsById.set(e,i):this.flowsById.delete(e)})),this.flowsById.set(e,a),a.begin(n,s),a}runFlow(e,t,n){let s=this.flowsById.get(e);if(!s)return this.openFlow(e,{scene:t,block:n}).advanceToStop().played;if(!s.goto(t,n))throw new Error(`runFlow: address not found: ${t}${n===void 0?"":` / ${n}`}`);return s.advanceToStop().played}assertExternalScopes(){for(let e of this.host.bundle.externalScopes??[])if(!this.host.registry.has(e))throw new Error(`this content names @${e}, which no engine on this registry registered: give every engine the game\'s one registry`)}resolveOpenAddress(e,t){if(e!==void 0){let n=be(this.host,e);if(n===void 0)throw new Error(`unknown scene: ${e}`);if(t===void 0)return{sceneId:n};let s=ve(this.host,n,t);if(s===void 0)throw new Error(`unknown block: ${t}`);return{sceneId:n,blockId:s}}if(t!==void 0){if(!this.host.blockIndex.has(t))throw new Error(`unknown block: ${t}`);return{blockId:t}}if(Object.keys(this.host.bundle.scenes).length===0)throw new Error("no scenes in bundle");return{}}resolveSceneRef(e){if(e!=null)return be(this.host,e)??e}resolveBlockRef(e,t){if(t!=null)return e==null?t:ve(this.host,e,t)}sceneAddress(e){let t=this.host.bundle.scenes[e];return t?y(t):void 0}blockAddress(e){let t=this.host.blockById.get(e);return t?y(t):void 0}tagsForBeat(e){return P(this.host,e)??[]}tagsForScene(e){let t=this.resolveSceneRef(e);return(t!=null?P(this.host,t):void 0)??[]}tagsForBlock(e,t){let n=this.resolveSceneRef(e),s=this.resolveBlockRef(n,t);return(s!=null?P(this.host,s):void 0)??[]}gameDataForScene(e){let t=this.resolveSceneRef(e),n=t!=null?this.host.bundle.scenes[t]:void 0;return b(n?.gameData)??{}}gameDataForBlock(e,t){let n=this.resolveBlockRef(this.resolveSceneRef(e),t),s=n!=null?this.host.blockById.get(n):void 0;return b(s?.gameData)??{}}extensionsForScene(e){let t=this.resolveSceneRef(e);return{...(t!=null?this.host.bundle.scenes[t]:void 0)?.extensions}}extensionsForBlock(e,t){let n=this.resolveBlockRef(this.resolveSceneRef(e),t);return{...(n!=null?this.host.blockById.get(n):void 0)?.extensions}}extensionsForSnippet(e){let t=this.host.nodeIndex.get(e);return t?.type==="snippet"?{...t.extensions}:{}}getCast(){let e=[];for(let t of this.host.bundle.cast??[])t?.name&&e.push(t.name);return e}castForScene(e){let t=this.resolveSceneRef(e),n=t!=null?this.host.bundle.scenes[t]:void 0;if(!n)return[];let s=new Set;for(let i of n.blocks)tt(i.children,s);return[...s]}castForBlock(e,t){let n=this.resolveSceneRef(e),s=this.resolveBlockRef(n,t),i=s!=null?this.host.blockById.get(s):void 0;if(!i)return[];let o=new Set;return tt(i.children,o),[...o]}getOutline(){return Object.values(this.host.bundle.scenes).map(e=>({id:e.id,...y(e)?{gameId:y(e)}:{},name:e.name,...nt(e.gameData),...D(e.extensions),...this.tagsField(e.id),blocks:e.blocks.map(t=>({id:t.id,...y(t)?{gameId:y(t)}:{},name:t.name,...nt(t.gameData),...D(t.extensions),...this.tagsField(t.id),children:t.children.map(n=>this.outlineNode(n))}))}))}getBeatSequence(){let e=[];for(let t of Object.values(this.host.bundle.scenes))for(let n of t.blocks)C(n.children,s=>{if(s.type==="snippet")for(let i of s.beats??[])e.push({sceneId:t.id,blockId:n.id,snippetId:s.id,beat:this.beatInfo(i)})});return e}outlineNode(e){return e.type==="group"?{type:"group",id:e.id,...this.tagsField(e.id),...e.selector?{selector:e.selector}:{},...e.prompt?{prompt:this.beatInfo(e.prompt)}:{},children:e.children.map(t=>this.outlineNode(t))}:{type:"snippet",id:e.id,...this.tagsField(e.id),beats:(e.beats??[]).map(t=>this.beatInfo(t)),...e.jump?{jumpTo:e.jump.to,...e.jump.mode?{jumpMode:e.jump.mode}:{}}:{}}}beatInfo(e){let t=P(this.host,e.id),n={id:e.id,kind:e.kind};if(e.kind==="line"){if(e.character!==void 0){n.character=e.character;let i=this.host.defaultStrings[re(e.character)]??this.host.castDisplay.get(e.character);i!==void 0&&(n.characterName=i)}if(e.direction!==void 0&&(n.direction=e.direction),e.qualifier!==void 0){n.qualifier=e.qualifier;let i=this.host.defaultStrings[se(e.qualifier)]??this.host.qualifierDisplay.get(e.qualifier);i!==void 0&&(n.qualifierName=i)}let s=oe(this.host,e.character,e.qualifier,!0);s!==void 0&&(n.speakerLabel=s)}if(e.kind==="line"||e.kind==="text"){let s=this.host.padIndex.get(e.id);n.padAfter=s?.resolved??O,s?.own!==void 0&&(n.ownPadAfter=s.own);let i=this.host.defaultStrings[e.id];i!==void 0&&(n.text=i)}return e.gameData&&Object.keys(e.gameData).length&&(n.gameData=b(e.gameData)),e.extensions&&Object.keys(e.extensions).length&&(n.extensions=e.extensions),t&&t.length&&(n.tags=t),n}tagsField(e){let t=P(this.host,e);return t&&t.length?{tags:t}:{}}getFlow(e){return this.flowsById.get(e)}flows(){return[...this.flowsById.values()]}listBags(){let e=[{bag:this.host.patterBag}];for(let[t,n]of this.host.stageBags)e.push({bag:n,pathPrefix:`@scene:${t}.`});return e}checkpoint(){if(this.host.journal)throw new Error("a checkpoint is already open: roll it back or commit it first");let e={undo:[],flows:new Set,opened:new Set,selectors:new Set,flowSelectors:new Map};return this.host.journal=e,new K(e)}rollback(e){this.endCheckpoint(e);let t=e.journal.undo;for(let n=t.length-1;n>=0;n--)t[n]();r.forget(e.journal)}commit(e){this.endCheckpoint(e),r.forget(e.journal)}get inCheckpoint(){return this.host.journal!==null}endCheckpoint(e){if(this.host.journal!==e.journal)throw new Error("that checkpoint is not the open one");this.host.journal=null}static forget(e){e.undo=[],e.flows.clear(),e.opened.clear(),e.selectors.clear(),e.flowSelectors.clear()}refuseInCheckpoint(e){if(this.host.journal)throw new Error(`${e} can\'t be undone, so it isn\'t allowed while a checkpoint is open`)}captureFlow(e){let t=this.flowsById.get(e);if(!t)throw new Error(`no open flow \'${e}\' to capture`);return{version:V,...t.snapshot(),...Qt(e,this.host.registry.save())}}restoreFlow(e,t){this.refuseInCheckpoint("restoreFlow");let n=t.version;if(n!==3&&n!==V)throw new Error(`unsupported flow state version: ${String(n)}`);let s=t.cursor;if(typeof s!="object"||s===null)throw new Error("malformed flow state: no cursor");if(this.flowsById.has(e))throw new Error(`a flow \'${e}\' is already open; close it before restoring another under that id`);this.assertExternalScopes();let i=w.flow(e);this.host.registry.discardParked(i),this.host.registry.load(Jt(e,t),{keepParked:!0,refit:!0});let o=new N(e,this.host,this.defaultSeed);try{o.restore(t)}catch(a){throw o.close(),this.host.registry.discardParked(i),a}return this.flowsById.set(e,o),this.host.reportRefits(),o}closeFlow(e){this.refuseInCheckpoint("closeFlow"),this.flowsById.get(e)?.close(),this.flowsById.delete(e)}reset(){this.refuseInCheckpoint("reset");for(let e of this.flowsById.values())e.close();this.flowsById.clear(),this.host.patterBag.reseed(this.host.patterSharedDecls),this.host.sharedVisits.clear(),this.host.sharedSelectors.clear();for(let e of this.host.stageBags.keys())this.host.registry.remove(w.stage(e));this.host.stageBags.clear(),this.host.registry.discardParked("patter/")}release(e){for(let n of this.flowsById.values())n.releaseBags(e),n.close();this.flowsById.clear();let t=this.host.registry;for(let n of this.host.stageBags.keys())t.remove(w.stage(n),{keep:e});this.host.stageBags.clear();for(let n of["patter",...this.host.hostScopes])t.has(n)&&t.remove(n,{keep:e});for(let n of Object.keys(this.creationOptions.hostScopes??{}))t.has(n)&&t.remove(n)}getProperty(e){let{scope:t,name:n}=this.splitShared(e);return this.host.registry.get(t,n)}setProperty(e,t){let{scope:n,name:s}=this.splitShared(e);lt(this.host,n,s,t,null);let i=this.host.journal?this.host.registry.get(n,s):void 0;this.host.registry.set(n,s,t,{host:!0}),this.host.journal&&i!==void 0&&this.host.journal.undo.push(()=>this.host.registry.set(n,s,i,{host:!0}))}stageIndex(e,t){return A(this.ladderOf(e),t)}compareStages(e,t,n){return B(this.ladderOf(e),t,n)}nextStage(e,t){return F(this.ladderOf(e),t)}ladderOf(e){let{scope:t,name:n}=this.splitShared(e),s=Wt(this.host,t,n);if(!s)throw new Error(`\'${e}\' is not a quality`);return s}log(){return this.engineLog}clearLog(){this.engineLog.length=0}onTrace(e){return this.engineTraceHandlers.add(e),this.host.tracing=!0,()=>{this.engineTraceHandlers.delete(e),this.host.tracing=this.host.logEnabled||this.engineTraceHandlers.size>0}}emitEngine(e,t,n){for(let s of this.engineTraceHandlers)s(e,t);this.host.logEnabled&&this.engineLog.push({...t,flow:e,seq:this.engineSeq++,...n?{scene:n}:{}})}getVisitCounts(){return Object.fromEntries(this.host.sharedVisits)}listProperties(){return this.host.patterSharedDecls.map(e=>({name:e.name,path:`@patter.${e.name}`,type:e.type,values:e.values,stages:e.stages,value:this.getProperty(`@${e.name}`),default:L(e),writable:e.writable??!0}))}splitShared(e){let t=pt(this.host,e);if(t.scope==="scene")throw new Error(`\'${e}\': @scene properties are scene-scoped - read/write them on a Flow, not the Engine`);return t}saveGame(){let e={};for(let[t,n]of this.flowsById)e[t]=n.snapshot();return{version:V,...this.host.ownsRegistry?{registry:this.host.registry.save()}:{},sharedVisits:Object.fromEntries(this.host.sharedVisits),sharedSelectors:at(this.host.sharedSelectors),flows:e}}loadGame(e){this.refuseInCheckpoint("loadGame");let t=e.version;if(t!==3&&t!==V)throw new Error(`unsupported save version: ${String(t)}`);let n=e.flows;if(typeof n!="object"||n===null||Array.isArray(n))throw new Error("malformed save: no flows");this.assertExternalScopes();let s=this.host.registry;for(let[o,a]of this.flowsById)a.releaseBags(o in e.flows),a.close();this.flowsById.clear();for(let o of this.host.stageBags.keys())s.remove(w.stage(o),{keep:!0});this.host.stageBags.clear();let i=e.registry;i&&(this.host.ownsRegistry?s.load(i,{refit:!0}):s.load(i,{keepParked:!0,refit:!0})),this.host.sharedVisits.clear();for(let[o,a]of Object.entries(e.sharedVisits??{}))this.host.sharedVisits.set(o,a);this.host.sharedSelectors.clear();for(let[o,a]of ct(e.sharedSelectors))this.host.sharedSelectors.set(o,a);for(let[o,a]of Object.entries(e.flows)){let c=new N(o,this.host,this.defaultSeed);c.restore(a),this.flowsById.set(o,c)}this.host.reportRefits()}},N=class{id;host;local;registered=new Set;rngState;started=!1;flowEnded=!1;closed=!1;currentSceneId=null;stack=[];activeSnippet=null;beatIndex=0;pendingChoice=null;pendingPrompt=null;pendingPromptOwnerId=null;selectors=new Map;visitCounts=new Map;sceneBags=new Map;patterResolver={get:e=>this.host.patterSharedNames.has(e)?this.host.patterBag.get(e):this.local.get(e),set:(e,t)=>{this.host.patterSharedNames.has(e)?this.host.registry.set("patter",e,t):this.local.set(e,t)}};sceneResolver={get:e=>{let t=this.currentSceneId;if(t!==null)return this.sceneBagFor(t,e)?.get(e)},set:(e,t)=>{let n=this.currentSceneId;if(n===null)return;let s=this.sceneBagFor(n,e);s&&s.set(e,t)}};evalCtx;ctxRevision=-1;registryQualities;flowLog=[];flowSeq=0;constructor(e,t,n){this.id=e,this.host=t,this.rngState=M(n),this.local=this.newLocal(),this.evalCtx={scopes:{},host:{nextRandom:this.rng,visits:s=>this.visitCounts.get(s)??0,patterVisits:s=>this.host.sharedVisits.get(s)??0},qualities:(s,i)=>this.stagesFor(s,i)}}context(){let e=this.host.registry;if(e.revision!==this.ctxRevision){let t=e.toEvalContext(),n=this.evalCtx.scopes;for(let s of Object.keys(n))delete n[s];Object.assign(n,t.scopes),n.patter=this.patterResolver,n.scene=this.sceneResolver,this.registryQualities=t.qualities,this.ctxRevision=e.revision}return this.evalCtx}stagesFor(e,t){let n=t.toLowerCase();if(e==="patter")return W(this.host,"patter",()=>[...this.host.patterSharedDecls,...this.host.patterLocalDecls]).get(n);if(e==="scene"){let s=this.currentSceneId;return s==null?void 0:W(this.host,`scene/${s}`,()=>this.host.bundle.scenes[s]?.sceneProps).get(n)}return this.registryQualities?.(e,t)??W(this.host,`host/${e}`,()=>this.host.bundle.scopeRegistry?.scopes.find(s=>s.token===e)?.declarations).get(n)}begin(e,t){let n=this.host.bundle.start;if(e===void 0&&t===void 0&&n&&this.host.bundle.scenes[n.scene]&&(e=n.scene,n.block!==void 0&&this.host.blockIndex.get(n.block)?.sceneId===n.scene&&(t=n.block)),this.host.journal&&!this.host.journal.opened.has(this))throw new Error("a flow can\'t be started or reset while a checkpoint is open");if(this.releaseBags(!1),this.host.registry.discardParked(w.flow(this.id)),this.mountLocal(),this.selectors.clear(),this.visitCounts.clear(),this.stack=[],this.currentSceneId=null,this.flowEnded=!1,this.activeSnippet=null,this.beatIndex=0,this.clearPending(),this.started=!0,t){let s=this.host.blockIndex.get(t);if(!s)throw new Error(`unknown block: ${t}`);this.enterSceneSetup(s.sceneId),this.stack=[{sceneId:s.sceneId,containerId:t,index:0}],this.enter(t)}else{let s=e??Object.keys(this.host.bundle.scenes)[0],i=s?this.host.bundle.scenes[s]:void 0;if(!i)throw new Error(s?`unknown scene: ${s}`:"no scenes in bundle");this.enterSceneSetup(s);let o=i.blocks[0];o&&(this.stack=[{sceneId:s,containerId:o.id,index:0}],this.enter(o.id))}this.settle()}reset(e,t){this.begin(e,t)}goto(e,t){if(this.closed)return!1;if(this.touch(),e==="END")return this.started=!0,this.clearPending(),this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!0,this.stack=[],!0;let n=be(this.host,e);if(n===void 0)return!1;let s;return t!==void 0&&(s=ve(this.host,n,t),s===void 0)?!1:this.started?(this.clearPending(),this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!1,this.enterTarget(s??n,"jump"),this.settle(),!0):(this.begin(n,s),!0)}close(){this.releaseBags(!1),this.closed=!0,this.flowEnded=!0,this.stack=[],this.activeSnippet=null,this.beatIndex=0,this.clearPending()}clearPending(){this.pendingChoice=null,this.pendingPrompt=null,this.pendingPromptOwnerId=null}touch(){let e=this.host.journal;if(!e||e.flows.has(this))return;e.flows.add(this);let{rngState:t,started:n,flowEnded:s,currentSceneId:i,activeSnippet:o,beatIndex:a,pendingChoice:c,pendingPrompt:l,pendingPromptOwnerId:d}=this,g=this.stack.map(f=>({...f}));e.undo.push(()=>{Object.assign(this,{rngState:t,started:n,flowEnded:s,currentSceneId:i,activeSnippet:o,beatIndex:a,pendingChoice:c,pendingPrompt:l,pendingPromptOwnerId:d,stack:g})})}get isClosed(){return this.closed}get currentScene(){return this.currentSceneId}advance(){if(this.closed)return{type:"end"};if(!this.started)throw new Error("flow has not been started");if(this.touch(),this.pendingPrompt){let e=this.pendingPrompt;return this.pendingPrompt=null,this.pendingPromptOwnerId=null,e.shown?this.promptResult(e.beat,e.shown):this.beatResult(e.beat)}return this.settle(),this.flowEnded?{type:"end"}:this.pendingChoice?{type:"choice",groupId:this.pendingChoice.groupId,options:this.offer(this.pendingChoice)}:this.activeSnippet?this.beatResult(this.activeSnippet.beats[this.beatIndex++]):(this.flowEnded=!0,{type:"end"})}advanceToStop(){let e=[];for(;;){let t=this.advance();if(t.type==="choice"||t.type==="end")return{played:e,stop:t};e.push(t)}}settle(){let e=0;for(;;){if(++e>1e4)throw new Error("flow did not settle after 10000 transitions - likely a jump cycle with no deliverable content");if(this.flowEnded||this.pendingChoice)return;if(this.activeSnippet){if(this.beatIndex<(this.activeSnippet.beats?.length??0))return;this.runEffects(this.activeSnippet.onExit,this.activeSnippet.id);let i=this.activeSnippet.jump;this.activeSnippet=null,this.beatIndex=0,this.resolveJump(i);continue}let t=this.stack[this.stack.length-1];if(!t){this.flowEnded=!0;return}t.sceneId!==this.currentSceneId&&(this.currentSceneId=t.sceneId);let n=this.childrenOf(t.containerId);if(!n){this.stack.pop();continue}let s=t.index;for(;t.index<n.length&&!this.eligible(n[t.index]);)t.index++;if(this.host.tracing&&t.index!==s&&this.emit({type:"select",group:t.containerId,selector:"run",children:n.slice(s,t.index+1).map((i,o)=>({id:i.id,eligible:s+o===t.index})),picked:n[t.index]?.id??null}),t.index>=n.length){this.stack.pop();continue}this.enterChild(n[t.index++])}}listBags(){let e=[{bag:this.local,pathPrefix:`${this.id}/@patter.`}];for(let[t,n]of this.sceneBags)e.push({bag:n,pathPrefix:`${this.id}/@scene:${t}.`});return e}log(){return this.flowLog}clearLog(){this.flowLog.length=0}emit(e){let t=this.currentSceneId??void 0;this.host.emitEngine(this.id,e,t),this.host.logEnabled&&this.flowLog.push({...e,seq:this.flowSeq++,...t?{scene:t}:{}})}getVisitCounts(){return Object.fromEntries(this.visitCounts)}stepFor(e){let t=Vt(this.host.bundle).get(e);return t?this.beatResult(t):void 0}getChoices(){return this.pendingChoice?this.offer(this.pendingChoice):[]}offer(e){return e.options.map(t=>{let n=e.byId.get(t.id),s=this.promptFor(n);return e.shown.set(t.id,s),{id:t.id,prompt:s,eligible:t.eligible,gameData:b(t.gameData),...D(n.extensions)}})}choose(e){let t=this.pendingChoice;if(!t)throw new Error("no choice is pending");let n=t.options.find(a=>a.id===e);if(!n)throw new Error(`unknown choice option: ${e}`);if(!n.eligible)throw new Error(`choice option is not eligible: ${e}`);this.touch();let s=t.byId.get(e);this.host.tracing&&this.emit({type:"chose",group:t.groupId,option:e}),this.pendingChoice=null;let i=this.host.replayPromptOnChoose?this.authoredPromptOf(s):void 0,o=i?t.shown.has(e)?t.shown.get(e):this.promptFor(s):void 0;this.pendingPrompt=i&&o?{beat:i,shown:{...o}}:null,this.pendingPromptOwnerId=this.pendingPrompt?s.id:null,this.enterChild(s)}isEnded(){return this.flowEnded}getProperty(e){let{scope:t,name:n}=this.splitRef(e);return t==="patter"?this.patterResolver.get(n):t==="scene"?this.sceneResolver.get(n):this.host.registry.get(t,n)}setProperty(e,t){this.writeProperty(e,t,!0)}stageIndex(e,t){return A(this.ladderOf(e),t)}compareStages(e,t,n){return B(this.ladderOf(e),t,n)}nextStage(e,t){return F(this.ladderOf(e),t)}ladderOf(e){let{scope:t,name:n}=this.splitRef(e);this.context();let s=this.stagesFor(t,n);if(!s)throw new Error(`\'${e}\' is not a quality`);return s}writeProperty(e,t,n){let{scope:s,name:i}=this.splitRef(e);if(n){if(s==="scene"&&this.currentSceneId===null)throw new Error(`\'${e}\': the flow has not entered a scene yet`);lt(this.host,s,i,t,this.currentSceneId)}let o=this.host.journal;if(s==="patter"){if(o){let a=this.host.patterSharedNames.has(i),c=a?this.host.patterBag.get(i):this.local.get(i),l=this.local;c!==void 0&&o.undo.push(a?()=>this.host.registry.set("patter",i,c):()=>l.set(i,c))}this.patterResolver.set(i,t)}else if(s==="scene"){if(this.currentSceneId===null)throw new Error(`\'${e}\': the flow has not entered a scene yet`);if(o){let a=this.sceneBagFor(this.currentSceneId,i),c=a?.get(i);a&&c!==void 0&&o.undo.push(()=>a.set(i,c))}this.sceneResolver.set(i,t)}else{let a=o?this.host.registry.get(s,i):void 0;this.host.registry.set(s,i,t,n?{host:!0}:void 0),o&&a!==void 0&&o.undo.push(()=>this.host.registry.set(s,i,a,{host:!0}))}}snapshot(){let e=Gt(this.host.bundle),t=this.activeSnippet?.beats?.[this.beatIndex]?.id;return{rngState:this.rngState,visits:Object.fromEntries(this.visitCounts),cursor:{flowEnded:this.flowEnded,currentSceneId:this.currentSceneId,stack:this.stack.map(n=>{let s=this.childrenOf(n.containerId)?.[n.index],i=e.get(n.containerId);return{...n,...s?{nextId:s.id}:{},...i!==void 0?{choiceId:i}:{}}}),activeSnippetId:this.activeSnippet?.id??null,...t!==void 0?{beatId:t}:{},pendingChoice:this.pendingChoice?{groupId:this.pendingChoice.groupId,options:this.pendingChoice.options.map(n=>({id:n.id,eligible:n.eligible,...n.gameData!==void 0?{gameData:b(n.gameData)}:{}}))}:null,pendingPromptOwnerId:this.pendingPromptOwnerId,...this.pendingPrompt?.shown?{pendingPrompt:_t(this.pendingPrompt.shown)}:{},selectors:at(this.selectors)}}}restore(e){if(this.host.journal)throw new Error("a flow can\'t be restored while a checkpoint is open");let t=this.restoreCursor(e);this.releaseBags(!0),this.mountLocal();for(let n of new Set([this.currentSceneId,...this.stack.map(s=>s.sceneId)]))n!==null&&this.host.bundle.scenes[n]&&this.ensureSceneBags(n);t&&(this.report({flow:this.id,kind:"save",node:t.node,message:`the save\'s place has gone from this build: ${t.instead}`}),t.reoffer&&this.setupChoice(t.reoffer))}restoreCursor(e){this.rngState=M(e.rngState),this.visitCounts=new Map(Object.entries(e.visits??{}));let t=e.cursor;this.started=!0,this.flowEnded=t.flowEnded,this.currentSceneId=t.currentSceneId;let n=null;this.stack=[];for(let s of t.stack){let{nextId:i,choiceId:o,...a}=s,c=this.childrenOf(a.containerId),l=!c&&o!==void 0?this.host.nodeIndex.get(o):void 0;if(l?.type==="group"&&l.selector==="choice"){n={node:t.activeSnippetId??t.pendingChoice?.groupId??a.containerId,instead:`option ${a.containerId} has gone, so choice ${l.id} is offered again`,reoffer:l};break}let d=i!==void 0?c?.findIndex(g=>g.id===i)??-1:-1;this.stack.push(d>=0?{...a,index:d}:{...a})}if(this.activeSnippet=null,this.beatIndex=0,!n?.reoffer&&t.activeSnippetId!==null){let s=this.host.nodeIndex.get(t.activeSnippetId);if(s&&s.type==="snippet"){let i=s.beats??[];if(this.activeSnippet=s,t.beatId!==void 0){let o=i.findIndex(a=>a.id===t.beatId);this.beatIndex=o>=0?o:i.length,o<0&&(n={node:t.activeSnippetId,instead:`beat ${t.beatId} has gone from snippet ${t.activeSnippetId}, so the snippet ends there`})}else this.beatIndex=t.beatIndex??i.length}else n={node:t.activeSnippetId,instead:`snippet ${t.activeSnippetId} has gone, so play carries on after it`}}if(this.selectors=ct(t.selectors),this.pendingChoice=null,!n?.reoffer&&t.pendingChoice!==null){let s=new Map,i=[];for(let o of t.pendingChoice.options){let a=this.host.nodeIndex.get(o.id);a&&(s.set(o.id,a),i.push({id:o.id,eligible:o.eligible,...o.gameData!==void 0?{gameData:o.gameData}:{}}))}if(i.length>0)this.pendingChoice={groupId:t.pendingChoice.groupId,options:i,byId:s,shown:new Map};else{let o=this.host.nodeIndex.get(t.pendingChoice.groupId);n=o?.type==="group"&&o.selector==="choice"?{node:t.pendingChoice.groupId,instead:`none of choice ${o.id}\'s options is left, so it\'s offered again`,reoffer:o}:{node:t.pendingChoice.groupId,instead:`choice ${t.pendingChoice.groupId} has gone, so play carries on after it`}}}if(this.pendingPrompt=null,this.pendingPromptOwnerId=n?.reoffer?null:t.pendingPromptOwnerId??null,this.pendingPromptOwnerId){let s=this.host.nodeIndex.get(this.pendingPromptOwnerId),i=s?this.authoredPromptOf(s):void 0,o=t.pendingPrompt,a=o?.kind==="line"&&o.speakerLabel===void 0?oe(this.host,o.character,o.qualifier):void 0;i?this.pendingPrompt={beat:i,...o?{shown:{...o,padAfter:o.padAfter??this.padOf(i.id),...a!==void 0?{speakerLabel:a}:{}}}:{}}:this.pendingPromptOwnerId=null}return n}enterSceneSetup(e){let t=this.host.bundle.scenes[e];if(!t)throw new Error(`unknown scene: ${e}`);this.currentSceneId=e,this.enter(e),this.seedScene(t),this.runEffects(t.onEntry,t.id)}enterChild(e){if(this.enter(e.id),e.type==="snippet"){this.beginSnippet(e);return}let t=e.selector??"run";if(t==="run"){this.stack.push({sceneId:this.currentSceneId,containerId:e.id,index:0});return}if(t==="choice"){this.setupChoice(e);return}let n=this.selectChild(e);n&&this.enterChild(n)}childrenOf(e){let t=this.host.blockById.get(e);if(t)return t.children;let n=this.host.nodeIndex.get(e);if(n&&n.type==="group")return n.children}beginSnippet(e){this.runEffects(e.onEnter,e.id),this.activeSnippet=e,this.beatIndex=0}setupChoice(e){let t=[],n=new Map,s=[];for(let o of e.children){if(o.fallback===!0){s.push(o);continue}if(o.sticky!==!0&&(this.visitCounts.get(o.id)??0)>=1)continue;let a=this.eligible(o),c=o.secretUntilEligible===!0;!a&&c||(t.push({id:o.id,eligible:a,...o.gameData!==void 0?{gameData:o.gameData}:{}}),n.set(o.id,o))}if(t.some(o=>o.eligible)){this.host.tracing&&this.emit({type:"choice",group:e.id,options:t.map(o=>({id:o.id,eligible:o.eligible}))}),this.pendingChoice={groupId:e.id,options:t,byId:n,shown:new Map};return}let i=s.find(o=>this.eligible(o));if(i){this.enterChild(i);return}this.host.tracing&&this.emit({type:"dry",group:e.id}),this.host.onDryChoice?.(e.id)}resolveJump(e){e&&this.enterTarget(e.to,e.mode==="call"?"call":"jump")}enterTarget(e,t){if(this.host.tracing&&this.emit({type:"jump",to:e,mode:t}),e==="END"){this.flowEnded=!0,this.stack=[];return}let n,s,i=this.host.bundle.scenes[e];if(i){this.enterSceneSetup(e);let a=i.blocks[0];if(!a){t==="jump"&&(this.stack=[]);return}n=e,s=a.id}else{let a=this.host.blockIndex.get(e);if(!a)throw new Error(`jump target not found: ${e}`);a.sceneId!==this.currentSceneId&&this.enterSceneSetup(a.sceneId),n=a.sceneId,s=e}this.enter(s);let o={sceneId:n,containerId:s,index:0};t==="call"?this.stack.push(o):this.stack=[o]}selectChild(e){let t=e.children.map(c=>({id:c.id,eligible:this.eligible(c)})),n=e.children.filter((c,l)=>t[l].eligible),s=e.options?.order??"sequential",i=e.options?.exhaust??"once",o=c=>(this.host.tracing&&this.emit({type:"select",group:e.id,selector:e.selector??"default",...e.selector==="sequence"?{order:s,exhaust:i}:{},children:t,picked:c?.id??null}),c);if(n.length===0)return o(null);let a=this.selectorState(e);switch(e.selector){case"branch":return o(n[0]);case"sequence":return o(s==="shuffle"?this.pickShuffle(n,i,a):s==="specificity"?this.pickSpecificity(n,i,a):this.pickSequential(n,i,a));default:return null}}pickSequential(e,t,n){let s=e.length,i=n.seq??0;return n.seq=i+1,t==="repeat"?e[i%s]:i<s?e[i]:t==="stick"?e[s-1]:null}pickShuffle(e,t,n){let s=e.length,i=t==="stick",o=()=>(i?e.slice(0,s-1):e).map(f=>f.id),a=new Set(e.map(f=>f.id));if(n.bag===void 0&&(n.bag=o()),!n.bag.some(f=>a.has(f))){if(t==="once")return null;if(i){let f=e[s-1];return n.last=f.id,f}if(n.bag=o(),n.bag.length===0)return null}let c=n.bag.filter(f=>a.has(f)),l=n.last!==void 0&&c.length>1?c.indexOf(n.last):-1,d=Math.floor(this.rng()*(l>=0?c.length-1:c.length));l>=0&&d>=l&&d++;let g=c[d];return n.bag.splice(n.bag.indexOf(g),1),n.last=g,e.find(f=>f.id===g)}pickSpecificity(e,t,n){let s=e;if(t!=="repeat"){n.bag===void 0&&(n.bag=e.map(d=>d.id));let l=new Set(n.bag);if(s=e.filter(d=>l.has(d.id)),s.length===0)return t==="stick"&&n.last!==void 0?e.find(d=>d.id===n.last)??null:null}let i=-1,a=s.map(l=>{let d=this.specScore(l);return d>i&&(i=d),{c:l,s:d}}).filter(l=>l.s===i).map(l=>l.c),c;if(a.length===1)c=a[0];else{let l=n.last!==void 0?a.findIndex(g=>g.id===n.last):-1,d=Math.floor(this.rng()*(l>=0?a.length-1:a.length));l>=0&&d>=l&&d++,c=a[d]}return t!=="repeat"&&(n.bag=n.bag.filter(l=>l!==c.id)),n.last=c.id,c}specScore(e){return e.condition?this.matchedSpec(this.conditionAst(e.condition),!0,e):0}matchedSpec(e,t,n){return Ne(e,i=>{try{return ot(Y(i,this.context(),me))}catch(o){return this.reportError("best-match",n.id,n.condition,o),!1}},{want:t})}selectorState(e){let t=e.shared?this.host.sharedSelectors:this.selectors,n=this.host.journal,s;if(n&&(s=e.shared?n.selectors:n.flowSelectors.get(this),s||(s=new Set,n.flowSelectors.set(this,s))),n&&s&&!s.has(e.id)){s.add(e.id);let o=t.get(e.id),a=o?{...o,...o.bag?{bag:[...o.bag]}:{}}:void 0;n.undo.push(()=>{a?t.set(e.id,a):t.delete(e.id)})}let i=t.get(e.id);return i||(i={},t.set(e.id,i)),i}runEffects(e,t){for(let n of e??[]){let s;try{s=this.evalExpr(n.value);let i=this.host.tracing?this.getProperty(n.target):void 0;this.writeProperty(n.target,s,!1),this.host.tracing&&this.emit({type:"write",target:n.target,value:s,...i!==void 0?{prev:i}:{}})}catch(i){this.reportError("effect",t,n.value,i)}}}eligible(e){if(!e.condition)return!0;try{return ot(this.evalExpr(e.condition))}catch(t){return this.reportError("condition",e.id,e.condition,t),!1}}reportError(e,t,n,s){let i=s instanceof Error?s.message:String(s),o=n?.src;this.report({flow:this.id,kind:e,node:t,...o?{source:o}:{},message:i})}report(e){this.host.onError(e),this.host.tracing&&this.emit({type:"diagnostic",kind:e.kind,node:e.node,...e.source?{source:e.source}:{},message:e.message})}evalExpr(e){return Y(this.conditionAst(e),this.context(),me)}conditionAst(e){let t=Je.get(e);return t||(t=I(e.ast),Je.set(e,t)),t}enter(e){let t=this.visitCounts,n=t.get(e);t.set(e,(n??0)+1);let s=this.host.sharedVisits,i=s.get(e);s.set(e,(i??0)+1),this.host.journal&&this.host.journal.undo.push(()=>{n===void 0?t.delete(e):t.set(e,n),i===void 0?s.delete(e):s.set(e,i)})}rng=()=>{if(this.host.customRng)return this.host.customRng();let e=ue(this.rngState),t=e.next();return this.rngState=e.state(),t};beatResult(e){let t=P(this.host,e.id),n=t&&t.length?{tags:t}:{};switch(e.kind){case"gameEvent":return{type:"gameEvent",id:e.id,gameData:b(e.gameData),...D(e.extensions),...n};case"text":return{type:"text",id:e.id,text:this.interpolate(this.resolveString(e.id)),padAfter:this.padOf(e.id),...e.action?{action:!0}:{},gameData:b(e.gameData),...D(e.extensions),...n};case"line":{let s=this.resolveString(e.id),i=!this.host.captionsOn,a=i&&e.character===this.host.captionCharacter?"":this.captionLine(this.host.bundle.voiced?s:this.interpolate(s)),c=i&&a.length===0;return{type:"line",id:e.id,text:a,character:c?void 0:e.character,characterName:c?void 0:this.resolveCharacterName(e.character),direction:c?void 0:e.direction,qualifier:c?void 0:e.qualifier,qualifierName:c?void 0:this.resolveQualifierName(e.qualifier),speakerLabel:c?void 0:oe(this.host,e.character,e.qualifier),padAfter:this.padOf(e.id),gameData:b(e.gameData),...D(e.extensions),...n}}}}interpolate(e){return $e(e,t=>this.getProperty(t))}stripCaptions(e){return Me(e,this.host.captionOpen,this.host.captionClose)}captionLine(e){return this.host.captionsOn?e:this.stripCaptions(e)}promptFor(e){let t=this.promptBeatOf(e);if(!t)return;let n=this.interpolate(this.resolveString(t.id)),s=this.padOf(t.id);return t.kind==="line"?{kind:"line",text:this.captionLine(n),character:t.character,characterName:this.resolveCharacterName(t.character),direction:t.direction,qualifier:t.qualifier,qualifierName:this.resolveQualifierName(t.qualifier),speakerLabel:oe(this.host,t.character,t.qualifier),padAfter:s}:{kind:"text",text:n,padAfter:s}}authoredPromptOf(e){return e.type==="group"?e.prompt:void 0}promptResult(e,t){let n=P(this.host,e.id),s=n&&n.length?{tags:n}:{};return t.kind==="text"?{type:"text",id:e.id,text:t.text,padAfter:this.padOf(e.id),gameData:b(e.gameData),...D(e.extensions),...s}:{type:"line",id:e.id,text:t.text,character:t.character,characterName:t.characterName,direction:t.direction,qualifier:t.qualifier,qualifierName:t.qualifierName,speakerLabel:t.speakerLabel,padAfter:this.padOf(e.id),gameData:b(e.gameData),...D(e.extensions),...s}}promptBeatOf(e){return e.type==="group"&&e.prompt?e.prompt:((e.type==="snippet"?e:this.firstTextSnippetIn(e.children))?.beats??[]).find(n=>n.kind==="line"||n.kind==="text")}firstTextSnippetIn(e){let t;return C(e,n=>{!t&&n.type==="snippet"&&(n.beats??[]).some(s=>s.kind==="line"||s.kind==="text")&&(t=n)}),t}resolveString(e){if(this.host.emitIds)return e;let t=this.host.strings[e];if(t!==void 0)return t;let n=this.host.defaultStrings[e];return n!==void 0?`<Untranslated: ${e}> ${n}`:e}resolveCharacterName(e){if(e===void 0||this.host.emitIds)return;let t=re(e);return this.host.strings[t]??this.host.defaultStrings[t]??this.host.castDisplay.get(e)}padOf(e){return this.host.padIndex.get(e)?.resolved??O}resolveQualifierName(e){if(e===void 0||this.host.emitIds)return;let t=se(e);return this.host.strings[t]??this.host.defaultStrings[t]??this.host.qualifierDisplay.get(e)}splitRef(e){return pt(this.host,e)}newLocal(){return new E(this.host.patterLocalDecls,{pathPrefix:"@patter."})}mountLocal(){this.local=this.newLocal();let e=w.flowGlobals(this.id);this.host.registry.mountOwned(e,this.local,{owner:U}),this.registered.add(e),this.host.reportRefits()}releaseBags(e){for(let t of this.registered)this.host.registry.remove(t,{keep:e});this.registered.clear(),this.sceneBags.clear()}sceneBagFor(e,t){if(this.host.bundle.scenes[e])return this.ensureSceneBags(e),this.host.sceneSharedNames.get(e)?.has(t.toLowerCase())?this.host.stageBags.get(e):this.sceneBags.get(e)}ensureSceneBags(e){let t=this.host.sceneSharedNames.get(e)??new Set,n=this.host.bundle.scenes[e]?.sceneProps??[],s=this.host.journal,i=!this.sceneBags.has(e)||!this.host.stageBags.has(e);if(!this.sceneBags.has(e)){let o=new E(n.filter(l=>!t.has(l.name.toLowerCase())),{pathPrefix:"@scene."}),a=w.flowScene(this.id,e),c=rt(this.host.registry,a,o,s!==null);this.registered.add(a),this.sceneBags.set(e,o),s&&s.undo.push(()=>{this.sceneBags.get(e)===o&&(this.host.registry.remove(a,c?{keep:!0}:void 0),this.registered.delete(a),this.sceneBags.delete(e))})}if(!this.host.stageBags.has(e)){let o=new E(n.filter(c=>t.has(c.name.toLowerCase())),{pathPrefix:"@scene."}),a=rt(this.host.registry,w.stage(e),o,s!==null);this.host.stageBags.set(e,o),s&&s.undo.push(()=>{this.host.stageBags.get(e)===o&&(this.host.registry.remove(w.stage(e),a?{keep:!0}:void 0),this.host.stageBags.delete(e))})}i&&this.host.reportRefits()}seedScene(e){let t=this.host.sceneSharedNames.get(e.id)??new Set;this.ensureSceneBags(e.id);for(let n of e.sceneProps??[]){if(!n.temporary)continue;let s=n.name.toLowerCase(),i=t.has(s)?this.host.stageBags.get(e.id):this.sceneBags.get(e.id);if(!i)continue;let o=this.host.journal?i.get(s):void 0;o!==void 0&&this.host.journal.undo.push(()=>i.set(s,o)),i.set(s,L(n))}}};function tt(r,e){C(r,t=>{if(t.type==="group"){t.prompt?.kind==="line"&&t.prompt.character&&e.add(t.prompt.character);return}for(let n of t.beats??[])n.kind==="line"&&n.character&&e.add(n.character)})}function oe(r,e,t,n=!1){if(!e||r.emitIds)return;let s=c=>(n?void 0:r.strings[c])??r.defaultStrings[c],i=s(re(e))??r.castDisplay.get(e)??e;if(t===void 0)return i;let o=r.speakerLabels.get(`${e}\\0${t}`);if(o!==void 0)return s(Ve(e,t))??o;let a=s(se(t))??r.qualifierDisplay.get(t)??t;return He(s(qe)??r.speakerPattern,i,a)}function nt(r){return r&&Object.keys(r).length?{gameData:b(r)}:{}}function D(r){return r&&Object.keys(r).length?{extensions:r}:{}}function _t(r){let e={kind:r.kind,text:r.text};return r.character!==void 0&&(e.character=r.character),r.characterName!==void 0&&(e.characterName=r.characterName),r.direction!==void 0&&(e.direction=r.direction),r.qualifier!==void 0&&(e.qualifier=r.qualifier),r.qualifierName!==void 0&&(e.qualifierName=r.qualifierName),r.speakerLabel!==void 0&&(e.speakerLabel=r.speakerLabel),typeof r.padAfter=="number"&&(e.padAfter=r.padAfter),e}function at(r){let e={};for(let[t,n]of r){let s={};n.seq!==void 0&&(s.seq=n.seq),n.bag&&(s.bag=[...n.bag]),n.last!==void 0&&(s.last=n.last),e[t]=s}return e}function ct(r){let e=new Map;for(let[t,n]of Object.entries(r??{})){let s={};n.seq!==void 0&&(s.seq=n.seq),n.bag&&(s.bag=[...n.bag]),n.last!==void 0&&(s.last=n.last),e.set(t,s)}return e}function rt(r,e,t,n){let s=n?JSON.stringify(t.save()):"";return r.mountOwned(e,t,{owner:U}),n&&JSON.stringify(t.save())!==s}function st(r){return{name:r.name,type:r.type,values:r.values,stages:r.stages,default:r.default}}var Ht=new Set(["rng","seed","locale","hostScopes","registry","replayPromptOnChoose","closedCaptions","onDryChoice","onError","onRefit","log"]);function we(r,e){let t=r.locales.default;if(e===void 0)return{locale:t,table:t};if(r.localisation?.mode==="ids")return{locale:e,table:e};let n=[...new Set([t,...r.locales.included,...Object.keys(r.strings)])];if(n.includes(e))return{locale:e,table:e};let s=c=>c.toLowerCase().replace(/_/g,"-"),i=n.find(c=>s(c)===s(e));if(i!==void 0)return{locale:i,table:i,problem:`the locale "${e}" is spelled "${i}" in this bundle, so it\'s using "${i}"`};let o=s(e).split("-")[0],a=n.find(c=>s(c)===o);return a!==void 0?{locale:a,table:a,problem:`this bundle has no locale "${e}", so it\'s using its language, "${a}"`}:{locale:t,problem:`this bundle has no locale "${e}", so it\'s using the default, "${t}", with every string marked untranslated`}}function it(r,e){return e.table!==void 0?r[e.table]??{}:{}}function lt(r,e,t,n,s){let i=c=>c?.find(l=>l.name.toLowerCase()===t),o;if(e==="patter")o=i(r.bundle.properties);else if(e==="scene")o=i(s!==null?r.bundle.scenes[s]?.sceneProps:void 0);else{let c=r.bundle.scopeRegistry?.scopes.find(l=>l.token===e);if(!c||c.declarations===void 0)return;o=i(c.declarations)}let a=`@${e}.${t}`;if(o===void 0)throw new Error(`no property at "${a}": the content declares no ${a}`);if(!$(o,n,{noneChosen:o.type==="enum"&&o.default===""}))throw new Error(`"${a}" takes ${Ut(o)}; ${JSON.stringify(n)} doesn\'t fit`)}function Ut(r){let e=t=>(t??[]).map(n=>JSON.stringify(n)).join(", ");switch(r.type){case"number":return"a number";case"boolean":return"true or false";case"enum":return`one of ${e(r.values)}`;case"flags":return r.values!==void 0&&r.values.length>0?`a list of flags from ${e(r.values)}`:"a list of flags";case"quality":return`one of its stages ${e(r.stages)}`;default:return"text"}}function W(r,e,t){let n=r.qualityLadders.get(e);if(!n){n=new Map;for(let s of t()??[]){let i=s.name.toLowerCase();s.type==="quality"&&s.stages&&!n.has(i)&&n.set(i,s.stages)}r.qualityLadders.set(e,n)}return n}function Wt(r,e,t){let n=t.toLowerCase();return e==="patter"?W(r,"patter",()=>[...r.patterSharedDecls,...r.patterLocalDecls]).get(n):r.registry.toEvalContext().qualities?.(e,t)??W(r,`host/${e}`,()=>r.bundle.scopeRegistry?.scopes.find(s=>s.token===e)?.declarations).get(n)}function dt(r){return{name:r.name,type:r.type,values:r.values,stages:r.stages,default:r.default,writable:r.writable}}function Kt(r,e){let t=dt(r),n=r.writable??e;return n===void 0?t:{...t,writable:n}}function be(r,e){return ne(r.bundle.scenes,e,r.sceneGameIdToId)}function ve(r,e,t){return r.blockGameIdToId.get(e)?.get(t)??(r.blockIndex.get(t)?.sceneId===e?t:void 0)}function pt(r,e){r.refSplitRevision!==r.registry.revision&&(r.refSplitCache.clear(),r.refSplitRevision=r.registry.revision);let t=r.refSplitCache.get(e);return t||(t=je(e,n=>n==="scene"||r.registry.has(n)||(r.bundle.externalScopes?.includes(n)??!1)),r.refSplitCache.set(e,t)),t}function Jt(r,e){let t={};e.scopes?.patter&&(t[w.flowGlobals(r)]=e.scopes.patter);for(let[n,s]of Object.entries(e.sceneBags??{}))t[w.flowScene(r,n)]=s;return t}function Qt(r,e){let t={scopes:{},sceneBags:{}},n=w.flow(r);for(let[s,i]of Object.entries(e)){if(!s.startsWith(n))continue;let o=s.slice(n.length);o==="patter"?t.scopes.patter=i:o.startsWith("scene/")&&(t.sceneBags[qt(o.slice(6))]=i)}return t}function ot(r){return typeof r=="boolean"?r:typeof r=="number"?r!==0:typeof r=="string"?r!=="":r.length>0}var zt=(r,e)=>r.shared??e;function xe(r,e){return{name:r.name,type:r.type,hasDefault:r.default!==void 0,...r.default!==void 0?{default:r.default}:{},shared:zt(r,e)}}function Yt(r){return{name:r.name,type:r.type,hasDefault:r.default!==void 0,...r.values?{values:[...r.values]}:{},...r.purpose?{purpose:r.purpose}:{}}}function Xt(r,e){e.blocks++;let t=[...r.children];for(;t.length;){let n=t.pop();if(n.type==="group"){e.groups++,n.prompt&&e.prompts++,t.push(...n.children);continue}e.snippets++;for(let s of n.beats??[])e.beats++,s.kind==="gameEvent"&&e.gameEvents++}}function ut(r){let e={scenes:0,blocks:0,groups:0,snippets:0,beats:0,prompts:0,gameEvents:0,cast:r.cast?.length??0},t=[],n=[];for(let o of Object.values(r.scenes)){e.scenes++;let a=y(o);t.push({gameId:a,name:o.name,blocks:o.blocks.map(c=>({gameId:y(c),name:c.name}))});for(let c of o.blocks)Xt(c,e);o.sceneProps?.length&&n.push({gameId:a,properties:o.sceneProps.map(c=>xe(c,!1))})}let s=(r.scopeRegistry?.scopes??[]).map(o=>({token:o.token,writable:o.writable??!0,opaque:o.declarations===void 0,properties:(o.declarations??[]).map(a=>xe(a,!0))})),i=Object.entries(r.gameDataFields??{}).filter(([,o])=>(o?.length??0)>0).map(([o,a])=>({kind:o,fields:(a??[]).map(Yt)}));return{identity:{schema:r.schema,project:r.content.project,...r.content.version!==void 0?{version:r.content.version}:{},...r.content.hash!==void 0?{hash:r.content.hash}:{},...r.content.structureHash!==void 0?{structureHash:r.content.structureHash}:{},voiced:r.voiced,defaultLocale:r.locales.default,locales:[...r.locales.included],localisation:r.localisation?.mode??"embedded",sourceDebug:r.localisation?.sourceDebug??!1},addresses:t,hostScopes:s,properties:{patter:(r.properties??[]).map(o=>xe(o,!0)),scene:n},gameData:i,counts:e}}var J=(r,e)=>Object.prototype.hasOwnProperty.call(r,e);function gt(r,e){return r.gameDataFields?.[e]??[]}function ke(r,e,t){return e&&J(e,t)?e[t]:r.find(n=>n.name===t)?.default}function ft(r,e){let t={};for(let n of r){let s=ke(r,e,n.name);s!==void 0&&(t[n.name]=s)}for(let[n,s]of Object.entries(e??{}))J(t,n)||(t[n]=s);return t}function ht(r,e,t){let n=r.extensions!==void 0&&J(r.extensions,e)?r.extensions[e]:void 0;return n!==void 0&&J(n.fields,t)?n.fields[t]??[]:[]}function mt(r,e,t=""){let n=o=>({...o?.extensions??{}}),s=Object.values(r.scenes??{}),i=o=>(J(r.scenes??{},o)?r.scenes[o]:void 0)??s.find(a=>y(a)===o);switch(e){case"project":{let o={};for(let[a,c]of Object.entries(r.extensions??{}))c.project!==void 0&&(o[a]=c.project);return o}case"scene":return n(i(t));case"block":{let o=t.indexOf("/");if(o<0)return{};let a=i(t.slice(0,o))?.blocks??[],c=t.slice(o+1);return n(a.find(l=>l.id===c)??a.find(l=>y(l)===c))}case"snippet":case"option":case"line":case"text":case"gameEvent":{let o,a=(c,l)=>{for(let d of c??[]){if(o!==void 0)return;if(d.type==="group"){if(l&&d.id===t&&e==="option"){o=d;return}if(l&&d.prompt?.id===t&&d.prompt.kind===e){o=d.prompt;return}a(d.children??[],d.selector==="choice");continue}if(d.id===t&&e==="snippet"){o=d;return}let g=(d.beats??[]).find(f=>f.id===t);if(g!==void 0){g.kind===e&&(o=g);return}}};for(let c of s)for(let l of c.blocks??[])o===void 0&&a(l.children??[],!1);return n(o)}default:return{}}}return Dt(Zt);})();\n';
 var PLAYABLE_TIMING_JS = 'var GameSubtitles=(()=>{var l=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var u=(t,e)=>{for(var s in e)l(t,s,{get:e[s],enumerable:!0})},f=(t,e,s,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of c(e))!_.call(t,i)&&i!==s&&l(t,i,{get:()=>e[i],enumerable:!(n=a(e,i))||n.enumerable});return t};var p=t=>f(l({},"__esModule",{value:!0}),t);var d={};u(d,{estimateDuration:()=>h});function h(t,{charsPerSecond:e=14,minSeconds:s=1.5,maxSeconds:n=18}={}){let i=0;for(let o of t??"")o!=="\\xAD"&&i++;let r=e>0?e:14;return Math.min(Math.max(i/r,s),n)}return p(d);})();\n';
 
 // src/play-timeline.ts
@@ -2187,7 +2685,6 @@ var PLAYER_JS = String.raw`
 (function () {
   var Engine = window.Patterplay.Engine;
   var BUNDLE = window.PATTER_BUNDLE;
-  var startScene = (BUNDLE.start && BUNDLE.start.scene) || Object.keys(BUNDLE.scenes)[0];
   var SAVE_KEY = "patter.play." + ((BUNDLE.content && BUNDLE.content.hash) || "x");
 
   var stage = document.getElementById("stage");
@@ -2242,7 +2739,7 @@ var PLAYER_JS = String.raw`
     };
   }
 
-  function build() { engine = new Engine(BUNDLE); flow = engine.openFlow("main", { scene: startScene }); }
+  function build() { engine = new Engine(BUNDLE); flow = engine.openFlow("main"); } // the project's start, or the first scene
 
   function newGame() { stage.innerHTML = ""; controls.innerHTML = ""; build(); run(); }
 
@@ -2513,8 +3010,9 @@ function renderPlay(result) {
 
 // src/coverage.ts
 import { Engine as Engine2 } from "@patterkit/runtime";
-import { isContentlessBeat as isContentlessBeat2, walkNodes as walkNodes2 } from "@patterkit/model";
-import { deserialiseAst, makePrng, stagesEitherSide } from "@wildwinter/expr";
+import { isContentlessBeat as isContentlessBeat2, walkNodes as walkNodes3 } from "@patterkit/model";
+import { neverRunNodes } from "@patterkit/core";
+import { deserialiseAst, makePrng, stagesEitherSide, valueFits } from "@wildwinter/expr";
 var CADENCE_PROB = {
   rarely: 0.15,
   sometimes: 0.4,
@@ -2640,15 +3138,13 @@ function analyzeHostScopes(bundle, hostTokens) {
       refsIn(e.value);
     }
   };
-  const walk = (nodes, blockId, gate, fine, branch, dead) => {
-    let won = false;
+  const walk = (nodes, blockId, gate, fine, dead, never) => {
     for (const node of nodes) {
-      const shadow = dead || won;
-      if (branch && !node.condition) won = true;
+      const shadow = dead || never.has(node.id);
       const here = /* @__PURE__ */ new Set([...gate, ...refsIn(node.condition)]);
       const hereFine = /* @__PURE__ */ new Set([...fine, ...fineIn(node.condition)]);
       if (node.type === "group") {
-        walk(node.children, blockId, here, hereFine, node.selector === "branch", shadow);
+        walk(node.children, blockId, here, hereFine, shadow, never);
       } else {
         const beats = (node.beats ?? []).map((b) => b.id);
         if (beats.length) siteBeats.set(node.id, beats);
@@ -2666,7 +3162,10 @@ function analyzeHostScopes(bundle, hostTokens) {
   };
   for (const scene of Object.values(bundle.scenes)) {
     scanEffects(scene.onEntry, scene.id);
-    for (const block of scene.blocks) walk(block.children, block.id, /* @__PURE__ */ new Set(), /* @__PURE__ */ new Set(), false, false);
+    for (const block of scene.blocks) {
+      const never = new Set(neverRunNodes(block.children).map((n) => n.id));
+      walk(block.children, block.id, /* @__PURE__ */ new Set(), /* @__PURE__ */ new Set(), false, never);
+    }
   }
   return empty;
 }
@@ -2722,7 +3221,7 @@ function proposeCoverageDrivers(loaded) {
   const { written, proposals } = analyzeHostScopes(bundle, hostTokens);
   const declByRef = /* @__PURE__ */ new Map();
   for (const s of hostScopes) {
-    for (const d of s.declarations ?? []) declByRef.set(`@${s.token}.${d.name}`, { type: d.type, values: d.values, stages: d.stages });
+    for (const d of s.declarations ?? []) declByRef.set(`@${s.token}.${d.name}`, { type: d.type, values: d.values, stages: d.stages, default: d.default });
   }
   const drivers = [];
   for (const [ref, pool] of proposals) {
@@ -2734,6 +3233,7 @@ function proposeCoverageDrivers(loaded) {
       else if (decl.type === "enum" && decl.values) values = [...decl.values];
       else if (decl.type === "quality" && decl.stages) values = [...decl.stages];
     }
+    if (decl) values = values.filter((v) => valueFits(decl, v, { noneChosen: decl.type === "enum" && decl.default === "" }));
     if (values.length === 0) continue;
     if (decl?.type === "quality" && decl.stages) {
       const near = new Set(values.flatMap((v) => stagesEitherSide(decl, v)));
@@ -2764,7 +3264,7 @@ function* sweep(loaded, options = {}, hooks = {}) {
   for (const scene of loaded.scenes) {
     nodeScene.set(scene.id, scene.id);
     for (const block of scene.blocks) {
-      walkNodes2(block.children, (node) => {
+      walkNodes3(block.children, (node) => {
         nodeScene.set(node.id, scene.id);
         if (node.type === "group") {
           if (node.selector === "choice") choiceScene.set(node.id, scene.id);
@@ -2801,6 +3301,13 @@ function* sweep(loaded, options = {}, hooks = {}) {
   const recurringDrivers = drivers.filter((d) => d.kind === "recurring");
   const drivenRefs = new Set(drivers.map((d) => d.ref));
   const pick = (vals) => vals[Math.floor(rng() * vals.length)];
+  const drive = (engine, d) => {
+    const value = pick(d.values);
+    try {
+      engine.setProperty(d.ref, value);
+    } catch {
+    }
+  };
   const sites = [...new Set([...analysis.writerSites.values()].flat())];
   const entered = entryGates(bundle, analysis.routes, start);
   let executed = 0;
@@ -2822,7 +3329,7 @@ function* sweep(loaded, options = {}, hooks = {}) {
       },
       ...registry ? { registry } : {}
     });
-    for (const d of initialDrivers) engine.setProperty(d.ref, pick(d.values));
+    for (const d of initialDrivers) drive(engine, d);
     const flow = engine.openFlow("cov", { scene: start.scene, block: start.block });
     const seenThisRun = /* @__PURE__ */ new Set();
     let term = "capped";
@@ -2835,7 +3342,7 @@ function* sweep(loaded, options = {}, hooks = {}) {
         }
         if (r.type === "choice") {
           for (const d of recurringDrivers) {
-            if (rng() < CADENCE_PROB[d.cadence ?? "sometimes"]) engine.setProperty(d.ref, pick(d.values));
+            if (rng() < CADENCE_PROB[d.cadence ?? "sometimes"]) drive(engine, d);
           }
           const eligible = r.options.filter((o) => o.eligible);
           if (eligible.length === 0) {
@@ -3787,454 +4294,237 @@ function poToCatalog(text) {
 // src/loc-xlsx.ts
 var HEADERS = ["ID", "Source", "Translation", "Comments", "Status", "Gender", "Scene", "Qualifier"];
 var SCENE_COLUMN = HEADERS.indexOf("Scene") + 1;
+var INFO_SHEET = "Patter";
+var INFO_MARKER = "Patter localisation file";
+var INFO_LANGUAGE = "Language";
+var INFO_SOURCE = "Source language";
+var INFO_PROJECT = "Project";
 var SHEET_NAME_MAX = 31;
 function uniqueSheetName(scene, used) {
   const tidy2 = (s) => s.replace(/^'+|'+$/g, "");
   const base = tidy2(scene.replace(/[:\\/?*[\]]/g, "-").slice(0, SHEET_NAME_MAX)) || "Scene";
   let name = base;
-  for (let n = 2; used.has(name.toLowerCase()) || name.toLowerCase() === "history"; n++) {
-    const suffix = ` (${n})`;
-    name = tidy2(base.slice(0, SHEET_NAME_MAX - suffix.length)) + suffix;
-  }
-  used.add(name.toLowerCase());
-  return name;
-}
-function cellText(v) {
-  if (v == null) return "";
-  if (typeof v === "string") return v;
-  if (typeof v === "number" || typeof v === "boolean") return String(v);
-  if (v instanceof Date) return v.toISOString();
-  if (typeof v !== "object") return "";
-  const o = v;
-  if (Array.isArray(o.richText)) return o.richText.map((run) => cellText(run?.text)).join("");
-  if ("text" in o) return cellText(o.text);
-  if ("result" in o) return cellText(o.result);
-  return "";
-}
-async function catalogToXlsx(catalog) {
-  const { default: ExcelJS } = await import("exceljs");
-  const wb = new ExcelJS.Workbook();
-  wb.creator = "patter";
-  const byScene = /* @__PURE__ */ new Map();
-  for (const e of catalog.entries) (byScene.get(e.scene) ?? byScene.set(e.scene, []).get(e.scene)).push(e);
-  const used = /* @__PURE__ */ new Set();
-  for (const [scene, entries] of byScene) {
-    const ws = wb.addWorksheet(uniqueSheetName(scene, used));
-    ws.columns = [
-      { header: "ID", key: "id", width: 22 },
-      { header: "Source", key: "source", width: 40 },
-      { header: "Translation", key: "translation", width: 40 },
-      { header: "Comments", key: "comments", width: 30 },
-      { header: "Status", key: "status", width: 10 },
-      { header: "Gender", key: "gender", width: 12 },
-      // Hidden: the translator has no use for it, and it is the import's only faithful record of the scene.
-      { header: "Scene", key: "scene", width: 22, hidden: true },
-      // After the hidden Scene column, so the columns an older reader finds by position stay where they were.
-      { header: "Qualifier", key: "qualifier", width: 11 }
-    ];
-    ws.getRow(1).font = { bold: true };
-    ws.views = [{ state: "frozen", ySplit: 1 }];
-    for (const e of entries) {
-      ws.addRow({
-        id: e.id,
-        source: e.source,
-        translation: e.translation,
-        comments: e.comments.join("\n"),
-        status: e.stale ? "stale" : e.translation ? "translated" : "",
-        gender: e.context?.gender ?? "",
-        scene,
-        qualifier: e.context?.qualifier ?? ""
-      });
-    }
-  }
-  return Buffer.from(await wb.xlsx.writeBuffer());
-}
-async function xlsxToCatalog(buffer) {
-  const { default: ExcelJS } = await import("exceljs");
-  const wb = new ExcelJS.Workbook();
-  await wb.xlsx.load(buffer);
-  const entries = [];
-  for (const ws of wb.worksheets) {
-    const header = ws.getRow(1).values.slice(1).map(cellText);
-    if (header[0] !== HEADERS[0]) continue;
-    const hasSceneColumn = header[SCENE_COLUMN - 1] === "Scene";
-    const sceneOf = (row) => hasSceneColumn ? cellText(row.getCell(SCENE_COLUMN).value).trim() : "";
-    let sheetScene = "";
-    ws.eachRow((row, n) => {
-      if (n > 1 && !sheetScene) sheetScene = sceneOf(row);
-    });
-    ws.eachRow((row, n) => {
-      if (n === 1) return;
-      const cell = (c) => cellText(row.getCell(c).value);
-      const id = cell(1).trim();
-      if (!id) return;
-      const status = cell(5).trim().toLowerCase();
-      const scene = checkCatalogField("spreadsheet", "scene", sceneOf(row) || sheetScene || ws.name);
-      entries.push({
-        id,
-        scene,
-        source: cell(2),
-        translation: cell(3),
-        comments: cell(4) ? cell(4).split("\n").filter(Boolean) : [],
-        stale: status === "stale"
-      });
-    });
-  }
-  return { project: "", defaultLocale: "", locale: void 0, entries };
-}
-
-// src/voice-script.ts
-import { DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES2, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES3, DEFAULT_DOCUMENTATION_CLASSES as DEFAULT_DOCUMENTATION_CLASSES2, projectQualifiers as projectQualifiers2 } from "@patterkit/model";
-function plainVoice(text) {
-  return text.replace(/<\/?(?:b|i|bi)>/g, "").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
-}
-function groupLabel(node, source) {
-  if (node.prompt) return plainVoice(source[node.prompt.id]?.trim() || "option");
-  if (node.selector === "choice") return "";
-  return node.selector ?? "group";
-}
-function runVoiceScript(loaded, opts = {}) {
-  const { project } = loaded;
-  const everything = !!opts.everything;
-  const ladderDecls = project.writingStatuses ?? DEFAULT_WRITING_STATUSES2;
-  const writingLadder = ladderDecls.map((s) => s.name);
-  const recordingLadder = (project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES3).map((s) => s.name);
-  const stub = writingLadder[0];
-  const recordThreshold = ladderDecls.findIndex((s) => s.readyToRecord);
-  const writingIndex = new Map(writingLadder.map((name, i) => [name, i]));
-  const { writing: writingOf, recording: manualRecordingOf, cut: cutSet, rerecord: rerecordSet, documentation: docsOf } = mergeAuthoring2(loaded);
-  const recordingBase = opts.recordingOverride ?? manualRecordingOf;
-  const recordingOf = (id) => effectiveRecording(id, recordingBase, rerecordSet, recordingLadder[0]);
-  const source = sourceStrings(loaded);
-  const actorOf = /* @__PURE__ */ new Map();
-  for (const c of project.cast ?? []) if (c.actor) actorOf.set(c.name, c.actor);
-  const qualifierName = new Map(projectQualifiers2(project).map((q) => [q.gameId, q.name]));
-  const voClasses = classesForChannel(project.documentationClasses ?? DEFAULT_DOCUMENTATION_CLASSES2, "vo");
-  const ownVo = (id) => (docsOf.get(id) ?? []).filter((d) => d.type !== void 0 && voClasses.has(d.type)).map((d) => d.text);
-  const lines = [];
-  const emitLine = (beat, scope, leadingVo) => {
-    if (beat.kind !== "line" || cutSet.has(beat.id)) return false;
-    const ws = writingOf.get(beat.id) ?? stub;
-    if (!everything && recordThreshold !== -1 && (writingIndex.get(ws) ?? 0) < recordThreshold) return false;
-    const own = ownVo(beat.id);
-    lines.push({
-      scope: scope.join(" \u203A "),
-      id: beat.id,
-      character: beat.character ?? "",
-      ...beat.qualifier ? { qualifier: qualifierName.get(beat.qualifier) ?? beat.qualifier } : {},
-      actor: beat.character ? actorOf.get(beat.character) : void 0,
-      text: plainVoice(source[beat.id] ?? ""),
-      comments: leadingVo ? [...leadingVo, ...own] : own,
-      // first line of the run gets the enclosing context
-      recordingStatus: recordingOf(beat.id)
-    });
-    return true;
-  };
-  const walkNode = (node, scope, ancestorVo) => {
-    if (node.type === "group") {
-      if (cutSet.has(node.id)) return;
-      const label = groupLabel(node, source);
-      const childScope = label ? [...scope, label] : scope;
-      const childVo = [...ancestorVo, ...ownVo(node.id)];
-      if (node.prompt) emitLine(node.prompt, childScope, childVo);
-      for (const child2 of node.children ?? []) walkNode(child2, childScope, childVo);
-      return;
-    }
-    if (cutSet.has(node.id)) return;
-    let leading = true;
-    for (const beat of node.beats ?? []) {
-      if (emitLine(beat, scope, leading ? ancestorVo : void 0)) leading = false;
-    }
-  };
-  for (const scene of loaded.scenes) {
-    if (cutSet.has(scene.id)) continue;
-    const sceneVo = ownVo(scene.id);
-    for (const block of scene.blocks) {
-      if (cutSet.has(block.id)) continue;
-      const scope = [scene.name, block.name].filter(Boolean);
-      const blockVo = [...sceneVo, ...ownVo(block.id)];
-      for (const child2 of block.children ?? []) walkNode(child2, scope, blockVo);
-    }
-  }
-  return { project: project.project.id, voiced: project.voiced ?? false, recordingLadder, everything, lines };
-}
-
-// src/voice-script-xlsx.ts
-async function voiceScriptToXlsx(data) {
-  const { default: ExcelJS } = await import("exceljs");
-  const wb = new ExcelJS.Workbook();
-  wb.creator = "patter";
-  const ws = wb.addWorksheet("Voice Script");
-  ws.columns = [
-    { header: "Scope", key: "scope", width: 28 },
-    { header: "Line ID", key: "id", width: 18 },
-    { header: "Character", key: "character", width: 16 },
-    { header: "Qualifier", key: "qualifier", width: 11 },
-    { header: "Actor", key: "actor", width: 16 },
-    { header: "Text", key: "text", width: 60 },
-    { header: "Comments", key: "comments", width: 36 },
-    { header: "Status", key: "status", width: 12 }
-  ];
-  ws.getRow(1).font = { bold: true };
-  ws.views = [{ state: "frozen", ySplit: 1 }];
-  for (const l of data.lines) {
-    const row = ws.addRow({
-      scope: l.scope,
-      id: l.id,
-      character: l.character,
-      qualifier: l.qualifier ?? "",
-      actor: l.actor ?? "",
-      text: l.text,
-      comments: l.comments.join("\n"),
-      status: l.recordingStatus
-    });
-    row.getCell("text").alignment = { wrapText: true, vertical: "top" };
-    row.getCell("comments").alignment = { wrapText: true, vertical: "top" };
-  }
-  return Buffer.from(await wb.xlsx.writeBuffer());
-}
-
-// src/script-doc.ts
-import { DEFAULT_DOCUMENTATION_CLASSES as DEFAULT_DOCUMENTATION_CLASSES3, projectQualifiers as projectQualifiers3 } from "@patterkit/model";
-import { humanizeNodeRefs } from "@patterkit/core";
-var TOKENS = {
-  ink: "26221c",
-  // near-black warm ink (headings)
-  inkRead: "3a352d",
-  // dialogue body (ink ~84% + muted)
-  inkSoft: "5c554b",
-  // text (ink ~68% + muted) - a step softer than dialogue
-  muted: "8c8479",
-  // labels, quiet tags
-  accent: "8a5a34",
-  // structural marks: conditions, options, jumps, game events
-  line: "e4dfd5"
-  // hairlines / rules / the group rail
-};
-var CHAR_PALETTE = [
-  "b23b3b",
-  "b5642b",
-  "927524",
-  "6b7a31",
-  "3f7d49",
-  "2c7d6e",
-  "2d7791",
-  "3a6aa8",
-  "5a5ba6",
-  "7e4e9c",
-  "9c4486",
-  "a83e5c"
-];
-function colourIndex(name) {
-  let h = 2166136261;
-  for (let i = 0; i < name.length; i++) {
-    h ^= name.charCodeAt(i);
-    h = Math.imul(h, 16777619);
-  }
-  h ^= h >>> 16;
-  h = Math.imul(h, 2246822507);
-  h ^= h >>> 13;
-  h = Math.imul(h, 3266489909);
-  h ^= h >>> 16;
-  return (h >>> 0) % 12;
-}
-function characterColour(name) {
-  return CHAR_PALETTE[colourIndex(name)];
-}
-function cueLabel(character, qualifierName) {
-  return qualifierName ? `${character.toUpperCase()} (${qualifierName.toUpperCase()})` : character.toUpperCase();
+  for (let n = 2; used.has(name.toLowerCase()) || name.toLowerCase() === "history"; n++) {
+    const suffix = ` (${n})`;
+    name = tidy2(base.slice(0, SHEET_NAME_MAX - suffix.length)) + suffix;
+  }
+  used.add(name.toLowerCase());
+  return name;
 }
-function qualifierNamer(project) {
-  const names = new Map(projectQualifiers3(project).map((q) => [q.gameId, q.name]));
-  return (gameId) => gameId ? names.get(gameId) ?? gameId : void 0;
+function cellText(v) {
+  if (v == null) return "";
+  if (typeof v === "string") return v;
+  if (typeof v === "number" || typeof v === "boolean") return String(v);
+  if (v instanceof Date) return v.toISOString();
+  if (typeof v !== "object") return "";
+  const o = v;
+  if (Array.isArray(o.richText)) return o.richText.map((run) => cellText(run?.text)).join("");
+  if ("text" in o) return cellText(o.text);
+  if ("result" in o) return cellText(o.result);
+  return "";
 }
-var MARKUP_RE = /<(b|i|bi)>([\s\S]*?)<\/\1>/g;
-var INTERP_RE = /\{@[^}]*\}/g;
-function textRuns(text) {
-  const marked = [];
-  let last = 0;
-  let m;
-  MARKUP_RE.lastIndex = 0;
-  while ((m = MARKUP_RE.exec(text)) !== null) {
-    if (m.index > last) marked.push({ text: text.slice(last, m.index), bold: false, italic: false });
-    const tag = m[1];
-    marked.push({ text: m[2], bold: tag === "b" || tag === "bi", italic: tag === "i" || tag === "bi" });
-    last = MARKUP_RE.lastIndex;
-  }
-  if (last < text.length) marked.push({ text: text.slice(last), bold: false, italic: false });
-  if (!marked.length) marked.push({ text, bold: false, italic: false });
-  const out = [];
-  for (const r of marked) {
-    let li = 0;
-    let im;
-    INTERP_RE.lastIndex = 0;
-    while ((im = INTERP_RE.exec(r.text)) !== null) {
-      if (im.index > li) out.push({ text: r.text.slice(li, im.index), bold: r.bold, italic: r.italic, code: false });
-      out.push({ text: im[0], bold: r.bold, italic: r.italic, code: true });
-      li = INTERP_RE.lastIndex;
+async function catalogToXlsx(catalog) {
+  const { default: ExcelJS } = await import("exceljs");
+  const wb = new ExcelJS.Workbook();
+  wb.creator = "patter";
+  const byScene = /* @__PURE__ */ new Map();
+  for (const e of catalog.entries) (byScene.get(e.scene) ?? byScene.set(e.scene, []).get(e.scene)).push(e);
+  const used = /* @__PURE__ */ new Set([INFO_SHEET.toLowerCase()]);
+  for (const [scene, entries] of byScene) {
+    const ws = wb.addWorksheet(uniqueSheetName(scene, used));
+    ws.columns = [
+      { header: "ID", key: "id", width: 22 },
+      { header: "Source", key: "source", width: 40 },
+      { header: "Translation", key: "translation", width: 40 },
+      { header: "Comments", key: "comments", width: 30 },
+      { header: "Status", key: "status", width: 10 },
+      { header: "Gender", key: "gender", width: 12 },
+      // Hidden: the translator has no use for it, and it is the import's only faithful record of the scene.
+      { header: "Scene", key: "scene", width: 22, hidden: true },
+      // After the hidden Scene column, so the columns an older reader finds by position stay where they were.
+      { header: "Qualifier", key: "qualifier", width: 11 }
+    ];
+    ws.getRow(1).font = { bold: true };
+    ws.views = [{ state: "frozen", ySplit: 1 }];
+    for (const e of entries) {
+      ws.addRow({
+        id: e.id,
+        source: e.source,
+        translation: e.translation,
+        comments: e.comments.join("\n"),
+        status: e.stale ? "stale" : e.translation ? "translated" : "",
+        gender: e.context?.gender ?? "",
+        scene,
+        qualifier: e.context?.qualifier ?? ""
+      });
     }
-    if (li < r.text.length) out.push({ text: r.text.slice(li), bold: r.bold, italic: r.italic, code: false });
   }
-  return out.length ? out : [{ text, bold: false, italic: false, code: false }];
-}
-function targetLabel(to, sceneOf, blockTrail) {
-  if (to === "END") return "END";
-  return blockTrail.get(to) ?? sceneOf.get(to) ?? to;
+  const info = wb.addWorksheet(INFO_SHEET, { state: byScene.size ? "hidden" : "visible" });
+  info.columns = [{ width: 18 }, { width: 40 }];
+  info.addRow([INFO_MARKER]);
+  info.addRow(["Patter reads this sheet to check which language the file is for. Please leave it as it is."]);
+  info.addRow([INFO_LANGUAGE, catalog.locale ?? ""]);
+  info.addRow([INFO_SOURCE, catalog.defaultLocale]);
+  info.addRow([INFO_PROJECT, catalog.project]);
+  return Buffer.from(await wb.xlsx.writeBuffer());
 }
-function gameEventLabel(beat) {
-  const gd = beat.gameData;
-  if (gd && typeof gd === "object") {
-    const parts = Object.entries(gd).map(([k, v]) => {
-      const val = v == null ? "" : typeof v === "object" ? JSON.stringify(v) : String(v);
-      return val === "" ? k : `${k}: ${val}`;
+async function xlsxToCatalog(buffer) {
+  const { default: ExcelJS } = await import("exceljs");
+  const wb = new ExcelJS.Workbook();
+  await wb.xlsx.load(buffer);
+  const entries = [];
+  let locale, defaultLocale = "", project = "";
+  for (const ws of wb.worksheets) {
+    if (cellText(ws.getCell(1, 1).value).trim() === INFO_MARKER) {
+      ws.eachRow((row) => {
+        const label = cellText(row.getCell(1).value).trim(), value = cellText(row.getCell(2).value).trim();
+        if (label === INFO_LANGUAGE && value) locale = checkCatalogField("spreadsheet", "locale", value);
+        else if (label === INFO_SOURCE) defaultLocale = value;
+        else if (label === INFO_PROJECT) project = value;
+      });
+      continue;
+    }
+    const header = ws.getRow(1).values.slice(1).map(cellText);
+    if (header[0] !== HEADERS[0]) continue;
+    const hasSceneColumn = header[SCENE_COLUMN - 1] === "Scene";
+    const sceneOf = (row) => hasSceneColumn ? cellText(row.getCell(SCENE_COLUMN).value).trim() : "";
+    let sheetScene = "";
+    ws.eachRow((row, n) => {
+      if (n > 1 && !sheetScene) sheetScene = sceneOf(row);
+    });
+    ws.eachRow((row, n) => {
+      if (n === 1) return;
+      const cell = (c) => cellText(row.getCell(c).value);
+      const id = cell(1).trim();
+      if (!id) return;
+      const status = cell(5).trim().toLowerCase();
+      const scene = checkCatalogField("spreadsheet", "scene", sceneOf(row) || sheetScene || ws.name);
+      entries.push({
+        id,
+        scene,
+        source: cell(2),
+        translation: cell(3),
+        comments: cell(4) ? cell(4).split("\n").filter(Boolean) : [],
+        stale: status === "stale"
+      });
     });
-    if (parts.length) return `game event \xB7 ${parts.join(", ")}`;
   }
-  return "game event";
+  return { project, defaultLocale, locale, entries };
 }
-function optionTag(node) {
-  const parts = [];
-  if (node.fallback) parts.push("fallback");
-  parts.push(node.sticky ? "repeatable" : "once only");
-  if (node.secretUntilEligible) parts.push("hidden");
-  return parts.join(" \xB7 ");
+
+// src/voice-script.ts
+import { DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES2, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES3, DEFAULT_DOCUMENTATION_CLASSES as DEFAULT_DOCUMENTATION_CLASSES3, projectQualifiers as projectQualifiers3 } from "@patterkit/model";
+function plainVoice(text) {
+  return text.replace(/<\/?(?:b|i|bi)>/g, "").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
 }
-function sequenceLabel(node) {
-  const o = node.options ?? {};
-  const bits = [];
-  if ((o.order ?? "sequential") === "shuffle") bits.push("shuffled");
-  const ex = o.exhaust ?? "once";
-  if (ex === "repeat") bits.push("repeating");
-  else if (ex === "stick") bits.push("holds on the last");
-  return bits.length ? `In sequence \xB7 ${bits.join(", ")}` : "In sequence";
+function groupLabel(node, source) {
+  if (node.prompt) return plainVoice(source[node.prompt.id]?.trim() || "option");
+  if (node.selector === "choice") return "";
+  return node.selector ?? "group";
 }
-function runScriptDoc(loaded, opts = {}) {
+function runVoiceScript(loaded, opts = {}) {
   const { project } = loaded;
+  const everything = !!opts.everything;
+  const ladderDecls = project.writingStatuses ?? DEFAULT_WRITING_STATUSES2;
+  const writingLadder = ladderDecls.map((s) => s.name);
+  const recordingLadder = (project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES3).map((s) => s.name);
+  const stub = writingLadder[0];
+  const recordThreshold = ladderDecls.findIndex((s) => s.readyToRecord);
+  const writingIndex = new Map(writingLadder.map((name, i) => [name, i]));
+  const { writing: writingOf, recording: manualRecordingOf, cut: cutSet, rerecord: rerecordSet, documentation: docsOf } = mergeAuthoring2(loaded);
+  const recordingBase = opts.recordingOverride ?? manualRecordingOf;
+  const recordingOf = (id) => effectiveRecording(id, recordingBase, rerecordSet, recordingLadder[0]);
   const source = sourceStrings(loaded);
-  const { cut, documentation } = mergeAuthoring2(loaded);
-  const noteClasses = opts.notes === void 0 || opts.notes === "all" ? void 0 : classesForChannel(project.documentationClasses ?? DEFAULT_DOCUMENTATION_CLASSES3, opts.notes.channel);
-  const ownNotes = (id) => opts.notes === void 0 ? [] : (documentation.get(id) ?? []).filter((l) => l.type !== void 0 && (noteClasses === void 0 || noteClasses.has(l.type)));
-  const sceneOf = /* @__PURE__ */ new Map();
-  const blockTrail = /* @__PURE__ */ new Map();
-  const blockName = /* @__PURE__ */ new Map();
-  for (const scene of loaded.scenes) {
-    sceneOf.set(scene.id, scene.name);
-    for (const block of scene.blocks) {
-      blockTrail.set(block.id, `${scene.name} \u203A ${block.name}`);
-      blockName.set(block.id, block.name);
-    }
-  }
-  const humanize = (cond) => humanizeNodeRefs(cond, (id) => blockName.get(id) ?? sceneOf.get(id) ?? id);
-  const els = [];
-  const nameOf = qualifierNamer(project);
-  const speaker = (beat) => ({
-    character: beat.character ?? "",
-    ...beat.qualifier ? { qualifier: beat.qualifier, qualifierName: nameOf(beat.qualifier) } : {},
-    direction: beat.direction
-  });
-  const textOf = (id) => source[id] ?? "";
-  const notes = (id, indent, sid) => {
-    for (const l of ownNotes(id)) els.push({ kind: "note", id, indent, snippet: sid, text: l.text, class: l.type });
-  };
-  const jumpText = (j) => {
-    const dest = targetLabel(j.to, sceneOf, blockTrail);
-    return j.mode === "call" ? `${dest} (and return)` : dest;
-  };
-  let snippetSeq = 0;
-  const nextSid = () => ++snippetSeq;
-  const emitBeats = (node, indent, sid) => {
-    for (const beat of node.beats ?? []) {
-      if (cut.has(beat.id)) continue;
-      if (beat.kind === "line") els.push({ kind: "line", id: beat.id, indent, snippet: sid, ...speaker(beat), runs: textRuns(textOf(beat.id)) });
-      else if (beat.kind === "text") els.push({ kind: "narration", id: beat.id, indent, snippet: sid, runs: textRuns(textOf(beat.id)) });
-      else if (beat.kind === "gameEvent") els.push({ kind: "gameEvent", id: beat.id, indent, snippet: sid, text: gameEventLabel(beat) });
-      else continue;
-      notes(beat.id, indent, sid);
-    }
-    if (node.jump) els.push({ kind: "jump", id: node.id, to: node.jump.to, indent, snippet: sid, text: jumpText(node.jump) });
-  };
-  const walk = (node, indent, sid) => {
-    if (cut.has(node.id)) return;
-    if (node.type === "snippet") {
-      if (node.condition) els.push({ kind: "condition", id: node.id, indent, snippet: sid, text: `if ${humanize(node.condition)}` });
-      notes(node.id, indent, sid);
-      emitBeats(node, indent, sid);
-      return;
-    }
-    if (node.condition) els.push({ kind: "condition", id: node.id, indent, snippet: sid, text: `if ${humanize(node.condition)}` });
-    if (node.selector === "choice" || node.selector === "branch" || node.selector === "sequence") {
-    } else notes(node.id, indent, sid);
-    if (node.selector === "choice") {
-      els.push({ kind: "group", id: node.id, indent, label: "Choose" });
-      notes(node.id, indent, sid);
-      for (const child2 of node.children ?? []) {
-        if (cut.has(child2.id)) continue;
-        const cid = nextSid();
-        if (child2.type === "group" && child2.prompt) {
-          if (child2.condition) els.push({ kind: "condition", id: child2.id, indent, snippet: cid, text: `if ${humanize(child2.condition)}` });
-          els.push({ kind: "option", id: child2.prompt.id, node: child2.id, indent, snippet: cid, runs: textRuns(textOf(child2.prompt.id) || "(option)"), tag: optionTag(child2) });
-          notes(child2.id, indent, cid);
-          notes(child2.prompt.id, indent, cid);
-          for (const c of child2.children ?? []) walk(c, indent + 1, cid);
-        } else if (child2.type === "snippet") {
-          const beats = child2.beats ?? [];
-          const first = beats.find((b) => b.kind === "line" || b.kind === "text");
-          if (child2.condition) els.push({ kind: "condition", id: child2.id, indent, snippet: cid, text: `if ${humanize(child2.condition)}` });
-          els.push({ kind: "option", id: first?.id ?? child2.id, node: child2.id, indent, snippet: cid, runs: textRuns(first ? textOf(first.id) || "(option)" : "(option)"), tag: optionTag(child2) });
-          notes(child2.id, indent, cid);
-          if (first) notes(first.id, indent, cid);
-          let seenPrompt = false;
-          for (const beat of beats) {
-            if (!seenPrompt && beat === first) {
-              seenPrompt = true;
-              continue;
-            }
-            if (cut.has(beat.id)) continue;
-            if (beat.kind === "line") els.push({ kind: "line", id: beat.id, indent: indent + 1, snippet: cid, ...speaker(beat), runs: textRuns(textOf(beat.id)) });
-            else if (beat.kind === "text") els.push({ kind: "narration", id: beat.id, indent: indent + 1, snippet: cid, runs: textRuns(textOf(beat.id)) });
-            else if (beat.kind === "gameEvent") els.push({ kind: "gameEvent", id: beat.id, indent: indent + 1, snippet: cid, text: gameEventLabel(beat) });
-            else continue;
-            notes(beat.id, indent + 1, cid);
-          }
-          if (child2.jump) els.push({ kind: "jump", id: child2.id, to: child2.jump.to, indent: indent + 1, snippet: cid, text: jumpText(child2.jump) });
-        } else {
-          walk(child2, indent + 1, cid);
-        }
-      }
-      return;
-    }
-    if (node.selector === "branch") {
-      els.push({ kind: "group", id: node.id, indent, label: "One of \xB7 first match wins" });
-      notes(node.id, indent, sid);
-      const kids2 = (node.children ?? []).filter((c) => !cut.has(c.id));
-      kids2.forEach((child2, i) => {
-        const isCatchAll = i === kids2.length - 1 && kids2.length > 1 && !("condition" in child2 && child2.condition);
-        if (isCatchAll) els.push({ kind: "else", id: child2.id, indent });
-        walk(child2, indent, nextSid());
-      });
+  const actorOf = /* @__PURE__ */ new Map();
+  for (const c of project.cast ?? []) if (c.actor) actorOf.set(c.name, c.actor);
+  const qualifierName = new Map(projectQualifiers3(project).map((q) => [q.gameId, q.name]));
+  const voClasses = classesForChannel(project.documentationClasses ?? DEFAULT_DOCUMENTATION_CLASSES3, "vo");
+  const ownVo = (id) => (docsOf.get(id) ?? []).filter((d) => d.type !== void 0 && voClasses.has(d.type)).map((d) => d.text);
+  const lines = [];
+  const emitLine = (beat, scope, leadingVo) => {
+    if (beat.kind !== "line" || cutSet.has(beat.id)) return false;
+    const ws = writingOf.get(beat.id) ?? stub;
+    if (!everything && recordThreshold !== -1 && (writingIndex.get(ws) ?? 0) < recordThreshold) return false;
+    const own = ownVo(beat.id);
+    lines.push({
+      scope: scope.join(" \u203A "),
+      id: beat.id,
+      character: beat.character ?? "",
+      ...beat.qualifier ? { qualifier: qualifierName.get(beat.qualifier) ?? beat.qualifier } : {},
+      actor: beat.character ? actorOf.get(beat.character) : void 0,
+      ...beat.direction?.trim() ? { direction: plainVoice(beat.direction.trim()) } : {},
+      text: plainVoice(source[beat.id] ?? ""),
+      comments: leadingVo ? [...leadingVo, ...own] : own,
+      // first line of the run gets the enclosing context
+      recordingStatus: recordingOf(beat.id)
+    });
+    return true;
+  };
+  const walkNode = (node, scope, ancestorVo) => {
+    if (node.type === "group") {
+      if (cutSet.has(node.id)) return;
+      const label = groupLabel(node, source);
+      const childScope = label ? [...scope, label] : scope;
+      const childVo = [...ancestorVo, ...ownVo(node.id)];
+      if (node.prompt) emitLine(node.prompt, childScope, childVo);
+      for (const child2 of node.children ?? []) walkNode(child2, childScope, childVo);
       return;
     }
-    if (node.selector === "sequence") {
-      els.push({ kind: "group", id: node.id, indent, label: sequenceLabel(node) });
-      notes(node.id, indent, sid);
-      for (const child2 of node.children ?? []) walk(child2, indent, nextSid());
-      return;
+    if (cutSet.has(node.id)) return;
+    let leading = true;
+    for (const beat of node.beats ?? []) {
+      if (emitLine(beat, scope, leading ? ancestorVo : void 0)) leading = false;
     }
-    for (const child2 of node.children ?? []) walk(child2, indent, sid);
   };
-  const only = opts.scenes ? new Set(opts.scenes) : void 0;
   for (const scene of loaded.scenes) {
-    if (cut.has(scene.id) || only && !only.has(scene.id)) continue;
-    els.push({ kind: "scene", id: scene.id, text: scene.name });
-    notes(scene.id, 0, void 0);
+    if (cutSet.has(scene.id)) continue;
+    const sceneVo = ownVo(scene.id);
     for (const block of scene.blocks) {
-      if (cut.has(block.id)) continue;
-      els.push({ kind: "block", id: block.id, text: block.name });
-      notes(block.id, 0, void 0);
-      for (const child2 of block.children ?? []) walk(child2, 0, void 0);
+      if (cutSet.has(block.id)) continue;
+      const scope = [scene.name, block.name].filter(Boolean);
+      const blockVo = [...sceneVo, ...ownVo(block.id)];
+      for (const child2 of block.children ?? []) walkNode(child2, scope, blockVo);
     }
   }
-  return { project: project.project.name, elements: els };
+  return { project: project.project.id, voiced: project.voiced ?? false, recordingLadder, everything, lines };
+}
+
+// src/voice-script-xlsx.ts
+async function voiceScriptToXlsx(data) {
+  const { default: ExcelJS } = await import("exceljs");
+  const wb = new ExcelJS.Workbook();
+  wb.creator = "patter";
+  const ws = wb.addWorksheet("Voice Script");
+  ws.columns = [
+    { header: "Scope", key: "scope", width: 28 },
+    { header: "Line ID", key: "id", width: 18 },
+    { header: "Character", key: "character", width: 16 },
+    { header: "Qualifier", key: "qualifier", width: 11 },
+    { header: "Actor", key: "actor", width: 16 },
+    { header: "Direction", key: "direction", width: 24 },
+    { header: "Text", key: "text", width: 60 },
+    { header: "Comments", key: "comments", width: 36 },
+    { header: "Status", key: "status", width: 12 }
+  ];
+  ws.getRow(1).font = { bold: true };
+  ws.views = [{ state: "frozen", ySplit: 1 }];
+  for (const l of data.lines) {
+    const row = ws.addRow({
+      scope: l.scope,
+      id: l.id,
+      character: l.character,
+      qualifier: l.qualifier ?? "",
+      actor: l.actor ?? "",
+      direction: l.direction ?? "",
+      text: l.text,
+      comments: l.comments.join("\n"),
+      status: l.recordingStatus
+    });
+    row.getCell("direction").alignment = { wrapText: true, vertical: "top" };
+    row.getCell("text").alignment = { wrapText: true, vertical: "top" };
+    row.getCell("comments").alignment = { wrapText: true, vertical: "top" };
+  }
+  return Buffer.from(await wb.xlsx.writeBuffer());
 }
 
 // src/script-docx.ts
@@ -4249,6 +4539,8 @@ var HANG = 340;
 var RIGHT_TAB = 9020;
 var SNIP_GAP = 170;
 var WITHIN = 30;
+var EFFECT_STYLE = "PatterEffect";
+var EFFECT_STYLE_DEF = { id: EFFECT_STYLE, name: "Patter effect", basedOn: "Normal", quickFormat: false };
 var S = { h1: 32, h2: 26, body: 22, cue: 18, label: 16, tag: 15, mech: 18 };
 function bodyRuns(runs, color, base = {}) {
   return runs.map((r) => r.code ? new TextRun({ text: r.text, font: MONO, color: TOKENS.accent, size: S.body - 2 }) : new TextRun({ text: r.text, font: SERIF, color, size: S.body, bold: base.bold || r.bold || void 0, italics: base.italic || r.italic || void 0 }));
@@ -4277,7 +4569,7 @@ function paragraph(el, prev) {
       });
     case "line": {
       const kids2 = [];
-      if (el.character) kids2.push(new TextRun({ text: cueLabel(el.character, el.qualifierName), font: SANS, bold: true, allCaps: true, color: characterColour(el.character), size: S.cue }), new TextRun({ text: "  ", font: SANS, size: S.cue }));
+      if (el.character) kids2.push(new TextRun({ text: cueLabel(el.character, el.qualifierName), font: SANS, bold: true, allCaps: true, color: characterColour(el.character, el.colour), size: S.cue }), new TextRun({ text: "  ", font: SANS, size: S.cue }));
       if (el.direction) kids2.push(new TextRun({ text: `(${el.direction})  `, font: SERIF, italics: true, color: TOKENS.muted, size: S.body }));
       kids2.push(...bodyRuns(el.runs, TOKENS.inkRead));
       return new Paragraph({ keepLines: true, spacing: { before, after: 20 }, indent: { left: leftOf(el) + DIALOGUE_INDENT + HANG, hanging: HANG }, children: kids2 });
@@ -4286,10 +4578,17 @@ function paragraph(el, prev) {
       return new Paragraph({ keepLines: true, spacing: { before, after: 20 }, indent: { left: leftOf(el) }, children: bodyRuns(el.runs, TOKENS.inkSoft) });
     case "condition":
       return new Paragraph({ keepNext: true, spacing: { before, after: 20 }, indent: { left: leftOf(el) }, children: [new TextRun({ text: `\u2039 ${el.text} \u203A`, font: MONO, color: TOKENS.accent, size: S.mech - 1 })] });
+    case "effect": {
+      const [label, ...rest] = el.text.split(": ");
+      return new Paragraph({ style: EFFECT_STYLE, keepLines: true, spacing: { before, after: 20 }, indent: { left: leftOf(el) }, children: [
+        new TextRun({ text: `${label}: `, font: SANS, italics: true, color: TOKENS.muted, size: S.mech - 1 }),
+        new TextRun({ text: rest.join(": "), font: SANS, color: TOKENS.muted, size: S.mech - 1 })
+      ] });
+    }
     case "group":
       return new Paragraph({ keepNext: true, spacing: { before: 260, after: 60 }, indent: { left: el.indent * STEP }, children: [new TextRun({ text: el.label.toUpperCase(), font: SANS, bold: true, allCaps: true, color: TOKENS.accent, size: S.label, characterSpacing: 14 })] });
     case "else":
-      return new Paragraph({ keepNext: true, spacing: { before: 140, after: 20 }, indent: { left: el.indent * STEP }, children: [new TextRun({ text: "else \xB7 catch-all", font: SANS, allCaps: true, color: TOKENS.muted, size: S.label, characterSpacing: 12 })] });
+      return new Paragraph({ keepNext: true, spacing: { before: 140, after: 20 }, indent: { left: el.indent * STEP }, children: [new TextRun({ text: "else (catch-all)", font: SANS, allCaps: true, color: TOKENS.muted, size: S.label, characterSpacing: 12 })] });
     case "option": {
       const kids2 = [new TextRun({ text: "\u25C7  ", color: TOKENS.accent, size: S.body }), ...bodyRuns(el.runs, TOKENS.ink)];
       if (el.tag) kids2.push(new TextRun({ text: "	", size: S.body }), new TextRun({ text: el.tag, font: SANS, smallCaps: true, color: TOKENS.muted, size: S.tag }));
@@ -4309,7 +4608,7 @@ async function scriptToDocx(doc) {
     new Paragraph({ spacing: { after: 560 }, children: [new TextRun({ text: doc.project, font: SERIF, bold: true, color: TOKENS.ink, size: 52 })] }),
     ...doc.elements.map((el, i) => paragraph(el, doc.elements[i - 1]))
   ];
-  const document = new Document({ creator: "Patter", title: doc.project, sections: [{ children: body }] });
+  const document = new Document({ creator: "Patter", title: doc.project, styles: { paragraphStyles: [EFFECT_STYLE_DEF] }, sections: [{ children: body }] });
   return Packer.toBuffer(document);
 }
 
@@ -4560,7 +4859,7 @@ async function scriptToPdf(doc) {
           }
           const yTop = pdf.y;
           if (cue) {
-            pdf.font("Sans-Bold").fontSize(CUE).fillColor(hex(characterColour(el.character))).text(cue, cueX, yTop + ascentPt("Serif", BODY) - ascentPt("Sans-Bold", CUE), { lineBreak: false });
+            pdf.font("Sans-Bold").fontSize(CUE).fillColor(hex(characterColour(el.character, el.colour))).text(cue, cueX, yTop + ascentPt("Serif", BODY) - ascentPt("Sans-Bold", CUE), { lineBreak: false });
             pdf.y = yTop;
           }
           pdf.fontSize(BODY);
@@ -4575,13 +4874,19 @@ async function scriptToPdf(doc) {
           pdf.fontSize(9.5);
           draw(split(`\u2039 ${el.text} \u203A`, "Mono", ACCENT), cx, { width: w });
           break;
+        case "effect": {
+          const at = el.text.indexOf(": ");
+          pdf.fontSize(8.5);
+          draw([...split(el.text.slice(0, at + 2), "Serif-Italic", MUTED), ...split(el.text.slice(at + 2), "Sans", MUTED)], cx, { width: w, lineGap: 2 });
+          break;
+        }
         case "group":
           pdf.fontSize(8);
           draw(split(el.label.toUpperCase(), "Sans-Bold", ACCENT), cx, { width: w, characterSpacing: 1.2 });
           break;
         case "else":
           pdf.fontSize(8);
-          draw(split("ELSE \xB7 CATCH-ALL", "Sans", MUTED), cx, { width: w, characterSpacing: 1 });
+          draw(split("ELSE (CATCH-ALL)", "Sans", MUTED), cx, { width: w, characterSpacing: 1 });
           break;
         case "option": {
           const ox = cx + HANG2;
@@ -4684,6 +4989,8 @@ function runInit(opts) {
     schema: PROJECT_SCHEMA,
     project: { id: newId("proj"), name },
     locales: { default: "en", all: ["en"] },
+    start: { scene: sceneId },
+    // the one scene is where the story starts
     ...opts.vcs ? { vcs: opts.vcs } : {},
     // record the chosen VCS so it can be read / switched later
     voiced: true
@@ -4758,7 +5065,7 @@ indent_size = 2
 `;
 
 // src/resolve.ts
-import { walkNodes as walkNodes3, effectiveGameId as effectiveGameId2, DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES3, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES4 } from "@patterkit/model";
+import { walkNodes as walkNodes4, effectiveGameId as effectiveGameId2, DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES3, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES4 } from "@patterkit/model";
 import { defaultFor } from "@wildwinter/scoperegistry";
 import { parseFieldQuery, fieldNameMatches, fieldValueMatches, fieldValueText } from "@wildwinter/toolkit";
 function runResolve(loaded, query) {
@@ -4814,7 +5121,7 @@ function runStatusBrowse(loaded, status, dimension = "writing", focus, recording
         if (statusAt(beat.id) !== status) return;
         out.push({ id: beat.id, kind: "beat", text: strings[beat.id], location: segments, sceneId: scene.id, file });
       };
-      walkNodes3(block.children, (node) => {
+      walkNodes4(block.children, (node) => {
         if (node.type === "group") {
           if (node.prompt) consider(node.prompt);
           return;
@@ -4835,7 +5142,7 @@ function listProjectTags(loaded) {
     add(scene.tags);
     for (const block of scene.blocks) {
       add(block.tags);
-      walkNodes3(block.children, (node) => {
+      walkNodes4(block.children, (node) => {
         add(node.tags);
         if (node.type === "group") {
           add(node.prompt?.tags);
@@ -4858,7 +5165,7 @@ function runTagBrowse(loaded, tag, focus) {
     for (const block of scene.blocks) {
       const segments = [scene.name, block.name];
       if (has(block.tags)) out.push({ id: block.id, kind: "block", name: block.name, gameId: effectiveGameId2(block), location: segments, sceneId: scene.id, file });
-      walkNodes3(block.children, (node) => {
+      walkNodes4(block.children, (node) => {
         if (has(node.tags)) {
           const preview = node.type === "group" ? node.prompt ? strings[node.prompt.id] : void 0 : strings[node.beats?.[0]?.id ?? ""];
           out.push({ id: node.id, kind: node.type, text: preview, location: segments, sceneId: scene.id, file });
@@ -4893,7 +5200,7 @@ function runPropertyUsage(loaded, query, focus) {
     }
     for (const block of scene.blocks) {
       const segments = [scene.name, block.name];
-      walkNodes3(block.children, (node) => {
+      walkNodes4(block.children, (node) => {
         if (refs(node.condition) && valueOk(node.condition)) push(node.id, node.type, segments, `if ${node.condition}`);
         if (node.type === "group") {
           if (node.prompt && refs(strings[node.prompt.id]) && valueOk(strings[node.prompt.id])) push(node.prompt.id, "beat", segments, strings[node.prompt.id]);
@@ -4949,7 +5256,7 @@ function runFieldBrowse(loaded, query, focus) {
       const segments = [scene.name, block.name];
       visit("block", block.gameData, { id: block.id, kind: "block", name: block.name, gameId: effectiveGameId2(block), location: segments });
       const options = /* @__PURE__ */ new Set();
-      walkNodes3(block.children, (node) => {
+      walkNodes4(block.children, (node) => {
         if (node.type === "group") {
           if (node.selector === "choice") {
             for (const c of node.children) if (c.type === "group") options.add(c.id);
@@ -5018,7 +5325,7 @@ function buildIndex(loaded) {
         sceneId: scene.id,
         file
       });
-      walkNodes3(block.children, (node) => {
+      walkNodes4(block.children, (node) => {
         out.push({
           id: node.id,
           kind: node.type,
@@ -5056,7 +5363,7 @@ function buildIndex(loaded) {
 
 // src/replace.ts
 import { canonicalStringify as canonicalStringify9 } from "@patterkit/core";
-import { walkNodes as walkNodes4, PROJECT_LOCALE_SCENE as PROJECT_LOCALE_SCENE3, AUTHORING_SCHEMA as AUTHORING_SCHEMA2, FLOW_SCHEMA as FLOW_SCHEMA2 } from "@patterkit/model";
+import { walkNodes as walkNodes5, PROJECT_LOCALE_SCENE as PROJECT_LOCALE_SCENE3, AUTHORING_SCHEMA as AUTHORING_SCHEMA2, FLOW_SCHEMA as FLOW_SCHEMA2 } from "@patterkit/model";
 import { findMatcher } from "@wildwinter/toolkit";
 function runReplace(loaded, opts) {
   const plan = { hits: [], writes: [], shards: [], authoring: [], flows: [], scenes: 0 };
@@ -5072,7 +5379,7 @@ function runReplace(loaded, opts) {
     sceneName.set(scene.id, scene.name);
     for (const block of scene.blocks) {
       const segs = [scene.name, block.name];
-      walkNodes4(block.children, (node) => {
+      walkNodes5(block.children, (node) => {
         if (node.type === "group") {
           if (node.prompt) locOf.set(node.prompt.id, segs);
           return;
@@ -5154,7 +5461,7 @@ function runReplace(loaded, opts) {
       for (const block of scene.blocks) {
         const segs = [scene.name, block.name];
         visit("block", block, segs);
-        walkNodes4(block.children, (node) => {
+        walkNodes5(block.children, (node) => {
           if (node.type === "group") {
             if (node.selector === "choice") {
               for (const option of node.children) if (option.type === "group") visit("option", option, segs);
@@ -5177,110 +5484,6 @@ function runReplace(loaded, opts) {
   return plan;
 }
 
-// src/stages.ts
-import { parse, renameStageInExpression, stageGateCount as gatesIn } from "@wildwinter/expr";
-import { dialectWithForeignScopes } from "@patterkit/dialect";
-import { hostScopesToSpec as hostScopesToSpec2, projectScopes as projectScopes2 } from "@patterkit/compiler";
-import { walkNodes as walkNodes5 } from "@patterkit/model";
-function stageDialect(project, gameScopes) {
-  return dialectWithForeignScopes(hostScopesToSpec2(projectScopes2(project, gameScopes?.merged).host));
-}
-var refersTo = (target) => (scope, name) => scope === target.scope && name === target.name;
-function effectTarget(ref, dialect) {
-  try {
-    const n = parse(ref, dialect);
-    return n.kind === "scopedvar" ? { scope: n.scope, name: n.name } : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function sceneSites(scene) {
-  const sites = [];
-  const effects = (list) => {
-    for (const e of list ?? []) {
-      sites.push({ get: () => e.value, set: (src) => {
-        e.value = src;
-      }, assignedTo: e.target });
-    }
-  };
-  effects(scene.onEntry);
-  for (const block of scene.blocks) {
-    walkNodes5(block.children, (node) => {
-      if (typeof node.condition === "string") {
-        sites.push({ get: () => node.condition, set: (src) => {
-          node.condition = src;
-        } });
-      }
-      if (node.type === "snippet") {
-        effects(node.onEnter);
-        effects(node.onExit);
-      }
-    });
-  }
-  return sites;
-}
-var reach = (scenes, target) => target.scope === "scene" ? scenes.filter((s) => s.id === target.scene) : scenes;
-function renameStage(scenes, target, from, to, dialect) {
-  const result = { scenes: [], expressions: 0 };
-  if (to.trim() === "" || from === to) return result;
-  const isTarget = refersTo(target);
-  for (const scene of reach(scenes, target)) {
-    let changed = false;
-    for (const site of sceneSites(scene)) {
-      const src = site.get();
-      if (src === void 0) continue;
-      const t = site.assignedTo !== void 0 ? effectTarget(site.assignedTo, dialect) : void 0;
-      const next = renameStageInExpression(src, dialect, isTarget, from, to, t !== void 0 && isTarget(t.scope, t.name));
-      if (next === void 0) continue;
-      site.set(next);
-      result.expressions++;
-      changed = true;
-    }
-    if (changed) result.scenes.push(scene);
-  }
-  return result;
-}
-function stageGateCount(scenes, target, dialect) {
-  const isTarget = refersTo(target);
-  let count = 0;
-  for (const scene of reach(scenes, target)) {
-    for (const site of sceneSites(scene)) {
-      const src = site.get();
-      if (src !== void 0) count += gatesIn(src, dialect, isTarget);
-    }
-  }
-  return count;
-}
-function renameGameDataStage(scenes, kind, field, from, to) {
-  const result = { scenes: [], values: 0 };
-  if (to.trim() === "" || from === to) return result;
-  for (const scene of scenes) {
-    let changed = false;
-    const visit = (holder) => {
-      if (holder.gameData?.[field] !== from) return;
-      holder.gameData[field] = to;
-      result.values++;
-      changed = true;
-    };
-    if (kind === "scene") visit(scene);
-    for (const block of scene.blocks) {
-      if (kind === "block") visit(block);
-      walkNodes5(block.children, (node) => {
-        if (node.type !== "snippet") {
-          if (kind === "option" && node.selector === "choice") {
-            for (const option of node.children) if (option.type === "group") visit(option);
-          }
-          return;
-        }
-        if (kind === "snippet") visit(node);
-        for (const beat of node.beats ?? []) if (beat.kind === kind) visit(beat);
-      });
-    }
-    if (changed) result.scenes.push(scene);
-  }
-  return result;
-}
-
 // src/pin.ts
 import { readFileSync as readFileSync11 } from "fs";
 import { canonicalStringify as canonicalStringify10, parseSource as parseSource7 } from "@patterkit/core";
@@ -5548,8 +5751,190 @@ function containedWrite(dir, name) {
   return full;
 }
 
+// src/resolutions.ts
+import { readFileSync as readFileSync13 } from "fs";
+import { canonicalStringify as canonicalStringify12, parseSource as parseSource9 } from "@patterkit/core";
+import { DEFAULT_QUALIFIERS as DEFAULT_QUALIFIERS2 } from "@patterkit/model";
+import { clearUnresolved, unresolvedOf } from "@wildwinter/toolkit/extensions";
+var ResolutionError = class extends Error {
+};
+var isObj2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var UNSETTABLE_KINDS = /* @__PURE__ */ new Set(["moved", "structural"]);
+function isSettableClash(clash) {
+  if (typeof clash.kind !== "string" || UNSETTABLE_KINDS.has(clash.kind)) return false;
+  return !clash.path.endsWith(":order");
+}
+function unresolvedClashes(shard) {
+  const out = [];
+  for (const e of unresolvedOf(shard) ?? []) {
+    if (!isObj2(e) || typeof e["path"] !== "string") continue;
+    const c = { path: e["path"], kind: typeof e["kind"] === "string" ? e["kind"] : "" };
+    if ("base" in e) c.base = e["base"];
+    if ("ours" in e) c.ours = e["ours"];
+    if ("theirs" in e) c.theirs = e["theirs"];
+    out.push(c);
+  }
+  return out;
+}
+function clashPathSegments(path) {
+  const p = path.endsWith(":order") ? path.slice(0, -":order".length) : path;
+  const out = [];
+  let i = 0;
+  while (i < p.length) {
+    if (p[i] === ".") {
+      i++;
+      continue;
+    }
+    if (p[i] === "[") {
+      if (p[i + 1] === '"') {
+        let j2 = i + 2;
+        while (j2 < p.length && !(p[j2] === '"' && p[j2 - 1] !== "\\")) j2++;
+        let key;
+        try {
+          key = JSON.parse(p.slice(i + 1, j2 + 1));
+        } catch {
+          key = p.slice(i + 2, j2);
+        }
+        out.push({ key, bracket: false });
+        i = p.indexOf("]", j2) + 1 || p.length;
+        continue;
+      }
+      const end = p.indexOf("]", i);
+      out.push({ key: p.slice(i + 1, end < 0 ? p.length : end), bracket: true });
+      i = end < 0 ? p.length : end + 1;
+      continue;
+    }
+    let j = i;
+    while (j < p.length && p[j] !== "." && p[j] !== "[") j++;
+    out.push({ key: p.slice(i, j), bracket: false });
+    i = j;
+  }
+  return out;
+}
+function elementMatches(el, key) {
+  if (!isObj2(el)) return false;
+  if (el["id"] === key || el["name"] === key || el["gameId"] === key) return true;
+  return "ts" in el && `${String(el["author"] ?? "")}|${String(el["ts"] ?? "")}` === key;
+}
+function valueAtClashPath(shard, path) {
+  let at = shard;
+  for (const { key } of clashPathSegments(path)) {
+    if (Array.isArray(at)) at = at.find((el) => elementMatches(el, key));
+    else if (isObj2(at)) at = at[key];
+    else return void 0;
+  }
+  return at;
+}
+var DOTTED_LISTS = /* @__PURE__ */ new Set(["qualifiers", "suggestions"]);
+function emptyContainer(key, next, depth) {
+  if (depth === 0 && key === "qualifiers") return structuredClone(DEFAULT_QUALIFIERS2);
+  return next.bracket || depth === 0 && DOTTED_LISTS.has(key) ? [] : {};
+}
+function setAtPath(root, path, value) {
+  const segs = clashPathSegments(path);
+  if (segs.length === 0) throw new ResolutionError(`"${path}" doesn't name a place in the shard`);
+  const chain = [];
+  let at = root;
+  for (let i = 0; i < segs.length - 1; i++) {
+    const key = segs[i].key;
+    let next;
+    if (Array.isArray(at)) {
+      next = at.find((el) => elementMatches(el, key));
+      if (next === void 0) {
+        if (value === void 0) return;
+        throw new ResolutionError(`"${path}": nothing in the shard is "${key}", so their value has nowhere to go`);
+      }
+    } else {
+      next = at[key];
+      if (next === void 0) {
+        if (value === void 0) return;
+        next = emptyContainer(key, segs[i + 1], i);
+        at[key] = next;
+      }
+    }
+    if (!isObj2(next) && !Array.isArray(next)) throw new ResolutionError(`"${path}": "${key}" isn't an object or a list`);
+    chain.push({ parent: at, key });
+    at = next;
+  }
+  const last = segs[segs.length - 1].key;
+  if (Array.isArray(at)) {
+    const i = at.findIndex((el) => elementMatches(el, last));
+    if (value === void 0) {
+      if (i >= 0) at.splice(i, 1);
+    } else if (i >= 0) at[i] = value;
+    else at.push(value);
+  } else if (value === void 0) {
+    delete at[last];
+  } else {
+    at[last] = value;
+  }
+  if (value !== void 0) return;
+  let child2 = at;
+  for (let i = chain.length - 1; i >= 0; i--) {
+    if (!isObj2(child2) || Object.keys(child2).length > 0) break;
+    const { parent, key } = chain[i];
+    if (Array.isArray(parent)) break;
+    if (parent === root) break;
+    delete parent[key];
+    child2 = parent;
+  }
+}
+function applyResolutions(shardText, decisions) {
+  const shard = parseSource9(shardText);
+  if (!isObj2(shard)) throw new ResolutionError("the shard isn't an object");
+  const clashes = new Map(unresolvedClashes(shard).map((c) => [c.path, c]));
+  const out = structuredClone(shard);
+  for (const { path, decision } of decisions) {
+    const clash = clashes.get(path);
+    if (!clash) throw new ResolutionError(`no unresolved clash at "${path}"`);
+    if (decision !== "theirs") continue;
+    if (!isSettableClash(clash)) throw new ResolutionError(`the clash at "${path}" (${clash.kind}) isn't one value, so theirs can't be written: keep ours, or edit it and mark it resolved`);
+    setAtPath(out, path, structuredClone(clash.theirs));
+  }
+  return canonicalStringify12(clearUnresolved(out, decisions.map((d) => d.path)));
+}
+function findMarkedShards(root) {
+  const tree = walkFilesByExt(root, [...SHARD_EXTENSIONS, CONFLICT_SIDECAR]);
+  const sidecars = new Set(tree.get(CONFLICT_SIDECAR));
+  const out = [];
+  for (const file of SHARD_EXTENSIONS.flatMap((ext) => tree.get(ext)).sort()) {
+    let text;
+    try {
+      text = readFileSync13(file, "utf8");
+    } catch {
+      continue;
+    }
+    if (!text.includes("unresolved")) continue;
+    let shard;
+    try {
+      shard = parseSource9(text);
+    } catch {
+      continue;
+    }
+    if (!isObj2(shard) || unresolvedOf(shard) === void 0) continue;
+    const found = { file, shard, clashes: unresolvedClashes(shard) };
+    const sidecarPath = `${file}${CONFLICT_SIDECAR}`;
+    if (sidecars.has(sidecarPath)) {
+      found.sidecarPath = sidecarPath;
+      try {
+        const s = JSON.parse(readFileSync13(sidecarPath, "utf8"));
+        found.sidecar = { ...typeof s.type === "string" ? { type: s.type } : {}, conflicts: Array.isArray(s.conflicts) ? s.conflicts : [], warnings: Array.isArray(s.warnings) ? s.warnings : [] };
+      } catch {
+      }
+    }
+    out.push(found);
+  }
+  return out;
+}
+
 // src/cast-rename.ts
 import { castStringKey as castStringKey2, speakerLabelKey as speakerLabelKey2, walkNodes as walkNodes6 } from "@patterkit/model";
+function keepCastColours(cast, renames) {
+  for (const [from, to] of renames) {
+    const m = cast.find((c) => c.name === to);
+    if (m && !isColourSlot(m.colour)) m.colour = colourIndex(from);
+  }
+}
 function cleanCastRenames(renames) {
   const out = /* @__PURE__ */ new Map();
   for (const [from, to] of Object.entries(renames ?? {})) if (from && to && from !== to) out.set(from, to);
@@ -5607,8 +5992,8 @@ function renameCastStrings(loc, renames) {
 }
 
 // src/suggestions.ts
-import { readFileSync as readFileSync13 } from "fs";
-import { canonicalStringify as canonicalStringify12, parseSource as parseSource9 } from "@patterkit/core";
+import { readFileSync as readFileSync14 } from "fs";
+import { canonicalStringify as canonicalStringify13, parseSource as parseSource10 } from "@patterkit/core";
 import { walkNodes as walkNodes7, AUTHORING_SCHEMA as AUTHORING_SCHEMA3 } from "@patterkit/model";
 function staleParts(s, liveText, line) {
   const stale = [];
@@ -5694,7 +6079,7 @@ var Working = class {
     if (!path) return void 0;
     let file = this.flows.get(path);
     if (!file) {
-      const onDisk = parseSource9(readFileSync13(path, "utf8"));
+      const onDisk = parseSource10(readFileSync14(path, "utf8"));
       const scene = this.loaded.scenes.find((s) => s.id === sceneId);
       file = { ...onDisk, scene: structuredClone(scene ?? onDisk.scene) };
       this.flows.set(path, file);
@@ -5702,7 +6087,7 @@ var Working = class {
     return { path, file };
   }
   writes() {
-    return [...this.locs, ...this.flows, ...this.authoring].filter(([path]) => this.touched.has(path)).map(([path, file]) => ({ path, content: canonicalStringify12(file) })).sort((a, b) => a.path.localeCompare(b.path));
+    return [...this.locs, ...this.flows, ...this.authoring].filter(([path]) => this.touched.has(path)).map(([path, file]) => ({ path, content: canonicalStringify13(file) })).sort((a, b) => a.path.localeCompare(b.path));
   }
 };
 function beatIn(scene, id) {
@@ -5866,6 +6251,7 @@ async function exportEditableScript(loaded, opts) {
   const lines = {};
   const skeleton = [];
   for (const el of doc.elements) {
+    if (el.kind === "effect") continue;
     if (isEditable(el)) {
       const code = markerOf.get(el);
       const baseline = source[el.id] ?? "";
@@ -5910,10 +6296,11 @@ async function exportEditableScript(loaded, opts) {
   const document = new Document2({
     creator: "Patter",
     title: `${loaded.project.project.name} (editable script)`,
+    styles: { paragraphStyles: [EFFECT_STYLE_DEF] },
     sections: [{
       properties: { page: { size: { width: 11906, height: 16838 } } },
       headers: { default: new Header({ children: [new Paragraph2({ children: [
-        new TextRun2({ text: `${loaded.project.project.name} \xB7 Editable script \xB7 Handoff ${id} \xB7 exported ${date} \xB7 Please keep the grey [#\u2026] markers`, font: SANS, size: 15, color: TOKENS.muted })
+        new TextRun2({ text: `${loaded.project.project.name}: editable script. Handoff ${id}, exported ${date}. Please keep the grey [#\u2026] markers`, font: SANS, size: 15, color: TOKENS.muted })
       ] })] }) },
       children: body
     }]
@@ -5926,7 +6313,7 @@ function contextText(el) {
     case "group":
       return el.label;
     case "else":
-      return "else \xB7 catch-all";
+      return "else (catch-all)";
     default:
       return el.text;
   }
@@ -5936,7 +6323,7 @@ function box(el, code, status) {
   const textW = Math.max(MIN_TEXT, FULL - ind - LEAD2 - MARGIN2);
   const cell = (children, width, extra = {}) => new TableCell({ width: { size: width, type: WidthType.DXA }, borders: { top: NONE, bottom: NONE, left: NONE, right: NONE }, margins: { top: 60, bottom: 60, left: 100, right: 100 }, children, ...extra });
   const lead = [];
-  if (el.kind === "line" && el.character) lead.push(new TextRun2({ text: cueLabel(el.character, el.qualifierName), font: SANS, bold: true, allCaps: true, size: S.cue, color: characterColour(el.character) }));
+  if (el.kind === "line" && el.character) lead.push(new TextRun2({ text: cueLabel(el.character, el.qualifierName), font: SANS, bold: true, allCaps: true, size: S.cue, color: characterColour(el.character, el.colour) }));
   if (el.kind === "line" && el.direction) lead.push(new TextRun2({ text: `(${el.direction})`, font: SERIF, italics: true, size: S.cue, color: TOKENS.muted, break: el.character ? 1 : 0 }));
   if (el.kind === "option") lead.push(new TextRun2({ text: "\u25C7", color: TOKENS.accent, size: S.body }));
   const ink = el.kind === "narration" ? TOKENS.inkSoft : el.kind === "option" ? TOKENS.ink : TOKENS.inkRead;
@@ -6000,7 +6387,7 @@ function frontPage(loaded, handoff, opts, now) {
     p("How to edit this script", { bold: true, size: 24, color: TOKENS.ink, after: 120 }),
     item("1.", "Change the words inside the shaded boxes. That's all that can be edited."),
     item("2.", "Don't delete, copy, or move the boxes, or change the grey markers like [#K7Q2M] beside them. If you want a line cut, delete its words but leave the box, or leave a comment."),
-    item("3.", "Everything outside the boxes (scene and block headings, speaker names, conditions, choices, jumps, and game events) is there to show you how the story flows. Comment on it rather than editing it."),
+    item("3.", "Everything outside the boxes (scene and block headings, speaker names, conditions, choices, jumps, game events, and effects) is there to show you how the story flows. Comment on it rather than editing it."),
     item("4.", "Use comments freely. You can also type a note inside a box like [[this]]."),
     p("How to read the structure", { bold: true, size: 24, color: TOKENS.ink, before: 280, after: 120 }),
     item("CHOOSE", "The player picks one of the options marked \u25C7."),
@@ -6009,6 +6396,7 @@ function frontPage(loaded, handoff, opts, now) {
     item("\u2039 if \u2026 \u203A", "This only happens when the condition holds."),
     item("\u21AA", "The story carries on somewhere else."),
     item("\u2699", "Something happens in the game here."),
+    item("On begin / On end", "What the story changes as it passes through, before or after the lines it sits with."),
     item("once only", "An option that disappears once it has been picked; repeatable ones stay."),
     p("Words like {@name} in a different typeface are filled in by the game. Keep them exactly as they are, braces included, though they can move within a line.", { before: 160 }),
     new Paragraph2({ children: [new PageBreak()] })
@@ -6021,7 +6409,7 @@ function castPage(loaded, elements) {
   return [
     new Paragraph2({ spacing: { after: 200 }, children: [new TextRun2({ text: "Cast", font: SERIF, bold: true, size: S.h1, color: TOKENS.ink })] }),
     ...cast.map((c) => new Paragraph2({ spacing: { after: 100 }, children: [
-      new TextRun2({ text: c.name.toUpperCase(), font: SANS, bold: true, size: S.cue, color: characterColour(c.name) }),
+      new TextRun2({ text: c.name.toUpperCase(), font: SANS, bold: true, size: S.cue, color: characterColour(c.name, c.colour) }),
       ...c.notes ? [new TextRun2({ text: `   ${c.notes}`, font: SERIF, size: S.body, color: TOKENS.inkRead })] : []
     ] })),
     new Paragraph2({ children: [new PageBreak()] })
@@ -6221,6 +6609,7 @@ function readRow(tr, indent) {
     ...indent !== void 0 ? { indent } : {}
   };
 }
+var EFFECT_LABEL = /^\s*On (begin|end):\s/i;
 function readBody(body) {
   const items = [];
   for (const e of kids(body)) {
@@ -6229,7 +6618,10 @@ function readBody(body) {
       const c = new Collector();
       c.walk(e, "both");
       const style = attr(child(child(e, "pPr") ?? e, "pStyle"), "val");
-      items.push({ kind: "paragraph", text: c.read(), ...style ? { style } : {} });
+      const text = c.read();
+      const phase = EFFECT_LABEL.exec(text.original.replace(/<\/?(?:b|i|bi)>/g, ""))?.[1]?.toLowerCase();
+      if (style === EFFECT_STYLE || phase) items.push({ kind: "effect", phase: phase === "end" ? "end" : "begin", text });
+      else items.push({ kind: "paragraph", text, ...style ? { style } : {} });
     } else if (name === "tbl") {
       const tblPr = child(e, "tblPr");
       const ind = tblPr ? attr(child(tblPr, "tblInd"), "w") : void 0;
@@ -6308,7 +6700,7 @@ async function readEditableDocx(bytes) {
 }
 
 // src/editable-import.ts
-import { canonicalStringify as canonicalStringify13 } from "@patterkit/core";
+import { canonicalStringify as canonicalStringify14 } from "@patterkit/core";
 import { AUTHORING_SCHEMA as AUTHORING_SCHEMA4, projectQualifiers as projectQualifiers4 } from "@patterkit/model";
 var REFUSE_MISSING_SHARE = 0.25;
 var tidy = (s) => s.replace(/[\s   ]+/g, " ").trim();
@@ -6576,7 +6968,7 @@ function planEditableImport(loaded, returned, opts) {
     const af = shardFor(c.anchor);
     af.comments = [...af.comments ?? [], c];
   }
-  let writes = [...shards].map(([path, af]) => ({ path, content: canonicalStringify13(af) }));
+  let writes = [...shards].map(([path, af]) => ({ path, content: canonicalStringify14(af) }));
   if (opts.direct && suggestions.length) {
     const warned = new Set(problems.filter((p) => p.severity === "warning" && p.anchor).map((p) => p.anchor));
     const clean = suggestions.filter((s) => (live[s.anchor] ?? "") === s.baseline && !warned.has(s.anchor));
@@ -6689,6 +7081,7 @@ function alignParagraphs(items, skeleton, codeOfBox, onEdited, onAdded, lineIdOf
     return rows;
   };
   let boxIndex = -1, gap = [], lastLine;
+  let beforeNext = [];
   const settle = (to, near) => {
     const rows = rowsBefore(to);
     const unmatchedItems = [];
@@ -6722,14 +7115,21 @@ function alignParagraphs(items, skeleton, codeOfBox, onEdited, onAdded, lineIdOf
       const line = code ? lineIdOf(code) : void 0;
       if (line) {
         lastLine = line;
-        note([...item.text.comments, ...item.lead.comments, ...item.margin.comments], line);
+        note([...beforeNext, ...item.text.comments, ...item.lead.comments, ...item.margin.comments], line);
+        beforeNext = [];
       }
       continue;
     }
+    if (item.kind === "effect") {
+      if (item.phase === "end") note(item.text.comments, lastLine);
+      else beforeNext.push(...item.text.comments);
+      continue;
+    }
     if (item.text.proposed.trim() === "" && item.text.original.trim() === "" && !item.text.comments.length) continue;
     gap.push(item);
   }
   settle(segments.length - 1, boxIndex);
+  note(beforeNext, lastLine);
   return anchors;
 }
 export {
@@ -6748,6 +7148,7 @@ export {
   PROJECT_HANDLED,
   RARE_REACH_PCT,
   REFUSE_MISSING_SHARE,
+  ResolutionError,
   SCRIPT_FONT_FILES,
   SCRIPT_FONT_PACKAGES,
   SHARD_EXTENSIONS,
@@ -6756,6 +7157,7 @@ export {
   actionTextChanges,
   actionTextIds,
   applyLoc,
+  applyResolutions,
   applySceneOrder,
   applySuggestionDecisions,
   applyWrites,
@@ -6766,23 +7168,30 @@ export {
   authoringPath,
   besideBundlePath,
   bundleOutputPath,
+  castColours,
   catalogToJson,
   catalogToPo,
   catalogToXlsx,
+  characterColour,
+  clashPathSegments,
   classesForChannel,
   cleanCastRenames,
+  compareLocTokens,
   compileLoaded,
   cueLabel,
   currentBundlePosture,
   defaultBundlePath,
   defaultGameScopesDir,
   describeLocExport,
+  describeLocImport,
   detectMergeType,
   discoverGameScopes,
   drivableScopes,
+  effectDescriber,
   exportBlockers,
   exportEditableScript,
   extractLoc,
+  findMarkedShards,
   findProjectFile,
   formatMarker,
   gameScopeTokens,
@@ -6791,9 +7200,12 @@ export {
   handoffPath,
   handoffWrite,
   hostScopeTokens,
+  importLocale,
+  isSettableClash,
   isUnsafeEntry2 as isUnsafeEntry,
   issueMarkerCodes,
   jsonToCatalog,
+  keepCastColours,
   leastReachedFirst,
   listGameDataFields,
   listOpenSuggestions,
@@ -6801,6 +7213,7 @@ export {
   loadProject,
   loadProjectLanding,
   loadedExtensions,
+  locLineHomes,
   manifestPath,
   markerLength,
   moveCastKeys,
@@ -6882,8 +7295,10 @@ export {
   stageDialect,
   stageGateCount,
   staleParts,
+  unresolvedClashes,
   unresolvedMarkIssues,
   useScriptFontFiles,
+  valueAtClashPath,
   vcsConfigWrites,
   voiceScriptToXlsx,
   worldSettingsScopes,