@patterkit/ops 0.10.4 → 0.12.0

package/dist/index.js

@@ -1245,7 +1245,7 @@ function bundleOutputPath(loaded) {
 import { canonicalStringify as canonicalStringify3 } from "@patterkit/core";
 
 // src/playable-runtime.ts
-var PLAYABLE_RUNTIME_JS = 'var Patterplay=(()=>{var q=Object.defineProperty;var Oe=Object.getOwnPropertyDescriptor;var Be=Object.getOwnPropertyNames;var Pe=Object.prototype.hasOwnProperty;var Ne=(n,e)=>{for(var t in e)q(n,t,{get:e[t],enumerable:!0})},Fe=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of Be(e))!Pe.call(n,s)&&s!==t&&q(n,s,{get:()=>e[s],enumerable:!(r=Oe(e,s))||r.enumerable});return n};var Te=n=>Fe(q({},"__esModule",{value:!0}),n);var Qe={};Ne(Qe,{Engine:()=>$,Flow:()=>D,buildTagIndex:()=>M,describeBundle:()=>ke,effectiveGameData:()=>Ie,gameDataFields:()=>Ce,gameDataValue:()=>Q});function E(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:E(n[2])};case"bin":return{kind:"binary",op:n[1],left:E(n[2]),right:E(n[3])};case"call":{let e=n.slice(2).map(E);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 F(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":{if(i.name==="advance"&&!t.functions[i.name]){let a=i.args[0];if(i.args.length!==1||a===void 0)throw new p(`advance() takes exactly 1 argument, got ${i.args.length}`);let c=_(a,e);if(c===void 0)throw new p("advance() needs a quality reference (@scope.name of a quality property)");let l=w(s(a),c,"advance");return c[Math.min(l+1,c.length-1)]}let o=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 u=s(i.left);if(typeof u!="boolean")throw new p(`\'and\' requires boolean operands, left is ${typeof u}`);if(!u)return!1;let S=s(i.right);if(typeof S!="boolean")throw new p(`\'and\' requires boolean operands, right is ${typeof S}`);return S}if(i.op==="or"){let u=s(i.left);if(typeof u!="boolean")throw new p(`\'or\' requires boolean operands, left is ${typeof u}`);if(u)return!0;let S=s(i.right);if(typeof S!="boolean")throw new p(`\'or\' requires boolean operands, right is ${typeof S}`);return S}let o=s(i.left),a=s(i.right),c=_(i.left,e),l=_(i.right,e),d=c??l;if(d!==void 0){if(c&&l&&!Ae(c,l)&&(i.op===">"||i.op===">="||i.op==="<"||i.op==="<="))throw new p(`\'${i.op}\' compares two different qualities, whose stage orders are unrelated`);switch(i.op){case">":return w(o,d,">")>w(a,d,">");case">=":return w(o,d,">=")>=w(a,d,">=");case"<":return w(o,d,"<")<w(a,d,"<");case"<=":return w(o,d,"<=")<=w(a,d,"<=");case"+":case"-":case"*":case"/":throw new p(`\'${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 se(o,a);case"!=":return!se(o,a);case">":return k(o,a,">"),o>a;case">=":return k(o,a,">="),o>=a;case"<":return k(o,a,"<"),o<a;case"<=":return k(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 k(o,a,"-"),o-a;case"*":return k(o,a,"*"),o*a;case"/":if(k(o,a,"/"),a===0)throw new p("division by zero");return o/a}}}};return s(n)}function se(n,e){if(Array.isArray(n)||Array.isArray(e)){if(!Array.isArray(n)||!Array.isArray(e)||n.length!==e.length)return!1;let t=[...n].sort(),r=[...e].sort();for(let s=0;s<t.length;s++)if(t[s]!==r[s])return!1;return!0}return n===e}function k(n,e,t){if(typeof n!="number"||typeof e!="number")throw new p(`\'${t}\' requires numeric operands, got ${typeof n} and ${typeof e}`)}function _(n,e){if(!(n.kind!=="scopedvar"||e.qualities===void 0))return e.qualities(n.scope,n.name)}function w(n,e,t){if(typeof n!="string")throw new p(`\'${t}\' on a quality compares stages, got ${typeof n}`);let r=e.indexOf(n);if(r<0)throw new p(`"${n}" is not a stage of this quality (stages: ${e.join(", ")})`);return r}var Ae=(n,e)=>n.length===e.length&&n.every((t,r)=>t===e[r]);function R(n){if(Number.isNaN(n)||!Number.isFinite(n))return 0;let e=Math.trunc(n)%4294967296;return e<0?e+4294967296:e}function H(n){let e=R(n);return{next(){e=e+1831565813>>>0;let t=Math.imul(e^e>>>15,1|e);return t=t+Math.imul(t^t>>>7,61|t)^t,((t^t>>>14)>>>0)/4294967296},state(){return e}}}var Ge={name:"check_flags",count:n=>Math.max(1,n.args.length-1)},Ve=[Ge];function ie(n,e,t){let r=t?.countingCalls??Ve;return T(n,t?.want??!0,e,r)}function T(n,e,t,r){if(n.kind==="binary"&&(n.op==="and"||n.op==="or")){let s=T(n.left,e,t,r),i=T(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 T(n.operand,!e,t,r);if(n.kind==="call"){let s=r.find(i=>i.name===n.name);if(s){let i=s.count(n),o=t(n);return e?o?i:0:o?0:1}}return t(n)===e?1:0}var b=class n{values={};decls=new Map;subscribers=new Set;auditors=new Set;norm;pathPrefix;constructor(e=[],t){this.norm=t?.normalise??(r=>r.toLowerCase()),this.pathPrefix=t?.pathPrefix??"",this.seed(e)}seed(e){for(let t of e){let r=this.norm(t.name);this.decls.set(r,t),this.values[r]=structuredClone(t.default??O(t))}}get(e){return this.values[this.norm(e)]}normalise(e){return this.norm(e)}set(e,t,r){let s=this.norm(e);if(!r?.host&&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])=>ae(t,this.get(e),void 0,e,this.pathPrefix))}declarations(){return[...this.decls.values()]}clone(){let e=new n([],{normalise:this.norm,pathPrefix:this.pathPrefix});return e.decls=new Map(this.decls),Object.assign(e.values,structuredClone(this.values)),e}reseed(e){for(let t of Object.keys(this.values))delete this.values[t];this.decls.clear(),this.seed(e)}save(){return structuredClone(this.values)}load(e){for(let[t,r]of Object.entries(e))this.values[this.norm(t)]=r}};function ae(n,e,t,r,s=""){let i=r??n.name.toLowerCase();return{name:i,path:s+i,type:n.type,value:e,default:n.default??O(n),...n.values!==void 0?{values:n.values}:{},...n.stages!==void 0?{stages:n.stages}:{},writable:t??n.writable??!0}}var Le=n=>n.toLowerCase(),U=1,A=class{scopes=new Map;parked=new Map;rev=0;get revision(){return this.rev}defineOwned(e,t,r){let s=typeof r=="string"?{pathPrefix:r}:r??{},i=new b(t,{pathPrefix:s.pathPrefix??`${e}.`,...s.normalise?{normalise:s.normalise}:{}});return this.mountOwned(e,i,s.owner!==void 0?{owner:s.owner}:void 0)}mountOwned(e,t,r){this.assertFree(e,r?.owner),this.scopes.set(e,{kind:"owned",bag:t,...r?.owner!==void 0?{owner:r.owner}:{}}),this.rev++;let s=this.parked.get(e);return s&&(t.load(s),this.parked.delete(e)),this}remove(e,t){let r=this.scopes.get(e);if(!r)throw new Error(`unknown scope \'@${e}\'`);return t?.keep&&r.kind==="owned"&&this.parked.set(e,r.bag.save()),this.scopes.delete(e),this.rev++,this}discardParked(e){if(e===void 0)this.parked.clear();else for(let t of[...this.parked.keys()])t.startsWith(e)&&this.parked.delete(t);return this}ownedBag(e){let t=this.scopes.get(e);if(!t||t.kind!=="owned")throw new Error(`\'@${e}\' is not an owned scope`);return t.bag}reseedOwned(e,t){return this.ownedBag(e).reseed(t),this}defineForeign(e,t,r=[],s=!0){let i=typeof s=="boolean"?{writable:s}:s;this.assertFree(e,i.owner);let o=i.normalise??Le,a=new Map;for(let c of r)a.set(o(c.name),c);return this.scopes.set(e,{kind:"foreign",resolver:t,decls:a,scopeWritable:i.writable??!0,norm:o,...i.owner!==void 0?{owner:i.owner}:{}}),this.rev++,this}has(e){return this.scopes.has(e)}get(e,t){let r=this.scopes.get(e);if(r)return r.kind==="owned"?r.bag.get(t):r.resolver.get(r.norm(t))}set(e,t,r,s){let i=this.scopes.get(e);if(!i)throw new Error(`unknown scope \'@${e}\'`);if(i.kind==="owned"){try{i.bag.set(t,r,s?.host?{host:!0}:void 0)}catch{throw new Error(`\'@${e}.${t}\' is read-only`)}return}let o=i.norm(t);if(!i.resolver.set)throw new Error(`\'@${e}.${t}\' is read-only`);if(!s?.host&&!this.foreignWritable(i,o))throw new Error(`\'@${e}.${t}\' is read-only`);i.resolver.set(o,r)}foreignWritable(e,t){return e.resolver.set?e.decls.get(t)?.writable??e.scopeWritable:!1}listProperties(){let e=[];for(let[t,r]of this.scopes){let s=r.owner!==void 0?{owner:r.owner}:{};if(r.kind==="owned")for(let i of r.bag.rows())e.push({scope:t,...s,...i});else for(let[i,o]of r.decls)e.push({scope:t,...s,...ae(o,r.resolver.get(i),this.foreignWritable(r,i),i,`${t}.`)})}return e}toEvalContext(e,t){let r=this.view(t?.aliases),s={};for(let[o,a]of r)s[o]=a.kind==="owned"?a.bag.values:a.resolver;let i=this.qualityLadders(r);return i.size===0?{scopes:s,host:e}:{scopes:s,host:e,qualities:(o,a)=>{let c=r.get(o);return c?i.get(o)?.get(Me(c)(a)):void 0}}}view(e){let t=new Map(this.scopes);for(let[r,s]of Object.entries(e??{})){let i=this.scopes.get(s);if(!i)throw new Error(`alias \'@${r}\' names \'${s}\', which is not registered`);t.set(r,i)}return t}qualityLadders(e){let t=new Map;for(let[r,s]of e)for(let[i,o]of oe(s)){if(o.type!=="quality"||o.stages===void 0)continue;let a=t.get(r);a||(a=new Map,t.set(r,a)),a.set(i,o.stages)}return t}toSchema(e){let t=new Map;for(let[r,s]of this.view(e?.aliases)){let i=oe(s);if(i.length===0)continue;let o=new Map;for(let[a,c]of i)o.set(a,{type:c.type,enumValues:c.values,...c.stages!==void 0?{stages:c.stages}:{}});t.set(r,o)}return{properties:t}}save(){let e={};for(let[t,r]of this.scopes)r.kind==="owned"&&(e[t]=r.bag.save());for(let[t,r]of this.parked)e[t]=structuredClone(r);return e}load(e,t){t?.keepParked||this.parked.clear();for(let[r,s]of Object.entries(e)){let i=this.scopes.get(r);i?.kind==="owned"?i.bag.load(s):i||this.parked.set(r,structuredClone(s))}}saveFragment(){return{version:U,scopes:this.save()}}loadFragment(e){if(e.version!==U)throw new Error(`unsupported owned-state fragment version ${e.version} (supported: ${U})`);this.load(e.scopes)}assertFree(e,t){let r=this.scopes.get(e);if(!r)return;let s=r.owner!==void 0?` by ${r.owner}`:"",i=t!==void 0?` (wanted by ${t})`:"";throw new Error(`scope \'@${e}\' is already registered${s}${i}`)}};function oe(n){return n.kind==="foreign"?[...n.decls.entries()]:n.bag.declarations().map(e=>[n.bag.normalise(e.name),e])}function Me(n){return n.kind==="foreign"?n.norm:e=>n.bag.normalise(e)}function O(n){if(n.default!==void 0)return n.default;switch(n.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"enum":return n.values?.[0]??"";case"flags":return[];case"quality":return n.stages?.[0]??"";default:return!1}}var ce=[{token:"patter",engine:"Patterplay",means:"Patter\'s shared globals"},{token:"story",engine:"Storylet Engine",means:"the Storylet Engine\'s shared @story properties"}];function B(n){return n.ctx.host??{}}var W={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=B(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:pe("check_flags"),eval(n,e){let t=le(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:pe("set_flags"),eval(n,e){let t=[...le(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:V("visits"),eval:(n,e)=>B(e).visits?.(G(n,e,"visits"))??0},seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:V("seen"),eval:(n,e)=>(B(e).visits?.(G(n,e,"seen"))??0)>0},patter_visits:{minArgs:1,maxArgs:1,returnType:"number",validate:V("patter_visits"),eval:(n,e)=>B(e).patterVisits?.(G(n,e,"patter_visits"))??0},patter_seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:V("patter_seen"),eval:(n,e)=>(B(e).patterVisits?.(G(n,e,"patter_seen"))??0)>0}}},ut=ce.map(n=>n.token).filter(n=>n!=="patter"&&n!=="scene");function de(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 G(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 V(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 le(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 pe(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 $e=/^@[A-Za-z0-9_.]+$/;function*je(n){let e="",t=0;for(;t<n.length;){let r=n[t];if(r==="{"&&n[t+1]==="{"){e+="{",t+=2;continue}if(r==="}"&&n[t+1]==="}"){e+="}",t+=2;continue}if(r==="{"){let s=n.indexOf("}",t+1);if(s!==-1){let i=n.slice(t,s+1),o=n.slice(t+1,s).trim();if(o.startsWith("@")){e&&(yield{kind:"text",value:e},e=""),yield{kind:"slot",raw:i,inner:o,ref:$e.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 qe(n){return Array.isArray(n)?n.join(", "):typeof n=="boolean"?n?"true":"false":String(n)}function _e(n){return n===" "||n==="	"||n===`\n`||n==="\\r"||n==="\\f"||n==="\\v"}function He(n){let e="",t=!1;for(let r of n){if(_e(r)){t=!0;continue}t&&e.length>0&&(e+=" "),t=!1,e+=r}return e}function ge(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?He(r):n}function ue(n,e){if(n.indexOf("{")<0)return n;let t="";for(let r of je(n)){if(r.kind==="text"){t+=r.value;continue}if(!r.ref){t+=r.raw;continue}let s=e(r.ref);t+=s===void 0?"":qe(s)}return t}function C(n,e){for(let t of n){e(t);let r=t.children;r&&C(r,e)}}function Ue(n){return n.toLowerCase().replace(/[\'\u2019]/g,"").replace(/[^a-z0-9-]+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function m(n){let e=n.gameId?.trim();return e||Ue(n.name)}function K(n){return`cast:${n}`}var J={open:"[",close:"]"},he="SFX";var z=3;function L(n){let e=new Set,t=[];for(let r of n)e.has(r)||(e.add(r),t.push(r));return t}function M(n){let e=new Map,t=(r,s)=>{let i=L([...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,L([...i,...o.tags??[]]))};for(let r of Object.values(n.scenes)){let s=L(r.tags??[]);e.set(r.id,s);for(let i of r.blocks){let o=L([...s,...i.tags??[]]);e.set(i.id,o);for(let a of i.children)t(a,o)}}return e}var fe=new WeakMap,I="Patter",P=n=>n.replace(/%/g,"%25").replace(/\\//g,"%2F"),me=Symbol("ownsRegistry"),v={stage:n=>`patter/scene/${P(n)}`,flow:n=>`patter/flow/${P(n)}/`,flowGlobals:n=>`patter/flow/${P(n)}/patter`,flowScene:(n,e)=>`patter/flow/${P(n)}/scene/${P(e)}`},$=class n{host;defaultSeed;flowsById=new Map;allStrings;currentLocale;sourceDebug;sceneGameIdToId=new Map;blockGameIdToId=new Map;creationOptions;engineLog=[];engineTraceHandlers=new Set;constructor(e,t={}){this.creationOptions=t;let r=t.locale??e.locales.default,s=e.strings;this.allStrings=s,this.currentLocale=r;let i=s[r]??{},o=s[e.locales.default]??{},a=e.localisation,c=a?.mode==="ids"&&!a.sourceDebug;this.sourceDebug=a?.mode==="ids"&&!!a.sourceDebug,this.sourceDebug&&typeof console<"u"&&console.warn("[Patterplay] source-only DEBUG build: strings are the source language for debugging, not a shippable localised build.");let l=new Map;for(let g of e.cast??[])g.displayName&&l.set(g.name,g.displayName);this.defaultSeed=(t.seed??2654435769)>>>0;let d=new Map,u=new Map,S=new Map;for(let[g,h]of Object.entries(e.scenes)){this.sceneGameIdToId.set(m(h),g);let y=new Map;for(let f of h.blocks)u.set(f.id,{sceneId:g}),S.set(f.id,f),y.set(m(f),f.id),C(f.children,ne=>d.set(ne.id,ne));this.blockGameIdToId.set(g,y)}let X=e.properties??[],j=X.filter(g=>g.shared??!0).map(ye),De=X.filter(g=>!(g.shared??!0)).map(ye),Re=new Set(j.map(g=>g.name.toLowerCase())),x=t.registry??new A,Z=!t.registry||t[me]===!0,ee=new b(j,{pathPrefix:"@patter."}),te=[],N=[];try{x.mountOwned("patter",ee,{owner:I}),N.push("patter");let g=new Set;if(t.world){let h=e.scopeRegistry?.scopes.find(f=>f.token==="world"),y=(h?.declarations??[]).map(xe);x.defineForeign("world",t.world,y,{writable:h?.writable??!0,owner:I}),N.push("world"),g.add("world")}for(let h of Z?e.scopeRegistry?.scopes??[]:[]){if(g.has(h.token)||x.has(h.token))continue;let y=(h.declarations??[]).map(f=>We(f,h.writable));x.defineOwned(h.token,y,{owner:I}),N.push(h.token),te.push(h.token)}}catch(g){for(let h of N)x.remove(h,{keep:!0});throw g}let re=new Map;for(let[g,h]of Object.entries(e.scenes)){let y=new Set((h.sceneProps??[]).filter(f=>f.shared??!1).map(f=>f.name.toLowerCase()));re.set(g,y)}this.host={logEnabled:t.log??!1,emitEngine:(g,h,y)=>this.emitEngine(g,h,y),bundle:e,emitIds:c,strings:i,defaultStrings:o,castDisplay:l,nodeIndex:d,blockIndex:u,blockById:S,sceneGameIdToId:this.sceneGameIdToId,blockGameIdToId:this.blockGameIdToId,tagIndex:M(e),registry:x,ownsRegistry:Z,patterBag:ee,hostScopes:te,patterSharedDecls:j,patterLocalDecls:De,patterSharedNames:Re,sceneSharedNames:re,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||he,refSplitCache:new Map,refSplitRevision:x.revision}}get locale(){return this.currentLocale}get isSourceDebug(){return this.sourceDebug}setLocale(e){this.currentLocale=e,this.host.strings=this.allStrings[e]??{}}replaceStrings(e){this.allStrings=e.strings,this.host.strings=this.allStrings[this.currentLocale]??{},this.host.defaultStrings=this.allStrings[this.host.bundle.locales.default]??{}}hotSwap(e){let t=this.saveGame(),r=o=>(o.setLocale(this.currentLocale),o.setClosedCaptions(this.host.captionsOn),o),s=()=>new n(e,{...this.creationOptions,registry:this.host.registry,[me]:this.host.ownsRegistry});this.release(!0);let i=s();try{return i.loadGame(t),r(i)}catch{i.release(!0);let o=s();for(let[a,c]of Object.entries(t.flows)){let l=c.cursor.currentSceneId;try{o.openFlow(a,l!==null?{scene:l}:{})}catch{}}return r(o)}}get closedCaptions(){return this.host.captionsOn}setClosedCaptions(e){this.host.captionsOn=e}openFlow(e,t={}){this.assertExternalScopes();let r=this.resolveSceneRef(t.scene),s=this.resolveBlockRef(r,t.block);this.flowsById.get(e)?.close();let i=new D(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}assertExternalScopes(){for(let e of this.host.bundle.externalScopes??[])if(!this.host.registry.has(e))throw new Error(`this content names @${e}, which no engine on this registry registered: give every engine the game\'s one registry`)}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?m(t):void 0}blockAddress(e){let t=this.host.blockById.get(e);return t?m(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,...m(e)?{gameId:m(e)}:{},name:e.name,...this.tagsField(e.id),blocks:e.blocks.map(t=>({id:t.id,...m(t)?{gameId:m(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)C(r.children,s=>{if(s.type==="snippet")for(let i of s.beats??[])e.push({sceneId:t.id,blockId:r.id,snippetId:s.id,beat:this.beatInfo(i)})});return e}outlineNode(e){return e.type==="group"?{type:"group",id:e.id,...this.tagsField(e.id),...e.selector?{selector:e.selector}:{},...e.prompt?{prompt:this.beatInfo(e.prompt)}:{},children:e.children.map(t=>this.outlineNode(t))}:{type:"snippet",id:e.id,...this.tagsField(e.id),beats:(e.beats??[]).map(t=>this.beatInfo(t)),...e.jump?{jumpTo:e.jump.to,...e.jump.mode?{jumpMode:e.jump.mode}:{}}:{}}}beatInfo(e){let t=this.host.tagIndex.get(e.id),r={id:e.id,kind:e.kind};if(e.kind==="line"){if(e.character!==void 0){r.character=e.character;let s=this.host.defaultStrings[K(e.character)]??this.host.castDisplay.get(e.character);s!==void 0&&(r.characterName=s)}e.direction!==void 0&&(r.direction=e.direction)}if(e.kind==="line"||e.kind==="text"){let s=this.host.defaultStrings[e.id];s!==void 0&&(r.text=s)}return e.gameData&&Object.keys(e.gameData).length&&(r.gameData=e.gameData),t&&t.length&&(r.tags=t),r}tagsField(e){let t=this.host.tagIndex.get(e);return t&&t.length?{tags:t}:{}}getFlow(e){return this.flowsById.get(e)}flows(){return[...this.flowsById.values()]}listBags(){let e=[{bag:this.host.patterBag}];for(let[t,r]of this.host.stageBags)e.push({bag:r,pathPrefix:`@scene:${t}.`});return e}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.patterBag.reseed(this.host.patterSharedDecls),this.host.sharedVisits.clear(),this.host.sharedSelectors.clear();for(let e of this.host.stageBags.keys())this.host.registry.remove(v.stage(e));this.host.stageBags.clear(),this.host.registry.discardParked("patter/")}release(e){for(let r of this.flowsById.values())r.releaseBags(e),r.close();this.flowsById.clear();let t=this.host.registry;for(let r of this.host.stageBags.keys())t.remove(v.stage(r),{keep:e});this.host.stageBags.clear();for(let r of["patter",...this.host.hostScopes])t.has(r)&&t.remove(r,{keep:e});this.creationOptions.world&&t.has("world")&&t.remove("world")}getProperty(e){let{scope:t,name:r}=this.splitShared(e);return this.host.registry.get(t,r)}setProperty(e,t){let{scope:r,name:s}=this.splitShared(e);this.host.registry.set(r,s,t,{host:!0})}log(){return this.engineLog}clearLog(){this.engineLog.length=0}onTrace(e){return this.engineTraceHandlers.add(e),()=>this.engineTraceHandlers.delete(e)}emitEngine(e,t,r){for(let s of this.engineTraceHandlers)s(e,t);this.host.logEnabled&&this.engineLog.push({...t,flow:e,seq:this.engineLog.length,...r?{scene:r}:{}})}listProperties(){return this.host.patterSharedDecls.map(e=>({name:e.name,path:`@patter.${e.name}`,type:e.type,values:e.values,stages:e.stages,value:this.getProperty(`@${e.name}`),default:O(e),writable:e.writable??!0}))}splitShared(e){let t=Ee(this.host,e);if(t.scope==="scene")throw new Error(`\'${e}\': @scene properties are scene-scoped - read/write them on a Flow, not the Engine`);return t}save(){return{patter:this.host.patterBag.save()}}load(e){e.patter&&this.host.patterBag.load(e.patter)}saveGame(){let e={};for(let[t,r]of this.flowsById)e[t]=r.snapshot();return{version:z,...this.host.ownsRegistry?{registry:this.host.registry.save()}:{},sharedVisits:Object.fromEntries(this.host.sharedVisits),sharedSelectors:we(this.host.sharedSelectors),flows:e}}loadGame(e){let t=e.version;if(t!==2&&t!==z)throw new Error(`unsupported save version: ${String(t)}`);this.assertExternalScopes();let r=this.host.registry;for(let[i,o]of this.flowsById)o.releaseBags(i in e.flows),o.close();this.flowsById.clear();for(let i of this.host.stageBags.keys())r.remove(v.stage(i),{keep:!0});this.host.stageBags.clear();let s=e.version===2?Ke(e):e.registry;s&&(this.host.ownsRegistry?r.load(s):r.load(s,{keepParked:!0})),this.host.sharedVisits.clear();for(let[i,o]of Object.entries(e.sharedVisits??{}))this.host.sharedVisits.set(i,o);this.host.sharedSelectors.clear();for(let[i,o]of be(e.sharedSelectors))this.host.sharedSelectors.set(i,o);for(let[i,o]of Object.entries(e.flows)){let a=new D(i,this.host,this.defaultSeed);a.restore(o),this.flowsById.set(i,a)}}},D=class{id;host;local;registered=new Set;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.patterBag.get(e):this.local.get(e),set:(e,t)=>{this.host.patterSharedNames.has(e)?this.host.registry.set("patter",e,t):this.local.set(e,t)}};sceneResolver={get:e=>{let t=this.currentSceneId;if(t!==null)return this.sceneBagFor(t,e)?.get(e)},set:(e,t)=>{let r=this.currentSceneId;if(r===null)return;let s=this.sceneBagFor(r,e);s&&s.set(e,t)}};evalCtx;ctxRevision=-1;registryQualities;flowLog=[];flowSeq=0;constructor(e,t,r){this.id=e,this.host=t,this.rngState=R(r),this.local=this.newLocal(),this.evalCtx={scopes:{},host:{nextRandom:this.rng,visits:s=>this.visitCounts.get(s)??0,patterVisits:s=>this.host.sharedVisits.get(s)??0},qualities:(s,i)=>this.stagesFor(s,i)}}context(){let e=this.host.registry;if(e.revision!==this.ctxRevision){let t=e.toEvalContext(),r=this.evalCtx.scopes;for(let s of Object.keys(r))delete r[s];Object.assign(r,t.scopes),r.patter=this.patterResolver,r.scene=this.sceneResolver,this.registryQualities=t.qualities,this.ctxRevision=e.revision}return this.evalCtx}stagesFor(e,t){let r=t.toLowerCase(),s=i=>i?.find(o=>o.name.toLowerCase()===r&&o.type==="quality")?.stages;if(e==="patter")return s(this.host.patterSharedDecls)??s(this.host.patterLocalDecls);if(e==="scene"){let i=this.currentSceneId!=null?this.host.bundle.scenes[this.currentSceneId]:void 0;return s(i?.sceneProps)}return this.registryQualities?.(e,t)??s(this.host.bundle.scopeRegistry?.scopes.find(i=>i.token===e)?.declarations)}start(e,t){if(this.releaseBags(!1),this.host.registry.discardParked(v.flow(this.id)),this.mountLocal(),this.selectors.clear(),this.visitCounts.clear(),this.stack=[],this.currentSceneId=null,this.flowEnded=!1,this.activeSnippet=null,this.beatIndex=0,this.pendingChoice=null,this.started=!0,t){let r=this.host.blockIndex.get(t);if(!r)throw new Error(`unknown block: ${t}`);this.enterSceneSetup(r.sceneId),this.stack=[{sceneId:r.sceneId,containerId:t,index:0}],this.enter(t)}else{let r=e??Object.keys(this.host.bundle.scenes)[0],s=r?this.host.bundle.scenes[r]:void 0;if(!s)throw new Error(r?`unknown scene: ${r}`:"no scenes in bundle");this.enterSceneSetup(r);let i=s.blocks[0];i&&(this.stack=[{sceneId:r,containerId:i.id,index:0}],this.enter(i.id))}this.settle()}reset(e,t){this.start(e,t)}goto(e,t){if(this.closed)return!1;if(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.releaseBags(!1),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 i=this.activeSnippet.jump;this.activeSnippet=null,this.beatIndex=0,this.resolveJump(i);continue}let t=this.stack[this.stack.length-1];if(!t){this.flowEnded=!0;return}t.sceneId!==this.currentSceneId&&(this.currentSceneId=t.sceneId);let r=this.childrenOf(t.containerId);if(!r){this.stack.pop();continue}let s=t.index;for(;t.index<r.length&&!this.eligible(r[t.index]);)t.index++;if(this.host.logEnabled&&t.index!==s&&this.emit({type:"select",group:t.containerId,selector:"run",children:r.slice(s,t.index+1).map((i,o)=>({id:i.id,eligible:s+o===t.index})),picked:r[t.index]?.id??null}),t.index>=r.length){this.stack.pop();continue}this.enterChild(r[t.index++])}}listBags(){let e=[{bag:this.local,pathPrefix:`${this.id}/@patter.`}];for(let[t,r]of this.sceneBags)e.push({bag:r,pathPrefix:`${this.id}/@scene:${t}.`});return e}log(){return this.flowLog}clearLog(){this.flowLog.length=0}emit(e){let t=this.currentSceneId??void 0;this.host.emitEngine(this.id,e,t),this.host.logEnabled&&this.flowLog.push({...e,seq:this.flowSeq++,...t?{scene:t}:{}})}getChoices(){return this.pendingChoice?.options??[]}choose(e){let t=this.pendingChoice;if(!t)throw new Error("no choice is pending");let r=t.options.find(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.emit({type:"chose",group:t.groupId,option: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.registry.get(t,r)}setProperty(e,t){this.writeProperty(e,t,!0)}writeProperty(e,t,r){let{scope:s,name:i}=this.splitRef(e);if(s==="patter")this.patterResolver.set(i,t);else if(s==="scene"){if(this.currentSceneId===null)throw new Error(`\'${e}\': the flow has not entered a scene yet`);this.sceneResolver.set(i,t)}else this.host.registry.set(s,i,t,r?{host:!0}:void 0)}snapshot(){return{rngState:this.rngState,visits:Object.fromEntries(this.visitCounts),cursor:{flowEnded:this.flowEnded,currentSceneId:this.currentSceneId,stack:this.stack.map(e=>{let t=this.childrenOf(e.containerId)?.[e.index];return t?{...e,nextId:t.id}:{...e}}),activeSnippetId:this.activeSnippet?.id??null,beatIndex:this.beatIndex,pendingChoice:this.pendingChoice?{groupId:this.pendingChoice.groupId,options:this.pendingChoice.options.map(e=>({...e}))}:null,pendingPromptOwnerId:this.pendingPromptOwnerId,selectors:we(this.selectors)}}}restore(e){this.rngState=R(e.rngState),this.visitCounts=new Map(Object.entries(e.visits??{}));let t=e.cursor;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.releaseBags(!1),this.mountLocal();for(let r of new Set([t.currentSceneId,...this.stack.map(s=>s.sceneId)]))r!==null&&this.host.bundle.scenes[r]&&this.ensureSceneBags(r);if(this.activeSnippet=null,t.activeSnippetId!==null){let r=this.host.nodeIndex.get(t.activeSnippetId);r&&r.type==="snippet"&&(this.activeSnippet=r)}if(this.selectors=be(t.selectors),this.pendingChoice=null,t.pendingChoice!==null){let r=new Map,s=[];for(let i of t.pendingChoice.options){let o=this.host.nodeIndex.get(i.id);o&&(r.set(i.id,o),s.push({...i}))}s.length>0&&(this.pendingChoice={groupId:t.pendingChoice.groupId,options:s,byId:r})}if(this.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.emit({type:"choice",group:e.id,options:t.map(o=>({id:o.id,eligible:o.eligible}))}),this.pendingChoice={groupId:e.id,options:t,byId:r};return}let i=s.find(o=>this.eligible(o));if(i){this.enterChild(i);return}this.emit({type:"dry",group:e.id}),this.host.onDryChoice?.(e.id)}resolveJump(e){e&&this.enterTarget(e.to,e.mode==="call"?"call":"jump")}enterTarget(e,t){if(this.emit({type:"jump",to:e,mode:t}),e==="END"){this.flowEnded=!0,this.stack=[];return}let r,s,i=this.host.bundle.scenes[e];if(i){this.enterSceneSetup(e);let a=i.blocks[0];if(!a){t==="jump"&&(this.stack=[]);return}r=e,s=a.id}else{let a=this.host.blockIndex.get(e);if(!a)throw new Error(`jump target not found: ${e}`);a.sceneId!==this.currentSceneId&&this.enterSceneSetup(a.sceneId),r=a.sceneId,s=e}this.enter(s);let o={sceneId:r,containerId:s,index:0};t==="call"?this.stack.push(o):this.stack=[o]}selectChild(e){let t=e.children.map(c=>({id:c.id,eligible:this.eligible(c)})),r=e.children.filter(c=>this.eligible(c)),s=e.options?.order??"sequential",i=e.options?.exhaust??"once",o=c=>(this.emit({type:"select",group:e.id,selector:e.selector??"default",...e.selector==="sequence"?{order:s,exhaust:i}:{},children:t,picked:c?.id??null}),c);if(r.length===0)return o(null);let a=this.selectorState(e);switch(e.selector){case"branch":return o(r[0]);case"sequence":return o(s==="shuffle"?this.pickShuffle(r,i,a):s==="specificity"?this.pickSpecificity(r,i,a):this.pickSequential(r,i,a));default:return null}}pickSequential(e,t,r){let s=e.length,i=r.seq??0;return r.seq=i+1,t==="repeat"?e[i%s]:i<s?e[i]:t==="stick"?e[s-1]:null}pickShuffle(e,t,r){let s=e.length,i=t==="stick",o=()=>(i?e.slice(0,s-1):e).map(u=>u.id);if(r.bag===void 0&&(r.bag=o()),r.bag.length===0){if(t==="once")return null;if(i){let u=e[s-1];return r.last=u.id,u}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 d=a[l];return a.splice(l,1),r.last=d,e.find(u=>u.id===d)}pickSpecificity(e,t,r){let s=e;if(t!=="repeat"){r.bag===void 0&&(r.bag=e.map(d=>d.id));let l=new Set(r.bag);if(s=e.filter(d=>l.has(d.id)),s.length===0)return t==="stick"&&r.last!==void 0?e.find(d=>d.id===r.last)??null:null}let i=-1,a=s.map(l=>{let d=this.specScore(l);return d>i&&(i=d),{c:l,s:d}}).filter(l=>l.s===i).map(l=>l.c),c;if(a.length===1)c=a[0];else{let l=r.last!==void 0?a.findIndex(u=>u.id===r.last):-1,d=Math.floor(this.rng()*(l>=0?a.length-1:a.length));l>=0&&d>=l&&d++,c=a[d]}return t!=="repeat"&&(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 ie(e,s=>ve(F(s,this.context(),W)),{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??[]){let r=this.evalExpr(t.value),s=this.host.logEnabled?this.getProperty(t.target):void 0;this.writeProperty(t.target,r,!1),this.emit({type:"write",target:t.target,value:r,...s!==void 0?{prev:s}:{}})}}eligible(e){return e.condition?ve(this.evalExpr(e.condition)):!0}evalExpr(e){return F(this.conditionAst(e),this.context(),W)}conditionAst(e){let t=fe.get(e);return t||(t=E(e.ast),fe.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=H(this.rngState),t=e.next();return this.rngState=e.state(),t};beatResult(e){let t=this.host.tagIndex.get(e.id),r=t&&t.length?{tags:t}:{};switch(e.kind){case"gameEvent":return{type:"gameEvent",id:e.id,gameData:e.gameData,...r};case"text":return{type:"text",id:e.id,text:this.interpolate(this.resolveString(e.id)),gameData:e.gameData,...r};case"line":{let s=this.resolveString(e.id),i=!this.host.captionsOn,a=i&&e.character===this.host.captionCharacter?"":this.captionLine(this.host.bundle.voiced?s:this.interpolate(s)),c=i&&a.length===0;return{type:"line",id:e.id,text:a,character:c?void 0:e.character,characterName:c?void 0:this.resolveCharacterName(e.character),direction:c?void 0:e.direction,gameData:e.gameData,...r}}}}interpolate(e){return ue(e,t=>this.getProperty(t))}stripCaptions(e){return ge(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 C(e,r=>{!t&&r.type==="snippet"&&(r.beats??[]).some(s=>s.kind==="line"||s.kind==="text")&&(t=r)}),t}resolveString(e){if(this.host.emitIds)return e;let t=this.host.strings[e];if(t!==void 0)return t;let r=this.host.defaultStrings[e];return r!==void 0?`<Untranslated: ${e}> ${r}`:e}resolveCharacterName(e){if(e===void 0||this.host.emitIds)return;let t=K(e);return this.host.strings[t]??this.host.defaultStrings[t]??this.host.castDisplay.get(e)}splitRef(e){return Ee(this.host,e)}newLocal(){return new b(this.host.patterLocalDecls,{pathPrefix:"@patter."})}mountLocal(){this.local=this.newLocal();let e=v.flowGlobals(this.id);this.host.registry.mountOwned(e,this.local,{owner:I}),this.registered.add(e)}releaseBags(e){for(let t of this.registered)this.host.registry.remove(t,{keep:e});this.registered.clear(),this.sceneBags.clear()}sceneBagFor(e,t){if(this.host.bundle.scenes[e])return this.ensureSceneBags(e),this.host.sceneSharedNames.get(e)?.has(t.toLowerCase())?this.host.stageBags.get(e):this.sceneBags.get(e)}ensureSceneBags(e){let t=this.host.sceneSharedNames.get(e)??new Set,r=this.host.bundle.scenes[e]?.sceneProps??[];if(!this.sceneBags.has(e)){let s=new b(r.filter(o=>!t.has(o.name.toLowerCase())),{pathPrefix:"@scene."}),i=v.flowScene(this.id,e);this.host.registry.mountOwned(i,s,{owner:I}),this.registered.add(i),this.sceneBags.set(e,s)}if(!this.host.stageBags.has(e)){let s=new b(r.filter(i=>t.has(i.name.toLowerCase())),{pathPrefix:"@scene."});this.host.registry.mountOwned(v.stage(e),s,{owner:I}),this.host.stageBags.set(e,s)}}seedScene(e){let t=this.host.sceneSharedNames.get(e.id)??new Set;this.ensureSceneBags(e.id);for(let r of e.sceneProps??[]){if(!r.temporary)continue;let s=r.name.toLowerCase(),i=t.has(s)?this.host.stageBags.get(e.id):this.sceneBags.get(e.id);i&&i.set(s,O(r))}}};function Se(n,e){C(n,t=>{if(t.type==="group"){t.prompt?.kind==="line"&&t.prompt.character&&e.add(t.prompt.character);return}for(let r of t.beats??[])r.kind==="line"&&r.character&&e.add(r.character)})}function we(n){let e={};for(let[t,r]of n){let s={};r.seq!==void 0&&(s.seq=r.seq),r.bag&&(s.bag=[...r.bag]),r.last!==void 0&&(s.last=r.last),e[t]=s}return e}function be(n){let e=new Map;for(let[t,r]of Object.entries(n??{})){let s={};r.seq!==void 0&&(s.seq=r.seq),r.bag&&(s.bag=[...r.bag]),r.last!==void 0&&(s.last=r.last),e.set(t,s)}return e}function ye(n){return{name:n.name,type:n.type,values:n.values,stages:n.stages,default:n.default}}function xe(n){return{name:n.name,type:n.type,values:n.values,stages:n.stages,default:n.default,writable:n.writable}}function We(n,e){let t=xe(n),r=n.writable??e;return r===void 0?t:{...t,writable:r}}function Ee(n,e){n.refSplitRevision!==n.registry.revision&&(n.refSplitCache.clear(),n.refSplitRevision=n.registry.revision);let t=n.refSplitCache.get(e);return t||(t=de(e,r=>r==="scene"||n.registry.has(r)||(n.bundle.externalScopes?.includes(r)??!1)),n.refSplitCache.set(e,t)),t}function Ke(n){let e={};n.shared?.patter&&(e.patter=n.shared.patter);for(let[t,r]of Object.entries(n.stageBags??{}))e[v.stage(t)]=r;for(let[t,r]of Object.entries(n.flows??{})){r.scopes?.patter&&(e[v.flowGlobals(t)]=r.scopes.patter);for(let[s,i]of Object.entries(r.sceneBags??{}))e[v.flowScene(t,s)]=i}return e}function ve(n){return typeof n=="boolean"?n:typeof n=="number"?n!==0:typeof n=="string"?n!=="":n.length>0}var Je=(n,e)=>n.shared??e;function Y(n,e){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.default!==void 0?{default:n.default}:{},shared:Je(n,e)}}function ze(n){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.values?{values:[...n.values]}:{},...n.purpose?{purpose:n.purpose}:{}}}function Ye(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 ke(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=m(o);t.push({gameId:a,name:o.name,blocks:o.blocks.map(c=>({gameId:m(c),name:c.name}))});for(let c of o.blocks)Ye(c,e);o.sceneProps?.length&&r.push({gameId:a,properties:o.sceneProps.map(c=>Y(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=>Y(a,!0))})),i=Object.entries(n.gameDataFields??{}).filter(([,o])=>(o?.length??0)>0).map(([o,a])=>({kind:o,fields:(a??[]).map(ze)}));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=>Y(o,!0)),scene:r},gameData:i,counts:e}}function Ce(n,e){return n.gameDataFields?.[e]??[]}function Q(n,e,t){return e&&Object.prototype.hasOwnProperty.call(e,t)?e[t]:n.find(r=>r.name===t)?.default}function Ie(n,e){let t={};for(let r of n){let s=Q(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 Te(Qe);})();\n';
+var PLAYABLE_RUNTIME_JS = 'var Patterplay=(()=>{var H=Object.defineProperty;var Be=Object.getOwnPropertyDescriptor;var Pe=Object.getOwnPropertyNames;var Ne=Object.prototype.hasOwnProperty;var Fe=(n,e)=>{for(var t in e)H(n,t,{get:e[t],enumerable:!0})},Ae=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of Pe(e))!Ne.call(n,s)&&s!==t&&H(n,s,{get:()=>e[s],enumerable:!(r=Be(e,s))||r.enumerable});return n};var Ge=n=>Ae(H({},"__esModule",{value:!0}),n);var Xe={};Fe(Xe,{Engine:()=>$,Flow:()=>D,buildTagIndex:()=>M,describeBundle:()=>Ce,effectiveGameData:()=>De,gameDataFields:()=>Ie,gameDataValue:()=>Q});function k(n){switch(n[0]){case"b":return{kind:"bool",value:n[1]};case"n":return{kind:"number",value:n[1]};case"s":return{kind:"string",value:n[1]};case"sv":return{kind:"scopedvar",scope:n[1],name:n[2]};case"u":return{kind:"unary",op:n[1],operand:k(n[2])};case"bin":return{kind:"binary",op:n[1],left:k(n[2]),right:k(n[3])};case"call":{let e=n.slice(2).map(k);return{kind:"call",name:n[1],args:e}}case"fd":return{kind:"flagdelta",sign:n[1],name:n[2]}}}var p=class extends Error{constructor(e){super(e),this.name="EvalError"}};function F(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":{if(i.name==="advance"&&!t.functions[i.name]){let a=i.args[0];if(i.args.length!==1||a===void 0)throw new p(`advance() takes exactly 1 argument, got ${i.args.length}`);let c=_(a,e);if(c===void 0)throw new p("advance() needs a quality reference (@scope.name of a quality property)");let l=b(s(a),c,"advance");return c[Math.min(l+1,c.length-1)]}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 u=s(i.left);if(typeof u!="boolean")throw new p(`\'and\' requires boolean operands, left is ${typeof u}`);if(!u)return!1;let S=s(i.right);if(typeof S!="boolean")throw new p(`\'and\' requires boolean operands, right is ${typeof S}`);return S}if(i.op==="or"){let u=s(i.left);if(typeof u!="boolean")throw new p(`\'or\' requires boolean operands, left is ${typeof u}`);if(u)return!0;let S=s(i.right);if(typeof S!="boolean")throw new p(`\'or\' requires boolean operands, right is ${typeof S}`);return S}let o=s(i.left),a=s(i.right),c=_(i.left,e),l=_(i.right,e),d=c??l;if(d!==void 0){if(c&&l&&!Te(c,l)&&(i.op===">"||i.op===">="||i.op==="<"||i.op==="<="))throw new p(`\'${i.op}\' compares two different qualities, whose stage orders are unrelated`);switch(i.op){case">":return b(o,d,">")>b(a,d,">");case">=":return b(o,d,">=")>=b(a,d,">=");case"<":return b(o,d,"<")<b(a,d,"<");case"<=":return b(o,d,"<=")<=b(a,d,"<=");case"+":case"-":case"*":case"/":throw new p(`\'${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 se(o,a);case"!=":return!se(o,a);case">":return E(o,a,">"),o>a;case">=":return E(o,a,">="),o>=a;case"<":return E(o,a,"<"),o<a;case"<=":return E(o,a,"<="),o<=a;case"+":if(typeof o=="number"&&typeof a=="number"||typeof o=="string"&&typeof a=="string")return o+a;throw new p(`\'+\' requires two numbers or two strings, got ${typeof o} and ${typeof a}`);case"-":return E(o,a,"-"),o-a;case"*":return E(o,a,"*"),o*a;case"/":if(E(o,a,"/"),a===0)throw new p("division by zero");return o/a}}}};return s(n)}function se(n,e){if(Array.isArray(n)||Array.isArray(e)){if(!Array.isArray(n)||!Array.isArray(e)||n.length!==e.length)return!1;let t=[...n].sort(),r=[...e].sort();for(let s=0;s<t.length;s++)if(t[s]!==r[s])return!1;return!0}return n===e}function E(n,e,t){if(typeof n!="number"||typeof e!="number")throw new p(`\'${t}\' requires numeric operands, got ${typeof n} and ${typeof e}`)}function _(n,e){if(!(n.kind!=="scopedvar"||e.qualities===void 0))return e.qualities(n.scope,n.name)}function b(n,e,t){if(typeof n!="string")throw new p(`\'${t}\' on a quality compares stages, got ${typeof n}`);let r=e.indexOf(n);if(r<0)throw new p(`"${n}" is not a stage of this quality (stages: ${e.join(", ")})`);return r}var Te=(n,e)=>n.length===e.length&&n.every((t,r)=>t===e[r]);function R(n){if(Number.isNaN(n)||!Number.isFinite(n))return 0;let e=Math.trunc(n)%4294967296;return e<0?e+4294967296:e}function q(n){let e=R(n);return{next(){e=e+1831565813>>>0;let t=Math.imul(e^e>>>15,1|e);return t=t+Math.imul(t^t>>>7,61|t)^t,((t^t>>>14)>>>0)/4294967296},state(){return e}}}var Ve={name:"check_flags",count:n=>Math.max(1,n.args.length-1)},Le=[Ve];function ie(n,e,t){let r=t?.countingCalls??Le;return A(n,t?.want??!0,e,r)}function A(n,e,t,r){if(n.kind==="binary"&&(n.op==="and"||n.op==="or")){let s=A(n.left,e,t,r),i=A(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 A(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 w=class n{values={};decls=new Map;subscribers=new Set;auditors=new Set;norm;pathPrefix;constructor(e=[],t){this.norm=t?.normalise??(r=>r.toLowerCase()),this.pathPrefix=t?.pathPrefix??"",this.seed(e)}seed(e){for(let t of e){let r=this.norm(t.name);this.decls.set(r,t),this.values[r]=structuredClone(t.default??O(t))}}get(e){return this.values[this.norm(e)]}normalise(e){return this.norm(e)}set(e,t,r){let s=this.norm(e);if(!r?.host&&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])=>ae(t,this.get(e),void 0,e,this.pathPrefix))}declarations(){return[...this.decls.values()]}clone(){let e=new n([],{normalise:this.norm,pathPrefix:this.pathPrefix});return e.decls=new Map(this.decls),Object.assign(e.values,structuredClone(this.values)),e}reseed(e){for(let t of Object.keys(this.values))delete this.values[t];this.decls.clear(),this.seed(e)}save(){return structuredClone(this.values)}load(e){for(let[t,r]of Object.entries(e))this.values[this.norm(t)]=r}};function ae(n,e,t,r,s=""){let i=r??n.name.toLowerCase();return{name:i,path:s+i,type:n.type,value:e,default:n.default??O(n),...n.values!==void 0?{values:n.values}:{},...n.stages!==void 0?{stages:n.stages}:{},writable:t??n.writable??!0}}var Me=n=>n.toLowerCase(),U=1,G=class{scopes=new Map;parked=new Map;rev=0;get revision(){return this.rev}defineOwned(e,t,r){let s=typeof r=="string"?{pathPrefix:r}:r??{},i=new w(t,{pathPrefix:s.pathPrefix??`${e}.`,...s.normalise?{normalise:s.normalise}:{}});return this.mountOwned(e,i,s.owner!==void 0?{owner:s.owner}:void 0)}mountOwned(e,t,r){this.assertFree(e,r?.owner),this.scopes.set(e,{kind:"owned",bag:t,...r?.owner!==void 0?{owner:r.owner}:{}}),this.rev++;let s=this.parked.get(e);return s&&(t.load(s),this.parked.delete(e)),this}remove(e,t){let r=this.scopes.get(e);if(!r)throw new Error(`unknown scope \'@${e}\'`);return t?.keep&&r.kind==="owned"&&this.parked.set(e,r.bag.save()),this.scopes.delete(e),this.rev++,this}discardParked(e){if(e===void 0)this.parked.clear();else for(let t of[...this.parked.keys()])t.startsWith(e)&&this.parked.delete(t);return this}ownedBag(e){let t=this.scopes.get(e);if(!t||t.kind!=="owned")throw new Error(`\'@${e}\' is not an owned scope`);return t.bag}reseedOwned(e,t){return this.ownedBag(e).reseed(t),this}defineForeign(e,t,r=[],s=!0){let i=typeof s=="boolean"?{writable:s}:s;this.assertFree(e,i.owner);let o=i.normalise??Me,a=new Map;for(let c of r)a.set(o(c.name),c);return this.scopes.set(e,{kind:"foreign",resolver:t,decls:a,scopeWritable:i.writable??!0,norm:o,...i.owner!==void 0?{owner:i.owner}:{}}),this.rev++,this}has(e){return this.scopes.has(e)}get(e,t){let r=this.scopes.get(e);if(r)return r.kind==="owned"?r.bag.get(t):r.resolver.get(r.norm(t))}set(e,t,r,s){let i=this.scopes.get(e);if(!i)throw new Error(`unknown scope \'@${e}\'`);if(i.kind==="owned"){try{i.bag.set(t,r,s?.host?{host:!0}:void 0)}catch{throw new Error(`\'@${e}.${t}\' is read-only`)}return}let o=i.norm(t);if(!i.resolver.set)throw new Error(`\'@${e}.${t}\' is read-only`);if(!s?.host&&!this.foreignWritable(i,o))throw new Error(`\'@${e}.${t}\' is read-only`);i.resolver.set(o,r)}foreignWritable(e,t){return e.resolver.set?e.decls.get(t)?.writable??e.scopeWritable:!1}listProperties(){let e=[];for(let[t,r]of this.scopes){let s=r.owner!==void 0?{owner:r.owner}:{};if(r.kind==="owned")for(let i of r.bag.rows())e.push({scope:t,...s,...i});else for(let[i,o]of r.decls)e.push({scope:t,...s,...ae(o,r.resolver.get(i),this.foreignWritable(r,i),i,`${t}.`)})}return e}toEvalContext(e,t){let r=this.view(t?.aliases),s={};for(let[o,a]of r)s[o]=a.kind==="owned"?a.bag.values:a.resolver;let i=this.qualityLadders(r);return i.size===0?{scopes:s,host:e}:{scopes:s,host:e,qualities:(o,a)=>{let c=r.get(o);return c?i.get(o)?.get($e(c)(a)):void 0}}}view(e){let t=new Map(this.scopes);for(let[r,s]of Object.entries(e??{})){let i=this.scopes.get(s);if(!i)throw new Error(`alias \'@${r}\' names \'${s}\', which is not registered`);t.set(r,i)}return t}qualityLadders(e){let t=new Map;for(let[r,s]of e)for(let[i,o]of oe(s)){if(o.type!=="quality"||o.stages===void 0)continue;let a=t.get(r);a||(a=new Map,t.set(r,a)),a.set(i,o.stages)}return t}toSchema(e){let t=new Map;for(let[r,s]of this.view(e?.aliases)){let i=oe(s);if(i.length===0)continue;let o=new Map;for(let[a,c]of i)o.set(a,{type:c.type,enumValues:c.values,...c.stages!==void 0?{stages:c.stages}:{}});t.set(r,o)}return{properties:t}}save(){let e={};for(let[t,r]of this.scopes)r.kind==="owned"&&(e[t]=r.bag.save());for(let[t,r]of this.parked)e[t]=structuredClone(r);return e}load(e,t){t?.keepParked||this.parked.clear();for(let[r,s]of Object.entries(e)){let i=this.scopes.get(r);i?.kind==="owned"?i.bag.load(s):i||this.parked.set(r,structuredClone(s))}}saveFragment(){return{version:U,scopes:this.save()}}loadFragment(e){if(e.version!==U)throw new Error(`unsupported owned-state fragment version ${e.version} (supported: ${U})`);this.load(e.scopes)}assertFree(e,t){let r=this.scopes.get(e);if(!r)return;let s=r.owner!==void 0?` by ${r.owner}`:"",i=t!==void 0?` (wanted by ${t})`:"";throw new Error(`scope \'@${e}\' is already registered${s}${i}`)}};function oe(n){return n.kind==="foreign"?[...n.decls.entries()]:n.bag.declarations().map(e=>[n.bag.normalise(e.name),e])}function $e(n){return n.kind==="foreign"?n.norm:e=>n.bag.normalise(e)}function O(n){if(n.default!==void 0)return n.default;switch(n.type){case"boolean":return!1;case"number":return 0;case"string":return"";case"enum":return n.values?.[0]??"";case"flags":return[];case"quality":return n.stages?.[0]??"";default:return!1}}var ce=[{token:"patter",engine:"Patterplay",means:"Patter\'s shared globals"},{token:"story",engine:"Storylet Engine",means:"the Storylet Engine\'s shared @story properties"}];function B(n){return n.ctx.host??{}}var W={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=B(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:pe("check_flags"),eval(n,e){let t=le(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:pe("set_flags"),eval(n,e){let t=[...le(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:V("visits"),eval:(n,e)=>B(e).visits?.(T(n,e,"visits"))??0},seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:V("seen"),eval:(n,e)=>(B(e).visits?.(T(n,e,"seen"))??0)>0},patter_visits:{minArgs:1,maxArgs:1,returnType:"number",validate:V("patter_visits"),eval:(n,e)=>B(e).patterVisits?.(T(n,e,"patter_visits"))??0},patter_seen:{minArgs:1,maxArgs:1,returnType:"boolean",validate:V("patter_seen"),eval:(n,e)=>(B(e).patterVisits?.(T(n,e,"patter_seen"))??0)>0}}},ht=ce.map(n=>n.token).filter(n=>n!=="patter"&&n!=="scene");function de(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 T(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 V(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 le(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 pe(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 je=/^@[A-Za-z0-9_.]+$/;function*He(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:je.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 _e(n){return Array.isArray(n)?n.join(", "):typeof n=="boolean"?n?"true":"false":String(n)}function qe(n){return n===" "||n==="	"||n===`\n`||n==="\\r"||n==="\\f"||n==="\\v"}function Ue(n){let e="",t=!1;for(let r of n){if(qe(r)){t=!0;continue}t&&e.length>0&&(e+=" "),t=!1,e+=r}return e}function ge(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?Ue(r):n}function ue(n,e){if(n.indexOf("{")<0)return n;let t="";for(let r of He(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?"":_e(s)}return t}function C(n,e){for(let t of n){e(t);let r=t.children;r&&C(r,e)}}function We(n){return n.toLowerCase().replace(/[\'\u2019]/g,"").replace(/[^a-z0-9-]+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function m(n){let e=n.gameId?.trim();return e||We(n.name)}function K(n){return`cast:${n}`}var J={open:"[",close:"]"},he="SFX";var z=3;function L(n){let e=new Set,t=[];for(let r of n)e.has(r)||(e.add(r),t.push(r));return t}function M(n){let e=new Map,t=(r,s)=>{let i=L([...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,L([...i,...o.tags??[]]))};for(let r of Object.values(n.scenes)){let s=L(r.tags??[]);e.set(r.id,s);for(let i of r.blocks){let o=L([...s,...i.tags??[]]);e.set(i.id,o);for(let a of i.children)t(a,o)}}return e}var fe=new WeakMap,I="Patter",P=n=>n.replace(/%/g,"%25").replace(/\\//g,"%2F"),me=Symbol("ownsRegistry"),v={stage:n=>`patter/scene/${P(n)}`,flow:n=>`patter/flow/${P(n)}/`,flowGlobals:n=>`patter/flow/${P(n)}/patter`,flowScene:(n,e)=>`patter/flow/${P(n)}/scene/${P(e)}`},$=class n{host;defaultSeed;flowsById=new Map;allStrings;currentLocale;sourceDebug;sceneGameIdToId=new Map;blockGameIdToId=new Map;creationOptions;engineLog=[];engineTraceHandlers=new Set;constructor(e,t={}){this.creationOptions=t;let r=t.locale??e.locales.default,s=e.strings;this.allStrings=s,this.currentLocale=r;let i=s[r]??{},o=s[e.locales.default]??{},a=e.localisation,c=a?.mode==="ids"&&!a.sourceDebug;this.sourceDebug=a?.mode==="ids"&&!!a.sourceDebug,this.sourceDebug&&typeof console<"u"&&console.warn("[Patterplay] source-only DEBUG build: strings are the source language for debugging, not a shippable localised build.");let l=new Map;for(let g of e.cast??[])g.displayName&&l.set(g.name,g.displayName);this.defaultSeed=(t.seed??2654435769)>>>0;let d=new Map,u=new Map,S=new Map;for(let[g,h]of Object.entries(e.scenes)){this.sceneGameIdToId.set(m(h),g);let y=new Map;for(let f of h.blocks)u.set(f.id,{sceneId:g}),S.set(f.id,f),y.set(m(f),f.id),C(f.children,ne=>d.set(ne.id,ne));this.blockGameIdToId.set(g,y)}let X=e.properties??[],j=X.filter(g=>g.shared??!0).map(ve),Re=X.filter(g=>!(g.shared??!0)).map(ve),Oe=new Set(j.map(g=>g.name.toLowerCase())),x=t.registry??new G,Z=!t.registry||t[me]===!0,ee=new w(j,{pathPrefix:"@patter."}),te=[],N=[];try{x.mountOwned("patter",ee,{owner:I}),N.push("patter");let g=new Set;if(t.world){let h=e.scopeRegistry?.scopes.find(f=>f.token==="world"),y=(h?.declarations??[]).map(ke);x.defineForeign("world",t.world,y,{writable:h?.writable??!0,owner:I}),N.push("world"),g.add("world")}for(let h of Z?e.scopeRegistry?.scopes??[]:[]){if(g.has(h.token)||x.has(h.token))continue;let y=(h.declarations??[]).map(f=>Ke(f,h.writable));x.defineOwned(h.token,y,{owner:I}),N.push(h.token),te.push(h.token)}}catch(g){for(let h of N)x.remove(h,{keep:!0});throw g}let re=new Map;for(let[g,h]of Object.entries(e.scenes)){let y=new Set((h.sceneProps??[]).filter(f=>f.shared??!1).map(f=>f.name.toLowerCase()));re.set(g,y)}this.host={logEnabled:t.log??!1,emitEngine:(g,h,y)=>this.emitEngine(g,h,y),bundle:e,emitIds:c,strings:i,defaultStrings:o,castDisplay:l,nodeIndex:d,blockIndex:u,blockById:S,sceneGameIdToId:this.sceneGameIdToId,blockGameIdToId:this.blockGameIdToId,tagIndex:M(e),registry:x,ownsRegistry:Z,patterBag:ee,hostScopes:te,patterSharedDecls:j,patterLocalDecls:Re,patterSharedNames:Oe,sceneSharedNames:re,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||he,refSplitCache:new Map,refSplitRevision:x.revision}}get locale(){return this.currentLocale}get isSourceDebug(){return this.sourceDebug}setLocale(e){this.currentLocale=e,this.host.strings=this.allStrings[e]??{}}replaceStrings(e){this.allStrings=e.strings,this.host.strings=this.allStrings[this.currentLocale]??{},this.host.defaultStrings=this.allStrings[this.host.bundle.locales.default]??{}}hotSwap(e){let t=this.saveGame(),r=o=>(o.setLocale(this.currentLocale),o.setClosedCaptions(this.host.captionsOn),o),s=()=>new n(e,{...this.creationOptions,registry:this.host.registry,[me]:this.host.ownsRegistry});this.release(!0);let i=s();try{return i.loadGame(t),r(i)}catch{i.release(!0);let o=s();for(let[a,c]of Object.entries(t.flows)){let l=c.cursor.currentSceneId;try{o.openFlow(a,l!==null?{scene:l}:{})}catch{}}return r(o)}}get closedCaptions(){return this.host.captionsOn}setClosedCaptions(e){this.host.captionsOn=e}openFlow(e,t={}){this.assertExternalScopes();let r=this.resolveSceneRef(t.scene),s=this.resolveBlockRef(r,t.block);this.flowsById.get(e)?.close();let i=new D(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}assertExternalScopes(){for(let e of this.host.bundle.externalScopes??[])if(!this.host.registry.has(e))throw new Error(`this content names @${e}, which no engine on this registry registered: give every engine the game\'s one registry`)}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?m(t):void 0}blockAddress(e){let t=this.host.blockById.get(e);return t?m(t):void 0}tagsForBeat(e){return this.host.tagIndex.get(e)??[]}tagsForScene(e){let t=this.resolveSceneRef(e);return(t!=null?this.host.tagIndex.get(t):void 0)??[]}tagsForBlock(e,t){let r=this.resolveSceneRef(e),s=this.resolveBlockRef(r,t);return(s!=null?this.host.tagIndex.get(s):void 0)??[]}gameDataForScene(e){let t=this.resolveSceneRef(e);return{...(t!=null?this.host.bundle.scenes[t]:void 0)?.gameData}}gameDataForBlock(e,t){let r=this.resolveBlockRef(this.resolveSceneRef(e),t);return{...(r!=null?this.host.blockById.get(r):void 0)?.gameData}}getCast(){let e=[];for(let t of this.host.bundle.cast??[])t?.name&&e.push(t.name);return e}castForScene(e){let t=this.resolveSceneRef(e),r=t!=null?this.host.bundle.scenes[t]:void 0;if(!r)return[];let s=new Set;for(let i of r.blocks)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,...m(e)?{gameId:m(e)}:{},name:e.name,...ye(e.gameData),...this.tagsField(e.id),blocks:e.blocks.map(t=>({id:t.id,...m(t)?{gameId:m(t)}:{},name:t.name,...ye(t.gameData),...this.tagsField(t.id),children:t.children.map(r=>this.outlineNode(r))}))}))}getBeatSequence(){let e=[];for(let t of Object.values(this.host.bundle.scenes))for(let r of t.blocks)C(r.children,s=>{if(s.type==="snippet")for(let i of s.beats??[])e.push({sceneId:t.id,blockId:r.id,snippetId:s.id,beat:this.beatInfo(i)})});return e}outlineNode(e){return e.type==="group"?{type:"group",id:e.id,...this.tagsField(e.id),...e.selector?{selector:e.selector}:{},...e.prompt?{prompt:this.beatInfo(e.prompt)}:{},children:e.children.map(t=>this.outlineNode(t))}:{type:"snippet",id:e.id,...this.tagsField(e.id),beats:(e.beats??[]).map(t=>this.beatInfo(t)),...e.jump?{jumpTo:e.jump.to,...e.jump.mode?{jumpMode:e.jump.mode}:{}}:{}}}beatInfo(e){let t=this.host.tagIndex.get(e.id),r={id:e.id,kind:e.kind};if(e.kind==="line"){if(e.character!==void 0){r.character=e.character;let s=this.host.defaultStrings[K(e.character)]??this.host.castDisplay.get(e.character);s!==void 0&&(r.characterName=s)}e.direction!==void 0&&(r.direction=e.direction)}if(e.kind==="line"||e.kind==="text"){let s=this.host.defaultStrings[e.id];s!==void 0&&(r.text=s)}return e.gameData&&Object.keys(e.gameData).length&&(r.gameData=e.gameData),t&&t.length&&(r.tags=t),r}tagsField(e){let t=this.host.tagIndex.get(e);return t&&t.length?{tags:t}:{}}getFlow(e){return this.flowsById.get(e)}flows(){return[...this.flowsById.values()]}listBags(){let e=[{bag:this.host.patterBag}];for(let[t,r]of this.host.stageBags)e.push({bag:r,pathPrefix:`@scene:${t}.`});return e}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.patterBag.reseed(this.host.patterSharedDecls),this.host.sharedVisits.clear(),this.host.sharedSelectors.clear();for(let e of this.host.stageBags.keys())this.host.registry.remove(v.stage(e));this.host.stageBags.clear(),this.host.registry.discardParked("patter/")}release(e){for(let r of this.flowsById.values())r.releaseBags(e),r.close();this.flowsById.clear();let t=this.host.registry;for(let r of this.host.stageBags.keys())t.remove(v.stage(r),{keep:e});this.host.stageBags.clear();for(let r of["patter",...this.host.hostScopes])t.has(r)&&t.remove(r,{keep:e});this.creationOptions.world&&t.has("world")&&t.remove("world")}getProperty(e){let{scope:t,name:r}=this.splitShared(e);return this.host.registry.get(t,r)}setProperty(e,t){let{scope:r,name:s}=this.splitShared(e);this.host.registry.set(r,s,t,{host:!0})}log(){return this.engineLog}clearLog(){this.engineLog.length=0}onTrace(e){return this.engineTraceHandlers.add(e),()=>this.engineTraceHandlers.delete(e)}emitEngine(e,t,r){for(let s of this.engineTraceHandlers)s(e,t);this.host.logEnabled&&this.engineLog.push({...t,flow:e,seq:this.engineLog.length,...r?{scene:r}:{}})}listProperties(){return this.host.patterSharedDecls.map(e=>({name:e.name,path:`@patter.${e.name}`,type:e.type,values:e.values,stages:e.stages,value:this.getProperty(`@${e.name}`),default:O(e),writable:e.writable??!0}))}splitShared(e){let t=Ee(this.host,e);if(t.scope==="scene")throw new Error(`\'${e}\': @scene properties are scene-scoped - read/write them on a Flow, not the Engine`);return t}save(){return{patter:this.host.patterBag.save()}}load(e){e.patter&&this.host.patterBag.load(e.patter)}saveGame(){let e={};for(let[t,r]of this.flowsById)e[t]=r.snapshot();return{version:z,...this.host.ownsRegistry?{registry:this.host.registry.save()}:{},sharedVisits:Object.fromEntries(this.host.sharedVisits),sharedSelectors:we(this.host.sharedSelectors),flows:e}}loadGame(e){let t=e.version;if(t!==2&&t!==z)throw new Error(`unsupported save version: ${String(t)}`);this.assertExternalScopes();let r=this.host.registry;for(let[i,o]of this.flowsById)o.releaseBags(i in e.flows),o.close();this.flowsById.clear();for(let i of this.host.stageBags.keys())r.remove(v.stage(i),{keep:!0});this.host.stageBags.clear();let s=e.version===2?Je(e):e.registry;s&&(this.host.ownsRegistry?r.load(s):r.load(s,{keepParked:!0})),this.host.sharedVisits.clear();for(let[i,o]of Object.entries(e.sharedVisits??{}))this.host.sharedVisits.set(i,o);this.host.sharedSelectors.clear();for(let[i,o]of xe(e.sharedSelectors))this.host.sharedSelectors.set(i,o);for(let[i,o]of Object.entries(e.flows)){let a=new D(i,this.host,this.defaultSeed);a.restore(o),this.flowsById.set(i,a)}}},D=class{id;host;local;registered=new Set;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.patterBag.get(e):this.local.get(e),set:(e,t)=>{this.host.patterSharedNames.has(e)?this.host.registry.set("patter",e,t):this.local.set(e,t)}};sceneResolver={get:e=>{let t=this.currentSceneId;if(t!==null)return this.sceneBagFor(t,e)?.get(e)},set:(e,t)=>{let r=this.currentSceneId;if(r===null)return;let s=this.sceneBagFor(r,e);s&&s.set(e,t)}};evalCtx;ctxRevision=-1;registryQualities;flowLog=[];flowSeq=0;constructor(e,t,r){this.id=e,this.host=t,this.rngState=R(r),this.local=this.newLocal(),this.evalCtx={scopes:{},host:{nextRandom:this.rng,visits:s=>this.visitCounts.get(s)??0,patterVisits:s=>this.host.sharedVisits.get(s)??0},qualities:(s,i)=>this.stagesFor(s,i)}}context(){let e=this.host.registry;if(e.revision!==this.ctxRevision){let t=e.toEvalContext(),r=this.evalCtx.scopes;for(let s of Object.keys(r))delete r[s];Object.assign(r,t.scopes),r.patter=this.patterResolver,r.scene=this.sceneResolver,this.registryQualities=t.qualities,this.ctxRevision=e.revision}return this.evalCtx}stagesFor(e,t){let r=t.toLowerCase(),s=i=>i?.find(o=>o.name.toLowerCase()===r&&o.type==="quality")?.stages;if(e==="patter")return s(this.host.patterSharedDecls)??s(this.host.patterLocalDecls);if(e==="scene"){let i=this.currentSceneId!=null?this.host.bundle.scenes[this.currentSceneId]:void 0;return s(i?.sceneProps)}return this.registryQualities?.(e,t)??s(this.host.bundle.scopeRegistry?.scopes.find(i=>i.token===e)?.declarations)}start(e,t){if(this.releaseBags(!1),this.host.registry.discardParked(v.flow(this.id)),this.mountLocal(),this.selectors.clear(),this.visitCounts.clear(),this.stack=[],this.currentSceneId=null,this.flowEnded=!1,this.activeSnippet=null,this.beatIndex=0,this.pendingChoice=null,this.started=!0,t){let r=this.host.blockIndex.get(t);if(!r)throw new Error(`unknown block: ${t}`);this.enterSceneSetup(r.sceneId),this.stack=[{sceneId:r.sceneId,containerId:t,index:0}],this.enter(t)}else{let r=e??Object.keys(this.host.bundle.scenes)[0],s=r?this.host.bundle.scenes[r]:void 0;if(!s)throw new Error(r?`unknown scene: ${r}`:"no scenes in bundle");this.enterSceneSetup(r);let i=s.blocks[0];i&&(this.stack=[{sceneId:r,containerId:i.id,index:0}],this.enter(i.id))}this.settle()}reset(e,t){this.start(e,t)}goto(e,t){if(this.closed)return!1;if(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.releaseBags(!1),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 i=this.activeSnippet.jump;this.activeSnippet=null,this.beatIndex=0,this.resolveJump(i);continue}let t=this.stack[this.stack.length-1];if(!t){this.flowEnded=!0;return}t.sceneId!==this.currentSceneId&&(this.currentSceneId=t.sceneId);let r=this.childrenOf(t.containerId);if(!r){this.stack.pop();continue}let s=t.index;for(;t.index<r.length&&!this.eligible(r[t.index]);)t.index++;if(this.host.logEnabled&&t.index!==s&&this.emit({type:"select",group:t.containerId,selector:"run",children:r.slice(s,t.index+1).map((i,o)=>({id:i.id,eligible:s+o===t.index})),picked:r[t.index]?.id??null}),t.index>=r.length){this.stack.pop();continue}this.enterChild(r[t.index++])}}listBags(){let e=[{bag:this.local,pathPrefix:`${this.id}/@patter.`}];for(let[t,r]of this.sceneBags)e.push({bag:r,pathPrefix:`${this.id}/@scene:${t}.`});return e}log(){return this.flowLog}clearLog(){this.flowLog.length=0}emit(e){let t=this.currentSceneId??void 0;this.host.emitEngine(this.id,e,t),this.host.logEnabled&&this.flowLog.push({...e,seq:this.flowSeq++,...t?{scene:t}:{}})}getChoices(){return this.pendingChoice?.options??[]}choose(e){let t=this.pendingChoice;if(!t)throw new Error("no choice is pending");let r=t.options.find(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.emit({type:"chose",group:t.groupId,option: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.registry.get(t,r)}setProperty(e,t){this.writeProperty(e,t,!0)}writeProperty(e,t,r){let{scope:s,name:i}=this.splitRef(e);if(s==="patter")this.patterResolver.set(i,t);else if(s==="scene"){if(this.currentSceneId===null)throw new Error(`\'${e}\': the flow has not entered a scene yet`);this.sceneResolver.set(i,t)}else this.host.registry.set(s,i,t,r?{host:!0}:void 0)}snapshot(){return{rngState:this.rngState,visits:Object.fromEntries(this.visitCounts),cursor:{flowEnded:this.flowEnded,currentSceneId:this.currentSceneId,stack:this.stack.map(e=>{let t=this.childrenOf(e.containerId)?.[e.index];return t?{...e,nextId:t.id}:{...e}}),activeSnippetId:this.activeSnippet?.id??null,beatIndex:this.beatIndex,pendingChoice:this.pendingChoice?{groupId:this.pendingChoice.groupId,options:this.pendingChoice.options.map(e=>({...e}))}:null,pendingPromptOwnerId:this.pendingPromptOwnerId,selectors:we(this.selectors)}}}restore(e){this.rngState=R(e.rngState),this.visitCounts=new Map(Object.entries(e.visits??{}));let t=e.cursor;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.releaseBags(!1),this.mountLocal();for(let r of new Set([t.currentSceneId,...this.stack.map(s=>s.sceneId)]))r!==null&&this.host.bundle.scenes[r]&&this.ensureSceneBags(r);if(this.activeSnippet=null,t.activeSnippetId!==null){let r=this.host.nodeIndex.get(t.activeSnippetId);r&&r.type==="snippet"&&(this.activeSnippet=r)}if(this.selectors=xe(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.emit({type:"choice",group:e.id,options:t.map(o=>({id:o.id,eligible:o.eligible}))}),this.pendingChoice={groupId:e.id,options:t,byId:r};return}let i=s.find(o=>this.eligible(o));if(i){this.enterChild(i);return}this.emit({type:"dry",group:e.id}),this.host.onDryChoice?.(e.id)}resolveJump(e){e&&this.enterTarget(e.to,e.mode==="call"?"call":"jump")}enterTarget(e,t){if(this.emit({type:"jump",to:e,mode:t}),e==="END"){this.flowEnded=!0,this.stack=[];return}let r,s,i=this.host.bundle.scenes[e];if(i){this.enterSceneSetup(e);let a=i.blocks[0];if(!a){t==="jump"&&(this.stack=[]);return}r=e,s=a.id}else{let a=this.host.blockIndex.get(e);if(!a)throw new Error(`jump target not found: ${e}`);a.sceneId!==this.currentSceneId&&this.enterSceneSetup(a.sceneId),r=a.sceneId,s=e}this.enter(s);let o={sceneId:r,containerId:s,index:0};t==="call"?this.stack.push(o):this.stack=[o]}selectChild(e){let t=e.children.map(c=>({id:c.id,eligible:this.eligible(c)})),r=e.children.filter(c=>this.eligible(c)),s=e.options?.order??"sequential",i=e.options?.exhaust??"once",o=c=>(this.emit({type:"select",group:e.id,selector:e.selector??"default",...e.selector==="sequence"?{order:s,exhaust:i}:{},children:t,picked:c?.id??null}),c);if(r.length===0)return o(null);let a=this.selectorState(e);switch(e.selector){case"branch":return o(r[0]);case"sequence":return o(s==="shuffle"?this.pickShuffle(r,i,a):s==="specificity"?this.pickSpecificity(r,i,a):this.pickSequential(r,i,a));default:return null}}pickSequential(e,t,r){let s=e.length,i=r.seq??0;return r.seq=i+1,t==="repeat"?e[i%s]:i<s?e[i]:t==="stick"?e[s-1]:null}pickShuffle(e,t,r){let s=e.length,i=t==="stick",o=()=>(i?e.slice(0,s-1):e).map(u=>u.id);if(r.bag===void 0&&(r.bag=o()),r.bag.length===0){if(t==="once")return null;if(i){let u=e[s-1];return r.last=u.id,u}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 d=a[l];return a.splice(l,1),r.last=d,e.find(u=>u.id===d)}pickSpecificity(e,t,r){let s=e;if(t!=="repeat"){r.bag===void 0&&(r.bag=e.map(d=>d.id));let l=new Set(r.bag);if(s=e.filter(d=>l.has(d.id)),s.length===0)return t==="stick"&&r.last!==void 0?e.find(d=>d.id===r.last)??null:null}let i=-1,a=s.map(l=>{let d=this.specScore(l);return d>i&&(i=d),{c:l,s:d}}).filter(l=>l.s===i).map(l=>l.c),c;if(a.length===1)c=a[0];else{let l=r.last!==void 0?a.findIndex(u=>u.id===r.last):-1,d=Math.floor(this.rng()*(l>=0?a.length-1:a.length));l>=0&&d>=l&&d++,c=a[d]}return t!=="repeat"&&(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 ie(e,s=>be(F(s,this.context(),W)),{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??[]){let r=this.evalExpr(t.value),s=this.host.logEnabled?this.getProperty(t.target):void 0;this.writeProperty(t.target,r,!1),this.emit({type:"write",target:t.target,value:r,...s!==void 0?{prev:s}:{}})}}eligible(e){return e.condition?be(this.evalExpr(e.condition)):!0}evalExpr(e){return F(this.conditionAst(e),this.context(),W)}conditionAst(e){let t=fe.get(e);return t||(t=k(e.ast),fe.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=q(this.rngState),t=e.next();return this.rngState=e.state(),t};beatResult(e){let t=this.host.tagIndex.get(e.id),r=t&&t.length?{tags:t}:{};switch(e.kind){case"gameEvent":return{type:"gameEvent",id:e.id,gameData:e.gameData,...r};case"text":return{type:"text",id:e.id,text:this.interpolate(this.resolveString(e.id)),gameData:e.gameData,...r};case"line":{let s=this.resolveString(e.id),i=!this.host.captionsOn,a=i&&e.character===this.host.captionCharacter?"":this.captionLine(this.host.bundle.voiced?s:this.interpolate(s)),c=i&&a.length===0;return{type:"line",id:e.id,text:a,character:c?void 0:e.character,characterName:c?void 0:this.resolveCharacterName(e.character),direction:c?void 0:e.direction,gameData:e.gameData,...r}}}}interpolate(e){return ue(e,t=>this.getProperty(t))}stripCaptions(e){return ge(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 C(e,r=>{!t&&r.type==="snippet"&&(r.beats??[]).some(s=>s.kind==="line"||s.kind==="text")&&(t=r)}),t}resolveString(e){if(this.host.emitIds)return e;let t=this.host.strings[e];if(t!==void 0)return t;let r=this.host.defaultStrings[e];return r!==void 0?`<Untranslated: ${e}> ${r}`:e}resolveCharacterName(e){if(e===void 0||this.host.emitIds)return;let t=K(e);return this.host.strings[t]??this.host.defaultStrings[t]??this.host.castDisplay.get(e)}splitRef(e){return Ee(this.host,e)}newLocal(){return new w(this.host.patterLocalDecls,{pathPrefix:"@patter."})}mountLocal(){this.local=this.newLocal();let e=v.flowGlobals(this.id);this.host.registry.mountOwned(e,this.local,{owner:I}),this.registered.add(e)}releaseBags(e){for(let t of this.registered)this.host.registry.remove(t,{keep:e});this.registered.clear(),this.sceneBags.clear()}sceneBagFor(e,t){if(this.host.bundle.scenes[e])return this.ensureSceneBags(e),this.host.sceneSharedNames.get(e)?.has(t.toLowerCase())?this.host.stageBags.get(e):this.sceneBags.get(e)}ensureSceneBags(e){let t=this.host.sceneSharedNames.get(e)??new Set,r=this.host.bundle.scenes[e]?.sceneProps??[];if(!this.sceneBags.has(e)){let s=new w(r.filter(o=>!t.has(o.name.toLowerCase())),{pathPrefix:"@scene."}),i=v.flowScene(this.id,e);this.host.registry.mountOwned(i,s,{owner:I}),this.registered.add(i),this.sceneBags.set(e,s)}if(!this.host.stageBags.has(e)){let s=new w(r.filter(i=>t.has(i.name.toLowerCase())),{pathPrefix:"@scene."});this.host.registry.mountOwned(v.stage(e),s,{owner:I}),this.host.stageBags.set(e,s)}}seedScene(e){let t=this.host.sceneSharedNames.get(e.id)??new Set;this.ensureSceneBags(e.id);for(let r of e.sceneProps??[]){if(!r.temporary)continue;let s=r.name.toLowerCase(),i=t.has(s)?this.host.stageBags.get(e.id):this.sceneBags.get(e.id);i&&i.set(s,O(r))}}};function Se(n,e){C(n,t=>{if(t.type==="group"){t.prompt?.kind==="line"&&t.prompt.character&&e.add(t.prompt.character);return}for(let r of t.beats??[])r.kind==="line"&&r.character&&e.add(r.character)})}function ye(n){return n&&Object.keys(n).length?{gameData:n}:{}}function we(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 xe(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 ve(n){return{name:n.name,type:n.type,values:n.values,stages:n.stages,default:n.default}}function ke(n){return{name:n.name,type:n.type,values:n.values,stages:n.stages,default:n.default,writable:n.writable}}function Ke(n,e){let t=ke(n),r=n.writable??e;return r===void 0?t:{...t,writable:r}}function Ee(n,e){n.refSplitRevision!==n.registry.revision&&(n.refSplitCache.clear(),n.refSplitRevision=n.registry.revision);let t=n.refSplitCache.get(e);return t||(t=de(e,r=>r==="scene"||n.registry.has(r)||(n.bundle.externalScopes?.includes(r)??!1)),n.refSplitCache.set(e,t)),t}function Je(n){let e={};n.shared?.patter&&(e.patter=n.shared.patter);for(let[t,r]of Object.entries(n.stageBags??{}))e[v.stage(t)]=r;for(let[t,r]of Object.entries(n.flows??{})){r.scopes?.patter&&(e[v.flowGlobals(t)]=r.scopes.patter);for(let[s,i]of Object.entries(r.sceneBags??{}))e[v.flowScene(t,s)]=i}return e}function be(n){return typeof n=="boolean"?n:typeof n=="number"?n!==0:typeof n=="string"?n!=="":n.length>0}var ze=(n,e)=>n.shared??e;function Y(n,e){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.default!==void 0?{default:n.default}:{},shared:ze(n,e)}}function Ye(n){return{name:n.name,type:n.type,hasDefault:n.default!==void 0,...n.values?{values:[...n.values]}:{},...n.purpose?{purpose:n.purpose}:{}}}function Qe(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 Ce(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=m(o);t.push({gameId:a,name:o.name,blocks:o.blocks.map(c=>({gameId:m(c),name:c.name}))});for(let c of o.blocks)Qe(c,e);o.sceneProps?.length&&r.push({gameId:a,properties:o.sceneProps.map(c=>Y(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=>Y(a,!0))})),i=Object.entries(n.gameDataFields??{}).filter(([,o])=>(o?.length??0)>0).map(([o,a])=>({kind:o,fields:(a??[]).map(Ye)}));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=>Y(o,!0)),scene:r},gameData:i,counts:e}}function Ie(n,e){return n.gameDataFields?.[e]??[]}function Q(n,e,t){return e&&Object.prototype.hasOwnProperty.call(e,t)?e[t]:n.find(r=>r.name===t)?.default}function De(n,e){let t={};for(let r of n){let s=Q(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 Ge(Xe);})();\n';
 
 // src/export-html.ts
 var esc = (s) => s.replace(/[&<>]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;" })[c]);
@@ -1591,6 +1591,10 @@ function mulberry32(seed) {
   const prng = makePrng(seed);
   return () => prng.next();
 }
+var RARE_REACH_PCT = 5;
+function leastReachedFirst(beats) {
+  return beats.map((b, i) => ({ b, i })).sort((x, y) => x.b.reachPct - y.b.reachPct || x.b.hits - y.b.hits || x.i - y.i).map(({ b }) => b);
+}
 function scanExpr(node, hostTokens, refs, proposals) {
   const refOf = (n) => n.kind === "scopedvar" && hostTokens.has(n.scope) ? `@${n.scope}.${n.name}` : void 0;
   const propose = (ref, v) => (proposals.get(ref) ?? proposals.set(ref, /* @__PURE__ */ new Set()).get(ref)).add(v);
@@ -1880,6 +1884,7 @@ function* sweep(loaded, options = {}, hooks = {}) {
       const blocked = blockedGates(id, analysis, drivenRefs, reachedRuns);
       if (blocked.length) blockedBy = blocked;
     }
+    const reachPct = executed ? reached / executed * 100 : 0;
     return {
       id,
       scene: m.scene,
@@ -1888,13 +1893,15 @@ function* sweep(loaded, options = {}, hooks = {}) {
       preview: m.preview,
       hits: hitCount.get(id),
       reachedRuns: reached,
-      reachPct: executed ? reached / executed * 100 : 0,
+      reachPct,
+      ...reached > 0 && reachPct < RARE_REACH_PCT ? { rare: true } : {},
       ...needsInput ? { needsInput } : {},
       ...blockedBy ? { blockedBy } : {}
     };
   });
   const neverHit = beats.filter((b) => b.reachedRuns === 0).length;
   const covered = beats.length - neverHit;
+  const rare = beats.filter((b) => b.rare).length;
   const dryChoices = [...dryRuns.entries()].map(([id, r]) => ({ id, scene: choiceScene.get(id) ?? "", runs: r })).sort((a, b) => b.runs - a.runs || a.id.localeCompare(b.id));
   return {
     runs: executed,
@@ -1902,7 +1909,8 @@ function* sweep(loaded, options = {}, hooks = {}) {
     seed,
     start,
     beats,
-    totals: { beats: beats.length, covered, neverHit, coveragePct: beats.length ? covered / beats.length * 100 : 100 },
+    totals: { beats: beats.length, covered, neverHit, rare, coveragePct: beats.length ? covered / beats.length * 100 : 100 },
+    rareThresholdPct: RARE_REACH_PCT,
     termination,
     drivers,
     unwrittenInputs: [...unwrittenInputs].sort(),
@@ -1926,14 +1934,19 @@ async function runCoverageAsync(loaded, options = {}, hooks = {}) {
   }
   return step.value;
 }
-function renderCoverageText(report, sceneName = (id) => id) {
+function renderCoverageText(report, sceneName = (id) => id, opts = {}) {
+  const order = opts.order ?? "least";
   const out = [];
   const t = report.totals;
   const pct = (n) => `${n.toFixed(0)}%`;
-  out.push(`coverage: ${t.covered}/${t.beats} beats reached (${pct(t.coveragePct)})${t.neverHit ? ` - ${t.neverHit} never reached` : ""}`);
+  const rareLimit = report.rareThresholdPct ?? RARE_REACH_PCT;
+  const rareCount = t.rare ?? report.beats.filter((b) => b.rare).length;
+  out.push(
+    `coverage: ${t.covered}/${t.beats} beats reached (${pct(t.coveragePct)})` + (t.neverHit ? ` - ${t.neverHit} never reached` : "") + (rareCount ? ` - ${rareCount} rarely reached (under ${rareLimit}% of runs)` : "")
+  );
   out.push(`${report.runs} run(s) - ${report.maxSteps} max steps - seed ${report.seed}${report.cancelled ? " - CANCELLED" : ""}`);
   const term = report.termination;
-  out.push(`runs ended: ${term.ended} reached the end, ${term.stalled} stalled, ${term.capped} hit the step cap, ${term.evalError} errored`);
+  out.push(`runs ended: ${term.ended} reached the end, ${term.stalled} stalled at a choice with nothing to pick, ${term.capped} hit the step limit, ${term.evalError} errored`);
   if (report.drivers.length) out.push(`input drivers: ${report.drivers.map((d) => d.ref).join(", ")}`);
   if (report.unwrittenInputs.length) {
     out.push(`? = gated on an input nothing writes/drives: ${report.unwrittenInputs.join(", ")} (add a coverage driver?)`);
@@ -1945,25 +1958,43 @@ function renderCoverageText(report, sceneName = (id) => id) {
       out.push(`  \u203C ${String(d.runs).padStart(6)} run(s)  ${sceneName(d.scene)}  choice '${d.id}'`);
     }
   }
+  if (!report.beats.length) return out;
+  const clip = (s, n = 48) => s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
+  const scenes = new Set(report.beats.map((b) => b.scene));
+  const heading2 = "     reached  played  beat";
+  const row = (b, withScene) => {
+    const mark = b.reachedRuns === 0 ? b.needsInput || b.blockedBy ? "? " : "\u203C " : b.rare ? "~ " : "  ";
+    const label = b.character ? `${b.character}: ${clip(b.preview)}` : clip(b.preview || `(${b.kind})`);
+    const where = withScene ? `[${sceneName(b.scene)}] ` : "";
+    out.push(`  ${mark}${pct(b.reachPct).padStart(6)}  ${String(b.hits).padStart(6)}  ${where}${label}`);
+    for (const bg of b.blockedBy ?? []) {
+      const names = bg.writers.map((w) => {
+        const target = report.beats.find((x) => x.id === w);
+        return target ? clip(target.preview || target.id, 28) : w;
+      });
+      out.push(`           gated on ${bg.ref}, written only by: ${names.join(", ")} (never played either)`);
+    }
+  };
+  out.push("");
+  out.push(`reached = share of runs that played the beat at least once; played = times it played in all runs`);
+  out.push(`\u203C never reached   ? never reached, may need an input   ~ rarely reached (under ${rareLimit}% of runs)`);
+  if (order === "least") {
+    out.push("");
+    out.push(`least reached first${scenes.size > 1 ? ", every scene" : ""}`);
+    out.push(heading2);
+    for (const b of leastReachedFirst(report.beats)) row(b, scenes.size > 1);
+    return out;
+  }
   const byScene = /* @__PURE__ */ new Map();
   for (const b of report.beats) (byScene.get(b.scene) ?? byScene.set(b.scene, []).get(b.scene)).push(b);
-  const clip = (s, n = 48) => s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
   for (const [scene, beats] of byScene) {
     const dead = beats.filter((b) => b.reachedRuns === 0).length;
+    const rare = beats.filter((b) => b.rare).length;
+    const notes = [dead ? `${dead} never reached` : "", rare ? `${rare} rarely reached` : ""].filter(Boolean).join(", ");
     out.push("");
-    out.push(`${sceneName(scene)}${dead ? `  (${dead} never reached)` : ""}`);
-    for (const b of beats) {
-      const mark = b.reachedRuns === 0 ? b.needsInput || b.blockedBy ? "? " : "\u203C " : "  ";
-      const label = b.character ? `${b.character}: ${clip(b.preview)}` : clip(b.preview || `(${b.kind})`);
-      out.push(`  ${mark}${b.reachPct.toFixed(0).padStart(3)}%  ${String(b.hits).padStart(6)}  ${label}`);
-      for (const bg of b.blockedBy ?? []) {
-        const names = bg.writers.map((w) => {
-          const target = report.beats.find((x) => x.id === w);
-          return target ? clip(target.preview || target.id, 28) : w;
-        });
-        out.push(`         gated on ${bg.ref}, written only by: ${names.join(", ")} (never played either)`);
-      }
-    }
+    out.push(`${sceneName(scene)}${notes ? `  (${notes})` : ""}`);
+    out.push(heading2);
+    for (const b of beats) row(b, false);
   }
   return out;
 }
@@ -2390,7 +2421,7 @@ function resolveDocumentation(loaded, channel) {
     const passed = visit(node.id, inherited);
     if (node.type === "group") {
       if (node.prompt) visit(node.prompt.id, passed);
-      for (const child of node.children ?? []) walkNode(child, passed);
+      for (const child2 of node.children ?? []) walkNode(child2, passed);
     } else {
       for (const beat of node.beats ?? []) visit(beat.id, passed);
     }
@@ -2399,7 +2430,7 @@ function resolveDocumentation(loaded, channel) {
     const sceneInh = visit(scene.id, []);
     for (const block of scene.blocks) {
       const blockInh = visit(block.id, sceneInh);
-      for (const child of block.children ?? []) walkNode(child, blockInh);
+      for (const child2 of block.children ?? []) walkNode(child2, blockInh);
     }
   }
   return out;
@@ -2768,7 +2799,7 @@ function runVoiceScript(loaded, opts = {}) {
       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);
+      for (const child2 of node.children ?? []) walkNode(child2, childScope, childVo);
       return;
     }
     if (cutSet.has(node.id)) return;
@@ -2798,7 +2829,7 @@ function runVoiceScript(loaded, opts = {}) {
       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);
+      for (const child2 of block.children ?? []) walkNode(child2, scope, blockVo);
     }
   }
   return { project: project.project.id, voiced: project.voiced ?? false, recordingLadder, everything, lines };
@@ -2838,6 +2869,7 @@ async function voiceScriptToXlsx(data) {
 }
 
 // src/script-doc.ts
+import { DEFAULT_DOCUMENTATION_CLASSES as DEFAULT_DOCUMENTATION_CLASSES3 } from "@patterkit/model";
 import { humanizeNodeRefs } from "@patterkit/core";
 var TOKENS = {
   ink: "26221c",
@@ -2943,10 +2975,12 @@ function sequenceLabel(node) {
   else if (ex === "stick") bits.push("holds on the last");
   return bits.length ? `In sequence \xB7 ${bits.join(", ")}` : "In sequence";
 }
-function runScriptDoc(loaded) {
+function runScriptDoc(loaded, opts = {}) {
   const { project } = loaded;
   const source = sourceStrings(loaded);
-  const { cut } = mergeAuthoring2(loaded);
+  const { cut, documentation } = mergeAuthoring2(loaded);
+  const noteClasses = opts.notes === void 0 || opts.notes === "all" ? void 0 : classesForChannel(project.documentationClasses ?? DEFAULT_DOCUMENTATION_CLASSES3, opts.notes.channel);
+  const ownNotes = (id) => opts.notes === void 0 ? [] : (documentation.get(id) ?? []).filter((l) => l.type !== void 0 && (noteClasses === void 0 || noteClasses.has(l.type)));
   const sceneOf = /* @__PURE__ */ new Map();
   const blockTrail = /* @__PURE__ */ new Map();
   const blockName = /* @__PURE__ */ new Map();
@@ -2960,6 +2994,9 @@ function runScriptDoc(loaded) {
   const humanize = (cond) => humanizeNodeRefs(cond, (id) => blockName.get(id) ?? sceneOf.get(id) ?? id);
   const els = [];
   const textOf = (id) => source[id] ?? "";
+  const notes = (id, indent, sid) => {
+    for (const l of ownNotes(id)) els.push({ kind: "note", id, indent, snippet: sid, text: l.text, class: l.type });
+  };
   const jumpText = (j) => {
     const dest = targetLabel(j.to, sceneOf, blockTrail);
     return j.mode === "call" ? `${dest} (and return)` : dest;
@@ -2969,34 +3006,44 @@ function runScriptDoc(loaded) {
   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 (beat.kind === "line") els.push({ kind: "line", id: beat.id, indent, snippet: sid, character: beat.character ?? "", direction: beat.direction, runs: textRuns(textOf(beat.id)) });
+      else if (beat.kind === "text") els.push({ kind: "narration", id: beat.id, indent, snippet: sid, runs: textRuns(textOf(beat.id)) });
+      else if (beat.kind === "gameEvent") els.push({ kind: "gameEvent", id: beat.id, indent, snippet: sid, text: gameEventLabel(beat) });
+      else continue;
+      notes(beat.id, indent, sid);
     }
-    if (node.jump) els.push({ kind: "jump", indent, snippet: sid, text: jumpText(node.jump) });
+    if (node.jump) els.push({ kind: "jump", id: node.id, to: node.jump.to, indent, snippet: sid, text: jumpText(node.jump) });
   };
   const walk = (node, indent, sid) => {
     if (cut.has(node.id)) return;
     if (node.type === "snippet") {
-      if (node.condition) els.push({ kind: "condition", indent, snippet: sid, text: `if ${humanize(node.condition)}` });
+      if (node.condition) els.push({ kind: "condition", id: node.id, indent, snippet: sid, text: `if ${humanize(node.condition)}` });
+      notes(node.id, indent, sid);
       emitBeats(node, indent, sid);
       return;
     }
-    if (node.condition) els.push({ kind: "condition", indent, snippet: sid, text: `if ${humanize(node.condition)}` });
+    if (node.condition) els.push({ kind: "condition", id: node.id, indent, snippet: sid, text: `if ${humanize(node.condition)}` });
+    if (node.selector === "choice" || node.selector === "branch" || node.selector === "sequence") {
+    } else notes(node.id, indent, sid);
     if (node.selector === "choice") {
-      els.push({ kind: "group", indent, label: "Choose" });
-      for (const child of node.children ?? []) {
-        if (cut.has(child.id)) continue;
+      els.push({ kind: "group", id: node.id, indent, label: "Choose" });
+      notes(node.id, indent, sid);
+      for (const child2 of node.children ?? []) {
+        if (cut.has(child2.id)) continue;
         const cid = nextSid();
-        if (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 ?? [];
+        if (child2.type === "group" && child2.prompt) {
+          if (child2.condition) els.push({ kind: "condition", id: child2.id, indent, snippet: cid, text: `if ${humanize(child2.condition)}` });
+          els.push({ kind: "option", id: child2.prompt.id, node: child2.id, indent, snippet: cid, runs: textRuns(textOf(child2.prompt.id) || "(option)"), tag: optionTag(child2) });
+          notes(child2.id, indent, cid);
+          notes(child2.prompt.id, indent, cid);
+          for (const c of child2.children ?? []) walk(c, indent + 1, cid);
+        } else if (child2.type === "snippet") {
+          const beats = child2.beats ?? [];
           const first = beats.find((b) => b.kind === "line" || b.kind === "text");
-          if (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) });
+          if (child2.condition) els.push({ kind: "condition", id: child2.id, indent, snippet: cid, text: `if ${humanize(child2.condition)}` });
+          els.push({ kind: "option", id: first?.id ?? child2.id, node: child2.id, indent, snippet: cid, runs: textRuns(first ? textOf(first.id) || "(option)" : "(option)"), tag: optionTag(child2) });
+          notes(child2.id, indent, cid);
+          if (first) notes(first.id, indent, cid);
           let seenPrompt = false;
           for (const beat of beats) {
             if (!seenPrompt && beat === first) {
@@ -3004,41 +3051,48 @@ function runScriptDoc(loaded) {
               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 (beat.kind === "line") els.push({ kind: "line", id: beat.id, 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", id: beat.id, indent: indent + 1, snippet: cid, runs: textRuns(textOf(beat.id)) });
+            else if (beat.kind === "gameEvent") els.push({ kind: "gameEvent", id: beat.id, indent: indent + 1, snippet: cid, text: gameEventLabel(beat) });
+            else continue;
+            notes(beat.id, indent + 1, cid);
           }
-          if (child.jump) els.push({ kind: "jump", indent: indent + 1, snippet: cid, text: jumpText(child.jump) });
+          if (child2.jump) els.push({ kind: "jump", id: child2.id, to: child2.jump.to, indent: indent + 1, snippet: cid, text: jumpText(child2.jump) });
         } else {
-          walk(child, indent + 1, cid);
+          walk(child2, 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());
+      els.push({ kind: "group", id: node.id, indent, label: "One of \xB7 first match wins" });
+      notes(node.id, indent, sid);
+      const kids2 = (node.children ?? []).filter((c) => !cut.has(c.id));
+      kids2.forEach((child2, i) => {
+        const isCatchAll = i === kids2.length - 1 && kids2.length > 1 && !("condition" in child2 && child2.condition);
+        if (isCatchAll) els.push({ kind: "else", id: child2.id, indent });
+        walk(child2, indent, nextSid());
       });
       return;
     }
     if (node.selector === "sequence") {
-      els.push({ kind: "group", indent, label: sequenceLabel(node) });
-      for (const child of node.children ?? []) walk(child, indent, nextSid());
+      els.push({ kind: "group", id: node.id, indent, label: sequenceLabel(node) });
+      notes(node.id, indent, sid);
+      for (const child2 of node.children ?? []) walk(child2, indent, nextSid());
       return;
     }
-    for (const child of node.children ?? []) walk(child, indent, sid);
+    for (const child2 of node.children ?? []) walk(child2, indent, sid);
   };
+  const only = opts.scenes ? new Set(opts.scenes) : void 0;
   for (const scene of loaded.scenes) {
-    if (cut.has(scene.id)) continue;
-    els.push({ kind: "scene", text: scene.name });
+    if (cut.has(scene.id) || only && !only.has(scene.id)) continue;
+    els.push({ kind: "scene", id: scene.id, text: scene.name });
+    notes(scene.id, 0, void 0);
     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);
+      els.push({ kind: "block", id: block.id, text: block.name });
+      notes(block.id, 0, void 0);
+      for (const child2 of block.children ?? []) walk(child2, 0, void 0);
     }
   }
   return { project: project.project.name, elements: els };
@@ -3047,8 +3101,8 @@ function runScriptDoc(loaded) {
 // 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 SANS = "Arial";
+var MONO = "Courier New";
 var STEP = 360;
 var SNIPPET_INSET = 220;
 var DIALOGUE_INDENT = 300;
@@ -3083,11 +3137,11 @@ function paragraph(el, prev) {
         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 });
+      const kids2 = [];
+      if (el.character) kids2.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) kids2.push(new TextRun({ text: `(${el.direction})  `, font: SERIF, italics: true, color: TOKENS.muted, size: S.body }));
+      kids2.push(...bodyRuns(el.runs, TOKENS.inkRead));
+      return new Paragraph({ keepLines: true, spacing: { before, after: 20 }, indent: { left: leftOf(el) + DIALOGUE_INDENT + HANG, hanging: HANG }, children: kids2 });
     }
     case "narration":
       return new Paragraph({ keepLines: true, spacing: { before, after: 20 }, indent: { left: leftOf(el) }, children: bodyRuns(el.runs, TOKENS.inkSoft) });
@@ -3098,14 +3152,16 @@ function paragraph(el, prev) {
     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 });
+      const kids2 = [new TextRun({ text: "\u25C7  ", color: TOKENS.accent, size: S.body }), ...bodyRuns(el.runs, TOKENS.ink)];
+      if (el.tag) kids2.push(new TextRun({ text: "	", size: S.body }), new TextRun({ text: el.tag, font: SANS, smallCaps: true, color: TOKENS.muted, size: S.tag }));
+      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: kids2 });
     }
     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 })] });
+    case "note":
+      return new Paragraph({ keepLines: true, spacing: { before: WITHIN, after: 20 }, indent: { left: leftOf(el) }, children: [new TextRun({ text: `Note: ${el.text}`, font: SERIF, italics: true, color: TOKENS.muted, size: S.cue })] });
   }
 }
 async function scriptToDocx(doc) {
@@ -3296,6 +3352,10 @@ async function scriptToPdf(doc) {
           else draw(pieces, cx, { width: pageRight - cx });
           break;
         }
+        case "note":
+          pdf.fontSize(9.5);
+          draw(split(`Note: ${el.text}`, "Serif-Italic", MUTED), cx, { width: w, lineGap: LEAD });
+          break;
       }
     };
     const leadOf = (k) => k === "scene" ? 24 : k === "block" ? 16 : k === "group" ? 13 : k === "else" ? 9 : 0;
@@ -3915,16 +3975,101 @@ function planPins(loaded) {
 
 // src/pack.ts
 import JSZip from "jszip";
-import { readFileSync as readFileSync6 } from "fs";
-import { dirname as dirname5, relative as relative3, sep as sep2 } from "path";
+import { readFileSync as readFileSync7 } from "fs";
+import { dirname as dirname5, join as join8, relative as relative3, sep as sep2 } from "path";
 import { parseSource as parseSource5 } from "@patterkit/core";
 import { ARCHIVE_ENTRY_OPTS } from "@wildwinter/toolkit/archive";
+
+// src/handoff.ts
+import { existsSync as existsSync4, readFileSync as readFileSync6 } from "fs";
+import { basename as basename7, join as join7 } from "path";
+import { HANDOFF_SCHEMA } from "@patterkit/model";
+var HANDOFF_DIR = "handoffs";
+var HANDOFF_EXT = ".json";
+function handoffPath(root, id) {
+  return join7(root, HANDOFF_DIR, `${id}${HANDOFF_EXT}`);
+}
+function serialiseHandoff(handoff) {
+  return JSON.stringify(handoff, null, 2) + "\n";
+}
+function handoffWrite(root, handoff) {
+  return { path: handoffPath(root, handoff.id), content: serialiseHandoff(handoff) };
+}
+function parseHandoff(text) {
+  const h = JSON.parse(text);
+  if (h.schema !== HANDOFF_SCHEMA) throw new Error(`not a handoff record (schema ${JSON.stringify(h.schema)})`);
+  if (typeof h.id !== "string" || !h.lines || !Array.isArray(h.skeleton)) throw new Error("handoff record is missing its id, lines, or skeleton");
+  return h;
+}
+function readHandoffs(root) {
+  const handoffs = [];
+  const issues = [];
+  for (const file of walkFiles(join7(root, HANDOFF_DIR), HANDOFF_EXT)) {
+    try {
+      handoffs.push(parseHandoff(readFileSync6(file, "utf8")));
+    } catch (e) {
+      issues.push({ file, message: `${basename7(file)}: ${e instanceof Error ? e.message : String(e)}` });
+    }
+  }
+  handoffs.sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
+  return { handoffs, issues };
+}
+function readHandoff(root, id) {
+  const path = handoffPath(root, id);
+  if (!existsSync4(path)) return void 0;
+  return parseHandoff(readFileSync6(path, "utf8"));
+}
+var ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+function checkChar(body) {
+  let sum = 0;
+  for (let i = 0; i < body.length; i++) sum += (i + 1) * ALPHABET.indexOf(body[i]);
+  return ALPHABET[sum % 31];
+}
+function randomBody(length, random) {
+  let s = "";
+  for (let i = 0; i < length; i++) s += ALPHABET[Math.floor(random() * ALPHABET.length)];
+  return s;
+}
+function markerLength(count) {
+  let length = 3;
+  while (ALPHABET.length ** length < Math.max(1, count) * 1e3) length++;
+  return length;
+}
+function issueMarkerCodes(count, random = Math.random) {
+  const length = markerLength(count);
+  const codes = /* @__PURE__ */ new Set();
+  while (codes.size < count) {
+    const body = randomBody(length, random);
+    codes.add(body + checkChar(body));
+  }
+  return [...codes];
+}
+function formatMarker(code) {
+  return `[#${code}]`;
+}
+function newHandoffId(taken = [], random = Math.random) {
+  const used = new Set(taken);
+  for (; ; ) {
+    const id = `H-${randomBody(4, random)}`;
+    if (!used.has(id)) return id;
+  }
+}
+function readMarker(text) {
+  const m = /\[\s*#?\s*([0-9A-Za-z]{2,9})\s*\]/.exec(text);
+  if (!m) return void 0;
+  const code = m[1].toUpperCase().replace(/O/g, "0").replace(/[IL]/g, "1");
+  if ([...code].some((c) => !ALPHABET.includes(c))) return { code, valid: false };
+  const body = code.slice(0, -1);
+  return { code, valid: body.length >= 2 && checkChar(body) === code.slice(-1) };
+}
+
+// src/pack.ts
 var SHARD_EXTENSIONS = [".patterflow", ".patterloc", ".patterx", ".patterproj"];
 var ENTRY_OPTS = ARCHIVE_ENTRY_OPTS;
 async function runPack(startPath) {
   const projectFile = findProjectFile(startPath);
   const root = dirname5(projectFile);
-  const project = parseSource5(readFileSync6(projectFile, "utf8"));
+  const project = parseSource5(readFileSync7(projectFile, "utf8"));
   const unresolved = sidecarIssues(walkFiles(root, CONFLICT_SIDECAR));
   if (unresolved.length) {
     throw new Error(
@@ -3934,23 +4079,32 @@ async function runPack(startPath) {
   }
   const files = SHARD_EXTENSIONS.flatMap((ext) => walkFiles(root, ext)).map((abs) => ({ abs, rel: relative3(root, abs).split(sep2).join("/") })).sort((a, b) => a.rel.localeCompare(b.rel));
   const scopes = gameScopesSnapshot(root, project);
+  const handoffs = walkFiles(join8(root, HANDOFF_DIR), ".json").map((abs) => ({ rel: relative3(root, abs).split(sep2).join("/"), text: readFileSync7(abs, "utf8") })).filter((f) => {
+    try {
+      return !parseHandoff(f.text).closed;
+    } catch {
+      return false;
+    }
+  });
   const manifest = {
     schema: "patter/document@0",
     project: { id: project.project.id, name: project.project.name },
     files: files.map((f) => f.rel),
-    ...scopes.length ? { gameScopes: scopes.map((f) => f.fileName) } : {}
+    ...scopes.length ? { gameScopes: scopes.map((f) => f.fileName) } : {},
+    ...handoffs.length ? { handoffs: handoffs.map((f) => f.rel) } : {}
   };
   const zip = new JSZip();
   zip.file("patter.manifest.json", JSON.stringify(manifest, null, 2) + "\n", ENTRY_OPTS);
-  for (const f of files) zip.file(f.rel, readFileSync6(f.abs, "utf8"), ENTRY_OPTS);
+  for (const f of files) zip.file(f.rel, readFileSync7(f.abs, "utf8"), ENTRY_OPTS);
   for (const f of scopes) zip.file(`${GAME_SCOPES_DIR}/${f.fileName}`, f.text, ENTRY_OPTS);
+  for (const f of handoffs) zip.file(f.rel, f.text, ENTRY_OPTS);
   return zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE", streamFiles: false });
 }
 
 // src/unpack.ts
 import JSZip2 from "jszip";
-import { join as join7, resolve as resolve5, sep as sep3 } from "path";
-import { existsSync as existsSync4, readFileSync as readFileSync7 } from "fs";
+import { join as join9, resolve as resolve5, sep as sep3 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync8 } from "fs";
 import { parseSource as parseSource6, canonicalStringify as canonicalStringify9 } from "@patterkit/core";
 import { isUnsafeEntry } from "@wildwinter/toolkit/archive";
 import { SCOPES_FILE_SUFFIX as SCOPES_FILE_SUFFIX2 } from "@wildwinter/scoperegistry/scopes";
@@ -3960,12 +4114,17 @@ var isScopesEntry = (name) => {
   const rest = name.startsWith(`${GAME_SCOPES_DIR}/`) ? name.slice(GAME_SCOPES_DIR.length + 1) : void 0;
   return rest !== void 0 && !rest.includes("/") && rest.endsWith(SCOPES_FILE_SUFFIX2);
 };
+var isHandoffEntry = (name) => {
+  const rest = name.startsWith(`${HANDOFF_DIR}/`) ? name.slice(HANDOFF_DIR.length + 1) : void 0;
+  return rest !== void 0 && !rest.includes("/") && rest.endsWith(".json");
+};
 var UnsafeEntryError = class extends Error {
 };
 async function readDoc(bytes) {
   const zip = await JSZip2.loadAsync(bytes);
   const shards = /* @__PURE__ */ new Map();
   const scopes = /* @__PURE__ */ new Map();
+  const handoffs = /* @__PURE__ */ new Map();
   let manifest;
   for (const [name, entry] of Object.entries(zip.files)) {
     if (entry.dir) continue;
@@ -3977,14 +4136,14 @@ async function readDoc(bytes) {
       continue;
     }
     if (isUnsafeEntry(name)) throw new UnsafeEntryError(`document entry escapes the target directory: ${name}`);
-    (isScopesEntry(name) ? scopes : shards).set(name, await entry.async("string"));
+    (isScopesEntry(name) ? scopes : isHandoffEntry(name) ? handoffs : shards).set(name, await entry.async("string"));
   }
-  return { shards, scopes, ...manifest ? { manifest } : {} };
+  return { shards, scopes, handoffs, ...manifest ? { manifest } : {} };
 }
 async function runUnpack(bytes, targetDir) {
   const doc = await readDoc(bytes);
   const plan = (entries) => [...entries.entries()].map(([name, content]) => ({ path: containedWrite(targetDir, name), content })).sort((a, b) => a.path.localeCompare(b.path));
-  return { shards: plan(doc.shards), scopes: plan(doc.scopes) };
+  return { shards: plan(new Map([...doc.shards, ...doc.handoffs])), scopes: plan(doc.scopes) };
 }
 function checkProvenance(returned, base, target) {
   const known = [returned, base, target].filter((id) => typeof id === "string" && id !== "");
@@ -3997,7 +4156,7 @@ function checkProvenance(returned, base, target) {
 }
 function targetProjectId(projectDir) {
   try {
-    const pf = parseSource6(readFileSync7(findProjectFile(projectDir), "utf8"));
+    const pf = parseSource6(readFileSync8(findProjectFile(projectDir), "utf8"));
     return pf.project?.id;
   } catch {
     return void 0;
@@ -4017,7 +4176,7 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
   let projectSides;
   for (const [rel, theirText] of [...theirs.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
     const outPath = containedWrite(projectDir, rel);
-    if (!existsSync4(outPath)) {
+    if (!existsSync5(outPath)) {
       writes.push({ path: outPath, content: theirText });
       shards.push({ path: rel, added: true });
       continue;
@@ -4029,7 +4188,7 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
         throw new Error(`${rel}: the ${side} copy is not readable Patter source - ${e instanceof Error ? e.message : String(e)}`);
       }
     };
-    const oursObj = readSide("ours", readFileSync7(outPath, "utf8"));
+    const oursObj = readSide("ours", readFileSync8(outPath, "utf8"));
     const theirsObj = readSide("theirs", theirText);
     const baseText = base.get(rel);
     const baseObj = baseText !== void 0 ? readSide("base", baseText) : {};
@@ -4046,15 +4205,38 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
     shards.push({ path: rel, result, added: false });
   }
   let gameScopes;
-  const local = projectSides && discoverGameScopes(resolve5(projectDir), projectSides.ours).gameScopes;
-  if (projectSides && local) {
-    const world = planReturnedWorld(projectSides.ours, projectSides.base, projectSides.theirs, projectSides.merged, local);
+  const local2 = projectSides && discoverGameScopes(resolve5(projectDir), projectSides.ours).gameScopes;
+  if (projectSides && local2) {
+    const world = planReturnedWorld(projectSides.ours, projectSides.base, projectSides.theirs, projectSides.merged, local2);
     if (world.write) {
       writes.push(world.write);
       gameScopes = { path: world.write.path };
-    } else if (world.error) gameScopes = { path: join7(local.dir, GAME_SCOPES_FILE), error: world.error };
+    } else if (world.error) gameScopes = { path: join9(local2.dir, GAME_SCOPES_FILE), error: world.error };
+  }
+  const handoffs = [];
+  for (const [rel, theirText] of [...returnedDoc.handoffs.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+    const outPath = containedWrite(projectDir, rel);
+    if (!existsSync5(outPath)) {
+      writes.push({ path: outPath, content: theirText });
+      handoffs.push(rel);
+      continue;
+    }
+    const merged = mergeHandoff(parseHandoff(readFileSync8(outPath, "utf8")), parseHandoff(theirText));
+    if (merged) {
+      writes.push({ path: outPath, content: serialiseHandoff(merged) });
+      handoffs.push(rel);
+    }
   }
-  return { shards, writes, sidecars, conflicts, warnings, provenance, ...gameScopes ? { gameScopes } : {} };
+  return { shards, writes, sidecars, conflicts, warnings, provenance, ...gameScopes ? { gameScopes } : {}, ...handoffs.length ? { handoffs } : {} };
+}
+function mergeHandoff(ours, theirs) {
+  const key = (i) => `${i.at}|${i.fileHash}`;
+  const known = new Set((ours.imports ?? []).map(key));
+  const added = (theirs.imports ?? []).filter((i) => !known.has(key(i)));
+  const closed = ours.closed === true || theirs.closed === true;
+  if (added.length === 0 && closed === (ours.closed === true)) return void 0;
+  const imports = [...ours.imports ?? [], ...added].sort((a, b) => a.at.localeCompare(b.at));
+  return { ...ours, ...imports.length ? { imports } : {}, ...closed ? { closed: true } : {} };
 }
 function projectEntry(shards) {
   const at = [...shards.keys()].filter((n) => !n.includes("/") && n.endsWith(".patterproj"));
@@ -4062,25 +4244,1117 @@ function projectEntry(shards) {
 }
 function containedWrite(dir, name) {
   const root = resolve5(dir);
-  const full = resolve5(join7(dir, name));
+  const full = resolve5(join9(dir, name));
   if (full !== root && !full.startsWith(root + sep3)) {
     throw new UnsafeEntryError(`document entry escapes the target directory: ${name}`);
   }
   return full;
 }
+
+// src/suggestions.ts
+import { readFileSync as readFileSync9 } from "fs";
+import { canonicalStringify as canonicalStringify10, parseSource as parseSource7 } from "@patterkit/core";
+import { walkNodes as walkNodes6 } from "@patterkit/model";
+function staleParts(s, liveText, line) {
+  const stale = [];
+  if (liveText !== s.baseline) stale.push("the text");
+  if (s.proposedCharacter !== void 0 && (line?.character ?? "") !== (s.baselineCharacter ?? "")) stale.push("the speaker");
+  if (s.proposedDirection !== void 0 && (line?.direction ?? "") !== (s.baselineDirection ?? "")) stale.push("the direction");
+  if ((s.proposedCharacter !== void 0 || s.proposedDirection !== void 0) && !line) stale.push("the line (no longer a spoken line)");
+  return stale;
+}
+function listOpenSuggestions(loaded, filter = {}) {
+  const places = indexPlaces(loaded);
+  const live = sourceStrings(loaded);
+  const sceneOrder = new Map(loaded.scenes.map((sc, i) => [sc.id, i]));
+  const out = [];
+  for (const af of loaded.authoring) {
+    for (const s of af.suggestions ?? []) {
+      if (s.resolved || filter.handoff && s.handoff?.id !== filter.handoff) continue;
+      const place = places.get(s.anchor);
+      const line = place?.beat?.kind === "line" ? place.beat : void 0;
+      out.push({ suggestion: s, ...place ? { sceneId: place.sceneId } : {}, stale: place ? staleParts(s, live[s.anchor] ?? "", line) : ["the line (no longer in the project)"] });
+    }
+  }
+  return out.sort((a, b) => (sceneOrder.get(a.sceneId ?? "") ?? 1e9) - (sceneOrder.get(b.sceneId ?? "") ?? 1e9) || a.suggestion.ts.localeCompare(b.suggestion.ts));
+}
+function indexPlaces(loaded) {
+  const places = /* @__PURE__ */ new Map();
+  for (const scene of loaded.scenes) {
+    places.set(scene.id, { sceneId: scene.id });
+    for (const block of scene.blocks) {
+      places.set(block.id, { sceneId: scene.id });
+      walkNodes6(block.children, (node) => {
+        places.set(node.id, { sceneId: scene.id });
+        if (node.type === "group") {
+          if (node.prompt) places.set(node.prompt.id, { sceneId: scene.id });
+          return;
+        }
+        for (const beat of node.beats ?? []) places.set(beat.id, { sceneId: scene.id, beat });
+      });
+    }
+  }
+  return places;
+}
+var Working = class {
+  constructor(loaded) {
+    this.loaded = loaded;
+  }
+  loaded;
+  authoring = /* @__PURE__ */ new Map();
+  locs = /* @__PURE__ */ new Map();
+  flows = /* @__PURE__ */ new Map();
+  touched = /* @__PURE__ */ new Set();
+  /** Mark a file as changed, so `writes` includes it. */
+  touch(path) {
+    this.touched.add(path);
+  }
+  /** A scene's authoring shard: the loaded one (copied), or a new one at the layout's path. */
+  authoringFor(path) {
+    let af = this.authoring.get(path);
+    if (!af) {
+      const i = this.loaded.authoringFiles.indexOf(path);
+      const existing = i >= 0 ? this.loaded.authoring[i] : void 0;
+      af = existing ? structuredClone(existing) : { schema: "patter/authoring@0" };
+      this.authoring.set(path, af);
+    }
+    return af;
+  }
+  /** A scene's default-locale strings shard, or undefined when it has none (no text to change). */
+  locFor(sceneId) {
+    const path = existingLocPath(this.loaded, sceneId, this.loaded.project.locales.default);
+    if (!path) return void 0;
+    let file = this.locs.get(path);
+    if (!file) {
+      const i = this.loaded.localeFiles.indexOf(path);
+      file = structuredClone(this.loaded.locales[i]);
+      this.locs.set(path, file);
+    }
+    return { path, file };
+  }
+  /** A scene's flow shard, read from disk for its envelope (as pin does), with the scene to edit. */
+  flowFor(sceneId) {
+    const path = this.loaded.sceneFiles[sceneId];
+    if (!path) return void 0;
+    let file = this.flows.get(path);
+    if (!file) {
+      const onDisk = parseSource7(readFileSync9(path, "utf8"));
+      const scene = this.loaded.scenes.find((s) => s.id === sceneId);
+      file = { ...onDisk, scene: structuredClone(scene ?? onDisk.scene) };
+      this.flows.set(path, file);
+    }
+    return { path, file };
+  }
+  writes() {
+    return [...this.locs, ...this.flows, ...this.authoring].filter(([path]) => this.touched.has(path)).map(([path, file]) => ({ path, content: canonicalStringify10(file) })).sort((a, b) => a.path.localeCompare(b.path));
+  }
+};
+function beatIn(scene, id) {
+  let found;
+  for (const block of scene.blocks) {
+    walkNodes6(block.children, (node) => {
+      if (found || node.type !== "snippet") return;
+      found = (node.beats ?? []).find((b) => b.id === id);
+    });
+  }
+  return found;
+}
+function applySuggestionDecisions(loaded, decisions, opts = {}) {
+  const now = opts.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const places = indexPlaces(loaded);
+  const work = new Working(loaded);
+  const holder = /* @__PURE__ */ new Map();
+  loaded.authoring.forEach((af, i) => {
+    for (const s of af.suggestions ?? []) holder.set(s.id, loaded.authoringFiles[i]);
+  });
+  const results = [];
+  for (const d of decisions) {
+    const path = holder.get(d.id);
+    const s = path ? work.authoringFor(path).suggestions?.find((x) => x.id === d.id) : void 0;
+    if (!path || !s) {
+      results.push({ id: d.id, outcome: "missing", reason: "no suggestion with this id" });
+      continue;
+    }
+    if (s.resolved) {
+      results.push({ id: d.id, outcome: "resolved-already" });
+      continue;
+    }
+    if (!d.accept) {
+      s.resolved = true;
+      s.outcome = "rejected";
+      work.touch(path);
+      results.push({ id: d.id, outcome: "rejected" });
+      continue;
+    }
+    const place = places.get(s.anchor);
+    if (!place) {
+      results.push({ id: d.id, outcome: "missing", reason: "its line is no longer in the project" });
+      continue;
+    }
+    const loc = work.locFor(place.sceneId);
+    const flow = work.flowFor(place.sceneId);
+    const beat = flow ? beatIn(flow.file.scene, s.anchor) : void 0;
+    const line = beat?.kind === "line" ? beat : void 0;
+    const liveText = loc?.file.strings[s.anchor] ?? "";
+    const stale = staleParts(s, liveText, line);
+    if (stale.length) {
+      results.push({ id: d.id, outcome: "stale", reason: `${stale.join(" and ")} changed since this was suggested` });
+      continue;
+    }
+    const aPath = authoringPath(loaded, place.sceneId);
+    const sceneAuthoring = work.authoringFor(aPath);
+    let edited = false;
+    if (loc && s.proposed !== liveText) {
+      loc.file.strings[s.anchor] = s.proposed;
+      work.touch(loc.path);
+      sceneAuthoring.edits = { ...sceneAuthoring.edits, [s.anchor]: { ...sceneAuthoring.edits?.[s.anchor], modifiedAt: now } };
+      edited = true;
+    }
+    if (line && flow && s.proposedCharacter !== void 0 && s.proposedCharacter !== (line.character ?? "")) {
+      line.character = s.proposedCharacter;
+      work.touch(flow.path);
+      edited = true;
+    }
+    if (line && flow && s.proposedDirection !== void 0 && s.proposedDirection !== (line.direction ?? "")) {
+      if (s.proposedDirection === "") delete line.direction;
+      else line.direction = s.proposedDirection;
+      work.touch(flow.path);
+      edited = true;
+    }
+    if (s.proposedCut) {
+      sceneAuthoring.cut = { ...sceneAuthoring.cut, [s.anchor]: true };
+      edited = true;
+    }
+    if (edited && opts.by) sceneAuthoring.edits = { ...sceneAuthoring.edits, [place.sceneId]: { ...sceneAuthoring.edits?.[place.sceneId], modifiedAt: now, by: opts.by } };
+    if (edited) work.touch(aPath);
+    s.resolved = true;
+    s.outcome = "accepted";
+    work.touch(path);
+    results.push({ id: d.id, outcome: "accepted" });
+  }
+  return { writes: work.writes(), results };
+}
+function setCut(loaded, ids, cut) {
+  const places = indexPlaces(loaded);
+  const work = new Working(loaded);
+  const unknown = [];
+  for (const id of ids) {
+    const place = places.get(id);
+    if (!place) {
+      unknown.push(id);
+      continue;
+    }
+    const aPath = authoringPath(loaded, place.sceneId);
+    const af = work.authoringFor(aPath);
+    if (af.cut?.[id] === true === cut) continue;
+    const next = { ...af.cut };
+    if (cut) next[id] = true;
+    else delete next[id];
+    if (Object.keys(next).length) af.cut = next;
+    else delete af.cut;
+    work.touch(aPath);
+  }
+  return { writes: work.writes(), unknown };
+}
+
+// src/editable-docx.ts
+import JSZip3 from "jszip";
+import {
+  AlignmentType as AlignmentType2,
+  BorderStyle as BorderStyle2,
+  Bookmark,
+  Document as Document2,
+  Header,
+  HeadingLevel as HeadingLevel2,
+  InternalHyperlink,
+  Packer as Packer2,
+  PageBreak,
+  Paragraph as Paragraph2,
+  ShadingType,
+  Table,
+  TableCell,
+  TableLayoutType,
+  TableRow,
+  TextRun as TextRun2,
+  WidthType
+} from "docx";
+import { HANDOFF_SCHEMA as HANDOFF_SCHEMA2 } from "@patterkit/model";
+var FULL = 9020;
+var LEAD2 = 1700;
+var MARGIN2 = 1500;
+var MIN_TEXT = 3e3;
+var BOX_FILL = "f7f2e8";
+var BOX_EDGE = "d9cfbd";
+var MARKER_INK = "a8a196";
+var NONE = { style: BorderStyle2.NONE, size: 0, color: "FFFFFF" };
+var HAIR = { style: BorderStyle2.SINGLE, size: 4, color: BOX_EDGE };
+var isEditable = (el) => el.kind === "line" || el.kind === "narration" || el.kind === "option";
+var bookmarkName = (id) => `pk_${id.replace(/[^A-Za-z0-9_]/g, "_")}`.slice(0, 40);
+async function exportEditableScript(loaded, opts) {
+  const now = opts.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const random = opts.random ?? Math.random;
+  const notes = opts.notes ?? "editor";
+  const doc = runScriptDoc(loaded, { ...opts.scenes ? { scenes: opts.scenes } : {}, notes: notes === "all" ? "all" : { channel: "editor" } });
+  const { writing } = mergeAuthoring2(loaded);
+  const source = sourceStrings(loaded);
+  const editable = doc.elements.filter(isEditable);
+  const codes = issueMarkerCodes(editable.length, random);
+  const markerOf = new Map(editable.map((el, i) => [el, codes[i]]));
+  const id = newHandoffId(readHandoffs(loaded.root).handoffs.map((h) => h.id), random);
+  const lines = {};
+  const skeleton = [];
+  for (const el of doc.elements) {
+    if (isEditable(el)) {
+      const code = markerOf.get(el);
+      const baseline = source[el.id] ?? "";
+      lines[code] = el.kind === "line" ? { id: el.id, kind: "line", character: el.character, ...el.direction ? { direction: el.direction } : {}, baseline } : { id: el.id, kind: el.kind === "option" ? "option" : "narration", baseline };
+      skeleton.push({ kind: "box", marker: code });
+    } else {
+      skeleton.push({ kind: el.kind, node: el.id, text: contextText(el) });
+    }
+  }
+  const scenes = [...new Set(doc.elements.filter((e) => e.kind === "scene").map((e) => e.id))];
+  const handoff = {
+    schema: HANDOFF_SCHEMA2,
+    id,
+    createdAt: now,
+    createdBy: opts.by,
+    format: "docx",
+    ...opts.recipient ? { recipient: opts.recipient } : {},
+    range: { scenes },
+    options: { notes, status: opts.status === true, cast: opts.cast === true },
+    lines,
+    skeleton
+  };
+  const inExport = new Set(doc.elements.filter((e) => e.kind === "scene" || e.kind === "block").map((e) => e.id));
+  const targets = new Set(doc.elements.filter((e) => e.kind === "jump").map((e) => e.to).filter((t) => inExport.has(t)));
+  const body = [...frontPage(loaded, handoff, opts, now), ...opts.cast ? castPage(loaded, doc.elements) : []];
+  doc.elements.forEach((el, i) => {
+    const prev = doc.elements[i - 1];
+    if (isEditable(el)) {
+      if (prev && isEditable(prev)) body.push(spacer());
+      body.push(box(el, markerOf.get(el), opts.status ? writing.get(el.id) : void 0));
+    } else if ((el.kind === "scene" || el.kind === "block") && targets.has(el.id)) {
+      body.push(heading(el, true));
+    } else if (el.kind === "scene" || el.kind === "block") {
+      body.push(heading(el, false));
+    } else if (el.kind === "jump") {
+      body.push(jump(el, targets.has(el.to)));
+    } else {
+      body.push(paragraph(el, prev));
+    }
+  });
+  const date = new Date(now).toLocaleDateString("en-GB", { day: "numeric", month: "short", year: "numeric", timeZone: "UTC" });
+  const document = new Document2({
+    creator: "Patter",
+    title: `${loaded.project.project.name} (editable script)`,
+    sections: [{
+      properties: { page: { size: { width: 11906, height: 16838 } } },
+      headers: { default: new Header({ children: [new Paragraph2({ children: [
+        new TextRun2({ text: `${loaded.project.project.name} \xB7 Editable script \xB7 Handoff ${id} \xB7 exported ${date} \xB7 Please keep the grey [#\u2026] markers`, font: SANS, size: 15, color: TOKENS.muted })
+      ] })] }) },
+      children: body
+    }]
+  });
+  const docx = await renumberBookmarks(await Packer2.toBuffer(document));
+  return { docx, handoff, writes: [handoffWrite(loaded.root, handoff)] };
+}
+function contextText(el) {
+  switch (el.kind) {
+    case "group":
+      return el.label;
+    case "else":
+      return "else \xB7 catch-all";
+    default:
+      return el.text;
+  }
+}
+function box(el, code, status) {
+  const ind = leftOf(el);
+  const textW = Math.max(MIN_TEXT, FULL - ind - LEAD2 - MARGIN2);
+  const cell = (children, width, extra = {}) => new TableCell({ width: { size: width, type: WidthType.DXA }, borders: { top: NONE, bottom: NONE, left: NONE, right: NONE }, margins: { top: 60, bottom: 60, left: 100, right: 100 }, children, ...extra });
+  const lead = [];
+  if (el.kind === "line" && el.character) lead.push(new TextRun2({ text: el.character.toUpperCase(), font: SANS, bold: true, allCaps: true, size: S.cue, color: characterColour(el.character) }));
+  if (el.kind === "line" && el.direction) lead.push(new TextRun2({ text: `(${el.direction})`, font: SERIF, italics: true, size: S.cue, color: TOKENS.muted, break: el.character ? 1 : 0 }));
+  if (el.kind === "option") lead.push(new TextRun2({ text: "\u25C7", color: TOKENS.accent, size: S.body }));
+  const ink = el.kind === "narration" ? TOKENS.inkSoft : el.kind === "option" ? TOKENS.ink : TOKENS.inkRead;
+  const margin = [];
+  if (el.kind === "option" && el.tag) margin.push(new TextRun2({ text: `${el.tag}  `, font: SANS, smallCaps: true, size: S.tag, color: TOKENS.muted }));
+  if (status) margin.push(new TextRun2({ text: `${status}  `, font: SANS, smallCaps: true, size: S.tag, color: TOKENS.muted }));
+  margin.push(new TextRun2({ text: formatMarker(code), font: MONO, size: 14, color: MARKER_INK }));
+  const narration = el.kind === "narration";
+  const wordsW = narration ? LEAD2 + textW : textW;
+  const words = cell(
+    [new Paragraph2({ children: bodyRuns(el.runs, ink) })],
+    wordsW,
+    { shading: { type: ShadingType.CLEAR, fill: BOX_FILL, color: "auto" }, borders: { top: HAIR, bottom: HAIR, left: HAIR, right: HAIR } }
+  );
+  const marginCell = cell([new Paragraph2({ alignment: AlignmentType2.RIGHT, children: margin })], MARGIN2);
+  return new Table({
+    layout: TableLayoutType.FIXED,
+    indent: { size: ind, type: WidthType.DXA },
+    width: { size: LEAD2 + textW + MARGIN2, type: WidthType.DXA },
+    columnWidths: narration ? [wordsW, MARGIN2] : [LEAD2, textW, MARGIN2],
+    borders: { top: NONE, bottom: NONE, left: NONE, right: NONE, insideHorizontal: NONE, insideVertical: NONE },
+    rows: [new TableRow({ cantSplit: true, children: narration ? [words, marginCell] : [cell([new Paragraph2({ alignment: AlignmentType2.RIGHT, children: lead })], LEAD2), words, marginCell] })]
+  });
+}
+function spacer() {
+  return new Paragraph2({ spacing: { before: 0, after: 0, line: 20, lineRule: "exact" }, children: [new TextRun2({ text: "", size: 2 })] });
+}
+function heading(el, bookmarked) {
+  const scene = el.kind === "scene";
+  const text = new TextRun2({ text: el.text, font: SERIF, bold: true, color: TOKENS.ink, size: scene ? S.h1 : S.h2 });
+  return new Paragraph2({
+    heading: scene ? HeadingLevel2.HEADING_1 : HeadingLevel2.HEADING_2,
+    keepNext: true,
+    spacing: scene ? { before: 480, after: 200 } : { before: 360, after: 160 },
+    border: { bottom: scene ? { style: BorderStyle2.SINGLE, size: 14, color: TOKENS.accent, space: 6 } : { style: BorderStyle2.SINGLE, size: 4, color: TOKENS.line, space: 4 } },
+    children: [bookmarked ? new Bookmark({ id: bookmarkName(el.id), children: [text] }) : text]
+  });
+}
+function jump(el, linked) {
+  const run = (text) => new TextRun2({ text, font: SANS, bold: true, color: TOKENS.accent, size: S.mech });
+  const label = `\u21AA  ${el.text}`;
+  return new Paragraph2({
+    keepLines: true,
+    alignment: AlignmentType2.RIGHT,
+    spacing: { before: 40, after: 40 },
+    children: linked ? [new InternalHyperlink({ anchor: bookmarkName(el.to), children: [run(label)] })] : [run(el.to === "END" ? label : `${label} (not in this document)`)]
+  });
+}
+function frontPage(loaded, handoff, opts, now) {
+  const p = (text, o = {}) => new Paragraph2({ spacing: { before: o.before ?? 0, after: o.after ?? 100 }, children: [new TextRun2({ text, font: SERIF, size: o.size ?? 21, bold: o.bold, color: o.color ?? TOKENS.inkRead })] });
+  const item = (lead, text) => new Paragraph2({
+    spacing: { after: 80 },
+    children: [new TextRun2({ text: `${lead}\xA0\xA0`, font: SERIF, size: 21, color: TOKENS.accent }), new TextRun2({ text, font: SERIF, size: 21, color: TOKENS.inkRead })]
+  });
+  const date = new Date(now).toLocaleDateString("en-GB", { day: "numeric", month: "long", year: "numeric", timeZone: "UTC" });
+  const sentTo = handoff.recipient ? ` for ${handoff.recipient}` : "";
+  return [
+    new Paragraph2({ spacing: { after: 120 }, children: [new TextRun2({ text: "Editable script", font: SANS, bold: true, allCaps: true, color: TOKENS.accent, size: 16, characterSpacing: 30 })] }),
+    new Paragraph2({ spacing: { after: 240 }, children: [new TextRun2({ text: loaded.project.project.name, font: SERIF, bold: true, color: TOKENS.ink, size: 52 })] }),
+    p(`Exported${sentTo} by ${opts.by} on ${date}. Handoff ${handoff.id}.`, { color: TOKENS.muted, after: 360 }),
+    p("How to edit this script", { bold: true, size: 24, color: TOKENS.ink, after: 120 }),
+    item("1.", "Change the words inside the shaded boxes. That's all that can be edited."),
+    item("2.", "Don't delete, copy, or move the boxes, or change the grey markers like [#K7Q2M] beside them. If you want a line cut, delete its words but leave the box, or leave a comment."),
+    item("3.", "Everything outside the boxes (scene and block headings, speaker names, conditions, choices, jumps, and game events) is there to show you how the story flows. Comment on it rather than editing it."),
+    item("4.", "Use comments freely. You can also type a note inside a box like [[this]]."),
+    p("How to read the structure", { bold: true, size: 24, color: TOKENS.ink, before: 280, after: 120 }),
+    item("CHOOSE", "The player picks one of the options marked \u25C7."),
+    item("ONE OF", "The first row whose condition holds is the one used."),
+    item("IN SEQUENCE", "A different row each time the story reaches this point."),
+    item("\u2039 if \u2026 \u203A", "This only happens when the condition holds."),
+    item("\u21AA", "The story carries on somewhere else."),
+    item("\u2699", "Something happens in the game here."),
+    item("once only", "An option that disappears once it has been picked; repeatable ones stay."),
+    p("Words like {@name} in a different typeface are filled in by the game. Keep them exactly as they are, braces included, though they can move within a line.", { before: 160 }),
+    new Paragraph2({ children: [new PageBreak()] })
+  ];
+}
+function castPage(loaded, elements) {
+  const speaking = new Set(elements.filter((e) => e.kind === "line").map((e) => e.character).filter(Boolean));
+  const cast = (loaded.project.cast ?? []).filter((c) => speaking.has(c.name));
+  if (!cast.length) return [];
+  return [
+    new Paragraph2({ spacing: { after: 200 }, children: [new TextRun2({ text: "Cast", font: SERIF, bold: true, size: S.h1, color: TOKENS.ink })] }),
+    ...cast.map((c) => new Paragraph2({ spacing: { after: 100 }, children: [
+      new TextRun2({ text: c.name.toUpperCase(), font: SANS, bold: true, size: S.cue, color: characterColour(c.name) }),
+      ...c.notes ? [new TextRun2({ text: `   ${c.notes}`, font: SERIF, size: S.body, color: TOKENS.inkRead })] : []
+    ] })),
+    new Paragraph2({ children: [new PageBreak()] })
+  ];
+}
+async function renumberBookmarks(buffer) {
+  const zip = await JSZip3.loadAsync(buffer);
+  const file = zip.file("word/document.xml");
+  if (!file) return buffer;
+  let next = 0, open = 0;
+  const xml = (await file.async("string")).replace(/<w:bookmarkStart\b([^>]*?)w:id="\d+"([^>]*)\/>|<w:bookmarkEnd w:id="\d+"\/>/g, (m, a, b) => {
+    if (m.startsWith("<w:bookmarkStart")) {
+      open = ++next;
+      return `<w:bookmarkStart${a}w:id="${open}"${b}/>`;
+    }
+    return `<w:bookmarkEnd w:id="${open}"/>`;
+  });
+  zip.file("word/document.xml", xml);
+  return zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE" });
+}
+
+// src/docx-read.ts
+import JSZip4 from "jszip";
+import { DOMParser } from "@xmldom/xmldom";
+var W = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+var isEl = (n) => !!n && n.nodeType === 1;
+var kids = (n) => {
+  const out = [];
+  for (let c = n.firstChild; c; c = c.nextSibling) if (isEl(c)) out.push(c);
+  return out;
+};
+var local = (e) => e.localName ?? e.nodeName.replace(/^.*:/, "");
+var attr = (e, name) => {
+  if (!e) return void 0;
+  return e.getAttributeNS(W, name) || e.getAttribute(`w:${name}`) || void 0;
+};
+var child = (e, name) => kids(e).find((c) => local(c) === name);
+var on = (rPr, name) => {
+  const p = rPr ? child(rPr, name) : void 0;
+  if (!p) return false;
+  const v = attr(p, "val");
+  return v === void 0 || !["false", "0", "off", "none"].includes(v);
+};
+var DROPPED = /* @__PURE__ */ new Set(["color", "highlight", "u", "strike", "dstrike", "shd", "caps", "smallCaps", "vertAlign"]);
+var OWN_COLOURS = new Set([...Object.values(TOKENS), ...CHAR_PALETTE, MARKER_INK, BOX_FILL, "000000", "auto"].map((c) => c.toLowerCase()));
+function addedFormatting(p) {
+  const name = local(p);
+  if (!DROPPED.has(name)) return false;
+  const val = (attr(p, "val") ?? "").toLowerCase();
+  if (val === "none" || val === "false" || val === "0") return false;
+  if (name === "u" && !val) return false;
+  if (name === "color") return !OWN_COLOURS.has(val || "auto");
+  if (name === "shd") return !OWN_COLOURS.has((attr(p, "fill") ?? "auto").toLowerCase());
+  if (name === "smallCaps" || name === "caps") return false;
+  return true;
+}
+var Collector = class {
+  pieces = [];
+  changes = [];
+  comments = [];
+  dropped = 0;
+  walk(node, view, change) {
+    for (const e of kids(node)) {
+      switch (local(e)) {
+        case "r":
+          this.run(e, view, change);
+          break;
+        case "ins":
+          this.tracked(e, "insert", "proposed");
+          break;
+        case "del":
+          this.tracked(e, "delete", "original");
+          break;
+        case "moveTo":
+          this.tracked(e, "moveTo", "proposed");
+          break;
+        case "moveFrom":
+          this.tracked(e, "moveFrom", "original");
+          break;
+        case "commentRangeStart": {
+          const id = attr(e, "id");
+          if (id !== void 0) this.comment(id);
+          break;
+        }
+        case "pPr":
+        case "rPr":
+        case "bookmarkStart":
+        case "bookmarkEnd":
+        case "commentRangeEnd":
+        case "proofErr":
+          break;
+        default:
+          this.walk(e, view, change);
+      }
+    }
+  }
+  tracked(e, kind, view) {
+    const change = { kind, author: attr(e, "author") ?? "", ...attr(e, "date") ? { date: attr(e, "date") } : {}, text: "" };
+    this.changes.push(change);
+    this.walk(e, view, change);
+  }
+  run(r, view, change) {
+    const rPr = child(r, "rPr");
+    const bold = on(rPr, "b"), italic = on(rPr, "i");
+    if (rPr && kids(rPr).some(addedFormatting)) this.dropped++;
+    for (const e of kids(r)) {
+      const name = local(e);
+      let text;
+      if (name === "t" || name === "delText") text = e.textContent ?? "";
+      else if (name === "tab") text = "	";
+      else if (name === "br" || name === "cr") text = "\n";
+      else if (name === "commentReference") {
+        const id = attr(e, "id");
+        if (id !== void 0) this.comment(id);
+      }
+      if (text === void 0) continue;
+      this.pieces.push({ text, bold, italic, view });
+      if (change) change.text += text;
+    }
+  }
+  comment(id) {
+    if (!this.comments.includes(id)) this.comments.push(id);
+  }
+  /** One view's text, adjacent same-format pieces merged, bold / italic as Patter markup. */
+  text(view) {
+    let out = "", open = "";
+    for (const p of this.pieces) {
+      if (p.view !== "both" && p.view !== view) continue;
+      const tag = p.bold && p.italic ? "bi" : p.bold ? "b" : p.italic ? "i" : "";
+      if (tag !== open) {
+        if (open) out += `</${open}>`;
+        if (tag) out += `<${tag}>`;
+        open = tag;
+      }
+      out += p.text;
+    }
+    if (open) out += `</${open}>`;
+    return out;
+  }
+  read() {
+    return { proposed: this.text("proposed"), original: this.text("original"), changes: this.changes, comments: this.comments, droppedFormatting: this.dropped };
+  }
+};
+function readParagraphs(ps, joiner) {
+  const parts = ps.map((p) => {
+    const c = new Collector();
+    c.walk(p, "both");
+    return c;
+  });
+  const join10 = (view) => parts.map((c) => c.text(view)).filter((t) => t !== "").join(joiner);
+  return {
+    text: {
+      proposed: join10("proposed"),
+      original: join10("original"),
+      changes: parts.flatMap((c) => c.changes),
+      comments: [...new Set(parts.flatMap((c) => c.comments))],
+      droppedFormatting: parts.reduce((n, c) => n + c.dropped, 0)
+    },
+    paragraphs: ps.length
+  };
+}
+function paragraphsIn(node) {
+  const out = [];
+  const visit = (n) => {
+    for (const c of kids(n)) {
+      if (local(c) === "p") out.push(c);
+      else if (local(c) !== "tbl") visit(c);
+    }
+  };
+  visit(node);
+  return out;
+}
+function plain(t) {
+  const strip = (s) => s.replace(/<\/?(?:b|i|bi)>/g, "");
+  return { ...t, proposed: strip(t.proposed), original: strip(t.original) };
+}
+function readRow(tr, indent) {
+  const cells = kids(tr).filter((c) => local(c) === "tc");
+  const cellText = (tc, joiner = " ") => readParagraphs(tc ? paragraphsIn(tc) : [], joiner);
+  const last = cellText(cells[cells.length - 1]);
+  const found = readMarker(last.text.proposed);
+  const recovered = found ? void 0 : readMarker(last.text.original);
+  const marker = found ?? (recovered ? { ...recovered, recovered: true } : void 0);
+  if (cells.length < 2 || !marker) {
+    return { kind: "table", text: readParagraphs(cells.flatMap(paragraphsIn), " ").text };
+  }
+  const words = cellText(cells.length >= 3 ? cells[1] : cells[0]);
+  const trPr = child(tr, "trPr");
+  return {
+    kind: "box",
+    marker,
+    text: words.text,
+    paragraphs: words.paragraphs,
+    lead: plain(cells.length >= 3 ? cellText(cells[0], "\n").text : readParagraphs([], " ").text),
+    margin: plain(last.text),
+    rowDeleted: !!(trPr && child(trPr, "del")),
+    ...indent !== void 0 ? { indent } : {}
+  };
+}
+function readBody(body) {
+  const items = [];
+  for (const e of kids(body)) {
+    const name = local(e);
+    if (name === "p") {
+      const c = new Collector();
+      c.walk(e, "both");
+      const style = attr(child(child(e, "pPr") ?? e, "pStyle"), "val");
+      items.push({ kind: "paragraph", text: c.read(), ...style ? { style } : {} });
+    } else if (name === "tbl") {
+      const tblPr = child(e, "tblPr");
+      const ind = tblPr ? attr(child(tblPr, "tblInd"), "w") : void 0;
+      const indent = ind !== void 0 && ind !== "" && Number.isFinite(Number(ind)) ? Number(ind) : void 0;
+      for (const tr of kids(e).filter((c) => local(c) === "tr")) items.push(readRow(tr, indent));
+    } else if (name === "sdt") {
+      const content = child(e, "sdtContent");
+      if (content) items.push(...readBody(content));
+    }
+  }
+  return items;
+}
+function readComments(commentsXml, extendedXml) {
+  if (!commentsXml) return [];
+  const doc = new DOMParser().parseFromString(commentsXml, "text/xml");
+  const all = [];
+  for (const c of kids(doc.documentElement).filter((e) => local(e) === "comment")) {
+    const ps = paragraphsIn(c);
+    all.push({
+      id: attr(c, "id") ?? "",
+      author: attr(c, "author") ?? "",
+      ...attr(c, "date") ? { date: attr(c, "date") } : {},
+      text: readParagraphs(ps, "\n").text.proposed.replace(/<\/?(b|i|bi)>/g, ""),
+      replies: [],
+      paraIds: ps.map((p) => p.getAttribute("w14:paraId") ?? "").filter(Boolean)
+    });
+  }
+  const parentOf = /* @__PURE__ */ new Map();
+  if (extendedXml) {
+    const ext = new DOMParser().parseFromString(extendedXml, "text/xml");
+    for (const e of kids(ext.documentElement)) {
+      const id = e.getAttribute("w15:paraId"), parent = e.getAttribute("w15:paraIdParent");
+      if (id && parent) parentOf.set(id, parent);
+    }
+  }
+  const byPara = /* @__PURE__ */ new Map();
+  for (const c of all) for (const p of c.paraIds) byPara.set(p, c);
+  const top = [];
+  for (const c of all) {
+    const parentPara = c.paraIds.map((p) => parentOf.get(p)).find(Boolean);
+    const parent = parentPara ? byPara.get(parentPara) : void 0;
+    if (parent && parent !== c) parent.replies.push({ author: c.author, ...c.date ? { date: c.date } : {}, text: c.text });
+    else top.push(c);
+  }
+  return top.map(({ paraIds: _p, ...c }) => c);
+}
+var HANDOFF_ID = /Handoff (H-[0-9A-Z]{4})\b/;
+async function readEditableDocx(bytes) {
+  const zip = await JSZip4.loadAsync(bytes);
+  const text = async (path) => zip.file(path)?.async("string");
+  const documentXml = await text("word/document.xml");
+  if (!documentXml) throw new Error("not a Word document (no word/document.xml)");
+  const doc = new DOMParser().parseFromString(documentXml, "text/xml");
+  const body = kids(doc.documentElement).find((e) => local(e) === "body");
+  const items = body ? readBody(body) : [];
+  let handoffId;
+  for (const name of Object.keys(zip.files).filter((n) => /^word\/header\d*\.xml$/.test(n)).sort()) {
+    const h = new DOMParser().parseFromString(await text(name), "text/xml");
+    const m = HANDOFF_ID.exec(h.documentElement?.textContent ?? "");
+    if (m) {
+      handoffId = m[1];
+      break;
+    }
+  }
+  if (!handoffId) {
+    for (const it of items.slice(0, 12)) {
+      const m = HANDOFF_ID.exec(it.text.proposed);
+      if (m) {
+        handoffId = m[1];
+        break;
+      }
+    }
+  }
+  const comments = readComments(await text("word/comments.xml"), await text("word/commentsExtended.xml"));
+  return { ...handoffId ? { handoffId } : {}, items, comments };
+}
+
+// src/editable-import.ts
+import { canonicalStringify as canonicalStringify11 } from "@patterkit/core";
+var REFUSE_MISSING_SHARE = 0.25;
+var tidy = (s) => s.replace(/[\s   ]+/g, " ").trim();
+function normalise(s, strictQuotes) {
+  const t = tidy(s);
+  return strictQuotes ? t : t.replace(/[‘’‚′]/g, "'").replace(/[“”„″]/g, '"').replace(/…/g, "...");
+}
+var placeholders = (s) => [...s.matchAll(/\{@[^}]*\}/g)].map((m) => m[0]).sort();
+var sameList = (a, b) => a.length === b.length && a.every((x, i) => x === b[i]);
+function takeNotes(text, baseline) {
+  const notes = [];
+  const out = text.replace(/\[\[([\s\S]*?)\]\]/g, (whole, note) => {
+    if (baseline.includes(whole)) return whole;
+    if (note.trim()) notes.push(note.trim());
+    return " ";
+  });
+  return { text: notes.length ? tidy(out) : out, notes };
+}
+var plainText = (s) => s.replace(/<\/?(?:b|i|bi)>/g, "");
+var quote = (s) => `\u201C${plainText(tidy(s))}\u201D`;
+function shownAs(row) {
+  switch (row.kind) {
+    case "condition":
+      return [`\u2039 ${row.text} \u203A`];
+    case "jump":
+      return [`\u21AA ${row.text}`, `\u21AA ${row.text} (not in this document)`];
+    case "gameEvent":
+      return [`\u2699 ${row.text}`];
+    case "note":
+      return [`Note: ${row.text}`];
+    default:
+      return [row.text];
+  }
+}
+var loose = (s) => tidy(plainText(s)).toLowerCase();
+function planEditableImport(loaded, returned, opts) {
+  const now = opts.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const random = opts.random ?? Math.random;
+  const rid = (prefix) => `${prefix}_${Array.from({ length: 8 }, () => "abcdefghijklmnopqrstuvwxyz0123456789"[Math.floor(random() * 36)]).join("")}`;
+  const problems = [];
+  const refuse = (why, handoff2) => ({
+    report: { ...returned.handoffId ? { handoffId: returned.handoffId } : {}, refused: why, counts: { changed: 0, unchanged: 0, stale: 0, comments: 0, problems: 0 }, problems },
+    suggestions: [],
+    comments: [],
+    writes: [],
+    ...handoff2 ? { handoff: handoff2 } : {}
+  });
+  if (!returned.handoffId) return refuse("This file has no handoff id in its page header, so it can't be matched to what was sent.");
+  let handoff;
+  try {
+    handoff = readHandoff(loaded.root, returned.handoffId);
+  } catch (e) {
+    return refuse(`The handoff record ${returned.handoffId} is damaged: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  if (!handoff) return refuse(`Handoff ${returned.handoffId} isn't in this project. Was it exported from another one?`);
+  const fallbackAuthor = opts.as?.trim() || handoff.recipient || "Editor";
+  const codes = Object.keys(handoff.lines);
+  const boxOrder = handoff.skeleton.filter((r) => r.kind === "box").map((r) => r.marker);
+  const orderOf = new Map(boxOrder.map((c, i) => [c, i]));
+  const boxes = returned.items.filter((i) => i.kind === "box");
+  const byCode = /* @__PURE__ */ new Map();
+  const damaged = [];
+  for (const b of boxes) {
+    if (b.marker?.valid && handoff.lines[b.marker.code]) (byCode.get(b.marker.code) ?? byCode.set(b.marker.code, []).get(b.marker.code)).push(b);
+    else damaged.push(b);
+  }
+  const codeOfBox = /* @__PURE__ */ new Map();
+  for (const [code, list] of byCode) if (list.length === 1) codeOfBox.set(list[0], code);
+  for (const b of damaged) {
+    const at = boxes.indexOf(b);
+    const before = boxes.slice(0, at).reverse().find((x) => codeOfBox.has(x));
+    const after = boxes.slice(at + 1).find((x) => codeOfBox.has(x));
+    const lo = before ? orderOf.get(codeOfBox.get(before)) : -1;
+    const hi = after ? orderOf.get(codeOfBox.get(after)) : boxOrder.length;
+    const free = boxOrder.slice(lo + 1, hi).filter((c) => !byCode.has(c));
+    const rivals = damaged.filter((d) => {
+      const i = boxes.indexOf(d);
+      return i > (before ? boxes.indexOf(before) : -1) && i < (after ? boxes.indexOf(after) : boxes.length);
+    });
+    if (free.length === 1 && rivals.length === 1) {
+      codeOfBox.set(b, free[0]);
+      byCode.set(free[0], [b]);
+      problems.push({ severity: "info", kind: "repaired-marker", marker: free[0], anchor: handoff.lines[free[0]].id, message: `A damaged marker${b.marker ? ` [#${b.marker.code}]` : ""} was matched to its line by position.` });
+    }
+  }
+  const missing = codes.filter((c) => !byCode.has(c));
+  const unrepaired = damaged.filter((b) => !codeOfBox.has(b));
+  if (codes.length && (missing.length + unrepaired.length) / codes.length > REFUSE_MISSING_SHARE) {
+    return refuse(`${missing.length} of ${codes.length} lines are missing from the returned file${unrepaired.length ? `, and ${unrepaired.length} came back with damaged markers` : ""}. It looks retyped or not the file that was sent, so nothing was imported.`, handoff);
+  }
+  const places = indexPlaces(loaded);
+  const live = sourceStrings(loaded);
+  const cast = loaded.project.cast ?? [];
+  const suggestions = [];
+  const comments = [];
+  let unchanged = 0, stale = 0;
+  const nearestLine = (fromBox) => {
+    for (let i = fromBox; i >= 0; i--) {
+      const c = codeOfBox.get(boxes[i]);
+      const id = c && handoff.lines[c].id;
+      if (id && places.has(id)) return id;
+    }
+    for (let i = fromBox + 1; i < boxes.length; i++) {
+      const c = codeOfBox.get(boxes[i]);
+      const id = c && handoff.lines[c].id;
+      if (id && places.has(id)) return id;
+    }
+    return handoff.range.scenes.find((s) => places.has(s));
+  };
+  const comment = (anchor, author, body, ts = now, replies = []) => {
+    if (!anchor) return;
+    comments.push({ id: rid("cmt"), anchor, messages: [{ author, ts, body }, ...replies.map((r) => ({ author: r.author, ts: r.date ?? ts, body: r.text }))] });
+  };
+  for (const [code, list] of byCode) {
+    if (list.length < 2) continue;
+    const line = handoff.lines[code];
+    problems.push({ severity: "warning", kind: "duplicate-marker", marker: code, anchor: line.id, message: `[#${code}] appears ${list.length} times (a copied box). Neither copy was applied; both are in a comment.` });
+    comment(
+      places.has(line.id) ? line.id : nearestLine(boxes.indexOf(list[0])),
+      fallbackAuthor,
+      `This line came back ${list.length} times: ${list.map((b) => quote(b.text.proposed)).join(" and ")}.`
+    );
+  }
+  for (const code of missing) {
+    const line = handoff.lines[code];
+    problems.push({ severity: "warning", kind: "missing-box", marker: code, anchor: line.id, message: `The line ${quote(line.baseline)} is missing from the returned file.` });
+    if (places.has(line.id)) comment(line.id, fallbackAuthor, `This line's box was deleted in the returned document (it read ${quote(line.baseline)}).`);
+  }
+  for (const b of unrepaired) {
+    problems.push({ severity: "warning", kind: "damaged-marker", ...b.marker ? { marker: b.marker.code } : {}, message: `A box came back with a damaged marker and couldn't be matched to its line: ${quote(b.text.proposed)}.` });
+    comment(nearestLine(boxes.indexOf(b)), fallbackAuthor, `A line near here came back with a damaged marker. Its words were: ${quote(b.text.proposed)}`);
+  }
+  const claimed = boxes.filter((b) => codeOfBox.has(b) && byCode.get(codeOfBox.get(b)).length === 1);
+  const inOrder = longestIncreasing(claimed.map((b) => orderOf.get(codeOfBox.get(b))));
+  claimed.forEach((b, i) => {
+    if (inOrder.has(i)) return;
+    const code = codeOfBox.get(b), line = handoff.lines[code];
+    const prev = claimed[i - 1];
+    const after = prev ? `after ${quote(handoff.lines[codeOfBox.get(prev)].baseline)}` : "to the start";
+    problems.push({ severity: "warning", kind: "moved", marker: code, anchor: line.id, message: `The editor moved this line ${after}.` });
+    if (places.has(line.id)) comment(line.id, fallbackAuthor, `The editor moved this line ${after}.`);
+  });
+  for (const b of claimed) {
+    let suggestion2 = function(parts) {
+      const isStale = (live[sent.id] ?? "") !== sent.baseline;
+      if (isStale) {
+        stale++;
+        problems.push({ severity: "info", kind: "stale", marker: code, anchor: sent.id, message: "This line has changed in the project since it was sent; its suggestion will show as out of date." });
+      }
+      return {
+        id: rid("sg"),
+        anchor: sent.id,
+        baseline: sent.baseline,
+        author,
+        ...changeAuthors.length > 1 ? { authors: changeAuthors } : {},
+        ts,
+        handoff: { id: handoff.id, marker: code },
+        ...parts
+      };
+    };
+    var suggestion = suggestion2;
+    const code = codeOfBox.get(b), sent = handoff.lines[code];
+    const here = places.has(sent.id) ? sent.id : void 0;
+    const changeAuthors = rankAuthors([...b.text.changes, ...b.lead.changes]);
+    const author = changeAuthors[0] ?? fallbackAuthor;
+    const ts = latest([...b.text.changes, ...b.lead.changes]) ?? now;
+    if (b.paragraphs > 1) problems.push({ severity: "info", kind: "joined-paragraphs", marker: code, anchor: sent.id, message: "An Enter inside this box was joined into one line." });
+    if (b.text.droppedFormatting) problems.push({ severity: "info", kind: "dropped-formatting", marker: code, anchor: sent.id, message: "Formatting other than bold and italic was dropped." });
+    const { text: proposedRaw, notes } = takeNotes(b.rowDeleted ? "" : b.text.proposed, sent.baseline);
+    const proposed = tidy(proposedRaw);
+    const textChanged = normalise(proposed, !!opts.strictQuotes) !== normalise(sent.baseline, !!opts.strictQuotes);
+    const tracked = b.text.changes.length > 0;
+    if (tracked && normalise(b.text.original, !!opts.strictQuotes) !== normalise(sent.baseline, !!opts.strictQuotes)) {
+      problems.push({ severity: "info", kind: "untracked-edits", marker: code, anchor: sent.id, message: "This line has tracked changes and some untracked ones too, so the credit may be incomplete." });
+    }
+    const cue = sent.kind === "line" ? readLead(b.lead.proposed) : void 0;
+    let proposedCharacter, proposedDirection;
+    if (sent.kind === "line" && cue) {
+      const sentCue = (sent.character ?? "").toUpperCase();
+      if (cue.character && cue.character.toUpperCase() !== sentCue) {
+        const match = cast.find((c) => c.name.toUpperCase() === cue.character.toUpperCase());
+        if (match) proposedCharacter = match.name;
+        else {
+          problems.push({ severity: "warning", kind: "unknown-speaker", marker: code, anchor: sent.id, message: `The speaker was changed to ${cue.character}, who isn't in the cast; it's in a comment.` });
+          comment(here ?? nearestLine(boxes.indexOf(b)), author, `Speaker changed from ${sent.character ?? "(none)"} to ${cue.character}, who isn't in the cast.`, ts);
+        }
+      }
+      if (tidy(cue.direction) !== tidy(sent.direction ?? "")) proposedDirection = tidy(cue.direction);
+    }
+    for (const note of notes) comment(here ?? nearestLine(boxes.indexOf(b)), author, note, ts);
+    if (!here) {
+      if (textChanged || proposedCharacter || proposedDirection !== void 0) {
+        problems.push({ severity: "warning", kind: "line-gone", marker: code, message: `The line ${quote(sent.baseline)} is no longer in the project; the editor's version is in a comment nearby.` });
+        comment(nearestLine(boxes.indexOf(b)), author, `For a line no longer in the project (${quote(sent.baseline)}), the editor wrote: ${quote(proposed)}`, ts);
+      } else unchanged++;
+      continue;
+    }
+    if (proposed === "" && sent.baseline.trim() !== "") {
+      suggestions.push(suggestion2({ proposed: sent.baseline, proposedCut: true }));
+      continue;
+    }
+    if (textChanged && !sameList(placeholders(proposed), placeholders(sent.baseline))) {
+      problems.push({ severity: "warning", kind: "placeholders", marker: code, anchor: sent.id, message: `The {@\u2026} placeholders changed, so this line wasn't suggested; the editor's version is in a comment.` });
+      comment(here, author, `The editor's version changes the {@\u2026} placeholders (${placeholders(sent.baseline).join(", ") || "none"} became ${placeholders(proposed).join(", ") || "none"}), so it wasn't made a suggestion: ${quote(proposed)}`, ts);
+      if (!proposedCharacter && proposedDirection === void 0) continue;
+    }
+    const keepText = textChanged && sameList(placeholders(proposed), placeholders(sent.baseline));
+    if (!keepText && !proposedCharacter && proposedDirection === void 0) {
+      unchanged++;
+      continue;
+    }
+    suggestions.push(suggestion2({
+      proposed: keepText ? proposed : sent.baseline,
+      ...proposedCharacter ? { proposedCharacter, baselineCharacter: sent.character ?? "" } : {},
+      ...proposedDirection !== void 0 ? { proposedDirection, baselineDirection: sent.direction ?? "" } : {}
+    }));
+  }
+  const anchorOfItem = alignParagraphs(returned.items, handoff.skeleton, codeOfBox, (item, row) => {
+    if (!places.has(row.node)) return;
+    problems.push({ severity: "warning", kind: "context-edited", anchor: row.node, message: `The editor changed ${quote(row.text)} to ${quote(item.text.proposed)}; it's a comment, since only the boxes are edited.` });
+    comment(row.node, rankAuthors(item.text.changes)[0] ?? fallbackAuthor, `Changed in the document from ${quote(row.text)} to ${quote(item.text.proposed)}.`, latest(item.text.changes) ?? now);
+  }, (item, nearBox) => {
+    const anchor = nearestLine(nearBox);
+    problems.push({ severity: "warning", kind: "added-text", ...anchor ? { anchor } : {}, message: `The editor added text outside the boxes: ${quote(item.text.proposed)}; it's a comment on the line before.` });
+    comment(anchor, rankAuthors(item.text.changes)[0] ?? fallbackAuthor, `Editor added: ${quote(item.text.proposed)}`, latest(item.text.changes) ?? now);
+  }, (code) => handoff.lines[code]?.id);
+  for (const c of returned.comments) {
+    const anchor = anchorOfItem.get(c.id);
+    const where = anchor && places.has(anchor) ? anchor : void 0;
+    if (!where) {
+      problems.push({ severity: "info", kind: "added-text", message: `A comment by ${c.author || fallbackAuthor} wasn't on any line of the script (the front page?): ${quote(c.text)}` });
+      continue;
+    }
+    comment(where, c.author || fallbackAuthor, c.text, c.date ?? now, c.replies);
+  }
+  const shards = /* @__PURE__ */ new Map();
+  const shardFor = (anchor) => {
+    const path = authoringPath(loaded, places.get(anchor).sceneId);
+    let af = shards.get(path);
+    if (!af) {
+      const i = loaded.authoringFiles.indexOf(path);
+      af = i >= 0 ? structuredClone(loaded.authoring[i]) : { schema: "patter/authoring@0" };
+      shards.set(path, af);
+    }
+    return af;
+  };
+  loaded.authoringFiles.forEach((path, i) => {
+    const af = loaded.authoring[i];
+    if ((af.suggestions ?? []).some((s) => s.handoff?.id === handoff.id && !s.resolved)) {
+      const copy = shards.get(path) ?? structuredClone(af);
+      copy.suggestions = (copy.suggestions ?? []).filter((s) => !(s.handoff?.id === handoff.id && !s.resolved));
+      shards.set(path, copy);
+    }
+  });
+  for (const s of suggestions) {
+    const af = shardFor(s.anchor);
+    af.suggestions = [...af.suggestions ?? [], s];
+  }
+  for (const c of comments) {
+    const af = shardFor(c.anchor);
+    af.comments = [...af.comments ?? [], c];
+  }
+  let writes = [...shards].map(([path, af]) => ({ path, content: canonicalStringify11(af) }));
+  if (opts.direct && suggestions.length) {
+    const warned = new Set(problems.filter((p) => p.severity === "warning" && p.anchor).map((p) => p.anchor));
+    const clean = suggestions.filter((s) => (live[s.anchor] ?? "") === s.baseline && !warned.has(s.anchor));
+    if (clean.length) {
+      const withSuggestions = { ...loaded, authoringFiles: [...loaded.authoringFiles], authoring: [...loaded.authoring] };
+      for (const [path, af] of shards) {
+        const i = withSuggestions.authoringFiles.indexOf(path);
+        if (i >= 0) withSuggestions.authoring[i] = af;
+        else {
+          withSuggestions.authoringFiles.push(path);
+          withSuggestions.authoring.push(af);
+        }
+      }
+      const decided = applySuggestionDecisions(withSuggestions, clean.map((s) => ({ id: s.id, accept: true })), { now, by: opts.by });
+      const byPath = new Map(writes.map((w) => [w.path, w]));
+      for (const w of decided.writes) byPath.set(w.path, w);
+      writes = [...byPath.values()];
+    }
+  }
+  const counts = { changed: suggestions.length, unchanged, stale, comments: comments.length, problems: problems.filter((p) => p.severity === "warning").length };
+  const logged = { ...handoff, imports: [...handoff.imports ?? [], { at: now, by: opts.by, fileHash: opts.fileHash, counts }] };
+  writes.push(handoffWrite(loaded.root, logged));
+  writes.sort((a, b) => a.path.localeCompare(b.path));
+  return { report: { handoffId: handoff.id, counts, problems }, suggestions, comments, writes, handoff: logged };
+}
+function readLead(text) {
+  const lines = text.split("\n").map((l) => l.trim()).filter(Boolean);
+  const direction = lines.find((l) => /^\(.*\)$/s.test(l));
+  const character = lines.find((l) => l !== direction) ?? "";
+  return { character, direction: direction ? direction.slice(1, -1) : "" };
+}
+function rankAuthors(changes) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const c of changes) if (c.author) counts.set(c.author, (counts.get(c.author) ?? 0) + 1);
+  return [...counts].sort((a, b) => b[1] - a[1]).map(([a]) => a);
+}
+function latest(changes) {
+  return changes.map((c) => c.date).filter((d) => !!d).sort().pop();
+}
+function longestIncreasing(xs) {
+  const tails = [], tailIdx = [], prev = new Array(xs.length).fill(-1);
+  xs.forEach((x, i) => {
+    let lo = 0, hi = tails.length;
+    while (lo < hi) {
+      const mid = lo + hi >> 1;
+      if (tails[mid] < x) lo = mid + 1;
+      else hi = mid;
+    }
+    tails[lo] = x;
+    tailIdx[lo] = i;
+    prev[i] = lo > 0 ? tailIdx[lo - 1] : -1;
+  });
+  const out = /* @__PURE__ */ new Set();
+  for (let i = tailIdx[tails.length - 1] ?? -1; i >= 0; i = prev[i]) out.add(i);
+  return out;
+}
+function alignParagraphs(items, skeleton, codeOfBox, onEdited, onAdded, lineIdOf) {
+  const anchors = /* @__PURE__ */ new Map();
+  const note = (ids, anchor) => {
+    if (anchor) {
+      for (const id of ids) if (!anchors.has(id)) anchors.set(id, anchor);
+    }
+  };
+  const first = skeleton[0];
+  const firstShown = first && first.kind !== "box" ? shownAs(first).map(loose) : [];
+  let start = items.findIndex((it) => it.kind !== "box" && firstShown.includes(loose(it.text.original)));
+  if (start < 0) start = items.findIndex((it) => it.kind === "box");
+  if (start < 0) return anchors;
+  const segments = [];
+  const order = /* @__PURE__ */ new Map();
+  let pending = [];
+  for (const row of skeleton) {
+    if (row.kind === "box") {
+      order.set(row.marker, segments.length);
+      segments.push(pending);
+      pending = [];
+    } else pending.push(row);
+  }
+  segments.push(pending);
+  let placed = -1;
+  const rowsBefore = (to) => {
+    const rows = to > placed ? segments.slice(placed + 1, to + 1).flat() : [...segments[to]];
+    placed = Math.max(placed, to);
+    return rows;
+  };
+  let boxIndex = -1, gap = [], lastLine;
+  const settle = (to, near) => {
+    const rows = rowsBefore(to);
+    const unmatchedItems = [];
+    for (const item of gap) {
+      const k = rows.findIndex((r) => shownAs(r).map(loose).includes(loose(item.text.original)));
+      if (k < 0) {
+        unmatchedItems.push(item);
+        continue;
+      }
+      const row = rows.splice(k, 1)[0];
+      note(item.text.comments, row.node);
+      if (!shownAs(row).map(loose).includes(loose(item.text.proposed))) onEdited(item, row);
+    }
+    if (unmatchedItems.length === 1 && rows.length === 1) {
+      note(unmatchedItems[0].text.comments, rows[0].node);
+      onEdited(unmatchedItems[0], rows[0]);
+    } else {
+      for (const item of unmatchedItems) {
+        note(item.text.comments, lastLine);
+        onAdded(item, near);
+      }
+    }
+    gap = [];
+  };
+  for (const item of items.slice(start)) {
+    if (item.kind === "box") {
+      const code = codeOfBox.get(item);
+      boxIndex++;
+      if (code === void 0) continue;
+      settle(order.get(code), boxIndex - 1);
+      const line = code ? lineIdOf(code) : void 0;
+      if (line) {
+        lastLine = line;
+        note([...item.text.comments, ...item.lead.comments, ...item.margin.comments], line);
+      }
+      continue;
+    }
+    if (item.text.proposed.trim() === "" && item.text.original.trim() === "" && !item.text.comments.length) continue;
+    gap.push(item);
+  }
+  settle(segments.length - 1, boxIndex);
+  return anchors;
+}
 export {
   AUTHORING_HANDLED,
   CONFLICT_SIDECAR,
   GAME_SCOPES_DIR,
   GAME_SCOPES_FILE,
   GAME_SCOPES_OWNER,
+  HANDOFF_DIR,
   PATTER_SCOPES_FILE,
   PATTER_SCOPES_OWNER,
+  RARE_REACH_PCT,
+  REFUSE_MISSING_SHARE,
   SHARD_EXTENSIONS,
   UnsafeEntryError,
   UnsupportedMergeError,
   applyLoc,
   applySceneOrder,
+  applySuggestionDecisions,
   applyWrites,
   bundleOutputPath,
   catalogToJson,
@@ -4091,20 +5365,31 @@ export {
   detectMergeType,
   discoverGameScopes,
   drivableScopes,
+  exportEditableScript,
   extractLoc,
   findProjectFile,
+  formatMarker,
   gameScopeTokens,
   gameScopesCatalogue,
   gameScopesSnapshot,
+  handoffPath,
+  handoffWrite,
   hostScopeTokens,
   isUnsafeEntry2 as isUnsafeEntry,
+  issueMarkerCodes,
   jsonToCatalog,
+  leastReachedFirst,
+  listOpenSuggestions,
   listProjectTags,
   loadProject,
   loadProjectLanding,
+  markerLength,
+  newHandoffId,
+  parseHandoff,
   patterScopesFile,
   patterScopesStale,
   patterScopesWrite,
+  planEditableImport,
   planPins,
   planReturnedWorld,
   planShareScopes,
@@ -4113,7 +5398,11 @@ export {
   previewRegistry,
   proposeCoverageDrivers,
   reachabilityIssues,
+  readEditableDocx,
   readGameScopes,
+  readHandoff,
+  readHandoffs,
+  readMarker,
   renderCoverageText,
   renderPlay,
   renderReportText,
@@ -4147,8 +5436,11 @@ export {
   sceneIdForShard,
   scriptToDocx,
   scriptToPdf,
+  serialiseHandoff,
   serialiseScopesFile,
+  setCut,
   sidecarIssues,
+  staleParts,
   vcsConfigWrites,
   voiceScriptToXlsx,
   worldSettingsScopes,