@patterkit/ops 0.13.0 → 0.14.0

package/dist/index.js

@@ -2,7 +2,7 @@
 import { readdirSync as readdirSync2, readFileSync as readFileSync2, statSync, existsSync as existsSync2 } from "fs";
 import { join as join2, dirname as dirname2, resolve as resolve2, basename } from "path";
 import { parseSource } from "@patterkit/core";
-import { isCaseOnlyPropertyName } from "@patterkit/model";
+import { isCaseOnlyPropertyName, projectLayout } from "@patterkit/model";
 
 // src/game-scopes.ts
 import { existsSync, readdirSync, readFileSync } from "fs";
@@ -68,7 +68,13 @@ function gameScopesSnapshot(root, project) {
     names = readdirSync(found.dir).filter((n) => n.endsWith(SCOPES_FILE_SUFFIX)).sort();
   } catch {
   }
-  return names.map((fileName) => ({ fileName, text: readFileSync(join(found.dir, fileName), "utf8") }));
+  return names.flatMap((fileName) => {
+    try {
+      return [{ fileName, text: readFileSync(join(found.dir, fileName), "utf8") }];
+    } catch {
+      return [];
+    }
+  });
 }
 function patterScopesFile(project) {
   const declarations = (project.properties ?? []).filter((p) => p.shared ?? true).map((p) => ({
@@ -266,6 +272,22 @@ function walkFiles(dir, ext) {
   }
   return out.sort();
 }
+function walkFilesByExt(dir, exts) {
+  const out = new Map(exts.map((ext) => [ext, []]));
+  const walk = (d) => {
+    for (const e of readDirSafe(d)) {
+      if (e.name.startsWith(".")) continue;
+      const p = join2(d, e.name);
+      if (e.isDirectory()) walk(p);
+      else if (e.isFile()) {
+        for (const ext of exts) if (e.name.endsWith(ext)) out.get(ext).push(p);
+      }
+    }
+  };
+  walk(dir);
+  for (const files of out.values()) files.sort();
+  return out;
+}
 function findProjectFile(startPath) {
   let dir = resolve2(startPath);
   try {
@@ -350,7 +372,7 @@ function sceneIdForShard(shardPath) {
     if (p.endsWith(".patterx")) {
       const projectFile = findProjectFile(p);
       const project = parseFile(projectFile, "patter/project", "project");
-      const flowDir = join2(dirname2(projectFile), project.layout?.flow ?? "scenes/");
+      const flowDir = join2(dirname2(projectFile), projectLayout(project).flow);
       const flowPath = join2(flowDir, basename(p).replace(/\.patterx$/, ".patterflow"));
       return parseSource(readFileSync2(flowPath, "utf8")).scene?.id;
     }
@@ -362,7 +384,7 @@ function loadProjectLanding(startPath, opts) {
   const projectFile = findProjectFile(startPath);
   const root = dirname2(projectFile);
   const project = parseFile(projectFile, "patter/project", "project");
-  const layout = { flow: "scenes/", strings: "loc/", authoring: "authoring/", ...project.layout };
+  const layout = projectLayout(project);
   const flowFiles = walkFiles(join2(root, layout.flow), ".patterflow");
   const launchPath = opts?.launchPath ? resolve2(opts.launchPath) : void 0;
   let landingFile;
@@ -407,10 +429,10 @@ function loadProjectLanding(startPath, opts) {
     if (!found) {
       for (const f of walkFiles(strings, ".patterloc")) {
         const loc = parseFile(f, "patter/strings", "strings");
-        if (loc.scene !== landingScene.id) continue;
+        if (loc.scene !== landingScene.id || loc.locale !== defaultLocale) continue;
         locales.push(loc);
         localeFiles.push(f);
-        if (loc.locale === defaultLocale || loc.default) break;
+        break;
       }
     }
   }
@@ -432,7 +454,7 @@ function loadProject(startPath) {
   const projectFile = findProjectFile(startPath);
   const root = dirname2(projectFile);
   const project = parseFile(projectFile, "patter/project", "project");
-  const layout = { flow: "scenes/", strings: "loc/", authoring: "authoring/", ...project.layout };
+  const layout = projectLayout(project);
   const scenes = [];
   const sceneFiles = {};
   for (const f of walkFiles(join2(root, layout.flow), ".patterflow")) {
@@ -471,8 +493,8 @@ function applyWrites(writes) {
 }
 
 // src/validate.ts
-import { readFileSync as readFileSync3, statSync as statSync2 } from "fs";
-import { basename as basename2, isAbsolute, join as join3, relative as relative2 } from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync5, statSync as statSync2 } from "fs";
+import { basename as basename4, isAbsolute as isAbsolute2, join as join5, relative as relative3 } from "path";
 
 // src/merge.ts
 import { canonicalStringify as canonicalStringify2 } from "@patterkit/core";
@@ -487,12 +509,12 @@ function sidecarIssues(sidecarPaths) {
     message: "unresolved merge conflict - resolve it and delete the .patterconflict sidecar before committing"
   }));
 }
+var MERGE_TYPES = { flow: "flow", strings: "loc", authoring: "authoring", project: "project" };
 function detectMergeType(file) {
   const s = typeof file.schema === "string" ? file.schema : "";
-  if (s.startsWith("patter/flow")) return "flow";
-  if (s.startsWith("patter/strings")) return "loc";
-  if (s.startsWith("patter/authoring")) return "authoring";
-  if (s.startsWith("patter/project")) return "project";
+  const name = /^patter\/([a-z]+)(?:@|$)/.exec(s)?.[1];
+  const type = name ? MERGE_TYPES[name] : void 0;
+  if (type) return type;
   throw new UnsupportedMergeError(`cannot detect a Patter merge type from schema '${s}'`);
 }
 function runMerge(base, ours, theirs, opts) {
@@ -519,7 +541,7 @@ function merge3(base, ours, theirs, id, path, conflicts) {
   conflicts.push({ id, path, base, ours, theirs, kind: deletedKind(base, ours, theirs) });
   return ours;
 }
-function mergeMap(base, ours, theirs, prefix, conflicts, resolve6) {
+function mergeMap(base, ours, theirs, prefix, conflicts, resolve7) {
   const out = {};
   for (const k of /* @__PURE__ */ new Set([...Object.keys(base), ...Object.keys(ours), ...Object.keys(theirs)])) {
     const b = base[k], o = ours[k], t = theirs[k];
@@ -528,7 +550,7 @@ function mergeMap(base, ours, theirs, prefix, conflicts, resolve6) {
     else if (eq(b, o)) v = t;
     else if (eq(b, t)) v = o;
     else {
-      const r = resolve6?.(k, b, o, t);
+      const r = resolve7?.(k, b, o, t);
       if (r && r.resolved) v = r.value;
       else {
         conflicts.push({ id: k, path: `${prefix}.${k}`, base: b, ours: o, theirs: t, kind: r ? r.kind : deletedKind(b, o, t) });
@@ -587,11 +609,50 @@ function mergeById(base, ours, theirs, path, conflicts) {
   return Object.values(merged).sort((a, b) => String(asMap(a).ts ?? "").localeCompare(String(asMap(b).ts ?? "")));
 }
 function mergeComments(base, ours, theirs) {
-  const byId = /* @__PURE__ */ new Map();
-  for (const c of [...base, ...ours, ...theirs]) {
-    if (isObj(c) && typeof c.id === "string" && !byId.has(c.id)) byId.set(c.id, c);
+  const index = (arr) => {
+    const m = /* @__PURE__ */ new Map();
+    for (const c of arr) if (isObj(c) && typeof c.id === "string") m.set(c.id, c);
+    return m;
+  };
+  const b = index(base), o = index(ours), t = index(theirs);
+  const msgKey = (m) => `${String(m.author ?? "")}|${String(m.ts ?? "")}`;
+  const out = [];
+  for (const id of /* @__PURE__ */ new Set([...b.keys(), ...o.keys(), ...t.keys()])) {
+    const bc = b.get(id), oc = o.get(id), tc = t.get(id);
+    const sides = [oc, tc].filter((c) => c !== void 0);
+    if (sides.length === 0) continue;
+    if (![bc, oc, tc].some((c) => Array.isArray(c?.messages))) {
+      out.push(oc ?? tc);
+      continue;
+    }
+    const deletedBy = /* @__PURE__ */ new Set();
+    for (const c of [oc, tc]) {
+      if (c === void 0 && bc) {
+        for (const m of asArr(bc.messages)) if (isObj(m)) deletedBy.add(msgKey(m));
+      }
+    }
+    const messages = /* @__PURE__ */ new Map();
+    for (const c of [bc, ...sides]) {
+      for (const m of asArr(c?.messages)) {
+        if (!isObj(m)) continue;
+        const key = msgKey(m);
+        const seen = messages.get(key);
+        if (!seen || m.deleted === true && seen.deleted !== true) messages.set(key, m);
+      }
+    }
+    for (const key of deletedBy) {
+      const m = messages.get(key);
+      if (m && m.deleted !== true) messages.set(key, { ...m, body: "", deleted: true });
+    }
+    const merged = [...messages.values()].sort((x, y) => String(x.ts ?? "").localeCompare(String(y.ts ?? "")));
+    if (merged.length === 0 || merged.every((m) => m.deleted === true)) continue;
+    const was = bc?.resolved === true;
+    const oursSays = oc ? oc.resolved === true : was, theirsSays = tc ? tc.resolved === true : was;
+    const resolved = oursSays !== was ? oursSays : theirsSays;
+    const { resolved: _r, messages: _m, ...rest } = oc ?? tc;
+    out.push({ ...rest, ...resolved ? { resolved: true } : {}, messages: merged });
   }
-  return [...byId.values()].sort((a, b) => String(a.ts ?? "").localeCompare(String(b.ts ?? "")));
+  return out.sort((x, y) => String(asArr(x.messages).map(asMap)[0]?.ts ?? x.ts ?? "").localeCompare(String(asArr(y.messages).map(asMap)[0]?.ts ?? y.ts ?? "")));
 }
 function lastWriterWins(oursEdits, theirsEdits) {
   return (id, _b, o, t) => {
@@ -817,11 +878,52 @@ var idMap = (nodes) => new Map(nodes.filter((n) => n.id).map((n) => [n.id, n]));
 var arrEq = (a, b) => a.length === b.length && a.every((x, i) => x === b[i]);
 
 // src/validate.ts
-import { validateProject, parseSource as parseSource2 } from "@patterkit/core";
-import { validateConditions, validateInterpolation, exportBundle as exportBundle2, hostScopesToSpec, projectScopes } from "@patterkit/compiler";
+import { validateProject } from "@patterkit/core";
+import { validateConditions, validateInterpolation, hostScopesToSpec, projectScopes } from "@patterkit/compiler";
 
-// src/reachability.ts
+// src/compile.ts
+import { basename as basename2, extname, isAbsolute, resolve as resolve3 } from "path";
 import { exportBundle } from "@patterkit/compiler";
+import { isContentlessBeat } from "@patterkit/model";
+function compileScenes(loaded) {
+  const def = loaded.project.locales.default;
+  const written = /* @__PURE__ */ new Set();
+  for (const l of loaded.locales) if (l.locale === def) {
+    for (const [k, v] of Object.entries(l.strings)) if (v) written.add(k);
+  }
+  const clean = (n) => {
+    if (n.type === "group") return { ...n, children: (n.children ?? []).map(clean) };
+    if (!n.beats) return n;
+    const kept = n.beats.filter((b) => !isContentlessBeat(b, written.has(b.id)));
+    if (kept.length === n.beats.length) return n;
+    const { beats, ...rest } = n;
+    return kept.length ? { ...rest, beats: kept } : rest;
+  };
+  return loaded.scenes.map((s) => ({
+    ...s,
+    blocks: s.blocks.map((b) => ({ ...b, children: b.children.map(clean) }))
+  }));
+}
+function compileLoaded(loaded) {
+  return exportBundle({ project: loaded.project, scenes: compileScenes(loaded), locales: loaded.locales, gameScopes: loaded.gameScopes?.merged });
+}
+function defaultBundlePath(loaded) {
+  return `../patter-dist/${basename2(loaded.projectFile).replace(/\.patterproj$/, "")}.patterc`;
+}
+function bundleOutputPath(loaded) {
+  const rel = loaded.project.export?.bundle ?? defaultBundlePath(loaded);
+  return isAbsolute(rel) ? rel : resolve3(loaded.root, rel);
+}
+function besideBundlePath(loaded, ext) {
+  const bundle = bundleOutputPath(loaded);
+  const own = extname(bundle);
+  const path = (own ? bundle.slice(0, -own.length) : bundle) + ext;
+  if (path === bundle) throw new Error(`the ${ext} file would replace the bundle at ${bundle}; pass -o`);
+  return path;
+}
+
+// src/validate.ts
+import { PROJECT_LOCALE_SCENE, projectLayout as projectLayout2 } from "@patterkit/model";
 
 // ../../../expr/packages/expr/src/ast.ts
 function deserialiseAst(node) {
@@ -928,8 +1030,7 @@ var termsOfAst = (ast, sceneId) => terms(ast, sceneId, keyOf);
 var requirementsOf = (expr, sceneId) => expr === void 0 ? [] : termsOfAst(expr.ast, sceneId);
 var asFlags = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
 function reachabilityIssues(loaded, compiled) {
-  const bundle = compiled ?? exportBundle({ project: loaded.project, scenes: loaded.scenes, locales: loaded.locales, gameScopes: loaded.gameScopes?.merged });
-  const hostTokens = hostScopeTokens(loaded, bundle);
+  const bundle = compiled ?? compileLoaded(loaded);
   const preset = /* @__PURE__ */ new Set();
   const notALatch = (decl, key) => {
     if (decl.temporary) {
@@ -993,8 +1094,14 @@ function reachabilityIssues(loaded, compiled) {
     const at = key.indexOf(":");
     if (at > 0 && broken.has(key.slice(0, at))) broken.add(key);
   }
-  const hostDriven = (key) => hostTokens.has(key.slice(1, key.indexOf(".")));
-  const monotonic = (key) => latched.has(key) && !broken.has(key) && !preset.has(key) && !hostDriven(key);
+  const sharedWithGame = new Set(loaded.gameScopes ? (loaded.project.properties ?? []).filter((p) => p.shared ?? true).map((p) => `@patter.${p.name}`) : []);
+  const projectOwned = (key) => {
+    const bare = key.includes(SEP) ? key.slice(key.indexOf(SEP) + 1) : key;
+    const prop = bare.includes(":") ? bare.slice(0, bare.indexOf(":")) : bare;
+    if (bare.startsWith("@patter.")) return !sharedWithGame.has(prop);
+    return bare.startsWith("@scene.");
+  };
+  const monotonic = (key) => latched.has(key) && !broken.has(key) && !preset.has(key) && projectOwned(key);
   const cache = /* @__PURE__ */ new Map();
   const inFlight = /* @__PURE__ */ new Set();
   const mustHold = (key) => {
@@ -1068,6 +1175,134 @@ function reachabilityIssues(loaded, compiled) {
   return issues;
 }
 
+// src/pack.ts
+import JSZip from "jszip";
+import { readFileSync as readFileSync4 } from "fs";
+import { dirname as dirname4, join as join4, relative as relative2, sep } from "path";
+import { parseSource as parseSource2 } from "@patterkit/core";
+import { ARCHIVE_ENTRY_OPTS } from "@wildwinter/toolkit/archive";
+
+// src/handoff.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
+import { basename as basename3, join as join3 } from "path";
+import { HANDOFF_SCHEMA } from "@patterkit/model";
+var HANDOFF_DIR = "handoffs";
+var HANDOFF_EXT = ".json";
+function handoffPath(root, id) {
+  return join3(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(join3(root, HANDOFF_DIR), HANDOFF_EXT)) {
+    try {
+      handoffs.push(parseHandoff(readFileSync3(file, "utf8")));
+    } catch (e) {
+      issues.push({ file, message: `${basename3(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"];
+var ENTRY_OPTS = ARCHIVE_ENTRY_OPTS;
+async function runPack(startPath) {
+  const projectFile = findProjectFile(startPath);
+  const root = dirname4(projectFile);
+  const project = parseSource2(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 files = SHARD_EXTENSIONS.flatMap((ext) => walkFiles(root, ext)).map((abs) => ({ abs, rel: relative2(root, abs).split(sep).join("/") })).sort((a, b) => a.rel.localeCompare(b.rel));
+  const scopes = gameScopesSnapshot(root, project);
+  const handoffs = walkFiles(join4(root, HANDOFF_DIR), ".json").map((abs) => ({ rel: relative2(root, abs).split(sep).join("/"), text: readFileSync4(abs, "utf8") })).filter((f) => {
+    try {
+      return !parseHandoff(f.text).closed;
+    } catch {
+      return false;
+    }
+  });
+  const manifest = {
+    schema: "patter/document@0",
+    project: { id: project.project.id, name: project.project.name },
+    files: files.map((f) => f.rel),
+    ...scopes.length ? { gameScopes: scopes.map((f) => f.fileName) } : {},
+    ...handoffs.length ? { handoffs: handoffs.map((f) => f.rel) } : {}
+  };
+  const zip = new JSZip();
+  zip.file("patter.manifest.json", JSON.stringify(manifest, null, 2) + "\n", ENTRY_OPTS);
+  for (const f of files) zip.file(f.rel, readFileSync4(f.abs, "utf8"), ENTRY_OPTS);
+  for (const f of scopes) zip.file(`${GAME_SCOPES_DIR}/${f.fileName}`, f.text, ENTRY_OPTS);
+  for (const f of handoffs) zip.file(f.rel, f.text, ENTRY_OPTS);
+  return zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE", streamFiles: false });
+}
+
 // src/validate.ts
 function runValidate(loaded) {
   const { project, scenes, locales } = loaded;
@@ -1079,10 +1314,20 @@ function runValidate(loaded) {
   const interpolation = validateInterpolation({ project, scenes, locales }, { foreignScopes, gameScopes: merged });
   const gameScopes = gameScopesIssues(loaded, scopes.notes);
   const hygiene = checkHygiene([loaded.projectFile, ...Object.values(loaded.sceneFiles), ...loaded.localeFiles, ...loaded.authoringFiles]);
-  const staleBundles = checkBundles(loaded);
-  const unresolvedMerges = sidecarIssues(walkFiles(loaded.root, CONFLICT_SIDECAR));
-  const orphans = orphanShards(loaded);
-  const reachability = structural.length === 0 && !conditions.some(isError) ? reachabilityIssues(loaded) : [];
+  const tree = walkFilesByExt(loaded.root, [...SHARD_EXTENSIONS, CONFLICT_SIDECAR, ".patterc"]);
+  const localisation = locIssues(loaded);
+  let compiled;
+  try {
+    compiled = compileLoaded(loaded);
+  } catch {
+    compiled = void 0;
+  }
+  const staleBundles = checkBundles(loaded, compiled, tree.get(".patterc"));
+  if (compiled) gameScopes.push(...unplayableScopes(loaded, compiled));
+  const unresolvedMerges = sidecarIssues(tree.get(CONFLICT_SIDECAR));
+  const orphans = orphanShards(loaded, tree);
+  const structuralErrors = structural.filter((i) => i.severity !== "warning");
+  const reachability = compiled && structuralErrors.length === 0 && !conditions.some(isError) ? reachabilityIssues(loaded, compiled) : [];
   return {
     structural,
     conditions,
@@ -1093,23 +1338,45 @@ function runValidate(loaded) {
     unresolvedMerges,
     orphans,
     gameScopes,
-    ok: structural.length === 0 && !conditions.some(isError) && !interpolation.some(isError) && hygiene.length === 0 && staleBundles.length === 0 && unresolvedMerges.length === 0 && orphans.length === 0 && !gameScopes.some(isError)
+    localisation,
+    ok: !localisation.some(isError) && structuralErrors.length === 0 && !conditions.some(isError) && !interpolation.some(isError) && hygiene.length === 0 && staleBundles.length === 0 && unresolvedMerges.length === 0 && orphans.length === 0 && !gameScopes.some(isError)
   };
 }
 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 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);
+  return [
+    ...structural.map((i) => `[${i.code}] ${i.message}`),
+    ...[...conditions, ...interpolation].map((i) => `[${i.field}] ${i.nodeId}: ${i.message}  (${i.src})`),
+    ...locIssues(loaded).filter(isError).map((i) => `[localisation] ${i.file}: ${i.message}`)
+  ];
+}
 function gameScopesIssues(loaded, notes) {
   const out = [];
   if (loaded.gameScopesMissing) out.push({ file: loaded.projectFile, severity: "error", message: loaded.gameScopesMissing });
   const gs = loaded.gameScopes;
   if (!gs) return out;
   for (const i of gs.issues) out.push({ file: i.file, severity: i.severity, message: i.message });
-  for (const n of notes) out.push({ file: join3(gs.dir, n.file), severity: "warning", message: n.message });
+  for (const n of notes) out.push({ file: join5(gs.dir, n.file), severity: "warning", message: n.message });
   const stale = patterScopesStale(loaded.project, gs);
   if (stale) out.push({ ...stale, severity: "warning" });
   return out;
 }
-function orphanShards(loaded) {
-  const layout = { flow: "scenes/", strings: "loc/", authoring: "authoring/", ...loaded.project.layout };
+function unplayableScopes(loaded, compiled) {
+  const registry = previewRegistry(loaded.gameScopes, compiled);
+  return (compiled.externalScopes ?? []).filter((t) => !registry?.has(t)).map((t) => ({
+    file: loaded.projectFile,
+    severity: "warning",
+    message: `the content names @${t}, another engine's scope, and no game scopes folder declares it: the game can play it, but play, coverage, and the Play window cannot until the game shares its scopes (patter share-scopes)`
+  }));
+}
+function orphanShards(loaded, tree = walkFilesByExt(loaded.root, SHARD_EXTENSIONS)) {
+  const layout = projectLayout2(loaded.project);
   const kind = {
     ".patterflow": { what: "scene", home: layout.flow },
     ".patterloc": { what: "strings", home: layout.strings },
@@ -1117,37 +1384,33 @@ function orphanShards(loaded) {
     ".patterproj": { what: "project", home: null }
   };
   const inside = (file, dir) => {
-    const r = relative2(dir, file);
-    return r !== "" && !r.startsWith("..") && !isAbsolute(r);
+    const r = relative3(dir, file);
+    return r !== "" && !r.startsWith("..") && !isAbsolute2(r);
   };
   const out = [];
   for (const [ext, { what, home }] of Object.entries(kind)) {
-    for (const file of walkFiles(loaded.root, ext)) {
-      if (home ? inside(file, join3(loaded.root, home)) : file === loaded.projectFile) continue;
-      const rel = relative2(loaded.root, file);
-      const message = home ? `${rel} is a ${what} file outside the project's folders: nothing loads it, so none of it is in the project. Move it under ${home}, or delete it.` : `${rel} is a second project file: only ${basename2(loaded.projectFile)} is read. Delete it, or move it out of the project.`;
+    for (const file of tree.get(ext) ?? []) {
+      if (home ? inside(file, join5(loaded.root, home)) : file === loaded.projectFile) continue;
+      const rel = relative3(loaded.root, file);
+      const message = home ? `${rel} is a ${what} file outside the project's folders: nothing loads it, so none of it is in the project. Move it under ${home}, or delete it.` : `${rel} is a second project file: only ${basename4(loaded.projectFile)} is read. Delete it, or move it out of the project.`;
       out.push({ file, message });
     }
   }
   return out;
 }
-function checkBundles(loaded) {
+function checkBundles(loaded, compiled, inTree) {
   const issues = [];
-  const bundles = walkFiles(loaded.root, ".patterc");
-  if (bundles.length === 0) return issues;
-  let fresh;
-  try {
-    fresh = exportBundle2({ project: loaded.project, scenes: loaded.scenes, locales: loaded.locales, gameScopes: loaded.gameScopes?.merged }).content.hash;
-  } catch {
-    return issues;
-  }
+  const own = bundleOutputPath(loaded);
+  const bundles = [.../* @__PURE__ */ new Set([...inTree, ...existsSync4(own) ? [own] : []])];
+  if (bundles.length === 0 || !compiled) return issues;
+  const fresh = compiled.content.hash;
   for (const file of bundles) {
     let hash;
     try {
-      const parsed = parseSource2(readFileSync3(file, "utf8"));
+      const parsed = JSON.parse(readFileSync5(file, "utf8"));
       hash = parsed?.content?.hash;
     } catch {
-      issues.push({ file, message: "compiled bundle is unparseable - run `patter export`" });
+      issues.push({ file, message: "compiled bundle is not strict JSON, so no game can read it - run `patter export`" });
       continue;
     }
     if (hash !== fresh) {
@@ -1156,8 +1419,35 @@ function checkBundles(loaded) {
   }
   return issues;
 }
+function locIssues(loaded) {
+  const out = [];
+  const scenes = /* @__PURE__ */ new Set([...loaded.scenes.map((sc) => sc.id), PROJECT_LOCALE_SCENE]);
+  const declared = new Set(loaded.project.locales.all);
+  const bySlot = /* @__PURE__ */ new Map();
+  const byKey = /* @__PURE__ */ new Map();
+  loaded.locales.forEach((l, i) => {
+    const file = loaded.localeFiles[i] ?? "";
+    if (!scenes.has(l.scene)) out.push({ file, severity: "warning", message: `strings for scene '${l.scene}', which the project does not have: nothing reads them` });
+    if (!declared.has(l.locale)) out.push({ file, severity: "warning", message: `strings in '${l.locale}', which is not one of the project's languages (${[...declared].join(", ")})` });
+    const slot = `${l.scene}|${l.locale}`;
+    const first = bySlot.get(slot);
+    if (first) out.push({ file, severity: "warning", message: `a second file of '${l.locale}' strings for scene '${l.scene}' (the first is ${first})` });
+    else bySlot.set(slot, file);
+    for (const [key, text] of Object.entries(l.strings)) {
+      const seen = byKey.get(`${l.locale}|${key}`);
+      if (!seen) {
+        byKey.set(`${l.locale}|${key}`, { file, text });
+        continue;
+      }
+      if (seen.text !== text) out.push({ file, severity: "error", message: `'${key}' has different '${l.locale}' text here and in ${seen.file}; the project will not build until one is removed` });
+    }
+  });
+  return out;
+}
 var hygieneCache = /* @__PURE__ */ new Map();
 function checkHygiene(files) {
+  const wanted = new Set(files);
+  for (const file of hygieneCache.keys()) if (!wanted.has(file)) hygieneCache.delete(file);
   const issues = [];
   for (const file of files) {
     let mtimeMs;
@@ -1173,7 +1463,7 @@ function checkHygiene(files) {
     }
     const fileIssues = [];
     try {
-      const text = readFileSync3(file, "utf8");
+      const text = readFileSync5(file, "utf8");
       if (text.charCodeAt(0) === 65279) {
         fileIssues.push({ file, message: "file starts with a UTF-8 BOM (canonical form is UTF-8 without BOM - run `patter format`)" });
       }
@@ -1190,28 +1480,72 @@ function checkHygiene(files) {
 }
 
 // src/export.ts
-import { basename as basename3, isAbsolute as isAbsolute2, join as join4 } from "path";
-import { exportBundle as exportBundle3 } from "@patterkit/compiler";
-import { isContentlessBeat } from "@patterkit/model";
-function compileScenes(loaded) {
-  const def = loaded.project.locales.default;
-  const written = /* @__PURE__ */ new Set();
-  for (const l of loaded.locales) if (l.locale === def) {
-    for (const [k, v] of Object.entries(l.strings)) if (v) written.add(k);
-  }
-  const clean = (n) => {
-    if (n.type === "group") return { ...n, children: (n.children ?? []).map(clean) };
-    if (!n.beats) return n;
-    const kept = n.beats.filter((b) => !isContentlessBeat(b, written.has(b.id)));
-    if (kept.length === n.beats.length) return n;
-    const { beats, ...rest } = n;
-    return kept.length ? { ...rest, beats: kept } : rest;
-  };
-  return loaded.scenes.map((s) => ({
-    ...s,
-    blocks: s.blocks.map((b) => ({ ...b, children: b.children.map(clean) }))
+import { canonicalStringify as canonicalStringify3 } from "@patterkit/core";
+
+// src/audio-index.ts
+import { readdirSync as readdirSync3 } from "fs";
+import { join as join6, relative as relative4, resolve as resolve4, sep as sep2 } from "path";
+import { deriveRecordingFolders, DEFAULT_RECORDING_STATUSES } from "@patterkit/model";
+var AUDIO_MANIFEST_SCHEMA = "patter/audio@0";
+var AUDIO_MANIFEST_FILE = "patteraudio.json";
+var AUDIO_EXT = [".wav", ".mp3"];
+function audioFoldersActive(p) {
+  return !!p.voiced && (p.trackAudioStatus ?? false) && !!p.audioFolders && !!p.audioRoot?.trim();
+}
+function audioFolderRungs(root, rungs) {
+  return rungs.filter((r) => r.folder?.trim()).reverse().map((r) => ({ name: r.name, dir: resolve4(root, r.folder.trim()) }));
+}
+function pickAudio(listings) {
+  const snap = {};
+  for (const { name, dir, files } of listings) {
+    const byId = /* @__PURE__ */ new Map();
+    for (const f of files ?? []) {
+      const dot = f.lastIndexOf(".");
+      if (dot <= 0) continue;
+      const ext = f.slice(dot).toLowerCase();
+      if (!AUDIO_EXT.includes(ext)) continue;
+      const id = f.slice(0, dot);
+      const existing = byId.get(id);
+      if (!existing || ext === ".wav" && !existing.toLowerCase().endsWith(".wav")) byId.set(id, f);
+    }
+    for (const [id, file] of byId) if (!(id in snap)) snap[id] = { status: name, path: resolve4(dir, file) };
+  }
+  return snap;
+}
+function scanAudio(loaded) {
+  const p = loaded.project;
+  if (!audioFoldersActive(p)) return void 0;
+  const rungs = audioFolderRungs(loaded.root, deriveRecordingFolders(p.audioRoot, p.recordingStatuses ?? DEFAULT_RECORDING_STATUSES));
+  return pickAudio(rungs.map((r) => {
+    let files;
+    try {
+      files = readdirSync3(r.dir);
+    } catch {
+      files = void 0;
+    }
+    return { ...r, files };
   }));
 }
+function scanAudioStatus(loaded) {
+  const snap = scanAudio(loaded);
+  return snap && new Map(Object.entries(snap).map(([id, e]) => [id, e.status]));
+}
+function audioManifest(snapshot, projectRoot, audioRoot) {
+  const base = resolve4(projectRoot, audioRoot);
+  const clips = {};
+  for (const beatId of Object.keys(snapshot).sort()) {
+    const entry = snapshot[beatId];
+    clips[beatId] = { file: relative4(base, entry.path).split(sep2).join("/"), status: entry.status };
+  }
+  return JSON.stringify({ schema: AUDIO_MANIFEST_SCHEMA, clips }, null, 2) + "\n";
+}
+function audioManifestWrite(loaded, snapshot) {
+  const p = loaded.project;
+  if (!snapshot || !audioFoldersActive(p) || !Object.keys(snapshot).length) return void 0;
+  return { path: join6(resolve4(loaded.root, p.audioRoot), AUDIO_MANIFEST_FILE), content: audioManifest(snapshot, loaded.root, p.audioRoot) };
+}
+
+// src/export.ts
 function refuseUnresolvedMerge(loaded) {
   const issues = sidecarIssues(walkFiles(loaded.root, CONFLICT_SIDECAR));
   if (!issues.length) return;
@@ -1220,32 +1554,47 @@ function refuseUnresolvedMerge(loaded) {
 ` + issues.map((i) => `  ${i.file}`).join("\n")
   );
 }
-function runExport(loaded) {
+function refuseInvalid(loaded, opts) {
+  if (opts.allowInvalid) return;
+  const blockers = exportBlockers(loaded);
+  if (!blockers.length) return;
+  const shown2 = blockers.slice(0, 10).map((b) => `  ${b}`);
+  if (blockers.length > shown2.length) shown2.push(`  ... and ${blockers.length - shown2.length} more (patter validate lists them)`);
+  throw new Error(`${blockers.length} problem(s) to fix before this project builds:
+${shown2.join("\n")}`);
+}
+function runExport(loaded, opts = {}) {
   refuseUnresolvedMerge(loaded);
-  const { project, locales } = loaded;
-  const full = exportBundle3({ project, scenes: compileScenes(loaded), locales, gameScopes: loaded.gameScopes?.merged });
+  refuseInvalid(loaded, opts);
+  const { project } = loaded;
+  const full = compileLoaded(loaded);
   const loc = project.export?.localisation;
   if (!loc || loc.mode === "embedded") return full;
   const strings = loc.sourceDebug ? { [full.locales.default]: full.strings[full.locales.default] ?? {} } : {};
   return { ...full, strings, localisation: { mode: "ids", ...loc.sourceDebug ? { sourceDebug: true } : {} } };
 }
-function runExportFull(loaded) {
+function runExportFull(loaded, opts = {}) {
   refuseUnresolvedMerge(loaded);
-  const { project, locales } = loaded;
-  return exportBundle3({ project, scenes: compileScenes(loaded), locales, gameScopes: loaded.gameScopes?.merged });
-}
-function bundleOutputPath(loaded) {
-  const override = loaded.project.export?.bundle;
-  if (override) return isAbsolute2(override) ? override : join4(loaded.root, override);
-  const stem = basename3(loaded.projectFile).replace(/\.patterproj$/, "");
-  return join4(loaded.root, "dist", `${stem}.patterc`);
+  if (opts.refuseInvalid) refuseInvalid(loaded, opts);
+  return compileLoaded(loaded);
+}
+function planBuild(loaded, opts = {}) {
+  const bundle = runExport(loaded, opts);
+  const text = canonicalStringify3(bundle, { trailingComma: false });
+  const scopes = patterScopesWrite(loaded.project, loaded.gameScopes);
+  const audio = audioManifestWrite(loaded, opts.audio ?? scanAudio(loaded));
+  return {
+    bundle,
+    text,
+    writes: [{ path: opts.bundlePath ?? bundleOutputPath(loaded), content: text }, ...scopes ? [scopes] : [], ...audio ? [audio] : []]
+  };
 }
 
 // src/export-html.ts
-import { canonicalStringify as canonicalStringify3 } from "@patterkit/core";
+import { canonicalStringify as canonicalStringify4 } from "@patterkit/core";
 
 // src/playable-runtime.ts
-var PLAYABLE_RUNTIME_JS = 'var Patterplay=(()=>{var _=Object.defineProperty;var Te=Object.getOwnPropertyDescriptor;var Ge=Object.getOwnPropertyNames;var je=Object.prototype.hasOwnProperty;var Ve=(n,e)=>{for(var t in e)_(n,t,{get:e[t],enumerable:!0})},Le=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of Ge(e))!je.call(n,s)&&s!==t&&_(n,s,{get:()=>e[s],enumerable:!(r=Te(e,s))||r.enumerable});return n};var Me=n=>Le(_({},"__esModule",{value:!0}),n);var st={};Ve(st,{Checkpoint:()=>A,Engine:()=>H,Flow:()=>I,buildTagIndex:()=>$,describeBundle:()=>Oe,effectiveGameData:()=>Ne,gameDataFields:()=>Be,gameDataValue:()=>te});function D(n,e){return n!==void 0&&Object.prototype.hasOwnProperty.call(n,e)?n[e]:void 0}function k(n){switch(n[0]){case"b":return{kind:"bool",value:n[1]};case"n":return{kind:"number",value:n[1]};case"s":return{kind:"string",value:n[1]};case"sv":return{kind:"scopedvar",scope:n[1],name:n[2]};case"u":return{kind:"unary",op:n[1],operand:k(n[2])};case"bin":return{kind:"binary",op:n[1],left:k(n[2]),right:k(n[3])};case"call":{let e=n.slice(2).map(k);return{kind:"call",name:n[1],args:e}}case"fd":return{kind:"flagdelta",sign:n[1],name:n[2]}}}var d=class extends Error{constructor(e){super(e),this.name="EvalError"}};function G(n,e,t){let r=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=D(e.scopes,i.scope);if(o===void 0)return!1;let a=typeof o.get=="function"?o.get(i.name):D(o,i.name);if(a===void 0){if(r.get(i.scope)==="throw")throw new d(`@${i.scope}.${i.name} is not declared on the current ${i.scope}.`);return!1}return a}case"call":{if(i.name==="advance"&&!D(t.functions,i.name)){let a=i.args[0];if(i.args.length!==1||a===void 0)throw new d(`advance() takes exactly 1 argument, got ${i.args.length}`);let c=U(a,e);if(c===void 0)throw new d("advance() needs a quality reference (@scope.name of a quality property)");let l=w(s(a),c,"advance");return c[Math.min(l+1,c.length-1)]}let o=D(t.functions,i.name);if(!o)throw new d(`unknown function \'${i.name}\'`);return o.eval(i.args,{evaluate:s,ctx:e})}case"flagdelta":throw new d("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 d(`\'not\' requires a boolean operand, got ${typeof a}`);return!a}let o=s(i.operand);if(typeof o!="number")throw new d(`unary \'-\' requires a numeric operand, got ${typeof o}`);return-o}case"binary":{if(i.op==="and"){let f=s(i.left);if(typeof f!="boolean")throw new d(`\'and\' requires boolean operands, left is ${typeof f}`);if(!f)return!1;let u=s(i.right);if(typeof u!="boolean")throw new d(`\'and\' requires boolean operands, right is ${typeof u}`);return u}if(i.op==="or"){let f=s(i.left);if(typeof f!="boolean")throw new d(`\'or\' requires boolean operands, left is ${typeof f}`);if(f)return!0;let u=s(i.right);if(typeof u!="boolean")throw new d(`\'or\' requires boolean operands, right is ${typeof u}`);return u}let o=s(i.left),a=s(i.right),c=U(i.left,e),l=U(i.right,e),p=c??l;if(p!==void 0){if(c&&l&&!$e(c,l)&&(i.op===">"||i.op===">="||i.op==="<"||i.op==="<="))throw new d(`\'${i.op}\' compares two different qualities, whose stage orders are unrelated`);switch(i.op){case">":return w(o,p,">")>w(a,p,">");case">=":return w(o,p,">=")>=w(a,p,">=");case"<":return w(o,p,"<")<w(a,p,"<");case"<=":return w(o,p,"<=")<=w(a,p,"<=");case"+":case"-":case"*":case"/":throw new d(`\'${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 E(o,a,">"),o>a;case">=":return E(o,a,">="),o>=a;case"<":return E(o,a,"<"),o<a;case"<=":return E(o,a,"<="),o<=a;case"+":if(typeof o=="number"&&typeof a=="number"||typeof o=="string"&&typeof a=="string")return o+a;throw new d(`\'+\' requires two numbers or two strings, got ${typeof o} and ${typeof a}`);case"-":return E(o,a,"-"),o-a;case"*":return E(o,a,"*"),o*a;case"/":if(E(o,a,"/"),a===0)throw new d("division by zero");return o/a}}}};return s(n)}function ce(n,e){if(Array.isArray(n)||Array.isArray(e)){if(!Array.isArray(n)||!Array.isArray(e)||n.length!==e.length)return!1;let t=[...n].sort(),r=[...e].sort();for(let s=0;s<t.length;s++)if(t[s]!==r[s])return!1;return!0}return n===e}function E(n,e,t){if(typeof n!="number"||typeof e!="number")throw new d(`\'${t}\' requires numeric operands, got ${typeof n} and ${typeof e}`)}function U(n,e){if(!(n.kind!=="scopedvar"||e.qualities===void 0))return e.qualities(n.scope,n.name)}function w(n,e,t){if(typeof n!="string")throw new d(`\'${t}\' on a quality compares stages, got ${typeof n}`);let r=e.indexOf(n);if(r<0)throw new d(`"${n}" is not a stage of this quality (stages: ${e.join(", ")})`);return r}var $e=(n,e)=>n.length===e.length&&n.every((t,r)=>t===e[r]);function R(n){if(Number.isNaN(n)||!Number.isFinite(n))return 0;let e=Math.trunc(n)%4294967296;return e<0?e+4294967296:e}function W(n){let e=R(n);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 He={name:"check_flags",count:n=>Math.max(1,n.args.length-1)},qe=[He];function le(n,e,t){let r=t?.countingCalls??qe;return j(n,t?.want??!0,e,r)}function j(n,e,t,r){if(n.kind==="binary"&&(n.op==="and"||n.op==="or")){let s=j(n.left,e,t,r),i=j(n.right,e,t,r);return n.op==="and"===e?s>0&&i>0?s+i:0:Math.max(s,i)}if(n.kind==="unary"&&n.op==="not")return j(n.operand,!e,t,r);if(n.kind==="call"){let s=r.find(i=>i.name===n.name);if(s){let i=s.count(n),o=t(n);return e?o?i:0:o?0:1}}return t(n)===e?1:0}var b=class n{values=Object.create(null);decls=new Map;subscribers=new Set;auditors=new Set;norm;pathPrefix;constructor(e=[],t){this.norm=t?.normalise??(r=>r.toLowerCase()),this.pathPrefix=t?.pathPrefix??"",this.seed(e)}seed(e){for(let t of e){let r=this.norm(t.name);this.decls.set(r,t),this.values[r]=structuredClone(t.default??P(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,r){let s=this.norm(e);if(!r?.host&&!this.writable(s))throw new Error(`\'${e}\' is read-only`);let i={name:s,prev:this.values[s],next:t,silent:r?.silent??!1,reason:r?.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])=>de(t,this.get(e),void 0,e,this.pathPrefix))}declarations(){return[...this.decls.values()]}clone(){let e=new n([],{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){for(let[t,r]of Object.entries(e))this.values[this.norm(t)]=r}};function de(n,e,t,r,s=""){let i=r??n.name.toLowerCase();return{name:i,path:s+i,type:n.type,value:e,default:n.default??P(n),...n.values!==void 0?{values:n.values}:{},...n.stages!==void 0?{stages:n.stages}:{},writable:t??n.writable??!0}}var _e=n=>n.toLowerCase(),J=1,V=class{scopes=new Map;parked=new Map;rev=0;get revision(){return this.rev}defineOwned(e,t,r){let s=typeof r=="string"?{pathPrefix:r}:r??{},i=new b(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,r){this.assertFree(e,r?.owner),this.scopes.set(e,{kind:"owned",bag:t,...r?.owner!==void 0?{owner:r.owner}:{}}),this.rev++;let s=this.parked.get(e);return s&&(t.load(s),this.parked.delete(e)),this}remove(e,t){let r=this.scopes.get(e);if(!r)throw new Error(`unknown scope \'@${e}\'`);return t?.keep&&r.kind==="owned"&&this.parked.set(e,r.bag.save()),this.scopes.delete(e),this.rev++,this}discardParked(e){if(e===void 0)this.parked.clear();else for(let t of[...this.parked.keys()])t.startsWith(e)&&this.parked.delete(t);return this}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,r=[],s=!0){let i=typeof s=="boolean"?{writable:s}:s;this.assertFree(e,i.owner);let o=i.normalise??_e,a=new Map;for(let c of r)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 r=this.scopes.get(e);if(r)return r.kind==="owned"?r.bag.get(t):r.resolver.get(r.norm(t))}set(e,t,r,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,r,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,r)}foreignWritable(e,t){return e.resolver.set?e.decls.get(t)?.writable??e.scopeWritable:!1}listProperties(){let e=[];for(let[t,r]of this.scopes){let s=r.owner!==void 0?{owner:r.owner}:{};if(r.kind==="owned")for(let i of r.bag.rows())e.push({scope:t,...s,...i});else for(let[i,o]of r.decls)e.push({scope:t,...s,...de(o,r.resolver.get(i),this.foreignWritable(r,i),i,`${t}.`)})}return e}toEvalContext(e,t){let r=this.view(t?.aliases),s={};for(let[o,a]of r)s[o]=a.kind==="owned"?a.bag.values:a.resolver;let i=this.qualityLadders(r);return i.size===0?{scopes:s,host:e}:{scopes:s,host:e,qualities:(o,a)=>{let c=r.get(o);return c?i.get(o)?.get(Ue(c)(a)):void 0}}}view(e){let t=new Map(this.scopes);for(let[r,s]of Object.entries(e??{})){let i=this.scopes.get(s);if(!i)throw new Error(`alias \'@${r}\' names \'${s}\', which is not registered`);t.set(r,i)}return t}qualityLadders(e){let t=new Map;for(let[r,s]of e)for(let[i,o]of pe(s)){if(o.type!=="quality"||o.stages===void 0)continue;let a=t.get(r);a||(a=new Map,t.set(r,a)),a.set(i,o.stages)}return t}toSchema(e){let t=new Map;for(let[r,s]of this.view(e?.aliases)){let i=pe(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(r,o)}return{properties:t}}save(){let e={};for(let[t,r]of this.scopes)r.kind==="owned"&&(e[t]=r.bag.save());for(let[t,r]of this.parked)e[t]=structuredClone(r);return e}load(e,t){t?.keepParked||this.parked.clear();for(let[r,s]of Object.entries(e)){let i=this.scopes.get(r);i?.kind==="owned"?i.bag.load(s):i||this.parked.set(r,structuredClone(s))}}saveFragment(){return{version:J,scopes:this.save()}}loadFragment(e){if(e.version!==J)throw new Error(`unsupported owned-state fragment version ${e.version} (supported: ${J})`);this.load(e.scopes)}assertFree(e,t){let r=this.scopes.get(e);if(!r)return;let s=r.owner!==void 0?` by ${r.owner}`:"",i=t!==void 0?` (wanted by ${t})`:"";throw new Error(`scope \'@${e}\' is already registered${s}${i}`)}};function pe(n){return n.kind==="foreign"?[...n.decls.entries()]:n.bag.declarations().map(e=>[n.bag.normalise(e.name),e])}function Ue(n){return n.kind==="foreign"?n.norm:e=>n.bag.normalise(e)}function P(n){if(n.default!==void 0)return n.default;switch(n.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"enum":return n.values?.[0]??"";case"flags":return[];case"quality":return n.stages?.[0]??"";default:return!1}}var ge=[{token:"patter",engine:"Patterplay",means:"Patter\'s shared globals"},{token:"story",engine:"Storylet Engine",means:"the Storylet Engine\'s shared @story properties"}];function O(n){return n.ctx.host??{}}var K={defaultScope:"patter",scopes:[{token:"patter"},{token:"scene"}],functions:{random:{minArgs:2,maxArgs:2,returnType:"number",eval(n,e){if(n.length!==2)throw new d("random(a, b) requires exactly 2 arguments");let t=O(e).nextRandom;if(!t)throw new d("random() called without a PRNG in context");let r=e.evaluate(n[0]),s=e.evaluate(n[1]);if(typeof r!="number"||typeof s!="number")throw new d("random(a, b) arguments must be numbers");if(!Number.isInteger(r)||!Number.isInteger(s))throw new d("random(a, b) arguments must be integers");let i=Math.min(r,s),o=Math.max(r,s);return Math.floor(t()*(o-i+1))+i}},check_flags:{minArgs:1,returnType:"boolean",flagDeltaArgs:!0,validate:he("check_flags"),eval(n,e){let t=ue(n[0],e,"check_flags");for(let r=1;r<n.length;r++){let s=n[r];if(s.kind!=="flagdelta")throw new d("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:he("set_flags"),eval(n,e){let t=[...ue(n[0],e,"set_flags")];for(let r=1;r<n.length;r++){let s=n[r];if(s.kind!=="flagdelta")throw new d("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:M("visits"),eval:(n,e)=>O(e).visits?.(L(n,e,"visits"))??0},seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:M("seen"),eval:(n,e)=>(O(e).visits?.(L(n,e,"seen"))??0)>0},patter_visits:{minArgs:1,maxArgs:1,returnType:"number",validate:M("patter_visits"),eval:(n,e)=>O(e).patterVisits?.(L(n,e,"patter_visits"))??0},patter_seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:M("patter_seen"),eval:(n,e)=>(O(e).patterVisits?.(L(n,e,"patter_seen"))??0)>0}}},xt=ge.map(n=>n.token).filter(n=>n!=="patter"&&n!=="scene");function fe(n,e){let t=n.replace(/^@/,"").split(".");return t.length===2&&e(t[0])?{scope:t[0],name:t[1].toLowerCase()}:{scope:"patter",name:t.join(".").toLowerCase()}}function L(n,e,t){let r=e.evaluate(n[0]);if(typeof r!="string")throw new d(`${t}(id) requires a string node id`);return r}function M(n){return(e,t)=>{let r=e[0];r&&r.kind!=="string"&&t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(id): the argument must be a string id literal (a scene / block / node id)`})}}function ue(n,e,t){if(!n)throw new d(`${t}() requires at least one argument (the flags variable)`);let r=e.evaluate(n);if(Array.isArray(r))return r;if(r===!1||r===null||r===void 0)return[];throw new d(`${t}() first argument must be a flags property`)}function he(n){return(e,t)=>{if(e.length===0)return;let r=e[0];if(r.kind!=="scopedvar"){t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(): first argument must be a flags property reference (@name or @scope.name)`});return}let s=t.schema.properties.get(r.scope)?.get(r.name);if(s&&s.type!=="flags"){let i=r.scope===t.defaultScope?r.name:`${r.scope}.${r.name}`;t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(): \'@${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:`${n}(): 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:`${n}(): unknown flag \'${o.name}\'`,reference:o.name})}}}var We=/^@[A-Za-z0-9_.]+$/;function*Je(n){let e="",t=0;for(;t<n.length;){let r=n[t];if(r==="{"&&n[t+1]==="{"){e+="{",t+=2;continue}if(r==="}"&&n[t+1]==="}"){e+="}",t+=2;continue}if(r==="{"){let s=n.indexOf("}",t+1);if(s!==-1){let i=n.slice(t,s+1),o=n.slice(t+1,s).trim();if(o.startsWith("@")){e&&(yield{kind:"text",value:e},e=""),yield{kind:"slot",raw:i,inner:o,ref:We.test(o)?o:void 0},t=s+1;continue}e+=i,t=s+1;continue}}e+=r,t+=1}e&&(yield{kind:"text",value:e})}function Ke(n){return Array.isArray(n)?n.join(", "):typeof n=="boolean"?n?"true":"false":String(n)}function ze(n){return n===" "||n==="	"||n===`\n`||n==="\\r"||n==="\\f"||n==="\\v"}function Ye(n){let e="",t=!1;for(let r of n){if(ze(r)){t=!0;continue}t&&e.length>0&&(e+=" "),t=!1,e+=r}return e}function me(n,e,t){if(e.length===0||n.indexOf(e)<0)return n;let r="",s=0,i=!1;for(;s<n.length;){if(n.startsWith(e,s)){let o=n.indexOf(t,s+e.length);if(o>=0){s=o+t.length,i=!0;continue}r+=n.slice(s);break}r+=n[s],s+=1}return i?Ye(r):n}function Se(n,e){if(n.indexOf("{")<0)return n;let t="";for(let r of Je(n)){if(r.kind==="text"){t+=r.value;continue}if(!r.ref){t+=r.raw;continue}let s=e(r.ref);t+=s===void 0?"":Ke(s)}return t}function C(n,e){for(let t of n){e(t);let r=t.children;r&&C(r,e)}}function Qe(n){return n.toLowerCase().replace(/[\'\u2019]/g,"").replace(/[^a-z0-9-]+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function S(n){let e=n.gameId?.trim();return e||Qe(n.name)}function z(n){return`cast:${n}`}var Y={open:"[",close:"]"},ye="SFX";var Q=3;function B(n){let e=new Set,t=[];for(let r of n)e.has(r)||(e.add(r),t.push(r));return t}function $(n){let e=new Map,t=(r,s)=>{let i=B([...s,...r.tags??[]]);if(e.set(r.id,i),r.type==="group"&&r.prompt&&e.set(r.prompt.id,B([...i,...r.prompt.tags??[]])),r.type==="group")for(let o of r.children)t(o,i);else for(let o of r.beats??[])e.set(o.id,B([...i,...o.tags??[]]))};for(let r of Object.values(n.scenes)){let s=B(r.tags??[]);e.set(r.id,s);for(let i of r.blocks){let o=B([...s,...i.tags??[]]);e.set(i.id,o);for(let a of i.children)t(a,o)}}return e}var ve=new WeakMap,F="Patter",N=n=>n.replace(/%/g,"%25").replace(/\\//g,"%2F"),we=Symbol("ownsRegistry"),y={stage:n=>`patter/scene/${N(n)}`,flow:n=>`patter/flow/${N(n)}/`,flowGlobals:n=>`patter/flow/${N(n)}/patter`,flowScene:(n,e)=>`patter/flow/${N(n)}/scene/${N(e)}`},A=class{constructor(e){this.journal=e}journal},H=class n{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 r=t.locale??e.locales.default,s=e.strings;this.allStrings=s,this.currentLocale=r;let i=s[r]??{},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 g of e.cast??[])g.displayName&&l.set(g.name,g.displayName);this.defaultSeed=(t.seed??2654435769)>>>0;let p=new Map,f=new Map,u=new Map;for(let[g,h]of Object.entries(e.scenes)){this.sceneGameIdToId.set(S(h),g);let v=new Map;for(let m of h.blocks)f.set(m.id,{sceneId:g}),u.set(m.id,m),v.set(S(m),m.id),C(m.children,ae=>p.set(ae.id,ae));this.blockGameIdToId.set(g,v)}let re=e.properties??[],q=re.filter(g=>g.shared??!0).map(Ee),Fe=re.filter(g=>!(g.shared??!0)).map(Ee),Ae=new Set(q.map(g=>g.name.toLowerCase())),x=t.registry??new V,ne=!t.registry||t[we]===!0,se=new b(q,{pathPrefix:"@patter."}),ie=[],T=[];try{x.mountOwned("patter",se,{owner:F}),T.push("patter");let g=new Set;if(t.world){let h=e.scopeRegistry?.scopes.find(m=>m.token==="world"),v=(h?.declarations??[]).map(Re);x.defineForeign("world",t.world,v,{writable:h?.writable??!0,owner:F}),T.push("world"),g.add("world")}for(let h of ne?e.scopeRegistry?.scopes??[]:[]){if(g.has(h.token)||x.has(h.token))continue;let v=(h.declarations??[]).map(m=>Ze(m,h.writable));x.defineOwned(h.token,v,{owner:F}),T.push(h.token),ie.push(h.token)}}catch(g){for(let h of T)x.remove(h,{keep:!0});throw g}let oe=new Map;for(let[g,h]of Object.entries(e.scenes)){let v=new Set((h.sceneProps??[]).filter(m=>m.shared??!1).map(m=>m.name.toLowerCase()));oe.set(g,v)}this.host={logEnabled:t.log??!1,emitEngine:(g,h,v)=>this.emitEngine(g,h,v),bundle:e,emitIds:c,strings:i,defaultStrings:o,castDisplay:l,nodeIndex:p,blockIndex:f,blockById:u,sceneGameIdToId:this.sceneGameIdToId,blockGameIdToId:this.blockGameIdToId,tagIndex:$(e),registry:x,ownsRegistry:ne,patterBag:se,hostScopes:ie,patterSharedDecls:q,patterLocalDecls:Fe,patterSharedNames:Ae,sceneSharedNames:oe,sharedVisits:new Map,sharedSelectors:new Map,stageBags:new Map,journal:null,customRng:t.rng,onDryChoice:t.onDryChoice,onError:t.onError??(g=>console.warn(`Patterplay: ${g.kind} on ${g.node} in flow \'${g.flow}\' failed, played through: ${g.message}`)),replayPromptOnChoose:t.replayPromptOnChoose??!1,captionsOn:t.closedCaptions??!0,captionOpen:(e.closedCaptions??Y).open,captionClose:(e.closedCaptions??Y).close,captionCharacter:e.closedCaptions?.character||ye,refSplitCache:new Map,refSplitRevision:x.revision}}get locale(){return this.currentLocale}get isSourceDebug(){return this.sourceDebug}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(),r=o=>(o.setLocale(this.currentLocale),o.setClosedCaptions(this.host.captionsOn),o),s=()=>new n(e,{...this.creationOptions,registry:this.host.registry,[we]:this.host.ownsRegistry});this.release(!0);let i=s();try{return i.loadGame(t),r(i)}catch{i.release(!0);let o=s();for(let[a,c]of Object.entries(t.flows)){let l=c.cursor.currentSceneId;try{o.openFlow(a,l!==null?{scene:l}:{})}catch{}}return r(o)}}get closedCaptions(){return this.host.captionsOn}setClosedCaptions(e){this.host.captionsOn=e}openFlow(e,t={}){this.assertExternalScopes();let{sceneId:r,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 I(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.start(r,s),a}runFlow(e,t,r){let s=this.flowsById.get(e);if(!s)return this.openFlow(e,{scene:t,block:r}).advanceToStop().played;if(!s.goto(t,r))throw new Error(`runFlow: address not found: ${t}${r===void 0?"":` / ${r}`}`);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 r=X(this.host,e);if(r===void 0)throw new Error(`unknown scene: ${e}`);if(t===void 0)return{sceneId:r};let s=Z(this.host,r,t);if(s===void 0)throw new Error(`unknown block: ${t}`);return{sceneId:r,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 X(this.host,e)??e}resolveBlockRef(e,t){if(t!=null)return e==null?t:Z(this.host,e,t)}sceneAddress(e){let t=this.host.bundle.scenes[e];return t?S(t):void 0}blockAddress(e){let t=this.host.blockById.get(e);return t?S(t):void 0}tagsForBeat(e){return this.host.tagIndex.get(e)??[]}tagsForScene(e){let t=this.resolveSceneRef(e);return(t!=null?this.host.tagIndex.get(t):void 0)??[]}tagsForBlock(e,t){let r=this.resolveSceneRef(e),s=this.resolveBlockRef(r,t);return(s!=null?this.host.tagIndex.get(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 r=this.resolveBlockRef(this.resolveSceneRef(e),t);return{...(r!=null?this.host.blockById.get(r):void 0)?.gameData}}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),r=t!=null?this.host.bundle.scenes[t]:void 0;if(!r)return[];let s=new Set;for(let i of r.blocks)be(i.children,s);return[...s]}castForBlock(e,t){let r=this.resolveSceneRef(e),s=this.resolveBlockRef(r,t),i=s!=null?this.host.blockById.get(s):void 0;if(!i)return[];let o=new Set;return be(i.children,o),[...o]}getOutline(){return Object.values(this.host.bundle.scenes).map(e=>({id:e.id,...S(e)?{gameId:S(e)}:{},name:e.name,...xe(e.gameData),...this.tagsField(e.id),blocks:e.blocks.map(t=>({id:t.id,...S(t)?{gameId:S(t)}:{},name:t.name,...xe(t.gameData),...this.tagsField(t.id),children:t.children.map(r=>this.outlineNode(r))}))}))}getBeatSequence(){let e=[];for(let t of Object.values(this.host.bundle.scenes))for(let r of t.blocks)C(r.children,s=>{if(s.type==="snippet")for(let i of s.beats??[])e.push({sceneId:t.id,blockId:r.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=this.host.tagIndex.get(e.id),r={id:e.id,kind:e.kind};if(e.kind==="line"){if(e.character!==void 0){r.character=e.character;let s=this.host.defaultStrings[z(e.character)]??this.host.castDisplay.get(e.character);s!==void 0&&(r.characterName=s)}e.direction!==void 0&&(r.direction=e.direction)}if(e.kind==="line"||e.kind==="text"){let s=this.host.defaultStrings[e.id];s!==void 0&&(r.text=s)}return e.gameData&&Object.keys(e.gameData).length&&(r.gameData=e.gameData),t&&t.length&&(r.tags=t),r}tagsField(e){let t=this.host.tagIndex.get(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,r]of this.host.stageBags)e.push({bag:r,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 A(e)}rollback(e){this.endCheckpoint(e);let t=e.journal.undo;for(let r=t.length-1;r>=0;r--)t[r]();n.forget(e.journal)}commit(e){this.endCheckpoint(e),n.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`)}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(y.stage(e));this.host.stageBags.clear(),this.host.registry.discardParked("patter/")}release(e){for(let r of this.flowsById.values())r.releaseBags(e),r.close();this.flowsById.clear();let t=this.host.registry;for(let r of this.host.stageBags.keys())t.remove(y.stage(r),{keep:e});this.host.stageBags.clear();for(let r of["patter",...this.host.hostScopes])t.has(r)&&t.remove(r,{keep:e});this.creationOptions.world&&t.has("world")&&t.remove("world")}getProperty(e){let{scope:t,name:r}=this.splitShared(e);return this.host.registry.get(t,r)}setProperty(e,t){let{scope:r,name:s}=this.splitShared(e),i=this.host.journal?this.host.registry.get(r,s):void 0;this.host.registry.set(r,s,t,{host:!0}),this.host.journal&&i!==void 0&&this.host.journal.undo.push(()=>this.host.registry.set(r,s,i,{host:!0}))}log(){return this.engineLog}clearLog(){this.engineLog.length=0}onTrace(e){return this.engineTraceHandlers.add(e),()=>this.engineTraceHandlers.delete(e)}emitEngine(e,t,r){for(let s of this.engineTraceHandlers)s(e,t);this.host.logEnabled&&this.engineLog.push({...t,flow:e,seq:this.engineSeq++,...r?{scene:r}:{}})}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:P(e),writable:e.writable??!0}))}splitShared(e){let t=Pe(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,r]of this.flowsById)e[t]=r.snapshot();return{version:Q,...this.host.ownsRegistry?{registry:this.host.registry.save()}:{},sharedVisits:Object.fromEntries(this.host.sharedVisits),sharedSelectors:Ie(this.host.sharedSelectors),flows:e}}loadGame(e){this.refuseInCheckpoint("loadGame");let t=e.version;if(t!==2&&t!==Q)throw new Error(`unsupported save version: ${String(t)}`);let r=e.flows;if(typeof r!="object"||r===null||Array.isArray(r))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(y.stage(o),{keep:!0});this.host.stageBags.clear();let i=e.version===2?et(e):e.registry;i&&(this.host.ownsRegistry?s.load(i):s.load(i,{keepParked:!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 De(e.sharedSelectors))this.host.sharedSelectors.set(o,a);for(let[o,a]of Object.entries(e.flows)){let c=new I(o,this.host,this.defaultSeed);c.restore(a),this.flowsById.set(o,c)}}},I=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 r=this.currentSceneId;if(r===null)return;let s=this.sceneBagFor(r,e);s&&s.set(e,t)}};evalCtx;ctxRevision=-1;registryQualities;flowLog=[];flowSeq=0;constructor(e,t,r){this.id=e,this.host=t,this.rngState=R(r),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(),r=this.evalCtx.scopes;for(let s of Object.keys(r))delete r[s];Object.assign(r,t.scopes),r.patter=this.patterResolver,r.scene=this.sceneResolver,this.registryQualities=t.qualities,this.ctxRevision=e.revision}return this.evalCtx}stagesFor(e,t){let r=t.toLowerCase(),s=i=>i?.find(o=>o.name.toLowerCase()===r&&o.type==="quality")?.stages;if(e==="patter")return s(this.host.patterSharedDecls)??s(this.host.patterLocalDecls);if(e==="scene"){let i=this.currentSceneId!=null?this.host.bundle.scenes[this.currentSceneId]:void 0;return s(i?.sceneProps)}return this.registryQualities?.(e,t)??s(this.host.bundle.scopeRegistry?.scopes.find(i=>i.token===e)?.declarations)}start(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(y.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.pendingChoice=null,this.started=!0,t){let r=this.host.blockIndex.get(t);if(!r)throw new Error(`unknown block: ${t}`);this.enterSceneSetup(r.sceneId),this.stack=[{sceneId:r.sceneId,containerId:t,index:0}],this.enter(t)}else{let r=e??Object.keys(this.host.bundle.scenes)[0],s=r?this.host.bundle.scenes[r]:void 0;if(!s)throw new Error(r?`unknown scene: ${r}`:"no scenes in bundle");this.enterSceneSetup(r);let i=s.blocks[0];i&&(this.stack=[{sceneId:r,containerId:i.id,index:0}],this.enter(i.id))}this.settle()}reset(e,t){this.start(e,t)}goto(e,t){if(this.closed)return!1;if(this.touch(),e==="END")return this.started=!0,this.pendingChoice=null,this.pendingPrompt=null,this.pendingPromptOwnerId=null,this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!0,this.stack=[],!0;let r=X(this.host,e);if(r===void 0)return!1;let s;return t!==void 0&&(s=Z(this.host,r,t),s===void 0)?!1:this.started?(this.pendingChoice=null,this.pendingPrompt=null,this.pendingPromptOwnerId=null,this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!1,this.enterTarget(s??r,"jump"),this.settle(),!0):(this.start(r,s),!0)}close(){this.releaseBags(!1),this.closed=!0,this.flowEnded=!0,this.stack=[],this.activeSnippet=null,this.beatIndex=0,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:r,flowEnded:s,currentSceneId:i,activeSnippet:o,beatIndex:a,pendingChoice:c,pendingPrompt:l,pendingPromptOwnerId:p}=this,f=this.stack.map(u=>({...u}));e.undo.push(()=>{Object.assign(this,{rngState:t,started:r,flowEnded:s,currentSceneId:i,activeSnippet:o,beatIndex:a,pendingChoice:c,pendingPrompt:l,pendingPromptOwnerId:p,stack:f})})}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 r=this.childrenOf(t.containerId);if(!r){this.stack.pop();continue}let s=t.index;for(;t.index<r.length&&!this.eligible(r[t.index]);)t.index++;if(this.host.logEnabled&&t.index!==s&&this.emit({type:"select",group:t.containerId,selector:"run",children:r.slice(s,t.index+1).map((i,o)=>({id:i.id,eligible:s+o===t.index})),picked:r[t.index]?.id??null}),t.index>=r.length){this.stack.pop();continue}this.enterChild(r[t.index++])}}listBags(){let e=[{bag:this.local,pathPrefix:`${this.id}/@patter.`}];for(let[t,r]of this.sceneBags)e.push({bag:r,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}:{}})}getChoices(){return this.pendingChoice?.options??[]}choose(e){let t=this.pendingChoice;if(!t)throw new Error("no choice is pending");let r=t.options.find(o=>o.id===e);if(!r)throw new Error(`unknown choice option: ${e}`);if(!r.eligible)throw new Error(`choice option is not eligible: ${e}`);this.touch();let s=t.byId.get(e);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&&r.prompt?{beat:i,shown:{...r.prompt}}:null,this.pendingPromptOwnerId=this.pendingPrompt?s.id:null,this.enterChild(s)}isEnded(){return this.flowEnded}getProperty(e){let{scope:t,name:r}=this.splitRef(e);return t==="patter"?this.patterResolver.get(r):t==="scene"?this.sceneResolver.get(r):this.host.registry.get(t,r)}setProperty(e,t){this.writeProperty(e,t,!0)}writeProperty(e,t,r){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,r?{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(e=>({...e}))}:null,pendingPromptOwnerId:this.pendingPromptOwnerId,...this.pendingPrompt?.shown?{pendingPrompt:Xe(this.pendingPrompt.shown)}:{},selectors:Ie(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(r=>r.sceneId)]))t!==null&&this.host.bundle.scenes[t]&&this.ensureSceneBags(t)}restoreCursor(e){this.rngState=R(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(r=>{let{nextId:s,...i}=r;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 r=this.host.nodeIndex.get(t.activeSnippetId);r&&r.type==="snippet"&&(this.activeSnippet=r)}if(this.selectors=De(t.selectors),this.pendingChoice=null,t.pendingChoice!==null){let r=new Map,s=[];for(let i of t.pendingChoice.options){let o=this.host.nodeIndex.get(i.id);o&&(r.set(i.id,o),s.push({...i}))}s.length>0&&(this.pendingChoice={groupId:t.pendingChoice.groupId,options:s,byId:r})}if(this.pendingPrompt=null,this.pendingPromptOwnerId=t.pendingPromptOwnerId??null,this.pendingPromptOwnerId){let r=this.host.nodeIndex.get(this.pendingPromptOwnerId),s=r?this.authoredPromptOf(r):void 0;s?this.pendingPrompt={beat:s,...t.pendingPrompt?{shown:{...t.pendingPrompt}}:{}}: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 r=this.selectChild(e);r&&this.enterChild(r)}childrenOf(e){let t=this.host.blockById.get(e);if(t)return t.children;let r=this.host.nodeIndex.get(e);if(r&&r.type==="group")return r.children}beginSnippet(e){this.runEffects(e.onEnter,e.id),this.activeSnippet=e,this.beatIndex=0}setupChoice(e){let t=[],r=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}),r.set(o.id,o))}if(t.some(o=>o.eligible)){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:r};return}let i=s.find(o=>this.eligible(o));if(i){this.enterChild(i);return}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.emit({type:"jump",to:e,mode:t}),e==="END"){this.flowEnded=!0,this.stack=[];return}let r,s,i=this.host.bundle.scenes[e];if(i){this.enterSceneSetup(e);let a=i.blocks[0];if(!a){t==="jump"&&(this.stack=[]);return}r=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),r=a.sceneId,s=e}this.enter(s);let o={sceneId:r,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)})),r=e.children.filter((c,l)=>t[l].eligible),s=e.options?.order??"sequential",i=e.options?.exhaust??"once",o=c=>(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(r.length===0)return o(null);let a=this.selectorState(e);switch(e.selector){case"branch":return o(r[0]);case"sequence":return o(s==="shuffle"?this.pickShuffle(r,i,a):s==="specificity"?this.pickSpecificity(r,i,a):this.pickSequential(r,i,a));default:return null}}pickSequential(e,t,r){let s=e.length,i=r.seq??0;return r.seq=i+1,t==="repeat"?e[i%s]:i<s?e[i]:t==="stick"?e[s-1]:null}pickShuffle(e,t,r){let s=e.length,i=t==="stick",o=()=>(i?e.slice(0,s-1):e).map(u=>u.id),a=new Set(e.map(u=>u.id));if(r.bag===void 0&&(r.bag=o()),!r.bag.some(u=>a.has(u))){if(t==="once")return null;if(i){let u=e[s-1];return r.last=u.id,u}if(r.bag=o(),r.bag.length===0)return null}let c=r.bag.filter(u=>a.has(u)),l=r.last!==void 0&&c.length>1?c.indexOf(r.last):-1,p=Math.floor(this.rng()*(l>=0?c.length-1:c.length));l>=0&&p>=l&&p++;let f=c[p];return r.bag.splice(r.bag.indexOf(f),1),r.last=f,e.find(u=>u.id===f)}pickSpecificity(e,t,r){let s=e;if(t!=="repeat"){r.bag===void 0&&(r.bag=e.map(p=>p.id));let l=new Set(r.bag);if(s=e.filter(p=>l.has(p.id)),s.length===0)return t==="stick"&&r.last!==void 0?e.find(p=>p.id===r.last)??null:null}let i=-1,a=s.map(l=>{let p=this.specScore(l);return p>i&&(i=p),{c:l,s:p}}).filter(l=>l.s===i).map(l=>l.c),c;if(a.length===1)c=a[0];else{let l=r.last!==void 0?a.findIndex(f=>f.id===r.last):-1,p=Math.floor(this.rng()*(l>=0?a.length-1:a.length));l>=0&&p>=l&&p++,c=a[p]}return t!=="repeat"&&(r.bag=r.bag.filter(l=>l!==c.id)),r.last=c.id,c}specScore(e){return e.condition?this.matchedSpec(this.conditionAst(e.condition),!0,e):0}matchedSpec(e,t,r){return le(e,i=>{try{return Ce(G(i,this.context(),K))}catch(o){return this.reportError("best-match",r.id,r.condition,o),!1}},{want:t})}selectorState(e){let t=e.shared?this.host.sharedSelectors:this.selectors,r=this.host.journal,s;if(r&&(s=e.shared?r.selectors:r.flowSelectors.get(this),s||(s=new Set,r.flowSelectors.set(this,s))),r&&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;r.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 r of e??[]){let s;try{s=this.evalExpr(r.value);let i=this.host.logEnabled?this.getProperty(r.target):void 0;this.writeProperty(r.target,s,!1),this.emit({type:"write",target:r.target,value:s,...i!==void 0?{prev:i}:{}})}catch(i){this.reportError("effect",t,r.value,i)}}}eligible(e){if(!e.condition)return!0;try{return Ce(this.evalExpr(e.condition))}catch(t){return this.reportError("condition",e.id,e.condition,t),!1}}reportError(e,t,r,s){let i=s instanceof Error?s.message:String(s),o=r?.src;this.host.onError({flow:this.id,kind:e,node:t,...o?{source:o}:{},message:i}),this.emit({type:"diagnostic",kind:e,node:t,...o?{source:o}:{},message:i})}evalExpr(e){return G(this.conditionAst(e),this.context(),K)}conditionAst(e){let t=ve.get(e);return t||(t=k(e.ast),ve.set(e,t)),t}enter(e){let t=this.visitCounts,r=t.get(e);t.set(e,(r??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(()=>{r===void 0?t.delete(e):t.set(e,r),i===void 0?s.delete(e):s.set(e,i)})}rng=()=>{if(this.host.customRng)return this.host.customRng();let e=W(this.rngState),t=e.next();return this.rngState=e.state(),t};beatResult(e){let t=this.host.tagIndex.get(e.id),r=t&&t.length?{tags:t}:{};switch(e.kind){case"gameEvent":return{type:"gameEvent",id:e.id,gameData:e.gameData,...r};case"text":return{type:"text",id:e.id,text:this.interpolate(this.resolveString(e.id)),gameData:e.gameData,...r};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,gameData:e.gameData,...r}}}}interpolate(e){return Se(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 r=this.interpolate(this.resolveString(t.id));return t.kind==="line"?{kind:"line",text:this.captionLine(r),character:t.character,characterName:this.resolveCharacterName(t.character),direction:t.direction}:{kind:"text",text:r}}authoredPromptOf(e){return e.type==="group"?e.prompt:void 0}promptResult(e,t){let r=this.host.tagIndex.get(e.id),s=r&&r.length?{tags:r}:{};return t.kind==="text"?{type:"text",id:e.id,text:t.text,gameData:e.gameData,...s}:{type:"line",id:e.id,text:t.text,character:t.character,characterName:t.characterName,direction:t.direction,gameData:e.gameData,...s}}promptBeatOf(e){return e.type==="group"&&e.prompt?e.prompt:((e.type==="snippet"?e:this.firstTextSnippetIn(e.children))?.beats??[]).find(r=>r.kind==="line"||r.kind==="text")}firstTextSnippetIn(e){let t;return C(e,r=>{!t&&r.type==="snippet"&&(r.beats??[]).some(s=>s.kind==="line"||s.kind==="text")&&(t=r)}),t}resolveString(e){if(this.host.emitIds)return e;let t=this.host.strings[e];if(t!==void 0)return t;let r=this.host.defaultStrings[e];return r!==void 0?`<Untranslated: ${e}> ${r}`:e}resolveCharacterName(e){if(e===void 0||this.host.emitIds)return;let t=z(e);return this.host.strings[t]??this.host.defaultStrings[t]??this.host.castDisplay.get(e)}splitRef(e){return Pe(this.host,e)}newLocal(){return new b(this.host.patterLocalDecls,{pathPrefix:"@patter."})}mountLocal(){this.local=this.newLocal();let e=y.flowGlobals(this.id);this.host.registry.mountOwned(e,this.local,{owner:F}),this.registered.add(e)}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,r=this.host.bundle.scenes[e]?.sceneProps??[],s=this.host.journal;if(!this.sceneBags.has(e)){let i=new b(r.filter(c=>!t.has(c.name.toLowerCase())),{pathPrefix:"@scene."}),o=y.flowScene(this.id,e),a=ke(this.host.registry,o,i,s!==null);this.registered.add(o),this.sceneBags.set(e,i),s&&s.undo.push(()=>{this.sceneBags.get(e)===i&&(this.host.registry.remove(o,a?{keep:!0}:void 0),this.registered.delete(o),this.sceneBags.delete(e))})}if(!this.host.stageBags.has(e)){let i=new b(r.filter(a=>t.has(a.name.toLowerCase())),{pathPrefix:"@scene."}),o=ke(this.host.registry,y.stage(e),i,s!==null);this.host.stageBags.set(e,i),s&&s.undo.push(()=>{this.host.stageBags.get(e)===i&&(this.host.registry.remove(y.stage(e),o?{keep:!0}:void 0),this.host.stageBags.delete(e))})}}seedScene(e){let t=this.host.sceneSharedNames.get(e.id)??new Set;this.ensureSceneBags(e.id);for(let r of e.sceneProps??[]){if(!r.temporary)continue;let s=r.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,P(r))}}};function be(n,e){C(n,t=>{if(t.type==="group"){t.prompt?.kind==="line"&&t.prompt.character&&e.add(t.prompt.character);return}for(let r of t.beats??[])r.kind==="line"&&r.character&&e.add(r.character)})}function xe(n){return n&&Object.keys(n).length?{gameData:n}:{}}function Xe(n){let e={kind:n.kind,text:n.text};return n.character!==void 0&&(e.character=n.character),n.characterName!==void 0&&(e.characterName=n.characterName),n.direction!==void 0&&(e.direction=n.direction),e}function Ie(n){let e={};for(let[t,r]of n){let s={};r.seq!==void 0&&(s.seq=r.seq),r.bag&&(s.bag=[...r.bag]),r.last!==void 0&&(s.last=r.last),e[t]=s}return e}function De(n){let e=new Map;for(let[t,r]of Object.entries(n??{})){let s={};r.seq!==void 0&&(s.seq=r.seq),r.bag&&(s.bag=[...r.bag]),r.last!==void 0&&(s.last=r.last),e.set(t,s)}return e}function ke(n,e,t,r){let s=r?JSON.stringify(t.save()):"";return n.mountOwned(e,t,{owner:F}),r&&JSON.stringify(t.save())!==s}function Ee(n){return{name:n.name,type:n.type,values:n.values,stages:n.stages,default:n.default}}function Re(n){return{name:n.name,type:n.type,values:n.values,stages:n.stages,default:n.default,writable:n.writable}}function Ze(n,e){let t=Re(n),r=n.writable??e;return r===void 0?t:{...t,writable:r}}function X(n,e){return n.sceneGameIdToId.get(e)??(n.bundle.scenes[e]?e:void 0)}function Z(n,e,t){return n.blockGameIdToId.get(e)?.get(t)??(n.blockIndex.get(t)?.sceneId===e?t:void 0)}function Pe(n,e){n.refSplitRevision!==n.registry.revision&&(n.refSplitCache.clear(),n.refSplitRevision=n.registry.revision);let t=n.refSplitCache.get(e);return t||(t=fe(e,r=>r==="scene"||n.registry.has(r)||(n.bundle.externalScopes?.includes(r)??!1)),n.refSplitCache.set(e,t)),t}function et(n){let e={};n.shared?.patter&&(e.patter=n.shared.patter);for(let[t,r]of Object.entries(n.stageBags??{}))e[y.stage(t)]=r;for(let[t,r]of Object.entries(n.flows??{})){r.scopes?.patter&&(e[y.flowGlobals(t)]=r.scopes.patter);for(let[s,i]of Object.entries(r.sceneBags??{}))e[y.flowScene(t,s)]=i}return e}function Ce(n){return typeof n=="boolean"?n:typeof n=="number"?n!==0:typeof n=="string"?n!=="":n.length>0}var tt=(n,e)=>n.shared??e;function ee(n,e){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.default!==void 0?{default:n.default}:{},shared:tt(n,e)}}function rt(n){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.values?{values:[...n.values]}:{},...n.purpose?{purpose:n.purpose}:{}}}function nt(n,e){e.blocks++;let t=[...n.children];for(;t.length;){let r=t.pop();if(r.type==="group"){e.groups++,r.prompt&&e.prompts++,t.push(...r.children);continue}e.snippets++;for(let s of r.beats??[])e.beats++,s.kind==="gameEvent"&&e.gameEvents++}}function Oe(n){let e={scenes:0,blocks:0,groups:0,snippets:0,beats:0,prompts:0,gameEvents:0,cast:n.cast?.length??0},t=[],r=[];for(let o of Object.values(n.scenes)){e.scenes++;let a=S(o);t.push({gameId:a,name:o.name,blocks:o.blocks.map(c=>({gameId:S(c),name:c.name}))});for(let c of o.blocks)nt(c,e);o.sceneProps?.length&&r.push({gameId:a,properties:o.sceneProps.map(c=>ee(c,!1))})}let s=(n.scopeRegistry?.scopes??[]).map(o=>({token:o.token,writable:o.writable??!0,opaque:o.declarations===void 0,properties:(o.declarations??[]).map(a=>ee(a,!0))})),i=Object.entries(n.gameDataFields??{}).filter(([,o])=>(o?.length??0)>0).map(([o,a])=>({kind:o,fields:(a??[]).map(rt)}));return{identity:{schema:n.schema,project:n.content.project,...n.content.version!==void 0?{version:n.content.version}:{},...n.content.hash!==void 0?{hash:n.content.hash}:{},...n.content.structureHash!==void 0?{structureHash:n.content.structureHash}:{},voiced:n.voiced,defaultLocale:n.locales.default,locales:[...n.locales.included],localisation:n.localisation?.mode??"embedded",sourceDebug:n.localisation?.sourceDebug??!1},addresses:t,hostScopes:s,properties:{patter:(n.properties??[]).map(o=>ee(o,!0)),scene:r},gameData:i,counts:e}}function Be(n,e){return n.gameDataFields?.[e]??[]}function te(n,e,t){return e&&Object.prototype.hasOwnProperty.call(e,t)?e[t]:n.find(r=>r.name===t)?.default}function Ne(n,e){let t={};for(let r of n){let s=te(n,e,r.name);s!==void 0&&(t[r.name]=s)}for(let[r,s]of Object.entries(e??{}))r in t||(t[r]=s);return t}return Me(st);})();\n';
+var PLAYABLE_RUNTIME_JS = 'var Patterplay=(()=>{var W=Object.defineProperty;var Me=Object.getOwnPropertyDescriptor;var $e=Object.getOwnPropertyNames;var He=Object.prototype.hasOwnProperty;var qe=(n,e)=>{for(var t in e)W(n,t,{get:e[t],enumerable:!0})},_e=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of $e(e))!He.call(n,s)&&s!==t&&W(n,s,{get:()=>e[s],enumerable:!(r=Me(e,s))||r.enumerable});return n};var Ue=n=>_e(W({},"__esModule",{value:!0}),n);var pt={};qe(pt,{Checkpoint:()=>T,Engine:()=>_,Flow:()=>D,buildTagIndex:()=>q,describeBundle:()=>Ae,effectiveGameData:()=>Ge,gameDataFields:()=>Te,gameDataValue:()=>se});function R(n,e){return n!==void 0&&Object.prototype.hasOwnProperty.call(n,e)?n[e]:void 0}function k(n){switch(n[0]){case"b":return{kind:"bool",value:n[1]};case"n":return{kind:"number",value:n[1]};case"s":return{kind:"string",value:n[1]};case"sv":return{kind:"scopedvar",scope:n[1],name:n[2]};case"u":return{kind:"unary",op:n[1],operand:k(n[2])};case"bin":return{kind:"binary",op:n[1],left:k(n[2]),right:k(n[3])};case"call":{let e=n.slice(2).map(k);return{kind:"call",name:n[1],args:e}}case"fd":return{kind:"flagdelta",sign:n[1],name:n[2]}}}var d=class extends Error{constructor(e){super(e),this.name="EvalError"}};function V(n,e,t){let r=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=R(e.scopes,i.scope);if(o===void 0)return!1;let a=typeof o.get=="function"?o.get(i.name):R(o,i.name);if(a===void 0){if(r.get(i.scope)==="throw")throw new d(`@${i.scope}.${i.name} is not declared on the current ${i.scope}.`);return!1}return a}case"call":{if(i.name==="advance"&&!R(t.functions,i.name)){let a=i.args[0];if(i.args.length!==1||a===void 0)throw new d(`advance() takes exactly 1 argument, got ${i.args.length}`);let c=J(a,e);if(c===void 0)throw new d("advance() needs a quality reference (@scope.name of a quality property)");let l=w(s(a),c,"advance");return c[Math.min(l+1,c.length-1)]}let o=R(t.functions,i.name);if(!o)throw new d(`unknown function \'${i.name}\'`);return o.eval(i.args,{evaluate:s,ctx:e})}case"flagdelta":throw new d("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 d(`\'not\' requires a boolean operand, got ${typeof a}`);return!a}let o=s(i.operand);if(typeof o!="number")throw new d(`unary \'-\' requires a numeric operand, got ${typeof o}`);return-o}case"binary":{if(i.op==="and"){let f=s(i.left);if(typeof f!="boolean")throw new d(`\'and\' requires boolean operands, left is ${typeof f}`);if(!f)return!1;let u=s(i.right);if(typeof u!="boolean")throw new d(`\'and\' requires boolean operands, right is ${typeof u}`);return u}if(i.op==="or"){let f=s(i.left);if(typeof f!="boolean")throw new d(`\'or\' requires boolean operands, left is ${typeof f}`);if(f)return!0;let u=s(i.right);if(typeof u!="boolean")throw new d(`\'or\' requires boolean operands, right is ${typeof u}`);return u}let o=s(i.left),a=s(i.right),c=J(i.left,e),l=J(i.right,e),p=c??l;if(p!==void 0){if(c&&l&&!We(c,l)&&(i.op===">"||i.op===">="||i.op==="<"||i.op==="<="))throw new d(`\'${i.op}\' compares two different qualities, whose stage orders are unrelated`);switch(i.op){case">":return w(o,p,">")>w(a,p,">");case">=":return w(o,p,">=")>=w(a,p,">=");case"<":return w(o,p,"<")<w(a,p,"<");case"<=":return w(o,p,"<=")<=w(a,p,"<=");case"+":case"-":case"*":case"/":throw new d(`\'${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 E(o,a,">"),o>a;case">=":return E(o,a,">="),o>=a;case"<":return E(o,a,"<"),o<a;case"<=":return E(o,a,"<="),o<=a;case"+":if(typeof o=="number"&&typeof a=="number"||typeof o=="string"&&typeof a=="string")return o+a;throw new d(`\'+\' requires two numbers or two strings, got ${typeof o} and ${typeof a}`);case"-":return E(o,a,"-"),o-a;case"*":return E(o,a,"*"),o*a;case"/":if(E(o,a,"/"),a===0)throw new d("division by zero");return o/a}}}};return s(n)}function pe(n,e){if(Array.isArray(n)||Array.isArray(e)){if(!Array.isArray(n)||!Array.isArray(e)||n.length!==e.length)return!1;let t=[...n].sort(),r=[...e].sort();for(let s=0;s<t.length;s++)if(t[s]!==r[s])return!1;return!0}return n===e}function E(n,e,t){if(typeof n!="number"||typeof e!="number")throw new d(`\'${t}\' requires numeric operands, got ${typeof n} and ${typeof e}`)}function J(n,e){if(!(n.kind!=="scopedvar"||e.qualities===void 0))return e.qualities(n.scope,n.name)}function w(n,e,t){if(typeof n!="string")throw new d(`\'${t}\' on a quality compares stages, got ${typeof n}`);let r=e.indexOf(n);if(r<0)throw new d(`"${n}" is not a stage of this quality (stages: ${e.join(", ")})`);return r}var We=(n,e)=>n.length===e.length&&n.every((t,r)=>t===e[r]);function O(n){if(Number.isNaN(n)||!Number.isFinite(n))return 0;let e=Math.trunc(n)%4294967296;return e<0?e+4294967296:e}function K(n){let e=O(n);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 Je={name:"check_flags",count:n=>Math.max(1,n.args.length-1)},Ke=[Je];function de(n,e,t){let r=t?.countingCalls??Ke;return L(n,t?.want??!0,e,r)}function L(n,e,t,r){if(n.kind==="binary"&&(n.op==="and"||n.op==="or")){let s=L(n.left,e,t,r),i=L(n.right,e,t,r);return n.op==="and"===e?s>0&&i>0?s+i:0:Math.max(s,i)}if(n.kind==="unary"&&n.op==="not")return L(n.operand,!e,t,r);if(n.kind==="call"){let s=r.find(i=>i.name===n.name);if(s){let i=s.count(n),o=t(n);return e?o?i:0:o?0:1}}return t(n)===e?1:0}var b=class n{values=Object.create(null);decls=new Map;subscribers=new Set;auditors=new Set;norm;pathPrefix;constructor(e=[],t){this.norm=t?.normalise??(r=>r.toLowerCase()),this.pathPrefix=t?.pathPrefix??"",this.seed(e)}seed(e){for(let t of e){let r=this.norm(t.name);this.decls.set(r,t),this.values[r]=structuredClone(t.default??P(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,r){let s=this.norm(e);if(!r?.host&&!this.writable(s))throw new Error(`\'${e}\' is read-only`);let i={name:s,prev:this.values[s],next:t,silent:r?.silent??!1,reason:r?.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])=>ue(t,this.get(e),void 0,e,this.pathPrefix))}declarations(){return[...this.decls.values()]}clone(){let e=new n([],{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){for(let[t,r]of Object.entries(e))this.values[this.norm(t)]=r}};function ue(n,e,t,r,s=""){let i=r??n.name.toLowerCase();return{name:i,path:s+i,type:n.type,value:e,default:n.default??P(n),...n.values!==void 0?{values:n.values}:{},...n.stages!==void 0?{stages:n.stages}:{},writable:t??n.writable??!0}}var ze=n=>n.toLowerCase(),z=1,M=class{scopes=new Map;parked=new Map;rev=0;get revision(){return this.rev}defineOwned(e,t,r){let s=typeof r=="string"?{pathPrefix:r}:r??{},i=new b(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,r){this.assertFree(e,r?.owner),this.scopes.set(e,{kind:"owned",bag:t,...r?.owner!==void 0?{owner:r.owner}:{}}),this.rev++;let s=this.parked.get(e);return s&&(t.load(s),this.parked.delete(e)),this}remove(e,t){let r=this.scopes.get(e);if(!r)throw new Error(`unknown scope \'@${e}\'`);return t?.keep&&r.kind==="owned"&&this.parked.set(e,r.bag.save()),this.scopes.delete(e),this.rev++,this}discardParked(e){if(e===void 0)this.parked.clear();else for(let t of[...this.parked.keys()])t.startsWith(e)&&this.parked.delete(t);return this}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,r=[],s=!0){let i=typeof s=="boolean"?{writable:s}:s;this.assertFree(e,i.owner);let o=i.normalise??ze,a=new Map;for(let c of r)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 r=this.scopes.get(e);if(r)return r.kind==="owned"?r.bag.get(t):r.resolver.get(r.norm(t))}set(e,t,r,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,r,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,r)}foreignWritable(e,t){return e.resolver.set?e.decls.get(t)?.writable??e.scopeWritable:!1}listProperties(){let e=[];for(let[t,r]of this.scopes){let s=r.owner!==void 0?{owner:r.owner}:{};if(r.kind==="owned")for(let i of r.bag.rows())e.push({scope:t,...s,...i});else for(let[i,o]of r.decls)e.push({scope:t,...s,...ue(o,r.resolver.get(i),this.foreignWritable(r,i),i,`${t}.`)})}return e}toEvalContext(e,t){let r=this.view(t?.aliases),s={};for(let[o,a]of r)s[o]=a.kind==="owned"?a.bag.values:a.resolver;let i=this.qualityLadders(r);return i.size===0?{scopes:s,host:e}:{scopes:s,host:e,qualities:(o,a)=>{let c=r.get(o);return c?i.get(o)?.get(Ye(c)(a)):void 0}}}view(e){let t=new Map(this.scopes);for(let[r,s]of Object.entries(e??{})){let i=this.scopes.get(s);if(!i)throw new Error(`alias \'@${r}\' names \'${s}\', which is not registered`);t.set(r,i)}return t}qualityLadders(e){let t=new Map;for(let[r,s]of e)for(let[i,o]of ge(s)){if(o.type!=="quality"||o.stages===void 0)continue;let a=t.get(r);a||(a=new Map,t.set(r,a)),a.set(i,o.stages)}return t}toSchema(e){let t=new Map;for(let[r,s]of this.view(e?.aliases)){let i=ge(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(r,o)}return{properties:t}}save(){let e={};for(let[t,r]of this.scopes)r.kind==="owned"&&(e[t]=r.bag.save());for(let[t,r]of this.parked)e[t]=structuredClone(r);return e}load(e,t){t?.keepParked||this.parked.clear();for(let[r,s]of Object.entries(e)){let i=this.scopes.get(r);i?.kind==="owned"?i.bag.load(s):i||this.parked.set(r,structuredClone(s))}}saveFragment(){return{version:z,scopes:this.save()}}loadFragment(e){if(e.version!==z)throw new Error(`unsupported owned-state fragment version ${e.version} (supported: ${z})`);this.load(e.scopes)}assertFree(e,t){let r=this.scopes.get(e);if(!r)return;let s=r.owner!==void 0?` by ${r.owner}`:"",i=t!==void 0?` (wanted by ${t})`:"";throw new Error(`scope \'@${e}\' is already registered${s}${i}`)}};function ge(n){return n.kind==="foreign"?[...n.decls.entries()]:n.bag.declarations().map(e=>[n.bag.normalise(e.name),e])}function Ye(n){return n.kind==="foreign"?n.norm:e=>n.bag.normalise(e)}function P(n){if(n.default!==void 0)return n.default;switch(n.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"enum":return n.values?.[0]??"";case"flags":return[];case"quality":return n.stages?.[0]??"";default:return!1}}var he=[{token:"patter",engine:"Patterplay",means:"Patter\'s shared globals"},{token:"story",engine:"Storylet Engine",means:"the Storylet Engine\'s shared @story properties"}];function B(n){return n.ctx.host??{}}var Y={defaultScope:"patter",scopes:[{token:"patter"},{token:"scene"}],functions:{random:{minArgs:2,maxArgs:2,returnType:"number",eval(n,e){if(n.length!==2)throw new d("random(a, b) requires exactly 2 arguments");let t=B(e).nextRandom;if(!t)throw new d("random() called without a PRNG in context");let r=e.evaluate(n[0]),s=e.evaluate(n[1]);if(typeof r!="number"||typeof s!="number")throw new d("random(a, b) arguments must be numbers");if(!Number.isInteger(r)||!Number.isInteger(s))throw new d("random(a, b) arguments must be integers");let i=Math.min(r,s),o=Math.max(r,s);return Math.floor(t()*(o-i+1))+i}},check_flags:{minArgs:1,returnType:"boolean",flagDeltaArgs:!0,validate:me("check_flags"),eval(n,e){let t=fe(n[0],e,"check_flags");for(let r=1;r<n.length;r++){let s=n[r];if(s.kind!=="flagdelta")throw new d("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:me("set_flags"),eval(n,e){let t=[...fe(n[0],e,"set_flags")];for(let r=1;r<n.length;r++){let s=n[r];if(s.kind!=="flagdelta")throw new d("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:H("visits"),eval:(n,e)=>B(e).visits?.($(n,e,"visits"))??0},seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:H("seen"),eval:(n,e)=>(B(e).visits?.($(n,e,"seen"))??0)>0},patter_visits:{minArgs:1,maxArgs:1,returnType:"number",validate:H("patter_visits"),eval:(n,e)=>B(e).patterVisits?.($(n,e,"patter_visits"))??0},patter_seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:H("patter_seen"),eval:(n,e)=>(B(e).patterVisits?.($(n,e,"patter_seen"))??0)>0}}},Rt=he.map(n=>n.token).filter(n=>n!=="patter"&&n!=="scene");function Se(n,e){let t=n.replace(/^@/,"").split(".");return t.length===2&&e(t[0])?{scope:t[0],name:t[1].toLowerCase()}:{scope:"patter",name:t.join(".").toLowerCase()}}function $(n,e,t){let r=e.evaluate(n[0]);if(typeof r!="string")throw new d(`${t}(id) requires a string node id`);return r}function H(n){return(e,t)=>{let r=e[0];r&&r.kind!=="string"&&t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(id): the argument must be a string id literal (a scene / block / node id)`})}}function fe(n,e,t){if(!n)throw new d(`${t}() requires at least one argument (the flags variable)`);let r=e.evaluate(n);if(Array.isArray(r))return r;if(r===!1||r===null||r===void 0)return[];throw new d(`${t}() first argument must be a flags property`)}function me(n){return(e,t)=>{if(e.length===0)return;let r=e[0];if(r.kind!=="scopedvar"){t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(): first argument must be a flags property reference (@name or @scope.name)`});return}let s=t.schema.properties.get(r.scope)?.get(r.name);if(s&&s.type!=="flags"){let i=r.scope===t.defaultScope?r.name:`${r.scope}.${r.name}`;t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(): \'@${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:`${n}(): 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:`${n}(): unknown flag \'${o.name}\'`,reference:o.name})}}}var Qe=/^@[A-Za-z0-9_.]+$/;function*Xe(n){let e="",t=0;for(;t<n.length;){let r=n[t];if(r==="{"&&n[t+1]==="{"){e+="{",t+=2;continue}if(r==="}"&&n[t+1]==="}"){e+="}",t+=2;continue}if(r==="{"){let s=n.indexOf("}",t+1);if(s!==-1){let i=n.slice(t,s+1),o=n.slice(t+1,s).trim();if(o.startsWith("@")){e&&(yield{kind:"text",value:e},e=""),yield{kind:"slot",raw:i,inner:o,ref:Qe.test(o)?o:void 0},t=s+1;continue}e+=i,t=s+1;continue}}e+=r,t+=1}e&&(yield{kind:"text",value:e})}function Ze(n){return Array.isArray(n)?n.join(", "):typeof n=="boolean"?n?"true":"false":String(n)}function et(n){return n===" "||n==="	"||n===`\n`||n==="\\r"||n==="\\f"||n==="\\v"}function tt(n){let e="",t=!1;for(let r of n){if(et(r)){t=!0;continue}t&&e.length>0&&(e+=" "),t=!1,e+=r}return e}function ye(n,e,t){if(e.length===0||n.indexOf(e)<0)return n;let r="",s=0,i=!1;for(;s<n.length;){if(n.startsWith(e,s)){let o=n.indexOf(t,s+e.length);if(o>=0){s=o+t.length,i=!0;continue}r+=n.slice(s);break}r+=n[s],s+=1}return i?tt(r):n}function ve(n,e){if(n.indexOf("{")<0)return n;let t="";for(let r of Xe(n)){if(r.kind==="text"){t+=r.value;continue}if(!r.ref){t+=r.raw;continue}let s=e(r.ref);t+=s===void 0?"":Ze(s)}return t}function I(n,e){for(let t of n){e(t);let r=t.children;r&&I(r,e)}}function rt(n){return n.toLowerCase().replace(/[\'\u2019]/g,"").replace(/[^a-z0-9-]+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function S(n){let e=n.gameId?.trim();return e||rt(n.name)}function Q(n){return`cast:${n}`}var X={open:"[",close:"]"},we="SFX";var Z=3;function N(n){let e=new Set,t=[];for(let r of n)e.has(r)||(e.add(r),t.push(r));return t}function q(n){let e=new Map,t=(r,s)=>{let i=N([...s,...r.tags??[]]);if(e.set(r.id,i),r.type==="group"&&r.prompt&&e.set(r.prompt.id,N([...i,...r.prompt.tags??[]])),r.type==="group")for(let o of r.children)t(o,i);else for(let o of r.beats??[])e.set(o.id,N([...i,...o.tags??[]]))};for(let r of Object.values(n.scenes)){let s=N(r.tags??[]);e.set(r.id,s);for(let i of r.blocks){let o=N([...s,...i.tags??[]]);e.set(i.id,o);for(let a of i.children)t(a,o)}}return e}var be=new WeakMap,xe=new WeakMap;function nt(n){let e=xe.get(n);return e||(e=q(n),xe.set(n,e)),e}function C(n,e){return n.tagIndex.get(e)?.slice()}var A="Patter",F=n=>n.replace(/%/g,"%25").replace(/\\//g,"%2F"),ke=Symbol("ownsRegistry"),y={stage:n=>`patter/scene/${F(n)}`,flow:n=>`patter/flow/${F(n)}/`,flowGlobals:n=>`patter/flow/${F(n)}/patter`,flowScene:(n,e)=>`patter/flow/${F(n)}/scene/${F(e)}`},T=class{constructor(e){this.journal=e}journal},_=class n{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 r=t.locale??e.locales.default,s=e.strings;this.allStrings=s,this.currentLocale=r;let i=s[r]??{},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 g of e.cast??[])g.displayName&&l.set(g.name,g.displayName);this.defaultSeed=(t.seed??2654435769)>>>0;let p=new Map,f=new Map,u=new Map;for(let[g,h]of Object.entries(e.scenes)){this.sceneGameIdToId.set(S(h),g);let v=new Map;for(let m of h.blocks)f.set(m.id,{sceneId:g}),u.set(m.id,m),v.set(S(m),m.id),I(m.children,j=>p.set(j.id,j));this.blockGameIdToId.set(g,v)}let ie=e.properties??[],U=ie.filter(g=>g.shared??!0).map(De),je=ie.filter(g=>!(g.shared??!0)).map(De),Ve=new Set(U.map(g=>g.name.toLowerCase())),x=t.registry??new M,oe=!t.registry||t[ke]===!0,ae=new b(U,{pathPrefix:"@patter."}),ce=[],G=[];try{x.mountOwned("patter",ae,{owner:A}),G.push("patter");let g=new Set;for(let[h,v]of Object.entries(Re(t))){let m=e.scopeRegistry?.scopes.find(Le=>Le.token===h),j=(m?.declarations??[]).map(Ne);x.defineForeign(h,v,j,{writable:m?.writable??!0,owner:A}),G.push(h),g.add(h)}for(let h of oe?e.scopeRegistry?.scopes??[]:[]){if(g.has(h.token)||x.has(h.token))continue;let v=(h.declarations??[]).map(m=>it(m,h.writable));x.defineOwned(h.token,v,{owner:A}),G.push(h.token),ce.push(h.token)}}catch(g){for(let h of G)x.remove(h,{keep:!0});throw g}let le=new Map;for(let[g,h]of Object.entries(e.scenes)){let v=new Set((h.sceneProps??[]).filter(m=>m.shared??!1).map(m=>m.name.toLowerCase()));le.set(g,v)}this.host={logEnabled:t.log??!1,tracing:t.log??!1,emitEngine:(g,h,v)=>this.emitEngine(g,h,v),bundle:e,emitIds:c,strings:i,defaultStrings:o,castDisplay:l,nodeIndex:p,blockIndex:f,blockById:u,sceneGameIdToId:this.sceneGameIdToId,blockGameIdToId:this.blockGameIdToId,tagIndex:nt(e),registry:x,ownsRegistry:oe,patterBag:ae,hostScopes:ce,patterSharedDecls:U,patterLocalDecls:je,patterSharedNames:Ve,sceneSharedNames:le,sharedVisits:new Map,qualityLadders:new Map,sharedSelectors:new Map,stageBags:new Map,journal:null,customRng:t.rng,onDryChoice:t.onDryChoice,onError:t.onError??(g=>console.warn(`Patterplay: ${g.kind} on ${g.node} in flow \'${g.flow}\' failed, played through: ${g.message}`)),replayPromptOnChoose:t.replayPromptOnChoose??!1,captionsOn:t.closedCaptions??!0,captionOpen:(e.closedCaptions??X).open,captionClose:(e.closedCaptions??X).close,captionCharacter:e.closedCaptions?.character||we,refSplitCache:new Map,refSplitRevision:x.revision}}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(),r=o=>(o.setLocale(this.currentLocale),o.setClosedCaptions(this.host.captionsOn),o),s=()=>new n(e,{...this.creationOptions,registry:this.host.registry,[ke]:this.host.ownsRegistry});this.release(!0);let i=s();try{return i.loadGame(t),r(i)}catch{i.release(!0);let o=s();for(let[a,c]of Object.entries(t.flows)){let l=c.cursor.currentSceneId;try{o.openFlow(a,l!==null?{scene:l}:{})}catch{}}return r(o)}}get closedCaptions(){return this.host.captionsOn}setClosedCaptions(e){this.host.captionsOn=e}openFlow(e,t={}){this.assertExternalScopes();let{sceneId:r,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 D(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(r,s),a}runFlow(e,t,r){let s=this.flowsById.get(e);if(!s)return this.openFlow(e,{scene:t,block:r}).advanceToStop().played;if(!s.goto(t,r))throw new Error(`runFlow: address not found: ${t}${r===void 0?"":` / ${r}`}`);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 r=te(this.host,e);if(r===void 0)throw new Error(`unknown scene: ${e}`);if(t===void 0)return{sceneId:r};let s=re(this.host,r,t);if(s===void 0)throw new Error(`unknown block: ${t}`);return{sceneId:r,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 te(this.host,e)??e}resolveBlockRef(e,t){if(t!=null)return e==null?t:re(this.host,e,t)}sceneAddress(e){let t=this.host.bundle.scenes[e];return t?S(t):void 0}blockAddress(e){let t=this.host.blockById.get(e);return t?S(t):void 0}tagsForBeat(e){return C(this.host,e)??[]}tagsForScene(e){let t=this.resolveSceneRef(e);return(t!=null?C(this.host,t):void 0)??[]}tagsForBlock(e,t){let r=this.resolveSceneRef(e),s=this.resolveBlockRef(r,t);return(s!=null?C(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 r=this.resolveBlockRef(this.resolveSceneRef(e),t);return{...(r!=null?this.host.blockById.get(r):void 0)?.gameData}}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),r=t!=null?this.host.bundle.scenes[t]:void 0;if(!r)return[];let s=new Set;for(let i of r.blocks)Ee(i.children,s);return[...s]}castForBlock(e,t){let r=this.resolveSceneRef(e),s=this.resolveBlockRef(r,t),i=s!=null?this.host.blockById.get(s):void 0;if(!i)return[];let o=new Set;return Ee(i.children,o),[...o]}getOutline(){return Object.values(this.host.bundle.scenes).map(e=>({id:e.id,...S(e)?{gameId:S(e)}:{},name:e.name,...Ce(e.gameData),...this.tagsField(e.id),blocks:e.blocks.map(t=>({id:t.id,...S(t)?{gameId:S(t)}:{},name:t.name,...Ce(t.gameData),...this.tagsField(t.id),children:t.children.map(r=>this.outlineNode(r))}))}))}getBeatSequence(){let e=[];for(let t of Object.values(this.host.bundle.scenes))for(let r of t.blocks)I(r.children,s=>{if(s.type==="snippet")for(let i of s.beats??[])e.push({sceneId:t.id,blockId:r.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=C(this.host,e.id),r={id:e.id,kind:e.kind};if(e.kind==="line"){if(e.character!==void 0){r.character=e.character;let s=this.host.defaultStrings[Q(e.character)]??this.host.castDisplay.get(e.character);s!==void 0&&(r.characterName=s)}e.direction!==void 0&&(r.direction=e.direction)}if(e.kind==="line"||e.kind==="text"){let s=this.host.defaultStrings[e.id];s!==void 0&&(r.text=s)}return e.gameData&&Object.keys(e.gameData).length&&(r.gameData=e.gameData),t&&t.length&&(r.tags=t),r}tagsField(e){let t=C(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,r]of this.host.stageBags)e.push({bag:r,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 T(e)}rollback(e){this.endCheckpoint(e);let t=e.journal.undo;for(let r=t.length-1;r>=0;r--)t[r]();n.forget(e.journal)}commit(e){this.endCheckpoint(e),n.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`)}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(y.stage(e));this.host.stageBags.clear(),this.host.registry.discardParked("patter/")}release(e){for(let r of this.flowsById.values())r.releaseBags(e),r.close();this.flowsById.clear();let t=this.host.registry;for(let r of this.host.stageBags.keys())t.remove(y.stage(r),{keep:e});this.host.stageBags.clear();for(let r of["patter",...this.host.hostScopes])t.has(r)&&t.remove(r,{keep:e});for(let r of Object.keys(Re(this.creationOptions)))t.has(r)&&t.remove(r)}getProperty(e){let{scope:t,name:r}=this.splitShared(e);return this.host.registry.get(t,r)}setProperty(e,t){let{scope:r,name:s}=this.splitShared(e),i=this.host.journal?this.host.registry.get(r,s):void 0;this.host.registry.set(r,s,t,{host:!0}),this.host.journal&&i!==void 0&&this.host.journal.undo.push(()=>this.host.registry.set(r,s,i,{host:!0}))}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,r){for(let s of this.engineTraceHandlers)s(e,t);this.host.logEnabled&&this.engineLog.push({...t,flow:e,seq:this.engineSeq++,...r?{scene:r}:{}})}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:P(e),writable:e.writable??!0}))}splitShared(e){let t=Fe(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,r]of this.flowsById)e[t]=r.snapshot();return{version:Z,...this.host.ownsRegistry?{registry:this.host.registry.save()}:{},sharedVisits:Object.fromEntries(this.host.sharedVisits),sharedSelectors:Pe(this.host.sharedSelectors),flows:e}}loadGame(e){this.refuseInCheckpoint("loadGame");let t=e.version;if(t!==2&&t!==Z)throw new Error(`unsupported save version: ${String(t)}`);let r=e.flows;if(typeof r!="object"||r===null||Array.isArray(r))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(y.stage(o),{keep:!0});this.host.stageBags.clear();let i=e.version===2?ot(e):e.registry;i&&(this.host.ownsRegistry?s.load(i):s.load(i,{keepParked:!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 Be(e.sharedSelectors))this.host.sharedSelectors.set(o,a);for(let[o,a]of Object.entries(e.flows)){let c=new D(o,this.host,this.defaultSeed);c.restore(a),this.flowsById.set(o,c)}}},D=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 r=this.currentSceneId;if(r===null)return;let s=this.sceneBagFor(r,e);s&&s.set(e,t)}};evalCtx;ctxRevision=-1;registryQualities;flowLog=[];flowSeq=0;constructor(e,t,r){this.id=e,this.host=t,this.rngState=O(r),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(),r=this.evalCtx.scopes;for(let s of Object.keys(r))delete r[s];Object.assign(r,t.scopes),r.patter=this.patterResolver,r.scene=this.sceneResolver,this.registryQualities=t.qualities,this.ctxRevision=e.revision}return this.evalCtx}stagesFor(e,t){let r=t.toLowerCase();if(e==="patter")return ee(this.host,"patter",()=>[...this.host.patterSharedDecls,...this.host.patterLocalDecls]).get(r);if(e==="scene"){let s=this.currentSceneId;return s==null?void 0:ee(this.host,`scene/${s}`,()=>this.host.bundle.scenes[s]?.sceneProps).get(r)}return this.registryQualities?.(e,t)??ee(this.host,`host/${e}`,()=>this.host.bundle.scopeRegistry?.scopes.find(s=>s.token===e)?.declarations).get(r)}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(y.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 r=this.host.blockIndex.get(t);if(!r)throw new Error(`unknown block: ${t}`);this.enterSceneSetup(r.sceneId),this.stack=[{sceneId:r.sceneId,containerId:t,index:0}],this.enter(t)}else{let r=e??Object.keys(this.host.bundle.scenes)[0],s=r?this.host.bundle.scenes[r]:void 0;if(!s)throw new Error(r?`unknown scene: ${r}`:"no scenes in bundle");this.enterSceneSetup(r);let i=s.blocks[0];i&&(this.stack=[{sceneId:r,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 r=te(this.host,e);if(r===void 0)return!1;let s;return t!==void 0&&(s=re(this.host,r,t),s===void 0)?!1:this.started?(this.clearPending(),this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!1,this.enterTarget(s??r,"jump"),this.settle(),!0):(this.begin(r,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:r,flowEnded:s,currentSceneId:i,activeSnippet:o,beatIndex:a,pendingChoice:c,pendingPrompt:l,pendingPromptOwnerId:p}=this,f=this.stack.map(u=>({...u}));e.undo.push(()=>{Object.assign(this,{rngState:t,started:r,flowEnded:s,currentSceneId:i,activeSnippet:o,beatIndex:a,pendingChoice:c,pendingPrompt:l,pendingPromptOwnerId:p,stack:f})})}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 r=this.childrenOf(t.containerId);if(!r){this.stack.pop();continue}let s=t.index;for(;t.index<r.length&&!this.eligible(r[t.index]);)t.index++;if(this.host.tracing&&t.index!==s&&this.emit({type:"select",group:t.containerId,selector:"run",children:r.slice(s,t.index+1).map((i,o)=>({id:i.id,eligible:s+o===t.index})),picked:r[t.index]?.id??null}),t.index>=r.length){this.stack.pop();continue}this.enterChild(r[t.index++])}}listBags(){let e=[{bag:this.local,pathPrefix:`${this.id}/@patter.`}];for(let[t,r]of this.sceneBags)e.push({bag:r,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)}getChoices(){return this.pendingChoice?.options??[]}choose(e){let t=this.pendingChoice;if(!t)throw new Error("no choice is pending");let r=t.options.find(o=>o.id===e);if(!r)throw new Error(`unknown choice option: ${e}`);if(!r.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&&r.prompt?{beat:i,shown:{...r.prompt}}:null,this.pendingPromptOwnerId=this.pendingPrompt?s.id:null,this.enterChild(s)}isEnded(){return this.flowEnded}getProperty(e){let{scope:t,name:r}=this.splitRef(e);return t==="patter"?this.patterResolver.get(r):t==="scene"?this.sceneResolver.get(r):this.host.registry.get(t,r)}setProperty(e,t){this.writeProperty(e,t,!0)}writeProperty(e,t,r){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,r?{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(e=>({...e}))}:null,pendingPromptOwnerId:this.pendingPromptOwnerId,...this.pendingPrompt?.shown?{pendingPrompt:st(this.pendingPrompt.shown)}:{},selectors:Pe(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(r=>r.sceneId)]))t!==null&&this.host.bundle.scenes[t]&&this.ensureSceneBags(t)}restoreCursor(e){this.rngState=O(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(r=>{let{nextId:s,...i}=r;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 r=this.host.nodeIndex.get(t.activeSnippetId);r&&r.type==="snippet"&&(this.activeSnippet=r)}if(this.selectors=Be(t.selectors),this.pendingChoice=null,t.pendingChoice!==null){let r=new Map,s=[];for(let i of t.pendingChoice.options){let o=this.host.nodeIndex.get(i.id);o&&(r.set(i.id,o),s.push({...i}))}s.length>0&&(this.pendingChoice={groupId:t.pendingChoice.groupId,options:s,byId:r})}if(this.pendingPrompt=null,this.pendingPromptOwnerId=t.pendingPromptOwnerId??null,this.pendingPromptOwnerId){let r=this.host.nodeIndex.get(this.pendingPromptOwnerId),s=r?this.authoredPromptOf(r):void 0;s?this.pendingPrompt={beat:s,...t.pendingPrompt?{shown:{...t.pendingPrompt}}:{}}: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 r=this.selectChild(e);r&&this.enterChild(r)}childrenOf(e){let t=this.host.blockById.get(e);if(t)return t.children;let r=this.host.nodeIndex.get(e);if(r&&r.type==="group")return r.children}beginSnippet(e){this.runEffects(e.onEnter,e.id),this.activeSnippet=e,this.beatIndex=0}setupChoice(e){let t=[],r=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}),r.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:r};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 r,s,i=this.host.bundle.scenes[e];if(i){this.enterSceneSetup(e);let a=i.blocks[0];if(!a){t==="jump"&&(this.stack=[]);return}r=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),r=a.sceneId,s=e}this.enter(s);let o={sceneId:r,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)})),r=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(r.length===0)return o(null);let a=this.selectorState(e);switch(e.selector){case"branch":return o(r[0]);case"sequence":return o(s==="shuffle"?this.pickShuffle(r,i,a):s==="specificity"?this.pickSpecificity(r,i,a):this.pickSequential(r,i,a));default:return null}}pickSequential(e,t,r){let s=e.length,i=r.seq??0;return r.seq=i+1,t==="repeat"?e[i%s]:i<s?e[i]:t==="stick"?e[s-1]:null}pickShuffle(e,t,r){let s=e.length,i=t==="stick",o=()=>(i?e.slice(0,s-1):e).map(u=>u.id),a=new Set(e.map(u=>u.id));if(r.bag===void 0&&(r.bag=o()),!r.bag.some(u=>a.has(u))){if(t==="once")return null;if(i){let u=e[s-1];return r.last=u.id,u}if(r.bag=o(),r.bag.length===0)return null}let c=r.bag.filter(u=>a.has(u)),l=r.last!==void 0&&c.length>1?c.indexOf(r.last):-1,p=Math.floor(this.rng()*(l>=0?c.length-1:c.length));l>=0&&p>=l&&p++;let f=c[p];return r.bag.splice(r.bag.indexOf(f),1),r.last=f,e.find(u=>u.id===f)}pickSpecificity(e,t,r){let s=e;if(t!=="repeat"){r.bag===void 0&&(r.bag=e.map(p=>p.id));let l=new Set(r.bag);if(s=e.filter(p=>l.has(p.id)),s.length===0)return t==="stick"&&r.last!==void 0?e.find(p=>p.id===r.last)??null:null}let i=-1,a=s.map(l=>{let p=this.specScore(l);return p>i&&(i=p),{c:l,s:p}}).filter(l=>l.s===i).map(l=>l.c),c;if(a.length===1)c=a[0];else{let l=r.last!==void 0?a.findIndex(f=>f.id===r.last):-1,p=Math.floor(this.rng()*(l>=0?a.length-1:a.length));l>=0&&p>=l&&p++,c=a[p]}return t!=="repeat"&&(r.bag=r.bag.filter(l=>l!==c.id)),r.last=c.id,c}specScore(e){return e.condition?this.matchedSpec(this.conditionAst(e.condition),!0,e):0}matchedSpec(e,t,r){return de(e,i=>{try{return Oe(V(i,this.context(),Y))}catch(o){return this.reportError("best-match",r.id,r.condition,o),!1}},{want:t})}selectorState(e){let t=e.shared?this.host.sharedSelectors:this.selectors,r=this.host.journal,s;if(r&&(s=e.shared?r.selectors:r.flowSelectors.get(this),s||(s=new Set,r.flowSelectors.set(this,s))),r&&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;r.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 r of e??[]){let s;try{s=this.evalExpr(r.value);let i=this.host.tracing?this.getProperty(r.target):void 0;this.writeProperty(r.target,s,!1),this.host.tracing&&this.emit({type:"write",target:r.target,value:s,...i!==void 0?{prev:i}:{}})}catch(i){this.reportError("effect",t,r.value,i)}}}eligible(e){if(!e.condition)return!0;try{return Oe(this.evalExpr(e.condition))}catch(t){return this.reportError("condition",e.id,e.condition,t),!1}}reportError(e,t,r,s){let i=s instanceof Error?s.message:String(s),o=r?.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 V(this.conditionAst(e),this.context(),Y)}conditionAst(e){let t=be.get(e);return t||(t=k(e.ast),be.set(e,t)),t}enter(e){let t=this.visitCounts,r=t.get(e);t.set(e,(r??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(()=>{r===void 0?t.delete(e):t.set(e,r),i===void 0?s.delete(e):s.set(e,i)})}rng=()=>{if(this.host.customRng)return this.host.customRng();let e=K(this.rngState),t=e.next();return this.rngState=e.state(),t};beatResult(e){let t=C(this.host,e.id),r=t&&t.length?{tags:t}:{};switch(e.kind){case"gameEvent":return{type:"gameEvent",id:e.id,gameData:e.gameData,...r};case"text":return{type:"text",id:e.id,text:this.interpolate(this.resolveString(e.id)),gameData:e.gameData,...r};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,gameData:e.gameData,...r}}}}interpolate(e){return ve(e,t=>this.getProperty(t))}stripCaptions(e){return ye(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 r=this.interpolate(this.resolveString(t.id));return t.kind==="line"?{kind:"line",text:this.captionLine(r),character:t.character,characterName:this.resolveCharacterName(t.character),direction:t.direction}:{kind:"text",text:r}}authoredPromptOf(e){return e.type==="group"?e.prompt:void 0}promptResult(e,t){let r=C(this.host,e.id),s=r&&r.length?{tags:r}:{};return t.kind==="text"?{type:"text",id:e.id,text:t.text,gameData:e.gameData,...s}:{type:"line",id:e.id,text:t.text,character:t.character,characterName:t.characterName,direction:t.direction,gameData:e.gameData,...s}}promptBeatOf(e){return e.type==="group"&&e.prompt?e.prompt:((e.type==="snippet"?e:this.firstTextSnippetIn(e.children))?.beats??[]).find(r=>r.kind==="line"||r.kind==="text")}firstTextSnippetIn(e){let t;return I(e,r=>{!t&&r.type==="snippet"&&(r.beats??[]).some(s=>s.kind==="line"||s.kind==="text")&&(t=r)}),t}resolveString(e){if(this.host.emitIds)return e;let t=this.host.strings[e];if(t!==void 0)return t;let r=this.host.defaultStrings[e];return r!==void 0?`<Untranslated: ${e}> ${r}`:e}resolveCharacterName(e){if(e===void 0||this.host.emitIds)return;let t=Q(e);return this.host.strings[t]??this.host.defaultStrings[t]??this.host.castDisplay.get(e)}splitRef(e){return Fe(this.host,e)}newLocal(){return new b(this.host.patterLocalDecls,{pathPrefix:"@patter."})}mountLocal(){this.local=this.newLocal();let e=y.flowGlobals(this.id);this.host.registry.mountOwned(e,this.local,{owner:A}),this.registered.add(e)}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,r=this.host.bundle.scenes[e]?.sceneProps??[],s=this.host.journal;if(!this.sceneBags.has(e)){let i=new b(r.filter(c=>!t.has(c.name.toLowerCase())),{pathPrefix:"@scene."}),o=y.flowScene(this.id,e),a=Ie(this.host.registry,o,i,s!==null);this.registered.add(o),this.sceneBags.set(e,i),s&&s.undo.push(()=>{this.sceneBags.get(e)===i&&(this.host.registry.remove(o,a?{keep:!0}:void 0),this.registered.delete(o),this.sceneBags.delete(e))})}if(!this.host.stageBags.has(e)){let i=new b(r.filter(a=>t.has(a.name.toLowerCase())),{pathPrefix:"@scene."}),o=Ie(this.host.registry,y.stage(e),i,s!==null);this.host.stageBags.set(e,i),s&&s.undo.push(()=>{this.host.stageBags.get(e)===i&&(this.host.registry.remove(y.stage(e),o?{keep:!0}:void 0),this.host.stageBags.delete(e))})}}seedScene(e){let t=this.host.sceneSharedNames.get(e.id)??new Set;this.ensureSceneBags(e.id);for(let r of e.sceneProps??[]){if(!r.temporary)continue;let s=r.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,P(r))}}};function Ee(n,e){I(n,t=>{if(t.type==="group"){t.prompt?.kind==="line"&&t.prompt.character&&e.add(t.prompt.character);return}for(let r of t.beats??[])r.kind==="line"&&r.character&&e.add(r.character)})}function Ce(n){return n&&Object.keys(n).length?{gameData:n}:{}}function st(n){let e={kind:n.kind,text:n.text};return n.character!==void 0&&(e.character=n.character),n.characterName!==void 0&&(e.characterName=n.characterName),n.direction!==void 0&&(e.direction=n.direction),e}function Pe(n){let e={};for(let[t,r]of n){let s={};r.seq!==void 0&&(s.seq=r.seq),r.bag&&(s.bag=[...r.bag]),r.last!==void 0&&(s.last=r.last),e[t]=s}return e}function Be(n){let e=new Map;for(let[t,r]of Object.entries(n??{})){let s={};r.seq!==void 0&&(s.seq=r.seq),r.bag&&(s.bag=[...r.bag]),r.last!==void 0&&(s.last=r.last),e.set(t,s)}return e}function Ie(n,e,t,r){let s=r?JSON.stringify(t.save()):"";return n.mountOwned(e,t,{owner:A}),r&&JSON.stringify(t.save())!==s}function De(n){return{name:n.name,type:n.type,values:n.values,stages:n.stages,default:n.default}}function Re(n){return{...n.world?{world:n.world}:{},...n.hostScopes}}function ee(n,e,t){let r=n.qualityLadders.get(e);if(!r){r=new Map;for(let s of t()??[]){let i=s.name.toLowerCase();s.type==="quality"&&s.stages&&!r.has(i)&&r.set(i,s.stages)}n.qualityLadders.set(e,r)}return r}function Ne(n){return{name:n.name,type:n.type,values:n.values,stages:n.stages,default:n.default,writable:n.writable}}function it(n,e){let t=Ne(n),r=n.writable??e;return r===void 0?t:{...t,writable:r}}function te(n,e){return n.sceneGameIdToId.get(e)??(n.bundle.scenes[e]?e:void 0)}function re(n,e,t){return n.blockGameIdToId.get(e)?.get(t)??(n.blockIndex.get(t)?.sceneId===e?t:void 0)}function Fe(n,e){n.refSplitRevision!==n.registry.revision&&(n.refSplitCache.clear(),n.refSplitRevision=n.registry.revision);let t=n.refSplitCache.get(e);return t||(t=Se(e,r=>r==="scene"||n.registry.has(r)||(n.bundle.externalScopes?.includes(r)??!1)),n.refSplitCache.set(e,t)),t}function ot(n){let e={};n.shared?.patter&&(e.patter=n.shared.patter);for(let[t,r]of Object.entries(n.stageBags??{}))e[y.stage(t)]=r;for(let[t,r]of Object.entries(n.flows??{})){r.scopes?.patter&&(e[y.flowGlobals(t)]=r.scopes.patter);for(let[s,i]of Object.entries(r.sceneBags??{}))e[y.flowScene(t,s)]=i}return e}function Oe(n){return typeof n=="boolean"?n:typeof n=="number"?n!==0:typeof n=="string"?n!=="":n.length>0}var at=(n,e)=>n.shared??e;function ne(n,e){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.default!==void 0?{default:n.default}:{},shared:at(n,e)}}function ct(n){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.values?{values:[...n.values]}:{},...n.purpose?{purpose:n.purpose}:{}}}function lt(n,e){e.blocks++;let t=[...n.children];for(;t.length;){let r=t.pop();if(r.type==="group"){e.groups++,r.prompt&&e.prompts++,t.push(...r.children);continue}e.snippets++;for(let s of r.beats??[])e.beats++,s.kind==="gameEvent"&&e.gameEvents++}}function Ae(n){let e={scenes:0,blocks:0,groups:0,snippets:0,beats:0,prompts:0,gameEvents:0,cast:n.cast?.length??0},t=[],r=[];for(let o of Object.values(n.scenes)){e.scenes++;let a=S(o);t.push({gameId:a,name:o.name,blocks:o.blocks.map(c=>({gameId:S(c),name:c.name}))});for(let c of o.blocks)lt(c,e);o.sceneProps?.length&&r.push({gameId:a,properties:o.sceneProps.map(c=>ne(c,!1))})}let s=(n.scopeRegistry?.scopes??[]).map(o=>({token:o.token,writable:o.writable??!0,opaque:o.declarations===void 0,properties:(o.declarations??[]).map(a=>ne(a,!0))})),i=Object.entries(n.gameDataFields??{}).filter(([,o])=>(o?.length??0)>0).map(([o,a])=>({kind:o,fields:(a??[]).map(ct)}));return{identity:{schema:n.schema,project:n.content.project,...n.content.version!==void 0?{version:n.content.version}:{},...n.content.hash!==void 0?{hash:n.content.hash}:{},...n.content.structureHash!==void 0?{structureHash:n.content.structureHash}:{},voiced:n.voiced,defaultLocale:n.locales.default,locales:[...n.locales.included],localisation:n.localisation?.mode??"embedded",sourceDebug:n.localisation?.sourceDebug??!1},addresses:t,hostScopes:s,properties:{patter:(n.properties??[]).map(o=>ne(o,!0)),scene:r},gameData:i,counts:e}}function Te(n,e){return n.gameDataFields?.[e]??[]}function se(n,e,t){return e&&Object.prototype.hasOwnProperty.call(e,t)?e[t]:n.find(r=>r.name===t)?.default}function Ge(n,e){let t={};for(let r of n){let s=se(n,e,r.name);s!==void 0&&(t[r.name]=s)}for(let[r,s]of Object.entries(e??{}))r in t||(t[r]=s);return t}return Ue(pt);})();\n';
 
 // src/export-html.ts
 var esc = (s) => s.replace(/[&<>]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;" })[c]);
@@ -1366,11 +1715,11 @@ var STYLE = String.raw`
   #flash { margin-left: auto; color: #9a8f78; font: 0.8rem ui-sans-serif, system-ui, sans-serif; opacity: 0; transition: opacity .2s; }
 `;
 function sourceStory(loaded) {
-  const full = runExportFull(loaded);
+  const full = runExportFull(loaded, { refuseInvalid: true });
   const def = full.locales?.default ?? Object.keys(full.strings)[0] ?? "en";
   const bundle = { ...full, locales: { default: def, included: [def] }, strings: { [def]: full.strings[def] ?? {} } };
   const title = loaded.project.project.name?.trim() || "A Patter story";
-  const bundleJson = canonicalStringify3(bundle, { trailingComma: false }).replace(/</g, "\\u003c");
+  const bundleJson = canonicalStringify4(bundle, { trailingComma: false }).replace(/</g, "\\u003c");
   return { title, lang: def, bundleJson };
 }
 function page(title, lang, head, tail) {
@@ -1441,39 +1790,11 @@ ${PLAYER_JS}`,
   };
 }
 
-// src/audio-scan.ts
-import { readdirSync as readdirSync3 } from "fs";
-import { resolve as resolve3, extname, basename as basename4 } from "path";
-import { deriveRecordingFolders, DEFAULT_RECORDING_STATUSES } from "@patterkit/model";
-var AUDIO_EXT = /* @__PURE__ */ new Set([".wav", ".mp3"]);
-function scanAudioStatus(loaded) {
-  const p = loaded.project;
-  const tracked = !!p.voiced && (p.trackAudioStatus ?? false);
-  if (!tracked || !p.audioFolders || !p.audioRoot?.trim()) return void 0;
-  const rungs = deriveRecordingFolders(p.audioRoot, p.recordingStatuses ?? DEFAULT_RECORDING_STATUSES);
-  const out = /* @__PURE__ */ new Map();
-  for (const rung of rungs) {
-    if (!rung.folder) continue;
-    let files;
-    try {
-      files = readdirSync3(resolve3(loaded.root, rung.folder));
-    } catch {
-      continue;
-    }
-    for (const f of files) {
-      const ext = extname(f).toLowerCase();
-      if (AUDIO_EXT.has(ext)) out.set(basename4(f, extname(f)), rung.name);
-    }
-  }
-  return out;
-}
-
 // src/play.ts
-import { exportBundle as exportBundle4 } from "@patterkit/compiler";
 import { Engine } from "@patterkit/runtime";
 
 // src/loaded-helpers.ts
-import { RERECORD_STATUS } from "@patterkit/model";
+import { RERECORD_STATUS, effectiveGameId } from "@patterkit/model";
 function effectiveRecording(id, base, rerecord, lowest) {
   return rerecord.has(id) ? RERECORD_STATUS : base.get(id) ?? lowest;
 }
@@ -1487,9 +1808,25 @@ function sourceStrings(loaded) {
 }
 function resolveStart(loaded, override) {
   if (override?.scene) return { scene: override.scene, block: override.block };
+  if (override?.block) return findBlockAnywhere(loaded, override.block);
   if (loaded.project.start) return { scene: loaded.project.start.scene, block: loaded.project.start.block };
   return {};
 }
+function findBlockAnywhere(loaded, ref) {
+  const matches = [];
+  for (const scene of loaded.scenes) {
+    for (const block of scene.blocks) {
+      if (block.id === ref) return { scene: scene.id, block: block.id };
+      if (block.name === ref || effectiveGameId(block) === ref) matches.push({ scene, block });
+    }
+  }
+  if (matches.length === 0) throw new Error(`no scene has a block "${ref}"`);
+  if (matches.length > 1) {
+    const scenes = [...new Set(matches.map((m) => `"${m.scene.name}" (${m.scene.id})`))].join(", ");
+    throw new Error(`more than one block is called "${ref}" (in ${scenes}): name the scene as well`);
+  }
+  return { scene: matches[0].scene.id, block: matches[0].block.id };
+}
 function stringsByLocale(loaded) {
   const byLocale = /* @__PURE__ */ new Map();
   for (const l of loaded.locales) {
@@ -1523,7 +1860,7 @@ function mergeAuthoring2(loaded) {
 
 // src/play.ts
 function runPlay(loaded, opts = {}) {
-  const bundle = exportBundle4({ project: loaded.project, scenes: loaded.scenes, locales: loaded.locales, gameScopes: loaded.gameScopes?.merged });
+  const bundle = compileLoaded(loaded);
   const events = [];
   const registry = previewRegistry(loaded.gameScopes, bundle);
   const engine = new Engine(bundle, { seed: opts.seed, onError: (error) => events.push({ type: "error", error }), ...registry ? { registry } : {} });
@@ -1531,17 +1868,33 @@ function runPlay(loaded, opts = {}) {
   const flow = engine.openFlow("main", { scene: start.scene, block: start.block });
   const scripted = [...opts.choices ?? []];
   const maxSteps = opts.maxSteps ?? 1e3;
-  for (let i = 0; i < maxSteps; i++) {
-    const r = flow.advance();
-    if (r.type === "end") return { events, outcome: "end" };
-    if (r.type === "choice") {
-      const picked = scripted.shift() ?? r.options.find((o) => o.eligible)?.id;
-      events.push({ type: "choice", options: r.options, picked });
-      if (picked === void 0) return { events, outcome: "stalled" };
-      flow.choose(picked);
-    } else {
-      events.push(r);
+  const failed = (message) => {
+    events.push({ type: "error", fatal: true, message });
+    return { events, outcome: "error" };
+  };
+  try {
+    for (let i = 0; i < maxSteps; i++) {
+      const r = flow.advance();
+      if (r.type === "end") return { events, outcome: "end" };
+      if (r.type === "choice") {
+        const wanted = scripted.shift();
+        if (wanted !== void 0) {
+          const offered = r.options.find((o) => o.id === wanted);
+          if (!offered || !offered.eligible) {
+            events.push({ type: "choice", options: r.options });
+            const onOffer = r.options.filter((o) => o.eligible).map((o) => o.id).join(", ");
+            return failed(`scripted choice '${wanted}' is ${offered ? "offered but its condition does not hold" : "not offered"} here; on offer: ${onOffer}`);
+          }
+        }
+        const picked = wanted ?? r.options.find((o) => o.eligible).id;
+        events.push({ type: "choice", options: r.options, picked });
+        flow.choose(picked);
+      } else {
+        events.push(r);
+      }
     }
+  } catch (err) {
+    return failed(err instanceof Error ? err.message : String(err));
   }
   return { events, outcome: "max-steps" };
 }
@@ -1559,6 +1912,10 @@ function renderPlay(result) {
         out.push(`    (game event ${JSON.stringify(e.gameData ?? {})})`);
         break;
       case "error": {
+        if ("fatal" in e) {
+          out.push(`    ! stopped: ${e.message}`);
+          break;
+        }
         const { kind, node, source, message } = e.error;
         out.push(`    ! ${kind} on '${node}'${source ? ` (${source})` : ""} failed, played through: ${message}`);
         break;
@@ -1573,20 +1930,19 @@ function renderPlay(result) {
     case "end":
       out.push("--- END ---");
       break;
-    case "stalled":
-      out.push("    (no eligible choice - stopping)");
-      break;
     case "max-steps":
       out.push("--- stopped: max steps reached ---");
       break;
+    case "error":
+      out.push("--- stopped: the run could not go on ---");
+      break;
   }
   return out;
 }
 
 // src/coverage.ts
-import { exportBundle as exportBundle5 } from "@patterkit/compiler";
 import { Engine as Engine2 } from "@patterkit/runtime";
-import { walkNodes } from "@patterkit/model";
+import { isContentlessBeat as isContentlessBeat2, walkNodes } from "@patterkit/model";
 var CADENCE_PROB = {
   rarely: 0.15,
   sometimes: 0.4,
@@ -1667,8 +2023,23 @@ function analyzeHostScopes(bundle, hostTokens) {
   const fineGatesByBeat = /* @__PURE__ */ new Map();
   const proposals = /* @__PURE__ */ new Map();
   const writerSites = /* @__PURE__ */ new Map();
+  const siteBeats = /* @__PURE__ */ new Map();
   const opaqueWrites = /* @__PURE__ */ new Set();
-  const empty = { written, gatesByBeat, proposals, fineGatesByBeat, writerSites, opaqueWrites };
+  const shadowed = /* @__PURE__ */ new Set();
+  const blockOfBeat = /* @__PURE__ */ new Map();
+  const routes = [];
+  const empty = {
+    written,
+    gatesByBeat,
+    proposals,
+    fineGatesByBeat,
+    writerSites,
+    siteBeats,
+    opaqueWrites,
+    shadowed,
+    blockOfBeat,
+    routes
+  };
   if (hostTokens.size === 0) return empty;
   const refsIn = (expr) => {
     const refs = /* @__PURE__ */ new Set();
@@ -1680,56 +2051,83 @@ function analyzeHostScopes(bundle, hostTokens) {
     if (expr) fineRefsIn(deserialiseAst(expr.ast), hostTokens, refs);
     return refs;
   };
-  const addSite = (key, witnesses) => {
-    (writerSites.get(key) ?? writerSites.set(key, []).get(key)).push(witnesses);
+  const addSite = (key, site) => {
+    const sites = writerSites.get(key) ?? writerSites.set(key, []).get(key);
+    if (!sites.includes(site)) sites.push(site);
   };
-  const scanEffects = (effects, witnesses) => {
+  const scanEffects = (effects, site) => {
     for (const e of effects ?? []) {
       const target = targetHostRef(e.target, hostTokens);
       if (target) {
         written.add(target);
-        addSite(target, witnesses);
+        addSite(target, site);
         const flags = e.value ? flagKeys(deserialiseAst(e.value.ast), hostTokens, "set_flags") : [];
-        if (flags.length) for (const k of flags) addSite(k, witnesses);
+        if (flags.length) for (const k of flags) addSite(k, site);
         else opaqueWrites.add(target);
       }
       refsIn(e.value);
     }
   };
-  const walk = (nodes, gate, fine) => {
+  const walk = (nodes, blockId, gate, fine, branch, dead) => {
+    let won = false;
     for (const node of nodes) {
+      const shadow = dead || won;
+      if (branch && !node.condition) won = true;
       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, here, hereFine);
+        walk(node.children, blockId, here, hereFine, node.selector === "branch", shadow);
       } else {
-        const witnesses = (node.beats ?? []).map((b) => b.id);
-        scanEffects(node.onEnter, witnesses);
-        scanEffects(node.onExit, witnesses);
-        for (const beat of node.beats ?? []) {
-          gatesByBeat.set(beat.id, here);
-          fineGatesByBeat.set(beat.id, hereFine);
+        const beats = (node.beats ?? []).map((b) => b.id);
+        if (beats.length) siteBeats.set(node.id, beats);
+        scanEffects(node.onEnter, node.id);
+        scanEffects(node.onExit, node.id);
+        for (const id of beats) {
+          gatesByBeat.set(id, here);
+          fineGatesByBeat.set(id, hereFine);
+          blockOfBeat.set(id, blockId);
+          if (shadow) shadowed.add(id);
         }
+        if (node.jump && node.jump.to !== "END" && !shadow) routes.push({ from: blockId, to: node.jump.to, gate: here, fine: hereFine });
       }
     }
   };
   for (const scene of Object.values(bundle.scenes)) {
-    const sceneBeats = [];
-    const collect = (nodes) => {
-      for (const n of nodes) {
-        if (n.type === "group") collect(n.children);
-        else for (const b of n.beats ?? []) sceneBeats.push(b.id);
-      }
-    };
-    for (const block of scene.blocks) collect(block.children);
-    scanEffects(scene.onEntry, sceneBeats);
-    for (const block of scene.blocks) walk(block.children, /* @__PURE__ */ new Set(), /* @__PURE__ */ new Set());
+    scanEffects(scene.onEntry, scene.id);
+    for (const block of scene.blocks) walk(block.children, block.id, /* @__PURE__ */ new Set(), /* @__PURE__ */ new Set(), false, false);
   }
   return empty;
 }
-function blockedGates(beatId, analysis, drivenRefs, reachedRuns) {
+function entryGates(bundle, routes, start) {
+  const firstBlock = (sceneId) => sceneId === void 0 ? void 0 : bundle.scenes[sceneId]?.blocks[0]?.id;
+  const blockOf = (to) => bundle.scenes[to] ? firstBlock(to) : to;
+  const startBlock = start.block ?? firstBlock(start.scene ?? Object.keys(bundle.scenes)[0]);
+  if (startBlock === void 0) return /* @__PURE__ */ new Map();
+  const none = () => ({ gate: /* @__PURE__ */ new Set(), fine: /* @__PURE__ */ new Set() });
+  const meet = (a, b) => new Set([...a].filter((g) => b.has(g)));
+  let entry = /* @__PURE__ */ new Map([[startBlock, none()]]);
+  for (; ; ) {
+    const next = /* @__PURE__ */ new Map([[startBlock, none()]]);
+    for (const r of routes) {
+      const from = entry.get(r.from);
+      const to = blockOf(r.to);
+      if (from === void 0 || to === void 0) continue;
+      const via = { gate: /* @__PURE__ */ new Set([...from.gate, ...r.gate]), fine: /* @__PURE__ */ new Set([...from.fine, ...r.fine]) };
+      const had = next.get(to);
+      next.set(to, had === void 0 ? via : { gate: meet(had.gate, via.gate), fine: meet(had.fine, via.fine) });
+    }
+    const same = next.size === entry.size && [...next].every(([k, v]) => {
+      const was = entry.get(k);
+      return was !== void 0 && was.gate.size === v.gate.size && was.fine.size === v.fine.size;
+    });
+    entry = next;
+    if (same) return entry;
+  }
+}
+function blockedGates(beatId, analysis, drivenRefs, siteRuns, entry) {
   const out = [];
-  const gates = /* @__PURE__ */ new Set([...analysis.gatesByBeat.get(beatId) ?? [], ...analysis.fineGatesByBeat.get(beatId) ?? []]);
+  const own = /* @__PURE__ */ new Set([...analysis.gatesByBeat.get(beatId) ?? [], ...analysis.fineGatesByBeat.get(beatId) ?? []]);
+  const gates = /* @__PURE__ */ new Set([...own, ...entry?.gate ?? [], ...entry?.fine ?? []]);
   for (const ref of [...gates].sort()) {
     const coarse = ref.includes(":") ? ref.slice(0, ref.indexOf(":")) : ref;
     if (drivenRefs.has(coarse)) continue;
@@ -1738,15 +2136,14 @@ function blockedGates(beatId, analysis, drivenRefs, reachedRuns) {
     if (ref === coarse && [...gates].some((g) => g !== ref && g.startsWith(`${ref}:`))) continue;
     const sites = analysis.writerSites.get(ref) ?? [];
     if (!sites.length) continue;
-    if (sites.some((s) => !s.length || s.some((w) => !reachedRuns.has(w)))) continue;
-    if (!sites.every((s) => s.every((w) => reachedRuns.get(w) === 0))) continue;
-    const writers = [...new Set(sites.flat())].sort();
-    out.push({ ref, writers });
+    if (sites.some((s) => (siteRuns.get(s) ?? 0) > 0)) continue;
+    const writers = [...new Set(sites.flatMap((s) => analysis.siteBeats.get(s) ?? [s]))].sort();
+    out.push({ ref, writers, ...own.has(ref) ? {} : { onTheWayIn: true } });
   }
   return out;
 }
 function proposeCoverageDrivers(loaded) {
-  const bundle = exportBundle5({ project: loaded.project, scenes: loaded.scenes, locales: loaded.locales, gameScopes: loaded.gameScopes?.merged });
+  const bundle = compileLoaded(loaded);
   const hostScopes = bundle.scopeRegistry?.scopes ?? [];
   const hostTokens = new Set(hostScopes.map((s) => s.token));
   if (hostTokens.size === 0) return [];
@@ -1798,6 +2195,7 @@ function* sweep(loaded, options = {}, hooks = {}) {
         }
         for (const beat of node.beats ?? []) {
           if (meta.has(beat.id)) continue;
+          if (isContentlessBeat2(beat, !!src[beat.id])) continue;
           order.push(beat.id);
           meta.set(beat.id, {
             scene: scene.id,
@@ -1814,7 +2212,8 @@ function* sweep(loaded, options = {}, hooks = {}) {
   const dryRuns = /* @__PURE__ */ new Map();
   const errorRuns = /* @__PURE__ */ new Map();
   const termination = { ended: 0, capped: 0, stalled: 0, evalError: 0 };
-  const bundle = exportBundle5({ project: loaded.project, scenes: loaded.scenes, locales: loaded.locales, gameScopes: loaded.gameScopes?.merged });
+  const siteRuns = /* @__PURE__ */ new Map();
+  const bundle = compileLoaded(loaded);
   const rng = mulberry32(seed);
   const hostTokens = hostScopeTokens(loaded, bundle);
   const analysis = analyzeHostScopes(bundle, hostTokens);
@@ -1825,6 +2224,8 @@ 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 sites = [...new Set([...analysis.writerSites.values()].flat())];
+  const entered = entryGates(bundle, analysis.routes, start);
   let executed = 0;
   let cancelled = false;
   for (let run = 0; run < runs; run++) {
@@ -1872,8 +2273,15 @@ function* sweep(loaded, options = {}, hooks = {}) {
           seenThisRun.add(r.id);
         }
       }
-    } catch {
+    } catch (err) {
       term = "evalError";
+      const node = flow.currentScene ?? start.scene ?? "";
+      const message = err instanceof Error ? err.message : String(err);
+      errorsThisRun.set(`stopped|${node}|${message}`, { kind: "stopped", node, message });
+    }
+    if (sites.length) {
+      const visits = engine.getVisitCounts();
+      for (const id of sites) if ((visits[id] ?? 0) > 0) siteRuns.set(id, (siteRuns.get(id) ?? 0) + 1);
     }
     for (const id of seenThisRun) reachedRuns.set(id, reachedRuns.get(id) + 1);
     for (const id of dryThisRun) dryRuns.set(id, (dryRuns.get(id) ?? 0) + 1);
@@ -1894,13 +2302,16 @@ function* sweep(loaded, options = {}, hooks = {}) {
     const reached = reachedRuns.get(id);
     let needsInput;
     let blockedBy;
-    if (reached === 0) {
-      const gates = [...analysis.gatesByBeat.get(id) ?? []].filter((r) => !analysis.written.has(r) && !drivenRefs.has(r));
+    if (reached === 0 && !analysis.shadowed.has(id)) {
+      const block = analysis.blockOfBeat.get(id);
+      const way = block !== void 0 ? entered.get(block) : void 0;
+      const all = /* @__PURE__ */ new Set([...analysis.gatesByBeat.get(id) ?? [], ...way?.gate ?? []]);
+      const gates = [...all].filter((r) => !analysis.written.has(r) && !drivenRefs.has(r));
       if (gates.length) {
         needsInput = gates;
         for (const g of gates) unwrittenInputs.add(g);
       }
-      const blocked = blockedGates(id, analysis, drivenRefs, reachedRuns);
+      const blocked = blockedGates(id, analysis, drivenRefs, siteRuns, way);
       if (blocked.length) blockedBy = blocked;
     }
     const reachPct = executed ? reached / executed * 100 : 0;
@@ -1966,7 +2377,7 @@ function renderCoverageText(report, sceneName = (id) => id, opts = {}) {
   );
   out.push(`${report.runs} run(s) - ${report.maxSteps} max steps - seed ${report.seed}${report.cancelled ? " - CANCELLED" : ""}`);
   const term = report.termination;
-  out.push(`runs ended: ${term.ended} reached the end, ${term.stalled} stalled at a choice with nothing to pick, ${term.capped} hit the step limit, ${term.evalError} errored`);
+  out.push(`runs ended: ${term.ended} reached the end, ${term.stalled ? `${term.stalled} stalled at a choice with nothing to pick, ` : ""}${term.capped} hit the step limit, ${term.evalError} errored`);
   if (report.drivers.length) out.push(`input drivers: ${report.drivers.map((d) => d.ref).join(", ")}`);
   if (report.unwrittenInputs.length) {
     out.push(`? = gated on an input nothing writes/drives: ${report.unwrittenInputs.join(", ")} (add a coverage driver?)`);
@@ -1980,9 +2391,10 @@ function renderCoverageText(report, sceneName = (id) => id, opts = {}) {
   }
   if (report.contentErrors.length) {
     out.push("");
-    out.push(`content errors (a condition or effect failed and play went on without it - fix the expression): ${report.contentErrors.length}`);
+    out.push(`content errors (a condition or effect failed and play went on without it, or a run stopped - fix the content): ${report.contentErrors.length}`);
     for (const e of report.contentErrors) {
-      out.push(`  \u203C ${String(e.runs).padStart(6)} run(s)  ${sceneName(e.scene)}  ${e.kind} on '${e.node}'${e.source ? ` (${e.source})` : ""}: ${e.message}`);
+      const what = e.kind === "stopped" ? "run stopped" : `${e.kind} on '${e.node}'${e.source ? ` (${e.source})` : ""}`;
+      out.push(`  \u203C ${String(e.runs).padStart(6)} run(s)  ${sceneName(e.scene)}  ${what}: ${e.message}`);
     }
   }
   if (!report.beats.length) return out;
@@ -1997,9 +2409,9 @@ function renderCoverageText(report, sceneName = (id) => id, opts = {}) {
     for (const bg of b.blockedBy ?? []) {
       const names = bg.writers.map((w) => {
         const target = report.beats.find((x) => x.id === w);
-        return target ? clip(target.preview || target.id, 28) : w;
+        return target ? clip(target.preview || target.id, 28) : sceneName(w);
       });
-      out.push(`           gated on ${bg.ref}, written only by: ${names.join(", ")} (never played either)`);
+      out.push(`           gated on ${bg.ref}${bg.onTheWayIn ? " on the way in" : ""}, written only by: ${names.join(", ")} (never played either)`);
     }
   };
   out.push("");
@@ -2027,14 +2439,27 @@ function renderCoverageText(report, sceneName = (id) => id, opts = {}) {
 }
 
 // src/format.ts
-import { readFileSync as readFileSync4 } from "fs";
-import { canonicalStringify as canonicalStringify4, parseSource as parseSource3 } from "@patterkit/core";
-function runFormat(files) {
-  return files.map((file) => {
-    const original = readFileSync4(file, "utf8");
+import { readFileSync as readFileSync6, statSync as statSync3 } from "fs";
+import { dirname as dirname5 } from "path";
+import { canonicalStringify as canonicalStringify5, parseSource as parseSource4 } from "@patterkit/core";
+var isShard = (file) => SHARD_EXTENSIONS.some((ext) => file.endsWith(ext));
+function expand(path) {
+  let dir = false;
+  try {
+    dir = statSync3(path).isDirectory();
+  } catch {
+  }
+  if (!dir) return [path];
+  const root = dirname5(findProjectFile(path));
+  return SHARD_EXTENSIONS.flatMap((ext) => walkFiles(root, ext)).sort();
+}
+function runFormat(paths) {
+  return paths.flatMap(expand).map((file) => {
+    if (!isShard(file)) return { file, changed: false, skipped: true };
+    const original = readFileSync6(file, "utf8");
     let canonical;
     try {
-      canonical = canonicalStringify4(parseSource3(original));
+      canonical = canonicalStringify5(parseSource4(original));
     } catch (e) {
       throw new Error(`${file}: ${e instanceof Error ? e.message : String(e)}`);
     }
@@ -2044,7 +2469,7 @@ function runFormat(files) {
 }
 
 // src/report.ts
-import { walkNodes as walkNodes2, DEFAULT_WRITING_STATUSES, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES2, RERECORD_STATUS as RERECORD_STATUS2 } from "@patterkit/model";
+import { DEFAULT_WRITING_STATUSES, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES2, RERECORD_STATUS as RERECORD_STATUS2 } from "@patterkit/model";
 var DEFAULT_WORDS_PER_LINE = 6;
 var UNATTRIBUTED = "(unattributed)";
 function allocateLargestRemainder(total, weights) {
@@ -2097,35 +2522,51 @@ function runReport(loaded, recordingOverride) {
   const localeIds = [];
   const estimatedScenes = [];
   let actualWrittenLines = 0, actualWords = 0;
-  const rungIdxOf = (id) => writingIndex.get(writingOf.get(id) ?? stub) ?? 0;
+  const wsOf = (id) => {
+    const w = writingOf.get(id);
+    return w !== void 0 && writingIndex.has(w) ? w : stub;
+  };
+  const rungIdxOf = (id) => writingIndex.get(wsOf(id)) ?? 0;
   for (const scene of loaded.scenes) {
     const sceneCut = cutSet.has(scene.id);
     const units = [];
+    const underCut = /* @__PURE__ */ new Set();
     let choices = 0;
     for (const block of scene.blocks) {
-      walkNodes2(block.children, (node) => {
-        if (node.type === "group") {
-          if (node.selector === "choice") choices++;
-          if (node.prompt) units.push({
-            id: node.prompt.id,
-            voiced: node.prompt.kind === "line",
-            words: wordsOf(node.prompt.id),
-            character: node.prompt.kind === "line" ? node.prompt.character : void 0
-          });
-          return;
-        }
-        for (const beat of node.beats ?? []) {
-          if (beat.kind === "gameEvent") continue;
-          units.push({
-            id: beat.id,
-            voiced: beat.kind === "line",
-            words: wordsOf(beat.id),
-            character: beat.kind === "line" ? beat.character : void 0
-          });
+      const blockCut = cutSet.has(block.id);
+      const visit = (nodes, inCut) => {
+        for (const node of nodes) {
+          const nodeCut = inCut || cutSet.has(node.id);
+          const add = (u) => {
+            units.push(u);
+            if (nodeCut) underCut.add(u.id);
+          };
+          if (node.type === "group") {
+            if (node.selector === "choice") choices++;
+            if (node.prompt) add({
+              id: node.prompt.id,
+              voiced: node.prompt.kind === "line",
+              words: wordsOf(node.prompt.id),
+              character: node.prompt.kind === "line" ? node.prompt.character : void 0
+            });
+            visit(node.children ?? [], nodeCut);
+            continue;
+          }
+          for (const beat of node.beats ?? []) {
+            if (beat.kind === "gameEvent") continue;
+            add({
+              id: beat.id,
+              voiced: beat.kind === "line",
+              words: wordsOf(beat.id),
+              character: beat.kind === "line" ? beat.character : void 0
+            });
+          }
         }
-      });
+      };
+      visit(block.children, blockCut);
     }
-    for (const u of units) if (sceneCut || cutSet.has(u.id)) {
+    const isCut = (id) => cutSet.has(id) || underCut.has(id);
+    for (const u of units) if (sceneCut || isCut(u.id)) {
       cut.writtenLines++;
       if (u.voiced) cut.voicedLines++;
     }
@@ -2133,7 +2574,7 @@ function runReport(loaded, recordingOverride) {
       cut.scenes++;
       continue;
     }
-    const live = units.filter((u) => !cutSet.has(u.id));
+    const live = units.filter((u) => !isCut(u.id));
     for (const u of live) if (sourceStrings2[u.id]) localeIds.push(u.id);
     const statusIdx = live.length ? Math.min(...live.map((u) => rungIdxOf(u.id))) : void 0;
     const status = statusIdx === void 0 ? void 0 : writingLadder[statusIdx];
@@ -2176,7 +2617,7 @@ function runReport(loaded, recordingOverride) {
     const voiced = emptyVoiced(writingLadder, recordingLadder);
     const written = emptyWritten(writingLadder);
     for (const u of live) {
-      const ws = writingOf.get(u.id) ?? stub;
+      const ws = wsOf(u.id);
       written.count++;
       written.words += u.words;
       written.byWriting[ws] = (written.byWriting[ws] ?? 0) + 1;
@@ -2418,9 +2859,9 @@ async function runReportXlsx(data) {
 }
 
 // src/localisation.ts
-import { basename as basename5, join as join5, sep } from "path";
-import { canonicalStringify as canonicalStringify5 } from "@patterkit/core";
-import { walkNodes as walkNodes3, castStringKey, PROJECT_LOCALE_SCENE } from "@patterkit/model";
+import { basename as basename5, join as join7, sep as sep3 } from "path";
+import { canonicalStringify as canonicalStringify6 } from "@patterkit/core";
+import { walkNodes as walkNodes2, castStringKey, PROJECT_LOCALE_SCENE as PROJECT_LOCALE_SCENE2, projectLayout as projectLayout3, STRINGS_SCHEMA, AUTHORING_SCHEMA } from "@patterkit/model";
 
 // src/documentation.ts
 import { DEFAULT_DOCUMENTATION_CLASSES } from "@patterkit/model";
@@ -2494,7 +2935,7 @@ function extractLoc(loaded, opts = {}) {
   };
   for (const scene of loaded.scenes) {
     for (const block of scene.blocks) {
-      walkNodes3(block.children, (node) => {
+      walkNodes2(block.children, (node) => {
         if (node.type === "group") {
           const p = node.prompt;
           if (p) push(p.id, scene.id, { character: p.kind === "line" ? p.character : void 0, kind: p.kind });
@@ -2511,14 +2952,11 @@ function extractLoc(loaded, opts = {}) {
     const id = castStringKey(c.name);
     const src = source[id] ?? c.displayName;
     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) });
+    entries.push({ id, scene: PROJECT_LOCALE_SCENE2, source: src, translation, comments: commentsOf(id), context: withGender({ character: c.name }), stale: staleFor(id, translation) });
   }
   return { project: loaded.project.project.id, defaultLocale, locale: targetLocale, entries };
 }
-var layoutOf = (loaded) => ({
-  strings: loaded.project.layout?.strings ?? "loc/",
-  authoring: loaded.project.layout?.authoring ?? "authoring/"
-});
+var layoutOf = (loaded) => projectLayout3(loaded.project);
 function existingLocPath(loaded, scene, locale) {
   for (let i = 0; i < loaded.locales.length; i++) {
     const l = loaded.locales[i];
@@ -2531,23 +2969,23 @@ function targetLocPath(loaded, scene, locale, defaultLocale) {
   if (existing) return existing;
   const fromDefault = existingLocPath(loaded, scene, defaultLocale);
   if (fromDefault) {
-    const parts = fromDefault.split(sep);
+    const parts = fromDefault.split(sep3);
     for (let i = parts.length - 2; i >= 0; i--) {
       if (parts[i] === defaultLocale) {
         parts[i] = locale;
-        return parts.join(sep);
+        return parts.join(sep3);
       }
     }
   }
-  const stem = scene === PROJECT_LOCALE_SCENE ? "_project" : scene;
-  return join5(loaded.root, layoutOf(loaded).strings, locale, `${stem}.patterloc`);
+  const stem = scene === PROJECT_LOCALE_SCENE2 ? "_project" : scene;
+  return join7(loaded.root, layoutOf(loaded).strings, locale, `${stem}.patterloc`);
 }
 function authoringPath(loaded, scene) {
-  const dir = join5(loaded.root, layoutOf(loaded).authoring);
-  if (scene === PROJECT_LOCALE_SCENE) return join5(dir, "_project.patterx");
+  const dir = join7(loaded.root, layoutOf(loaded).authoring);
+  if (scene === PROJECT_LOCALE_SCENE2) return join7(dir, "_project.patterx");
   const flow = loaded.sceneFiles[scene];
   const stem = flow ? basename5(flow).replace(/\.patterflow$/, "") : scene;
-  return join5(dir, `${stem}.patterx`);
+  return join7(dir, `${stem}.patterx`);
 }
 var findFile = (files, items, path) => {
   const i = files.indexOf(path);
@@ -2558,6 +2996,14 @@ function applyLoc(loaded, catalog, opts = {}) {
   if (!locale || locale === loaded.project.locales.default) {
     return { writes: [], stats: { updated: 0, files: 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_SCENE2]);
+  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 bySceneText = /* @__PURE__ */ new Map();
   const bySceneFresh = /* @__PURE__ */ new Map();
@@ -2576,22 +3022,31 @@ function applyLoc(loaded, catalog, opts = {}) {
       if (merged[id] !== text) updated++;
       merged[id] = text;
     }
-    const file = { schema: existing?.schema ?? "patter/strings@0", scene, locale, strings: merged };
-    writes.push({ path, content: canonicalStringify5(file) });
+    const file = { schema: existing?.schema ?? STRINGS_SCHEMA, scene, locale, strings: merged };
+    writes.push({ path, content: canonicalStringify6(file) });
     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: "patter/authoring@0" };
+    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: canonicalStringify5(authoring) });
+    writes.push({ path: aPath, content: canonicalStringify6(authoring) });
   }
   return { writes, stats: { updated, files: bySceneText.size } };
 }
 
 // src/loc-format.ts
+function checkCatalogField(format, field, value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    throw new Error(`${format}: '${field}' must be a non-empty string (got ${JSON.stringify(value) ?? String(value)})`);
+  }
+  if (/[\\/]/.test(value) || value.includes("..")) {
+    throw new Error(`${format}: '${field}' ${JSON.stringify(value)} is not a plain name (it holds a path separator or '..')`);
+  }
+  return value;
+}
 function catalogToJson(catalog) {
   return JSON.stringify(catalog, null, 2) + "\n";
 }
@@ -2602,10 +3057,10 @@ function jsonToCatalog(text) {
   return {
     project: typeof o.project === "string" ? o.project : "",
     defaultLocale: o.defaultLocale,
-    locale: typeof o.locale === "string" ? o.locale : void 0,
+    locale: o.locale === void 0 || o.locale === null ? void 0 : checkCatalogField("localisation JSON", "locale", o.locale),
     entries: o.entries.map((e) => ({
       id: String(e.id),
-      scene: String(e.scene),
+      scene: checkCatalogField("localisation JSON", "scene", e.scene),
       source: String(e.source ?? ""),
       translation: String(e.translation ?? ""),
       comments: Array.isArray(e.comments) ? e.comments.map(String) : [],
@@ -2614,8 +3069,10 @@ function jsonToCatalog(text) {
     }))
   };
 }
-var poEscape = (s) => s.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\t/g, "\\t");
-var poUnescape = (s) => s.replace(/\\n/g, "\n").replace(/\\t/g, "	").replace(/\\"/g, '"').replace(/\\\\/g, "\\");
+var PO_ESCAPES = { "\\": "\\\\", '"': '\\"', "\n": "\\n", "	": "\\t", "\r": "\\r" };
+var PO_UNESCAPES = { "\\": "\\", '"': '"', n: "\n", t: "	", r: "\r" };
+var poEscape = (s) => s.replace(/[\\"\n\t\r]/g, (c) => PO_ESCAPES[c]);
+var poUnescape = (s) => s.replace(/\\(.)/gs, (all, c) => PO_UNESCAPES[c] ?? all);
 var poField = (key, value) => `${key} "${poEscape(value)}"`;
 function catalogToPo(catalog) {
   const out = [];
@@ -2665,10 +3122,10 @@ function poToCatalog(text) {
   let i = 0;
   const flush = (msgstr) => {
     if (ctxt !== void 0) {
-      entries.push({ id: ctxt, scene, source: msgid, translation: msgstr, comments, stale });
+      entries.push({ id: ctxt, scene: checkCatalogField("PO", "scene", scene), source: msgid, translation: msgstr, comments, stale });
     } else if (msgid === "") {
       const lang = /Language:\s*([^\\\n]*)/.exec(msgstr);
-      if (lang?.[1]?.trim()) locale = lang[1].trim();
+      if (lang?.[1]?.trim()) locale = checkCatalogField("PO", "locale", lang[1].trim());
       const pid = /Project-Id-Version:\s*([^\\\n]*)/.exec(msgstr);
       if (pid?.[1]?.trim()) project = pid[1].trim();
     }
@@ -2728,23 +3185,50 @@ function poToCatalog(text) {
 }
 
 // src/loc-xlsx.ts
-var HEADERS = ["ID", "Source", "Translation", "Comments", "Status", "Gender"];
-var sheetName = (scene) => scene.replace(/[:\\/?*[\]]/g, "-").slice(0, 31);
+var HEADERS = ["ID", "Source", "Translation", "Comments", "Status", "Gender", "Scene"];
+var SCENE_COLUMN = HEADERS.indexOf("Scene") + 1;
+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(sheetName(scene));
+    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 }
+      { 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 }
     ];
     ws.getRow(1).font = { bold: true };
     ws.views = [{ state: "frozen", ySplit: 1 }];
@@ -2755,7 +3239,8 @@ async function catalogToXlsx(catalog) {
         translation: e.translation,
         comments: e.comments.join("\n"),
         status: e.stale ? "stale" : e.translation ? "translated" : "",
-        gender: e.context?.gender ?? ""
+        gender: e.context?.gender ?? "",
+        scene
       });
     }
   }
@@ -2767,18 +3252,21 @@ async function xlsxToCatalog(buffer) {
   await wb.xlsx.load(buffer);
   const entries = [];
   for (const ws of wb.worksheets) {
-    const scene = ws.name;
-    const header = ws.getRow(1).values.slice(1).map((v) => String(v ?? ""));
+    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) => {
-        const v = row.getCell(c).value;
-        return v == null ? "" : String(typeof v === "object" && "text" in v ? v.text : v);
-      };
+      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,
@@ -2820,33 +3308,37 @@ function runVoiceScript(loaded, opts = {}) {
   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 ?? "",
+      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 (beat.kind !== "line" || cutSet.has(beat.id)) continue;
-      const ws = writingOf.get(beat.id) ?? stub;
-      if (!everything && recordThreshold !== -1 && (writingIndex.get(ws) ?? 0) < recordThreshold) continue;
-      const own = ownVo(beat.id);
-      lines.push({
-        scope: scope.join(" \u203A "),
-        id: beat.id,
-        character: beat.character ?? "",
-        actor: beat.character ? actorOf.get(beat.character) : void 0,
-        text: plainVoice(source[beat.id] ?? ""),
-        comments: leading ? [...ancestorVo, ...own] : own,
-        // first line of the run gets the enclosing context
-        recordingStatus: recordingOf(beat.id)
-      });
-      leading = false;
+      if (emitLine(beat, scope, leading ? ancestorVo : void 0)) leading = false;
     }
   };
   for (const scene of loaded.scenes) {
@@ -3229,7 +3721,7 @@ var SERIF2 = (bold, italic) => bold && italic ? "Serif-BoldItalic" : bold ? "Ser
 var isEmoji = (cp) => cp >= 126976 || cp >= 9728 && cp <= 10175;
 async function scriptToPdf(doc) {
   const { scriptFont } = await import("./script-fonts-AQNQOADI.js");
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     const pdf = new PDFDocument({ size: "A4", margins: { top: MARGIN, bottom: MARGIN, left: MARGIN, right: MARGIN }, info: { Title: doc.project, Author: "Patter" }, font: null });
     pdf.registerFont("Serif", scriptFont("serif"));
     pdf.registerFont("Serif-Bold", scriptFont("serifBold"));
@@ -3270,7 +3762,7 @@ async function scriptToPdf(doc) {
     const bodyPieces = (runs, color, base = {}) => runs.flatMap((r) => r.code ? split(r.text, "Mono", ACCENT) : split(r.text, SERIF2(base.bold || r.bold, base.italic || r.italic), color));
     const chunks = [];
     pdf.on("data", (c) => chunks.push(c));
-    pdf.on("end", () => resolve6(Buffer.concat(chunks)));
+    pdf.on("end", () => resolve7(Buffer.concat(chunks)));
     pdf.on("error", reject);
     const pageRight = pdf.page.width - MARGIN;
     const pageBottom = pdf.page.height - MARGIN;
@@ -3421,11 +3913,12 @@ async function scriptToPdf(doc) {
 }
 
 // src/init.ts
-import { join as join6, basename as basename6, resolve as resolve4 } from "path";
-import { readdirSync as readdirSync4, existsSync as existsSync3 } from "fs";
-import { newId, slug, canonicalStringify as canonicalStringify6 } from "@patterkit/core";
+import { join as join8, basename as basename6, resolve as resolve5 } from "path";
+import { readdirSync as readdirSync4, existsSync as existsSync5, readFileSync as readFileSync7 } from "fs";
+import { newId, slug, canonicalStringify as canonicalStringify7 } from "@patterkit/core";
+import { FLOW_SCHEMA, PROJECT_SCHEMA, STRINGS_SCHEMA as STRINGS_SCHEMA2 } from "@patterkit/model";
 function runInit(opts) {
-  const dir = resolve4(opts.dir);
+  const dir = resolve5(opts.dir);
   const name = opts.name?.trim() || basename6(dir).replace(/\.patter$/, "");
   const fileSlug = slug(name);
   let existing = [];
@@ -3437,7 +3930,7 @@ function runInit(opts) {
   const sceneId = newId("scn");
   const beatId = newId("T");
   const project = {
-    schema: "patter/project@0",
+    schema: PROJECT_SCHEMA,
     project: { id: newId("proj"), name },
     locales: { default: "en", all: ["en"] },
     ...opts.vcs ? { vcs: opts.vcs } : {},
@@ -3445,7 +3938,7 @@ function runInit(opts) {
     voiced: true
   };
   const flow = {
-    schema: "patter/flow@0",
+    schema: FLOW_SCHEMA,
     scene: {
       id: sceneId,
       type: "scene",
@@ -3464,7 +3957,7 @@ function runInit(opts) {
     }
   };
   const locale = {
-    schema: "patter/strings@0",
+    schema: STRINGS_SCHEMA2,
     scene: sceneId,
     locale: "en",
     default: true,
@@ -3474,27 +3967,39 @@ function runInit(opts) {
     strings: { [beatId]: `Welcome to ${name}. This is the first line of your story - replace it with your own.` }
   };
   const bundle = opts.bundle ?? "commit";
-  const projectFile = join6(dir, `${fileSlug}.patterproj`);
+  const projectFile = join8(dir, `${fileSlug}.patterproj`);
   const writes = [
-    { path: projectFile, content: canonicalStringify6(project) },
-    { path: join6(dir, "scenes", "start.patterflow"), content: canonicalStringify6(flow) },
-    { path: join6(dir, "loc", "en", "start.patterloc"), content: canonicalStringify6(locale) },
-    { path: join6(dir, ".editorconfig"), content: EDITORCONFIG },
-    ...vcsConfigWrites(dir, opts.vcs, bundle)
+    { path: join8(dir, "scenes", "start.patterflow"), content: canonicalStringify7(flow) },
+    { path: join8(dir, "loc", "en", "start.patterloc"), content: canonicalStringify7(locale) },
+    { path: join8(dir, ".editorconfig"), content: EDITORCONFIG },
+    ...vcsConfigWrites(dir, opts.vcs, bundle),
+    { path: projectFile, content: canonicalStringify7(project) }
   ];
-  const collisions = writes.map((w) => w.path).filter((p) => existsSync3(p));
+  const collisions = writes.map((w) => w.path).filter((p) => existsSync5(p));
   if (collisions.length > 0) {
     throw new Error(`refusing to overwrite existing file(s): ${collisions.join(", ")}`);
   }
   return { writes, projectFile, name };
 }
 function vcsConfigWrites(dir, vcs, bundle = "commit") {
-  const writes = [{ path: join6(dir, "vcs-setup.md"), content: vcsSetup(vcs, bundle) }];
-  if (vcs === "git") writes.push({ path: join6(dir, ".gitattributes"), content: GITATTRIBUTES });
+  const writes = [{ path: join8(dir, "vcs-setup.md"), content: vcsSetup(vcs, bundle) }];
+  if (vcs === "git") writes.push({ path: join8(dir, ".gitattributes"), content: GITATTRIBUTES });
   const ignore = ignoreFileFor(vcs);
-  if (ignore) writes.push({ path: join6(dir, ignore), content: ignoreContent(bundle) });
+  if (ignore) writes.push({ path: join8(dir, ignore), content: ignoreContent(bundle) });
   return writes;
 }
+function currentBundlePosture(dir, vcs) {
+  const read = (name) => {
+    try {
+      return readFileSync7(join8(dir, name), "utf8");
+    } catch {
+      return "";
+    }
+  };
+  const ignore = ignoreFileFor(vcs);
+  if (ignore && read(ignore).split(/\r?\n/).some((l) => l.trim() === "*.patterc")) return "ignore";
+  return read("vcs-setup.md").includes("This project IGNORES the compiled") ? "ignore" : "commit";
+}
 var EDITORCONFIG = `# Patter projects are UTF-8 + LF, always (spec - patter format enforces this).
 root = true
 
@@ -3573,13 +4078,13 @@ drivers once per clone (git config is not repo-tracked) - until then git falls
 back to a normal text merge for those files:
 
     git config merge.patter.name "Patter structured merge"
-    git config merge.patter.driver "patter merge %O %A %B -o %A"
+    git config merge.patter.driver "patter merge %O %A %B -o %A --path %P"
     git config merge.ours.driver true
 
 git invokes the per-path driver directly (no \`mergetool\` wrapper needed). \`%O %A
-%B\` are base / ours / theirs; the merged result is written back to \`%A\`. On a
-conflict \`patter merge\` exits non-zero and writes a \`.patterconflict\` sidecar
-beside the file, so the merge stays unresolved.
+%B\` are base / ours / theirs; the merged result is written back to \`%A\`, and
+\`%P\` is the file's real path. On a conflict \`patter merge\` exits non-zero and
+writes a \`.patterconflict\` sidecar beside that file, so the merge stays unresolved.
 `,
     perforce: `## Perforce
 
@@ -3675,7 +4180,7 @@ return via \`patter unpack\`.
 }
 
 // src/resolve.ts
-import { walkNodes as walkNodes4, effectiveGameId, DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES3, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES4 } from "@patterkit/model";
+import { walkNodes as walkNodes3, effectiveGameId as effectiveGameId2, DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES3, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES4 } from "@patterkit/model";
 function runResolve(loaded, query) {
   const entries = indexProject(loaded);
   const q = query.trim();
@@ -3729,7 +4234,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 });
       };
-      walkNodes4(block.children, (node) => {
+      walkNodes3(block.children, (node) => {
         if (node.type === "group") {
           if (node.prompt) consider(node.prompt);
           return;
@@ -3750,7 +4255,7 @@ function listProjectTags(loaded) {
     add(scene.tags);
     for (const block of scene.blocks) {
       add(block.tags);
-      walkNodes4(block.children, (node) => {
+      walkNodes3(block.children, (node) => {
         add(node.tags);
         if (node.type === "group") {
           add(node.prompt?.tags);
@@ -3769,11 +4274,11 @@ function runTagBrowse(loaded, tag, focus) {
   const out = [];
   for (const scene of loaded.scenes) {
     const file = loaded.sceneFiles[scene.id];
-    if (has(scene.tags)) out.push({ id: scene.id, kind: "scene", name: scene.name, gameId: effectiveGameId(scene), location: [scene.name], sceneId: scene.id, file });
+    if (has(scene.tags)) out.push({ id: scene.id, kind: "scene", name: scene.name, gameId: effectiveGameId2(scene), location: [scene.name], sceneId: scene.id, file });
     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: effectiveGameId(block), location: segments, sceneId: scene.id, file });
-      walkNodes4(block.children, (node) => {
+      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) => {
         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 });
@@ -3808,7 +4313,7 @@ function runPropertyUsage(loaded, query, focus) {
     }
     for (const block of scene.blocks) {
       const segments = [scene.name, block.name];
-      walkNodes4(block.children, (node) => {
+      walkNodes3(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]);
@@ -3838,18 +4343,19 @@ function parsePropertyQuery(query) {
   const regexes = prop.includes(".") ? [new RegExp(`@${esc2(prop)}\\b`, "i")] : [new RegExp(`@${esc2(prop)}\\b`, "i"), new RegExp(`@patter\\.${esc2(prop)}\\b`, "i")];
   return { regexes, value };
 }
-var indexCache = null;
+var indexCache = /* @__PURE__ */ new WeakMap();
 function sameRefs(a, b) {
   if (a.length !== b.length) return false;
   for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
   return true;
 }
 function indexProject(loaded) {
-  if (indexCache && indexCache.loaded === loaded && sameRefs(indexCache.scenes, loaded.scenes) && sameRefs(indexCache.locales, loaded.locales)) {
-    return indexCache.entries;
+  const hit = indexCache.get(loaded);
+  if (hit && sameRefs(hit.scenes, loaded.scenes) && sameRefs(hit.locales, loaded.locales)) {
+    return hit.entries;
   }
   const entries = buildIndex(loaded);
-  indexCache = { loaded, scenes: [...loaded.scenes], locales: [...loaded.locales], entries };
+  indexCache.set(loaded, { scenes: [...loaded.scenes], locales: [...loaded.locales], entries });
   return entries;
 }
 function buildIndex(loaded) {
@@ -3861,7 +4367,7 @@ function buildIndex(loaded) {
       id: scene.id,
       kind: "scene",
       name: scene.name,
-      gameId: effectiveGameId(scene),
+      gameId: effectiveGameId2(scene),
       location: [scene.name],
       sceneId: scene.id,
       file
@@ -3872,12 +4378,12 @@ function buildIndex(loaded) {
         id: block.id,
         kind: "block",
         name: block.name,
-        gameId: effectiveGameId(block),
+        gameId: effectiveGameId2(block),
         location: segments,
         sceneId: scene.id,
         file
       });
-      walkNodes4(block.children, (node) => {
+      walkNodes3(block.children, (node) => {
         out.push({
           id: node.id,
           kind: node.type,
@@ -3914,21 +4420,23 @@ function buildIndex(loaded) {
 }
 
 // src/replace.ts
-import { canonicalStringify as canonicalStringify7 } from "@patterkit/core";
-import { walkNodes as walkNodes5, PROJECT_LOCALE_SCENE as PROJECT_LOCALE_SCENE2 } from "@patterkit/model";
+import { canonicalStringify as canonicalStringify8 } from "@patterkit/core";
+import { walkNodes as walkNodes4, PROJECT_LOCALE_SCENE as PROJECT_LOCALE_SCENE3, AUTHORING_SCHEMA as AUTHORING_SCHEMA2 } from "@patterkit/model";
 import { findMatcher } from "@wildwinter/toolkit";
 function runReplace(loaded, opts) {
-  const plan = { hits: [], writes: [], shards: [], scenes: 0 };
+  const plan = { hits: [], writes: [], shards: [], authoring: [], scenes: 0 };
   const re = findMatcher(opts);
   if (!re) return plan;
   const def = loaded.project.locales.default;
+  const now = opts.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const stamped = /* @__PURE__ */ new Map();
   const locOf = /* @__PURE__ */ new Map();
   const sceneName = /* @__PURE__ */ new Map();
   for (const scene of loaded.scenes) {
     sceneName.set(scene.id, scene.name);
     for (const block of scene.blocks) {
       const segs = [scene.name, block.name];
-      walkNodes5(block.children, (node) => {
+      walkNodes4(block.children, (node) => {
         if (node.type === "group") {
           if (node.prompt) locOf.set(node.prompt.id, segs);
           return;
@@ -3939,10 +4447,10 @@ function runReplace(loaded, opts) {
   }
   for (let i = 0; i < loaded.locales.length; i++) {
     const shard = loaded.locales[i];
-    if (shard.locale !== def || shard.scene === PROJECT_LOCALE_SCENE2) continue;
+    if (shard.locale !== def || shard.scene === PROJECT_LOCALE_SCENE3) continue;
     const path = loaded.localeFiles[i];
     if (!path) continue;
-    let changed = false;
+    const changedIds = [];
     const merged = { ...shard.strings };
     for (const [id, before] of Object.entries(shard.strings)) {
       if (opts.onlyId && id !== opts.onlyId) continue;
@@ -3952,26 +4460,40 @@ function runReplace(loaded, opts) {
       if (after === before) continue;
       plan.hits.push({ id, sceneId: shard.scene, location: locOf.get(id) ?? [sceneName.get(shard.scene) ?? shard.scene], before, after });
       merged[id] = after;
-      changed = true;
+      changedIds.push(id);
     }
-    if (changed) {
+    if (changedIds.length) {
       const next = { ...shard, strings: merged };
-      plan.writes.push({ path, content: canonicalStringify7(next) });
+      plan.writes.push({ path, content: canonicalStringify8(next) });
       plan.shards.push(next);
       plan.scenes++;
+      const aPath = authoringPath(loaded, shard.scene);
+      let af = stamped.get(aPath);
+      if (!af) {
+        const ai = loaded.authoringFiles.indexOf(aPath);
+        af = ai >= 0 ? structuredClone(loaded.authoring[ai]) : { schema: AUTHORING_SCHEMA2 };
+        stamped.set(aPath, af);
+      }
+      const edits = { ...af.edits };
+      for (const id of changedIds) edits[id] = { ...edits[id], modifiedAt: now };
+      af.edits = edits;
     }
   }
+  for (const [path, file] of stamped) {
+    plan.authoring.push({ path, file });
+    plan.writes.push({ path, content: canonicalStringify8(file) });
+  }
   return plan;
 }
 
 // src/pin.ts
-import { readFileSync as readFileSync5 } from "fs";
-import { canonicalStringify as canonicalStringify8, parseSource as parseSource4 } from "@patterkit/core";
-import { effectiveGameId as effectiveGameId2, gameIdify } from "@patterkit/model";
+import { readFileSync as readFileSync8 } from "fs";
+import { canonicalStringify as canonicalStringify9, parseSource as parseSource5 } from "@patterkit/core";
+import { effectiveGameId as effectiveGameId3, gameIdify } from "@patterkit/model";
 function toPin(node) {
   if (node.gameId?.trim()) return void 0;
   if (!gameIdify(node.name)) return void 0;
-  return effectiveGameId2(node);
+  return effectiveGameId3(node);
 }
 function planPins(loaded) {
   const plan = { pinned: [], writes: [], scenes: [] };
@@ -3993,146 +4515,18 @@ function planPins(loaded) {
     });
     if (!changed) continue;
     const next = { ...scene, ...sceneGameId !== void 0 ? { gameId: sceneGameId } : {}, blocks };
-    const file = parseSource4(readFileSync5(path, "utf8"));
-    plan.writes.push({ path, content: canonicalStringify8({ ...file, scene: next }) });
+    const file = parseSource5(readFileSync8(path, "utf8"));
+    plan.writes.push({ path, content: canonicalStringify9({ ...file, scene: next }) });
     plan.scenes.push(next);
   }
   return plan;
 }
 
-// src/pack.ts
-import JSZip from "jszip";
-import { readFileSync as readFileSync7 } from "fs";
-import { dirname as dirname5, join as join8, relative as relative3, sep as sep2 } from "path";
-import { parseSource as parseSource5 } from "@patterkit/core";
-import { ARCHIVE_ENTRY_OPTS } from "@wildwinter/toolkit/archive";
-
-// src/handoff.ts
-import { existsSync as existsSync4, readFileSync as readFileSync6 } from "fs";
-import { basename as basename7, join as join7 } from "path";
-import { HANDOFF_SCHEMA } from "@patterkit/model";
-var HANDOFF_DIR = "handoffs";
-var HANDOFF_EXT = ".json";
-function handoffPath(root, id) {
-  return join7(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(join7(root, HANDOFF_DIR), HANDOFF_EXT)) {
-    try {
-      handoffs.push(parseHandoff(readFileSync6(file, "utf8")));
-    } catch (e) {
-      issues.push({ file, message: `${basename7(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 (!existsSync4(path)) return void 0;
-  return parseHandoff(readFileSync6(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"];
-var ENTRY_OPTS = ARCHIVE_ENTRY_OPTS;
-async function runPack(startPath) {
-  const projectFile = findProjectFile(startPath);
-  const root = dirname5(projectFile);
-  const project = parseSource5(readFileSync7(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 files = SHARD_EXTENSIONS.flatMap((ext) => walkFiles(root, ext)).map((abs) => ({ abs, rel: relative3(root, abs).split(sep2).join("/") })).sort((a, b) => a.rel.localeCompare(b.rel));
-  const scopes = gameScopesSnapshot(root, project);
-  const handoffs = walkFiles(join8(root, HANDOFF_DIR), ".json").map((abs) => ({ rel: relative3(root, abs).split(sep2).join("/"), text: readFileSync7(abs, "utf8") })).filter((f) => {
-    try {
-      return !parseHandoff(f.text).closed;
-    } catch {
-      return false;
-    }
-  });
-  const manifest = {
-    schema: "patter/document@0",
-    project: { id: project.project.id, name: project.project.name },
-    files: files.map((f) => f.rel),
-    ...scopes.length ? { gameScopes: scopes.map((f) => f.fileName) } : {},
-    ...handoffs.length ? { handoffs: handoffs.map((f) => f.rel) } : {}
-  };
-  const zip = new JSZip();
-  zip.file("patter.manifest.json", JSON.stringify(manifest, null, 2) + "\n", ENTRY_OPTS);
-  for (const f of files) zip.file(f.rel, readFileSync7(f.abs, "utf8"), ENTRY_OPTS);
-  for (const f of scopes) zip.file(`${GAME_SCOPES_DIR}/${f.fileName}`, f.text, ENTRY_OPTS);
-  for (const f of handoffs) zip.file(f.rel, f.text, ENTRY_OPTS);
-  return zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE", streamFiles: false });
-}
-
 // src/unpack.ts
 import JSZip2 from "jszip";
-import { join as join9, resolve as resolve5, sep as sep3 } from "path";
-import { existsSync as existsSync5, readFileSync as readFileSync8 } from "fs";
-import { parseSource as parseSource6, canonicalStringify as canonicalStringify9 } from "@patterkit/core";
+import { join as join9, resolve as resolve6, sep as sep4 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync9, readdirSync as readdirSync5 } from "fs";
+import { parseSource as parseSource6, canonicalStringify as canonicalStringify10 } from "@patterkit/core";
 import { isUnsafeEntry } from "@wildwinter/toolkit/archive";
 import { SCOPES_FILE_SUFFIX as SCOPES_FILE_SUFFIX2 } from "@wildwinter/scoperegistry/scopes";
 import { isUnsafeEntry as isUnsafeEntry2 } from "@wildwinter/toolkit/archive";
@@ -4147,11 +4541,26 @@ var isHandoffEntry = (name) => {
 };
 var UnsafeEntryError = class extends Error {
 };
-async function readDoc(bytes) {
-  const zip = await JSZip2.loadAsync(bytes);
+var NotAPackError = class extends Error {
+};
+var isShardEntry = (name) => SHARD_EXTENSIONS.some((ext) => name.endsWith(ext));
+function refuseUnsafe(name) {
+  if (isUnsafeEntry(name)) throw new UnsafeEntryError(`document entry escapes the target directory: ${name}`);
+  if (name.split("/").some((segment) => segment.startsWith("."))) {
+    throw new UnsafeEntryError(`document entry names a dot-file or dot-folder: ${name}`);
+  }
+}
+async function readDoc(bytes, which = "pack") {
+  let zip;
+  try {
+    zip = await JSZip2.loadAsync(bytes);
+  } catch {
+    throw new NotAPackError(`the ${which === "base" ? "base file" : "file"} is not a .patterpack (it is not a zip archive)`);
+  }
   const shards = /* @__PURE__ */ new Map();
   const scopes = /* @__PURE__ */ new Map();
   const handoffs = /* @__PURE__ */ new Map();
+  const other = [];
   let manifest;
   for (const [name, entry] of Object.entries(zip.files)) {
     if (entry.dir) continue;
@@ -4162,15 +4571,49 @@ async function readDoc(bytes) {
       }
       continue;
     }
-    if (isUnsafeEntry(name)) throw new UnsafeEntryError(`document entry escapes the target directory: ${name}`);
-    (isScopesEntry(name) ? scopes : isHandoffEntry(name) ? handoffs : shards).set(name, await entry.async("string"));
+    refuseUnsafe(name);
+    if (isScopesEntry(name)) scopes.set(name, await entry.async("string"));
+    else if (isHandoffEntry(name)) handoffs.set(name, await entry.async("string"));
+    else if (isShardEntry(name)) shards.set(name, await entry.async("string"));
+    else other.push(name);
   }
-  return { shards, scopes, handoffs, ...manifest ? { manifest } : {} };
+  return { shards, scopes, handoffs, other: other.sort(), ...manifest ? { manifest } : {} };
 }
 async function runUnpack(bytes, targetDir) {
   const doc = await readDoc(bytes);
+  if (projectEntry(doc.shards) === void 0) throw new NotAPackError("the file is not a .patterpack (it holds no project file)");
+  const here = projectIdIn(targetDir);
+  const packed = projectIdOf(doc.shards);
+  if (here !== void 0 && packed !== void 0 && here !== packed) {
+    throw new Error(`${targetDir} already holds a different project (${here}); unpack into an empty folder, or use --merge to fold a returned pack into this one`);
+  }
   const plan = (entries) => [...entries.entries()].map(([name, content]) => ({ path: containedWrite(targetDir, name), content })).sort((a, b) => a.path.localeCompare(b.path));
-  return { shards: plan(new Map([...doc.shards, ...doc.handoffs])), scopes: plan(doc.scopes) };
+  return { shards: plan(new Map([...doc.shards, ...doc.handoffs])), scopes: plan(doc.scopes), other: doc.other };
+}
+function projectIdIn(dir) {
+  let names;
+  try {
+    names = readdirSync5(dir).filter((n) => n.endsWith(".patterproj"));
+  } catch {
+    return void 0;
+  }
+  for (const n of names) {
+    try {
+      const id = parseSource6(readFileSync9(join9(dir, n), "utf8")).project?.id;
+      if (id) return id;
+    } catch {
+    }
+  }
+  return void 0;
+}
+function projectIdOf(shards) {
+  const rel = projectEntry(shards);
+  if (rel === void 0) return void 0;
+  try {
+    return parseSource6(shards.get(rel)).project?.id;
+  } catch {
+    return void 0;
+  }
 }
 function checkProvenance(returned, base, target) {
   const known = [returned, base, target].filter((id) => typeof id === "string" && id !== "");
@@ -4183,7 +4626,7 @@ function checkProvenance(returned, base, target) {
 }
 function targetProjectId(projectDir) {
   try {
-    const pf = parseSource6(readFileSync8(findProjectFile(projectDir), "utf8"));
+    const pf = parseSource6(readFileSync9(findProjectFile(projectDir), "utf8"));
     return pf.project?.id;
   } catch {
     return void 0;
@@ -4191,7 +4634,7 @@ function targetProjectId(projectDir) {
 }
 async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
   const returnedDoc = await readDoc(returnedBytes);
-  const baseDoc = await readDoc(baseBytes);
+  const baseDoc = await readDoc(baseBytes, "base");
   const theirs = returnedDoc.shards;
   const base = baseDoc.shards;
   const provenance = checkProvenance(returnedDoc.manifest?.project?.id, baseDoc.manifest?.project?.id, targetProjectId(projectDir));
@@ -4203,9 +4646,21 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
   let projectSides;
   for (const [rel, theirText] of [...theirs.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
     const outPath = containedWrite(projectDir, rel);
-    if (!existsSync5(outPath)) {
+    const baseText = base.get(rel);
+    if (!existsSync6(outPath)) {
+      if (baseText === theirText) continue;
       writes.push({ path: outPath, content: theirText });
-      shards.push({ path: rel, added: true });
+      shards.push({ path: rel, added: true, changed: true });
+      continue;
+    }
+    const oursText = readFileSync9(outPath, "utf8");
+    if (theirText === baseText || theirText === oursText) {
+      if (rel === projectRel && baseText !== void 0) {
+        const read = (t) => parseSource6(t);
+        const ours = read(oursText);
+        projectSides = { ours, base: read(baseText), theirs: read(theirText), merged: ours };
+      }
+      shards.push({ path: rel, added: false, changed: false });
       continue;
     }
     const readSide = (side, text) => {
@@ -4215,12 +4670,13 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
         throw new Error(`${rel}: the ${side} copy is not readable Patter source - ${e instanceof Error ? e.message : String(e)}`);
       }
     };
-    const oursObj = readSide("ours", readFileSync8(outPath, "utf8"));
+    const oursObj = readSide("ours", oursText);
     const theirsObj = readSide("theirs", theirText);
-    const baseText = base.get(rel);
     const baseObj = baseText !== void 0 ? readSide("base", baseText) : {};
     const result = runMerge(baseObj, oursObj, theirsObj);
-    writes.push({ path: outPath, content: canonicalStringify9(result.merged) });
+    const mergedText = canonicalStringify10(result.merged);
+    const changed = mergedText !== oursText;
+    if (changed) writes.push({ path: outPath, content: mergedText });
     if (rel === projectRel && baseText !== void 0) {
       projectSides = { ours: oursObj, base: baseObj, theirs: theirsObj, merged: result.merged };
     }
@@ -4229,10 +4685,10 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
       conflicts += result.conflicts.length;
     }
     warnings += result.warnings.length;
-    shards.push({ path: rel, result, added: false });
+    shards.push({ path: rel, result, added: false, changed });
   }
   let gameScopes;
-  const local2 = projectSides && discoverGameScopes(resolve5(projectDir), projectSides.ours).gameScopes;
+  const local2 = projectSides && discoverGameScopes(resolve6(projectDir), projectSides.ours).gameScopes;
   if (projectSides && local2) {
     const world = planReturnedWorld(projectSides.ours, projectSides.base, projectSides.theirs, projectSides.merged, local2);
     if (world.write) {
@@ -4243,18 +4699,18 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
   const handoffs = [];
   for (const [rel, theirText] of [...returnedDoc.handoffs.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
     const outPath = containedWrite(projectDir, rel);
-    if (!existsSync5(outPath)) {
+    if (!existsSync6(outPath)) {
       writes.push({ path: outPath, content: theirText });
       handoffs.push(rel);
       continue;
     }
-    const merged = mergeHandoff(parseHandoff(readFileSync8(outPath, "utf8")), parseHandoff(theirText));
+    const merged = mergeHandoff(parseHandoff(readFileSync9(outPath, "utf8")), parseHandoff(theirText));
     if (merged) {
       writes.push({ path: outPath, content: serialiseHandoff(merged) });
       handoffs.push(rel);
     }
   }
-  return { shards, writes, sidecars, conflicts, warnings, provenance, ...gameScopes ? { gameScopes } : {}, ...handoffs.length ? { handoffs } : {} };
+  return { shards, writes, sidecars, other: returnedDoc.other, conflicts, warnings, provenance, ...gameScopes ? { gameScopes } : {}, ...handoffs.length ? { handoffs } : {} };
 }
 function mergeHandoff(ours, theirs) {
   const key = (i) => `${i.at}|${i.fileHash}`;
@@ -4270,18 +4726,18 @@ function projectEntry(shards) {
   return at.length === 1 ? at[0] : void 0;
 }
 function containedWrite(dir, name) {
-  const root = resolve5(dir);
-  const full = resolve5(join9(dir, name));
-  if (full !== root && !full.startsWith(root + sep3)) {
+  const root = resolve6(dir);
+  const full = resolve6(join9(dir, name));
+  if (full !== root && !full.startsWith(root + sep4)) {
     throw new UnsafeEntryError(`document entry escapes the target directory: ${name}`);
   }
   return full;
 }
 
 // src/suggestions.ts
-import { readFileSync as readFileSync9 } from "fs";
-import { canonicalStringify as canonicalStringify10, parseSource as parseSource7 } from "@patterkit/core";
-import { walkNodes as walkNodes6 } from "@patterkit/model";
+import { readFileSync as readFileSync10 } from "fs";
+import { canonicalStringify as canonicalStringify11, parseSource as parseSource7 } from "@patterkit/core";
+import { walkNodes as walkNodes5, AUTHORING_SCHEMA as AUTHORING_SCHEMA3 } from "@patterkit/model";
 function staleParts(s, liveText, line) {
   const stale = [];
   if (liveText !== s.baseline) stale.push("the text");
@@ -4311,7 +4767,7 @@ function indexPlaces(loaded) {
     places.set(scene.id, { sceneId: scene.id });
     for (const block of scene.blocks) {
       places.set(block.id, { sceneId: scene.id });
-      walkNodes6(block.children, (node) => {
+      walkNodes5(block.children, (node) => {
         places.set(node.id, { sceneId: scene.id });
         if (node.type === "group") {
           if (node.prompt) places.set(node.prompt.id, { sceneId: scene.id });
@@ -4342,7 +4798,7 @@ var Working = class {
     if (!af) {
       const i = this.loaded.authoringFiles.indexOf(path);
       const existing = i >= 0 ? this.loaded.authoring[i] : void 0;
-      af = existing ? structuredClone(existing) : { schema: "patter/authoring@0" };
+      af = existing ? structuredClone(existing) : { schema: AUTHORING_SCHEMA3 };
       this.authoring.set(path, af);
     }
     return af;
@@ -4365,7 +4821,7 @@ var Working = class {
     if (!path) return void 0;
     let file = this.flows.get(path);
     if (!file) {
-      const onDisk = parseSource7(readFileSync9(path, "utf8"));
+      const onDisk = parseSource7(readFileSync10(path, "utf8"));
       const scene = this.loaded.scenes.find((s) => s.id === sceneId);
       file = { ...onDisk, scene: structuredClone(scene ?? onDisk.scene) };
       this.flows.set(path, file);
@@ -4373,13 +4829,13 @@ 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: canonicalStringify10(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: canonicalStringify11(file) })).sort((a, b) => a.path.localeCompare(b.path));
   }
 };
 function beatIn(scene, id) {
   let found;
   for (const block of scene.blocks) {
-    walkNodes6(block.children, (node) => {
+    walkNodes5(block.children, (node) => {
       if (found || node.type !== "snippet") return;
       found = (node.beats ?? []).find((b) => b.id === id);
     });
@@ -4865,22 +5321,22 @@ function plain(t) {
 }
 function readRow(tr, indent) {
   const cells = kids(tr).filter((c) => local(c) === "tc");
-  const cellText = (tc, joiner = " ") => readParagraphs(tc ? paragraphsIn(tc) : [], joiner);
-  const last = cellText(cells[cells.length - 1]);
+  const cellText2 = (tc, joiner = " ") => readParagraphs(tc ? paragraphsIn(tc) : [], joiner);
+  const last = cellText2(cells[cells.length - 1]);
   const found = readMarker(last.text.proposed);
   const recovered = found ? void 0 : readMarker(last.text.original);
   const marker = found ?? (recovered ? { ...recovered, recovered: true } : void 0);
   if (cells.length < 2 || !marker) {
     return { kind: "table", text: readParagraphs(cells.flatMap(paragraphsIn), " ").text };
   }
-  const words = cellText(cells.length >= 3 ? cells[1] : cells[0]);
+  const words = cellText2(cells.length >= 3 ? cells[1] : cells[0]);
   const trPr = child(tr, "trPr");
   return {
     kind: "box",
     marker,
     text: words.text,
     paragraphs: words.paragraphs,
-    lead: plain(cells.length >= 3 ? cellText(cells[0], "\n").text : readParagraphs([], " ").text),
+    lead: plain(cells.length >= 3 ? cellText2(cells[0], "\n").text : readParagraphs([], " ").text),
     margin: plain(last.text),
     rowDeleted: !!(trPr && child(trPr, "del")),
     ...indent !== void 0 ? { indent } : {}
@@ -4973,7 +5429,8 @@ async function readEditableDocx(bytes) {
 }
 
 // src/editable-import.ts
-import { canonicalStringify as canonicalStringify11 } from "@patterkit/core";
+import { canonicalStringify as canonicalStringify12 } from "@patterkit/core";
+import { AUTHORING_SCHEMA as AUTHORING_SCHEMA4 } from "@patterkit/model";
 var REFUSE_MISSING_SHARE = 0.25;
 var tidy = (s) => s.replace(/[\s   ]+/g, " ").trim();
 function normalise(s, strictQuotes) {
@@ -5214,7 +5671,7 @@ function planEditableImport(loaded, returned, opts) {
     let af = shards.get(path);
     if (!af) {
       const i = loaded.authoringFiles.indexOf(path);
-      af = i >= 0 ? structuredClone(loaded.authoring[i]) : { schema: "patter/authoring@0" };
+      af = i >= 0 ? structuredClone(loaded.authoring[i]) : { schema: AUTHORING_SCHEMA4 };
       shards.set(path, af);
     }
     return af;
@@ -5235,7 +5692,7 @@ function planEditableImport(loaded, returned, opts) {
     const af = shardFor(c.anchor);
     af.comments = [...af.comments ?? [], c];
   }
-  let writes = [...shards].map(([path, af]) => ({ path, content: canonicalStringify11(af) }));
+  let writes = [...shards].map(([path, af]) => ({ path, content: canonicalStringify12(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));
@@ -5366,12 +5823,15 @@ function alignParagraphs(items, skeleton, codeOfBox, onEdited, onAdded, lineIdOf
   return anchors;
 }
 export {
+  AUDIO_MANIFEST_FILE,
+  AUDIO_MANIFEST_SCHEMA,
   AUTHORING_HANDLED,
   CONFLICT_SIDECAR,
   GAME_SCOPES_DIR,
   GAME_SCOPES_FILE,
   GAME_SCOPES_OWNER,
   HANDOFF_DIR,
+  NotAPackError,
   PATTER_SCOPES_FILE,
   PATTER_SCOPES_OWNER,
   RARE_REACH_PCT,
@@ -5383,15 +5843,24 @@ export {
   applySceneOrder,
   applySuggestionDecisions,
   applyWrites,
+  audioFolderRungs,
+  audioFoldersActive,
+  audioManifest,
+  audioManifestWrite,
+  besideBundlePath,
   bundleOutputPath,
   catalogToJson,
   catalogToPo,
   catalogToXlsx,
   classesForChannel,
+  compileLoaded,
+  currentBundlePosture,
+  defaultBundlePath,
   defaultGameScopesDir,
   detectMergeType,
   discoverGameScopes,
   drivableScopes,
+  exportBlockers,
   exportEditableScript,
   extractLoc,
   findProjectFile,
@@ -5416,6 +5885,8 @@ export {
   patterScopesFile,
   patterScopesStale,
   patterScopesWrite,
+  pickAudio,
+  planBuild,
   planEditableImport,
   planPins,
   planReturnedWorld,
@@ -5459,6 +5930,7 @@ export {
   runUnpackMerge,
   runValidate,
   runVoiceScript,
+  scanAudio,
   scanAudioStatus,
   sceneIdForShard,
   scriptToDocx,