@patterkit/ops 0.3.5 → 0.4.0

package/dist/index.js

@@ -13,6 +13,7 @@ function readDirSafe(dir) {
 function walkFiles(dir, ext) {
   const out = [];
   for (const e of readDirSafe(dir)) {
+    if (e.name.startsWith(".")) continue;
     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);
@@ -225,251 +226,626 @@ function applyWrites(writes) {
 
 // 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) => ({
+
+// src/merge.ts
+import { canonicalStringify } from "@patterkit/core";
+var UnsupportedMergeError = class extends Error {
+};
+var eq = (a, b) => canonicalStringify(a) === canonicalStringify(b);
+var isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var CONFLICT_SIDECAR = ".patterconflict";
+function sidecarIssues(sidecarPaths) {
+  return sidecarPaths.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;
+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 mergeAuthoring(base, ours, theirs);
+    case "flow":
+      return mergeFlow(base, ours, theirs);
+    case "project":
+      return mergeProject(base, ours, theirs);
   }
-  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`" });
+}
+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, resolve5) {
+  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 = resolve5?.(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 issues;
+  return out;
 }
-var hygieneCache = /* @__PURE__ */ new Map();
-function checkHygiene(files) {
-  const issues = [];
-  for (const file of files) {
-    let mtimeMs;
-    try {
-      mtimeMs = statSync2(file).mtimeMs;
-    } catch {
+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 mergeAuthoring(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));
+  setIf(merged, "suggestions", mergeById(asArr(base.suggestions), asArr(ours.suggestions), asArr(theirs.suggestions), "suggestions", conflicts));
+  setIf(merged, "rerecord", mergeMap(asMap(base.rerecord), asMap(ours.rerecord), asMap(theirs.rerecord), "rerecord", conflicts, void 0));
+  for (const k of /* @__PURE__ */ new Set([...Object.keys(base), ...Object.keys(ours), ...Object.keys(theirs)])) {
+    if (k in merged || AUTHORING_HANDLED.has(k)) continue;
+    const v = merge3(base[k], ours[k], theirs[k], "", k, conflicts);
+    if (v !== void 0) merged[k] = v;
+  }
+  return { type: "authoring", merged, conflicts, warnings: [] };
+}
+var AUTHORING_HANDLED = /* @__PURE__ */ new Set(["schema", "comments", "edits", "writing", "recording", "audio", "documentation", "cut", "suggestions", "rerecord"]);
+function mergeById(base, ours, theirs, path, conflicts) {
+  const index = (arr) => {
+    const m = {};
+    for (const r of arr) if (isObj(r) && typeof r.id === "string") m[r.id] = r;
+    return m;
+  };
+  const merged = mergeMap(index(base), index(ours), index(theirs), path, conflicts);
+  return Object.values(merged).sort((a, b) => String(asMap(a).ts ?? "").localeCompare(String(asMap(b).ts ?? "")));
+}
+function mergeComments(base, ours, theirs) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const c of [...base, ...ours, ...theirs]) {
+    if (isObj(c) && typeof c.id === "string" && !byId.has(c.id)) byId.set(c.id, c);
+  }
+  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;
     }
-    const hit = hygieneCache.get(file);
-    if (hit && hit.mtimeMs === mtimeMs) {
-      issues.push(...hit.issues);
+    if (o === void 0) {
+      if (t !== void 0) out[id] = t;
       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 {
+    if (t === void 0) {
+      out[id] = o;
       continue;
     }
-    hygieneCache.set(file, { mtimeMs, issues: fileIssues });
-    issues.push(...fileIssues);
+    out[id] = mergeEditRecord(asMap(o), asMap(t));
   }
-  return issues;
+  return out;
 }
-
-// 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);
+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 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;
+  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;
   };
-  return loaded.scenes.map((s) => ({
-    ...s,
-    blocks: s.blocks.map((b) => ({ ...b, children: b.children.map(clean) }))
-  }));
+  const merged = mergeMap(byName(base), byName(ours), byName(theirs), path, conflicts);
+  return Object.keys(merged).sort().map((name) => merged[name]);
 }
-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 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 runExportFull(loaded) {
-  const { project, locales } = loaded;
-  return exportBundle2({ project, scenes: compileScenes(loaded), locales });
+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 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`);
+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;
 }
-
-// src/export-html.ts
-import { canonicalStringify } from "@patterkit/core";
-
-// src/playable-runtime.ts
-var PLAYABLE_RUNTIME_JS = '"use strict";var Patterplay=(()=>{var A=Object.defineProperty;var he=Object.getOwnPropertyDescriptor;var me=Object.getOwnPropertyNames;var Se=Object.prototype.hasOwnProperty;var ye=(n,e)=>{for(var t in e)A(n,t,{get:e[t],enumerable:!0})},ve=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of me(e))!Se.call(n,s)&&s!==t&&A(n,s,{get:()=>e[s],enumerable:!(r=he(e,s))||r.enumerable});return n};var be=n=>ve(A({},"__esModule",{value:!0}),n);var Ge={};ye(Ge,{Engine:()=>O,Flow:()=>w,buildTagIndex:()=>B,describeBundle:()=>pe,effectiveGameData:()=>ue,gameDataFields:()=>de,gameDataValue:()=>_});function S(n){switch(n[0]){case"b":return{kind:"bool",value:n[1]};case"n":return{kind:"number",value:n[1]};case"s":return{kind:"string",value:n[1]};case"sv":return{kind:"scopedvar",scope:n[1],name:n[2]};case"u":return{kind:"unary",op:n[1],operand:S(n[2])};case"bin":return{kind:"binary",op:n[1],left:S(n[2]),right:S(n[3])};case"call":{let e=n.slice(2).map(S);return{kind:"call",name:n[1],args:e}}case"fd":return{kind:"flagdelta",sign:n[1],name:n[2]}}}var p=class extends Error{constructor(e){super(e),this.name="EvalError"}};function C(n,e,t){let r=new Map(t.scopes.map(i=>[i.token,i.missing??"false"])),s=i=>{switch(i.kind){case"bool":return i.value;case"number":return i.value;case"string":return i.value;case"scopedvar":{let o=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 p(`@${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 p(`unknown function \'${i.name}\'`);return o.eval(i.args,{evaluate:s,ctx:e})}case"flagdelta":throw new p("flagdelta node is only valid as an argument to a flag-delta function");case"unary":{if(i.op==="not"){let a=s(i.operand);if(typeof a!="boolean")throw new p(`\'not\' requires a boolean operand, got ${typeof a}`);return!a}let o=s(i.operand);if(typeof o!="number")throw new p(`unary \'-\' requires a numeric operand, got ${typeof o}`);return-o}case"binary":{if(i.op==="and"){let c=s(i.left);if(typeof c!="boolean")throw new p(`\'and\' requires boolean operands, left is ${typeof c}`);if(!c)return!1;let l=s(i.right);if(typeof l!="boolean")throw new p(`\'and\' requires boolean operands, right is ${typeof l}`);return l}if(i.op==="or"){let c=s(i.left);if(typeof c!="boolean")throw new p(`\'or\' requires boolean operands, left is ${typeof c}`);if(c)return!0;let l=s(i.right);if(typeof l!="boolean")throw new p(`\'or\' requires boolean operands, right is ${typeof l}`);return l}let o=s(i.left),a=s(i.right);switch(i.op){case"==":return J(o,a);case"!=":return!J(o,a);case">":return y(o,a,">"),o>a;case">=":return y(o,a,">="),o>=a;case"<":return y(o,a,"<"),o<a;case"<=":return y(o,a,"<="),o<=a;case"+":if(typeof o=="number"&&typeof a=="number"||typeof o=="string"&&typeof a=="string")return o+a;throw new p(`\'+\' requires two numbers or two strings, got ${typeof o} and ${typeof a}`);case"-":return y(o,a,"-"),o-a;case"*":return y(o,a,"*"),o*a;case"/":if(y(o,a,"/"),a===0)throw new p("division by zero");return o/a}}}};return s(n)}function J(n,e){if(Array.isArray(n)||Array.isArray(e)){if(!Array.isArray(n)||!Array.isArray(e)||n.length!==e.length)return!1;for(let t=0;t<n.length;t++)if(n[t]!==e[t])return!1;return!0}return n===e}function y(n,e,t){if(typeof n!="number"||typeof e!="number")throw new p(`\'${t}\' requires numeric operands, got ${typeof n} and ${typeof e}`)}var we={name:"check_flags",count:n=>Math.max(1,n.args.length-1)},xe=[we];function z(n,e,t){let r=t?.countingCalls??xe;return E(n,t?.want??!0,e,r)}function E(n,e,t,r){if(n.kind==="binary"&&(n.op==="and"||n.op==="or")){let s=E(n.left,e,t,r),i=E(n.right,e,t,r);return n.op==="and"===e?s>0&&i>0?s+i:0:Math.max(s,i)}if(n.kind==="unary"&&n.op==="not")return E(n.operand,!e,t,r);if(n.kind==="call"){let s=r.find(i=>i.name===n.name);if(s){let i=s.count(n),o=t(n);return e?o?i:0:o?0:1}}return t(n)===e?1:0}var G=class n{values={};decls=new Map;subscribers=new Set;auditors=new Set;norm;constructor(e=[],t){this.norm=t?.normalise??(r=>r.toLowerCase()),this.seed(e)}seed(e){for(let t of e){let r=this.norm(t.name);this.decls.set(r,t),this.values[r]=structuredClone(t.default??Y(t))}}get(e){return this.values[this.norm(e)]}set(e,t,r){let s=this.norm(e);if(this.decls.get(s)?.writable===!1)throw new Error(`\'${e}\' is read-only`);let i={name:s,prev:this.values[s],next:t,silent:r?.silent??!1,reason:r?.reason};this.values[s]=t;for(let o of this.auditors)o(i);if(!i.silent)for(let o of this.subscribers)o(i);return i}subscribe(e){return this.subscribers.add(e),()=>this.subscribers.delete(e)}onAudit(e){return this.auditors.add(e),()=>this.auditors.delete(e)}rows(){return[...this.decls.entries()].map(([e,t])=>X(t,this.get(e),void 0,e))}declarations(){return[...this.decls.values()]}clone(){let e=new n([],{normalise:this.norm});return e.decls=new Map(this.decls),Object.assign(e.values,structuredClone(this.values)),e}reseed(e){for(let t of Object.keys(this.values))delete this.values[t];this.decls.clear(),this.seed(e)}save(){return structuredClone(this.values)}load(e){for(let[t,r]of Object.entries(e))this.values[this.norm(t)]=r}};function X(n,e,t,r){return{name:r??n.name.toLowerCase(),type:n.type,value:e,default:n.default??Y(n),...n.values!==void 0?{values:n.values}:{},writable:t??n.writable??!0}}var F=1,x=class{scopes=new Map;defineOwned(e,t){return this.mountOwned(e,new G(t))}mountOwned(e,t){return this.assertFree(e),this.scopes.set(e,{kind:"owned",bag:t}),this}ownedBag(e){let t=this.scopes.get(e);if(!t||t.kind!=="owned")throw new Error(`\'@${e}\' is not an owned scope`);return t.bag}reseedOwned(e,t){return this.ownedBag(e).reseed(t),this}defineForeign(e,t,r=[],s=!0){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:s}),this}has(e){return this.scopes.has(e)}get(e,t){let r=this.scopes.get(e);if(r)return r.kind==="owned"?r.bag.get(t):r.resolver.get(t.toLowerCase())}set(e,t,r){let s=this.scopes.get(e);if(!s)throw new Error(`unknown scope \'@${e}\'`);if(s.kind==="owned"){try{s.bag.set(t,r)}catch{throw new Error(`\'@${e}.${t}\' is read-only`)}return}let i=t.toLowerCase();if(!this.foreignWritable(s,i))throw new Error(`\'@${e}.${t}\' is read-only`);s.resolver.set(i,r)}foreignWritable(e,t){return e.resolver.set?e.decls.get(t)?.writable??e.scopeWritable:!1}listProperties(){let e=[];for(let[t,r]of this.scopes)if(r.kind==="owned")for(let s of r.bag.rows())e.push({scope:t,...s});else for(let s of r.decls.values())e.push({scope:t,...X(s,r.resolver.get(s.name.toLowerCase()),this.foreignWritable(r,s.name.toLowerCase()))});return e}toEvalContext(e){let t={};for(let[r,s]of this.scopes)t[r]=s.kind==="owned"?s.bag.values:s.resolver;return{scopes:t,host:e}}toSchema(){let e=new Map;for(let[t,r]of this.scopes){let s=r.kind==="owned"?r.bag.declarations():[...r.decls.values()];if(s.length===0)continue;let i=new Map;for(let o of s)i.set(o.name.toLowerCase(),{type:o.type,enumValues:o.values});e.set(t,i)}return{properties:e}}save(){let e={};for(let[t,r]of this.scopes)r.kind==="owned"&&(e[t]=r.bag.save());return e}load(e){for(let[t,r]of Object.entries(e)){let s=this.scopes.get(t);s?.kind==="owned"&&s.bag.load(r)}}saveFragment(){return{version:F,scopes:this.save()}}loadFragment(e){if(e.version!==F)throw new Error(`unsupported owned-state fragment version ${e.version} (supported: ${F})`);this.load(e.scopes)}assertFree(e){if(this.scopes.has(e))throw new Error(`scope \'@${e}\' is already registered`)}};function Y(n){if(n.default!==void 0)return n.default;switch(n.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"enum":return n.values?.[0]??"";case"flags":return[]}}function k(n){return n.ctx.host??{}}var T={defaultScope:"patter",scopes:[{token:"patter"},{token:"scene"}],functions:{random:{minArgs:2,maxArgs:2,returnType:"number",eval(n,e){if(n.length!==2)throw new p("random(a, b) requires exactly 2 arguments");let t=k(e).nextRandom;if(!t)throw new p("random() called without a PRNG in context");let r=e.evaluate(n[0]),s=e.evaluate(n[1]);if(typeof r!="number"||typeof s!="number")throw new p("random(a, b) arguments must be numbers");if(!Number.isInteger(r)||!Number.isInteger(s))throw new p("random(a, b) arguments must be integers");let i=Math.min(r,s),o=Math.max(r,s);return Math.floor(t()*(o-i+1))+i}},check_flags:{minArgs:1,returnType:"boolean",flagDeltaArgs:!0,validate:Q("check_flags"),eval(n,e){let t=Z(n[0],e,"check_flags");for(let r=1;r<n.length;r++){let s=n[r];if(s.kind!=="flagdelta")throw new p("check_flags() flag args must be +flagName or -flagName");if(s.sign==="+"?!t.includes(s.name):t.includes(s.name))return!1}return!0}},set_flags:{minArgs:1,returnType:"flags",flagDeltaArgs:!0,validate:Q("set_flags"),eval(n,e){let t=[...Z(n[0],e,"set_flags")];for(let r=1;r<n.length;r++){let s=n[r];if(s.kind!=="flagdelta")throw new p("set_flags() flag args must be +flagName or -flagName");if(s.sign==="+")t.includes(s.name)||t.push(s.name);else{let i=t.indexOf(s.name);i>=0&&t.splice(i,1)}}return t}},visits:{minArgs:1,maxArgs:1,returnType:"number",validate:I("visits"),eval:(n,e)=>k(e).visits?.(D(n,e,"visits"))??0},seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:I("seen"),eval:(n,e)=>(k(e).visits?.(D(n,e,"seen"))??0)>0},patter_visits:{minArgs:1,maxArgs:1,returnType:"number",validate:I("patter_visits"),eval:(n,e)=>k(e).patterVisits?.(D(n,e,"patter_visits"))??0},patter_seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:I("patter_seen"),eval:(n,e)=>(k(e).patterVisits?.(D(n,e,"patter_seen"))??0)>0}}};function V(n,e){let t=n.replace(/^@/,"").split(".");return t.length===2&&e(t[0])?{scope:t[0],name:t[1].toLowerCase()}:{scope:"patter",name:t.join(".").toLowerCase()}}function D(n,e,t){let r=e.evaluate(n[0]);if(typeof r!="string")throw new p(`${t}(id) requires a string node id`);return r}function I(n){return(e,t)=>{let r=e[0];r&&r.kind!=="string"&&t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(id): the argument must be a string id literal (a scene / block / node id)`})}}function Z(n,e,t){if(!n)throw new p(`${t}() requires at least one argument (the flags variable)`);let r=e.evaluate(n);if(Array.isArray(r))return r;if(r===!1||r===null||r===void 0)return[];throw new p(`${t}() first argument must be a flags property`)}function Q(n){return(e,t)=>{if(e.length===0)return;let r=e[0];if(r.kind!=="scopedvar"){t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(): first argument must be a flags property reference (@name or @scope.name)`});return}let s=t.schema.properties.get(r.scope)?.get(r.name);if(s&&s.type!=="flags"){let i=r.scope===t.defaultScope?r.name:`${r.scope}.${r.name}`;t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(): \'@${i}\' is not a flags property (got ${s.type})`});return}for(let i=1;i<e.length;i++){let o=e[i];o.kind!=="flagdelta"?t.report({path:[...t.path,"args",i],kind:"wrong-arg-type",severity:"error",message:`${n}(): argument ${i+1} must be +flagName or -flagName`}):s?.type==="flags"&&s.enumValues&&!s.enumValues.includes(o.name)&&t.report({path:[...t.path,"args",i],kind:"unknown-flag-name",severity:"error",message:`${n}(): unknown flag \'${o.name}\'`,reference:o.name})}}}var ke=/^@[A-Za-z0-9_.]+$/;function*Ce(n){let e="",t=0;for(;t<n.length;){let r=n[t];if(r==="{"&&n[t+1]==="{"){e+="{",t+=2;continue}if(r==="}"&&n[t+1]==="}"){e+="}",t+=2;continue}if(r==="{"){let s=n.indexOf("}",t+1);if(s!==-1){let i=n.slice(t,s+1),o=n.slice(t+1,s).trim();if(o.startsWith("@")){e&&(yield{kind:"text",value:e},e=""),yield{kind:"slot",raw:i,inner:o,ref:ke.test(o)?o:void 0},t=s+1;continue}e+=i,t=s+1;continue}}e+=r,t+=1}e&&(yield{kind:"text",value:e})}function Ee(n){return Array.isArray(n)?n.join(", "):typeof n=="boolean"?n?"true":"false":String(n)}function De(n){return n===" "||n==="	"||n===`\n`||n==="\\r"||n==="\\f"||n==="\\v"}function Ie(n){let e="",t=!1;for(let r of n){if(De(r)){t=!0;continue}t&&e.length>0&&(e+=" "),t=!1,e+=r}return e}function ee(n,e,t){if(e.length===0||n.indexOf(e)<0)return n;let r="",s=0,i=!1;for(;s<n.length;){if(n.startsWith(e,s)){let o=n.indexOf(t,s+e.length);if(o>=0){s=o+t.length,i=!0;continue}r+=n.slice(s);break}r+=n[s],s+=1}return i?Ie(r):n}function te(n,e){if(n.indexOf("{")<0)return n;let t="";for(let r of Ce(n)){if(r.kind==="text"){t+=r.value;continue}if(!r.ref){t+=r.raw;continue}let s=e(r.ref);t+=s===void 0?"":Ee(s)}return t}function b(n,e){for(let t of n){e(t);let r=t.children;r&&b(r,e)}}function Re(n){return n.toLowerCase().replace(/[\'\u2019]/g,"").replace(/[^a-z0-9-]+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function g(n){let e=n.gameId?.trim();return e||Re(n.name)}function M(n){return`cast:${n}`}var j={open:"[",close:"]"},re="SFX";function R(n){let e=new Set,t=[];for(let r of n)e.has(r)||(e.add(r),t.push(r));return t}function B(n){let e=new Map,t=(r,s)=>{let i=R([...s,...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,R([...i,...o.tags??[]]))};for(let r of Object.values(n.scenes)){let s=R(r.tags??[]);e.set(r.id,s);for(let i of r.blocks){let o=R([...s,...i.tags??[]]);e.set(i.id,o);for(let a of i.children)t(a,o)}}return e}var ne=new WeakMap,O=class n{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,s=e.strings;this.allStrings=s,this.currentLocale=r;let i=s[r]??{},o=s[e.locales.default]??{},a=e.localisation,c=a?.mode==="ids"&&!a.sourceDebug;this.sourceDebug=a?.mode==="ids"&&!!a.sourceDebug,this.sourceDebug&&typeof console<"u"&&console.warn("[Patterplay] source-only DEBUG build: strings are the source language for debugging, not a shippable localised build.");let l=new Map;for(let d of e.cast??[])d.displayName&&l.set(d.name,d.displayName);this.defaultSeed=(t.seed??2654435769)>>>0;let u=new Map,f=new Map,H=new Map;for(let[d,m]of Object.entries(e.scenes)){this.sceneGameIdToId.set(g(m),d);let v=new Map;for(let h of m.blocks)f.set(h.id,{sceneId:d}),H.set(h.id,h),v.set(g(h),h.id),b(h.children,K=>u.set(K.id,K));this.blockGameIdToId.set(d,v)}let q=e.properties??[],P=q.filter(d=>d.shared??!0).map(ie),ge=q.filter(d=>!(d.shared??!0)).map(ie),fe=new Set(P.map(d=>d.name.toLowerCase())),N=new x().defineOwned("patter",P),U=new Set;if(t.world){let d=e.scopeRegistry?.scopes.find(v=>v.token==="world"),m=(d?.declarations??[]).map(oe);N.defineForeign("world",t.world,m,d?.writable??!0),U.add("world")}for(let d of e.scopeRegistry?.scopes??[]){if(U.has(d.token))continue;let m=(d.declarations??[]).map(oe);N.defineForeign(d.token,Pe(d.declarations??[]),m,d.writable??!0)}let W=new Map;for(let[d,m]of Object.entries(e.scenes)){let v=new Set((m.sceneProps??[]).filter(h=>h.shared??!1).map(h=>h.name.toLowerCase()));W.set(d,v)}this.host={bundle:e,emitIds:c,strings:i,defaultStrings:o,castDisplay:l,nodeIndex:u,blockIndex:f,blockById:H,sceneGameIdToId:this.sceneGameIdToId,blockGameIdToId:this.blockGameIdToId,tagIndex:B(e),shared:N,patterSharedDecls:P,patterLocalDecls:ge,patterSharedNames:fe,sceneSharedNames:W,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??j).open,captionClose:(e.closedCaptions??j).close,captionCharacter:e.closedCaptions?.character||re,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),s=new n(e,this.creationOptions);try{return s.loadGame(t),r(s)}catch{let i=new n(e,this.creationOptions);for(let[o,a]of Object.entries(t.flows)){let c=a.cursor.currentSceneId;try{i.openFlow(o,c!==null?{scene:c}:{})}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),s=this.resolveBlockRef(r,t.block);this.flowsById.get(e)?.close();let i=new w(e,this.host,t.seed??this.defaultSeed);return this.flowsById.set(e,i),i.start(r,s),i}runFlow(e,t,r){let s=this.flowsById.get(e);if(!s)return this.openFlow(e,{scene:t,block:r}).advanceToStop().played;if(!s.goto(t,r))throw new Error(`runFlow: address not found: ${t}${r===void 0?"":` / ${r}`}`);return s.advanceToStop().played}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?g(t):void 0}blockAddress(e){let t=this.host.blockById.get(e);return t?g(t):void 0}tagsForBeat(e){return this.host.tagIndex.get(e)??[]}tagsForScene(e){let t=this.resolveSceneRef(e);return(t!=null?this.host.tagIndex.get(t):void 0)??[]}tagsForBlock(e,t){let r=this.resolveSceneRef(e),s=this.resolveBlockRef(r,t);return(s!=null?this.host.tagIndex.get(s):void 0)??[]}getCast(){let e=[];for(let t of this.host.bundle.cast??[])t?.name&&e.push(t.name);return e}castForScene(e){let t=this.resolveSceneRef(e),r=t!=null?this.host.bundle.scenes[t]:void 0;if(!r)return[];let s=new Set;for(let i of r.blocks)se(i.children,s);return[...s]}castForBlock(e,t){let r=this.resolveSceneRef(e),s=this.resolveBlockRef(r,t),i=s!=null?this.host.blockById.get(s):void 0;if(!i)return[];let o=new Set;return se(i.children,o),[...o]}getOutline(){return Object.values(this.host.bundle.scenes).map(e=>({id:e.id,...g(e)?{gameId:g(e)}:{},name:e.name,...this.tagsField(e.id),blocks:e.blocks.map(t=>({id:t.id,...g(t)?{gameId:g(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)b(r.children,s=>{if(s.type==="snippet")for(let i of s.beats??[])e.push({sceneId:t.id,blockId:r.id,snippetId:s.id,beat:this.beatInfo(i)})});return e}outlineNode(e){return e.type==="group"?{type:"group",id:e.id,...this.tagsField(e.id),...e.selector?{selector:e.selector}:{},...e.prompt?{prompt:this.beatInfo(e.prompt)}:{},children:e.children.map(t=>this.outlineNode(t))}:{type:"snippet",id:e.id,...this.tagsField(e.id),beats:(e.beats??[]).map(t=>this.beatInfo(t)),...e.jump?{jumpTo:e.jump.to,...e.jump.mode?{jumpMode:e.jump.mode}:{}}:{}}}beatInfo(e){let t=this.host.tagIndex.get(e.id),r={id:e.id,kind:e.kind};if(e.kind==="line"){if(e.character!==void 0){r.character=e.character;let s=this.host.defaultStrings[M(e.character)]??this.host.castDisplay.get(e.character);s!==void 0&&(r.characterName=s)}e.direction!==void 0&&(r.direction=e.direction)}if(e.kind==="line"||e.kind==="text"){let s=this.host.defaultStrings[e.id];s!==void 0&&(r.text=s)}return e.gameData&&Object.keys(e.gameData).length&&(r.gameData=e.gameData),t&&t.length&&(r.tags=t),r}tagsField(e){let t=this.host.tagIndex.get(e);return t&&t.length?{tags:t}:{}}getFlow(e){return this.flowsById.get(e)}flows(){return[...this.flowsById.values()]}closeFlow(e){this.flowsById.get(e)?.close(),this.flowsById.delete(e)}reset(){for(let e of this.flowsById.values())e.close();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:s}=this.splitShared(e);this.host.shared.set(r,s,t)}listProperties(){return this.host.patterSharedDecls.map(e=>({ref:`@${e.name}`,type:e.type,values:e.values,value:this.getProperty(`@${e.name}`),default:Be(e)}))}splitShared(e){let t=this.host.refSplitCache.get(e);if(t||(t=V(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:ce(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 le(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 s=new w(t,this.host,this.defaultSeed);s.restore(r),this.flowsById.set(t,s)}}},w=class{id;host;local;rngState;started=!1;flowEnded=!1;closed=!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 s=this.host.sceneSharedNames.get(r)?.has(e)?this.host.stageBags.get(r):this.sceneBags.get(r);s&&(s[e]=t)}};evalCtx;constructor(e,t,r){this.id=e,this.host=t,this.rngState=r>>>0,this.local=this.freshLocal();let s={...t.shared.toEvalContext().scopes};s.patter=this.patterResolver,s.scene=this.sceneResolver,this.evalCtx={scopes:s,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],s=r?this.host.bundle.scenes[r]:void 0;if(!s)throw new Error(r?`unknown scene: ${r}`:"no scenes in bundle");this.enterSceneSetup(r);let i=s.blocks[0];i&&(this.stack=[{sceneId:r,containerId:i.id,index:0}],this.enter(i.id))}this.settle()}reset(e,t){this.start(e,t)}goto(e,t){if(this.closed)return!1;if(e==="END")return this.started=!0,this.pendingChoice=null,this.pendingPromptBeat=null,this.pendingPromptOwnerId=null,this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!0,this.stack=[],!0;let r=this.host.sceneGameIdToId.get(e)??(this.host.bundle.scenes[e]?e:void 0);if(r===void 0)return!1;let s;return t!==void 0&&(s=this.host.blockGameIdToId.get(r)?.get(t)??(this.host.blockIndex.get(t)?.sceneId===r?t:void 0),s===void 0)?!1:this.started?(this.pendingChoice=null,this.pendingPromptBeat=null,this.pendingPromptOwnerId=null,this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!1,this.enterTarget(s??r,"jump"),this.settle(),!0):(this.start(r,s),!0)}close(){this.closed=!0,this.flowEnded=!0,this.stack=[],this.activeSnippet=null,this.beatIndex=0,this.pendingChoice=null,this.pendingPromptBeat=null,this.pendingPromptOwnerId=null}get isClosed(){return this.closed}get currentScene(){return this.currentSceneId}advance(){if(this.closed)return{type:"end"};if(!this.started)throw new Error("flow has not been started");if(this.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 s=this.activeSnippet.jump;this.activeSnippet=null,this.beatIndex=0,this.resolveJump(s);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 s=t.byId.get(e);this.pendingChoice=null,this.pendingPromptBeat=this.host.replayPromptOnChoose?this.promptBeatOf(s)??null:null,this.pendingPromptOwnerId=this.pendingPromptBeat?s.id:null,this.enterChild(s)}isEnded(){return this.flowEnded}getProperty(e){let{scope:t,name:r}=this.splitRef(e);return t==="patter"?this.patterResolver.get(r):t==="scene"?this.sceneResolver.get(r):this.host.shared.get(t,r)}setProperty(e,t){let{scope:r,name:s}=this.splitRef(e);if(r==="patter")this.patterResolver.set(s,t);else if(r==="scene"){if(this.currentSceneId===null)throw new Error(`\'${e}\': the flow has not entered a scene yet`);this.sceneResolver.set(s,t)}else this.host.shared.set(r,s,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:ce(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:s,...i}=r;if(s!==void 0){let o=this.childrenOf(i.containerId)?.findIndex(a=>a.id===s)??-1;if(o>=0)return{...i,index:o}}return{...i}}),this.sceneBags=new Map(Object.entries(e.sceneBags??{}).map(([r,s])=>[r,{...s}])),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=le(t.selectors),this.pendingChoice=null,t.pendingChoice!==null){let r=new Map,s=[];for(let i of t.pendingChoice.options){let o=this.host.nodeIndex.get(i.id);o&&(r.set(i.id,o),s.push({...i}))}s.length>0&&(this.pendingChoice={groupId:t.pendingChoice.groupId,options:s,byId:r})}if(this.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,s=[];for(let o of e.children){if(o.fallback===!0){s.push(o);continue}if(o.sticky!==!0&&(this.visitCounts.get(o.id)??0)>=1)continue;let a=this.eligible(o),c=o.secretUntilEligible===!0;!a&&c||(t.push({id:o.id,prompt:this.promptFor(o),eligible:a,gameData:o.gameData}),r.set(o.id,o))}if(t.length>0){this.pendingChoice={groupId:e.id,options:t,byId:r};return}let i=s.find(o=>this.eligible(o));if(i){this.enterChild(i);return}this.host.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,s,i=this.host.bundle.scenes[e];if(i){this.enterSceneSetup(e);let a=i.blocks[0];if(!a){t==="jump"&&(this.stack=[]);return}r=e,s=a.id}else{let a=this.host.blockIndex.get(e);if(!a)throw new Error(`jump target not found: ${e}`);a.sceneId!==this.currentSceneId&&this.enterSceneSetup(a.sceneId),r=a.sceneId,s=e}this.enter(s);let o={sceneId:r,containerId:s,index:0};t==="call"?this.stack.push(o):this.stack=[o]}selectChild(e){let t=e.children.filter(s=>this.eligible(s));if(t.length===0)return null;let r=this.selectorState(e);switch(e.selector){case"branch":return t[0];case"sequence":{let s=e.options?.order??"sequential",i=e.options?.exhaust??"once";return s==="shuffle"?this.pickShuffle(t,i,r):s==="specificity"?this.pickSpecificity(t,i,r):this.pickSequential(t,i,r)}default:return null}}pickSequential(e,t,r){let s=e.length,i=r.seq??0;return r.seq=i+1,t==="repeat"?e[i%s]:i<s?e[i]:t==="stick"?e[s-1]:null}pickShuffle(e,t,r){let s=e.length,i=t==="stick",o=()=>(i?e.slice(0,s-1):e).map(f=>f.id);if(r.bag===void 0&&(r.bag=o()),r.bag.length===0){if(t==="once")return null;if(i){let f=e[s-1];return r.last=f.id,f}r.bag=o()}let a=r.bag,c=r.last!==void 0&&a.length>1?a.indexOf(r.last):-1,l=Math.floor(this.rng()*(c>=0?a.length-1:a.length));c>=0&&l>=c&&l++;let u=a[l];return a.splice(l,1),r.last=u,e.find(f=>f.id===u)}pickSpecificity(e,t,r){let s=e;if(t!=="repeat"){r.bag===void 0&&(r.bag=e.map(u=>u.id));let l=new Set(r.bag);if(s=e.filter(u=>l.has(u.id)),s.length===0)return t==="stick"&&r.last!==void 0?e.find(u=>u.id===r.last)??null:null}let i=-1,a=s.map(l=>{let u=this.specScore(l);return u>i&&(i=u),{c:l,s:u}}).filter(l=>l.s===i).map(l=>l.c),c;if(a.length===1)c=a[0];else{let l=r.last!==void 0?a.findIndex(f=>f.id===r.last):-1,u=Math.floor(this.rng()*(l>=0?a.length-1:a.length));l>=0&&u>=l&&u++,c=a[u]}return t!=="repeat"&&(r.bag=r.bag.filter(l=>l!==c.id)),r.last=c.id,c}specScore(e){return e.condition?this.matchedSpec(this.conditionAst(e.condition),!0):0}matchedSpec(e,t){return z(e,s=>ae(C(s,this.evalCtx,T)),{want:t})}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?ae(this.evalExpr(e.condition)):!0}evalExpr(e){return C(this.conditionAst(e),this.evalCtx,T)}conditionAst(e){let t=ne.get(e);return t||(t=S(e.ast),ne.set(e,t)),t}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 s=this.resolveString(e.id),i=!this.host.captionsOn,a=i&&e.character===this.host.captionCharacter?"":this.captionLine(this.host.bundle.voiced?s:this.interpolate(s)),c=i&&a.length===0;return{type:"line",id:e.id,text:a,character:c?void 0:e.character,characterName:c?void 0:this.resolveCharacterName(e.character),direction:c?void 0:e.direction,gameData:e.gameData,...r}}}}interpolate(e){return te(e,t=>this.getProperty(t))}stripCaptions(e){return ee(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 b(e,r=>{!t&&r.type==="snippet"&&(r.beats??[]).some(s=>s.kind==="line"||s.kind==="text")&&(t=r)}),t}resolveString(e){if(this.host.emitIds)return e;let t=this.host.strings[e];if(t!==void 0)return t;let r=this.host.defaultStrings[e];return r!==void 0?`<Untranslated: ${e}> ${r}`:e}resolveCharacterName(e){if(e===void 0||this.host.emitIds)return;let t=M(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=V(e,r=>r==="scene"||this.host.shared.has(r)),this.host.refSplitCache.set(e,t)),t}freshLocal(){return new x().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 s of e.sceneProps??[]){let i=s.name.toLowerCase();t.has(i)||(r[i]=L(s))}this.sceneBags.set(e.id,r)}if(!this.host.stageBags.has(e.id)){let r={};for(let s of e.sceneProps??[]){let i=s.name.toLowerCase();t.has(i)&&(r[i]=L(s))}this.host.stageBags.set(e.id,r)}for(let r of e.sceneProps??[]){if(!r.temporary)continue;let s=r.name.toLowerCase(),i=t.has(s)?this.host.stageBags.get(e.id):this.sceneBags.get(e.id);i&&(i[s]=L(r))}}};function se(n,e){b(n,t=>{if(t.type==="group"){t.prompt?.kind==="line"&&t.prompt.character&&e.add(t.prompt.character);return}for(let r of t.beats??[])r.kind==="line"&&r.character&&e.add(r.character)})}function ce(n){let e={};for(let[t,r]of n){let s={};r.seq!==void 0&&(s.seq=r.seq),r.bag&&(s.bag=[...r.bag]),r.last!==void 0&&(s.last=r.last),e[t]=s}return e}function le(n){let e=new Map;for(let[t,r]of Object.entries(n??{})){let s={};r.seq!==void 0&&(s.seq=r.seq),r.bag&&(s.bag=[...r.bag]),r.last!==void 0&&(s.last=r.last),e.set(t,s)}return e}function ie(n){return{name:n.name,type:n.type,values:n.values,default:n.default}}function Be(n){if(n.default!==void 0)return n.default;switch(n.type){case"number":return 0;case"string":return"";case"flags":return[];case"enum":return n.values?.[0]??"";default:return!1}}function oe(n){return{name:n.name,type:n.type,values:n.values,default:n.default,writable:n.writable}}function Oe(n){if(n.default!==void 0)return n.default;switch(n.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"flags":return[];case"enum":return n.values?.[0]??""}}function Pe(n){let e=r=>r.toLowerCase(),t=new Map;for(let r of n)t.set(e(r.name),Oe(r));return{get:r=>t.get(e(r)),set:(r,s)=>{t.set(e(r),s)}}}function L(n){if(n.default!==void 0)return n.default;switch(n.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"flags":return[];case"enum":return n.values?.[0]??""}}function ae(n){return typeof n=="boolean"?n:typeof n=="number"?n!==0:typeof n=="string"?n!=="":n.length>0}var Ne=(n,e)=>n.shared??e;function $(n,e){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.default!==void 0?{default:n.default}:{},shared:Ne(n,e)}}function Ae(n){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.values?{values:[...n.values]}:{},...n.purpose?{purpose:n.purpose}:{}}}function Fe(n,e){e.blocks++;let t=[...n.children];for(;t.length;){let r=t.pop();if(r.type==="group"){e.groups++,r.prompt&&e.prompts++,t.push(...r.children);continue}e.snippets++;for(let s of r.beats??[])e.beats++,s.kind==="gameEvent"&&e.gameEvents++}}function pe(n){let e={scenes:0,blocks:0,groups:0,snippets:0,beats:0,prompts:0,gameEvents:0,cast:n.cast?.length??0},t=[],r=[];for(let o of Object.values(n.scenes)){e.scenes++;let a=g(o);t.push({gameId:a,name:o.name,blocks:o.blocks.map(c=>({gameId:g(c),name:c.name}))});for(let c of o.blocks)Fe(c,e);o.sceneProps?.length&&r.push({gameId:a,properties:o.sceneProps.map(c=>$(c,!1))})}let s=(n.scopeRegistry?.scopes??[]).map(o=>({token:o.token,writable:o.writable??!0,opaque:o.declarations===void 0,properties:(o.declarations??[]).map(a=>$(a,!0))})),i=Object.entries(n.gameDataFields??{}).filter(([,o])=>(o?.length??0)>0).map(([o,a])=>({kind:o,fields:(a??[]).map(Ae)}));return{identity:{schema:n.schema,project:n.content.project,...n.content.version!==void 0?{version:n.content.version}:{},...n.content.hash!==void 0?{hash:n.content.hash}:{},...n.content.structureHash!==void 0?{structureHash:n.content.structureHash}:{},voiced:n.voiced,defaultLocale:n.locales.default,locales:[...n.locales.included],localisation:n.localisation?.mode??"embedded",sourceDebug:n.localisation?.sourceDebug??!1},addresses:t,hostScopes:s,properties:{patter:(n.properties??[]).map(o=>$(o,!0)),scene:r},gameData:i,counts:e}}function de(n,e){return n.gameDataFields?.[e]??[]}function _(n,e,t){return e&&Object.prototype.hasOwnProperty.call(e,t)?e[t]:n.find(r=>r.name===t)?.default}function ue(n,e){let t={};for(let r of n){let s=_(n,e,r.name);s!==void 0&&(t[r.name]=s)}for(let[r,s]of Object.entries(e??{}))r in t||(t[r]=s);return t}return be(Ge);})();\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
+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;
   }
-  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) {} };
+  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);
+      }
+    }
   }
-
-  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
-    })();
+  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;
   }
-
-  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();
+  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);
   }
-
-  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();
+  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);
   };
-  function flash(msg) { var f = document.getElementById("flash"); f.textContent = msg; f.style.opacity = "1"; setTimeout(function () { f.style.opacity = "0"; }, 1100); }
+  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]);
 
-  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; }
+// src/validate.ts
+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 = sidecarIssues(walkFiles(loaded.root, CONFLICT_SIDECAR));
+  const orphans = orphanShards(loaded);
+  return {
+    structural,
+    conditions,
+    interpolation,
+    hygiene,
+    staleBundles,
+    unresolvedMerges,
+    orphans,
+    ok: structural.length === 0 && conditions.length === 0 && interpolation.length === 0 && hygiene.length === 0 && staleBundles.length === 0 && unresolvedMerges.length === 0 && orphans.length === 0
+  };
+}
+function orphanShards(loaded) {
+  const collected = /* @__PURE__ */ new Set([
+    loaded.projectFile,
+    ...Object.values(loaded.sceneFiles),
+    ...loaded.localeFiles,
+    ...loaded.authoringFiles
+  ]);
+  const kind = {
+    ".patterflow": "scene",
+    ".patterloc": "locale",
+    ".patterx": "authoring",
+    ".patterproj": "project"
+  };
+  const out = [];
+  for (const [ext, what] of Object.entries(kind)) {
+    for (const file of walkFiles(loaded.root, ext)) {
+      if (collected.has(file)) continue;
+      out.push({ file, message: `a ${what} shard outside the project's layout - nothing loads it, so its content is not in the project (move it under the configured folder, or delete it)` });
+    }
+  }
+  return out;
+}
+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 refuseUnresolvedMerge(loaded) {
+  const issues = sidecarIssues(walkFiles(loaded.root, CONFLICT_SIDECAR));
+  if (!issues.length) return;
+  throw new Error(
+    `${issues.length} unresolved merge conflict(s) - resolve them and delete the .patterconflict sidecar(s) first:
+` + issues.map((i) => `  ${i.file}`).join("\n")
+  );
+}
+function runExport(loaded) {
+  refuseUnresolvedMerge(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) {
+  refuseUnresolvedMerge(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 as canonicalStringify2 } from "@patterkit/core";
+
+// src/playable-runtime.ts
+var PLAYABLE_RUNTIME_JS = '"use strict";var Patterplay=(()=>{var G=Object.defineProperty;var Se=Object.getOwnPropertyDescriptor;var ye=Object.getOwnPropertyNames;var ve=Object.prototype.hasOwnProperty;var be=(n,e)=>{for(var t in e)G(n,t,{get:e[t],enumerable:!0})},we=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of ye(e))!ve.call(n,s)&&s!==t&&G(n,s,{get:()=>e[s],enumerable:!(r=Se(e,s))||r.enumerable});return n};var xe=n=>we(G({},"__esModule",{value:!0}),n);var Me={};be(Me,{Engine:()=>N,Flow:()=>k,buildTagIndex:()=>P,describeBundle:()=>ue,effectiveGameData:()=>fe,gameDataFields:()=>ge,gameDataValue:()=>U});function v(n){switch(n[0]){case"b":return{kind:"bool",value:n[1]};case"n":return{kind:"number",value:n[1]};case"s":return{kind:"string",value:n[1]};case"sv":return{kind:"scopedvar",scope:n[1],name:n[2]};case"u":return{kind:"unary",op:n[1],operand:v(n[2])};case"bin":return{kind:"binary",op:n[1],left:v(n[2]),right:v(n[3])};case"call":{let e=n.slice(2).map(v);return{kind:"call",name:n[1],args:e}}case"fd":return{kind:"flagdelta",sign:n[1],name:n[2]}}}var l=class extends Error{constructor(e){super(e),this.name="EvalError"}};function D(n,e,t){let r=new Map(t.scopes.map(i=>[i.token,i.missing??"false"])),s=i=>{switch(i.kind){case"bool":return i.value;case"number":return i.value;case"string":return i.value;case"scopedvar":{let o=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 l(`@${i.scope}.${i.name} is not declared on the current ${i.scope}.`);return!1}return a}case"call":{if(i.name==="advance"&&!t.functions[i.name]){let a=i.args[0];if(i.args.length!==1||a===void 0)throw new l(`advance() takes exactly 1 argument, got ${i.args.length}`);let c=T(a,e);if(c===void 0)throw new l("advance() needs a quality reference (@scope.name of a quality property)");let d=S(s(a),c,"advance");return c[Math.min(d+1,c.length-1)]}let o=t.functions[i.name];if(!o)throw new l(`unknown function \'${i.name}\'`);return o.eval(i.args,{evaluate:s,ctx:e})}case"flagdelta":throw new l("flagdelta node is only valid as an argument to a flag-delta function");case"unary":{if(i.op==="not"){let a=s(i.operand);if(typeof a!="boolean")throw new l(`\'not\' requires a boolean operand, got ${typeof a}`);return!a}let o=s(i.operand);if(typeof o!="number")throw new l(`unary \'-\' requires a numeric operand, got ${typeof o}`);return-o}case"binary":{if(i.op==="and"){let g=s(i.left);if(typeof g!="boolean")throw new l(`\'and\' requires boolean operands, left is ${typeof g}`);if(!g)return!1;let h=s(i.right);if(typeof h!="boolean")throw new l(`\'and\' requires boolean operands, right is ${typeof h}`);return h}if(i.op==="or"){let g=s(i.left);if(typeof g!="boolean")throw new l(`\'or\' requires boolean operands, left is ${typeof g}`);if(g)return!0;let h=s(i.right);if(typeof h!="boolean")throw new l(`\'or\' requires boolean operands, right is ${typeof h}`);return h}let o=s(i.left),a=s(i.right),c=T(i.left,e),d=T(i.right,e),p=c??d;if(p!==void 0){if(c&&d&&!ke(c,d)&&(i.op===">"||i.op===">="||i.op==="<"||i.op==="<="))throw new l(`\'${i.op}\' compares two different qualities, whose stage orders are unrelated`);switch(i.op){case">":return S(o,p,">")>S(a,p,">");case">=":return S(o,p,">=")>=S(a,p,">=");case"<":return S(o,p,"<")<S(a,p,"<");case"<=":return S(o,p,"<=")<=S(a,p,"<=");case"+":case"-":case"*":case"/":throw new l(`\'${i.op}\' cannot be applied to a quality - a stage is a position, not a number; use advance() to move it`);default:break}}switch(i.op){case"==":return X(o,a);case"!=":return!X(o,a);case">":return b(o,a,">"),o>a;case">=":return b(o,a,">="),o>=a;case"<":return b(o,a,"<"),o<a;case"<=":return b(o,a,"<="),o<=a;case"+":if(typeof o=="number"&&typeof a=="number"||typeof o=="string"&&typeof a=="string")return o+a;throw new l(`\'+\' requires two numbers or two strings, got ${typeof o} and ${typeof a}`);case"-":return b(o,a,"-"),o-a;case"*":return b(o,a,"*"),o*a;case"/":if(b(o,a,"/"),a===0)throw new l("division by zero");return o/a}}}};return s(n)}function X(n,e){if(Array.isArray(n)||Array.isArray(e)){if(!Array.isArray(n)||!Array.isArray(e)||n.length!==e.length)return!1;for(let t=0;t<n.length;t++)if(n[t]!==e[t])return!1;return!0}return n===e}function b(n,e,t){if(typeof n!="number"||typeof e!="number")throw new l(`\'${t}\' requires numeric operands, got ${typeof n} and ${typeof e}`)}function T(n,e){if(!(n.kind!=="scopedvar"||e.qualities===void 0))return e.qualities(n.scope,n.name)}function S(n,e,t){if(typeof n!="string")throw new l(`\'${t}\' on a quality compares stages, got ${typeof n}`);let r=e.indexOf(n);if(r<0)throw new l(`"${n}" is not a stage of this quality (stages: ${e.join(", ")})`);return r}var ke=(n,e)=>n.length===e.length&&n.every((t,r)=>t===e[r]);var Ce={name:"check_flags",count:n=>Math.max(1,n.args.length-1)},Ee=[Ce];function Y(n,e,t){let r=t?.countingCalls??Ee;return I(n,t?.want??!0,e,r)}function I(n,e,t,r){if(n.kind==="binary"&&(n.op==="and"||n.op==="or")){let s=I(n.left,e,t,r),i=I(n.right,e,t,r);return n.op==="and"===e?s>0&&i>0?s+i:0:Math.max(s,i)}if(n.kind==="unary"&&n.op==="not")return I(n.operand,!e,t,r);if(n.kind==="call"){let s=r.find(i=>i.name===n.name);if(s){let i=s.count(n),o=t(n);return e?o?i:0:o?0:1}}return t(n)===e?1:0}var M=class n{values={};decls=new Map;subscribers=new Set;auditors=new Set;norm;constructor(e=[],t){this.norm=t?.normalise??(r=>r.toLowerCase()),this.seed(e)}seed(e){for(let t of e){let r=this.norm(t.name);this.decls.set(r,t),this.values[r]=structuredClone(t.default??Q(t))}}get(e){return this.values[this.norm(e)]}set(e,t,r){let s=this.norm(e);if(this.decls.get(s)?.writable===!1)throw new Error(`\'${e}\' is read-only`);let i={name:s,prev:this.values[s],next:t,silent:r?.silent??!1,reason:r?.reason};this.values[s]=t;for(let o of this.auditors)o(i);if(!i.silent)for(let o of this.subscribers)o(i);return i}subscribe(e){return this.subscribers.add(e),()=>this.subscribers.delete(e)}onAudit(e){return this.auditors.add(e),()=>this.auditors.delete(e)}rows(){return[...this.decls.entries()].map(([e,t])=>Z(t,this.get(e),void 0,e))}declarations(){return[...this.decls.values()]}clone(){let e=new n([],{normalise:this.norm});return e.decls=new Map(this.decls),Object.assign(e.values,structuredClone(this.values)),e}reseed(e){for(let t of Object.keys(this.values))delete this.values[t];this.decls.clear(),this.seed(e)}save(){return structuredClone(this.values)}load(e){for(let[t,r]of Object.entries(e))this.values[this.norm(t)]=r}};function Z(n,e,t,r){return{name:r??n.name.toLowerCase(),type:n.type,value:e,default:n.default??Q(n),...n.values!==void 0?{values:n.values}:{},writable:t??n.writable??!0}}var V=1,C=class{scopes=new Map;defineOwned(e,t){return this.mountOwned(e,new M(t))}mountOwned(e,t){return this.assertFree(e),this.scopes.set(e,{kind:"owned",bag:t}),this}ownedBag(e){let t=this.scopes.get(e);if(!t||t.kind!=="owned")throw new Error(`\'@${e}\' is not an owned scope`);return t.bag}reseedOwned(e,t){return this.ownedBag(e).reseed(t),this}defineForeign(e,t,r=[],s=!0){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:s}),this}has(e){return this.scopes.has(e)}get(e,t){let r=this.scopes.get(e);if(r)return r.kind==="owned"?r.bag.get(t):r.resolver.get(t.toLowerCase())}set(e,t,r){let s=this.scopes.get(e);if(!s)throw new Error(`unknown scope \'@${e}\'`);if(s.kind==="owned"){try{s.bag.set(t,r)}catch{throw new Error(`\'@${e}.${t}\' is read-only`)}return}let i=t.toLowerCase();if(!this.foreignWritable(s,i))throw new Error(`\'@${e}.${t}\' is read-only`);s.resolver.set(i,r)}foreignWritable(e,t){return e.resolver.set?e.decls.get(t)?.writable??e.scopeWritable:!1}listProperties(){let e=[];for(let[t,r]of this.scopes)if(r.kind==="owned")for(let s of r.bag.rows())e.push({scope:t,...s});else for(let s of r.decls.values())e.push({scope:t,...Z(s,r.resolver.get(s.name.toLowerCase()),this.foreignWritable(r,s.name.toLowerCase()))});return e}toEvalContext(e){let t={};for(let[s,i]of this.scopes)t[s]=i.kind==="owned"?i.bag.values:i.resolver;let r=this.qualityLadders();return r.size===0?{scopes:t,host:e}:{scopes:t,host:e,qualities:(s,i)=>r.get(s)?.get(i.toLowerCase())}}qualityLadders(){let e=new Map;for(let[t,r]of this.scopes){let s=r.kind==="owned"?r.bag.declarations():[...r.decls.values()];for(let i of s){if(i.type!=="quality"||i.stages===void 0)continue;let o=e.get(t);o||(o=new Map,e.set(t,o)),o.set(i.name.toLowerCase(),i.stages)}}return e}toSchema(){let e=new Map;for(let[t,r]of this.scopes){let s=r.kind==="owned"?r.bag.declarations():[...r.decls.values()];if(s.length===0)continue;let i=new Map;for(let o of s)i.set(o.name.toLowerCase(),{type:o.type,enumValues:o.values,...o.stages!==void 0?{stages:o.stages}:{}});e.set(t,i)}return{properties:e}}save(){let e={};for(let[t,r]of this.scopes)r.kind==="owned"&&(e[t]=r.bag.save());return e}load(e){for(let[t,r]of Object.entries(e)){let s=this.scopes.get(t);s?.kind==="owned"&&s.bag.load(r)}}saveFragment(){return{version:V,scopes:this.save()}}loadFragment(e){if(e.version!==V)throw new Error(`unsupported owned-state fragment version ${e.version} (supported: ${V})`);this.load(e.scopes)}assertFree(e){if(this.scopes.has(e))throw new Error(`scope \'@${e}\' is already registered`)}};function Q(n){if(n.default!==void 0)return n.default;switch(n.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"enum":return n.values?.[0]??"";case"flags":return[];case"quality":return n.stages?.[0]??""}}function E(n){return n.ctx.host??{}}var L={defaultScope:"patter",scopes:[{token:"patter"},{token:"scene"}],functions:{random:{minArgs:2,maxArgs:2,returnType:"number",eval(n,e){if(n.length!==2)throw new l("random(a, b) requires exactly 2 arguments");let t=E(e).nextRandom;if(!t)throw new l("random() called without a PRNG in context");let r=e.evaluate(n[0]),s=e.evaluate(n[1]);if(typeof r!="number"||typeof s!="number")throw new l("random(a, b) arguments must be numbers");if(!Number.isInteger(r)||!Number.isInteger(s))throw new l("random(a, b) arguments must be integers");let i=Math.min(r,s),o=Math.max(r,s);return Math.floor(t()*(o-i+1))+i}},check_flags:{minArgs:1,returnType:"boolean",flagDeltaArgs:!0,validate:te("check_flags"),eval(n,e){let t=ee(n[0],e,"check_flags");for(let r=1;r<n.length;r++){let s=n[r];if(s.kind!=="flagdelta")throw new l("check_flags() flag args must be +flagName or -flagName");if(s.sign==="+"?!t.includes(s.name):t.includes(s.name))return!1}return!0}},set_flags:{minArgs:1,returnType:"flags",flagDeltaArgs:!0,validate:te("set_flags"),eval(n,e){let t=[...ee(n[0],e,"set_flags")];for(let r=1;r<n.length;r++){let s=n[r];if(s.kind!=="flagdelta")throw new l("set_flags() flag args must be +flagName or -flagName");if(s.sign==="+")t.includes(s.name)||t.push(s.name);else{let i=t.indexOf(s.name);i>=0&&t.splice(i,1)}}return t}},visits:{minArgs:1,maxArgs:1,returnType:"number",validate:B("visits"),eval:(n,e)=>E(e).visits?.(R(n,e,"visits"))??0},seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:B("seen"),eval:(n,e)=>(E(e).visits?.(R(n,e,"seen"))??0)>0},patter_visits:{minArgs:1,maxArgs:1,returnType:"number",validate:B("patter_visits"),eval:(n,e)=>E(e).patterVisits?.(R(n,e,"patter_visits"))??0},patter_seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:B("patter_seen"),eval:(n,e)=>(E(e).patterVisits?.(R(n,e,"patter_seen"))??0)>0}}};function j(n,e){let t=n.replace(/^@/,"").split(".");return t.length===2&&e(t[0])?{scope:t[0],name:t[1].toLowerCase()}:{scope:"patter",name:t.join(".").toLowerCase()}}function R(n,e,t){let r=e.evaluate(n[0]);if(typeof r!="string")throw new l(`${t}(id) requires a string node id`);return r}function B(n){return(e,t)=>{let r=e[0];r&&r.kind!=="string"&&t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(id): the argument must be a string id literal (a scene / block / node id)`})}}function ee(n,e,t){if(!n)throw new l(`${t}() requires at least one argument (the flags variable)`);let r=e.evaluate(n);if(Array.isArray(r))return r;if(r===!1||r===null||r===void 0)return[];throw new l(`${t}() first argument must be a flags property`)}function te(n){return(e,t)=>{if(e.length===0)return;let r=e[0];if(r.kind!=="scopedvar"){t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(): first argument must be a flags property reference (@name or @scope.name)`});return}let s=t.schema.properties.get(r.scope)?.get(r.name);if(s&&s.type!=="flags"){let i=r.scope===t.defaultScope?r.name:`${r.scope}.${r.name}`;t.report({path:[...t.path,"args",0],kind:"wrong-arg-type",severity:"error",message:`${n}(): \'@${i}\' is not a flags property (got ${s.type})`});return}for(let i=1;i<e.length;i++){let o=e[i];o.kind!=="flagdelta"?t.report({path:[...t.path,"args",i],kind:"wrong-arg-type",severity:"error",message:`${n}(): argument ${i+1} must be +flagName or -flagName`}):s?.type==="flags"&&s.enumValues&&!s.enumValues.includes(o.name)&&t.report({path:[...t.path,"args",i],kind:"unknown-flag-name",severity:"error",message:`${n}(): unknown flag \'${o.name}\'`,reference:o.name})}}}var De=/^@[A-Za-z0-9_.]+$/;function*Ie(n){let e="",t=0;for(;t<n.length;){let r=n[t];if(r==="{"&&n[t+1]==="{"){e+="{",t+=2;continue}if(r==="}"&&n[t+1]==="}"){e+="}",t+=2;continue}if(r==="{"){let s=n.indexOf("}",t+1);if(s!==-1){let i=n.slice(t,s+1),o=n.slice(t+1,s).trim();if(o.startsWith("@")){e&&(yield{kind:"text",value:e},e=""),yield{kind:"slot",raw:i,inner:o,ref:De.test(o)?o:void 0},t=s+1;continue}e+=i,t=s+1;continue}}e+=r,t+=1}e&&(yield{kind:"text",value:e})}function Re(n){return Array.isArray(n)?n.join(", "):typeof n=="boolean"?n?"true":"false":String(n)}function Be(n){return n===" "||n==="	"||n===`\n`||n==="\\r"||n==="\\f"||n==="\\v"}function Oe(n){let e="",t=!1;for(let r of n){if(Be(r)){t=!0;continue}t&&e.length>0&&(e+=" "),t=!1,e+=r}return e}function re(n,e,t){if(e.length===0||n.indexOf(e)<0)return n;let r="",s=0,i=!1;for(;s<n.length;){if(n.startsWith(e,s)){let o=n.indexOf(t,s+e.length);if(o>=0){s=o+t.length,i=!0;continue}r+=n.slice(s);break}r+=n[s],s+=1}return i?Oe(r):n}function ne(n,e){if(n.indexOf("{")<0)return n;let t="";for(let r of Ie(n)){if(r.kind==="text"){t+=r.value;continue}if(!r.ref){t+=r.raw;continue}let s=e(r.ref);t+=s===void 0?"":Re(s)}return t}function x(n,e){for(let t of n){e(t);let r=t.children;r&&x(r,e)}}function Pe(n){return n.toLowerCase().replace(/[\'\u2019]/g,"").replace(/[^a-z0-9-]+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function f(n){let e=n.gameId?.trim();return e||Pe(n.name)}function $(n){return`cast:${n}`}var _={open:"[",close:"]"},se="SFX";function O(n){let e=new Set,t=[];for(let r of n)e.has(r)||(e.add(r),t.push(r));return t}function P(n){let e=new Map,t=(r,s)=>{let i=O([...s,...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,O([...i,...o.tags??[]]))};for(let r of Object.values(n.scenes)){let s=O(r.tags??[]);e.set(r.id,s);for(let i of r.blocks){let o=O([...s,...i.tags??[]]);e.set(i.id,o);for(let a of i.children)t(a,o)}}return e}var ie=new WeakMap,N=class n{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,s=e.strings;this.allStrings=s,this.currentLocale=r;let i=s[r]??{},o=s[e.locales.default]??{},a=e.localisation,c=a?.mode==="ids"&&!a.sourceDebug;this.sourceDebug=a?.mode==="ids"&&!!a.sourceDebug,this.sourceDebug&&typeof console<"u"&&console.warn("[Patterplay] source-only DEBUG build: strings are the source language for debugging, not a shippable localised build.");let d=new Map;for(let u of e.cast??[])u.displayName&&d.set(u.name,u.displayName);this.defaultSeed=(t.seed??2654435769)>>>0;let p=new Map,g=new Map,h=new Map;for(let[u,y]of Object.entries(e.scenes)){this.sceneGameIdToId.set(f(y),u);let w=new Map;for(let m of y.blocks)g.set(m.id,{sceneId:u}),h.set(m.id,m),w.set(f(m),m.id),x(m.children,J=>p.set(J.id,J));this.blockGameIdToId.set(u,w)}let W=e.properties??[],A=W.filter(u=>u.shared??!0).map(ae),he=W.filter(u=>!(u.shared??!0)).map(ae),me=new Set(A.map(u=>u.name.toLowerCase())),F=new C().defineOwned("patter",A),K=new Set;if(t.world){let u=e.scopeRegistry?.scopes.find(w=>w.token==="world"),y=(u?.declarations??[]).map(ce);F.defineForeign("world",t.world,y,u?.writable??!0),K.add("world")}for(let u of e.scopeRegistry?.scopes??[]){if(K.has(u.token))continue;let y=(u.declarations??[]).map(ce);F.defineForeign(u.token,Fe(u.declarations??[]),y,u.writable??!0)}let z=new Map;for(let[u,y]of Object.entries(e.scenes)){let w=new Set((y.sceneProps??[]).filter(m=>m.shared??!1).map(m=>m.name.toLowerCase()));z.set(u,w)}this.host={bundle:e,emitIds:c,strings:i,defaultStrings:o,castDisplay:d,nodeIndex:p,blockIndex:g,blockById:h,sceneGameIdToId:this.sceneGameIdToId,blockGameIdToId:this.blockGameIdToId,tagIndex:P(e),shared:F,patterSharedDecls:A,patterLocalDecls:he,patterSharedNames:me,sceneSharedNames:z,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??_).open,captionClose:(e.closedCaptions??_).close,captionCharacter:e.closedCaptions?.character||se,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),s=new n(e,this.creationOptions);try{return s.loadGame(t),r(s)}catch{let i=new n(e,this.creationOptions);for(let[o,a]of Object.entries(t.flows)){let c=a.cursor.currentSceneId;try{i.openFlow(o,c!==null?{scene:c}:{})}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),s=this.resolveBlockRef(r,t.block);this.flowsById.get(e)?.close();let i=new k(e,this.host,t.seed??this.defaultSeed);return this.flowsById.set(e,i),i.start(r,s),i}runFlow(e,t,r){let s=this.flowsById.get(e);if(!s)return this.openFlow(e,{scene:t,block:r}).advanceToStop().played;if(!s.goto(t,r))throw new Error(`runFlow: address not found: ${t}${r===void 0?"":` / ${r}`}`);return s.advanceToStop().played}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),s=this.resolveBlockRef(r,t);return(s!=null?this.host.tagIndex.get(s):void 0)??[]}getCast(){let e=[];for(let t of this.host.bundle.cast??[])t?.name&&e.push(t.name);return e}castForScene(e){let t=this.resolveSceneRef(e),r=t!=null?this.host.bundle.scenes[t]:void 0;if(!r)return[];let s=new Set;for(let i of r.blocks)oe(i.children,s);return[...s]}castForBlock(e,t){let r=this.resolveSceneRef(e),s=this.resolveBlockRef(r,t),i=s!=null?this.host.blockById.get(s):void 0;if(!i)return[];let o=new Set;return oe(i.children,o),[...o]}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)x(r.children,s=>{if(s.type==="snippet")for(let i of s.beats??[])e.push({sceneId:t.id,blockId:r.id,snippetId:s.id,beat:this.beatInfo(i)})});return e}outlineNode(e){return e.type==="group"?{type:"group",id:e.id,...this.tagsField(e.id),...e.selector?{selector:e.selector}:{},...e.prompt?{prompt:this.beatInfo(e.prompt)}:{},children:e.children.map(t=>this.outlineNode(t))}:{type:"snippet",id:e.id,...this.tagsField(e.id),beats:(e.beats??[]).map(t=>this.beatInfo(t)),...e.jump?{jumpTo:e.jump.to,...e.jump.mode?{jumpMode:e.jump.mode}:{}}:{}}}beatInfo(e){let t=this.host.tagIndex.get(e.id),r={id:e.id,kind:e.kind};if(e.kind==="line"){if(e.character!==void 0){r.character=e.character;let s=this.host.defaultStrings[$(e.character)]??this.host.castDisplay.get(e.character);s!==void 0&&(r.characterName=s)}e.direction!==void 0&&(r.direction=e.direction)}if(e.kind==="line"||e.kind==="text"){let s=this.host.defaultStrings[e.id];s!==void 0&&(r.text=s)}return e.gameData&&Object.keys(e.gameData).length&&(r.gameData=e.gameData),t&&t.length&&(r.tags=t),r}tagsField(e){let t=this.host.tagIndex.get(e);return t&&t.length?{tags:t}:{}}getFlow(e){return this.flowsById.get(e)}flows(){return[...this.flowsById.values()]}closeFlow(e){this.flowsById.get(e)?.close(),this.flowsById.delete(e)}reset(){for(let e of this.flowsById.values())e.close();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:s}=this.splitShared(e);this.host.shared.set(r,s,t)}listProperties(){return this.host.patterSharedDecls.map(e=>({ref:`@${e.name}`,type:e.type,values:e.values,stages:e.stages,value:this.getProperty(`@${e.name}`),default:Ne(e)}))}splitShared(e){let t=this.host.refSplitCache.get(e);if(t||(t=j(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:pe(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 de(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 s=new k(t,this.host,this.defaultSeed);s.restore(r),this.flowsById.set(t,s)}}},k=class{id;host;local;rngState;started=!1;flowEnded=!1;closed=!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 s=this.host.sceneSharedNames.get(r)?.has(e)?this.host.stageBags.get(r):this.sceneBags.get(r);s&&(s[e]=t)}};evalCtx;constructor(e,t,r){this.id=e,this.host=t,this.rngState=r>>>0,this.local=this.freshLocal();let s={...t.shared.toEvalContext().scopes};s.patter=this.patterResolver,s.scene=this.sceneResolver,this.evalCtx={scopes:s,host:{nextRandom:this.rng,visits:i=>this.visitCounts.get(i)??0,patterVisits:i=>this.host.sharedVisits.get(i)??0},qualities:(i,o)=>this.stagesFor(i,o)}}stagesFor(e,t){let r=t.toLowerCase(),s=i=>i?.find(o=>o.name.toLowerCase()===r&&o.type==="quality")?.stages;if(e==="patter")return s(this.host.patterSharedDecls)??s(this.host.patterLocalDecls);if(e==="scene"){let i=this.currentSceneId!=null?this.host.bundle.scenes[this.currentSceneId]:void 0;return s(i?.sceneProps)}return s(this.host.bundle.scopeRegistry?.scopes.find(i=>i.token===e)?.declarations)}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],s=r?this.host.bundle.scenes[r]:void 0;if(!s)throw new Error(r?`unknown scene: ${r}`:"no scenes in bundle");this.enterSceneSetup(r);let i=s.blocks[0];i&&(this.stack=[{sceneId:r,containerId:i.id,index:0}],this.enter(i.id))}this.settle()}reset(e,t){this.start(e,t)}goto(e,t){if(this.closed)return!1;if(e==="END")return this.started=!0,this.pendingChoice=null,this.pendingPromptBeat=null,this.pendingPromptOwnerId=null,this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!0,this.stack=[],!0;let r=this.host.sceneGameIdToId.get(e)??(this.host.bundle.scenes[e]?e:void 0);if(r===void 0)return!1;let s;return t!==void 0&&(s=this.host.blockGameIdToId.get(r)?.get(t)??(this.host.blockIndex.get(t)?.sceneId===r?t:void 0),s===void 0)?!1:this.started?(this.pendingChoice=null,this.pendingPromptBeat=null,this.pendingPromptOwnerId=null,this.activeSnippet=null,this.beatIndex=0,this.flowEnded=!1,this.enterTarget(s??r,"jump"),this.settle(),!0):(this.start(r,s),!0)}close(){this.closed=!0,this.flowEnded=!0,this.stack=[],this.activeSnippet=null,this.beatIndex=0,this.pendingChoice=null,this.pendingPromptBeat=null,this.pendingPromptOwnerId=null}get isClosed(){return this.closed}get currentScene(){return this.currentSceneId}advance(){if(this.closed)return{type:"end"};if(!this.started)throw new Error("flow has not been started");if(this.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 s=this.activeSnippet.jump;this.activeSnippet=null,this.beatIndex=0,this.resolveJump(s);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 s=t.byId.get(e);this.pendingChoice=null,this.pendingPromptBeat=this.host.replayPromptOnChoose?this.promptBeatOf(s)??null:null,this.pendingPromptOwnerId=this.pendingPromptBeat?s.id:null,this.enterChild(s)}isEnded(){return this.flowEnded}getProperty(e){let{scope:t,name:r}=this.splitRef(e);return t==="patter"?this.patterResolver.get(r):t==="scene"?this.sceneResolver.get(r):this.host.shared.get(t,r)}setProperty(e,t){let{scope:r,name:s}=this.splitRef(e);if(r==="patter")this.patterResolver.set(s,t);else if(r==="scene"){if(this.currentSceneId===null)throw new Error(`\'${e}\': the flow has not entered a scene yet`);this.sceneResolver.set(s,t)}else this.host.shared.set(r,s,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:pe(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:s,...i}=r;if(s!==void 0){let o=this.childrenOf(i.containerId)?.findIndex(a=>a.id===s)??-1;if(o>=0)return{...i,index:o}}return{...i}}),this.sceneBags=new Map(Object.entries(e.sceneBags??{}).map(([r,s])=>[r,{...s}])),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=de(t.selectors),this.pendingChoice=null,t.pendingChoice!==null){let r=new Map,s=[];for(let i of t.pendingChoice.options){let o=this.host.nodeIndex.get(i.id);o&&(r.set(i.id,o),s.push({...i}))}s.length>0&&(this.pendingChoice={groupId:t.pendingChoice.groupId,options:s,byId:r})}if(this.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,s=[];for(let o of e.children){if(o.fallback===!0){s.push(o);continue}if(o.sticky!==!0&&(this.visitCounts.get(o.id)??0)>=1)continue;let a=this.eligible(o),c=o.secretUntilEligible===!0;!a&&c||(t.push({id:o.id,prompt:this.promptFor(o),eligible:a,gameData:o.gameData}),r.set(o.id,o))}if(t.length>0){this.pendingChoice={groupId:e.id,options:t,byId:r};return}let i=s.find(o=>this.eligible(o));if(i){this.enterChild(i);return}this.host.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,s,i=this.host.bundle.scenes[e];if(i){this.enterSceneSetup(e);let a=i.blocks[0];if(!a){t==="jump"&&(this.stack=[]);return}r=e,s=a.id}else{let a=this.host.blockIndex.get(e);if(!a)throw new Error(`jump target not found: ${e}`);a.sceneId!==this.currentSceneId&&this.enterSceneSetup(a.sceneId),r=a.sceneId,s=e}this.enter(s);let o={sceneId:r,containerId:s,index:0};t==="call"?this.stack.push(o):this.stack=[o]}selectChild(e){let t=e.children.filter(s=>this.eligible(s));if(t.length===0)return null;let r=this.selectorState(e);switch(e.selector){case"branch":return t[0];case"sequence":{let s=e.options?.order??"sequential",i=e.options?.exhaust??"once";return s==="shuffle"?this.pickShuffle(t,i,r):s==="specificity"?this.pickSpecificity(t,i,r):this.pickSequential(t,i,r)}default:return null}}pickSequential(e,t,r){let s=e.length,i=r.seq??0;return r.seq=i+1,t==="repeat"?e[i%s]:i<s?e[i]:t==="stick"?e[s-1]:null}pickShuffle(e,t,r){let s=e.length,i=t==="stick",o=()=>(i?e.slice(0,s-1):e).map(g=>g.id);if(r.bag===void 0&&(r.bag=o()),r.bag.length===0){if(t==="once")return null;if(i){let g=e[s-1];return r.last=g.id,g}r.bag=o()}let a=r.bag,c=r.last!==void 0&&a.length>1?a.indexOf(r.last):-1,d=Math.floor(this.rng()*(c>=0?a.length-1:a.length));c>=0&&d>=c&&d++;let p=a[d];return a.splice(d,1),r.last=p,e.find(g=>g.id===p)}pickSpecificity(e,t,r){let s=e;if(t!=="repeat"){r.bag===void 0&&(r.bag=e.map(p=>p.id));let d=new Set(r.bag);if(s=e.filter(p=>d.has(p.id)),s.length===0)return t==="stick"&&r.last!==void 0?e.find(p=>p.id===r.last)??null:null}let i=-1,a=s.map(d=>{let p=this.specScore(d);return p>i&&(i=p),{c:d,s:p}}).filter(d=>d.s===i).map(d=>d.c),c;if(a.length===1)c=a[0];else{let d=r.last!==void 0?a.findIndex(g=>g.id===r.last):-1,p=Math.floor(this.rng()*(d>=0?a.length-1:a.length));d>=0&&p>=d&&p++,c=a[p]}return t!=="repeat"&&(r.bag=r.bag.filter(d=>d!==c.id)),r.last=c.id,c}specScore(e){return e.condition?this.matchedSpec(this.conditionAst(e.condition),!0):0}matchedSpec(e,t){return Y(e,s=>le(D(s,this.evalCtx,L)),{want:t})}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?le(this.evalExpr(e.condition)):!0}evalExpr(e){return D(this.conditionAst(e),this.evalCtx,L)}conditionAst(e){let t=ie.get(e);return t||(t=v(e.ast),ie.set(e,t)),t}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 s=this.resolveString(e.id),i=!this.host.captionsOn,a=i&&e.character===this.host.captionCharacter?"":this.captionLine(this.host.bundle.voiced?s:this.interpolate(s)),c=i&&a.length===0;return{type:"line",id:e.id,text:a,character:c?void 0:e.character,characterName:c?void 0:this.resolveCharacterName(e.character),direction:c?void 0:e.direction,gameData:e.gameData,...r}}}}interpolate(e){return ne(e,t=>this.getProperty(t))}stripCaptions(e){return re(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 x(e,r=>{!t&&r.type==="snippet"&&(r.beats??[]).some(s=>s.kind==="line"||s.kind==="text")&&(t=r)}),t}resolveString(e){if(this.host.emitIds)return e;let t=this.host.strings[e];if(t!==void 0)return t;let r=this.host.defaultStrings[e];return r!==void 0?`<Untranslated: ${e}> ${r}`:e}resolveCharacterName(e){if(e===void 0||this.host.emitIds)return;let t=$(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=j(e,r=>r==="scene"||this.host.shared.has(r)),this.host.refSplitCache.set(e,t)),t}freshLocal(){return new C().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 s of e.sceneProps??[]){let i=s.name.toLowerCase();t.has(i)||(r[i]=q(s))}this.sceneBags.set(e.id,r)}if(!this.host.stageBags.has(e.id)){let r={};for(let s of e.sceneProps??[]){let i=s.name.toLowerCase();t.has(i)&&(r[i]=q(s))}this.host.stageBags.set(e.id,r)}for(let r of e.sceneProps??[]){if(!r.temporary)continue;let s=r.name.toLowerCase(),i=t.has(s)?this.host.stageBags.get(e.id):this.sceneBags.get(e.id);i&&(i[s]=q(r))}}};function oe(n,e){x(n,t=>{if(t.type==="group"){t.prompt?.kind==="line"&&t.prompt.character&&e.add(t.prompt.character);return}for(let r of t.beats??[])r.kind==="line"&&r.character&&e.add(r.character)})}function pe(n){let e={};for(let[t,r]of n){let s={};r.seq!==void 0&&(s.seq=r.seq),r.bag&&(s.bag=[...r.bag]),r.last!==void 0&&(s.last=r.last),e[t]=s}return e}function de(n){let e=new Map;for(let[t,r]of Object.entries(n??{})){let s={};r.seq!==void 0&&(s.seq=r.seq),r.bag&&(s.bag=[...r.bag]),r.last!==void 0&&(s.last=r.last),e.set(t,s)}return e}function ae(n){return{name:n.name,type:n.type,values:n.values,stages:n.stages,default:n.default}}function Ne(n){if(n.default!==void 0)return n.default;switch(n.type){case"number":return 0;case"string":return"";case"flags":return[];case"enum":return n.values?.[0]??"";case"quality":return n.stages?.[0]??"";default:return!1}}function ce(n){return{name:n.name,type:n.type,values:n.values,stages:n.stages,default:n.default,writable:n.writable}}function Ae(n){if(n.default!==void 0)return n.default;switch(n.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"flags":return[];case"enum":return n.values?.[0]??"";case"quality":return n.stages?.[0]??""}}function Fe(n){let e=r=>r.toLowerCase(),t=new Map;for(let r of n)t.set(e(r.name),Ae(r));return{get:r=>t.get(e(r)),set:(r,s)=>{t.set(e(r),s)}}}function q(n){if(n.default!==void 0)return n.default;switch(n.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"flags":return[];case"enum":return n.values?.[0]??"";case"quality":return n.stages?.[0]??""}}function le(n){return typeof n=="boolean"?n:typeof n=="number"?n!==0:typeof n=="string"?n!=="":n.length>0}var Ge=(n,e)=>n.shared??e;function H(n,e){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.default!==void 0?{default:n.default}:{},shared:Ge(n,e)}}function Te(n){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.values?{values:[...n.values]}:{},...n.purpose?{purpose:n.purpose}:{}}}function Ve(n,e){e.blocks++;let t=[...n.children];for(;t.length;){let r=t.pop();if(r.type==="group"){e.groups++,r.prompt&&e.prompts++,t.push(...r.children);continue}e.snippets++;for(let s of r.beats??[])e.beats++,s.kind==="gameEvent"&&e.gameEvents++}}function ue(n){let e={scenes:0,blocks:0,groups:0,snippets:0,beats:0,prompts:0,gameEvents:0,cast:n.cast?.length??0},t=[],r=[];for(let o of Object.values(n.scenes)){e.scenes++;let a=f(o);t.push({gameId:a,name:o.name,blocks:o.blocks.map(c=>({gameId:f(c),name:c.name}))});for(let c of o.blocks)Ve(c,e);o.sceneProps?.length&&r.push({gameId:a,properties:o.sceneProps.map(c=>H(c,!1))})}let s=(n.scopeRegistry?.scopes??[]).map(o=>({token:o.token,writable:o.writable??!0,opaque:o.declarations===void 0,properties:(o.declarations??[]).map(a=>H(a,!0))})),i=Object.entries(n.gameDataFields??{}).filter(([,o])=>(o?.length??0)>0).map(([o,a])=>({kind:o,fields:(a??[]).map(Te)}));return{identity:{schema:n.schema,project:n.content.project,...n.content.version!==void 0?{version:n.content.version}:{},...n.content.hash!==void 0?{hash:n.content.hash}:{},...n.content.structureHash!==void 0?{structureHash:n.content.structureHash}:{},voiced:n.voiced,defaultLocale:n.locales.default,locales:[...n.locales.included],localisation:n.localisation?.mode??"embedded",sourceDebug:n.localisation?.sourceDebug??!1},addresses:t,hostScopes:s,properties:{patter:(n.properties??[]).map(o=>H(o,!0)),scene:r},gameData:i,counts:e}}function ge(n,e){return n.gameDataFields?.[e]??[]}function U(n,e,t){return e&&Object.prototype.hasOwnProperty.call(e,t)?e[t]:n.find(r=>r.name===t)?.default}function fe(n,e){let t={};for(let r of n){let s=U(n,e,r.name);s!==void 0&&(t[r.name]=s)}for(let[r,s]of Object.entries(e??{}))r in t||(t[r]=s);return t}return xe(Me);})();\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; }
 `;
@@ -478,7 +854,7 @@ function sourceStory(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");
+  const bundleJson = canonicalStringify2(bundle, { trailingComma: false }).replace(/</g, "\\u003c");
   return { title, lang: def, bundleJson };
 }
 function page(title, lang, head, tail) {
@@ -607,7 +983,7 @@ function stringsByLocale(loaded) {
   }
   return byLocale;
 }
-function mergeAuthoring(loaded) {
+function mergeAuthoring2(loaded) {
   const writing = /* @__PURE__ */ new Map();
   const recording = /* @__PURE__ */ new Map();
   const cut = /* @__PURE__ */ new Set();
@@ -808,7 +1184,7 @@ function proposeCoverageDrivers(loaded) {
   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 });
+    for (const d of s.declarations ?? []) declByRef.set(`@${s.token}.${d.name}`, { type: d.type, values: d.values, stages: d.stages });
   }
   const drivers = [];
   for (const [ref, pool] of proposals) {
@@ -818,6 +1194,7 @@ function proposeCoverageDrivers(loaded) {
     if (values.length === 0 && decl) {
       if (decl.type === "boolean") values = [true, false];
       else if (decl.type === "enum" && decl.values) values = [...decl.values];
+      else if (decl.type === "quality" && decl.stages) values = [...decl.stages];
     }
     if (values.length === 0) continue;
     drivers.push({ ref, kind: "recurring", cadence: "sometimes", values: sortValues(values) });
@@ -1020,13 +1397,13 @@ function renderCoverageText(report, sceneName = (id) => id) {
 
 // src/format.ts
 import { readFileSync as readFileSync3 } from "fs";
-import { canonicalStringify as canonicalStringify2, parseSource as parseSource3 } from "@patterkit/core";
+import { canonicalStringify as canonicalStringify3, 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));
+      canonical = canonicalStringify3(parseSource3(original));
     } catch (e) {
       throw new Error(`${file}: ${e instanceof Error ? e.message : String(e)}`);
     }
@@ -1066,7 +1443,7 @@ function runReport(loaded, recordingOverride) {
   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, rerecord: rerecordSet, edits: editsOf } = mergeAuthoring(loaded);
+  const { writing: writingOf, recording: manualRecordingOf, cut: cutSet, rerecord: rerecordSet, edits: editsOf } = mergeAuthoring2(loaded);
   const recordingBase = recordingOverride ?? manualRecordingOf;
   const recordingOf = (id) => effectiveRecording(id, recordingBase, rerecordSet, recordingLadder[0]);
   const byLocale = stringsByLocale(loaded);
@@ -1411,7 +1788,7 @@ async function runReportXlsx(data) {
 
 // src/localisation.ts
 import { basename as basename4, join as join3, sep } from "path";
-import { canonicalStringify as canonicalStringify3 } from "@patterkit/core";
+import { canonicalStringify as canonicalStringify4 } from "@patterkit/core";
 import { walkNodes as walkNodes3, castStringKey, PROJECT_LOCALE_SCENE } from "@patterkit/model";
 
 // src/documentation.ts
@@ -1426,7 +1803,7 @@ function classesForChannel(classes, channel) {
 function resolveDocumentation(loaded, channel) {
   const classes = loaded.project.documentationClasses ?? DEFAULT_DOCUMENTATION_CLASSES;
   const allowed = classesForChannel(classes, channel);
-  const docsOf = mergeAuthoring(loaded).documentation;
+  const docsOf = mergeAuthoring2(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) => {
@@ -1462,7 +1839,7 @@ function extractLoc(loaded, opts = {}) {
   const targetLocale = isTemplate ? void 0 : opts.locale;
   const source = tableFor(loaded, defaultLocale);
   const target = targetLocale ? tableFor(loaded, targetLocale) : {};
-  const edits = mergeAuthoring(loaded).edits;
+  const edits = mergeAuthoring2(loaded).edits;
   const docs = resolveDocumentation(loaded, "loc");
   const commentsOf = (id) => (docs.get(id) ?? []).map((d) => d.text);
   const staleFor = (id, translation) => {
@@ -1569,7 +1946,7 @@ function applyLoc(loaded, catalog, opts = {}) {
       merged[id] = text;
     }
     const file = { schema: existing?.schema ?? "patter/strings@0", scene, locale, strings: merged };
-    writes.push({ path, content: canonicalStringify3(file) });
+    writes.push({ path, content: canonicalStringify4(file) });
     const fresh = bySceneFresh.get(scene);
     if (!fresh?.size) continue;
     const aPath = authoringPath(loaded, scene);
@@ -1578,7 +1955,7 @@ function applyLoc(loaded, catalog, opts = {}) {
     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) });
+    writes.push({ path: aPath, content: canonicalStringify4(authoring) });
   }
   return { writes, stats: { updated, files: bySceneText.size } };
 }
@@ -1630,1660 +2007,1347 @@ function catalogToPo(catalog) {
     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", "Gender"];
-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 },
-      { header: "Gender", key: "gender", width: 12 }
-    ];
-    ws.getRow(1).font = { bold: true };
-    ws.views = [{ state: "frozen", ySplit: 1 }];
-    for (const e of entries) {
-      ws.addRow({
-        id: e.id,
-        source: e.source,
-        translation: e.translation,
-        comments: e.comments.join("\n"),
-        status: e.stale ? "stale" : e.translation ? "translated" : "",
-        gender: e.context?.gender ?? ""
-      });
-    }
-  }
-  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, rerecord: rerecordSet, documentation: docsOf } = mergeAuthoring(loaded);
-  const recordingBase = opts.recordingOverride ?? manualRecordingOf;
-  const recordingOf = (id) => effectiveRecording(id, recordingBase, rerecordSet, recordingLadder[0]);
-  const source = sourceStrings(loaded);
-  const actorOf = /* @__PURE__ */ new Map();
-  for (const c of project.cast ?? []) if (c.actor) actorOf.set(c.name, c.actor);
-  const 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(beat.id)
-      });
-      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 };
-  ws.views = [{ state: "frozen", ySplit: 1 }];
-  for (const l of data.lines) {
-    const row = ws.addRow({
-      scope: l.scope,
-      id: l.id,
-      character: l.character,
-      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).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((resolve5, reject) => {
-    const pdf = new PDFDocument({ size: "A4", margins: { top: MARGIN, bottom: MARGIN, left: MARGIN, right: MARGIN }, info: { Title: doc.project, Author: "Patter" }, font: null });
-    pdf.registerFont("Serif", scriptFont("serif"));
-    pdf.registerFont("Serif-Bold", scriptFont("serifBold"));
-    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", () => resolve5(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;
-          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 = yTop;
-          }
-          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 });
-          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;
-          if (tag) {
-            pdf.font("Sans").fontSize(7.5).fillColor(MUTED).text(tag, pageRight - tagW, yStart, { width: tagW, align: "right", lineBreak: false });
-            pdf.y = yStart;
-          }
-          pdf.fontSize(BODY);
-          draw([...split("\u25C7  ", "Serif", ACCENT), ...bodyPieces(el.runs, INK)], ox, { width: Math.max(80, pageRight - ox - tagW), indent: -HANG2, lineGap: LEAD });
-          break;
-        }
-        case "jump":
-          drawRight(split(`\u21AA  ${el.text}`, "Sans-Bold", ACCENT), 9.5);
-          break;
-        case "gameEvent": {
-          const pieces = split(`\u2699  ${el.text}`, "Mono", ACCENT);
-          pdf.fontSize(9);
-          let total = 0;
-          for (const p of pieces) {
-            pdf.font(p.font);
-            total += pdf.widthOfString(p.text);
-          }
-          if (total <= pageRight - cx) drawRight(pieces, 9);
-          else draw(pieces, cx, { width: pageRight - cx });
-          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);
-      else ensure(leadOf(el.kind) + BODY + LEAD + 14);
-      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;
-      const pageBefore = pdf.page;
-      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;
-        const top = pdf.page === pageBefore ? yTop : MARGIN;
-        pdf.strokeColor(EDGE).lineWidth(0.75).moveTo(ex, top).lineTo(ex, bottom + (sameNext ? trail : 0)).stroke();
-      }
-      pdf.y = bottom + trail;
-    }
-    pdf.end();
-  });
+  }
+  return out.join("\n");
 }
-
-// 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 {
+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++;
   }
-  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" }
-        }]
-      }]
+  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 = "";
   };
-  const locale = {
-    schema: "patter/strings@0",
-    scene: sceneId,
-    locale: "en",
-    default: true,
-    // The starter line is STORY content the writer replaces, so it must read the same however the
-    // project was made: no file paths, no commands. (Front-ends give their own next step - `patter init`
-    // prints "try: patter play <dir>" on the terminal, and Patterpad just opens the scene for editing.)
-    strings: { [beatId]: `Welcome to ${name}. This is the first line of your story - replace it with your own.` }
-  };
-  const bundle = opts.bundle ?? "commit";
-  const projectFile = 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(", ")}`);
+  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 { 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;
+  return { project, defaultLocale: locale ?? "", locale, entries };
 }
-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;
+// src/loc-xlsx.ts
+var HEADERS = ["ID", "Source", "Translation", "Comments", "Status", "Gender"];
+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 },
+      { header: "Gender", key: "gender", width: 12 }
+    ];
+    ws.getRow(1).font = { bold: true };
+    ws.views = [{ state: "frozen", ySplit: 1 }];
+    for (const e of entries) {
+      ws.addRow({
+        id: e.id,
+        source: e.source,
+        translation: e.translation,
+        comments: e.comments.join("\n"),
+        status: e.stale ? "stale" : e.translation ? "translated" : "",
+        gender: e.context?.gender ?? ""
+      });
+    }
   }
+  return Buffer.from(await wb.xlsx.writeBuffer());
 }
-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");
+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 lines.join("\n") + "\n";
+  return { project: "", defaultLocale: "", locale: void 0, entries };
 }
-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"
-`
+// 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, rerecord: rerecordSet, documentation: docsOf } = mergeAuthoring2(loaded);
+  const recordingBase = opts.recordingOverride ?? manualRecordingOf;
+  const recordingOf = (id) => effectiveRecording(id, recordingBase, rerecordSet, recordingLadder[0]);
+  const source = sourceStrings(loaded);
+  const actorOf = /* @__PURE__ */ new Map();
+  for (const c of project.cast ?? []) if (c.actor) actorOf.set(c.name, c.actor);
+  const 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(beat.id)
+      });
+      leading = false;
+    }
   };
-  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)}`;
+  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 };
 }
-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}
+// 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 };
+  ws.views = [{ state: "frozen", ySplit: 1 }];
+  for (const l of data.lines) {
+    const row = ws.addRow({
+      scope: l.scope,
+      id: l.id,
+      character: l.character,
+      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());
+}
 
-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/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;
 }
-
-// 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;
+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;
   }
-  return [];
+  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 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];
+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).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(", ")}`;
   }
-  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);
+  return "game event";
 }
-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 statusAt = (id) => recording ? effectiveRecording(id, statusOf, merged.rerecord, lowest ?? "") : statusOf.get(id) ?? lowest;
-  const out = [];
+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 } = mergeAuthoring2(loaded);
+  const sceneOf = /* @__PURE__ */ new Map();
+  const blockTrail = /* @__PURE__ */ new Map();
+  const blockName = /* @__PURE__ */ new Map();
   for (const scene of loaded.scenes) {
-    const file = loaded.sceneFiles[scene.id];
+    sceneOf.set(scene.id, scene.name);
     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 (statusAt(beat.id) !== status) return;
-        out.push({ id: beat.id, kind: "beat", text: strings[beat.id], location: segments, sceneId: scene.id, file });
-      };
-      walkNodes4(block.children, (node) => {
-        if (node.type === "group") {
-          if (node.prompt) consider(node.prompt);
-          return;
+      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);
         }
-        for (const beat of node.beats ?? []) consider(beat);
+      }
+      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 (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);
+    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) {
-    add(scene.tags);
+    if (cut.has(scene.id)) continue;
+    els.push({ kind: "scene", text: scene.name });
     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);
+      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 })]
       });
-    }
-  }
-  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 });
+    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 })] });
   }
-  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}`);
+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((resolve5, reject) => {
+    const pdf = new PDFDocument({ size: "A4", margins: { top: MARGIN, bottom: MARGIN, left: MARGIN, right: MARGIN }, info: { Title: doc.project, Author: "Patter" }, font: null });
+    pdf.registerFont("Serif", scriptFont("serif"));
+    pdf.registerFont("Serif-Bold", scriptFont("serifBold"));
+    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;
     }
-    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;
+    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;
         }
-        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}`);
+        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", () => resolve5(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;
+          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 = yTop;
           }
+          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 });
+          break;
         }
-        for (const beat of node.beats ?? []) {
-          if (refs(strings[beat.id]) && valueOk(strings[beat.id])) push(beat.id, "beat", segments, strings[beat.id]);
+        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;
+          if (tag) {
+            pdf.font("Sans").fontSize(7.5).fillColor(MUTED).text(tag, pageRight - tagW, yStart, { width: tagW, align: "right", lineBreak: false });
+            pdf.y = yStart;
+          }
+          pdf.fontSize(BODY);
+          draw([...split("\u25C7  ", "Serif", ACCENT), ...bodyPieces(el.runs, INK)], ox, { width: Math.max(80, pageRight - ox - tagW), indent: -HANG2, lineGap: LEAD });
+          break;
         }
-      });
-    }
-  }
-  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;
+        case "jump":
+          drawRight(split(`\u21AA  ${el.text}`, "Sans-Bold", ACCENT), 9.5);
+          break;
+        case "gameEvent": {
+          const pieces = split(`\u2699  ${el.text}`, "Mono", ACCENT);
+          pdf.fontSize(9);
+          let total = 0;
+          for (const p of pieces) {
+            pdf.font(p.font);
+            total += pdf.widthOfString(p.text);
+          }
+          if (total <= pageRight - cx) drawRight(pieces, 9);
+          else draw(pieces, cx, { width: pageRight - cx });
+          break;
         }
-        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
-          });
+      }
+    };
+    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);
+      else ensure(leadOf(el.kind) + BODY + LEAD + 14);
+      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;
+      const pageBefore = pdf.page;
+      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;
+        const top = pdf.page === pageBefore ? yTop : MARGIN;
+        pdf.strokeColor(EDGE).lineWidth(0.75).moveTo(ex, top).lineTo(ex, bottom + (sameNext ? trail : 0)).stroke();
+      }
+      pdf.y = bottom + trail;
     }
-  }
-  return out;
+    pdf.end();
+  });
 }
 
-// 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);
-      });
-    }
+// 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 canonicalStringify5 } 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 {
   }
-  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++;
+  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" }
+        }]
+      }]
     }
-  }
-  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");
-var ENTRY_OPTS = { date: FIXED_DATE, createFolders: false };
-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", ENTRY_OPTS);
-  for (const f of files) zip.file(f.rel, readFileSync4(f.abs, "utf8"), ENTRY_OPTS);
-  return zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE", streamFiles: false });
+  const locale = {
+    schema: "patter/strings@0",
+    scene: sceneId,
+    locale: "en",
+    default: true,
+    // The starter line is STORY content the writer replaces, so it must read the same however the
+    // project was made: no file paths, no commands. (Front-ends give their own next step - `patter init`
+    // prints "try: patter play <dir>" on the terminal, and Patterpad just opens the scene for editing.)
+    strings: { [beatId]: `Welcome to ${name}. This is the first line of your story - replace it with your own.` }
+  };
+  const bundle = opts.bundle ?? "commit";
+  const projectFile = join4(dir, `${fileSlug}.patterproj`);
+  const writes = [
+    { path: projectFile, content: canonicalStringify5(project) },
+    { path: join4(dir, "scenes", "start.patterflow"), content: canonicalStringify5(flow) },
+    { path: join4(dir, "loc", "en", "start.patterloc"), content: canonicalStringify5(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
 
-// src/unpack.ts
-import JSZip2 from "jszip";
-import { join as join5, normalize, isAbsolute as isAbsolute2, resolve as resolve4, sep as sep3 } from "path";
-import { existsSync as existsSync3, readFileSync as readFileSync5 } from "fs";
-import { parseSource as parseSource5, canonicalStringify as canonicalStringify7 } from "@patterkit/core";
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
 
-// 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);
+[*.{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 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, resolve5) {
-  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 = resolve5?.(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;
+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 out;
+  return lines.join("\n") + "\n";
 }
-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 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 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 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\`.
+`;
 }
-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));
+
+// 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;
   }
-  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: [] };
+  return [];
 }
-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);
+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];
   }
-  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" };
-  };
+  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 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;
+function runStatusBrowse(loaded, status, dimension = "writing", focus, recordingOverride) {
+  const strings = sourceStrings(loaded);
+  const merged = mergeAuthoring2(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 statusAt = (id) => recording ? effectiveRecording(id, statusOf, merged.rerecord, lowest ?? "") : statusOf.get(id) ?? lowest;
+  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 (statusAt(beat.id) !== status) return;
+        out.push({ id: beat.id, kind: "beat", text: strings[beat.id], location: segments, sceneId: scene.id, file });
+      };
+      walkNodes4(block.children, (node) => {
+        if (node.type === "group") {
+          if (node.prompt) consider(node.prompt);
+          return;
+        }
+        for (const beat of node.beats ?? []) consider(beat);
+      });
     }
-    out[id] = mergeEditRecord(asMap(o), asMap(t));
   }
+  if (focus) out.sort((a, b) => (a.sceneId === focus.sceneId ? 0 : 1) - (b.sceneId === focus.sceneId ? 0 : 1));
   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;
+function listProjectTags(loaded) {
+  const counts = /* @__PURE__ */ new Map();
+  const add = (tags) => {
+    for (const t of tags ?? []) counts.set(t, (counts.get(t) ?? 0) + 1);
   };
-  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;
+  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 { 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;
+  return [...counts.entries()].map(([name, count]) => ({ name, count })).sort((a, b) => a.name.localeCompare(b.name));
 }
-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);
+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 });
+      });
+    }
   }
-  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);
+  if (focus) out.sort((a, b) => (a.sceneId === focus.sceneId ? 0 : 1) - (b.sceneId === focus.sceneId ? 0 : 1));
   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 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 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 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 };
 }
-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;
+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;
   }
-  return out;
+  const entries = buildIndex(loaded);
+  indexCache = { loaded, scenes: [...loaded.scenes], locales: [...loaded.locales], entries };
+  return entries;
 }
-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);
-      }
+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 orderChildren(merged, B, O, T, path, conflicts, warnings);
+  return out;
 }
-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;
+
+// src/replace.ts
+import { canonicalStringify as canonicalStringify6 } 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);
+      });
+    }
   }
-  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);
+  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: canonicalStringify6(next) });
+      plan.shards.push(next);
+      plan.scenes++;
     }
-    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));
+  return plan;
 }
-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);
+
+// 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");
+var ENTRY_OPTS = { date: FIXED_DATE, createFolders: false };
+async function runPack(startPath) {
+  const projectFile = findProjectFile(startPath);
+  const root = dirname4(projectFile);
+  const project = parseSource4(readFileSync4(projectFile, "utf8"));
+  const unresolved = sidecarIssues(walkFiles(root, CONFLICT_SIDECAR));
+  if (unresolved.length) {
+    throw new Error(
+      `${unresolved.length} unresolved merge conflict(s) - resolve them before packing, or the recipient gets your side of a disagreement with no sign of it:
+` + unresolved.map((i) => `  ${i.file}`).join("\n")
+    );
+  }
+  const files = SHARD_EXTENSIONS.flatMap((ext) => walkFiles(root, ext)).map((abs) => ({ abs, rel: 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)
   };
-  walk(root);
-  for (const id of dup) conflicts.push({ id, path: "scene", base: void 0, ours: void 0, theirs: void 0, kind: "structural" });
+  const zip = new JSZip();
+  zip.file("patter.manifest.json", JSON.stringify(manifest, null, 2) + "\n", ENTRY_OPTS);
+  for (const f of files) zip.file(f.rel, readFileSync4(f.abs, "utf8"), ENTRY_OPTS);
+  return zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE", streamFiles: false });
 }
-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
+import JSZip2 from "jszip";
+import { join as join5, normalize, isAbsolute as isAbsolute2, resolve as resolve4, sep as sep3 } from "path";
+import { existsSync as existsSync3, readFileSync as readFileSync5 } from "fs";
+import { parseSource as parseSource5, canonicalStringify as canonicalStringify7 } from "@patterkit/core";
 var MANIFEST = "patter.manifest.json";
 var UnsafeEntryError = class extends Error {
 };
@@ -3346,10 +3410,17 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
       shards.push({ path: rel, added: true });
       continue;
     }
-    const oursObj = parseSource5(readFileSync5(outPath, "utf8"));
-    const theirsObj = parseSource5(theirText);
+    const readSide = (side, text) => {
+      try {
+        return parseSource5(text);
+      } catch (e) {
+        throw new Error(`${rel}: the ${side} copy is not readable Patter source - ${e instanceof Error ? e.message : String(e)}`);
+      }
+    };
+    const oursObj = readSide("ours", readFileSync5(outPath, "utf8"));
+    const theirsObj = readSide("theirs", theirText);
     const baseText = base.get(rel);
-    const baseObj = baseText !== void 0 ? parseSource5(baseText) : {};
+    const baseObj = baseText !== void 0 ? readSide("base", baseText) : {};
     const result = runMerge(baseObj, oursObj, theirsObj);
     writes.push({ path: outPath, content: canonicalStringify7(result.merged) });
     if (result.conflicts.length > 0) {
@@ -3375,6 +3446,8 @@ function containedWrite(dir, name) {
   return full;
 }
 export {
+  AUTHORING_HANDLED,
+  CONFLICT_SIDECAR,
   SHARD_EXTENSIONS,
   UnsafeEntryError,
   UnsupportedMergeError,
@@ -3429,6 +3502,7 @@ export {
   sceneIdForShard,
   scriptToDocx,
   scriptToPdf,
+  sidecarIssues,
   vcsConfigWrites,
   voiceScriptToXlsx,
   xlsxToCatalog