@patterkit/ops 0.1.0

package/dist/index.js

@@ -0,0 +1,3317 @@
+// src/load.ts
+import { readdirSync, readFileSync, statSync, existsSync } from "fs";
+import { join, dirname, resolve, basename } from "path";
+import { parseSource } from "@patterkit/core";
+function readDirSafe(dir) {
+  try {
+    return readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+}
+function walkFiles(dir, ext) {
+  const out = [];
+  for (const e of readDirSafe(dir)) {
+    const p = join(dir, e.name);
+    if (e.isDirectory()) out.push(...walkFiles(p, ext));
+    else if (e.isFile() && e.name.endsWith(ext)) out.push(p);
+  }
+  return out.sort();
+}
+function findProjectFile(startPath) {
+  let dir = resolve(startPath);
+  try {
+    if (statSync(dir).isFile()) {
+      if (dir.endsWith(".patterproj")) return dir;
+      dir = dirname(dir);
+    }
+  } catch {
+  }
+  for (; ; ) {
+    const here = readDirSafe(dir).filter((e) => e.isFile() && e.name.endsWith(".patterproj")).map((e) => join(dir, e.name)).sort();
+    if (here.length > 1) throw new Error(`multiple project files in ${dir}: ${here.map((p) => p.slice(dir.length + 1)).join(", ")}`);
+    if (here.length === 1) return here[0];
+    const parent = dirname(dir);
+    if (parent === dir) throw new Error(`no .patterproj found at or above ${startPath}`);
+    dir = parent;
+  }
+}
+function parseFile(file, expectSchema, shapeKey) {
+  let parsed;
+  try {
+    parsed = parseSource(readFileSync(file, "utf8"));
+  } catch (e) {
+    throw new Error(`${file}: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  const obj = parsed;
+  if (typeof obj !== "object" || obj === null || !(shapeKey in obj)) {
+    throw new Error(`${file}: not a ${expectSchema} file (missing '${shapeKey}')`);
+  }
+  const schema = obj["schema"];
+  if (typeof schema !== "string" || !schema.startsWith(expectSchema)) {
+    throw new Error(`${file}: schema is '${String(schema)}', expected '${expectSchema}@...'`);
+  }
+  migrateLegacyPropertyTypes(parsed, expectSchema);
+  return parsed;
+}
+function migrateLegacyPropertyTypes(parsed, expectSchema) {
+  const fixDecls = (decls) => {
+    if (!Array.isArray(decls)) return;
+    for (const d of decls) {
+      if (d && typeof d === "object" && d.type === "bool") d.type = "boolean";
+    }
+  };
+  if (!parsed || typeof parsed !== "object") return;
+  const obj = parsed;
+  if (expectSchema === "patter/project") {
+    fixDecls(obj["properties"]);
+    const reg = obj["scopeRegistry"];
+    if (reg && Array.isArray(reg.scopes)) for (const s of reg.scopes) fixDecls(s.declarations);
+    const recs = obj["recordingStatuses"];
+    if (Array.isArray(recs)) obj["recordingStatuses"] = recs.map((r) => typeof r === "string" ? { name: r } : r);
+  } else if (expectSchema === "patter/flow") {
+    const scene = obj["scene"];
+    fixDecls(scene?.sceneProps);
+  }
+}
+function sceneIdForShard(shardPath) {
+  const p = resolve(shardPath);
+  try {
+    if (p.endsWith(".patterflow")) return parseSource(readFileSync(p, "utf8")).scene?.id;
+    if (p.endsWith(".patterloc")) return parseSource(readFileSync(p, "utf8")).scene;
+    if (p.endsWith(".patterx")) {
+      const projectFile = findProjectFile(p);
+      const project = parseFile(projectFile, "patter/project", "project");
+      const flowDir = join(dirname(projectFile), project.layout?.flow ?? "scenes/");
+      const flowPath = join(flowDir, basename(p).replace(/\.patterx$/, ".patterflow"));
+      return parseSource(readFileSync(flowPath, "utf8")).scene?.id;
+    }
+  } catch {
+  }
+  return void 0;
+}
+function loadProjectLanding(startPath, opts) {
+  const projectFile = findProjectFile(startPath);
+  const root = dirname(projectFile);
+  const project = parseFile(projectFile, "patter/project", "project");
+  const layout = { flow: "scenes/", strings: "loc/", authoring: "authoring/", ...project.layout };
+  const flowFiles = walkFiles(join(root, layout.flow), ".patterflow");
+  const launchPath = opts?.launchPath ? resolve(opts.launchPath) : void 0;
+  let landingFile;
+  if (launchPath?.endsWith(".patterflow")) landingFile = flowFiles.find((f) => resolve(f) === launchPath);
+  if (!landingFile) {
+    const targetId = (opts?.launchPath ? sceneIdForShard(opts.launchPath) : void 0) ?? opts?.preferId;
+    if (targetId) {
+      for (const f of flowFiles) {
+        if (parseFile(f, "patter/flow", "scene").scene.id === targetId) {
+          landingFile = f;
+          break;
+        }
+      }
+    }
+  }
+  landingFile ??= flowFiles[0];
+  const landingScene = landingFile ? parseFile(landingFile, "patter/flow", "scene").scene : void 0;
+  const scenes = [];
+  const sceneFiles = {};
+  if (landingScene && landingFile) {
+    scenes.push(landingScene);
+    sceneFiles[landingScene.id] = landingFile;
+  }
+  const locales = [];
+  const localeFiles = [];
+  if (landingScene && landingFile) {
+    const defaultLocale = project.locales.default;
+    const strings = join(root, layout.strings);
+    const guess = join(strings, defaultLocale, `${basename(landingFile).replace(/\.patterflow$/, "")}.patterloc`);
+    let found = false;
+    if (existsSync(guess)) {
+      try {
+        const loc = parseFile(guess, "patter/strings", "strings");
+        if (loc.scene === landingScene.id) {
+          locales.push(loc);
+          localeFiles.push(guess);
+          found = true;
+        }
+      } catch {
+      }
+    }
+    if (!found) {
+      for (const f of walkFiles(strings, ".patterloc")) {
+        const loc = parseFile(f, "patter/strings", "strings");
+        if (loc.scene !== landingScene.id) continue;
+        locales.push(loc);
+        localeFiles.push(f);
+        if (loc.locale === defaultLocale || loc.default) break;
+      }
+    }
+  }
+  return { root, projectFile, project, scenes, locales, sceneFiles, localeFiles, authoring: [], authoringFiles: [] };
+}
+function applySceneOrder(scenes, order) {
+  if (!order?.length) return;
+  const rank = new Map(order.map((id, i) => [id, i]));
+  const fileRank = new Map(scenes.map((s, i) => [s.id, i]));
+  scenes.sort((a, b) => {
+    const ra = rank.get(a.id), rb = rank.get(b.id);
+    if (ra !== void 0 && rb !== void 0) return ra - rb;
+    if (ra !== void 0) return -1;
+    if (rb !== void 0) return 1;
+    return (fileRank.get(a.id) ?? 0) - (fileRank.get(b.id) ?? 0);
+  });
+}
+function loadProject(startPath) {
+  const projectFile = findProjectFile(startPath);
+  const root = dirname(projectFile);
+  const project = parseFile(projectFile, "patter/project", "project");
+  const layout = { flow: "scenes/", strings: "loc/", authoring: "authoring/", ...project.layout };
+  const scenes = [];
+  const sceneFiles = {};
+  for (const f of walkFiles(join(root, layout.flow), ".patterflow")) {
+    const scene = parseFile(f, "patter/flow", "scene").scene;
+    const existing = sceneFiles[scene.id];
+    if (existing !== void 0) {
+      throw new Error(`scene id '${scene.id}' is declared by two files: ${existing} and ${f}`);
+    }
+    scenes.push(scene);
+    sceneFiles[scene.id] = f;
+  }
+  applySceneOrder(scenes, project.sceneOrder);
+  const locales = [];
+  const localeFiles = [];
+  for (const f of walkFiles(join(root, layout.strings), ".patterloc")) {
+    locales.push(parseFile(f, "patter/strings", "strings"));
+    localeFiles.push(f);
+  }
+  const authoring = [];
+  const authoringFiles = [];
+  for (const f of walkFiles(join(root, layout.authoring), ".patterx")) {
+    authoring.push(parseFile(f, "patter/authoring", "schema"));
+    authoringFiles.push(f);
+  }
+  return { root, projectFile, project, scenes, locales, sceneFiles, localeFiles, authoring, authoringFiles };
+}
+
+// src/write.ts
+import { writeFileSync, mkdirSync } from "fs";
+import { dirname as dirname2 } from "path";
+function applyWrites(writes) {
+  for (const w of writes) {
+    mkdirSync(dirname2(w.path), { recursive: true });
+    writeFileSync(w.path, w.content, "utf8");
+  }
+}
+
+// src/validate.ts
+import { readFileSync as readFileSync2, statSync as statSync2 } from "fs";
+import { validateProject, parseSource as parseSource2 } from "@patterkit/core";
+import { validateConditions, validateInterpolation, exportBundle, hostScopesToSpec } from "@patterkit/compiler";
+function runValidate(loaded) {
+  const { project, scenes, locales } = loaded;
+  const structural = validateProject({ project, scenes, authoring: loaded.authoring });
+  const foreignScopes = hostScopesToSpec(project.scopeRegistry);
+  const conditions = validateConditions({ project, scenes }, { foreignScopes });
+  const interpolation = validateInterpolation({ project, scenes, locales }, { foreignScopes });
+  const hygiene = checkHygiene([loaded.projectFile, ...Object.values(loaded.sceneFiles), ...loaded.localeFiles, ...loaded.authoringFiles]);
+  const staleBundles = checkBundles(loaded);
+  const unresolvedMerges = walkFiles(loaded.root, ".patterconflict").map((file) => ({
+    file,
+    message: "unresolved merge conflict - resolve it and delete the .patterconflict sidecar before committing"
+  }));
+  return {
+    structural,
+    conditions,
+    interpolation,
+    hygiene,
+    staleBundles,
+    unresolvedMerges,
+    ok: structural.length === 0 && conditions.length === 0 && interpolation.length === 0 && hygiene.length === 0 && staleBundles.length === 0 && unresolvedMerges.length === 0
+  };
+}
+function checkBundles(loaded) {
+  const issues = [];
+  const bundles = walkFiles(loaded.root, ".patterc");
+  if (bundles.length === 0) return issues;
+  let fresh;
+  try {
+    fresh = exportBundle({ project: loaded.project, scenes: loaded.scenes, locales: loaded.locales }).content.hash;
+  } catch {
+    return issues;
+  }
+  for (const file of bundles) {
+    let hash;
+    try {
+      const parsed = parseSource2(readFileSync2(file, "utf8"));
+      hash = parsed?.content?.hash;
+    } catch {
+      issues.push({ file, message: "compiled bundle is unparseable - run `patter export`" });
+      continue;
+    }
+    if (hash !== fresh) {
+      issues.push({ file, message: "compiled bundle is stale (does not match current source) - run `patter export`" });
+    }
+  }
+  return issues;
+}
+var hygieneCache = /* @__PURE__ */ new Map();
+function checkHygiene(files) {
+  const issues = [];
+  for (const file of files) {
+    let mtimeMs;
+    try {
+      mtimeMs = statSync2(file).mtimeMs;
+    } catch {
+      continue;
+    }
+    const hit = hygieneCache.get(file);
+    if (hit && hit.mtimeMs === mtimeMs) {
+      issues.push(...hit.issues);
+      continue;
+    }
+    const fileIssues = [];
+    try {
+      const text = readFileSync2(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`)" });
+      }
+      if (text.includes("\r")) {
+        fileIssues.push({ file, message: "file contains CRLF line endings (canonical form is LF - run `patter format`)" });
+      }
+    } catch {
+      continue;
+    }
+    hygieneCache.set(file, { mtimeMs, issues: fileIssues });
+    issues.push(...fileIssues);
+  }
+  return issues;
+}
+
+// src/export.ts
+import { basename as basename2, isAbsolute, join as join2 } from "path";
+import { exportBundle as exportBundle2 } 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 runExport(loaded) {
+  const { project, locales } = loaded;
+  const full = exportBundle2({ project, scenes: compileScenes(loaded), locales });
+  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) {
+  const { project, locales } = loaded;
+  return exportBundle2({ project, scenes: compileScenes(loaded), locales });
+}
+function bundleOutputPath(loaded) {
+  const override = loaded.project.export?.bundle;
+  if (override) return isAbsolute(override) ? override : join2(loaded.root, override);
+  const stem = basename2(loaded.projectFile).replace(/\.patterproj$/, "");
+  return join2(loaded.root, "dist", `${stem}.patterc`);
+}
+
+// src/export-html.ts
+import { canonicalStringify } from "@patterkit/core";
+
+// src/playable-runtime.ts
+var PLAYABLE_RUNTIME_JS = '"use strict";var Patterplay=(()=>{var N=Object.defineProperty;var oe=Object.getOwnPropertyDescriptor;var ae=Object.getOwnPropertyNames;var ce=Object.prototype.hasOwnProperty;var le=(s,e)=>{for(var t in e)N(s,t,{get:e[t],enumerable:!0})},pe=(s,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of ae(e))!ce.call(s,n)&&n!==t&&N(s,n,{get:()=>e[n],enumerable:!(r=oe(e,n))||r.enumerable});return s};var de=s=>pe(N({},"__esModule",{value:!0}),s);var xe={};le(xe,{Engine:()=>R,Flow:()=>b,buildTagIndex:()=>I,effectiveGameData:()=>ne,gameDataFields:()=>re,gameDataValue:()=>G});function m(s){switch(s[0]){case"b":return{kind:"bool",value:s[1]};case"n":return{kind:"number",value:s[1]};case"s":return{kind:"string",value:s[1]};case"sv":return{kind:"scopedvar",scope:s[1],name:s[2]};case"u":return{kind:"unary",op:s[1],operand:m(s[2])};case"bin":return{kind:"binary",op:s[1],left:m(s[2]),right:m(s[3])};case"call":{let e=s.slice(2).map(m);return{kind:"call",name:s[1],args:e}}case"fd":return{kind:"flagdelta",sign:s[1],name:s[2]}}}var c=class extends Error{constructor(e){super(e),this.name="EvalError"}};function P(s,e,t){let r=new Map(t.scopes.map(i=>[i.token,i.missing??"false"])),n=i=>{switch(i.kind){case"bool":return i.value;case"number":return i.value;case"string":return i.value;case"scopedvar":{let o=e.scopes[i.scope];if(o===void 0)return!1;let a=typeof o.get=="function"?o.get(i.name):o[i.name];if(a===void 0){if(r.get(i.scope)==="throw")throw new c(`@${i.scope}.${i.name} is not declared on the current ${i.scope}.`);return!1}return a}case"call":{let o=t.functions[i.name];if(!o)throw new c(`unknown function \'${i.name}\'`);return o.eval(i.args,{evaluate:n,ctx:e})}case"flagdelta":throw new c("flagdelta node is only valid as an argument to a flag-delta function");case"unary":{if(i.op==="not"){let a=n(i.operand);if(typeof a!="boolean")throw new c(`\'not\' requires a boolean operand, got ${typeof a}`);return!a}let o=n(i.operand);if(typeof o!="number")throw new c(`unary \'-\' requires a numeric operand, got ${typeof o}`);return-o}case"binary":{if(i.op==="and"){let p=n(i.left);if(typeof p!="boolean")throw new c(`\'and\' requires boolean operands, left is ${typeof p}`);if(!p)return!1;let d=n(i.right);if(typeof d!="boolean")throw new c(`\'and\' requires boolean operands, right is ${typeof d}`);return d}if(i.op==="or"){let p=n(i.left);if(typeof p!="boolean")throw new c(`\'or\' requires boolean operands, left is ${typeof p}`);if(p)return!0;let d=n(i.right);if(typeof d!="boolean")throw new c(`\'or\' requires boolean operands, right is ${typeof d}`);return d}let o=n(i.left),a=n(i.right);switch(i.op){case"==":return q(o,a);case"!=":return!q(o,a);case">":return S(o,a,">"),o>a;case">=":return S(o,a,">="),o>=a;case"<":return S(o,a,"<"),o<a;case"<=":return S(o,a,"<="),o<=a;case"+":if(typeof o=="number"&&typeof a=="number"||typeof o=="string"&&typeof a=="string")return o+a;throw new c(`\'+\' requires two numbers or two strings, got ${typeof o} and ${typeof a}`);case"-":return S(o,a,"-"),o-a;case"*":return S(o,a,"*"),o*a;case"/":if(S(o,a,"/"),a===0)throw new c("division by zero");return o/a}}}};return n(s)}function q(s,e){if(Array.isArray(s)||Array.isArray(e)){if(!Array.isArray(s)||!Array.isArray(e)||s.length!==e.length)return!1;for(let t=0;t<s.length;t++)if(s[t]!==e[t])return!1;return!0}return s===e}function S(s,e,t){if(typeof s!="number"||typeof e!="number")throw new c(`\'${t}\' requires numeric operands, got ${typeof s} and ${typeof e}`)}var w=class{scopes=new Map;defineOwned(e,t){this.assertFree(e);let r={},n=new Map;for(let i of t){let o=i.name.toLowerCase();n.set(o,i),r[o]=i.default??_(i)}return this.scopes.set(e,{kind:"owned",bag:r,decls:n}),this}reseedOwned(e,t){let r=this.scopes.get(e);if(!r||r.kind!=="owned")throw new Error(`\'@${e}\' is not an owned scope`);for(let n of Object.keys(r.bag))delete r.bag[n];r.decls.clear();for(let n of t){let i=n.name.toLowerCase();r.decls.set(i,n),r.bag[i]=n.default??_(n)}return this}defineForeign(e,t,r=[],n=!0){this.assertFree(e);let i=new Map;for(let o of r)i.set(o.name.toLowerCase(),o);return this.scopes.set(e,{kind:"foreign",resolver:t,decls:i,scopeWritable:n}),this}has(e){return this.scopes.has(e)}get(e,t){let r=this.scopes.get(e);if(!r)return;let n=t.toLowerCase();return r.kind==="owned"?r.bag[n]:r.resolver.get(n)}set(e,t,r){let n=this.scopes.get(e);if(!n)throw new Error(`unknown scope \'@${e}\'`);let i=t.toLowerCase();if(!this.writable(n,i))throw new Error(`\'@${e}.${t}\' is read-only`);n.kind==="owned"?n.bag[i]=r:n.resolver.set(i,r)}writable(e,t){return e.kind==="owned"?e.decls.get(t)?.writable??!0:e.resolver.set?e.decls.get(t)?.writable??e.scopeWritable:!1}toEvalContext(e){let t={};for(let[r,n]of this.scopes)t[r]=n.kind==="owned"?n.bag:n.resolver;return{scopes:t,host:e}}toSchema(){let e=new Map;for(let[t,r]of this.scopes){if(r.decls.size===0)continue;let n=new Map;for(let[i,o]of r.decls)n.set(i,{type:o.type,enumValues:o.values});e.set(t,n)}return{properties:e}}save(){let e={};for(let[t,r]of this.scopes)r.kind==="owned"&&(e[t]={...r.bag});return e}load(e){for(let[t,r]of Object.entries(e)){let n=this.scopes.get(t);n?.kind==="owned"&&Object.assign(n.bag,r)}}assertFree(e){if(this.scopes.has(e))throw new Error(`scope \'@${e}\' is already registered`)}};function _(s){if(s.default!==void 0)return s.default;switch(s.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"enum":return s.values?.[0]??"";case"flags":return[]}}function x(s){return s.ctx.host??{}}var J={defaultScope:"patter",scopes:[{token:"patter"},{token:"scene"}],functions:{random:{minArgs:2,maxArgs:2,returnType:"number",eval(s,e){if(s.length!==2)throw new c("random(a, b) requires exactly 2 arguments");let t=x(e).nextRandom;if(!t)throw new c("random() called without a PRNG in context");let r=e.evaluate(s[0]),n=e.evaluate(s[1]);if(typeof r!="number"||typeof n!="number")throw new c("random(a, b) arguments must be numbers");if(!Number.isInteger(r)||!Number.isInteger(n))throw new c("random(a, b) arguments must be integers");let i=Math.min(r,n),o=Math.max(r,n);return Math.floor(t()*(o-i+1))+i}},check_flags:{minArgs:1,returnType:"boolean",flagDeltaArgs:!0,validate:W("check_flags"),eval(s,e){let t=U(s[0],e,"check_flags");for(let r=1;r<s.length;r++){let n=s[r];if(n.kind!=="flagdelta")throw new c("check_flags() flag args must be +flagName or -flagName");if(n.sign==="+"?!t.includes(n.name):t.includes(n.name))return!1}return!0}},set_flags:{minArgs:1,returnType:"flags",flagDeltaArgs:!0,validate:W("set_flags"),eval(s,e){let t=[...U(s[0],e,"set_flags")];for(let r=1;r<s.length;r++){let n=s[r];if(n.kind!=="flagdelta")throw new c("set_flags() flag args must be +flagName or -flagName");if(n.sign==="+")t.includes(n.name)||t.push(n.name);else{let i=t.indexOf(n.name);i>=0&&t.splice(i,1)}}return t}},visits:{minArgs:1,maxArgs:1,returnType:"number",validate:C("visits"),eval:(s,e)=>x(e).visits?.(E(s,e,"visits"))??0},seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:C("seen"),eval:(s,e)=>(x(e).visits?.(E(s,e,"seen"))??0)>0},patter_visits:{minArgs:1,maxArgs:1,returnType:"number",validate:C("patter_visits"),eval:(s,e)=>x(e).patterVisits?.(E(s,e,"patter_visits"))??0},patter_seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:C("patter_seen"),eval:(s,e)=>(x(e).patterVisits?.(E(s,e,"patter_seen"))??0)>0}}};function A(s,e){let t=s.replace(/^@/,"").split(".");return t.length===2&&e(t[0])?{scope:t[0],name:t[1].toLowerCase()}:{scope:"patter",name:t.join(".").toLowerCase()}}function E(s,e,t){let r=e.evaluate(s[0]);if(typeof r!="string")throw new c(`${t}(id) requires a string node id`);return r}function C(s){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:`${s}(id): the argument must be a string id literal (a scene / block / node id)`})}}function U(s,e,t){if(!s)throw new c(`${t}() requires at least one argument (the flags variable)`);let r=e.evaluate(s);if(Array.isArray(r))return r;if(r===!1||r===null||r===void 0)return[];throw new c(`${t}() first argument must be a flags property`)}function W(s){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:`${s}(): first argument must be a flags property reference (@name or @scope.name)`});return}let n=t.schema.properties.get(r.scope)?.get(r.name);if(n&&n.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:`${s}(): \'@${i}\' is not a flags property (got ${n.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:`${s}(): argument ${i+1} must be +flagName or -flagName`}):n?.type==="flags"&&n.enumValues&&!n.enumValues.includes(o.name)&&t.report({path:[...t.path,"args",i],kind:"unknown-flag-name",severity:"error",message:`${s}(): unknown flag \'${o.name}\'`,reference:o.name})}}}var ge=/^@[A-Za-z0-9_.]+$/;function*ue(s){let e="",t=0;for(;t<s.length;){let r=s[t];if(r==="{"&&s[t+1]==="{"){e+="{",t+=2;continue}if(r==="}"&&s[t+1]==="}"){e+="}",t+=2;continue}if(r==="{"){let n=s.indexOf("}",t+1);if(n!==-1){let i=s.slice(t,n+1),o=s.slice(t+1,n).trim();if(o.startsWith("@")){e&&(yield{kind:"text",value:e},e=""),yield{kind:"slot",raw:i,inner:o,ref:ge.test(o)?o:void 0},t=n+1;continue}e+=i,t=n+1;continue}}e+=r,t+=1}e&&(yield{kind:"text",value:e})}function fe(s){return Array.isArray(s)?s.join(", "):typeof s=="boolean"?s?"true":"false":String(s)}function he(s){return s===" "||s==="	"||s===`\n`||s==="\\r"||s==="\\f"||s==="\\v"}function me(s){let e="",t=!1;for(let r of s){if(he(r)){t=!0;continue}t&&e.length>0&&(e+=" "),t=!1,e+=r}return e}function K(s,e,t){if(e.length===0||s.indexOf(e)<0)return s;let r="",n=0,i=!1;for(;n<s.length;){if(s.startsWith(e,n)){let o=s.indexOf(t,n+e.length);if(o>=0){n=o+t.length,i=!0;continue}r+=s.slice(n);break}r+=s[n],n+=1}return i?me(r):s}function z(s,e){if(s.indexOf("{")<0)return s;let t="";for(let r of ue(s)){if(r.kind==="text"){t+=r.value;continue}if(!r.ref){t+=r.raw;continue}let n=e(r.ref);t+=n===void 0?"":fe(n)}return t}function k(s,e){for(let t of s){e(t);let r=t.children;r&&k(r,e)}}function Se(s){return s.toLowerCase().replace(/[\'\u2019]/g,"").replace(/[^a-z0-9-]+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function f(s){let e=s.gameId?.trim();return e||Se(s.name)}function V(s){return`cast:${s}`}var F={open:"[",close:"]"},X="SFX";function D(s){let e=new Set,t=[];for(let r of s)e.has(r)||(e.add(r),t.push(r));return t}function I(s){let e=new Map,t=(r,n)=>{let i=D([...n,...r.tags??[]]);if(e.set(r.id,i),r.type==="group")for(let o of r.children)t(o,i);else for(let o of r.beats??[])e.set(o.id,D([...i,...o.tags??[]]))};for(let r of Object.values(s.scenes)){let n=D(r.tags??[]);e.set(r.id,n);for(let i of r.blocks){let o=D([...n,...i.tags??[]]);e.set(i.id,o);for(let a of i.children)t(a,o)}}return e}var Z=new WeakMap,R=class s{host;defaultSeed;flowsById=new Map;allStrings;currentLocale;sourceDebug;sceneGameIdToId=new Map;blockGameIdToId=new Map;creationOptions;constructor(e,t={}){this.creationOptions=t;let r=t.locale??e.locales.default,n=e.strings;this.allStrings=n,this.currentLocale=r;let i=n[r]??{},o=n[e.locales.default]??{},a=e.localisation,p=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 d=new Map;for(let l of e.cast??[])l.displayName&&d.set(l.name,l.displayName);this.defaultSeed=(t.seed??2654435769)>>>0;let v=new Map,u=new Map,M=new Map;for(let[l,h]of Object.entries(e.scenes)){this.sceneGameIdToId.set(f(h),l);let y=new Map;for(let g of h.blocks)u.set(g.id,{sceneId:l}),M.set(g.id,g),y.set(f(g),g.id),k(g.children,H=>v.set(H.id,H));this.blockGameIdToId.set(l,y)}let j=e.properties??[],O=j.filter(l=>l.shared??!0).map(Q),se=j.filter(l=>!(l.shared??!0)).map(Q),ie=new Set(O.map(l=>l.name.toLowerCase())),B=new w().defineOwned("patter",O),L=new Set;if(t.world){let l=e.scopeRegistry?.scopes.find(y=>y.token==="world"),h=(l?.declarations??[]).map(Y);B.defineForeign("world",t.world,h,l?.writable??!0),L.add("world")}for(let l of e.scopeRegistry?.scopes??[]){if(L.has(l.token))continue;let h=(l.declarations??[]).map(Y);B.defineForeign(l.token,ve(l.declarations??[]),h,l.writable??!0)}let $=new Map;for(let[l,h]of Object.entries(e.scenes)){let y=new Set((h.sceneProps??[]).filter(g=>g.shared??!1).map(g=>g.name.toLowerCase()));$.set(l,y)}this.host={bundle:e,emitIds:p,strings:i,defaultStrings:o,castDisplay:d,nodeIndex:v,blockIndex:u,blockById:M,tagIndex:I(e),shared:B,patterSharedDecls:O,patterLocalDecls:se,patterSharedNames:ie,sceneSharedNames:$,sharedVisits:new Map,sharedSelectors:new Map,stageBags:new Map,customRng:t.rng,onDryChoice:t.onDryChoice,replayPromptOnChoose:t.replayPromptOnChoose??!1,captionsOn:t.closedCaptions??!0,captionOpen:(e.closedCaptions??F).open,captionClose:(e.closedCaptions??F).close,captionCharacter:e.closedCaptions?.character||X,refSplitCache:new Map}}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){let t=this.saveGame(),r=i=>(i.setLocale(this.currentLocale),i.setClosedCaptions(this.host.captionsOn),i),n=new s(e,this.creationOptions);try{return n.loadGame(t),r(n)}catch{let i=new s(e,this.creationOptions);for(let[o,a]of Object.entries(t.flows)){let p=a.cursor.currentSceneId;try{i.openFlow(o,p!==null?{scene:p}:{})}catch{}}return r(i)}}get closedCaptions(){return this.host.captionsOn}setClosedCaptions(e){this.host.captionsOn=e}openFlow(e,t={}){let r=this.resolveSceneRef(t.scene),n=this.resolveBlockRef(r,t.block),i=new b(e,this.host,t.seed??this.defaultSeed);return this.flowsById.set(e,i),i.start(r,n),i}resolveSceneRef(e){if(e!=null)return this.host.bundle.scenes[e]?e:this.sceneGameIdToId.get(e)??e}resolveBlockRef(e,t){if(t!=null){if(this.host.blockById.has(t))return t;if(e!=null){let r=this.blockGameIdToId.get(e)?.get(t);if(r)return r}return t}}sceneAddress(e){let t=this.host.bundle.scenes[e];return t?f(t):void 0}blockAddress(e){let t=this.host.blockById.get(e);return t?f(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),n=this.resolveBlockRef(r,t);return(n!=null?this.host.tagIndex.get(n):void 0)??[]}getOutline(){return Object.values(this.host.bundle.scenes).map(e=>({id:e.id,...f(e)?{gameId:f(e)}:{},name:e.name,...this.tagsField(e.id),blocks:e.blocks.map(t=>({id:t.id,...f(t)?{gameId:f(t)}:{},name:t.name,...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)k(r.children,n=>{if(n.type==="snippet")for(let i of n.beats??[])e.push({sceneId:t.id,blockId:r.id,snippetId:n.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 n=this.host.defaultStrings[V(e.character)]??this.host.castDisplay.get(e.character);n!==void 0&&(r.characterName=n)}e.direction!==void 0&&(r.direction=e.direction)}if(e.kind==="line"||e.kind==="text"){let n=this.host.defaultStrings[e.id];n!==void 0&&(r.text=n)}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()]}closeFlow(e){this.flowsById.delete(e)}reset(){this.flowsById.clear(),this.host.shared.reseedOwned("patter",this.host.patterSharedDecls),this.host.sharedVisits.clear(),this.host.sharedSelectors.clear(),this.host.stageBags.clear()}getProperty(e){let{scope:t,name:r}=this.splitShared(e);return this.host.shared.get(t,r)}setProperty(e,t){let{scope:r,name:n}=this.splitShared(e);this.host.shared.set(r,n,t)}listProperties(){return this.host.patterSharedDecls.map(e=>({ref:`@${e.name}`,type:e.type,values:e.values,value:this.getProperty(`@${e.name}`),default:ye(e)}))}splitShared(e){let t=this.host.refSplitCache.get(e);if(t||(t=A(e,r=>r==="scene"||this.host.shared.has(r)),this.host.refSplitCache.set(e,t)),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 this.host.shared.save()}load(e){this.host.shared.load(e)}saveGame(){let e={};for(let[t,r]of this.flowsById)e[t]=r.snapshot();return{version:2,shared:this.host.shared.save(),sharedVisits:Object.fromEntries(this.host.sharedVisits),sharedSelectors:ee(this.host.sharedSelectors),stageBags:Object.fromEntries([...this.host.stageBags].map(([t,r])=>[t,{...r}])),flows:e}}loadGame(e){if(e.version!==2)throw new Error(`unsupported save version: ${e.version}`);this.host.shared.load(e.shared),this.host.sharedVisits.clear();for(let[t,r]of Object.entries(e.sharedVisits??{}))this.host.sharedVisits.set(t,r);this.host.sharedSelectors.clear();for(let[t,r]of te(e.sharedSelectors))this.host.sharedSelectors.set(t,r);this.host.stageBags.clear();for(let[t,r]of Object.entries(e.stageBags??{}))this.host.stageBags.set(t,{...r});this.flowsById.clear();for(let[t,r]of Object.entries(e.flows)){let n=new b(t,this.host,this.defaultSeed);n.restore(r),this.flowsById.set(t,n)}}},b=class{id;host;local;rngState;started=!1;flowEnded=!1;currentSceneId=null;stack=[];activeSnippet=null;beatIndex=0;pendingChoice=null;pendingPromptBeat=null;pendingPromptOwnerId=null;selectors=new Map;visitCounts=new Map;sceneBags=new Map;patterResolver={get:e=>this.host.patterSharedNames.has(e)?this.host.shared.get("patter",e):this.local.get("patter",e),set:(e,t)=>{this.host.patterSharedNames.has(e)?this.host.shared.set("patter",e,t):this.local.set("patter",e,t)}};sceneResolver={get:e=>{let t=this.currentSceneId;return t===null?void 0:(this.host.sceneSharedNames.get(t)?.has(e)?this.host.stageBags.get(t):this.sceneBags.get(t))?.[e]},set:(e,t)=>{let r=this.currentSceneId;if(r===null)return;let n=this.host.sceneSharedNames.get(r)?.has(e)?this.host.stageBags.get(r):this.sceneBags.get(r);n&&(n[e]=t)}};evalCtx;constructor(e,t,r){this.id=e,this.host=t,this.rngState=r>>>0,this.local=this.freshLocal();let n={...t.shared.toEvalContext().scopes};n.patter=this.patterResolver,n.scene=this.sceneResolver,this.evalCtx={scopes:n,host:{nextRandom:this.rng,visits:i=>this.visitCounts.get(i)??0,patterVisits:i=>this.host.sharedVisits.get(i)??0}}}start(e,t){if(this.sceneBags.clear(),this.local=this.freshLocal(),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],n=r?this.host.bundle.scenes[r]:void 0;if(!n)throw new Error(r?`unknown scene: ${r}`:"no scenes in bundle");this.enterSceneSetup(r);let i=n.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)}get currentScene(){return this.currentSceneId}advance(){if(!this.started)throw new Error("flow has not been started");if(this.pendingPromptBeat){let e=this.pendingPromptBeat;return this.pendingPromptBeat=null,this.pendingPromptOwnerId=null,this.beatResult(e)}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);let n=this.activeSnippet.jump;this.activeSnippet=null,this.beatIndex=0,this.resolveJump(n);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}for(;t.index<r.length&&!this.eligible(r[t.index]);)t.index++;if(t.index>=r.length){this.stack.pop();continue}this.enterChild(r[t.index++])}}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(i=>i.id===e);if(!r)throw new Error(`unknown choice option: ${e}`);if(!r.eligible)throw new Error(`choice option is not eligible: ${e}`);let n=t.byId.get(e);this.pendingChoice=null,this.pendingPromptBeat=this.host.replayPromptOnChoose?this.promptBeatOf(n)??null:null,this.pendingPromptOwnerId=this.pendingPromptBeat?n.id:null,this.enterChild(n)}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.shared.get(t,r)}setProperty(e,t){let{scope:r,name:n}=this.splitRef(e);if(r==="patter")this.patterResolver.set(n,t);else if(r==="scene"){if(this.currentSceneId===null)throw new Error(`\'${e}\': the flow has not entered a scene yet`);this.sceneResolver.set(n,t)}else this.host.shared.set(r,n,t)}snapshot(){return{scopes:this.local.save(),sceneBags:Object.fromEntries([...this.sceneBags].map(([e,t])=>[e,{...t}])),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,selectors:ee(this.selectors)}}}restore(e){this.rngState=e.rngState>>>0,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:n,...i}=r;if(n!==void 0){let o=this.childrenOf(i.containerId)?.findIndex(a=>a.id===n)??-1;if(o>=0)return{...i,index:o}}return{...i}}),this.sceneBags=new Map(Object.entries(e.sceneBags??{}).map(([r,n])=>[r,{...n}])),this.local=this.freshLocal(),this.local.load(e.scopes),this.activeSnippet=null,t.activeSnippetId!==null){let r=this.host.nodeIndex.get(t.activeSnippetId);r&&r.type==="snippet"&&(this.activeSnippet=r)}if(this.selectors=te(t.selectors),this.pendingChoice=null,t.pendingChoice!==null){let r=new Map,n=[];for(let i of t.pendingChoice.options){let o=this.host.nodeIndex.get(i.id);o&&(r.set(i.id,o),n.push({...i}))}n.length>0&&(this.pendingChoice={groupId:t.pendingChoice.groupId,options:n,byId:r})}if(this.pendingPromptBeat=null,this.pendingPromptOwnerId=t.pendingPromptOwnerId??null,this.pendingPromptOwnerId){let r=this.host.nodeIndex.get(this.pendingPromptOwnerId);this.pendingPromptBeat=r?this.promptBeatOf(r)??null:null,this.pendingPromptBeat||(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)}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),this.activeSnippet=e,this.beatIndex=0}setupChoice(e){let t=[],r=new Map,n=[];for(let o of e.children){if(o.fallback===!0){n.push(o);continue}if(o.sticky!==!0&&(this.visitCounts.get(o.id)??0)>=1)continue;let a=this.eligible(o),p=o.secretUntilEligible===!0;!a&&p||(t.push({id:o.id,prompt:this.promptFor(o),eligible:a,gameData:o.gameData}),r.set(o.id,o))}if(t.length>0){this.pendingChoice={groupId:e.id,options:t,byId:r};return}let i=n.find(o=>this.eligible(o));if(i){this.enterChild(i);return}this.host.onDryChoice?.(e.id)}resolveJump(e){e&&this.enterTarget(e.to,e.mode==="call"?"call":"jump")}enterTarget(e,t){if(e==="END"){this.flowEnded=!0,this.stack=[];return}let r,n,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,n=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,n=e}this.enter(n);let o={sceneId:r,containerId:n,index:0};t==="call"?this.stack.push(o):this.stack=[o]}selectChild(e){let t=e.children.filter(n=>this.eligible(n));if(t.length===0)return null;let r=this.selectorState(e);switch(e.selector){case"branch":return t[0];case"sequence":{let n=e.options?.order??"sequential",i=e.options?.exhaust??"once";return n==="shuffle"?this.pickShuffle(t,i,r):this.pickSequential(t,i,r)}default:return null}}pickSequential(e,t,r){let n=e.length,i=r.seq??0;return r.seq=i+1,t==="repeat"?e[i%n]:i<n?e[i]:t==="stick"?e[n-1]:null}pickShuffle(e,t,r){let n=e.length,i=t==="stick",o=()=>(i?e.slice(0,n-1):e).map(u=>u.id);if(r.bag===void 0&&(r.bag=o()),r.bag.length===0){if(t==="once")return null;if(i){let u=e[n-1];return r.last=u.id,u}r.bag=o()}let a=r.bag,p=r.last!==void 0&&a.length>1?a.indexOf(r.last):-1,d=Math.floor(this.rng()*(p>=0?a.length-1:a.length));p>=0&&d>=p&&d++;let v=a[d];return a.splice(d,1),r.last=v,e.find(u=>u.id===v)}selectorState(e){let t=e.shared?this.host.sharedSelectors:this.selectors,r=t.get(e.id);return r||(r={},t.set(e.id,r)),r}runEffects(e){for(let t of e??[])this.setProperty(t.target,this.evalExpr(t.value))}eligible(e){return e.condition?we(this.evalExpr(e.condition)):!0}evalExpr(e){let t=Z.get(e);return t||(t=m(e.ast),Z.set(e,t)),P(t,this.evalCtx,J)}enter(e){this.visitCounts.set(e,(this.visitCounts.get(e)??0)+1),this.host.sharedVisits.set(e,(this.host.sharedVisits.get(e)??0)+1)}rng=()=>{if(this.host.customRng)return this.host.customRng();let e=this.rngState+1831565813|0;this.rngState=e;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};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 n=this.resolveString(e.id),i=!this.host.captionsOn,a=i&&e.character===this.host.captionCharacter?"":this.captionLine(this.host.bundle.voiced?n:this.interpolate(n)),p=i&&a.length===0;return{type:"line",id:e.id,text:a,character:p?void 0:e.character,characterName:p?void 0:this.resolveCharacterName(e.character),direction:p?void 0:e.direction,gameData:e.gameData,...r}}}}interpolate(e){return z(e,t=>this.getProperty(t))}stripCaptions(e){return K(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}}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 k(e,r=>{!t&&r.type==="snippet"&&(r.beats??[]).some(n=>n.kind==="line"||n.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=V(e);return this.host.strings[t]??this.host.defaultStrings[t]??this.host.castDisplay.get(e)}splitRef(e){let t=this.host.refSplitCache.get(e);return t||(t=A(e,r=>r==="scene"||this.host.shared.has(r)),this.host.refSplitCache.set(e,t)),t}freshLocal(){return new w().defineOwned("patter",this.host.patterLocalDecls)}seedScene(e){let t=this.host.sceneSharedNames.get(e.id)??new Set;if(!this.sceneBags.has(e.id)){let r={};for(let n of e.sceneProps??[]){let i=n.name.toLowerCase();t.has(i)||(r[i]=T(n))}this.sceneBags.set(e.id,r)}if(!this.host.stageBags.has(e.id)){let r={};for(let n of e.sceneProps??[]){let i=n.name.toLowerCase();t.has(i)&&(r[i]=T(n))}this.host.stageBags.set(e.id,r)}for(let r of e.sceneProps??[]){if(!r.temporary)continue;let n=r.name.toLowerCase(),i=t.has(n)?this.host.stageBags.get(e.id):this.sceneBags.get(e.id);i&&(i[n]=T(r))}}};function ee(s){let e={};for(let[t,r]of s){let n={};r.seq!==void 0&&(n.seq=r.seq),r.bag&&(n.bag=[...r.bag]),r.last!==void 0&&(n.last=r.last),e[t]=n}return e}function te(s){let e=new Map;for(let[t,r]of Object.entries(s??{})){let n={};r.seq!==void 0&&(n.seq=r.seq),r.bag&&(n.bag=[...r.bag]),r.last!==void 0&&(n.last=r.last),e.set(t,n)}return e}function Q(s){return{name:s.name,type:s.type,values:s.values,default:s.default}}function ye(s){if(s.default!==void 0)return s.default;switch(s.type){case"number":return 0;case"string":return"";case"flags":return[];case"enum":return s.values?.[0]??"";default:return!1}}function Y(s){return{name:s.name,type:s.type,values:s.values,default:s.default,writable:s.writable}}function be(s){if(s.default!==void 0)return s.default;switch(s.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"flags":return[];case"enum":return s.values?.[0]??""}}function ve(s){let e=new Map;for(let t of s)e.set(t.name,be(t));return{get:t=>e.get(t),set:(t,r)=>{e.set(t,r)}}}function T(s){if(s.default!==void 0)return s.default;switch(s.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"flags":return[];case"enum":return s.values?.[0]??""}}function we(s){return typeof s=="boolean"?s:typeof s=="number"?s!==0:typeof s=="string"?s!=="":s.length>0}function re(s,e){return s.gameDataFields?.[e]??[]}function G(s,e,t){return e&&Object.prototype.hasOwnProperty.call(e,t)?e[t]:s.find(r=>r.name===t)?.default}function ne(s,e){let t={};for(let r of s){let n=G(s,e,r.name);n!==void 0&&(t[r.name]=n)}for(let[r,n]of Object.entries(e??{}))r in t||(t[r]=n);return t}return de(xe);})();\n//# sourceMappingURL=patterplay.min.js.map';
+
+// src/export-html.ts
+var esc = (s) => s.replace(/[&<>]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;" })[c]);
+var PLAYER_JS = String.raw`
+(function () {
+  var Engine = window.Patterplay.Engine;
+  var BUNDLE = window.PATTER_BUNDLE;
+  var startScene = (BUNDLE.start && BUNDLE.start.scene) || Object.keys(BUNDLE.scenes)[0];
+  var SAVE_KEY = "patter.play." + ((BUNDLE.content && BUNDLE.content.hash) || "x");
+
+  var stage = document.getElementById("stage");
+  var controls = document.getElementById("controls");
+  var engine, flow;
+
+  // Stable per-character hue (same idea as the editor's colour-by-character), tinted for a light page.
+  function hueOf(name) { var h = 0; for (var i = 0; i < (name || "").length; i++) h = (h * 31 + name.charCodeAt(i)) % 360; return h; }
+  function add(cls, html) { var d = document.createElement("div"); d.className = cls; d.innerHTML = html; stage.appendChild(d); return d; }
+  function esc(s) { return String(s == null ? "" : s).replace(/[&<>]/g, function (c) { return { "&": "&amp;", "<": "&lt;", ">": "&gt;" }[c]; }); }
+
+  // Pacing: a source-only reader carries no audio, so each line is held on screen for a reading-length delay
+  // (proportional to its word count) before the next appears, and every line fades in (see CSS). The Speed
+  // control sets the reading pace (words/min); "Instant" drops the delay entirely. The choice is persisted.
+  // A run token cancels an in-flight paced read the moment the player restarts, loads, or picks a choice.
+  var SPEED_WPM = { slow: 300, normal: 500, fast: 800, instant: 0 }, runToken = 0;
+  var speedKey = (function () { try { return localStorage.getItem("patter.playSpeed") || "normal"; } catch (e) { return "normal"; } })();
+  if (SPEED_WPM[speedKey] === undefined) speedKey = "normal";
+  function fakeDuration(text) {
+    var wpm = SPEED_WPM[speedKey];
+    if (!wpm) return 0; // "Instant" - reveal the next line immediately
+    var words = String(text == null ? "" : text).trim().split(/\s+/).filter(Boolean).length;
+    return Math.max(450, Math.round((words / wpm) * 60000)); // a beat needs to land
+  }
+  function scrollDown() { window.scrollTo(0, document.body.scrollHeight); }
+  var speedSel = document.getElementById("speed");
+  if (speedSel) {
+    speedSel.value = speedKey; // a fresh fakeDuration() reads speedKey each line, so a change applies next line
+    speedSel.onchange = function () { speedKey = speedSel.value; try { localStorage.setItem("patter.playSpeed", speedKey); } catch (e) {} };
+  }
+
+  function build() { engine = new Engine(BUNDLE); flow = engine.openFlow("main", { scene: startScene }); }
+
+  function newGame() { stage.innerHTML = ""; controls.innerHTML = ""; build(); run(); }
+
+  function run() {
+    controls.innerHTML = "";
+    var token = ++runToken;
+    (function step() {
+      if (token !== runToken) return; // superseded by a restart / load / choice pick
+      var s = flow.advance();
+      if (!s) { add("end", "The End"); return; } // defensive: a step should always be returned; never hard-crash
+      if (s.type === "line") {
+        var who = s.characterName || s.character || "";
+        var dir = s.direction ? '<em class="dir">(' + esc(s.direction) + ')</em> ' : "";
+        add("line", '<span class="who" style="color:hsl(' + hueOf(s.character || who) + ',55%,38%)">' + esc(who) + '</span>' + dir + esc(s.text));
+        scrollDown(); setTimeout(step, fakeDuration(s.text));
+      } else if (s.type === "text") {
+        add("text", esc(s.text)); scrollDown(); setTimeout(step, fakeDuration(s.text));
+      } else if (s.type === "choice") { renderChoice(s); }
+      else if (s.type === "end") { add("end", "The End"); }
+      else { step(); } // game-event beat: a host cue with no player-facing text - skip it, advance at once
+    })();
+  }
+
+  function renderChoice(step) {
+    var opts = step.options || [];
+    if (!opts.length) { add("end", "The End"); return; }
+    for (var i = 0; i < opts.length; i++) (function (opt, idx) {
+      var b = document.createElement("button");
+      b.className = "choice"; b.textContent = (opt.prompt && opt.prompt.text) || "(continue)";
+      b.disabled = opt.eligible === false;
+      b.style.animationDelay = (idx * 60) + "ms"; // gentle stagger so the options fade in one after another
+      b.onclick = function () { flow.choose(opt.id); scrollDown(); run(); };
+      controls.appendChild(b);
+    })(opts[i], i);
+    scrollDown();
+  }
+
+  document.getElementById("restart").onclick = newGame;
+  document.getElementById("save").onclick = function () { try { localStorage.setItem(SAVE_KEY, JSON.stringify(engine.saveGame())); flash("Saved"); } catch (e) {} };
+  document.getElementById("load").onclick = function () {
+    var blob; try { blob = localStorage.getItem(SAVE_KEY); } catch (e) {}
+    if (!blob) { flash("No save yet"); return; }
+    engine = new Engine(BUNDLE);
+    engine.loadGame(JSON.parse(blob)); flow = engine.getFlow("main");
+    stage.innerHTML = ""; add("text", "(resumed from save)"); run();
+  };
+  function flash(msg) { var f = document.getElementById("flash"); f.textContent = msg; f.style.opacity = "1"; setTimeout(function () { f.style.opacity = "0"; }, 1100); }
+
+  newGame();
+})();
+`;
+var STYLE = String.raw`
+  :root { color-scheme: light; }
+  * { box-sizing: border-box; }
+  body { margin: 0; background: #f6f1e7; color: #2b2620; font: 18px/1.65 Georgia, "Times New Roman", serif; }
+  .wrap { max-width: 42rem; margin: 0 auto; padding: 1.5rem 1.25rem 6rem; }
+  header { display: flex; align-items: baseline; gap: 0.75rem; border-bottom: 1px solid #e0d7c5; padding-bottom: 0.75rem; margin-bottom: 1.25rem; }
+  h1 { font-size: 1.15rem; margin: 0; font-weight: 600; }
+  header .by { color: #9a8f78; font-size: 0.8rem; font-family: ui-sans-serif, system-ui, sans-serif; margin-left: auto; }
+  #stage > div { margin: 0.55rem 0; animation: fade 0.45s ease-out both; }
+  @keyframes fade { from { opacity: 0; transform: translateY(4px); } to { opacity: 1; transform: none; } }
+  @media (prefers-reduced-motion: reduce) { #stage > div, .choice { animation: none; } }
+  .line .who { font-weight: 700; font-family: ui-sans-serif, system-ui, sans-serif; font-size: 0.8rem; letter-spacing: 0.02em; text-transform: uppercase; margin-right: 0.4rem; }
+  .line .dir { color: #9a8f78; font-style: italic; }
+  .text { color: #4a4334; }
+  .end { color: #9a8f78; font-style: italic; text-align: center; margin-top: 1.5rem; }
+  #controls { margin: 1.25rem 0; display: flex; flex-direction: column; gap: 0.5rem; }
+  .choice { font: 1rem Georgia, serif; text-align: left; background: #fff; border: 1px solid #d9cfbb; border-radius: 8px; padding: 0.55rem 0.8rem; cursor: pointer; transition: border-color .15s, background .15s; animation: fade 0.4s ease-out both; }
+  .choice:hover:not(:disabled) { border-color: #b8956a; background: #fffaf0; }
+  .choice:disabled { color: #b8af9b; cursor: default; }
+  .bar { position: fixed; bottom: 0; left: 0; right: 0; background: rgba(246,241,231,0.94); border-top: 1px solid #e0d7c5; backdrop-filter: blur(4px); }
+  .bar .inner { max-width: 42rem; margin: 0 auto; padding: 0.6rem 1.25rem; display: flex; gap: 0.5rem; align-items: center; }
+  .bar button { font: 0.85rem ui-sans-serif, system-ui, sans-serif; background: #fff; border: 1px solid #d9cfbb; border-radius: 6px; padding: 0.3rem 0.7rem; cursor: pointer; }
+  .bar button:hover { border-color: #b8956a; }
+  .bar .speedlabel { font: 0.8rem ui-sans-serif, system-ui, sans-serif; color: #9a8f78; display: flex; align-items: center; gap: 0.3rem; }
+  .bar #speed { font: 0.85rem ui-sans-serif, system-ui, sans-serif; background: #fff; border: 1px solid #d9cfbb; border-radius: 6px; padding: 0.3rem 0.4rem; cursor: pointer; color: #2b2620; }
+  .bar #speed:hover { border-color: #b8956a; }
+  #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 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 = canonicalStringify(bundle, { trailingComma: false }).replace(/</g, "\\u003c");
+  return { title, lang: def, bundleJson };
+}
+function page(title, lang, head, tail) {
+  return `<!doctype html>
+<html lang="${esc(lang)}">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>${esc(title)}</title>
+${head}
+</head>
+<body>
+<div class="wrap">
+  <header>
+    <h1>${esc(title)}</h1>
+    <span class="by">Patter</span>
+  </header>
+  <main id="stage"></main>
+  <div id="controls"></div>
+</div>
+<div class="bar"><div class="inner">
+  <button id="restart">\u21BA Restart</button>
+  <button id="save">Save</button>
+  <button id="load">Load</button>
+  <label class="speedlabel">Speed
+    <select id="speed" title="Reading speed: how long each line is held before the next appears">
+      <option value="slow">Slow</option>
+      <option value="normal">Normal</option>
+      <option value="fast">Fast</option>
+      <option value="instant">Instant</option>
+    </select>
+  </label>
+  <span id="flash"></span>
+</div></div>
+${tail}
+</body>
+</html>
+`;
+}
+function runExportHtml(loaded) {
+  const { title, lang, bundleJson } = sourceStory(loaded);
+  return page(
+    title,
+    lang,
+    `<style>${STYLE}</style>`,
+    `<script>${PLAYABLE_RUNTIME_JS}</script>
+<script>window.PATTER_BUNDLE=${bundleJson};</script>
+<script>${PLAYER_JS}</script>`
+  );
+}
+function runExportWeb(loaded) {
+  const { title, lang, bundleJson } = sourceStory(loaded);
+  return {
+    indexHtml: page(
+      title,
+      lang,
+      `<link rel="stylesheet" href="style.css" />`,
+      // The story must load first (patterplay.js reads window.PATTER_BUNDLE as it starts).
+      `<script src="story.js"></script>
+<script src="patterplay.js"></script>`
+    ),
+    styleCss: `${STYLE.trim()}
+`,
+    patterplayJs: `${PLAYABLE_RUNTIME_JS}
+${PLAYER_JS}`,
+    storyJs: `window.PATTER_BUNDLE=${bundleJson};
+`
+  };
+}
+
+// src/audio-scan.ts
+import { readdirSync as readdirSync2 } from "fs";
+import { resolve as resolve2, extname, basename as basename3 } 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 = readdirSync2(resolve2(loaded.root, rung.folder));
+    } catch {
+      continue;
+    }
+    for (const f of files) {
+      const ext = extname(f).toLowerCase();
+      if (AUDIO_EXT.has(ext)) out.set(basename3(f, extname(f)), rung.name);
+    }
+  }
+  return out;
+}
+
+// src/play.ts
+import { exportBundle as exportBundle3 } from "@patterkit/compiler";
+import { Engine } from "@patterkit/runtime";
+
+// src/loaded-helpers.ts
+function tableFor(loaded, locale) {
+  const table = {};
+  for (const l of loaded.locales) if (l.locale === locale) Object.assign(table, l.strings);
+  return table;
+}
+function sourceStrings(loaded) {
+  return tableFor(loaded, loaded.project.locales.default);
+}
+function resolveStart(loaded, override) {
+  if (override?.scene) return { scene: override.scene, block: override.block };
+  if (loaded.project.start) return { scene: loaded.project.start.scene, block: loaded.project.start.block };
+  return {};
+}
+function stringsByLocale(loaded) {
+  const byLocale = /* @__PURE__ */ new Map();
+  for (const l of loaded.locales) {
+    const table = byLocale.get(l.locale) ?? {};
+    Object.assign(table, l.strings);
+    byLocale.set(l.locale, table);
+  }
+  return byLocale;
+}
+function mergeAuthoring(loaded) {
+  const writing = /* @__PURE__ */ new Map();
+  const recording = /* @__PURE__ */ new Map();
+  const cut = /* @__PURE__ */ new Set();
+  const documentation = /* @__PURE__ */ new Map();
+  const edits = /* @__PURE__ */ new Map();
+  for (const a of loaded.authoring) {
+    for (const [id, v] of Object.entries(a.writing ?? {})) writing.set(id, v);
+    for (const [id, v] of Object.entries(a.recording ?? {})) recording.set(id, v);
+    for (const [id, v] of Object.entries(a.cut ?? {})) if (v) cut.add(id);
+    for (const [id, lines] of Object.entries(a.documentation ?? {})) {
+      const cur = documentation.get(id);
+      if (cur) cur.push(...lines);
+      else documentation.set(id, [...lines]);
+    }
+    for (const [id, v] of Object.entries(a.edits ?? {})) edits.set(id, v);
+  }
+  return { writing, recording, cut, documentation, edits };
+}
+
+// src/play.ts
+function runPlay(loaded, opts = {}) {
+  const bundle = exportBundle3({ project: loaded.project, scenes: loaded.scenes, locales: loaded.locales });
+  const events = [];
+  const engine = new Engine(bundle, { seed: opts.seed });
+  const start = resolveStart(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);
+    }
+  }
+  return { events, outcome: "max-steps" };
+}
+function renderPlay(result) {
+  const out = [];
+  for (const e of result.events) {
+    switch (e.type) {
+      case "line":
+        out.push(`${e.character ?? "?"}: ${e.text}`);
+        break;
+      case "text":
+        out.push(`  ${e.text}`);
+        break;
+      case "gameEvent":
+        out.push(`    (game event ${JSON.stringify(e.gameData ?? {})})`);
+        break;
+      case "choice":
+        for (const o of e.options) out.push(`    ${o.eligible ? "[ ]" : "[x]"} ${o.prompt?.text ?? "(no label)"}  (${o.id})`);
+        if (e.picked !== void 0) out.push(`    > ${e.picked}`);
+        break;
+    }
+  }
+  switch (result.outcome) {
+    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;
+  }
+  return out;
+}
+
+// src/coverage.ts
+import { exportBundle as exportBundle4 } from "@patterkit/compiler";
+import { Engine as Engine2 } from "@patterkit/runtime";
+import { walkNodes } from "@patterkit/model";
+
+// ../../../expr/packages/expr/src/ast.ts
+function deserialiseAst(node) {
+  switch (node[0]) {
+    case "b":
+      return { kind: "bool", value: node[1] };
+    case "n":
+      return { kind: "number", value: node[1] };
+    case "s":
+      return { kind: "string", value: node[1] };
+    case "sv":
+      return { kind: "scopedvar", scope: node[1], name: node[2] };
+    case "u":
+      return { kind: "unary", op: node[1], operand: deserialiseAst(node[2]) };
+    case "bin":
+      return { kind: "binary", op: node[1], left: deserialiseAst(node[2]), right: deserialiseAst(node[3]) };
+    case "call": {
+      const args = node.slice(2).map(deserialiseAst);
+      return { kind: "call", name: node[1], args };
+    }
+    case "fd":
+      return { kind: "flagdelta", sign: node[1], name: node[2] };
+  }
+}
+
+// src/coverage.ts
+var CADENCE_PROB = {
+  rarely: 0.15,
+  sometimes: 0.4,
+  often: 0.8
+};
+function mulberry32(seed) {
+  let a = seed >>> 0;
+  return () => {
+    a = a + 1831565813 | 0;
+    let t = Math.imul(a ^ a >>> 15, 1 | a);
+    t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+  };
+}
+function scanExpr(node, hostTokens, refs, proposals) {
+  const refOf = (n) => n.kind === "scopedvar" && hostTokens.has(n.scope) ? `@${n.scope}.${n.name}` : void 0;
+  const propose = (ref, v) => (proposals.get(ref) ?? proposals.set(ref, /* @__PURE__ */ new Set()).get(ref)).add(v);
+  switch (node.kind) {
+    case "scopedvar": {
+      const r = refOf(node);
+      if (r) {
+        refs.add(r);
+        proposals.get(r) ?? proposals.set(r, /* @__PURE__ */ new Set());
+      }
+      break;
+    }
+    case "unary":
+      scanExpr(node.operand, hostTokens, refs, proposals);
+      break;
+    case "binary": {
+      for (const [a, b] of [[node.left, node.right], [node.right, node.left]]) {
+        const ref = refOf(a);
+        if (!ref) continue;
+        if (b.kind === "number") {
+          for (const d of [-1, 0, 1]) propose(ref, b.value + d);
+        } else if (b.kind === "string") propose(ref, b.value);
+        else if (b.kind === "bool") propose(ref, b.value);
+      }
+      scanExpr(node.left, hostTokens, refs, proposals);
+      scanExpr(node.right, hostTokens, refs, proposals);
+      break;
+    }
+    case "call":
+      for (const a of node.args) scanExpr(a, hostTokens, refs, proposals);
+      break;
+  }
+}
+function targetHostRef(target, hostTokens) {
+  const m = /^@([A-Za-z_][\w]*)\.(.+)$/.exec(target);
+  return m && hostTokens.has(m[1]) ? `@${m[1]}.${m[2]}` : void 0;
+}
+function analyzeHostScopes(bundle, hostTokens) {
+  const written = /* @__PURE__ */ new Set();
+  const gatesByBeat = /* @__PURE__ */ new Map();
+  const proposals = /* @__PURE__ */ new Map();
+  if (hostTokens.size === 0) return { written, gatesByBeat, proposals };
+  const refsIn = (expr) => {
+    const refs = /* @__PURE__ */ new Set();
+    if (expr) scanExpr(deserialiseAst(expr.ast), hostTokens, refs, proposals);
+    return refs;
+  };
+  const scanEffects = (effects) => {
+    for (const e of effects ?? []) {
+      const t = targetHostRef(e.target, hostTokens);
+      if (t) written.add(t);
+      refsIn(e.value);
+    }
+  };
+  const walk = (nodes, gate) => {
+    for (const node of nodes) {
+      const here = /* @__PURE__ */ new Set([...gate, ...refsIn(node.condition)]);
+      if (node.type === "group") {
+        walk(node.children, here);
+      } else {
+        scanEffects(node.onEnter);
+        scanEffects(node.onExit);
+        for (const beat of node.beats ?? []) gatesByBeat.set(beat.id, here);
+      }
+    }
+  };
+  for (const scene of Object.values(bundle.scenes)) {
+    scanEffects(scene.onEntry);
+    for (const block of scene.blocks) walk(block.children, /* @__PURE__ */ new Set());
+  }
+  return { written, gatesByBeat, proposals };
+}
+function proposeCoverageDrivers(loaded) {
+  const hostTokens = new Set((loaded.project.scopeRegistry?.scopes ?? []).map((s) => s.token));
+  if (hostTokens.size === 0) return [];
+  const bundle = exportBundle4({ project: loaded.project, scenes: loaded.scenes, locales: loaded.locales });
+  const { written, proposals } = analyzeHostScopes(bundle, hostTokens);
+  const declByRef = /* @__PURE__ */ new Map();
+  for (const s of loaded.project.scopeRegistry?.scopes ?? []) {
+    for (const d of s.declarations ?? []) declByRef.set(`@${s.token}.${d.name}`, { type: d.type, values: d.values });
+  }
+  const drivers = [];
+  for (const [ref, pool] of proposals) {
+    if (written.has(ref)) continue;
+    const decl = declByRef.get(ref);
+    let values = [...pool];
+    if (values.length === 0 && decl) {
+      if (decl.type === "boolean") values = [true, false];
+      else if (decl.type === "enum" && decl.values) values = [...decl.values];
+    }
+    if (values.length === 0) continue;
+    drivers.push({ ref, kind: "recurring", cadence: "sometimes", values: sortValues(values) });
+  }
+  return drivers.sort((a, b) => a.ref.localeCompare(b.ref));
+}
+function sortValues(values) {
+  return [...values].sort((a, b) => {
+    if (typeof a === "number" && typeof b === "number") return a - b;
+    return String(a).localeCompare(String(b));
+  });
+}
+function runCoverage(loaded, options = {}, hooks = {}) {
+  const runs = options.runs ?? 5e3;
+  const maxSteps = options.maxSteps ?? 200;
+  const seed = options.seed ?? 0;
+  const start = resolveStart(loaded, options);
+  const src = sourceStrings(loaded);
+  const order = [];
+  const meta = /* @__PURE__ */ new Map();
+  const choiceScene = /* @__PURE__ */ new Map();
+  for (const scene of loaded.scenes) {
+    for (const block of scene.blocks) {
+      walkNodes(block.children, (node) => {
+        if (node.type === "group") {
+          if (node.selector === "choice") choiceScene.set(node.id, scene.id);
+          return;
+        }
+        for (const beat of node.beats ?? []) {
+          if (meta.has(beat.id)) continue;
+          order.push(beat.id);
+          meta.set(beat.id, {
+            scene: scene.id,
+            kind: beat.kind,
+            character: beat.kind === "line" ? beat.character : void 0,
+            preview: beat.kind === "gameEvent" ? "(game event)" : src[beat.id] ?? ""
+          });
+        }
+      });
+    }
+  }
+  const hitCount = new Map(order.map((id) => [id, 0]));
+  const reachedRuns = new Map(order.map((id) => [id, 0]));
+  const dryRuns = /* @__PURE__ */ new Map();
+  const termination = { ended: 0, capped: 0, stalled: 0, evalError: 0 };
+  const bundle = exportBundle4({ project: loaded.project, scenes: loaded.scenes, locales: loaded.locales });
+  const rng = mulberry32(seed);
+  const hostTokens = new Set((loaded.project.scopeRegistry?.scopes ?? []).map((s) => s.token));
+  const analysis = analyzeHostScopes(bundle, hostTokens);
+  const drivers = (options.drivers ?? loaded.project.coverageDrivers ?? []).filter(
+    (d) => d.values.length > 0 && hostTokens.has(d.ref.replace(/^@/, "").split(".")[0] ?? "")
+  );
+  const initialDrivers = drivers.filter((d) => d.kind === "initial");
+  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)];
+  let executed = 0;
+  let cancelled = false;
+  for (let run = 0; run < runs; run++) {
+    if (hooks.signal?.aborted) {
+      cancelled = true;
+      break;
+    }
+    const dryThisRun = /* @__PURE__ */ new Set();
+    const engine = new Engine2(bundle, {
+      seed: Math.floor(rng() * 4294967296),
+      onDryChoice: (groupId) => dryThisRun.add(groupId)
+    });
+    for (const d of initialDrivers) engine.setProperty(d.ref, pick(d.values));
+    const flow = engine.openFlow("cov", { scene: start.scene, block: start.block });
+    const seenThisRun = /* @__PURE__ */ new Set();
+    let term = "capped";
+    try {
+      for (let step = 0; step < maxSteps; step++) {
+        const r = flow.advance();
+        if (r.type === "end") {
+          term = "ended";
+          break;
+        }
+        if (r.type === "choice") {
+          for (const d of recurringDrivers) {
+            if (rng() < CADENCE_PROB[d.cadence ?? "sometimes"]) engine.setProperty(d.ref, pick(d.values));
+          }
+          const eligible = r.options.filter((o) => o.eligible);
+          if (eligible.length === 0) {
+            term = "stalled";
+            break;
+          }
+          flow.choose(eligible[Math.floor(rng() * eligible.length)].id);
+          continue;
+        }
+        if (hitCount.has(r.id)) {
+          hitCount.set(r.id, hitCount.get(r.id) + 1);
+          seenThisRun.add(r.id);
+        }
+      }
+    } catch {
+      term = "evalError";
+    }
+    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);
+    termination[term]++;
+    executed++;
+    if ((run & 255) === 0) hooks.onProgress?.(executed, runs);
+  }
+  hooks.onProgress?.(executed, runs);
+  const unwrittenInputs = /* @__PURE__ */ new Set();
+  const beats = order.map((id) => {
+    const m = meta.get(id);
+    const reached = reachedRuns.get(id);
+    let needsInput;
+    if (reached === 0) {
+      const gates = [...analysis.gatesByBeat.get(id) ?? []].filter((r) => !analysis.written.has(r) && !drivenRefs.has(r));
+      if (gates.length) {
+        needsInput = gates;
+        for (const g of gates) unwrittenInputs.add(g);
+      }
+    }
+    return {
+      id,
+      scene: m.scene,
+      kind: m.kind,
+      character: m.character,
+      preview: m.preview,
+      hits: hitCount.get(id),
+      reachedRuns: reached,
+      reachPct: executed ? reached / executed * 100 : 0,
+      ...needsInput ? { needsInput } : {}
+    };
+  });
+  const neverHit = beats.filter((b) => b.reachedRuns === 0).length;
+  const covered = beats.length - neverHit;
+  const dryChoices = [...dryRuns.entries()].map(([id, r]) => ({ id, scene: choiceScene.get(id) ?? "", runs: r })).sort((a, b) => b.runs - a.runs || a.id.localeCompare(b.id));
+  return {
+    runs: executed,
+    maxSteps,
+    seed,
+    start,
+    beats,
+    totals: { beats: beats.length, covered, neverHit, coveragePct: beats.length ? covered / beats.length * 100 : 100 },
+    termination,
+    drivers,
+    unwrittenInputs: [...unwrittenInputs].sort(),
+    dryChoices,
+    cancelled
+  };
+}
+function renderCoverageText(report, sceneName = (id) => id) {
+  const out = [];
+  const t = report.totals;
+  const pct = (n) => `${n.toFixed(0)}%`;
+  out.push(`coverage: ${t.covered}/${t.beats} beats reached (${pct(t.coveragePct)})${t.neverHit ? ` - ${t.neverHit} never reached` : ""}`);
+  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, ${term.capped} hit the step cap, ${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?)`);
+  }
+  if (report.dryChoices.length) {
+    out.push("");
+    out.push(`dry choices (fell through with nothing takeable - add a fallback or an unconditional option): ${report.dryChoices.length}`);
+    for (const d of report.dryChoices) {
+      out.push(`  \u203C ${String(d.runs).padStart(6)} run(s)  ${sceneName(d.scene)}  choice '${d.id}'`);
+    }
+  }
+  const byScene = /* @__PURE__ */ new Map();
+  for (const b of report.beats) (byScene.get(b.scene) ?? byScene.set(b.scene, []).get(b.scene)).push(b);
+  const clip = (s, n = 48) => s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
+  for (const [scene, beats] of byScene) {
+    const dead = beats.filter((b) => b.reachedRuns === 0).length;
+    out.push("");
+    out.push(`${sceneName(scene)}${dead ? `  (${dead} never reached)` : ""}`);
+    for (const b of beats) {
+      const mark = b.reachedRuns === 0 ? b.needsInput ? "? " : "\u203C " : "  ";
+      const label = b.character ? `${b.character}: ${clip(b.preview)}` : clip(b.preview || `(${b.kind})`);
+      out.push(`  ${mark}${b.reachPct.toFixed(0).padStart(3)}%  ${String(b.hits).padStart(6)}  ${label}`);
+    }
+  }
+  return out;
+}
+
+// src/format.ts
+import { readFileSync as readFileSync3 } from "fs";
+import { canonicalStringify as canonicalStringify2, parseSource as parseSource3 } from "@patterkit/core";
+function runFormat(files) {
+  return files.map((file) => {
+    const original = readFileSync3(file, "utf8");
+    let canonical;
+    try {
+      canonical = canonicalStringify2(parseSource3(original));
+    } catch (e) {
+      throw new Error(`${file}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    const changed = canonical !== original;
+    return changed ? { file, changed, write: { path: file, content: canonical } } : { file, changed };
+  });
+}
+
+// src/report.ts
+import { walkNodes as walkNodes2, DEFAULT_WRITING_STATUSES, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES2 } from "@patterkit/model";
+var DEFAULT_WORDS_PER_LINE = 6;
+var UNATTRIBUTED = "(unattributed)";
+function allocateLargestRemainder(total, weights) {
+  const sum = [...weights.values()].reduce((a, b) => a + b, 0);
+  if (sum <= 0 || total <= 0) return /* @__PURE__ */ new Map();
+  const parts = [...weights.entries()].map(([k, w]) => {
+    const ideal = total * w / sum;
+    const floor = Math.floor(ideal);
+    return { k, floor, frac: ideal - floor };
+  });
+  let remainder = total - parts.reduce((n, p) => n + p.floor, 0);
+  parts.sort((a, b) => b.frac - a.frac);
+  for (let i = 0; i < parts.length && remainder > 0; i++, remainder--) parts[i].floor++;
+  return new Map(parts.map((p) => [p.k, p.floor]));
+}
+function runReport(loaded, recordingOverride) {
+  const { project } = loaded;
+  const writingLadder = (project.writingStatuses ?? DEFAULT_WRITING_STATUSES).map((s) => s.name);
+  const recordingLadder = (project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES2).map((s) => s.name);
+  const stub = writingLadder[0];
+  const ladderDecls = project.writingStatuses ?? DEFAULT_WRITING_STATUSES;
+  const recordThreshold = ladderDecls.findIndex((s) => s.readyToRecord);
+  const shipThreshold = ladderDecls.findIndex((s) => s.readyToShip);
+  const writingIndex = new Map(writingLadder.map((name, i) => [name, i]));
+  const est = project.estimating;
+  const estimatingOn = est?.enabled ?? false;
+  const thresholdIdx = estimatingOn ? writingIndex.get(est?.thresholdStatus ?? "") ?? 0 : -1;
+  const defaultLines = est?.defaultLines ?? 0;
+  const tagMap = new Map((est?.tagEstimates ?? []).map((t) => [t.tag, t.lines]));
+  const { writing: writingOf, recording: manualRecordingOf, cut: cutSet, edits: editsOf } = mergeAuthoring(loaded);
+  const recordingOf = recordingOverride ?? manualRecordingOf;
+  const byLocale = stringsByLocale(loaded);
+  const sourceStrings2 = byLocale.get(project.locales.default) ?? {};
+  const wordsOf = (id) => {
+    const text = sourceStrings2[id];
+    return text ? text.split(/\s+/).filter(Boolean).length : 0;
+  };
+  const cut = { scenes: 0, voicedLines: 0, writtenLines: 0 };
+  const characters = /* @__PURE__ */ new Map();
+  const getChar = (name) => {
+    let c = characters.get(name);
+    if (!c) {
+      c = { character: name, lines: 0, words: 0, estimatedLines: 0, recording: Object.fromEntries(recordingLadder.map((s) => [s, 0])) };
+      characters.set(name, c);
+    }
+    return c;
+  };
+  const reports = [];
+  const localeIds = [];
+  const estimatedScenes = [];
+  let actualWrittenLines = 0, actualWords = 0;
+  const rungIdxOf = (id) => writingIndex.get(writingOf.get(id) ?? stub) ?? 0;
+  for (const scene of loaded.scenes) {
+    const sceneCut = cutSet.has(scene.id);
+    const units = [];
+    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
+          });
+        }
+      });
+    }
+    for (const u of units) if (sceneCut || cutSet.has(u.id)) {
+      cut.writtenLines++;
+      if (u.voiced) cut.voicedLines++;
+    }
+    if (sceneCut) {
+      cut.scenes++;
+      continue;
+    }
+    const live = units.filter((u) => !cutSet.has(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];
+    const highestIdx = live.length ? Math.max(...live.map((u) => rungIdxOf(u.id))) : void 0;
+    const estimated = estimatingOn && live.length > 0 && highestIdx <= thresholdIdx;
+    if (estimated) {
+      const tagLines = (scene.tags ?? []).map((t) => tagMap.get(t)).filter((n) => n != null);
+      const estimateLines = tagLines.length ? Math.max(...tagLines) : defaultLines;
+      const weights = /* @__PURE__ */ new Map();
+      for (const u of live) {
+        const key = u.voiced && u.character ? u.character : UNATTRIBUTED;
+        weights.set(key, (weights.get(key) ?? 0) + 1);
+      }
+      const shares = allocateLargestRemainder(estimateLines, weights);
+      let voicedShare = 0;
+      for (const [key, n] of shares) {
+        if (key === UNATTRIBUTED) continue;
+        getChar(key).estimatedLines += n;
+        voicedShare += n;
+      }
+      const report = {
+        sceneId: scene.id,
+        name: scene.name,
+        file: loaded.sceneFiles[scene.id],
+        status,
+        estimated: true,
+        choices,
+        voiced: emptyVoiced(writingLadder, recordingLadder),
+        written: emptyWritten(writingLadder),
+        estimate: estimateLines,
+        writtenDone: 0,
+        writtenRemaining: estimateLines,
+        voicedDone: 0,
+        voicedRemaining: voicedShare
+      };
+      reports.push(report);
+      estimatedScenes.push({ report, voicedShare });
+      continue;
+    }
+    const voiced = emptyVoiced(writingLadder, recordingLadder);
+    const written = emptyWritten(writingLadder);
+    for (const u of live) {
+      const ws = writingOf.get(u.id) ?? stub;
+      written.count++;
+      written.words += u.words;
+      written.byWriting[ws] = (written.byWriting[ws] ?? 0) + 1;
+      actualWrittenLines++;
+      actualWords += u.words;
+      if (!u.voiced) continue;
+      voiced.count++;
+      voiced.words += u.words;
+      voiced.byWriting[ws] = (voiced.byWriting[ws] ?? 0) + 1;
+      const wi = writingIndex.get(ws) ?? 0;
+      if (recordThreshold !== -1 && wi >= recordThreshold) voiced.readyToRecord++;
+      if (shipThreshold !== -1 && wi >= shipThreshold) voiced.readyToShip++;
+      const rec = recordingOf.get(u.id) ?? recordingLadder[0];
+      voiced.byRecording[rec] = (voiced.byRecording[rec] ?? 0) + 1;
+      const speaker = u.character ?? "(narrator)";
+      const ch = getChar(speaker);
+      ch.lines++;
+      ch.words += u.words;
+      ch.recording[rec] = (ch.recording[rec] ?? 0) + 1;
+    }
+    const writtenStub = written.byWriting[stub] ?? 0;
+    const voicedStub = voiced.byWriting[stub] ?? 0;
+    reports.push({
+      sceneId: scene.id,
+      name: scene.name,
+      file: loaded.sceneFiles[scene.id],
+      status,
+      estimated: false,
+      choices,
+      voiced,
+      written,
+      writtenDone: written.count - writtenStub,
+      writtenRemaining: writtenStub,
+      voicedDone: voiced.count - voicedStub,
+      voicedRemaining: voicedStub
+    });
+  }
+  const avgWordsPerLine = actualWrittenLines > 0 ? actualWords / actualWrittenLines : DEFAULT_WORDS_PER_LINE;
+  for (const { report, voicedShare } of estimatedScenes) {
+    report.written.words = Math.round((report.estimate ?? 0) * avgWordsPerLine);
+    report.voiced.words = Math.round(voicedShare * avgWordsPerLine);
+  }
+  const locales = computeLocales(loaded, byLocale, editsOf, localeIds, project.locales.default);
+  const totals = computeTotals(reports, writingLadder, recordingLadder);
+  const scenesByStatus = Object.fromEntries(writingLadder.map((s) => [s, 0]));
+  for (const s of reports) if (s.status) scenesByStatus[s.status] = (scenesByStatus[s.status] ?? 0) + 1;
+  const coverage = { totalScenes: reports.length, estimated: reports.filter((s) => s.estimated).length };
+  return {
+    project: { id: project.project.id, name: project.project.name },
+    voiced: project.voiced ?? false,
+    // Recording tracking is opt-in (default off) even for a voiced project (#206).
+    recordingTracked: (project.voiced ?? false) && (project.trackAudioStatus ?? false),
+    writingLadder,
+    recordingLadder,
+    scenes: reports,
+    characters: [...characters.values()].sort((a, b) => b.lines + b.estimatedLines - (a.lines + a.estimatedLines)),
+    locales,
+    cut,
+    estimating: estimatingOn,
+    scenesByStatus,
+    coverage,
+    totals
+  };
+}
+function emptyWritten(ladder) {
+  return { count: 0, words: 0, byWriting: Object.fromEntries(ladder.map((s) => [s, 0])) };
+}
+function emptyVoiced(writing, recording) {
+  return { ...emptyWritten(writing), byRecording: Object.fromEntries(recording.map((s) => [s, 0])), readyToRecord: 0, readyToShip: 0 };
+}
+function computeLocales(loaded, byLocale, editsOf, ids, defaultLocale) {
+  const out = [];
+  for (const locale of loaded.project.locales.all) {
+    if (locale === defaultLocale) continue;
+    const table = byLocale.get(locale) ?? {};
+    let translated = 0, missing = 0, stale = 0, words = 0;
+    for (const id of ids) {
+      const text = table[id];
+      if (text === void 0) {
+        missing++;
+        continue;
+      }
+      translated++;
+      words += text.split(/\s+/).filter(Boolean).length;
+      const edit = editsOf.get(id);
+      const modified = edit?.modifiedAt, localised = edit?.localisedAt?.[locale];
+      if (modified && localised && modified > localised) stale++;
+    }
+    out.push({ locale, translated, missing, stale, words });
+  }
+  return out;
+}
+function computeTotals(scenes, writingLadder, recordingLadder) {
+  const t = {
+    voiced: emptyVoiced(writingLadder, recordingLadder),
+    written: emptyWritten(writingLadder),
+    choices: 0,
+    writtenDone: 0,
+    writtenRemaining: 0,
+    voicedDone: 0,
+    voicedRemaining: 0,
+    projectedWritten: 0,
+    projectedVoiced: 0
+  };
+  const add = (into, from) => {
+    for (const [k, v] of Object.entries(from)) into[k] = (into[k] ?? 0) + v;
+  };
+  for (const s of scenes) {
+    t.voiced.count += s.voiced.count;
+    t.voiced.words += s.voiced.words;
+    t.voiced.readyToRecord += s.voiced.readyToRecord;
+    t.voiced.readyToShip += s.voiced.readyToShip;
+    add(t.voiced.byWriting, s.voiced.byWriting);
+    add(t.voiced.byRecording, s.voiced.byRecording);
+    t.written.count += s.written.count;
+    t.written.words += s.written.words;
+    add(t.written.byWriting, s.written.byWriting);
+    t.choices += s.choices;
+    t.writtenDone += s.writtenDone;
+    t.writtenRemaining += s.writtenRemaining;
+    t.voicedDone += s.voicedDone;
+    t.voicedRemaining += s.voicedRemaining;
+  }
+  t.projectedWritten = t.writtenDone + t.writtenRemaining;
+  t.projectedVoiced = t.voicedDone + t.voicedRemaining;
+  return t;
+}
+function renderReportText(data) {
+  const out = [];
+  const t = data.totals;
+  out.push(`${data.project.name} - ${data.scenes.length} scene(s)`);
+  out.push(`written lines: ${t.writtenDone} done / ${t.writtenRemaining} to write -> ${t.projectedWritten} projected (${t.written.words} words)`);
+  if (data.voiced) out.push(`voiced lines:  ${t.voicedDone} done / ${t.voicedRemaining} to write -> ${t.projectedVoiced} projected (${t.voiced.words} words)`);
+  out.push(`writing status: ${Object.entries(t.written.byWriting).map(([k, v]) => `${k} ${v}`).join(", ")}`);
+  out.push(`scene status: ${Object.entries(data.scenesByStatus).map(([k, v]) => `${k} ${v}`).join(", ")}`);
+  if (data.voiced) out.push(`ready to record: ${t.voiced.readyToRecord} / ready to ship: ${t.voiced.readyToShip} (voiced)`);
+  if (data.recordingTracked) out.push(`recording: ${Object.entries(t.voiced.byRecording).map(([k, v]) => `${k} ${v}`).join(", ")}`);
+  if (data.estimating) {
+    const estLines = data.scenes.reduce((n, s) => n + (s.estimated ? s.estimate ?? 0 : 0), 0);
+    out.push(`estimating: ${data.coverage.estimated}/${data.coverage.totalScenes} scene(s) estimated (${estLines} lines)`);
+  }
+  if (data.cut.writtenLines > 0) out.push(`cut: ${data.cut.scenes} scene(s), ${data.cut.writtenLines} written / ${data.cut.voicedLines} voiced line(s)`);
+  for (const l of data.locales) {
+    out.push(`locale ${l.locale}: ${l.translated} translated, ${l.missing} missing, ${l.stale} stale`);
+  }
+  return out;
+}
+
+// src/report-xlsx.ts
+async function runReportXlsx(data) {
+  const { default: ExcelJS } = await import("exceljs");
+  const wb = new ExcelJS.Workbook();
+  wb.creator = "patter";
+  const v = data.voiced;
+  const rec = data.recordingTracked;
+  const scenes = wb.addWorksheet("Scenes");
+  scenes.columns = [
+    { header: "Scene", key: "name", width: 24 },
+    { header: "Status", key: "status", width: 10 },
+    ...v ? [{ header: "Voiced", key: "vCount", width: 8 }] : [],
+    { header: "Written", key: "wCount", width: 8 },
+    { header: "Words", key: "words", width: 9 },
+    { header: "Choices", key: "choices", width: 8 },
+    ...data.writingLadder.map((s) => ({ header: s, key: `w:${s}`, width: 10 })),
+    ...v ? [{ header: "Ready record", key: "rr", width: 12 }, { header: "Ready ship", key: "rs", width: 11 }] : [],
+    ...rec ? data.recordingLadder.map((s) => ({ header: `rec ${s}`, key: `r:${s}`, width: 10 })) : [],
+    ...data.estimating ? [{ header: "Estimate", key: "estimate", width: 9 }] : [],
+    { header: "Written left", key: "wRem", width: 11 },
+    ...v ? [{ header: "Voiced left", key: "vRem", width: 11 }] : []
+  ];
+  const sceneRow = (name, s) => ({
+    name,
+    status: s.status,
+    vCount: s.voiced.count,
+    wCount: s.written.count,
+    words: s.written.words,
+    choices: s.choices,
+    ...Object.fromEntries(data.writingLadder.map((k) => [`w:${k}`, s.written.byWriting[k] ?? 0])),
+    rr: s.voiced.readyToRecord,
+    rs: s.voiced.readyToShip,
+    ...Object.fromEntries(data.recordingLadder.map((k) => [`r:${k}`, s.voiced.byRecording[k] ?? 0])),
+    estimate: s.estimate,
+    wRem: s.writtenRemaining,
+    vRem: s.voicedRemaining
+  });
+  for (const s of data.scenes) scenes.addRow(sceneRow(s.name, s));
+  const totals = data.totals;
+  const totalRow = scenes.addRow(sceneRow("TOTAL", totals));
+  totalRow.font = { bold: true };
+  scenes.getRow(1).font = { bold: true };
+  const chars = wb.addWorksheet("Characters");
+  chars.columns = [
+    { header: "Character", key: "character", width: 20 },
+    { header: "Lines", key: "lines", width: 8 },
+    ...data.estimating ? [{ header: "Est. lines", key: "estLines", width: 9 }] : [],
+    { header: "Words", key: "words", width: 9 },
+    ...rec ? data.recordingLadder.map((s) => ({ header: `rec ${s}`, key: `r:${s}`, width: 10 })) : []
+  ];
+  for (const c of data.characters) {
+    chars.addRow({
+      character: c.character,
+      lines: c.lines,
+      estLines: c.estimatedLines,
+      words: c.words,
+      ...Object.fromEntries(data.recordingLadder.map((k) => [`r:${k}`, c.recording[k] ?? 0]))
+    });
+  }
+  chars.getRow(1).font = { bold: true };
+  if (data.locales.length > 0) {
+    const loc = wb.addWorksheet("Localisation");
+    loc.columns = [
+      { header: "Locale", key: "locale", width: 10 },
+      { header: "Translated", key: "translated", width: 11 },
+      { header: "Missing", key: "missing", width: 9 },
+      { header: "Stale", key: "stale", width: 8 },
+      { header: "Words", key: "words", width: 9 }
+    ];
+    for (const l of data.locales) loc.addRow(l);
+    loc.getRow(1).font = { bold: true };
+  }
+  if (data.estimating && data.coverage.estimated > 0) {
+    const plan = wb.addWorksheet("Estimates");
+    plan.columns = [
+      { header: "Scene", key: "name", width: 24 },
+      { header: "Est. written", key: "written", width: 12 },
+      ...v ? [{ header: "Est. voiced", key: "voiced", width: 11 }] : []
+    ];
+    for (const s of data.scenes) if (s.estimated) plan.addRow({ name: s.name, written: s.estimate, voiced: s.voicedRemaining });
+    const coverageRow = plan.addRow({ name: `coverage: ${data.coverage.estimated}/${data.coverage.totalScenes} scenes estimated` });
+    coverageRow.font = { italic: true };
+    plan.getRow(1).font = { bold: true };
+  }
+  return Buffer.from(await wb.xlsx.writeBuffer());
+}
+
+// src/localisation.ts
+import { basename as basename4, join as join3, sep } from "path";
+import { canonicalStringify as canonicalStringify3 } from "@patterkit/core";
+import { walkNodes as walkNodes3, castStringKey, PROJECT_LOCALE_SCENE } from "@patterkit/model";
+
+// src/documentation.ts
+import { DEFAULT_DOCUMENTATION_CLASSES } from "@patterkit/model";
+function classesForChannel(classes, channel) {
+  const out = /* @__PURE__ */ new Set();
+  for (const c of classes) {
+    if (c.deliver === "*" || Array.isArray(c.deliver) && c.deliver.includes(channel)) out.add(c.name);
+  }
+  return out;
+}
+function resolveDocumentation(loaded, channel) {
+  const classes = loaded.project.documentationClasses ?? DEFAULT_DOCUMENTATION_CLASSES;
+  const allowed = classesForChannel(classes, channel);
+  const docsOf = mergeAuthoring(loaded).documentation;
+  const own = (id) => (docsOf.get(id) ?? []).filter((l) => l.type !== void 0 && allowed.has(l.type));
+  const out = /* @__PURE__ */ new Map();
+  const visit = (id, inherited) => {
+    const mine = own(id);
+    if (inherited.length === 0 && mine.length === 0) return inherited;
+    const resolved = [...inherited, ...mine];
+    out.set(id, resolved);
+    return resolved;
+  };
+  const walkNode = (node, inherited) => {
+    const passed = visit(node.id, inherited);
+    if (node.type === "group") {
+      if (node.prompt) visit(node.prompt.id, passed);
+      for (const child of node.children ?? []) walkNode(child, passed);
+    } else {
+      for (const beat of node.beats ?? []) visit(beat.id, passed);
+    }
+  };
+  for (const scene of loaded.scenes) {
+    const sceneInh = visit(scene.id, []);
+    for (const block of scene.blocks) {
+      const blockInh = visit(block.id, sceneInh);
+      for (const child of block.children ?? []) walkNode(child, blockInh);
+    }
+  }
+  return out;
+}
+
+// src/localisation.ts
+function extractLoc(loaded, opts = {}) {
+  const defaultLocale = loaded.project.locales.default;
+  const isTemplate = opts.locale === void 0 || opts.locale === defaultLocale;
+  const targetLocale = isTemplate ? void 0 : opts.locale;
+  const source = tableFor(loaded, defaultLocale);
+  const target = targetLocale ? tableFor(loaded, targetLocale) : {};
+  const edits = mergeAuthoring(loaded).edits;
+  const docs = resolveDocumentation(loaded, "loc");
+  const commentsOf = (id) => (docs.get(id) ?? []).map((d) => d.text);
+  const staleFor = (id, translation) => {
+    if (isTemplate || !translation) return false;
+    const e = edits.get(id);
+    const localised = e?.localisedAt?.[targetLocale];
+    return !!(e?.modifiedAt && localised && e.modifiedAt > localised);
+  };
+  const entries = [];
+  const push = (id, scene, context) => {
+    const src = source[id];
+    if (src === void 0) return;
+    const translation = isTemplate ? "" : target[id] ?? "";
+    entries.push({ id, scene, source: src, translation, comments: commentsOf(id), context, stale: staleFor(id, translation) });
+  };
+  for (const scene of loaded.scenes) {
+    for (const block of scene.blocks) {
+      walkNodes3(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 });
+          return;
+        }
+        for (const beat of node.beats ?? []) {
+          if (beat.kind !== "gameEvent") push(beat.id, scene.id, { character: beat.kind === "line" ? beat.character : void 0, kind: beat.kind });
+        }
+      });
+    }
+  }
+  for (const c of loaded.project.cast ?? []) {
+    if (!c.displayName) continue;
+    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: { 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/"
+});
+function existingLocPath(loaded, scene, locale) {
+  for (let i = 0; i < loaded.locales.length; i++) {
+    const l = loaded.locales[i];
+    if (l.scene === scene && l.locale === locale) return loaded.localeFiles[i] ?? null;
+  }
+  return null;
+}
+function targetLocPath(loaded, scene, locale, defaultLocale) {
+  const existing = existingLocPath(loaded, scene, locale);
+  if (existing) return existing;
+  const fromDefault = existingLocPath(loaded, scene, defaultLocale);
+  if (fromDefault) {
+    const parts = fromDefault.split(sep);
+    for (let i = parts.length - 2; i >= 0; i--) {
+      if (parts[i] === defaultLocale) {
+        parts[i] = locale;
+        return parts.join(sep);
+      }
+    }
+  }
+  const stem = scene === PROJECT_LOCALE_SCENE ? "_project" : scene;
+  return join3(loaded.root, layoutOf(loaded).strings, locale, `${stem}.patterloc`);
+}
+function authoringPath(loaded, scene) {
+  const dir = join3(loaded.root, layoutOf(loaded).authoring);
+  if (scene === PROJECT_LOCALE_SCENE) return join3(dir, "_project.patterx");
+  const flow = loaded.sceneFiles[scene];
+  const stem = flow ? basename4(flow).replace(/\.patterflow$/, "") : scene;
+  return join3(dir, `${stem}.patterx`);
+}
+var findFile = (files, items, path) => {
+  const i = files.indexOf(path);
+  return i >= 0 ? items[i] : void 0;
+};
+function applyLoc(loaded, catalog, opts = {}) {
+  const locale = catalog.locale;
+  if (!locale || locale === loaded.project.locales.default) {
+    return { writes: [], stats: { updated: 0, files: 0 } };
+  }
+  const now = opts.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const bySceneText = /* @__PURE__ */ new Map();
+  const bySceneFresh = /* @__PURE__ */ new Map();
+  for (const e of catalog.entries) {
+    if (!e.translation.trim()) continue;
+    (bySceneText.get(e.scene) ?? bySceneText.set(e.scene, /* @__PURE__ */ new Map()).get(e.scene)).set(e.id, e.translation);
+    if (!e.stale) (bySceneFresh.get(e.scene) ?? bySceneFresh.set(e.scene, /* @__PURE__ */ new Set()).get(e.scene)).add(e.id);
+  }
+  const writes = [];
+  let updated = 0;
+  for (const [scene, strings] of bySceneText) {
+    const path = targetLocPath(loaded, scene, locale, loaded.project.locales.default);
+    const existing = findFile(loaded.localeFiles, loaded.locales, path);
+    const merged = { ...existing?.strings ?? {} };
+    for (const [id, text] of strings) {
+      merged[id] = text;
+      updated++;
+    }
+    const file = { schema: existing?.schema ?? "patter/strings@0", scene, locale, strings: merged };
+    writes.push({ path, content: canonicalStringify3(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 editsMap = { ...authoring.edits ?? {} };
+    for (const id of fresh) editsMap[id] = { ...editsMap[id], localisedAt: { ...editsMap[id]?.localisedAt, [locale]: now } };
+    authoring.edits = editsMap;
+    writes.push({ path: aPath, content: canonicalStringify3(authoring) });
+  }
+  return { writes, stats: { updated, files: bySceneText.size } };
+}
+
+// src/loc-format.ts
+function catalogToJson(catalog) {
+  return JSON.stringify(catalog, null, 2) + "\n";
+}
+function jsonToCatalog(text) {
+  const o = JSON.parse(text);
+  if (!o || typeof o !== "object" || !Array.isArray(o.entries)) throw new Error("not a localisation JSON file (no 'entries' array)");
+  if (typeof o.defaultLocale !== "string") throw new Error("localisation JSON: missing 'defaultLocale'");
+  return {
+    project: typeof o.project === "string" ? o.project : "",
+    defaultLocale: o.defaultLocale,
+    locale: typeof o.locale === "string" ? o.locale : void 0,
+    entries: o.entries.map((e) => ({
+      id: String(e.id),
+      scene: String(e.scene),
+      source: String(e.source ?? ""),
+      translation: String(e.translation ?? ""),
+      comments: Array.isArray(e.comments) ? e.comments.map(String) : [],
+      context: e.context,
+      stale: !!e.stale
+    }))
+  };
+}
+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 poField = (key, value) => `${key} "${poEscape(value)}"`;
+function catalogToPo(catalog) {
+  const out = [];
+  out.push(
+    'msgid ""',
+    'msgstr ""',
+    `"Project-Id-Version: ${catalog.project}\\n"`,
+    `"Language: ${catalog.locale ?? ""}\\n"`,
+    '"MIME-Version: 1.0\\n"',
+    '"Content-Type: text/plain; charset=UTF-8\\n"',
+    '"Content-Transfer-Encoding: 8bit\\n"',
+    ""
+  );
+  for (const e of catalog.entries) {
+    for (const c of e.comments) out.push(`#. ${c}`);
+    if (e.context?.character || e.context?.kind) {
+      out.push(`#. [${[e.context.kind, e.context.character].filter(Boolean).join(" ")}]`);
+    }
+    out.push(`#: ${e.scene}`);
+    if (e.stale) out.push("#, fuzzy");
+    out.push(poField("msgctxt", e.id), poField("msgid", e.source), poField("msgstr", e.translation), "");
+  }
+  return out.join("\n");
+}
+function readQuoted(lines, start) {
+  const first = lines[start];
+  let value = poUnescape(first.slice(first.indexOf('"') + 1, first.lastIndexOf('"')));
+  let i = start + 1;
+  while (i < lines.length && lines[i].trimStart().startsWith('"')) {
+    const l = lines[i].trim();
+    value += poUnescape(l.slice(1, l.lastIndexOf('"')));
+    i++;
+  }
+  return { value, next: i };
+}
+function poToCatalog(text) {
+  const lines = text.split(/\r?\n/);
+  const entries = [];
+  let locale;
+  let project = "";
+  let comments = [];
+  let scene = "";
+  let stale = false;
+  let ctxt;
+  let msgid = "";
+  let i = 0;
+  const flush = (msgstr) => {
+    if (ctxt !== void 0) {
+      entries.push({ id: ctxt, 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();
+      const pid = /Project-Id-Version:\s*([^\\\n]*)/.exec(msgstr);
+      if (pid?.[1]?.trim()) project = pid[1].trim();
+    }
+    comments = [];
+    scene = "";
+    stale = false;
+    ctxt = void 0;
+    msgid = "";
+  };
+  while (i < lines.length) {
+    const line = lines[i];
+    const t = line.trim();
+    if (t === "") {
+      i++;
+      continue;
+    }
+    if (t.startsWith("#.")) {
+      comments.push(t.slice(2).trim());
+      i++;
+      continue;
+    }
+    if (t.startsWith("#:")) {
+      scene = t.slice(2).trim().split(/\s+/)[0] ?? "";
+      i++;
+      continue;
+    }
+    if (t.startsWith("#,")) {
+      if (t.includes("fuzzy")) stale = true;
+      i++;
+      continue;
+    }
+    if (t.startsWith("#")) {
+      i++;
+      continue;
+    }
+    if (t.startsWith("msgctxt")) {
+      const r = readQuoted(lines, i);
+      ctxt = r.value;
+      i = r.next;
+      continue;
+    }
+    if (t.startsWith("msgid")) {
+      const r = readQuoted(lines, i);
+      msgid = r.value;
+      i = r.next;
+      continue;
+    }
+    if (t.startsWith("msgstr")) {
+      const r = readQuoted(lines, i);
+      flush(r.value);
+      i = r.next;
+      continue;
+    }
+    i++;
+  }
+  return { project, defaultLocale: locale ?? "", locale, entries };
+}
+
+// src/loc-xlsx.ts
+var HEADERS = ["ID", "Source", "Translation", "Comments", "Status"];
+var sheetName = (scene) => scene.replace(/[:\\/?*[\]]/g, "-").slice(0, 31);
+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);
+  for (const [scene, entries] of byScene) {
+    const ws = wb.addWorksheet(sheetName(scene));
+    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 }
+    ];
+    ws.getRow(1).font = { bold: true };
+    for (const e of entries) {
+      ws.addRow({
+        id: e.id,
+        source: e.source,
+        translation: e.translation,
+        comments: e.comments.join("\n"),
+        status: e.stale ? "stale" : e.translation ? "translated" : ""
+      });
+    }
+  }
+  return Buffer.from(await wb.xlsx.writeBuffer());
+}
+async function xlsxToCatalog(buffer) {
+  const { default: ExcelJS } = await import("exceljs");
+  const wb = new ExcelJS.Workbook();
+  await wb.xlsx.load(buffer);
+  const entries = [];
+  for (const ws of wb.worksheets) {
+    const scene = ws.name;
+    const header = ws.getRow(1).values.slice(1).map((v) => String(v ?? ""));
+    if (header[0] !== HEADERS[0]) continue;
+    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 id = cell(1).trim();
+      if (!id) return;
+      const status = cell(5).trim().toLowerCase();
+      entries.push({
+        id,
+        scene,
+        source: cell(2),
+        translation: cell(3),
+        comments: cell(4) ? cell(4).split("\n").filter(Boolean) : [],
+        stale: status === "stale"
+      });
+    });
+  }
+  return { project: "", defaultLocale: "", locale: void 0, entries };
+}
+
+// src/voice-script.ts
+import { DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES2, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES3, DEFAULT_DOCUMENTATION_CLASSES as DEFAULT_DOCUMENTATION_CLASSES2 } from "@patterkit/model";
+function plainVoice(text) {
+  return text.replace(/<\/?(?:b|i|bi)>/g, "").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+}
+function groupLabel(node, source) {
+  if (node.prompt) return plainVoice(source[node.prompt.id]?.trim() || "option");
+  if (node.selector === "choice") return "";
+  return node.selector ?? "group";
+}
+function runVoiceScript(loaded, opts = {}) {
+  const { project } = loaded;
+  const everything = !!opts.everything;
+  const ladderDecls = project.writingStatuses ?? DEFAULT_WRITING_STATUSES2;
+  const writingLadder = ladderDecls.map((s) => s.name);
+  const recordingLadder = (project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES3).map((s) => s.name);
+  const stub = writingLadder[0];
+  const recordThreshold = ladderDecls.findIndex((s) => s.readyToRecord);
+  const writingIndex = new Map(writingLadder.map((name, i) => [name, i]));
+  const { writing: writingOf, recording: manualRecordingOf, cut: cutSet, documentation: docsOf } = mergeAuthoring(loaded);
+  const recordingOf = opts.recordingOverride ?? manualRecordingOf;
+  const source = sourceStrings(loaded);
+  const actorOf = /* @__PURE__ */ new Map();
+  for (const c of project.cast ?? []) if (c.actor) actorOf.set(c.name, c.actor);
+  const 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 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)];
+      for (const child of node.children ?? []) walkNode(child, 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.get(beat.id) ?? recordingLadder[0]
+      });
+      leading = false;
+    }
+  };
+  for (const scene of loaded.scenes) {
+    if (cutSet.has(scene.id)) continue;
+    const sceneVo = ownVo(scene.id);
+    for (const block of scene.blocks) {
+      if (cutSet.has(block.id)) continue;
+      const scope = [scene.name, block.name].filter(Boolean);
+      const blockVo = [...sceneVo, ...ownVo(block.id)];
+      for (const child of block.children ?? []) walkNode(child, scope, blockVo);
+    }
+  }
+  return { project: project.project.id, voiced: project.voiced ?? false, recordingLadder, everything, lines };
+}
+
+// src/voice-script-xlsx.ts
+async function voiceScriptToXlsx(data) {
+  const { default: ExcelJS } = await import("exceljs");
+  const wb = new ExcelJS.Workbook();
+  wb.creator = "patter";
+  const ws = wb.addWorksheet("Voice Script");
+  ws.columns = [
+    { header: "Scope", key: "scope", width: 28 },
+    { header: "Line ID", key: "id", width: 18 },
+    { header: "Character", key: "character", width: 16 },
+    { header: "Actor", key: "actor", width: 16 },
+    { header: "Text", key: "text", width: 60 },
+    { header: "Comments", key: "comments", width: 36 },
+    { header: "Status", key: "status", width: 12 }
+  ];
+  ws.getRow(1).font = { bold: true };
+  for (const l of data.lines) {
+    const row = ws.addRow({
+      scope: l.scope,
+      id: l.id,
+      character: l.character,
+      actor: l.actor ?? "",
+      text: l.text,
+      comments: l.comments.join("\n"),
+      status: l.recordingStatus
+    });
+    row.getCell("text").alignment = { wrapText: true, vertical: "top" };
+    row.getCell("comments").alignment = { wrapText: true, vertical: "top" };
+  }
+  return Buffer.from(await wb.xlsx.writeBuffer());
+}
+
+// src/script-doc.ts
+var TOKENS = {
+  ink: "26221c",
+  // near-black warm ink (headings)
+  inkRead: "3a352d",
+  // dialogue body (ink ~84% + muted)
+  inkSoft: "5c554b",
+  // narration (ink ~68% + muted) - a step softer than dialogue
+  muted: "8c8479",
+  // labels, quiet tags
+  accent: "8a5a34",
+  // structural marks: conditions, options, jumps, game events
+  line: "e4dfd5"
+  // hairlines / rules / the group rail
+};
+var CHAR_PALETTE = [
+  "b23b3b",
+  "b5642b",
+  "927524",
+  "6b7a31",
+  "3f7d49",
+  "2c7d6e",
+  "2d7791",
+  "3a6aa8",
+  "5a5ba6",
+  "7e4e9c",
+  "9c4486",
+  "a83e5c"
+];
+function colourIndex(name) {
+  let h = 2166136261;
+  for (let i = 0; i < name.length; i++) {
+    h ^= name.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  h ^= h >>> 16;
+  h = Math.imul(h, 2246822507);
+  h ^= h >>> 13;
+  h = Math.imul(h, 3266489909);
+  h ^= h >>> 16;
+  return (h >>> 0) % 12;
+}
+function characterColour(name) {
+  return CHAR_PALETTE[colourIndex(name)];
+}
+var VISIT_FN_RE = /\b(patter_visits|patter_seen|visits|seen)\s*\(\s*(['"])(.*?)\2\s*\)/g;
+function humanizeCondition(cond, label) {
+  return cond.replace(VISIT_FN_RE, (_m, fn, _q, id) => `${fn}(${label(id)})`);
+}
+var MARKUP_RE = /<(b|i|bi)>([\s\S]*?)<\/\1>/g;
+var INTERP_RE = /\{@[^}]*\}/g;
+function textRuns(text) {
+  const marked = [];
+  let last = 0;
+  let m;
+  MARKUP_RE.lastIndex = 0;
+  while ((m = MARKUP_RE.exec(text)) !== null) {
+    if (m.index > last) marked.push({ text: text.slice(last, m.index), bold: false, italic: false });
+    const tag = m[1];
+    marked.push({ text: m[2], bold: tag === "b" || tag === "bi", italic: tag === "i" || tag === "bi" });
+    last = MARKUP_RE.lastIndex;
+  }
+  if (last < text.length) marked.push({ text: text.slice(last), bold: false, italic: false });
+  if (!marked.length) marked.push({ text, bold: false, italic: false });
+  const out = [];
+  for (const r of marked) {
+    let li = 0;
+    let im;
+    INTERP_RE.lastIndex = 0;
+    while ((im = INTERP_RE.exec(r.text)) !== null) {
+      if (im.index > li) out.push({ text: r.text.slice(li, im.index), bold: r.bold, italic: r.italic, code: false });
+      out.push({ text: im[0], bold: r.bold, italic: r.italic, code: true });
+      li = INTERP_RE.lastIndex;
+    }
+    if (li < r.text.length) out.push({ text: r.text.slice(li), bold: r.bold, italic: r.italic, code: false });
+  }
+  return out.length ? out : [{ text, bold: false, italic: false, code: false }];
+}
+function targetLabel(to, sceneOf, blockTrail) {
+  if (to === "END") return "END";
+  return blockTrail.get(to) ?? sceneOf.get(to) ?? to;
+}
+function gameEventLabel(beat) {
+  const gd = beat.gameData;
+  if (gd && typeof gd === "object") {
+    const parts = Object.entries(gd).slice(0, 3).map(([k, v]) => {
+      const val = v == null ? "" : typeof v === "object" ? JSON.stringify(v) : String(v);
+      return val === "" ? k : `${k}: ${val}`;
+    });
+    if (parts.length) return `game event \xB7 ${parts.join(", ")}`;
+  }
+  return "game event";
+}
+function optionTag(node) {
+  const parts = [];
+  if (node.fallback) parts.push("fallback");
+  parts.push(node.sticky ? "repeatable" : "once only");
+  if (node.secretUntilEligible) parts.push("hidden");
+  return parts.join(" \xB7 ");
+}
+function sequenceLabel(node) {
+  const o = node.options ?? {};
+  const bits = [];
+  if ((o.order ?? "sequential") === "shuffle") bits.push("shuffled");
+  const ex = o.exhaust ?? "once";
+  if (ex === "repeat") bits.push("repeating");
+  else if (ex === "stick") bits.push("holds on the last");
+  return bits.length ? `In sequence \xB7 ${bits.join(", ")}` : "In sequence";
+}
+function runScriptDoc(loaded) {
+  const { project } = loaded;
+  const source = sourceStrings(loaded);
+  const { cut } = mergeAuthoring(loaded);
+  const sceneOf = /* @__PURE__ */ new Map();
+  const blockTrail = /* @__PURE__ */ new Map();
+  const blockName = /* @__PURE__ */ new Map();
+  for (const scene of loaded.scenes) {
+    sceneOf.set(scene.id, scene.name);
+    for (const block of scene.blocks) {
+      blockTrail.set(block.id, `${scene.name} \u203A ${block.name}`);
+      blockName.set(block.id, block.name);
+    }
+  }
+  const humanize = (cond) => humanizeCondition(cond, (id) => blockName.get(id) ?? sceneOf.get(id) ?? id);
+  const els = [];
+  const textOf = (id) => source[id] ?? "";
+  const jumpText = (j) => {
+    const dest = targetLabel(j.to, sceneOf, blockTrail);
+    return j.mode === "call" ? `${dest} (and return)` : dest;
+  };
+  let snippetSeq = 0;
+  const nextSid = () => ++snippetSeq;
+  const emitBeats = (node, indent, sid) => {
+    for (const beat of node.beats ?? []) {
+      if (cut.has(beat.id)) continue;
+      if (beat.kind === "line") els.push({ kind: "line", indent, snippet: sid, character: beat.character ?? "", direction: beat.direction, runs: textRuns(textOf(beat.id)) });
+      else if (beat.kind === "text") els.push({ kind: "narration", indent, snippet: sid, runs: textRuns(textOf(beat.id)) });
+      else if (beat.kind === "gameEvent") els.push({ kind: "gameEvent", indent, snippet: sid, text: gameEventLabel(beat) });
+    }
+    if (node.jump) els.push({ kind: "jump", indent, snippet: sid, text: jumpText(node.jump) });
+  };
+  const walk = (node, indent, sid) => {
+    if (cut.has(node.id)) return;
+    if (node.type === "snippet") {
+      if (node.condition) els.push({ kind: "condition", indent, snippet: sid, text: `if ${humanize(node.condition)}` });
+      emitBeats(node, indent, sid);
+      return;
+    }
+    if (node.condition) els.push({ kind: "condition", indent, snippet: sid, text: `if ${humanize(node.condition)}` });
+    if (node.selector === "choice") {
+      els.push({ kind: "group", indent, label: "Choose" });
+      for (const child of node.children ?? []) {
+        if (cut.has(child.id)) continue;
+        const cid = nextSid();
+        if (child.type === "group" && child.prompt) {
+          if (child.condition) els.push({ kind: "condition", indent, snippet: cid, text: `if ${humanize(child.condition)}` });
+          els.push({ kind: "option", indent, snippet: cid, runs: textRuns(textOf(child.prompt.id) || "(option)"), tag: optionTag(child) });
+          for (const c of child.children ?? []) walk(c, indent + 1, cid);
+        } else if (child.type === "snippet") {
+          const beats = child.beats ?? [];
+          const first = beats.find((b) => b.kind === "line" || b.kind === "text");
+          if (child.condition) els.push({ kind: "condition", indent, snippet: cid, text: `if ${humanize(child.condition)}` });
+          els.push({ kind: "option", indent, snippet: cid, runs: textRuns(first ? textOf(first.id) || "(option)" : "(option)"), tag: optionTag(child) });
+          let seenPrompt = false;
+          for (const beat of beats) {
+            if (!seenPrompt && beat === first) {
+              seenPrompt = true;
+              continue;
+            }
+            if (cut.has(beat.id)) continue;
+            if (beat.kind === "line") els.push({ kind: "line", indent: indent + 1, snippet: cid, character: beat.character ?? "", direction: beat.direction, runs: textRuns(textOf(beat.id)) });
+            else if (beat.kind === "text") els.push({ kind: "narration", indent: indent + 1, snippet: cid, runs: textRuns(textOf(beat.id)) });
+            else if (beat.kind === "gameEvent") els.push({ kind: "gameEvent", indent: indent + 1, snippet: cid, text: gameEventLabel(beat) });
+          }
+          if (child.jump) els.push({ kind: "jump", indent: indent + 1, snippet: cid, text: jumpText(child.jump) });
+        } else {
+          walk(child, indent + 1, cid);
+        }
+      }
+      return;
+    }
+    if (node.selector === "branch") {
+      els.push({ kind: "group", indent, label: "One of \xB7 first match wins" });
+      const kids = (node.children ?? []).filter((c) => !cut.has(c.id));
+      kids.forEach((child, i) => {
+        const isCatchAll = i === kids.length - 1 && kids.length > 1 && !("condition" in child && child.condition);
+        if (isCatchAll) els.push({ kind: "else", indent });
+        walk(child, indent, nextSid());
+      });
+      return;
+    }
+    if (node.selector === "sequence") {
+      els.push({ kind: "group", indent, label: sequenceLabel(node) });
+      for (const child of node.children ?? []) walk(child, indent, nextSid());
+      return;
+    }
+    for (const child of node.children ?? []) walk(child, indent, sid);
+  };
+  for (const scene of loaded.scenes) {
+    if (cut.has(scene.id)) continue;
+    els.push({ kind: "scene", text: scene.name });
+    for (const block of scene.blocks) {
+      if (cut.has(block.id)) continue;
+      els.push({ kind: "block", text: block.name });
+      for (const child of block.children ?? []) walk(child, 0, void 0);
+    }
+  }
+  return { project: project.project.name, elements: els };
+}
+
+// src/script-docx.ts
+import { AlignmentType, BorderStyle, Document, HeadingLevel, Packer, Paragraph, TabStopType, TextRun } from "docx";
+var SERIF = "Georgia";
+var SANS = "Calibri";
+var MONO = "Consolas";
+var STEP = 360;
+var SNIPPET_INSET = 220;
+var DIALOGUE_INDENT = 300;
+var HANG = 340;
+var RIGHT_TAB = 9020;
+var SNIP_GAP = 170;
+var WITHIN = 30;
+var S = { h1: 32, h2: 26, body: 22, cue: 18, label: 16, tag: 15, mech: 18 };
+function bodyRuns(runs, color, base = {}) {
+  return runs.map((r) => r.code ? new TextRun({ text: r.text, font: MONO, color: TOKENS.accent, size: S.body - 2 }) : new TextRun({ text: r.text, font: SERIF, color, size: S.body, bold: base.bold || r.bold || void 0, italics: base.italic || r.italic || void 0 }));
+}
+var leftOf = (el) => ("indent" in el ? el.indent * STEP : 0) + ("snippet" in el && el.snippet !== void 0 ? SNIPPET_INSET : 0);
+function paragraph(el, prev) {
+  const sid = "snippet" in el ? el.snippet : void 0;
+  const startsSnippet = sid !== void 0 && (!prev || !("snippet" in prev) || prev.snippet !== sid);
+  const before = sid !== void 0 ? startsSnippet ? SNIP_GAP : WITHIN : 100;
+  switch (el.kind) {
+    case "scene":
+      return new Paragraph({
+        heading: HeadingLevel.HEADING_1,
+        keepNext: true,
+        spacing: { before: 480, after: 200 },
+        border: { bottom: { style: BorderStyle.SINGLE, size: 14, color: TOKENS.accent, space: 6 } },
+        children: [new TextRun({ text: el.text, font: SERIF, bold: true, color: TOKENS.ink, size: S.h1 })]
+      });
+    case "block":
+      return new Paragraph({
+        heading: HeadingLevel.HEADING_2,
+        keepNext: true,
+        spacing: { before: 360, after: 160 },
+        border: { bottom: { style: BorderStyle.SINGLE, size: 4, color: TOKENS.line, space: 4 } },
+        children: [new TextRun({ text: el.text, font: SERIF, bold: true, color: TOKENS.ink, size: S.h2 })]
+      });
+    case "line": {
+      const kids = [];
+      if (el.character) kids.push(new TextRun({ text: el.character.toUpperCase(), font: SANS, bold: true, allCaps: true, color: characterColour(el.character), size: S.cue }), new TextRun({ text: "  ", font: SANS, size: S.cue }));
+      if (el.direction) kids.push(new TextRun({ text: `(${el.direction})  `, font: SERIF, italics: true, color: TOKENS.muted, size: S.body }));
+      kids.push(...bodyRuns(el.runs, TOKENS.inkRead));
+      return new Paragraph({ keepLines: true, spacing: { before, after: 20 }, indent: { left: leftOf(el) + DIALOGUE_INDENT + HANG, hanging: HANG }, children: kids });
+    }
+    case "narration":
+      return new Paragraph({ keepLines: true, spacing: { before, after: 20 }, indent: { left: leftOf(el) }, children: bodyRuns(el.runs, TOKENS.inkSoft) });
+    case "condition":
+      return new Paragraph({ keepNext: true, spacing: { before, after: 20 }, indent: { left: leftOf(el) }, children: [new TextRun({ text: `\u2039 ${el.text} \u203A`, font: MONO, color: TOKENS.accent, size: S.mech - 1 })] });
+    case "group":
+      return new Paragraph({ keepNext: true, spacing: { before: 260, after: 60 }, indent: { left: el.indent * STEP }, children: [new TextRun({ text: el.label.toUpperCase(), font: SANS, bold: true, allCaps: true, color: TOKENS.accent, size: S.label, characterSpacing: 14 })] });
+    case "else":
+      return new Paragraph({ keepNext: true, spacing: { before: 140, after: 20 }, indent: { left: el.indent * STEP }, children: [new TextRun({ text: "else \xB7 catch-all", font: SANS, allCaps: true, color: TOKENS.muted, size: S.label, characterSpacing: 12 })] });
+    case "option": {
+      const kids = [new TextRun({ text: "\u25C7  ", color: TOKENS.accent, size: S.body }), ...bodyRuns(el.runs, TOKENS.ink)];
+      if (el.tag) kids.push(new TextRun({ text: "	", size: S.body }), new TextRun({ text: el.tag, font: SANS, smallCaps: true, color: TOKENS.muted, size: S.tag }));
+      return new Paragraph({ keepLines: true, spacing: { before, after: 20 }, indent: { left: leftOf(el) + HANG, hanging: HANG }, tabStops: el.tag ? [{ type: TabStopType.RIGHT, position: RIGHT_TAB }] : void 0, children: kids });
+    }
+    case "jump":
+      return new Paragraph({ keepLines: true, alignment: AlignmentType.RIGHT, spacing: { before: 40, after: 40 }, children: [new TextRun({ text: `\u21AA  ${el.text}`, font: SANS, bold: true, color: TOKENS.accent, size: S.mech })] });
+    case "gameEvent":
+      return new Paragraph({ keepLines: true, alignment: AlignmentType.RIGHT, spacing: { before: 40, after: 40 }, children: [new TextRun({ text: `\u2699  ${el.text}`, font: MONO, color: TOKENS.accent, size: S.mech - 2 })] });
+  }
+}
+async function scriptToDocx(doc) {
+  const body = [
+    new Paragraph({ spacing: { after: 120 }, children: [new TextRun({ text: "Readable script", font: SANS, bold: true, allCaps: true, color: TOKENS.accent, size: 16, characterSpacing: 30 })] }),
+    new Paragraph({ spacing: { after: 560 }, children: [new TextRun({ text: doc.project, font: SERIF, bold: true, color: TOKENS.ink, size: 52 })] }),
+    ...doc.elements.map((el, i) => paragraph(el, doc.elements[i - 1]))
+  ];
+  const document = new Document({ creator: "Patter", title: doc.project, sections: [{ children: body }] });
+  return Packer.toBuffer(document);
+}
+
+// src/script-pdf.ts
+import PDFDocument from "pdfkit";
+var MARGIN = 64;
+var INDENT_STEP = 20;
+var EDGE_INSET = 12;
+var EDGE_OFF = 3;
+var DIALOGUE_INDENT2 = 14;
+var HANG2 = 18;
+var CUE_GAP = 7;
+var BODY = 11;
+var CUE = 8.5;
+var LEAD = 3.5;
+var WITHIN2 = 4;
+var BETWEEN = 10;
+var BEAT = 6;
+var TIGHT = 3;
+var hex = (h) => `#${h}`;
+var INK = hex(TOKENS.ink);
+var INK_READ = hex(TOKENS.inkRead);
+var INK_SOFT = hex(TOKENS.inkSoft);
+var MUTED = hex(TOKENS.muted);
+var ACCENT = hex(TOKENS.accent);
+var LINE = hex(TOKENS.line);
+var EDGE = "#d7d0c3";
+var SERIF2 = (bold, italic) => bold && italic ? "Serif-BoldItalic" : bold ? "Serif-Bold" : italic ? "Serif-Italic" : "Serif";
+var isEmoji = (cp) => cp >= 126976 || cp >= 9728 && cp <= 10175;
+async function scriptToPdf(doc) {
+  const { scriptFont } = await import("./script-fonts-AQNQOADI.js");
+  return new Promise((resolve4, reject) => {
+    const pdf = new PDFDocument({ size: "A4", margins: { top: MARGIN, bottom: MARGIN, left: MARGIN, right: MARGIN }, info: { Title: doc.project, Author: "Patter" } });
+    pdf.registerFont("Serif", scriptFont("serif"));
+    pdf.registerFont("Serif-Bold", scriptFont("serifBold"));
+    pdf.registerFont("Serif-Italic", scriptFont("serifItalic"));
+    pdf.registerFont("Serif-BoldItalic", scriptFont("serifBoldItalic"));
+    pdf.registerFont("Sans", scriptFont("sans"));
+    pdf.registerFont("Sans-Bold", scriptFont("sansBold"));
+    pdf.registerFont("Mono", scriptFont("mono"));
+    pdf.registerFont("Symbol", scriptFont("symbol"));
+    pdf.registerFont("Emoji", scriptFont("emoji"));
+    const coverage = {};
+    const ascender = {};
+    for (const name of ["Serif", "Serif-Bold", "Serif-Italic", "Serif-BoldItalic", "Sans", "Sans-Bold", "Mono"]) {
+      pdf.font(name);
+      const f = pdf._font;
+      coverage[name] = (cp) => f.font.hasGlyphForCodePoint(cp);
+      ascender[name] = f.ascender;
+    }
+    const ascentPt = (name, size) => ascender[name] / 1e3 * size;
+    const split = (text, primary, color) => {
+      const cov = coverage[primary];
+      const out = [];
+      let buf = "";
+      let cur = primary;
+      for (const ch of text) {
+        const cp = ch.codePointAt(0);
+        const f = isEmoji(cp) ? "Emoji" : cov(cp) ? primary : "Symbol";
+        if (f !== cur) {
+          if (buf) out.push({ text: buf, font: cur, color });
+          buf = "";
+          cur = f;
+        }
+        buf += ch;
+      }
+      if (buf) out.push({ text: buf, font: cur, color });
+      return out;
+    };
+    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", () => resolve4(Buffer.concat(chunks)));
+    pdf.on("error", reject);
+    const pageRight = pdf.page.width - MARGIN;
+    const pageBottom = pdf.page.height - MARGIN;
+    const contentW = pdf.page.width - MARGIN * 2;
+    const ensure = (space) => {
+      if (pdf.y > pageBottom - space) pdf.addPage();
+    };
+    const draw = (pieces, x, opts) => {
+      pieces.forEach((p, i) => {
+        pdf.font(p.font).fillColor(p.color);
+        const cont = i < pieces.length - 1;
+        if (i === 0) pdf.text(p.text, x, pdf.y, { ...opts, continued: cont });
+        else pdf.text(p.text, { continued: cont });
+      });
+    };
+    const drawRight = (pieces, size) => {
+      let total = 0;
+      for (const p of pieces) {
+        pdf.font(p.font).fontSize(size);
+        total += pdf.widthOfString(p.text);
+      }
+      const x = Math.max(MARGIN, pageRight - total);
+      pieces.forEach((p, i) => {
+        pdf.font(p.font).fillColor(p.color).fontSize(size);
+        const cont = i < pieces.length - 1;
+        if (i === 0) pdf.text(p.text, x, pdf.y, { continued: cont });
+        else pdf.text(p.text, { continued: cont });
+      });
+    };
+    pdf.fontSize(9);
+    draw(split("READABLE SCRIPT", "Sans-Bold", ACCENT), MARGIN, { characterSpacing: 2 });
+    pdf.moveDown(0.4).fontSize(26);
+    draw(split(doc.project, "Serif-Bold", INK), MARGIN, { width: contentW });
+    pdf.strokeColor(ACCENT).lineWidth(2).moveTo(MARGIN, pdf.y + 10).lineTo(MARGIN + 40, pdf.y + 10).stroke();
+    pdf.y += 28;
+    const drawContent = (el, cx) => {
+      const w = pageRight - cx;
+      switch (el.kind) {
+        case "scene":
+          pdf.fontSize(17);
+          draw(split(el.text, "Serif-Bold", INK), MARGIN, { width: contentW });
+          pdf.strokeColor(ACCENT).lineWidth(1.5).moveTo(MARGIN, pdf.y + 4).lineTo(MARGIN + 34, pdf.y + 4).stroke();
+          break;
+        case "block":
+          pdf.fontSize(13);
+          draw(split(el.text, "Serif-Bold", INK), MARGIN, { width: contentW });
+          pdf.strokeColor(LINE).lineWidth(0.75).moveTo(MARGIN, pdf.y + 3).lineTo(pageRight, pdf.y + 3).stroke();
+          break;
+        case "line": {
+          const cueX = cx + DIALOGUE_INDENT2;
+          let bodyX = cueX;
+          if (el.character) {
+            pdf.font("Sans-Bold").fontSize(CUE);
+            bodyX = cueX + pdf.widthOfString(el.character.toUpperCase()) + CUE_GAP;
+          }
+          const yTop = pdf.y;
+          pdf.fontSize(BODY);
+          draw([...el.direction ? split(`(${el.direction})  `, "Serif-Italic", MUTED) : [], ...bodyPieces(el.runs, INK_READ)], bodyX, { width: Math.max(120, pageRight - bodyX), lineGap: LEAD });
+          const yEnd = pdf.y;
+          if (el.character) {
+            pdf.font("Sans-Bold").fontSize(CUE).fillColor(hex(characterColour(el.character))).text(el.character.toUpperCase(), cueX, yTop + ascentPt("Serif", BODY) - ascentPt("Sans-Bold", CUE), { lineBreak: false });
+          }
+          pdf.y = yEnd;
+          break;
+        }
+        case "narration":
+          pdf.fontSize(BODY);
+          draw(bodyPieces(el.runs, INK_SOFT), cx, { width: w, lineGap: LEAD });
+          break;
+        case "condition":
+          pdf.fontSize(9.5);
+          draw(split(`\u2039 ${el.text} \u203A`, "Mono", ACCENT), cx, { width: w });
+          break;
+        case "group":
+          pdf.fontSize(8);
+          draw(split(el.label.toUpperCase(), "Sans-Bold", ACCENT), cx, { width: w, characterSpacing: 1.2 });
+          break;
+        case "else":
+          pdf.fontSize(8);
+          draw(split("ELSE \xB7 CATCH-ALL", "Sans", MUTED), cx, { width: w, characterSpacing: 1 });
+          break;
+        case "option": {
+          const ox = cx + HANG2;
+          const tag = el.tag ? el.tag.toUpperCase() : "";
+          const tagW = tag ? pdf.font("Sans").fontSize(7.5).widthOfString(tag) + 8 : 0;
+          const yStart = pdf.y;
+          pdf.fontSize(BODY);
+          draw([...split("\u25C7  ", "Serif", ACCENT), ...bodyPieces(el.runs, INK)], ox, { width: Math.max(80, pageRight - ox - tagW), indent: -HANG2, lineGap: LEAD });
+          const yEnd = pdf.y;
+          if (tag && yEnd >= yStart) {
+            pdf.font("Sans").fontSize(7.5).fillColor(MUTED).text(tag, pageRight - tagW, yStart, { width: tagW, align: "right", lineBreak: false });
+            pdf.y = yEnd;
+          }
+          break;
+        }
+        case "jump":
+          drawRight(split(`\u21AA  ${el.text}`, "Sans-Bold", ACCENT), 9.5);
+          break;
+        case "gameEvent":
+          drawRight(split(`\u2699  ${el.text}`, "Mono", ACCENT), 9);
+          break;
+      }
+    };
+    const leadOf = (k) => k === "scene" ? 24 : k === "block" ? 16 : k === "group" ? 13 : k === "else" ? 9 : 0;
+    const els = doc.elements;
+    let curSid;
+    let curBase = 0;
+    for (let i = 0; i < els.length; i++) {
+      const el = els[i];
+      const next = els[i + 1];
+      const sid = "snippet" in el ? el.snippet : void 0;
+      const sameNext = sid !== void 0 && next !== void 0 && "snippet" in next && next.snippet === sid;
+      if (el.kind === "scene") ensure(90);
+      else if (el.kind === "block") ensure(70);
+      pdf.y += leadOf(el.kind);
+      const base = "indent" in el ? MARGIN + el.indent * INDENT_STEP : MARGIN;
+      const cx = base + (sid !== void 0 ? EDGE_INSET : 0);
+      const yTop = pdf.y;
+      drawContent(el, cx);
+      const bottom = pdf.y;
+      const trail = el.kind === "condition" ? TIGHT : el.kind === "scene" ? 12 : el.kind === "block" ? 11 : el.kind === "group" ? 7 : el.kind === "else" ? 4 : sid !== void 0 ? sameNext ? WITHIN2 : BETWEEN : BEAT;
+      if (sid !== void 0) {
+        if (sid !== curSid) {
+          curSid = sid;
+          curBase = "indent" in el ? el.indent : 0;
+        }
+        const ex = MARGIN + curBase * INDENT_STEP + EDGE_OFF;
+        pdf.strokeColor(EDGE).lineWidth(0.75).moveTo(ex, yTop).lineTo(ex, bottom + (sameNext ? trail : 0)).stroke();
+      }
+      pdf.y = bottom + trail;
+    }
+    pdf.end();
+  });
+}
+
+// src/init.ts
+import { join as join4, basename as basename5, resolve as resolve3 } from "path";
+import { readdirSync as readdirSync3, existsSync as existsSync2 } from "fs";
+import { newId, slug, canonicalStringify as canonicalStringify4 } from "@patterkit/core";
+function runInit(opts) {
+  const dir = resolve3(opts.dir);
+  const name = opts.name?.trim() || basename5(dir).replace(/\.patter$/, "");
+  const fileSlug = slug(name);
+  let existing = [];
+  try {
+    existing = readdirSync3(dir).filter((f) => f.endsWith(".patterproj"));
+  } catch {
+  }
+  if (existing.length > 0) throw new Error(`a project already exists here: ${existing[0]}`);
+  const sceneId = newId("scn");
+  const beatId = newId("T");
+  const project = {
+    schema: "patter/project@0",
+    project: { id: newId("proj"), name },
+    locales: { default: "en", all: ["en"] },
+    ...opts.vcs ? { vcs: opts.vcs } : {},
+    // record the chosen VCS so it can be read / switched later
+    voiced: true
+  };
+  const flow = {
+    schema: "patter/flow@0",
+    scene: {
+      id: sceneId,
+      type: "scene",
+      name: "Start",
+      blocks: [{
+        id: newId("blk"),
+        type: "block",
+        name: "Main",
+        children: [{
+          id: newId("sn"),
+          type: "snippet",
+          beats: [{ id: beatId, kind: "text" }],
+          jump: { to: "END" }
+        }]
+      }]
+    }
+  };
+  const locale = {
+    schema: "patter/strings@0",
+    scene: sceneId,
+    locale: "en",
+    default: true,
+    strings: { [beatId]: `Welcome to ${name}. Edit scenes/start.patterflow, then run: patter play` }
+  };
+  const bundle = opts.bundle ?? "commit";
+  const projectFile = join4(dir, `${fileSlug}.patterproj`);
+  const writes = [
+    { path: projectFile, content: canonicalStringify4(project) },
+    { path: join4(dir, "scenes", "start.patterflow"), content: canonicalStringify4(flow) },
+    { path: join4(dir, "loc", "en", "start.patterloc"), content: canonicalStringify4(locale) },
+    { path: join4(dir, ".editorconfig"), content: EDITORCONFIG },
+    ...vcsConfigWrites(dir, opts.vcs, bundle)
+  ];
+  const collisions = writes.map((w) => w.path).filter((p) => existsSync2(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: join4(dir, "vcs-setup.md"), content: vcsSetup(vcs, bundle) }];
+  if (vcs === "git") writes.push({ path: join4(dir, ".gitattributes"), content: GITATTRIBUTES });
+  const ignore = ignoreFileFor(vcs);
+  if (ignore) writes.push({ path: join4(dir, ignore), content: ignoreContent(bundle) });
+  return writes;
+}
+var EDITORCONFIG = `# Patter projects are UTF-8 + LF, always (spec - patter format enforces this).
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+
+[*.{patterflow,patterloc,patterx,patterproj}]
+indent_style = space
+indent_size = 2
+`;
+var GITATTRIBUTES = `# Patter source is UTF-8 + LF text (pinned; never let autocrlf touch it).
+*.patterflow text eol=lf
+*.patterloc  text eol=lf
+*.patterx    text eol=lf
+*.patterproj text eol=lf
+
+# Id-keyed structured merge for Patter source (the 'patter merge' driver).
+# Register it once per clone (see vcs-setup.md); until then git falls back to a
+# normal text merge for these - no harm, just not structure-aware.
+*.patterflow merge=patter
+*.patterloc  merge=patter
+*.patterx    merge=patter
+*.patterproj merge=patter
+
+# Generated artifacts (spec \xA711). The compiled bundle is committed but
+# REGENERATED, never hand-merged - keep ours on conflict and rebuild (the
+# validate staleness gate catches a stale one). Needs a one-time
+# 'git config merge.ours.driver true' (see vcs-setup.md).
+*.patterc    text eol=lf merge=ours
+# The packed document (.patterpack) is a binary zip envelope - kept out of VCS (.gitignore).
+*.patterpack binary
+`;
+function ignoreFileFor(vcs) {
+  switch (vcs) {
+    case "git":
+      return ".gitignore";
+    case "perforce":
+      return ".p4ignore";
+    case "plastic":
+      return "ignore.conf";
+    default:
+      return void 0;
+  }
+}
+function ignoreContent(bundle) {
+  const lines = [
+    "# Patter generated artifacts - not source (see vcs-setup.md).",
+    "# Packed document (the send-and-return envelope):",
+    "*.patterpack",
+    "# Unresolved merge sidecar:",
+    "*.patterconflict"
+  ];
+  if (bundle === "ignore") {
+    lines.push("# Compiled bundle (built in CI, not committed under this posture):", "*.patterc");
+  }
+  return lines.join("\n") + "\n";
+}
+function vcsSetup(vcs, bundle) {
+  const sections = {
+    git: `## git
+
+\`.gitattributes\` (already emitted) pins Patter source shards to UTF-8 + LF text
+and marks the generated artifacts (the \`.patterc\` bundle \`merge=ours\`, the
+\`.patterpack\` document \`binary\`). \`.gitignore\` (already emitted) keeps the document
+(and the bundle, under the "ignore" posture) out of source control.
+
+Recommended pre-commit hook (\`.git/hooks/pre-commit\`, executable):
+
+    #!/bin/sh
+    patter validate || exit 1
+
+The \`merge=patter\` rules in \`.gitattributes\` are already active; register the
+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.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.
+`,
+    perforce: `## Perforce
+
+Add Patter extensions to the typemap (\`p4 typemap\`): source shards and the
+compiled bundle are TEXT with LF; the packed document is BINARY:
+
+    text   //....patterflow
+    text   //....patterloc
+    text   //....patterx
+    text   //....patterproj
+    text   //....patterc
+    binary //....patterpack
+
+On a unicode-mode server, set \`P4CHARSET=utf8\`. For the lock-based workflow
+(spec: one scene per file = one lock per scene), add \`+l\` to make checkouts
+exclusive. A \`.p4ignore\` (already emitted) keeps the packed document out of the
+depot.
+
+Perforce allows ONE global merge tool, so set \`patter mergetool\` as it - it
+runs the structured merge for Patter source and hands everything else to your
+normal tool. Map Perforce's variables into the order BASE THEIRS OURS OUT:
+
+    patter mergetool --fallback "<your merge tool>" %b %t %y %r
+
+(\`%b\` base, \`%t\` theirs, \`%y\` yours/ours, \`%r\` result - adjust to your P4
+client's variable names; the argument ORDER is what matters.)
+`,
+    plastic: `## Plastic SCM (Unity VC)
+
+Patter source shards are plain UTF-8 text; Plastic handles them as-is. The
+\`ignore.conf\` (already emitted) keeps the packed document out of the repo. For
+the lock-based workflow, configure exclusive checkout (lock.conf) for the shard
+extensions.
+
+In Preferences > Merge tools, add an external tool (a global entry is fine -
+the wrapper sniffs the path) with the arguments in BASE THEIRS OURS OUT order:
+
+    patter mergetool --fallback "<your merge tool>" @basefile @sourcefile @destinationfile @output
+`,
+    svn: `## SVN
+
+Set auto-props so Patter source keeps LF (\`~/.subversion/config\` or repo config):
+
+    [auto-props]
+    *.patterflow = svn:eol-style=LF
+    *.patterloc = svn:eol-style=LF
+    *.patterx = svn:eol-style=LF
+    *.patterproj = svn:eol-style=LF
+    *.patterc = svn:eol-style=LF
+    *.patterpack = svn:mime-type=application/octet-stream
+
+SVN's ignore is a directory PROPERTY, not a file - set it from the project root:
+
+    svn propset svn:ignore "*.patterpack${bundle === "ignore" ? "\\n*.patterc" : ""}\\n*.patterconflict" .
+
+For the lock-based workflow add \`svn:needs-lock\` to the shard patterns.
+
+SVN allows one global merge tool. Point \`[helpers] merge-tool-cmd\` at a small
+wrapper script that forwards SVN's four arguments (base theirs mine merged =
+BASE THEIRS OURS OUT) to \`patter mergetool\`:
+
+    #!/bin/sh
+    exec patter mergetool --fallback "<your merge tool>" "$1" "$2" "$3" "$4"
+`
+  };
+  const head = vcs ? sections[vcs] : `No VCS selected (\`patter init --vcs git|perforce|plastic|svn\` emits tailored
+config). Whichever you adopt, the rules are the same: Patter source is UTF-8 +
+LF text, one scene per file, and \`patter validate\` belongs in your pre-commit /
+CI. Sections for every supported VCS:
+
+${Object.keys(sections).map((k) => sections[k]).join("\n")}`;
+  return `# Version-control setup for this Patter project
+
+${head}
+${bundleSection(bundle)}`;
+}
+function bundleSection(bundle) {
+  const posture = bundle === "commit" ? `This project COMMITS the compiled \`.patterc\` bundle (\`patter init --bundle ignore\`
+to build it in CI instead). The bundle is regenerated, never hand-merged: on a
+conflict, keep ours and re-run \`patter export\`. \`patter validate\` recomputes the
+bundle's embedded hash from source and FAILS if it is stale, so a forgotten
+regenerate cannot ship silently.` : `This project IGNORES the compiled \`.patterc\` bundle (built in CI; \`patter init
+--bundle commit\` to commit it instead). Run \`patter export\` as a build step.`;
+  return `## Compiled bundle & packed document
+
+${posture}
+
+The packed \`.patterpack\` document (\`patter pack\`) is the send-and-return envelope
+for collaborators without VCS. It is a binary zip and a projection of the
+shards - NOT source - so it stays out of version control (ignored above); edits
+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";
+function runResolve(loaded, query) {
+  const entries = indexProject(loaded);
+  const q = query.trim();
+  const ql = q.toLowerCase();
+  const tiers = [
+    (e) => e.id === q,
+    (e) => e.gameId?.toLowerCase() === ql,
+    (e) => e.name?.toLowerCase() === ql,
+    (e) => e.id.toLowerCase().includes(ql) || (e.gameId?.toLowerCase().includes(ql) ?? false) || (e.name?.toLowerCase().includes(ql) ?? false)
+  ];
+  for (const match of tiers) {
+    const hits = entries.filter(match);
+    if (hits.length > 0) return hits;
+  }
+  return [];
+}
+function runSearch(loaded, query, focus) {
+  const ql = query.trim().toLowerCase();
+  if (!ql) return [];
+  const entries = indexProject(loaded);
+  const inMeta = (e) => (e.gameId?.toLowerCase().includes(ql) ?? false) || (e.name?.toLowerCase().includes(ql) ?? false);
+  const inText = (e) => e.text?.toLowerCase().includes(ql) ?? false;
+  const inTech = (e) => e.id.toLowerCase().includes(ql);
+  const matched = entries.map((e, i) => ({ e, i })).filter(({ e }) => inMeta(e) || inText(e) || inTech(e));
+  if (!focus) {
+    const meta = matched.filter(({ e }) => inMeta(e)).map((m) => m.e);
+    const text = matched.filter(({ e }) => !inMeta(e) && inText(e)).map((m) => m.e);
+    const tech = matched.filter(({ e }) => !inMeta(e) && !inText(e) && inTech(e)).map((m) => m.e);
+    return [...meta, ...text, ...tech];
+  }
+  const cut = focus.fromBeatId ? entries.findIndex((e) => e.id === focus.fromBeatId) : -1;
+  const group = (e, i) => e.sceneId !== focus.sceneId ? 2 : cut < 0 || i >= cut ? 0 : 1;
+  return matched.sort((a, b) => group(a.e, a.i) - group(b.e, b.i) || a.i - b.i).map((m) => m.e);
+}
+function runStatusBrowse(loaded, status, dimension = "writing", focus, recordingOverride) {
+  const strings = sourceStrings(loaded);
+  const merged = mergeAuthoring(loaded);
+  const recording = dimension === "recording";
+  const statusOf = recording ? recordingOverride ?? merged.recording : merged.writing;
+  const ladder = recording ? loaded.project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES4 : loaded.project.writingStatuses ?? DEFAULT_WRITING_STATUSES3;
+  const lowest = ladder[0]?.name;
+  const out = [];
+  for (const scene of loaded.scenes) {
+    const file = loaded.sceneFiles[scene.id];
+    for (const block of scene.blocks) {
+      const segments = [scene.name, block.name];
+      const consider = (beat) => {
+        const tracked = recording ? beat.kind === "line" : beat.kind === "line" || beat.kind === "text";
+        if (!tracked) return;
+        if ((statusOf.get(beat.id) ?? lowest) !== status) return;
+        out.push({ id: beat.id, kind: "beat", text: strings[beat.id], location: segments, sceneId: scene.id, file });
+      };
+      walkNodes4(block.children, (node) => {
+        if (node.type === "group") {
+          if (node.prompt) consider(node.prompt);
+          return;
+        }
+        for (const beat of node.beats ?? []) consider(beat);
+      });
+    }
+  }
+  if (focus) out.sort((a, b) => (a.sceneId === focus.sceneId ? 0 : 1) - (b.sceneId === focus.sceneId ? 0 : 1));
+  return out;
+}
+function listProjectTags(loaded) {
+  const counts = /* @__PURE__ */ new Map();
+  const add = (tags) => {
+    for (const t of tags ?? []) counts.set(t, (counts.get(t) ?? 0) + 1);
+  };
+  for (const scene of loaded.scenes) {
+    add(scene.tags);
+    for (const block of scene.blocks) {
+      add(block.tags);
+      walkNodes4(block.children, (node) => {
+        add(node.tags);
+        if (node.type === "group") {
+          add(node.prompt?.tags);
+          return;
+        }
+        for (const beat of node.beats ?? []) add(beat.tags);
+      });
+    }
+  }
+  return [...counts.entries()].map(([name, count]) => ({ name, count })).sort((a, b) => a.name.localeCompare(b.name));
+}
+function runTagBrowse(loaded, tag, focus) {
+  if (!tag) return [];
+  const strings = sourceStrings(loaded);
+  const has = (tags) => !!tags && tags.includes(tag);
+  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 });
+    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(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 });
+        }
+        if (node.type === "group") {
+          if (node.prompt && has(node.prompt.tags)) out.push({ id: node.prompt.id, kind: "beat", text: strings[node.prompt.id], location: segments, sceneId: scene.id, file });
+          return;
+        }
+        for (const beat of node.beats ?? []) if (has(beat.tags)) out.push({ id: beat.id, kind: "beat", text: strings[beat.id], location: segments, sceneId: scene.id, file });
+      });
+    }
+  }
+  if (focus) out.sort((a, b) => (a.sceneId === focus.sceneId ? 0 : 1) - (b.sceneId === focus.sceneId ? 0 : 1));
+  return out;
+}
+function runPropertyUsage(loaded, query, focus) {
+  const parsed = parsePropertyQuery(query);
+  if (!parsed) return [];
+  const { regexes, value } = parsed;
+  const strings = sourceStrings(loaded);
+  const refs = (src) => !!src && regexes.some((re) => re.test(src));
+  const valueOk = (src) => !value || src.toLowerCase().includes(value);
+  const out = [];
+  for (const scene of loaded.scenes) {
+    const file = loaded.sceneFiles[scene.id];
+    const push = (id, kind, segments, usage) => {
+      out.push({ id, kind, text: usage, location: segments, sceneId: scene.id, file });
+    };
+    for (const e of scene.onEntry ?? []) {
+      const src = `${e.target} = ${e.value}`;
+      if ((refs(e.target) || refs(e.value)) && valueOk(src)) push(scene.id, "scene", [scene.name], `on entry: set ${src}`);
+    }
+    for (const block of scene.blocks) {
+      const segments = [scene.name, block.name];
+      walkNodes4(block.children, (node) => {
+        if (refs(node.condition) && valueOk(node.condition)) push(node.id, node.type, segments, `if ${node.condition}`);
+        if (node.type === "group") {
+          if (node.prompt && refs(strings[node.prompt.id]) && valueOk(strings[node.prompt.id])) push(node.prompt.id, "beat", segments, strings[node.prompt.id]);
+          return;
+        }
+        for (const phase of ["onEnter", "onExit"]) {
+          for (const e of node[phase] ?? []) {
+            const src = `${e.target} = ${e.value}`;
+            if ((refs(e.target) || refs(e.value)) && valueOk(src)) push(node.id, "snippet", segments, `${phase === "onEnter" ? "on enter" : "on exit"}: set ${src}`);
+          }
+        }
+        for (const beat of node.beats ?? []) {
+          if (refs(strings[beat.id]) && valueOk(strings[beat.id])) push(beat.id, "beat", segments, strings[beat.id]);
+        }
+      });
+    }
+  }
+  if (focus) out.sort((a, b) => (a.sceneId === focus.sceneId ? 0 : 1) - (b.sceneId === focus.sceneId ? 0 : 1));
+  return out;
+}
+function parsePropertyQuery(query) {
+  const m = /^@?([A-Za-z_]\w*(?:\.[A-Za-z_]\w*)?)(.*)$/.exec(query.trim());
+  if (!m) return null;
+  const prop = m[1];
+  const value = m[2].replace(/^[\s=<>!]+/, "").replace(/^["']|["']$/g, "").trim().toLowerCase() || void 0;
+  const esc2 = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  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;
+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 entries = buildIndex(loaded);
+  indexCache = { loaded, scenes: [...loaded.scenes], locales: [...loaded.locales], entries };
+  return entries;
+}
+function buildIndex(loaded) {
+  const out = [];
+  const strings = sourceStrings(loaded);
+  for (const scene of loaded.scenes) {
+    const file = loaded.sceneFiles[scene.id];
+    out.push({
+      id: scene.id,
+      kind: "scene",
+      name: scene.name,
+      gameId: effectiveGameId(scene),
+      location: [scene.name],
+      sceneId: scene.id,
+      file
+    });
+    for (const block of scene.blocks) {
+      const segments = [scene.name, block.name];
+      out.push({
+        id: block.id,
+        kind: "block",
+        name: block.name,
+        gameId: effectiveGameId(block),
+        location: segments,
+        sceneId: scene.id,
+        file
+      });
+      walkNodes4(block.children, (node) => {
+        out.push({
+          id: node.id,
+          kind: node.type,
+          location: segments,
+          sceneId: scene.id,
+          file
+        });
+        if (node.type === "group" && node.prompt) {
+          out.push({
+            id: node.prompt.id,
+            kind: "beat",
+            text: strings[node.prompt.id],
+            location: segments,
+            sceneId: scene.id,
+            file
+          });
+          return;
+        }
+        if (node.type !== "snippet") return;
+        for (const beat of node.beats ?? []) {
+          out.push({
+            id: beat.id,
+            kind: "beat",
+            text: strings[beat.id],
+            location: segments,
+            sceneId: scene.id,
+            file
+          });
+        }
+      });
+    }
+  }
+  return out;
+}
+
+// src/replace.ts
+import { canonicalStringify as canonicalStringify5 } from "@patterkit/core";
+import { walkNodes as walkNodes5, PROJECT_LOCALE_SCENE as PROJECT_LOCALE_SCENE2 } from "@patterkit/model";
+function matcher(opts) {
+  if (!opts.query) return null;
+  const esc2 = opts.query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const body = opts.wholeWord ? `\\b${esc2}\\b` : esc2;
+  return new RegExp(body, opts.caseSensitive ? "g" : "gi");
+}
+function runReplace(loaded, opts) {
+  const plan = { hits: [], writes: [], shards: [], scenes: 0 };
+  const re = matcher(opts);
+  if (!re) return plan;
+  const def = loaded.project.locales.default;
+  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) => {
+        if (node.type === "group") {
+          if (node.prompt) locOf.set(node.prompt.id, segs);
+          return;
+        }
+        for (const b of node.beats ?? []) locOf.set(b.id, segs);
+      });
+    }
+  }
+  for (let i = 0; i < loaded.locales.length; i++) {
+    const shard = loaded.locales[i];
+    if (shard.locale !== def || shard.scene === PROJECT_LOCALE_SCENE2) continue;
+    const path = loaded.localeFiles[i];
+    if (!path) continue;
+    let changed = false;
+    const merged = { ...shard.strings };
+    for (const [id, before] of Object.entries(shard.strings)) {
+      if (opts.onlyId && id !== opts.onlyId) continue;
+      re.lastIndex = 0;
+      if (!re.test(before)) continue;
+      const after = before.replace(re, () => opts.replacement);
+      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;
+    }
+    if (changed) {
+      const next = { ...shard, strings: merged };
+      plan.writes.push({ path, content: canonicalStringify5(next) });
+      plan.shards.push(next);
+      plan.scenes++;
+    }
+  }
+  return plan;
+}
+
+// src/pack.ts
+import JSZip from "jszip";
+import { readFileSync as readFileSync4 } from "fs";
+import { dirname as dirname4, relative, sep as sep2 } from "path";
+import { parseSource as parseSource4 } from "@patterkit/core";
+var SHARD_EXTENSIONS = [".patterflow", ".patterloc", ".patterx", ".patterproj"];
+var FIXED_DATE = /* @__PURE__ */ new Date("2000-01-01T00:00:00Z");
+async function runPack(startPath) {
+  const projectFile = findProjectFile(startPath);
+  const root = dirname4(projectFile);
+  const project = parseSource4(readFileSync4(projectFile, "utf8"));
+  const files = SHARD_EXTENSIONS.flatMap((ext) => walkFiles(root, ext)).map((abs) => ({ abs, rel: relative(root, abs).split(sep2).join("/") })).sort((a, b) => a.rel.localeCompare(b.rel));
+  const manifest = {
+    schema: "patter/document@0",
+    project: { id: project.project.id, name: project.project.name },
+    files: files.map((f) => f.rel)
+  };
+  const zip = new JSZip();
+  zip.file("patter.manifest.json", JSON.stringify(manifest, null, 2) + "\n", { date: FIXED_DATE });
+  for (const f of files) zip.file(f.rel, readFileSync4(f.abs, "utf8"), { date: FIXED_DATE });
+  return zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE", streamFiles: false });
+}
+
+// src/unpack.ts
+import JSZip2 from "jszip";
+import { join as join5, normalize, isAbsolute as isAbsolute2, sep as sep3 } from "path";
+import { existsSync as existsSync3, readFileSync as readFileSync5 } from "fs";
+import { parseSource as parseSource5, canonicalStringify as canonicalStringify7 } from "@patterkit/core";
+
+// src/merge.ts
+import { canonicalStringify as canonicalStringify6 } from "@patterkit/core";
+var UnsupportedMergeError = class extends Error {
+};
+var eq = (a, b) => canonicalStringify6(a) === canonicalStringify6(b);
+var isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+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";
+  throw new UnsupportedMergeError(`cannot detect a Patter merge type from schema '${s}'`);
+}
+function runMerge(base, ours, theirs, opts) {
+  const type = opts?.type ?? detectMergeType(ours);
+  switch (type) {
+    case "loc":
+      return mergeLoc(base, ours, theirs);
+    case "authoring":
+      return mergeAuthoring2(base, ours, theirs);
+    case "flow":
+      return mergeFlow(base, ours, theirs);
+    case "project":
+      return mergeProject(base, ours, theirs);
+  }
+}
+function deletedKind(base, ours, theirs) {
+  const deleted = base !== void 0 && (ours === void 0 || theirs === void 0);
+  return deleted ? "delete-vs-edit" : "both-changed";
+}
+function merge3(base, ours, theirs, id, path, conflicts) {
+  if (eq(ours, theirs)) return ours;
+  if (eq(base, ours)) return theirs;
+  if (eq(base, theirs)) return ours;
+  conflicts.push({ id, path, base, ours, theirs, kind: deletedKind(base, ours, theirs) });
+  return ours;
+}
+function mergeMap(base, ours, theirs, prefix, conflicts, resolve4) {
+  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];
+    let v;
+    if (eq(o, t)) v = o;
+    else if (eq(b, o)) v = t;
+    else if (eq(b, t)) v = o;
+    else {
+      const r = resolve4?.(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) });
+        v = o;
+      }
+    }
+    if (v !== void 0) out[k] = v;
+  }
+  return out;
+}
+var asMap = (v) => isObj(v) ? v : {};
+var asArr = (v) => Array.isArray(v) ? v : [];
+function setIf(obj, key, val) {
+  if (Array.isArray(val) ? val.length > 0 : Object.keys(val).length > 0) obj[key] = val;
+}
+function mergeLoc(base, ours, theirs) {
+  const conflicts = [];
+  const merged = {};
+  for (const f of ["schema", "scene", "locale", "default"]) {
+    const v = merge3(base[f], ours[f], theirs[f], "", f, conflicts);
+    if (v !== void 0) merged[f] = v;
+  }
+  merged.strings = mergeMap(asMap(base.strings), asMap(ours.strings), asMap(theirs.strings), "strings", conflicts);
+  return { type: "loc", merged, conflicts, warnings: [] };
+}
+function mergeAuthoring2(base, ours, theirs) {
+  const conflicts = [];
+  const merged = {};
+  merged.schema = merge3(base.schema, ours.schema, theirs.schema, "", "schema", conflicts) ?? ours.schema;
+  setIf(merged, "comments", mergeComments(asArr(base.comments), asArr(ours.comments), asArr(theirs.comments)));
+  const edits = mergeEdits(asMap(base.edits), asMap(ours.edits), asMap(theirs.edits));
+  setIf(merged, "edits", edits);
+  const lww = lastWriterWins(asMap(ours.edits), asMap(theirs.edits));
+  for (const f of ["writing", "recording", "audio"]) {
+    setIf(merged, f, mergeMap(asMap(base[f]), asMap(ours[f]), asMap(theirs[f]), f, conflicts, lww));
+  }
+  setIf(merged, "documentation", mergeMap(asMap(base.documentation), asMap(ours.documentation), asMap(theirs.documentation), "documentation", conflicts));
+  setIf(merged, "cut", mergeMap(asMap(base.cut), asMap(ours.cut), asMap(theirs.cut), "cut", conflicts, void 0));
+  return { type: "authoring", merged, conflicts, warnings: [] };
+}
+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);
+  }
+  return [...byId.values()].sort((a, b) => String(a.ts ?? "").localeCompare(String(b.ts ?? "")));
+}
+function lastWriterWins(oursEdits, theirsEdits) {
+  return (id, _b, o, t) => {
+    const om = asMap(oursEdits[id]).modifiedAt, tm = asMap(theirsEdits[id]).modifiedAt;
+    if (typeof om === "string" && typeof tm === "string") return { resolved: true, value: om >= tm ? o : t };
+    return { resolved: false, kind: "no-timestamp" };
+  };
+}
+function mergeEdits(base, ours, theirs) {
+  const out = {};
+  for (const id of /* @__PURE__ */ new Set([...Object.keys(base), ...Object.keys(ours), ...Object.keys(theirs)])) {
+    const o = ours[id], t = theirs[id];
+    if (eq(o, t)) {
+      if (o !== void 0) out[id] = o;
+      continue;
+    }
+    if (o === void 0) {
+      if (t !== void 0) out[id] = t;
+      continue;
+    }
+    if (t === void 0) {
+      out[id] = o;
+      continue;
+    }
+    out[id] = mergeEditRecord(asMap(o), asMap(t));
+  }
+  return out;
+}
+function mergeEditRecord(o, t) {
+  const om = typeof o.modifiedAt === "string" ? o.modifiedAt : "";
+  const tm = typeof t.modifiedAt === "string" ? t.modifiedAt : "";
+  const newer = om >= tm ? o : t;
+  const ol = asMap(o.localisedAt), tl = asMap(t.localisedAt);
+  const loc = {};
+  for (const k of /* @__PURE__ */ new Set([...Object.keys(ol), ...Object.keys(tl)])) {
+    const a = typeof ol[k] === "string" ? ol[k] : "";
+    const b = typeof tl[k] === "string" ? tl[k] : "";
+    loc[k] = a >= b ? ol[k] ?? tl[k] : tl[k] ?? ol[k];
+  }
+  const merged = { ...newer };
+  if (Object.keys(loc).length > 0) merged.localisedAt = loc;
+  return merged;
+}
+function mergeKeyedByName(base, ours, theirs, path, conflicts) {
+  const byName = (arr) => {
+    const m = {};
+    for (const p of arr) if (isObj(p) && typeof p.name === "string") m[p.name] = p;
+    return m;
+  };
+  const merged = mergeMap(byName(base), byName(ours), byName(theirs), path, conflicts);
+  return Object.keys(merged).sort().map((name) => merged[name]);
+}
+function mergeProject(base, ours, theirs) {
+  const conflicts = [];
+  const merged = {};
+  for (const k of /* @__PURE__ */ new Set([...Object.keys(base), ...Object.keys(ours), ...Object.keys(theirs)])) {
+    if (k === "properties" || k === "cast") {
+      const v = mergeKeyedByName(asArr(base[k]), asArr(ours[k]), asArr(theirs[k]), k, conflicts);
+      if (v.length > 0) merged[k] = v;
+    } else if (k === "gameDataFields") {
+      const v = mergeGameDataFields(asMap(base[k]), asMap(ours[k]), asMap(theirs[k]), conflicts);
+      if (Object.keys(v).length > 0) merged[k] = v;
+    } else if (k === "locales") {
+      merged.locales = mergeLocales(asMap(base.locales), asMap(ours.locales), asMap(theirs.locales), conflicts);
+    } else {
+      const v = merge3(base[k], ours[k], theirs[k], "", k, conflicts);
+      if (v !== void 0) merged[k] = v;
+    }
+  }
+  return { type: "project", merged, conflicts, warnings: [] };
+}
+function mergeGameDataFields(b, o, t, conflicts) {
+  const out = {};
+  for (const kind of /* @__PURE__ */ new Set([...Object.keys(b), ...Object.keys(o), ...Object.keys(t)])) {
+    const v = mergeKeyedByName(asArr(b[kind]), asArr(o[kind]), asArr(t[kind]), `gameDataFields.${kind}`, conflicts);
+    if (v.length > 0) out[kind] = v;
+  }
+  return out;
+}
+function mergeLocales(b, o, t, conflicts) {
+  const out = {};
+  const def = merge3(b.default, o.default, t.default, "", "locales.default", conflicts);
+  if (def !== void 0) out.default = def;
+  const all = [];
+  for (const arr of [asArr(b.all), asArr(o.all), asArr(t.all)]) {
+    for (const x of arr) if (typeof x === "string" && !all.includes(x)) all.push(x);
+  }
+  out.all = all;
+  return out;
+}
+var CHILD_KEYS = ["blocks", "children", "beats"];
+function toTree(raw) {
+  const childKey = CHILD_KEYS.find((k) => Array.isArray(raw[k]));
+  const fields = {};
+  for (const [k, v] of Object.entries(raw)) if (k !== childKey) fields[k] = v;
+  const children = childKey ? raw[childKey].filter(isObj).map(toTree) : [];
+  return { id: typeof raw.id === "string" ? raw.id : "", fields, childKey, children };
+}
+function fromTree(n) {
+  const out = { ...n.fields };
+  if (n.childKey) out[n.childKey] = n.children.map(fromTree);
+  return out;
+}
+function mergeFlow(base, ours, theirs) {
+  const conflicts = [];
+  const warnings = [];
+  const merged = {};
+  merged.schema = merge3(base.schema, ours.schema, theirs.schema, "", "schema", conflicts) ?? ours.schema;
+  const bScene = isObj(base.scene) ? toTree(base.scene) : void 0;
+  const oScene = toTree(asMap(ours.scene));
+  const tScene = isObj(theirs.scene) ? toTree(theirs.scene) : void 0;
+  const mergedScene = mergeNode(bScene, oScene, tScene, "scene", conflicts, warnings);
+  merged.scene = fromTree(mergedScene);
+  checkDuplicateIds(mergedScene, conflicts);
+  return { type: "flow", merged, conflicts, warnings };
+}
+function mergeNode(b, o, t, path, conflicts, warnings) {
+  const fields = mergeFields(b?.fields ?? {}, o.fields, t?.fields ?? {}, o.id, path, conflicts);
+  const childKey = o.childKey ?? t?.childKey ?? b?.childKey;
+  const children = childKey ? mergeChildren(b?.children ?? [], o.children, t?.children ?? [], `${path}.${childKey}`, conflicts, warnings) : [];
+  return { id: o.id, fields, childKey, children };
+}
+function mergeFields(b, o, t, id, path, conflicts) {
+  const out = {};
+  for (const k of /* @__PURE__ */ new Set([...Object.keys(b), ...Object.keys(o), ...Object.keys(t)])) {
+    const v = merge3(b[k], o[k], t[k], id, `${path}.${k}`, conflicts);
+    if (v !== void 0) out[k] = v;
+  }
+  return out;
+}
+function mergeChildren(B, O, T, path, conflicts, warnings) {
+  const Bm = idMap(B), Om = idMap(O), Tm = idMap(T);
+  const Bset = new Set(Bm.keys()), Oset = new Set(Om.keys()), Tset = new Set(Tm.keys());
+  const merged = /* @__PURE__ */ new Map();
+  const here = (id) => `${path}[${id}]`;
+  for (const id of /* @__PURE__ */ new Set([...Bm.keys(), ...Om.keys(), ...Tm.keys()])) {
+    const b = Bm.get(id), o = Om.get(id), t = Tm.get(id);
+    const inB = Bset.has(id), inO = Oset.has(id), inT = Tset.has(id);
+    if (inO && inT) {
+      if (!inB && !eq(fromTree(o), fromTree(t))) {
+        conflicts.push({ id, path: here(id), base: void 0, ours: fromTree(o), theirs: fromTree(t), kind: "added-both" });
+        merged.set(id, o);
+      } else {
+        merged.set(id, mergeNode(b, o, t, here(id), conflicts, warnings));
+      }
+    } else if (inO && !inT) {
+      if (inB && !eq(fromTree(o), fromTree(b))) {
+        conflicts.push({ id, path: here(id), base: fromTree(b), ours: fromTree(o), theirs: void 0, kind: "delete-vs-edit" });
+        merged.set(id, o);
+      } else if (!inB) {
+        merged.set(id, o);
+      }
+    } else if (!inO && inT) {
+      if (inB && !eq(fromTree(t), fromTree(b))) {
+        conflicts.push({ id, path: here(id), base: fromTree(b), ours: void 0, theirs: fromTree(t), kind: "delete-vs-edit" });
+      } else if (!inB) {
+        merged.set(id, t);
+      }
+    }
+  }
+  return orderChildren(merged, B, O, T, path, conflicts, warnings);
+}
+function orderChildren(merged, B, O, T, path, conflicts, warnings) {
+  const Bids = B.map((n) => n.id), Oids = O.map((n) => n.id), Tids = T.map((n) => n.id);
+  const Oidset = new Set(Oids);
+  const common = new Set(Bids.filter((id) => merged.has(id)));
+  const restrict = (ids) => ids.filter((id) => common.has(id));
+  const relB = restrict(Bids), relO = restrict(Oids), relT = restrict(Tids);
+  const fullO = relO.length === common.size, fullT = relT.length === common.size;
+  let commonOrder;
+  if (!fullO && !fullT) commonOrder = relB;
+  else if (!fullO) commonOrder = relT;
+  else if (!fullT) commonOrder = relO;
+  else if (arrEq(relO, relB)) commonOrder = relT;
+  else if (arrEq(relT, relB)) commonOrder = relO;
+  else if (arrEq(relO, relT)) commonOrder = relO;
+  else {
+    conflicts.push({ id: "", path, base: relB, ours: relO, theirs: relT, kind: "moved" });
+    commonOrder = relO;
+  }
+  const anchorIn = (ids, id) => {
+    for (let i = ids.indexOf(id) - 1; i >= 0; i--) if (common.has(ids[i])) return ids[i];
+    return null;
+  };
+  const byAnchor = /* @__PURE__ */ new Map();
+  const group = (a) => {
+    let g = byAnchor.get(a);
+    if (!g) {
+      g = { ours: [], theirs: [] };
+      byAnchor.set(a, g);
+    }
+    return g;
+  };
+  for (const n of O) if (merged.has(n.id) && !common.has(n.id)) group(anchorIn(Oids, n.id)).ours.push(n.id);
+  for (const n of T) if (merged.has(n.id) && !common.has(n.id) && !Oidset.has(n.id)) group(anchorIn(Tids, n.id)).theirs.push(n.id);
+  const out = [];
+  const emit = (anchor) => {
+    const g = byAnchor.get(anchor);
+    if (!g) return;
+    if (g.ours.length > 0 && g.theirs.length > 0) warnings.push({ id: anchor ?? "", path, message: "both sides inserted here; kept ours-then-theirs - review the order" });
+    out.push(...g.ours, ...g.theirs);
+  };
+  emit(null);
+  for (const id of commonOrder) {
+    out.push(id);
+    emit(id);
+  }
+  return out.map((id) => merged.get(id));
+}
+function checkDuplicateIds(root, conflicts) {
+  const seen = /* @__PURE__ */ new Set(), dup = /* @__PURE__ */ new Set();
+  const walk = (n) => {
+    if (n.id) {
+      if (seen.has(n.id)) dup.add(n.id);
+      else seen.add(n.id);
+    }
+    n.children.forEach(walk);
+  };
+  walk(root);
+  for (const id of dup) conflicts.push({ id, path: "scene", base: void 0, ours: void 0, theirs: void 0, kind: "structural" });
+}
+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/unpack.ts
+var MANIFEST = "patter.manifest.json";
+var UnsafeEntryError = class extends Error {
+};
+async function readDocShards(bytes) {
+  const zip = await JSZip2.loadAsync(bytes);
+  const out = /* @__PURE__ */ new Map();
+  for (const [name, entry] of Object.entries(zip.files)) {
+    if (entry.dir || name === MANIFEST) continue;
+    if (isUnsafeEntry(name)) throw new UnsafeEntryError(`document entry escapes the target directory: ${name}`);
+    out.set(name, await entry.async("string"));
+  }
+  return out;
+}
+async function runUnpack(bytes, targetDir) {
+  const shards = await readDocShards(bytes);
+  return [...shards.entries()].map(([name, content]) => ({ path: join5(targetDir, name), content })).sort((a, b) => a.path.localeCompare(b.path));
+}
+async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
+  const theirs = await readDocShards(returnedBytes);
+  const base = await readDocShards(baseBytes);
+  const shards = [];
+  const writes = [];
+  const sidecars = [];
+  let conflicts = 0, warnings = 0;
+  for (const [rel, theirText] of [...theirs.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+    const outPath = join5(projectDir, rel);
+    if (!existsSync3(outPath)) {
+      writes.push({ path: outPath, content: theirText });
+      shards.push({ path: rel, added: true });
+      continue;
+    }
+    const oursObj = parseSource5(readFileSync5(outPath, "utf8"));
+    const theirsObj = parseSource5(theirText);
+    const baseText = base.get(rel);
+    const baseObj = baseText !== void 0 ? parseSource5(baseText) : {};
+    const result = runMerge(baseObj, oursObj, theirsObj);
+    writes.push({ path: outPath, content: canonicalStringify7(result.merged) });
+    if (result.conflicts.length > 0) {
+      sidecars.push({ path: `${outPath}.patterconflict`, content: JSON.stringify({ type: result.type, conflicts: result.conflicts, warnings: result.warnings }, null, 2) + "\n" });
+      conflicts += result.conflicts.length;
+    }
+    warnings += result.warnings.length;
+    shards.push({ path: rel, result, added: false });
+  }
+  return { shards, writes, sidecars, conflicts, warnings };
+}
+function isUnsafeEntry(name) {
+  if (isAbsolute2(name) || /^[a-zA-Z]:/.test(name)) return true;
+  const norm = normalize(name);
+  return norm === ".." || norm.startsWith(".." + sep3) || norm.startsWith("../");
+}
+export {
+  SHARD_EXTENSIONS,
+  UnsafeEntryError,
+  UnsupportedMergeError,
+  applyLoc,
+  applySceneOrder,
+  applyWrites,
+  bundleOutputPath,
+  catalogToJson,
+  catalogToPo,
+  catalogToXlsx,
+  classesForChannel,
+  detectMergeType,
+  extractLoc,
+  findProjectFile,
+  isUnsafeEntry,
+  jsonToCatalog,
+  listProjectTags,
+  loadProject,
+  loadProjectLanding,
+  poToCatalog,
+  proposeCoverageDrivers,
+  renderCoverageText,
+  renderPlay,
+  renderReportText,
+  resolveDocumentation,
+  resolveStart,
+  runCoverage,
+  runExport,
+  runExportFull,
+  runExportHtml,
+  runExportWeb,
+  runFormat,
+  runInit,
+  runMerge,
+  runPack,
+  runPlay,
+  runPropertyUsage,
+  runReplace,
+  runReport,
+  runReportXlsx,
+  runResolve,
+  runScriptDoc,
+  runSearch,
+  runStatusBrowse,
+  runTagBrowse,
+  runUnpack,
+  runUnpackMerge,
+  runValidate,
+  runVoiceScript,
+  scanAudioStatus,
+  sceneIdForShard,
+  scriptToDocx,
+  scriptToPdf,
+  vcsConfigWrites,
+  voiceScriptToXlsx,
+  xlsxToCatalog
+};