@patterkit/ops 1.0.1 → 1.1.0

package/dist/index.js

@@ -623,7 +623,7 @@ function merge3(base, ours, theirs, id, path, conflicts) {
   conflicts.push({ id, path, base, ours, theirs, kind: deletedKind(base, ours, theirs) });
   return ours;
 }
-function mergeMap(base, ours, theirs, prefix, conflicts, resolve8) {
+function mergeMap(base, ours, theirs, prefix, conflicts, resolve9) {
   const out = {};
   for (const k of /* @__PURE__ */ new Set([...Object.keys(base), ...Object.keys(ours), ...Object.keys(theirs)])) {
     const b = base[k], o = ours[k], t = theirs[k];
@@ -632,7 +632,7 @@ function mergeMap(base, ours, theirs, prefix, conflicts, resolve8) {
     else if (eq(b, o)) v = t;
     else if (eq(b, t)) v = o;
     else {
-      const r = resolve8?.(k, b, o, t);
+      const r = resolve9?.(k, b, o, t);
       if (r && r.resolved) v = r.value;
       else {
         conflicts.push({ id: k, path: `${prefix}.${k}`, base: b, ours: o, theirs: t, kind: r ? r.kind : deletedKind(b, o, t) });
@@ -2330,7 +2330,8 @@ function runValidate(loaded) {
   if (compiled) gameScopes.push(...unplayableScopes(loaded, compiled));
   const unresolvedMerges = [...sidecarIssues(tree.get(CONFLICT_SIDECAR)), ...markedShards(SHARD_EXTENSIONS.flatMap((ext) => tree.get(ext)))];
   const orphans = orphanShards(loaded, tree);
-  const extensions = [...extensionIssues(loaded), ...gitattributesHint(loaded)];
+  const extensionPassed = extensionIssues(loaded);
+  const extensions = [...extensionPassed.issues, ...gitattributesHint(loaded)];
   const structuralErrors = structural.filter((i) => i.severity === void 0);
   const reachability = compiled && structuralErrors.length === 0 && !conditions.some(isError) ? reachabilityIssues(loaded, compiled) : [];
   return {
@@ -2345,6 +2346,7 @@ function runValidate(loaded) {
     gameScopes,
     localisation,
     extensions,
+    extensionPools: extensionPassed.pools,
     ok: !localisation.some(isError) && !extensions.some(isError) && structuralErrors.length === 0 && !conditions.some(isError) && !interpolation.some(isError) && hygiene.length === 0 && staleBundles.length === 0 && unresolvedMerges.length === 0 && orphans.length === 0 && !gameScopes.some(isError)
   };
 }
@@ -2360,20 +2362,20 @@ function exportBlockers(loaded) {
     ...structural.map((i) => `[${i.code}] ${i.message}`),
     ...[...conditions, ...interpolation].map((i) => `[${i.field}] ${i.nodeId}: ${i.message}  (${i.src})`),
     ...locIssues(loaded).filter(isError).map((i) => `[localisation] ${i.file}: ${i.message}`),
-    ...extensionIssues(loaded).filter(isError).map((i) => `[extension] ${i.file}: ${i.message}`)
+    ...extensionIssues(loaded).issues.filter(isError).map((i) => `[extension] ${i.file}: ${i.message}`)
   ];
 }
 function extensionIssues(loaded) {
   const loadIssues = loaded.extensionIssues.map((i) => ({ severity: "error", file: i.file, message: i.message }));
-  if (loaded.project.extensions === void 0 && loaded.manifests.length === 0 && loaded.extensionShards.length === 0) return loadIssues;
-  const { issues } = extensionPass({
+  if (loaded.project.extensions === void 0 && loaded.manifests.length === 0 && loaded.extensionShards.length === 0) return { issues: loadIssues, pools: {} };
+  const { issues, pools } = extensionPass({
     project: loaded.project,
     scenes: loaded.scenes,
     ...loadedExtensions(loaded),
     projectPath: loaded.projectFile,
     sceneFiles: loaded.sceneFiles
   });
-  return [...loadIssues, ...pinSettingsIssues(loaded), ...issues];
+  return { issues: [...loadIssues, ...pinSettingsIssues(loaded), ...issues], pools };
 }
 function pinSettingsIssues(loaded) {
   return Object.entries(loaded.project.extensions ?? {}).filter(([, pin]) => typeof pin === "object" && pin !== null && Object.prototype.hasOwnProperty.call(pin, "settings")).map(([id]) => ({
@@ -2633,19 +2635,41 @@ function scanAudioStatus(loaded) {
   const snap = scanAudio(loaded);
   return snap && new Map(Object.entries(snap).map(([id, e]) => [id, e.status]));
 }
-function audioManifest(snapshot, projectRoot, audioRoot) {
+function audioManifest(snapshot, projectRoot, audioRoot, opts = {}) {
   const base = resolve4(projectRoot, audioRoot);
   const clips = {};
   for (const beatId of Object.keys(snapshot).sort()) {
     const entry = snapshot[beatId];
+    if (opts.lines && !opts.lines.has(beatId)) continue;
+    if (opts.leaveOut?.has(entry.status)) continue;
     clips[beatId] = { file: relative4(base, entry.path).split(sep3).join("/"), status: entry.status };
   }
   return JSON.stringify({ schema: AUDIO_MANIFEST_SCHEMA, clips }, null, 2) + "\n";
 }
-function audioManifestWrite(loaded, snapshot) {
+function manifestLineIds(loaded) {
+  const ids = /* @__PURE__ */ new Set();
+  const walk = (n) => {
+    if (Array.isArray(n)) {
+      for (const x of n) walk(x);
+      return;
+    }
+    if (!n || typeof n !== "object") return;
+    const o = n;
+    if (typeof o["id"] === "string" && typeof o["kind"] === "string") ids.add(o["id"]);
+    for (const v of Object.values(o)) if (v && typeof v === "object") walk(v);
+  };
+  for (const scene of loaded.scenes) walk(scene);
+  for (const id of mergeAuthoring2(loaded).cut) ids.delete(id);
+  return ids;
+}
+function audioManifestWrite(loaded, snapshot, opts = {}) {
   const p = loaded.project;
   if (!snapshot || !audioFoldersActive(p) || !Object.keys(snapshot).length) return void 0;
-  return { path: join7(resolve4(loaded.root, p.audioRoot), AUDIO_MANIFEST_FILE), content: audioManifest(snapshot, loaded.root, p.audioRoot) };
+  const leaveOut = opts.leaveOutPlaceholderSpeech && p.placeholderSpeech ? /* @__PURE__ */ new Set([p.placeholderSpeech.status]) : void 0;
+  return {
+    path: opts.path ?? join7(resolve4(loaded.root, p.audioRoot), AUDIO_MANIFEST_FILE),
+    content: audioManifest(snapshot, loaded.root, p.audioRoot, { lines: manifestLineIds(loaded), ...leaveOut ? { leaveOut } : {} })
+  };
 }
 
 // src/export.ts
@@ -2693,7 +2717,10 @@ function planBuild(loaded, opts = {}) {
   const bundle = runExport(loaded, opts);
   const text = canonicalStringify4(bundle, { trailingComma: false });
   const scopes = patterScopesWrite(loaded.project, loaded.gameScopes);
-  const audio = audioManifestWrite(loaded, opts.audio ?? scanAudio(loaded));
+  const audio = audioManifestWrite(loaded, opts.audio ?? scanAudio(loaded), {
+    ...opts.audioManifestPath ? { path: opts.audioManifestPath } : {},
+    ...opts.leaveOutPlaceholderSpeech ? { leaveOutPlaceholderSpeech: true } : {}
+  });
   return {
     bundle,
     text,
@@ -3075,6 +3102,444 @@ ${PLAYER_JS}`,
   };
 }
 
+// src/placeholder-speech.ts
+import { createHash, createSign } from "crypto";
+import { existsSync as existsSync5, readFileSync as readFileSync7, openSync, readSync, closeSync, fstatSync } from "fs";
+import { homedir } from "os";
+import { isAbsolute as isAbsolute3, join as join8, relative as relative5, resolve as resolve5 } from "path";
+import { DEFAULT_CAPTION_CHARACTER, DEFAULT_CAPTION_DELIMITERS, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES3, deriveRecordingFolders as deriveRecordingFolders2 } from "@patterkit/model";
+import { stripCaptions } from "@patterkit/dialect";
+import { textHash, withStamps, readInfoChunks, accentForLanguage, defaultPlaceholderVoice, TEXT_STAMP, GENERATED_STAMP } from "@patterkit/core";
+
+// src/voice-script.ts
+import { DEFAULT_WRITING_STATUSES, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES2, DEFAULT_DOCUMENTATION_CLASSES as DEFAULT_DOCUMENTATION_CLASSES3, projectQualifiers as projectQualifiers3 } from "@patterkit/model";
+function plainVoice(text) {
+  return text.replace(/<\/?(?:b|i|bi)>/g, "").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+}
+function groupLabel(node, source) {
+  if (node.prompt) return plainVoice(source[node.prompt.id]?.trim() || "option");
+  if (node.selector === "choice") return "";
+  return node.selector ?? "group";
+}
+function runVoiceScript(loaded, opts = {}) {
+  const { project } = loaded;
+  const everything = !!opts.everything;
+  const ladderDecls = project.writingStatuses ?? DEFAULT_WRITING_STATUSES;
+  const writingLadder = ladderDecls.map((s) => s.name);
+  const recordingLadder = (project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES2).map((s) => s.name);
+  const stub = writingLadder[0];
+  const recordThreshold = ladderDecls.findIndex((s) => s.readyToRecord);
+  const writingIndex = new Map(writingLadder.map((name, i) => [name, i]));
+  const { writing: writingOf, recording: manualRecordingOf, cut: cutSet, rerecord: rerecordSet, documentation: docsOf } = mergeAuthoring2(loaded);
+  const recordingBase = opts.recordingOverride ?? manualRecordingOf;
+  const recordingOf = (id) => effectiveRecording(id, recordingBase, rerecordSet, recordingLadder[0]);
+  const source = sourceStrings(loaded);
+  const actorOf = /* @__PURE__ */ new Map();
+  for (const c of project.cast ?? []) if (c.actor) actorOf.set(c.name, c.actor);
+  const qualifierName = new Map(projectQualifiers3(project).map((q) => [q.gameId, q.name]));
+  const voClasses = classesForChannel(project.documentationClasses ?? DEFAULT_DOCUMENTATION_CLASSES3, "vo");
+  const ownVo = (id) => (docsOf.get(id) ?? []).filter((d) => d.type !== void 0 && voClasses.has(d.type)).map((d) => d.text);
+  const lines = [];
+  const folders = sceneFolderPaths(loaded);
+  let sceneNow = "";
+  const emitLine = (beat, scope, leadingVo) => {
+    if (beat.kind !== "line" || cutSet.has(beat.id)) return false;
+    const ws = writingOf.get(beat.id) ?? stub;
+    if (!everything && recordThreshold !== -1 && (writingIndex.get(ws) ?? 0) < recordThreshold) return false;
+    const own = ownVo(beat.id);
+    const folder = folders.get(sceneNow);
+    lines.push({
+      ...folder ? { folder } : {},
+      scope: scope.join(" \u203A "),
+      id: beat.id,
+      character: beat.character ?? "",
+      ...beat.qualifier ? { qualifier: qualifierName.get(beat.qualifier) ?? beat.qualifier } : {},
+      actor: beat.character ? actorOf.get(beat.character) : void 0,
+      ...beat.direction?.trim() ? { direction: plainVoice(beat.direction.trim()) } : {},
+      text: plainVoice(source[beat.id] ?? ""),
+      comments: leadingVo ? [...leadingVo, ...own] : own,
+      // first line of the run gets the enclosing context
+      recordingStatus: recordingOf(beat.id)
+    });
+    return true;
+  };
+  const walkNode = (node, scope, ancestorVo) => {
+    if (node.type === "group") {
+      if (cutSet.has(node.id)) return;
+      const label = groupLabel(node, source);
+      const childScope = label ? [...scope, label] : scope;
+      const childVo = [...ancestorVo, ...ownVo(node.id)];
+      if (node.prompt) emitLine(node.prompt, childScope, childVo);
+      for (const child2 of node.children ?? []) walkNode(child2, childScope, childVo);
+      return;
+    }
+    if (cutSet.has(node.id)) return;
+    let leading = true;
+    for (const beat of node.beats ?? []) {
+      if (emitLine(beat, scope, leading ? ancestorVo : void 0)) leading = false;
+    }
+  };
+  for (const scene of loaded.scenes) {
+    if (cutSet.has(scene.id)) continue;
+    sceneNow = scene.id;
+    const sceneVo = ownVo(scene.id);
+    for (const block of scene.blocks) {
+      if (cutSet.has(block.id)) continue;
+      const scope = [scene.name, block.name].filter(Boolean);
+      const blockVo = [...sceneVo, ...ownVo(block.id)];
+      for (const child2 of block.children ?? []) walkNode(child2, scope, blockVo);
+    }
+  }
+  return { project: project.project.id, voiced: project.voiced ?? false, recordingLadder, everything, lines };
+}
+
+// src/placeholder-speech.ts
+var PLACEHOLDER_SAMPLE_RATE = 16e3;
+var TRIM_THRESHOLD = 0.01;
+var TRIM_PAD_SECONDS = 0.05;
+function resolveKeyFile(projectRoot, keyFile, env = process.env) {
+  const stored = keyFile?.trim();
+  if (stored) {
+    const path = expandKeyPath(projectRoot, stored);
+    if (existsSync5(path)) return { path, source: "project", stored };
+  }
+  const fromEnv = env["GOOGLE_APPLICATION_CREDENTIALS"]?.trim();
+  if (fromEnv && existsSync5(fromEnv)) return { path: fromEnv, source: "environment", ...stored ? { stored } : {} };
+  const gcloud = gcloudCredentialsPath(env);
+  if (gcloud && existsSync5(gcloud)) return { path: gcloud, source: "gcloud", ...stored ? { stored } : {} };
+  return { source: "none", ...stored ? { stored } : {} };
+}
+function gcloudCredentialsPath(env = process.env) {
+  const file = "application_default_credentials.json";
+  const config = env["CLOUDSDK_CONFIG"]?.trim();
+  if (config) return join8(config, file);
+  if (process.platform === "win32") return env["APPDATA"] ? join8(env["APPDATA"], "gcloud", file) : void 0;
+  return join8(homedir(), ".config", "gcloud", file);
+}
+function expandKeyPath(projectRoot, stored) {
+  const p = stored.trim();
+  if (p === "~" || p.startsWith("~/") || p.startsWith("~\\")) return join8(homedir(), p.slice(2));
+  return isAbsolute3(p) ? p : resolve5(projectRoot, p);
+}
+function storedKeyPath(projectRoot, chosen) {
+  const home = homedir();
+  const norm = (s) => s.replace(/\\/g, "/");
+  const c = norm(resolve5(chosen));
+  const h = norm(home);
+  if (c === h || c.startsWith(h + "/")) return "~/" + c.slice(h.length + 1);
+  const rel = relative5(projectRoot, chosen);
+  return norm(isAbsolute3(rel) ? chosen : rel);
+}
+function readGoogleKey(path) {
+  let raw;
+  try {
+    raw = JSON.parse(readFileSync7(path, "utf8"));
+  } catch {
+    throw new Error("That file isn't a Google key: it isn't readable JSON.");
+  }
+  const k = raw;
+  const text = (name) => typeof k[name] === "string" ? k[name] : "";
+  if (k["type"] === "service_account") {
+    if (!text("client_email") || !text("private_key")) throw new Error("That key file is missing its account or its private key.");
+    return { kind: "service-account", projectId: text("project_id"), account: text("client_email"), privateKey: text("private_key") };
+  }
+  if (k["type"] === "authorized_user") {
+    if (!text("client_id") || !text("client_secret") || !text("refresh_token")) throw new Error("That gcloud sign-in file is incomplete: sign in again with gcloud auth application-default login.");
+    if (!text("quota_project_id")) throw new Error("That gcloud sign-in names no project to bill: run gcloud auth application-default set-quota-project with your project's id.");
+    return { kind: "user", projectId: text("quota_project_id"), account: text("account"), clientId: text("client_id"), clientSecret: text("client_secret"), refreshToken: text("refresh_token") };
+  }
+  throw new Error("That file isn't a Google key Placeholder Speech can use: choose a service account's JSON key, or gcloud's sign-in (application_default_credentials.json).");
+}
+var b64url = (b) => Buffer.from(b).toString("base64").replace(/=+$/, "").replace(/\+/g, "-").replace(/\//g, "_");
+async function mintToken(key, fetchFn = fetch) {
+  if (key.kind === "user") {
+    const res2 = await fetchFn("https://oauth2.googleapis.com/token", {
+      method: "POST",
+      headers: { "content-type": "application/x-www-form-urlencoded" },
+      body: new URLSearchParams({ grant_type: "refresh_token", client_id: key.clientId, client_secret: key.clientSecret, refresh_token: key.refreshToken }).toString()
+    });
+    if (!res2.ok) throw new SpeechError(res2.status === 400 || res2.status === 401 ? "auth" : kindForStatus(res2.status), `Google refused this sign-in (${res2.status}): ${await errorText(res2)}. Sign in again with gcloud auth application-default login.`);
+    return tokenFrom(await res2.json());
+  }
+  const now = Math.floor(Date.now() / 1e3);
+  const header = b64url(JSON.stringify({ alg: "RS256", typ: "JWT" }));
+  const claims = b64url(JSON.stringify({ iss: key.account, scope: "https://www.googleapis.com/auth/cloud-platform", aud: "https://oauth2.googleapis.com/token", iat: now, exp: now + 3600 }));
+  const signer = createSign("RSA-SHA256");
+  signer.update(`${header}.${claims}`);
+  const jwt = `${header}.${claims}.${b64url(signer.sign(key.privateKey))}`;
+  const res = await fetchFn("https://oauth2.googleapis.com/token", {
+    method: "POST",
+    headers: { "content-type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({ grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer", assertion: jwt }).toString()
+  });
+  if (!res.ok) throw new SpeechError(res.status === 400 || res.status === 401 ? "auth" : kindForStatus(res.status), `Google refused this key (${res.status}): ${await errorText(res)}`);
+  return tokenFrom(await res.json());
+}
+function tokenFrom(body) {
+  if (!body.access_token) throw new SpeechError("auth", "Google gave no token for this key.");
+  return { token: body.access_token, expiresAt: Date.now() + (body.expires_in ?? 3600) * 1e3 - 6e4 };
+}
+var SpeechError = class extends Error {
+  constructor(kind, message) {
+    super(message);
+    this.kind = kind;
+  }
+  kind;
+};
+function kindForStatus(status) {
+  if (status === 401) return "auth";
+  if (status === 403) return "forbidden";
+  if (status === 429) return "rate";
+  if (status >= 500) return "server";
+  return "bad-request";
+}
+async function errorText(res) {
+  try {
+    const j = await res.json();
+    if (typeof j.error === "object" && j.error?.message) return j.error.message;
+    return j.error_description ?? (typeof j.error === "string" ? j.error : res.statusText);
+  } catch {
+    return res.statusText;
+  }
+}
+function describeSpeechError(e) {
+  if (e instanceof SpeechError) {
+    if (e.kind === "forbidden" && /not been used|disabled|SERVICE_DISABLED/i.test(e.message)) return "Google refused this key: the Text-to-Speech service isn't switched on for its project.";
+    if (e.kind === "forbidden" && /billing/i.test(e.message)) return "Google refused this key: its project has no billing account.";
+    return e.message;
+  }
+  if (e instanceof TypeError || e?.code === "ENOTFOUND") return "Couldn't reach Google: no network connection.";
+  return e instanceof Error ? e.message : String(e);
+}
+var isNetworkError = (e) => e instanceof TypeError || ["ENOTFOUND", "ECONNREFUSED", "ETIMEDOUT", "EAI_AGAIN", "ECONNRESET"].includes(e?.code ?? e?.cause?.code ?? "");
+function requestHash(r) {
+  const shape = { text: r.text, voice: r.voice, languageCode: r.languageCode, encoding: "LINEAR16", sampleRate: PLACEHOLDER_SAMPLE_RATE, trim: TRIM_PAD_SECONDS };
+  return createHash("sha256").update(JSON.stringify(shape)).digest("hex").slice(0, 16);
+}
+async function synthesize(auth, r, fetchFn = fetch) {
+  const { token, quotaProject } = typeof auth === "string" ? { token: auth, quotaProject: void 0 } : auth;
+  let res;
+  try {
+    res = await fetchFn("https://texttospeech.googleapis.com/v1/text:synthesize", {
+      method: "POST",
+      headers: { authorization: `Bearer ${token}`, "content-type": "application/json", ...quotaProject ? { "x-goog-user-project": quotaProject } : {} },
+      body: JSON.stringify({ input: { text: r.text }, voice: { languageCode: r.languageCode, name: r.voice }, audioConfig: { audioEncoding: "LINEAR16", sampleRateHertz: PLACEHOLDER_SAMPLE_RATE } })
+    });
+  } catch (e) {
+    if (isNetworkError(e)) throw new SpeechError("offline", "Couldn't reach Google: no network connection.");
+    throw e;
+  }
+  if (!res.ok) throw new SpeechError(kindForStatus(res.status), `Google refused the request (${res.status}): ${await errorText(res)}`);
+  const body = await res.json();
+  if (!body.audioContent) throw new SpeechError("server", "Google sent no audio.");
+  return new Uint8Array(Buffer.from(body.audioContent, "base64"));
+}
+function finishTake(wav, stamps) {
+  const view = new DataView(wav.buffer, wav.byteOffset, wav.byteLength);
+  const ascii = (at) => String.fromCharCode(wav[at], wav[at + 1], wav[at + 2], wav[at + 3]);
+  let fmtAt = -1, dataAt = -1, dataLen = 0;
+  for (let pos = 12; pos + 8 <= wav.length; ) {
+    const id = ascii(pos), len = view.getUint32(pos + 4, true);
+    if (id === "fmt ") fmtAt = pos + 8;
+    if (id === "data") {
+      dataAt = pos + 8;
+      dataLen = Math.min(len, wav.length - dataAt);
+    }
+    pos += 8 + len + len % 2;
+  }
+  if (fmtAt < 0 || dataAt < 0) throw new SpeechError("server", "Google's audio wasn't a WAV.");
+  const channels = view.getUint16(fmtAt + 2, true), rate = view.getUint32(fmtAt + 4, true), bits = view.getUint16(fmtAt + 14, true);
+  if (bits !== 16) throw new SpeechError("server", "Google's audio wasn't 16-bit.");
+  const frames = Math.floor(dataLen / (2 * channels));
+  const amp = (i) => {
+    let m = 0;
+    for (let c = 0; c < channels; c++) m = Math.max(m, Math.abs(view.getInt16(dataAt + (i * channels + c) * 2, true)) / 32768);
+    return m;
+  };
+  const pad = Math.floor(rate * TRIM_PAD_SECONDS);
+  let start = 0, end = frames - 1;
+  for (let i = 0; i < frames; i++) if (amp(i) > TRIM_THRESHOLD) {
+    start = Math.max(0, i - pad);
+    break;
+  }
+  for (let i = frames - 1; i >= start; i--) if (amp(i) > TRIM_THRESHOLD) {
+    end = Math.min(frames - 1, i + pad);
+    break;
+  }
+  const pcm = wav.subarray(dataAt + start * 2 * channels, dataAt + (end + 1) * 2 * channels);
+  const out = new Uint8Array(44 + pcm.length);
+  const o = new DataView(out.buffer);
+  const put = (at, s) => {
+    for (let i = 0; i < 4; i++) out[at + i] = s.charCodeAt(i);
+  };
+  put(0, "RIFF");
+  o.setUint32(4, 36 + pcm.length, true);
+  put(8, "WAVE");
+  put(12, "fmt ");
+  o.setUint32(16, 16, true);
+  o.setUint16(20, 1, true);
+  o.setUint16(22, channels, true);
+  o.setUint32(24, rate, true);
+  o.setUint32(28, rate * channels * 2, true);
+  o.setUint16(32, channels * 2, true);
+  o.setUint16(34, 16, true);
+  put(36, "data");
+  o.setUint32(40, pcm.length, true);
+  out.set(pcm, 44);
+  return withStamps(out, [[TEXT_STAMP, stamps.text], [GENERATED_STAMP, stamps.request]]);
+}
+function readGeneratedStampFromFile(path) {
+  let fd;
+  try {
+    fd = openSync(path, "r");
+    const size = fstatSync(fd).size;
+    const head = Buffer.alloc(12);
+    readSync(fd, head, 0, 12, 0);
+    if (head.toString("ascii", 0, 4) !== "RIFF" || head.toString("ascii", 8, 12) !== "WAVE") return null;
+    const hdr = Buffer.alloc(8);
+    for (let pos = 12; pos + 8 <= size; ) {
+      readSync(fd, hdr, 0, 8, pos);
+      const len = hdr.readUInt32LE(4);
+      if (hdr.toString("ascii", 0, 4) === "LIST" && len <= 64 * 1024) {
+        const list = Buffer.alloc(8 + len);
+        readSync(fd, list, 0, list.length, pos);
+        const info = readInfoChunks(new Uint8Array(Buffer.concat([head, list])));
+        const g = info.get(GENERATED_STAMP) ?? info.get("PSVT");
+        if (g) return g;
+      }
+      pos += 8 + len + len % 2;
+    }
+    return null;
+  } catch {
+    return null;
+  } finally {
+    if (fd !== void 0) closeSync(fd);
+  }
+}
+function voiceFor(cast, character, accent) {
+  const m = cast?.find((c) => c.name === character);
+  return m?.placeholderVoice ?? defaultPlaceholderVoice(character, accent, m?.gender);
+}
+function placeholderAccentOf(p) {
+  return p.placeholderSpeech?.accent ?? accentForLanguage(p.locales?.default);
+}
+function planPlaceholderSpeech(loaded, opts = {}) {
+  const p = loaded.project;
+  const ps = p.placeholderSpeech;
+  if (!ps || !p.audioFolders || !p.audioRoot?.trim()) return void 0;
+  const ladder = p.recordingStatuses ?? DEFAULT_RECORDING_STATUSES3;
+  const rung = deriveRecordingFolders2(p.audioRoot, ladder).find((r) => r.name === ps.status);
+  if (!rung?.folder) return void 0;
+  const folder = resolve5(loaded.root, rung.folder);
+  const rank = new Map(ladder.map((r, i) => [r.name, i]));
+  const myRank = rank.get(ps.status) ?? 0;
+  const accent = placeholderAccentOf(p);
+  const snap = opts.snapshot ?? scanAudio(loaded) ?? {};
+  const caps = { open: p.closedCaptions?.open ?? DEFAULT_CAPTION_DELIMITERS.open, close: p.closedCaptions?.close ?? DEFAULT_CAPTION_DELIMITERS.close };
+  const captionCharacter = p.closedCaptions?.character ?? DEFAULT_CAPTION_CHARACTER;
+  const sceneIds = opts.scene ? /* @__PURE__ */ new Set([opts.scene]) : void 0;
+  const plan = { status: ps.status, folder, accent, tasks: [], skipped: {} };
+  const skip = (why) => {
+    plan.skipped[why] = (plan.skipped[why] ?? 0) + 1;
+  };
+  const script = runVoiceScript(loaded, { everything: true });
+  const inScene = sceneIds ? lineIdsInScenes(loaded, sceneIds) : void 0;
+  for (const line of script.lines) {
+    if (opts.only && !opts.only.has(line.id)) continue;
+    if (inScene && !inScene.has(line.id)) continue;
+    const text = stripCaptions(line.text, caps.open, caps.close).replace(/\s+/g, " ").trim();
+    if (!text || line.character === captionCharacter) {
+      skip("unspoken");
+      continue;
+    }
+    const have = snap[line.id];
+    if (have && (rank.get(have.status) ?? 0) > myRank) {
+      skip("better");
+      continue;
+    }
+    const voice = voiceFor(p.cast, line.character, accent);
+    if (!voice) {
+      skip("no-voice");
+      continue;
+    }
+    const request = { text, voice, languageCode: voice.split("-").slice(0, 2).join("-") };
+    const hash = requestHash(request);
+    const forced = opts.force === "all" || opts.force?.has(line.id);
+    if (have && have.status === ps.status) {
+      const stamp = have.generated ?? readGeneratedStampFromFile(have.path);
+      if (!stamp) {
+        skip("not-ours");
+        continue;
+      }
+      if (stamp === hash && !forced) {
+        skip("unchanged");
+        continue;
+      }
+    }
+    plan.tasks.push({ beatId: line.id, character: line.character, request, hash, textHash: textHash(line.text), path: join8(folder, `${line.id}.wav`) });
+  }
+  return plan;
+}
+function lineIdsInScenes(loaded, scenes) {
+  const ids = /* @__PURE__ */ new Set();
+  const walk = (node) => {
+    if (!node || typeof node !== "object") return;
+    const n = node;
+    if (typeof n.id === "string") ids.add(n.id);
+    for (const v of Object.values(node)) if (v && typeof v === "object") walk(v);
+  };
+  for (const s of loaded.scenes) if (scenes.has(s.id)) walk(s);
+  return ids;
+}
+async function runPlaceholderSpeech(tasks, o) {
+  const result = { made: [], failed: [], skippedLocked: [], notTried: 0 };
+  let next = 0, done = 0;
+  const worker = async () => {
+    while (next < tasks.length && !result.stopped && !o.signal?.aborted) {
+      const t = tasks[next++];
+      let wait = 2e3;
+      for (let attempt = 0; ; attempt++) {
+        try {
+          const raw = await synthesize(await o.token(), t.request, o.fetchFn);
+          const bytes = finishTake(raw, { text: t.textHash, request: t.hash });
+          if (await o.write(t.path, bytes)) result.made.push(t.beatId);
+          else result.skippedLocked.push(t.beatId);
+          break;
+        } catch (e) {
+          const kind = e instanceof SpeechError ? e.kind : isNetworkError(e) ? "offline" : void 0;
+          if (kind === "rate" && attempt < 4) {
+            await new Promise((r) => setTimeout(r, wait));
+            wait *= 2;
+            continue;
+          }
+          if (kind === "auth" || kind === "forbidden" || kind === "offline" || kind === "rate") {
+            result.stopped ??= { kind, message: describeSpeechError(e) };
+          } else result.failed.push({ beatId: t.beatId, error: describeSpeechError(e) });
+          break;
+        }
+      }
+      done++;
+      o.onProgress?.(done, tasks.length, t);
+    }
+  };
+  await Promise.all(Array.from({ length: Math.max(1, o.concurrency ?? 2) }, () => worker()));
+  result.notTried = tasks.length - done;
+  return result;
+}
+function tokenSource(key, fetchFn) {
+  let cached;
+  let pending;
+  const auth = (token) => key.kind === "user" ? { token, quotaProject: key.projectId } : { token };
+  return async () => {
+    if (cached && cached.expiresAt > Date.now()) return auth(cached.token);
+    pending ??= mintToken(key, fetchFn).finally(() => {
+      pending = void 0;
+    });
+    cached = await pending;
+    return auth(cached.token);
+  };
+}
+
 // src/play.ts
 import { Engine } from "@patterkit/runtime";
 function runPlay(loaded, opts = {}) {
@@ -3676,23 +4141,23 @@ function renderCoverageText(report, sceneName = (id) => id, opts = {}) {
 }
 
 // src/format.ts
-import { readFileSync as readFileSync8, statSync as statSync3 } from "fs";
-import { dirname as dirname7, resolve as resolve5 } from "path";
+import { readFileSync as readFileSync9, statSync as statSync3 } from "fs";
+import { dirname as dirname7, resolve as resolve6 } from "path";
 import { canonicalStringify as canonicalStringify7, parseSource as parseSource6 } from "@patterkit/core";
 
 // src/extensions.ts
-import { readFileSync as readFileSync7 } from "fs";
-import { join as join8, relative as relative5, sep as sep4 } from "path";
+import { readFileSync as readFileSync8 } from "fs";
+import { join as join9, relative as relative6, sep as sep4 } from "path";
 import { canonicalStringify as canonicalStringify6, parseSource as parseSource5 } from "@patterkit/core";
 import { EXTENSIONS_DIR as EXTENSIONS_DIR3, MANIFEST_EXTENSION as MANIFEST_EXTENSION3 } from "@patterkit/model";
 import { manifestProblems, parseManifest, renameStages, targetOf } from "@wildwinter/toolkit/extensions";
 var CONFLICT_MARKERS = /^(<{7}|={7}|>{7})( |$)/m;
-var manifestPath = (projectDir, id) => join8(projectDir, EXTENSIONS_DIR3, `${id}${MANIFEST_EXTENSION3}`);
+var manifestPath = (projectDir, id) => join9(projectDir, EXTENSIONS_DIR3, `${id}${MANIFEST_EXTENSION3}`);
 function readProjectManifest(projectDir, id) {
   if (!/^[a-z][a-z0-9-]*$/.test(id)) return void 0;
   let text;
   try {
-    text = readFileSync7(manifestPath(projectDir, id), "utf8");
+    text = readFileSync8(manifestPath(projectDir, id), "utf8");
   } catch {
     return void 0;
   }
@@ -3718,7 +4183,7 @@ function planExtensionUpgrades(loaded) {
   };
   const taken = loaded.project.extensions ?? {};
   const moved = {};
-  const rel = (path) => relative5(loaded.root, path).split(sep4).join("/");
+  const rel = (path) => relative6(loaded.root, path).split(sep4).join("/");
   for (const [id, pin] of Object.entries(taken)) {
     const file = loaded.manifests.find((m) => m.id === id);
     const manifest = file !== void 0 ? soundOf(file.manifest) : void 0;
@@ -3755,7 +4220,7 @@ function planExtensionUpgrades(loaded) {
     });
   }
   if (Object.keys(moved).length > 0) {
-    const project = parseSource5(readFileSync7(loaded.projectFile, "utf8"));
+    const project = parseSource5(readFileSync8(loaded.projectFile, "utf8"));
     writes.set(loaded.projectFile, canonicalStringify6({ ...project, extensions: { ...taken, ...moved } }));
   }
   return { writes, report, notes };
@@ -3863,8 +4328,8 @@ function upgradesFor(paths) {
       continue;
     }
     const plan = planExtensionUpgrades(loaded);
-    for (const [file, text] of plan.writes) content.set(resolve5(file), text);
-    for (const [file, lines] of plan.notes) notes.set(resolve5(file), [...notes.get(resolve5(file)) ?? [], ...lines]);
+    for (const [file, text] of plan.writes) content.set(resolve6(file), text);
+    for (const [file, lines] of plan.notes) notes.set(resolve6(file), [...notes.get(resolve6(file)) ?? [], ...lines]);
   }
   return { content, notes };
 }
@@ -3872,11 +4337,11 @@ function runFormat(paths) {
   const upgrades = upgradesFor(paths);
   return paths.flatMap(expand).map((file) => {
     if (!isShard(file)) return { file, changed: false, skipped: true };
-    const original = readFileSync8(file, "utf8");
-    const notes = upgrades.notes.get(resolve5(file));
+    const original = readFileSync9(file, "utf8");
+    const notes = upgrades.notes.get(resolve6(file));
     let canonical;
     try {
-      canonical = upgrades.content.get(resolve5(file)) ?? canonicalStringify7(parseSource6(original));
+      canonical = upgrades.content.get(resolve6(file)) ?? canonicalStringify7(parseSource6(original));
     } catch (e) {
       throw new Error(`${file}: ${e instanceof Error ? e.message : String(e)}`);
     }
@@ -3886,7 +4351,7 @@ function runFormat(paths) {
 }
 
 // src/report.ts
-import { DEFAULT_WRITING_STATUSES, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES2, RERECORD_STATUS as RERECORD_STATUS2, textIsAction as textIsAction2 } from "@patterkit/model";
+import { DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES2, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES4, RERECORD_STATUS as RERECORD_STATUS2, textIsAction as textIsAction2 } from "@patterkit/model";
 var DEFAULT_WORDS_PER_LINE = 6;
 var UNATTRIBUTED = "(unattributed)";
 function allocateLargestRemainder(total, weights) {
@@ -3904,10 +4369,10 @@ function allocateLargestRemainder(total, weights) {
 }
 function runReport(loaded, recordingOverride) {
   const { project } = loaded;
-  const writingLadder = (project.writingStatuses ?? DEFAULT_WRITING_STATUSES).map((s) => s.name);
-  const recordingLadder = (project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES2).map((s) => s.name);
+  const writingLadder = (project.writingStatuses ?? DEFAULT_WRITING_STATUSES2).map((s) => s.name);
+  const recordingLadder = (project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES4).map((s) => s.name);
   const stub = writingLadder[0];
-  const ladderDecls = project.writingStatuses ?? DEFAULT_WRITING_STATUSES;
+  const ladderDecls = project.writingStatuses ?? DEFAULT_WRITING_STATUSES2;
   const recordThreshold = ladderDecls.findIndex((s) => s.readyToRecord);
   const shipThreshold = ladderDecls.findIndex((s) => s.readyToShip);
   const writingIndex = new Map(writingLadder.map((name, i) => [name, i]));
@@ -4104,6 +4569,7 @@ function runReport(loaded, recordingOverride) {
     recordingTracked: (project.voiced ?? false) && (project.trackAudioStatus ?? false),
     writingLadder,
     recordingLadder: reportedRecordingLadder,
+    ...project.placeholderSpeech ? { toRecord: [recordingLadder[0], project.placeholderSpeech.status, RERECORD_STATUS2].reduce((n, st, i, all) => all.indexOf(st) === i ? n + (totals.voiced.byRecording[st] ?? 0) : n, 0) } : {},
     scenes: reports,
     characters: [...characters.values()].sort((a, b) => b.lines + b.estimatedLines - (a.lines + a.estimatedLines)),
     locales,
@@ -4192,6 +4658,7 @@ function renderReportText(data) {
   out.push(`scene status: ${Object.entries(data.scenesByStatus).map(([k, v]) => `${k} ${v}`).join(", ")}`);
   if (data.voiced) out.push(`ready to record: ${t.voiced.readyToRecord} / ready to ship: ${t.voiced.readyToShip} (voiced)`);
   if (data.recordingTracked) out.push(`recording: ${Object.entries(t.voiced.byRecording).map(([k, v]) => `${k} ${v}`).join(", ")}`);
+  if (data.recordingTracked && data.toRecord !== void 0) out.push(`still to record: ${data.toRecord} (counting lines with only placeholder speech)`);
   if (data.estimating) {
     const estLines = data.scenes.reduce((n, s) => n + (s.estimated ? s.estimate ?? 0 : 0), 0);
     out.push(`estimating: ${data.coverage.estimated}/${data.coverage.totalScenes} scene(s) estimated (${estLines} lines)`);
@@ -4574,88 +5041,6 @@ async function xlsxToCatalog(buffer) {
   return { project, defaultLocale, locale, entries };
 }
 
-// src/voice-script.ts
-import { DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES2, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES3, DEFAULT_DOCUMENTATION_CLASSES as DEFAULT_DOCUMENTATION_CLASSES3, projectQualifiers as projectQualifiers3 } from "@patterkit/model";
-function plainVoice(text) {
-  return text.replace(/<\/?(?:b|i|bi)>/g, "").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
-}
-function groupLabel(node, source) {
-  if (node.prompt) return plainVoice(source[node.prompt.id]?.trim() || "option");
-  if (node.selector === "choice") return "";
-  return node.selector ?? "group";
-}
-function runVoiceScript(loaded, opts = {}) {
-  const { project } = loaded;
-  const everything = !!opts.everything;
-  const ladderDecls = project.writingStatuses ?? DEFAULT_WRITING_STATUSES2;
-  const writingLadder = ladderDecls.map((s) => s.name);
-  const recordingLadder = (project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES3).map((s) => s.name);
-  const stub = writingLadder[0];
-  const recordThreshold = ladderDecls.findIndex((s) => s.readyToRecord);
-  const writingIndex = new Map(writingLadder.map((name, i) => [name, i]));
-  const { writing: writingOf, recording: manualRecordingOf, cut: cutSet, rerecord: rerecordSet, documentation: docsOf } = mergeAuthoring2(loaded);
-  const recordingBase = opts.recordingOverride ?? manualRecordingOf;
-  const recordingOf = (id) => effectiveRecording(id, recordingBase, rerecordSet, recordingLadder[0]);
-  const source = sourceStrings(loaded);
-  const actorOf = /* @__PURE__ */ new Map();
-  for (const c of project.cast ?? []) if (c.actor) actorOf.set(c.name, c.actor);
-  const qualifierName = new Map(projectQualifiers3(project).map((q) => [q.gameId, q.name]));
-  const voClasses = classesForChannel(project.documentationClasses ?? DEFAULT_DOCUMENTATION_CLASSES3, "vo");
-  const ownVo = (id) => (docsOf.get(id) ?? []).filter((d) => d.type !== void 0 && voClasses.has(d.type)).map((d) => d.text);
-  const lines = [];
-  const folders = sceneFolderPaths(loaded);
-  let sceneNow = "";
-  const emitLine = (beat, scope, leadingVo) => {
-    if (beat.kind !== "line" || cutSet.has(beat.id)) return false;
-    const ws = writingOf.get(beat.id) ?? stub;
-    if (!everything && recordThreshold !== -1 && (writingIndex.get(ws) ?? 0) < recordThreshold) return false;
-    const own = ownVo(beat.id);
-    const folder = folders.get(sceneNow);
-    lines.push({
-      ...folder ? { folder } : {},
-      scope: scope.join(" \u203A "),
-      id: beat.id,
-      character: beat.character ?? "",
-      ...beat.qualifier ? { qualifier: qualifierName.get(beat.qualifier) ?? beat.qualifier } : {},
-      actor: beat.character ? actorOf.get(beat.character) : void 0,
-      ...beat.direction?.trim() ? { direction: plainVoice(beat.direction.trim()) } : {},
-      text: plainVoice(source[beat.id] ?? ""),
-      comments: leadingVo ? [...leadingVo, ...own] : own,
-      // first line of the run gets the enclosing context
-      recordingStatus: recordingOf(beat.id)
-    });
-    return true;
-  };
-  const walkNode = (node, scope, ancestorVo) => {
-    if (node.type === "group") {
-      if (cutSet.has(node.id)) return;
-      const label = groupLabel(node, source);
-      const childScope = label ? [...scope, label] : scope;
-      const childVo = [...ancestorVo, ...ownVo(node.id)];
-      if (node.prompt) emitLine(node.prompt, childScope, childVo);
-      for (const child2 of node.children ?? []) walkNode(child2, childScope, childVo);
-      return;
-    }
-    if (cutSet.has(node.id)) return;
-    let leading = true;
-    for (const beat of node.beats ?? []) {
-      if (emitLine(beat, scope, leading ? ancestorVo : void 0)) leading = false;
-    }
-  };
-  for (const scene of loaded.scenes) {
-    if (cutSet.has(scene.id)) continue;
-    sceneNow = scene.id;
-    const sceneVo = ownVo(scene.id);
-    for (const block of scene.blocks) {
-      if (cutSet.has(block.id)) continue;
-      const scope = [scene.name, block.name].filter(Boolean);
-      const blockVo = [...sceneVo, ...ownVo(block.id)];
-      for (const child2 of block.children ?? []) walkNode(child2, scope, blockVo);
-    }
-  }
-  return { project: project.project.id, voiced: project.voiced ?? false, recordingLadder, everything, lines };
-}
-
 // src/voice-script-xlsx.ts
 async function voiceScriptToXlsx(data) {
   const { default: ExcelJS } = await import("exceljs");
@@ -4786,9 +5171,9 @@ async function scriptToDocx(doc) {
 import PDFDocument from "pdfkit";
 
 // src/script-fonts.ts
-import { existsSync as existsSync5, readdirSync as readdirSync5, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync6, readdirSync as readdirSync5, readFileSync as readFileSync10 } from "fs";
 import { createRequire } from "module";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 
 // src/script-fonts.json
 var script_fonts_default = {
@@ -4875,18 +5260,18 @@ function useScriptFontFiles(paths, licencePaths = {}) {
   cache.clear();
 }
 function scriptFontLicencePath(pkg) {
-  const dir = (require2.resolve.paths(pkg) ?? []).map((p) => join9(p, pkg)).find((d) => existsSync5(d));
+  const dir = (require2.resolve.paths(pkg) ?? []).map((p) => join10(p, pkg)).find((d) => existsSync6(d));
   const file = dir && readdirSync5(dir).find((f) => /^(licen[cs]e|ofl)/i.test(f));
   if (!dir || !file) throw new Error(`no licence file found for ${pkg}`);
-  return join9(dir, file);
+  return join10(dir, file);
 }
 function scriptFontLicences() {
-  return SCRIPT_FONT_PACKAGES.map((pkg) => ({ package: pkg, text: readFileSync9(licences[pkg] ?? scriptFontLicencePath(pkg), "utf8") }));
+  return SCRIPT_FONT_PACKAGES.map((pkg) => ({ package: pkg, text: readFileSync10(licences[pkg] ?? scriptFontLicencePath(pkg), "utf8") }));
 }
 function scriptFontFiles(face) {
   return script_fonts_default[face].map((spec) => {
     let bytes = cache.get(spec);
-    if (!bytes) cache.set(spec, bytes = readFileSync9(located[spec] ?? require2.resolve(spec)));
+    if (!bytes) cache.set(spec, bytes = readFileSync10(located[spec] ?? require2.resolve(spec)));
     return bytes;
   });
 }
@@ -4926,7 +5311,7 @@ var ROLES = {
   "Mono": "mono"
 };
 async function scriptToPdf(doc) {
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve9, reject) => {
     const pdf = new PDFDocument({ size: "A4", margins: { top: MARGIN, bottom: MARGIN, left: MARGIN, right: MARGIN }, info: { Title: doc.project, Author: "Patter" }, font: null });
     const register = (prefix, face, firstIsPrefix) => scriptFontFiles(face).map((bytes, i) => {
       const name = firstIsPrefix && i === 0 ? prefix : `${prefix}~${i}`;
@@ -4970,7 +5355,7 @@ async function scriptToPdf(doc) {
     const bodyPieces = (runs, color, base = {}) => runs.flatMap((r) => r.code ? split(r.text, "Mono", ACCENT) : split(r.text, SERIF2(base.bold || r.bold, base.italic || r.italic), color));
     const chunks = [];
     pdf.on("data", (c) => chunks.push(c));
-    pdf.on("end", () => resolve8(Buffer.concat(chunks)));
+    pdf.on("end", () => resolve9(Buffer.concat(chunks)));
     pdf.on("error", reject);
     const pageRight = pdf.page.width - MARGIN;
     const pageBottom = pdf.page.height - MARGIN;
@@ -5128,8 +5513,8 @@ async function scriptToPdf(doc) {
 }
 
 // src/init.ts
-import { join as join10, basename as basename6, resolve as resolve6 } from "path";
-import { readdirSync as readdirSync6, existsSync as existsSync6, readFileSync as readFileSync10 } from "fs";
+import { join as join11, basename as basename6, resolve as resolve7 } from "path";
+import { readdirSync as readdirSync6, existsSync as existsSync7, readFileSync as readFileSync11 } from "fs";
 import { newId, slug, canonicalStringify as canonicalStringify8 } from "@patterkit/core";
 import { FLOW_SCHEMA, PROJECT_SCHEMA, STRINGS_SCHEMA as STRINGS_SCHEMA2, MANIFEST_EXTENSION as MANIFEST_EXTENSION4, EXTENSIONS_DIR as EXTENSIONS_DIR4 } from "@patterkit/model";
 import { vcsConfigFiles, bundlePostureOf } from "@wildwinter/toolkit/vcs";
@@ -5144,7 +5529,7 @@ var PATTER_VCS_FORMAT = {
   conflict: CONFLICT_SIDECAR.slice(1)
 };
 function runInit(opts) {
-  const dir = resolve6(opts.dir);
+  const dir = resolve7(opts.dir);
   const name = opts.name?.trim() || basename6(dir).replace(/\.patter$/, "");
   const fileSlug = slug(name);
   let existing = [];
@@ -5195,27 +5580,27 @@ function runInit(opts) {
     strings: { [beatId]: `Welcome to ${name}. This is the first line of your story - replace it with your own.` }
   };
   const bundle = opts.bundle ?? "commit";
-  const projectFile = join10(dir, `${fileSlug}.patterproj`);
+  const projectFile = join11(dir, `${fileSlug}.patterproj`);
   const writes = [
-    { path: join10(dir, "scenes", "start.patterflow"), content: canonicalStringify8(flow) },
-    { path: join10(dir, "loc", "en", "start.patterloc"), content: canonicalStringify8(locale) },
-    { path: join10(dir, ".editorconfig"), content: EDITORCONFIG },
+    { path: join11(dir, "scenes", "start.patterflow"), content: canonicalStringify8(flow) },
+    { path: join11(dir, "loc", "en", "start.patterloc"), content: canonicalStringify8(locale) },
+    { path: join11(dir, ".editorconfig"), content: EDITORCONFIG },
     ...vcsConfigWrites(dir, opts.vcs, bundle),
     { path: projectFile, content: canonicalStringify8(project) }
   ];
-  const collisions = writes.map((w) => w.path).filter((p) => existsSync6(p));
+  const collisions = writes.map((w) => w.path).filter((p) => existsSync7(p));
   if (collisions.length > 0) {
     throw new Error(`refusing to overwrite existing file(s): ${collisions.join(", ")}`);
   }
   return { writes, projectFile, name };
 }
 function vcsConfigWrites(dir, vcs, bundle = "commit") {
-  return vcsConfigFiles(PATTER_VCS_FORMAT, vcs, bundle).map((f) => ({ path: join10(dir, f.path), content: f.content }));
+  return vcsConfigFiles(PATTER_VCS_FORMAT, vcs, bundle).map((f) => ({ path: join11(dir, f.path), content: f.content }));
 }
 function currentBundlePosture(dir, vcs) {
   return bundlePostureOf(PATTER_VCS_FORMAT, vcs, (name) => {
     try {
-      return readFileSync10(join10(dir, name), "utf8");
+      return readFileSync11(join11(dir, name), "utf8");
     } catch {
       return void 0;
     }
@@ -5235,7 +5620,7 @@ indent_size = 2
 `;
 
 // src/resolve.ts
-import { walkNodes as walkNodes4, effectiveGameId as effectiveGameId2, DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES3, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES4 } from "@patterkit/model";
+import { walkNodes as walkNodes4, effectiveGameId as effectiveGameId2, DEFAULT_WRITING_STATUSES as DEFAULT_WRITING_STATUSES3, DEFAULT_RECORDING_STATUSES as DEFAULT_RECORDING_STATUSES5 } from "@patterkit/model";
 import { defaultFor } from "@wildwinter/scoperegistry";
 import { parseFieldQuery, fieldNameMatches, fieldValueMatches, fieldValueText } from "@wildwinter/toolkit";
 function runResolve(loaded, query) {
@@ -5277,7 +5662,7 @@ function runStatusBrowse(loaded, status, dimension = "writing", focus, recording
   const merged = mergeAuthoring2(loaded);
   const recording = dimension === "recording";
   const statusOf = recording ? recordingOverride ?? merged.recording : merged.writing;
-  const ladder = recording ? loaded.project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES4 : loaded.project.writingStatuses ?? DEFAULT_WRITING_STATUSES3;
+  const ladder = recording ? loaded.project.recordingStatuses ?? DEFAULT_RECORDING_STATUSES5 : loaded.project.writingStatuses ?? DEFAULT_WRITING_STATUSES3;
   const lowest = ladder[0]?.name;
   const statusAt = (id) => recording ? effectiveRecording(id, statusOf, merged.rerecord, lowest ?? "") : statusOf.get(id) ?? lowest;
   const out = [];
@@ -5655,7 +6040,7 @@ function runReplace(loaded, opts) {
 }
 
 // src/pin.ts
-import { readFileSync as readFileSync11 } from "fs";
+import { readFileSync as readFileSync12 } from "fs";
 import { canonicalStringify as canonicalStringify10, parseSource as parseSource7 } from "@patterkit/core";
 import { effectiveGameId as effectiveGameId3, gameIdify } from "@patterkit/model";
 function toPin(node) {
@@ -5683,7 +6068,7 @@ function planPins(loaded) {
     });
     if (!changed) continue;
     const next = { ...scene, ...sceneGameId !== void 0 ? { gameId: sceneGameId } : {}, blocks };
-    const file = parseSource7(readFileSync11(path, "utf8"));
+    const file = parseSource7(readFileSync12(path, "utf8"));
     plan.writes.push({ path, content: canonicalStringify10({ ...file, scene: next }) });
     plan.scenes.push(next);
   }
@@ -5692,8 +6077,8 @@ function planPins(loaded) {
 
 // src/unpack.ts
 import JSZip2 from "jszip";
-import { join as join11, resolve as resolve7, sep as sep5 } from "path";
-import { existsSync as existsSync7, readFileSync as readFileSync12, readdirSync as readdirSync7 } from "fs";
+import { join as join12, resolve as resolve8, sep as sep5 } from "path";
+import { existsSync as existsSync8, readFileSync as readFileSync13, readdirSync as readdirSync7 } from "fs";
 import { parseSource as parseSource8, canonicalStringify as canonicalStringify11 } from "@patterkit/core";
 import { isUnsafeEntry } from "@wildwinter/toolkit/archive";
 import { SCOPES_FILE_SUFFIX as SCOPES_FILE_SUFFIX2 } from "@wildwinter/scoperegistry/scopes";
@@ -5767,7 +6152,7 @@ function projectIdIn(dir) {
   }
   for (const n of names) {
     try {
-      const id = parseSource8(readFileSync12(join11(dir, n), "utf8")).project?.id;
+      const id = parseSource8(readFileSync13(join12(dir, n), "utf8")).project?.id;
       if (id) return id;
     } catch {
     }
@@ -5794,7 +6179,7 @@ function checkProvenance(returned, base, target) {
 }
 function targetProjectId(projectDir) {
   try {
-    const pf = parseSource8(readFileSync12(findProjectFile(projectDir), "utf8"));
+    const pf = parseSource8(readFileSync13(findProjectFile(projectDir), "utf8"));
     return pf.project?.id;
   } catch {
     return void 0;
@@ -5817,13 +6202,13 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
   for (const [rel, theirText] of [...theirs.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
     const outPath = containedWrite(projectDir, rel);
     const baseText = base.get(rel);
-    if (!existsSync7(outPath)) {
+    if (!existsSync8(outPath)) {
       if (baseText === theirText) continue;
       writes.push({ path: outPath, content: theirText });
       shards.push({ path: rel, added: true, changed: true });
       continue;
     }
-    const oursText = readFileSync12(outPath, "utf8");
+    const oursText = readFileSync13(outPath, "utf8");
     if (isManifestEntry(rel)) {
       if (theirText !== oursText) manifestsKept.push(rel);
       shards.push({ path: rel, added: false, changed: false });
@@ -5864,23 +6249,23 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
     shards.push({ path: rel, result, added: false, changed });
   }
   let gameScopes;
-  const local2 = projectSides && discoverGameScopes(resolve7(projectDir), projectSides.ours).gameScopes;
+  const local2 = projectSides && discoverGameScopes(resolve8(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: join11(local2.dir, GAME_SCOPES_FILE), error: world.error };
+    } else if (world.error) gameScopes = { path: join12(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 (!existsSync7(outPath)) {
+    if (!existsSync8(outPath)) {
       writes.push({ path: outPath, content: theirText });
       handoffs.push(rel);
       continue;
     }
-    const merged = mergeHandoff(parseHandoff(readFileSync12(outPath, "utf8")), parseHandoff(theirText));
+    const merged = mergeHandoff(parseHandoff(readFileSync13(outPath, "utf8")), parseHandoff(theirText));
     if (merged) {
       writes.push({ path: outPath, content: serialiseHandoff(merged) });
       handoffs.push(rel);
@@ -5913,8 +6298,8 @@ function projectEntry(shards) {
   return at.length === 1 ? at[0] : void 0;
 }
 function containedWrite(dir, name) {
-  const root = resolve7(dir);
-  const full = resolve7(join11(dir, name));
+  const root = resolve8(dir);
+  const full = resolve8(join12(dir, name));
   if (full !== root && !full.startsWith(root + sep5)) {
     throw new UnsafeEntryError(`document entry escapes the target directory: ${name}`);
   }
@@ -5922,7 +6307,7 @@ function containedWrite(dir, name) {
 }
 
 // src/resolutions.ts
-import { readFileSync as readFileSync13 } from "fs";
+import { readFileSync as readFileSync14 } from "fs";
 import { canonicalStringify as canonicalStringify12, parseSource as parseSource9 } from "@patterkit/core";
 import { DEFAULT_QUALIFIERS as DEFAULT_QUALIFIERS2 } from "@patterkit/model";
 import { clearUnresolved, unresolvedOf } from "@wildwinter/toolkit/extensions";
@@ -6070,7 +6455,7 @@ function findMarkedShards(root) {
   for (const file of SHARD_EXTENSIONS.flatMap((ext) => tree.get(ext)).sort()) {
     let text;
     try {
-      text = readFileSync13(file, "utf8");
+      text = readFileSync14(file, "utf8");
     } catch {
       continue;
     }
@@ -6087,7 +6472,7 @@ function findMarkedShards(root) {
     if (sidecars.has(sidecarPath)) {
       found.sidecarPath = sidecarPath;
       try {
-        const s = JSON.parse(readFileSync13(sidecarPath, "utf8"));
+        const s = JSON.parse(readFileSync14(sidecarPath, "utf8"));
         found.sidecar = { ...typeof s.type === "string" ? { type: s.type } : {}, conflicts: Array.isArray(s.conflicts) ? s.conflicts : [], warnings: Array.isArray(s.warnings) ? s.warnings : [] };
       } catch {
       }
@@ -6099,12 +6484,21 @@ function findMarkedShards(root) {
 
 // src/cast-rename.ts
 import { castStringKey as castStringKey2, speakerLabelKey as speakerLabelKey2, walkNodes as walkNodes6 } from "@patterkit/model";
+import { defaultPlaceholderVoice as defaultPlaceholderVoice2 } from "@patterkit/core";
 function keepCastColours(cast, renames) {
   for (const [from, to] of renames) {
     const m = cast.find((c) => c.name === to);
     if (m && !isColourSlot(m.colour)) m.colour = colourIndex(from);
   }
 }
+function keepPlaceholderVoices(cast, renames, accent) {
+  for (const [from, to] of renames) {
+    const m = cast.find((c) => c.name === to);
+    if (!m || m.placeholderVoice) continue;
+    const voice = defaultPlaceholderVoice2(from, accent, m.gender);
+    if (voice) m.placeholderVoice = voice;
+  }
+}
 function cleanCastRenames(renames) {
   const out = /* @__PURE__ */ new Map();
   for (const [from, to] of Object.entries(renames ?? {})) if (from && to && from !== to) out.set(from, to);
@@ -6162,7 +6556,7 @@ function renameCastStrings(loc, renames) {
 }
 
 // src/suggestions.ts
-import { readFileSync as readFileSync14 } from "fs";
+import { readFileSync as readFileSync15 } from "fs";
 import { canonicalStringify as canonicalStringify13, parseSource as parseSource10 } from "@patterkit/core";
 import { walkNodes as walkNodes7, AUTHORING_SCHEMA as AUTHORING_SCHEMA3 } from "@patterkit/model";
 function staleParts(s, liveText, line) {
@@ -6249,7 +6643,7 @@ var Working = class {
     if (!path) return void 0;
     let file = this.flows.get(path);
     if (!file) {
-      const onDisk = parseSource10(readFileSync14(path, "utf8"));
+      const onDisk = parseSource10(readFileSync15(path, "utf8"));
       const scene = this.loaded.scenes.find((s) => s.id === sceneId);
       file = { ...onDisk, scene: structuredClone(scene ?? onDisk.scene) };
       this.flows.set(path, file);
@@ -6729,11 +7123,11 @@ function readParagraphs(ps, joiner) {
     c.walk(p, "both");
     return c;
   });
-  const join12 = (view) => parts.map((c) => c.text(view)).filter((t) => t !== "").join(joiner);
+  const join13 = (view) => parts.map((c) => c.text(view)).filter((t) => t !== "").join(joiner);
   return {
     text: {
-      proposed: join12("proposed"),
-      original: join12("original"),
+      proposed: join13("proposed"),
+      original: join13("original"),
       changes: parts.flatMap((c) => c.changes),
       comments: [...new Set(parts.flatMap((c) => c.comments))],
       droppedFormatting: parts.reduce((n, c) => n + c.dropped, 0)
@@ -7315,6 +7709,7 @@ export {
   PATTER_SCOPES_FILE,
   PATTER_SCOPES_OWNER,
   PATTER_VCS_FORMAT,
+  PLACEHOLDER_SAMPLE_RATE,
   PROJECT_HANDLED,
   RARE_REACH_PCT,
   REFUSE_MISSING_SHARE,
@@ -7322,6 +7717,7 @@ export {
   SCRIPT_FONT_FILES,
   SCRIPT_FONT_PACKAGES,
   SHARD_EXTENSIONS,
+  SpeechError,
   UnsafeEntryError,
   UnsupportedMergeError,
   actionTextChanges,
@@ -7355,19 +7751,23 @@ export {
   defaultGameScopesDir,
   describeLocExport,
   describeLocImport,
+  describeSpeechError,
   detectMergeType,
   discoverGameScopes,
   drivableScopes,
   effectDescriber,
+  expandKeyPath,
   exportBlockers,
   exportEditableScript,
   extractLoc,
   findMarkedShards,
   findProjectFile,
+  finishTake,
   formatMarker,
   gameScopeTokens,
   gameScopesCatalogue,
   gameScopesSnapshot,
+  gcloudCredentialsPath,
   handoffPath,
   handoffWrite,
   hostScopeTokens,
@@ -7377,6 +7777,7 @@ export {
   issueMarkerCodes,
   jsonToCatalog,
   keepCastColours,
+  keepPlaceholderVoices,
   leastReachedFirst,
   listGameDataFields,
   listOpenSuggestions,
@@ -7385,8 +7786,10 @@ export {
   loadProjectLanding,
   loadedExtensions,
   locLineHomes,
+  manifestLineIds,
   manifestPath,
   markerLength,
+  mintToken,
   moveCastKeys,
   newHandoffId,
   parseHandoff,
@@ -7394,10 +7797,12 @@ export {
   patterScopesStale,
   patterScopesWrite,
   pickAudio,
+  placeholderAccentOf,
   planBuild,
   planEditableImport,
   planExtensionUpgrades,
   planPins,
+  planPlaceholderSpeech,
   planReturnedWorld,
   planShareScopes,
   planWorldSave,
@@ -7410,6 +7815,8 @@ export {
   reachabilityIssues,
   readEditableDocx,
   readGameScopes,
+  readGeneratedStampFromFile,
+  readGoogleKey,
   readHandoff,
   readHandoffs,
   readMarker,
@@ -7423,7 +7830,9 @@ export {
   renderCoverageText,
   renderPlay,
   renderReportText,
+  requestHash,
   resolveDocumentation,
+  resolveKeyFile,
   resolveStart,
   runCoverage,
   runCoverageAsync,
@@ -7436,6 +7845,7 @@ export {
   runInit,
   runMerge,
   runPack,
+  runPlaceholderSpeech,
   runPlay,
   runPropertyUsage,
   runReplace,
@@ -7464,14 +7874,19 @@ export {
   setCut,
   sidecarIssues,
   soundManifest,
+  sourceStrings,
   stageDialect,
   stageGateCount,
   staleParts,
+  storedKeyPath,
+  synthesize,
+  tokenSource,
   unresolvedClashes,
   unresolvedMarkIssues,
   useScriptFontFiles,
   valueAtClashPath,
   vcsConfigWrites,
+  voiceFor,
   voiceScriptToXlsx,
   worldSettingsScopes,
   xlsxToCatalog