@patterkit/core 1.0.0 → 1.1.0

package/dist/index.cjs

@@ -20,20 +20,34 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  GENERATED_STAMP: () => GENERATED_STAMP,
+  PLACEHOLDER_ACCENTS: () => PLACEHOLDER_ACCENTS,
+  TEXT_STAMP: () => TEXT_STAMP,
+  accentForLanguage: () => accentForLanguage,
   canonicalStringify: () => canonicalStringify,
+  defaultPlaceholderVoice: () => defaultPlaceholderVoice,
+  describePlaceholderVoice: () => describePlaceholderVoice,
   effectiveGameId: () => import_model5.effectiveGameId,
   gameIdify: () => import_model5.gameIdify,
   hash32: () => hash32,
   hash4: () => hash4,
   humanizeNodeRefs: () => humanizeNodeRefs,
+  infoListChunk: () => infoListChunk,
   isValidGameId: () => import_model5.isValidGameId,
+  isWav: () => isWav,
   neverRunNodes: () => neverRunNodes,
   newId: () => import_toolkit.newId,
-  parseSource: () => import_toolkit3.parseSource,
+  parseSource: () => import_toolkit4.parseSource,
+  placeholderAccent: () => placeholderAccent,
   planProject: () => planProject,
   planScene: () => planScene,
+  readGeneratedStamp: () => readGeneratedStamp,
+  readInfoChunks: () => readInfoChunks,
+  readTextStamp: () => readTextStamp,
   slug: () => slug,
-  validateProject: () => validateProject
+  textHash: () => textHash,
+  validateProject: () => validateProject,
+  withStamps: () => withStamps
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -62,26 +76,242 @@ function humanizeNodeRefs(cond, label) {
   return cond.replace(VISIT_FN_RE, (_m, fn, _q, quoted, bare) => `${fn}(${label(quoted ?? bare ?? "")})`);
 }
 
+// src/placeholder-voices.ts
+var import_toolkit3 = require("@wildwinter/toolkit");
+var v = (name, gender) => ({ name, gender });
+var PLACEHOLDER_ACCENTS = [
+  { code: "en-GB", label: "English (British)", voices: [
+    v("en-GB-Standard-A", "female"),
+    v("en-GB-Standard-B", "male"),
+    v("en-GB-Standard-C", "female"),
+    v("en-GB-Standard-D", "male"),
+    v("en-GB-Standard-F", "female")
+  ] },
+  { code: "en-US", label: "English (American)", voices: [
+    v("en-US-Standard-A", "male"),
+    v("en-US-Standard-B", "male"),
+    v("en-US-Standard-C", "female"),
+    v("en-US-Standard-D", "male"),
+    v("en-US-Standard-E", "female"),
+    v("en-US-Standard-F", "female"),
+    v("en-US-Standard-G", "female"),
+    v("en-US-Standard-H", "female"),
+    v("en-US-Standard-I", "male"),
+    v("en-US-Standard-J", "male")
+  ] },
+  { code: "en-AU", label: "English (Australian)", voices: [
+    v("en-AU-Standard-A", "female"),
+    v("en-AU-Standard-B", "male"),
+    v("en-AU-Standard-C", "female"),
+    v("en-AU-Standard-D", "male")
+  ] },
+  { code: "en-IN", label: "English (Indian)", voices: [
+    v("en-IN-Standard-A", "female"),
+    v("en-IN-Standard-B", "male"),
+    v("en-IN-Standard-C", "male"),
+    v("en-IN-Standard-D", "female")
+  ] },
+  { code: "de-DE", label: "German", voices: [
+    v("de-DE-Standard-A", "female"),
+    v("de-DE-Standard-B", "male"),
+    v("de-DE-Standard-C", "female"),
+    v("de-DE-Standard-D", "male"),
+    v("de-DE-Standard-E", "male"),
+    v("de-DE-Standard-F", "female")
+  ] },
+  { code: "fr-FR", label: "French", voices: [
+    v("fr-FR-Standard-A", "female"),
+    v("fr-FR-Standard-B", "male"),
+    v("fr-FR-Standard-C", "female"),
+    v("fr-FR-Standard-D", "male"),
+    v("fr-FR-Standard-E", "female")
+  ] },
+  { code: "es-ES", label: "Spanish (Spain)", voices: [
+    v("es-ES-Standard-A", "female"),
+    v("es-ES-Standard-B", "male"),
+    v("es-ES-Standard-C", "female"),
+    v("es-ES-Standard-D", "female")
+  ] },
+  { code: "it-IT", label: "Italian", voices: [
+    v("it-IT-Standard-A", "female"),
+    v("it-IT-Standard-B", "female"),
+    v("it-IT-Standard-C", "male"),
+    v("it-IT-Standard-D", "male")
+  ] },
+  { code: "sv-SE", label: "Swedish", voices: [
+    v("sv-SE-Standard-A", "female"),
+    v("sv-SE-Standard-B", "female"),
+    v("sv-SE-Standard-C", "female"),
+    v("sv-SE-Standard-D", "male"),
+    v("sv-SE-Standard-E", "male")
+  ] },
+  { code: "ja-JP", label: "Japanese", voices: [
+    v("ja-JP-Standard-A", "female"),
+    v("ja-JP-Standard-B", "female"),
+    v("ja-JP-Standard-C", "male"),
+    v("ja-JP-Standard-D", "male")
+  ] }
+];
+function placeholderAccent(code) {
+  const want = code?.replace(/_/g, "-").toLowerCase();
+  return want === void 0 ? void 0 : PLACEHOLDER_ACCENTS.find((a) => a.code.toLowerCase() === want);
+}
+function accentForLanguage(locale) {
+  if (!locale) return void 0;
+  const exact = placeholderAccent(locale);
+  if (exact) return exact.code;
+  const lang = locale.split(/[-_]/)[0].toLowerCase();
+  const same = PLACEHOLDER_ACCENTS.filter((a) => a.code.split("-")[0].toLowerCase() === lang);
+  return same[0]?.code;
+}
+function defaultPlaceholderVoice(name, accent, gender) {
+  const voices = placeholderAccent(accent)?.voices;
+  if (!voices?.length) return void 0;
+  const h = (0, import_toolkit3.fnv32)(name);
+  const pick = voices[h % voices.length];
+  const want = gender?.trim().toLowerCase();
+  if (want !== "male" && want !== "female" || pick.gender === want) return pick.name;
+  const fitting = voices.filter((x) => x.gender === want);
+  return fitting.length ? fitting[h % fitting.length].name : pick.name;
+}
+function describePlaceholderVoice(voice) {
+  for (const a of PLACEHOLDER_ACCENTS) {
+    const sameGender = (g) => a.voices.filter((x) => x.gender === g);
+    const found = a.voices.find((x) => x.name === voice);
+    if (found) {
+      const n = sameGender(found.gender).indexOf(found) + 1;
+      return `${found.gender === "female" ? "Female" : "Male"}, ${a.label} ${n}`;
+    }
+  }
+  return voice;
+}
+
+// src/take-stamp.ts
+var TEXT_STAMP = "PTRK";
+var TEXT_STAMP_OLD = "DINK";
+var GENERATED_STAMP = "PTPS";
+var GENERATED_STAMP_OTHER = "PSVT";
+function normalizeForHash(input) {
+  return input.replace(/<\/?(?:b|i|bi)>/g, "").replace(/[^\p{L}\p{N}\s]/gu, "").replace(/\s+/g, " ").trim();
+}
+function textHash(input) {
+  const text = normalizeForHash(input);
+  if (!text) return "000000";
+  let hash = 2166136261;
+  for (let i = 0; i < text.length; i++) {
+    hash ^= text.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  const bytes = [hash & 255, hash >>> 8 & 255, hash >>> 16 & 255, hash >>> 24 & 255];
+  return btoa(String.fromCharCode(...bytes)).slice(0, 6);
+}
+var ascii = (bytes, at, n) => {
+  let s = "";
+  for (let i = 0; i < n && at + i < bytes.length; i++) s += String.fromCharCode(bytes[at + i]);
+  return s;
+};
+var u32 = (bytes, at) => (bytes[at] | bytes[at + 1] << 8 | bytes[at + 2] << 16 | bytes[at + 3] << 24) >>> 0;
+function isWav(bytes) {
+  return bytes.length >= 12 && ascii(bytes, 0, 4) === "RIFF" && ascii(bytes, 8, 4) === "WAVE";
+}
+function readInfoChunks(bytes) {
+  const out = /* @__PURE__ */ new Map();
+  if (!isWav(bytes)) return out;
+  let pos = 12;
+  while (pos + 8 <= bytes.length) {
+    const id = ascii(bytes, pos, 4);
+    const size = u32(bytes, pos + 4);
+    const body = pos + 8;
+    if (id === "LIST" && ascii(bytes, body, 4) === "INFO") {
+      const end = Math.min(body + size, bytes.length);
+      let sub = body + 4;
+      while (sub + 8 <= end) {
+        const subId = ascii(bytes, sub, 4);
+        const subSize = u32(bytes, sub + 4);
+        out.set(subId, ascii(bytes, sub + 8, subSize).replace(/\0+$/, ""));
+        sub += 8 + subSize + subSize % 2;
+      }
+    }
+    pos = body + size + size % 2;
+  }
+  return out;
+}
+function readTextStamp(bytes) {
+  const info = readInfoChunks(bytes);
+  return info.get(TEXT_STAMP) ?? info.get(TEXT_STAMP_OLD) ?? null;
+}
+function readGeneratedStamp(bytes) {
+  const info = readInfoChunks(bytes);
+  return info.get(GENERATED_STAMP) ?? info.get(GENERATED_STAMP_OTHER) ?? null;
+}
+function infoListChunk(stamps) {
+  const parts = stamps.map(([id, value]) => {
+    const data = new TextEncoder().encode(value + "\0");
+    const padded = data.length + data.length % 2;
+    const sub = new Uint8Array(8 + padded);
+    for (let i = 0; i < 4; i++) sub[i] = id.charCodeAt(i);
+    new DataView(sub.buffer).setUint32(4, data.length, true);
+    sub.set(data, 8);
+    return sub;
+  });
+  const content = 4 + parts.reduce((n, p) => n + p.length, 0);
+  const out = new Uint8Array(8 + content);
+  const view = new DataView(out.buffer);
+  out.set([76, 73, 83, 84], 0);
+  view.setUint32(4, content, true);
+  out.set([73, 78, 70, 79], 8);
+  let at = 12;
+  for (const p of parts) {
+    out.set(p, at);
+    at += p.length;
+  }
+  return out;
+}
+function withStamps(wav, stamps) {
+  if (!isWav(wav)) throw new Error("not a WAV file");
+  const kept = [];
+  let pos = 12;
+  while (pos + 8 <= wav.length) {
+    const id = ascii(wav, pos, 4);
+    const size = u32(wav, pos + 4);
+    const next = Math.min(pos + 8 + size + size % 2, wav.length);
+    if (!(id === "LIST" && ascii(wav, pos + 8, 4) === "INFO")) kept.push(wav.subarray(pos, next));
+    pos = next;
+  }
+  const list = infoListChunk(stamps);
+  const total = 12 + kept.reduce((n, c) => n + c.length, 0) + list.length;
+  const out = new Uint8Array(total);
+  out.set(wav.subarray(0, 12), 0);
+  let at = 12;
+  for (const c of kept) {
+    out.set(c, at);
+    at += c.length;
+  }
+  out.set(list, at);
+  new DataView(out.buffer).setUint32(4, total - 8, true);
+  return out;
+}
+
 // src/serialize.ts
 var import_json5 = require("json5");
-var import_toolkit3 = require("@wildwinter/toolkit");
+var import_toolkit4 = require("@wildwinter/toolkit");
 function canonicalStringify(value, opts) {
   return write(value, "", opts?.trailingComma ?? true) + "\n";
 }
-function write(v, indent, tc) {
-  if (v === null || typeof v === "boolean" || typeof v === "number") return JSON.stringify(v);
-  if (typeof v === "string") return JSON.stringify(v);
+function write(v2, indent, tc) {
+  if (v2 === null || typeof v2 === "boolean" || typeof v2 === "number") return JSON.stringify(v2);
+  if (typeof v2 === "string") return JSON.stringify(v2);
   const tail = tc ? "," : "";
-  if (Array.isArray(v)) {
-    if (v.length === 0) return "[]";
+  if (Array.isArray(v2)) {
+    if (v2.length === 0) return "[]";
     const next = indent + "  ";
-    const items = v.map((x) => next + write(x, next, tc));
+    const items = v2.map((x) => next + write(x, next, tc));
     return `[
 ${items.join(",\n")}${tail}
 ${indent}]`;
   }
-  if (typeof v === "object") {
-    const obj = v;
+  if (typeof v2 === "object") {
+    const obj = v2;
     const keys = Object.keys(obj).filter((k) => obj[k] !== void 0).sort();
     if (keys.length === 0) return "{}";
     const next = indent + "  ";
@@ -260,7 +490,7 @@ function contentlessJumpCycles(scenes) {
         code: "jump-cycle",
         severity: "warning",
         id: via[0],
-        message: `${via.length === 1 ? `snippet '${via[0]}' jumps` : `snippets ${via.map((v) => `'${v}'`).join(", ")} jump`} round a loop with nothing to deliver (blocks ${[...loop, at].map((b) => `'${b}'`).join(" -> ")}); play reaching it never gets out`
+        message: `${via.length === 1 ? `snippet '${via[0]}' jumps` : `snippets ${via.map((v2) => `'${v2}'`).join(", ")} jump`} round a loop with nothing to deliver (blocks ${[...loop, at].map((b) => `'${b}'`).join(" -> ")}); play reaching it never gets out`
       });
     }
     for (const b of path) settled.add(b);
@@ -936,18 +1166,32 @@ function planScene(target, scaffold) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  GENERATED_STAMP,
+  PLACEHOLDER_ACCENTS,
+  TEXT_STAMP,
+  accentForLanguage,
   canonicalStringify,
+  defaultPlaceholderVoice,
+  describePlaceholderVoice,
   effectiveGameId,
   gameIdify,
   hash32,
   hash4,
   humanizeNodeRefs,
+  infoListChunk,
   isValidGameId,
+  isWav,
   neverRunNodes,
   newId,
   parseSource,
+  placeholderAccent,
   planProject,
   planScene,
+  readGeneratedStamp,
+  readInfoChunks,
+  readTextStamp,
   slug,
-  validateProject
+  textHash,
+  validateProject,
+  withStamps
 });

package/dist/index.d.cts

@@ -16,6 +16,57 @@ declare function hash32(input: string): string;
  */
 declare function humanizeNodeRefs(cond: string, label: (id: string) => string): string;
 
+type VoiceGender = "female" | "male";
+interface PlaceholderVoice {
+    name: string;
+    gender: VoiceGender;
+}
+interface PlaceholderAccent {
+    code: string;
+    label: string;
+    voices: readonly PlaceholderVoice[];
+}
+/** The accents on offer, in the order the settings page lists them. */
+declare const PLACEHOLDER_ACCENTS: readonly PlaceholderAccent[];
+/** The accent for a code, or undefined when it isn't one on offer. */
+declare function placeholderAccent(code: string | undefined): PlaceholderAccent | undefined;
+/** The accent a project's main language implies: an exact match (`en-GB`), else the first accent on offer for
+ *  that language, so a bare `en` is British English (Ian, 2026-11-10), changeable in settings. Undefined for a
+ *  language with no accent on offer. */
+declare function accentForLanguage(locale: string | undefined): string | undefined;
+/** The voice a character gets with none chosen: a hash of their name picks from the accent's voices; when
+ *  their gender is male or female (any case) and that pick is the other, the pick moves within that gender's
+ *  voices. Characters whose pick already fits keep it, so setting a gender changes only the voices that were
+ *  wrong. Undefined when the accent isn't one on offer. */
+declare function defaultPlaceholderVoice(name: string, accent: string | undefined, gender?: string): string | undefined;
+/** A voice's name in words, for the Cast editor: "Female, English (British) 2". Falls back to the raw name. */
+declare function describePlaceholderVoice(voice: string): string;
+
+/** The text-hash stamp's chunk id, and the older name it's still read under. */
+declare const TEXT_STAMP = "PTRK";
+/** Placeholder Speech's request-hash stamp, and Patterstage's name for the same thing. */
+declare const GENERATED_STAMP = "PTPS";
+/** FNV-1a (32-bit) of the NORMALISED line text -> 4 little-endian bytes -> base64 -> first 6 chars.
+ *  Empty (after normalising) -> "000000". */
+declare function textHash(input: string): string;
+/** Whether the bytes start as a RIFF/WAVE file. */
+declare function isWav(bytes: Uint8Array): boolean;
+/** Every LIST/INFO sub-chunk in a WAV, by id, as text (trailing NULs dropped). Walks the RIFF chunks, so it
+ *  works wherever the list sits. Empty for anything that isn't a WAV. Reading only needs the file's chunk
+ *  headers and the list itself, so a caller may pass just the head of a large file when the list comes first. */
+declare function readInfoChunks(bytes: Uint8Array): Map<string, string>;
+/** A take's text-hash stamp (`PTRK`, else the older `DINK`), or null when it has none. */
+declare function readTextStamp(bytes: Uint8Array): string | null;
+/** A take's generated-speech stamp (`PTPS`, else Patterstage's `PSVT`), or null for a person's take. */
+declare function readGeneratedStamp(bytes: Uint8Array): string | null;
+/** A LIST/INFO chunk holding these sub-chunks, in order. Each value is written as ASCII with a NUL terminator
+ *  and padded to an even length, as RIFF wants. */
+declare function infoListChunk(stamps: Array<[string, string]>): Uint8Array;
+/** The same WAV with its LIST/INFO chunks replaced by one holding `stamps` (any other INFO entries, such as an
+ *  encoder's, are dropped), appended after the audio, with the RIFF size fixed. Throws on bytes that aren't a
+ *  WAV. */
+declare function withStamps(wav: Uint8Array, stamps: Array<[string, string]>): Uint8Array;
+
 /** Options for {@link canonicalStringify}. */
 interface StringifyOptions {
     /** Emit a trailing comma after the last item/entry (the canonical SOURCE form).
@@ -138,4 +189,4 @@ declare function planProject(opts: {
 /** Plan a stub scene for a card. Pure: nothing is read or written. */
 declare function planScene(target: ScenePlanTarget, scaffold: SceneScaffold): ScenePlan;
 
-export { type NeverRuns, type ProjectInput, type RunTreeNode, type ScenePlan, type ScenePlanTarget, type SceneScaffold, type StringifyOptions, type ValidationIssue, canonicalStringify, hash32, hash4, humanizeNodeRefs, neverRunNodes, planProject, planScene, slug, validateProject };
+export { GENERATED_STAMP, type NeverRuns, PLACEHOLDER_ACCENTS, type PlaceholderAccent, type PlaceholderVoice, type ProjectInput, type RunTreeNode, type ScenePlan, type ScenePlanTarget, type SceneScaffold, type StringifyOptions, TEXT_STAMP, type ValidationIssue, type VoiceGender, accentForLanguage, canonicalStringify, defaultPlaceholderVoice, describePlaceholderVoice, hash32, hash4, humanizeNodeRefs, infoListChunk, isWav, neverRunNodes, placeholderAccent, planProject, planScene, readGeneratedStamp, readInfoChunks, readTextStamp, slug, textHash, validateProject, withStamps };

package/dist/index.d.ts

@@ -16,6 +16,57 @@ declare function hash32(input: string): string;
  */
 declare function humanizeNodeRefs(cond: string, label: (id: string) => string): string;
 
+type VoiceGender = "female" | "male";
+interface PlaceholderVoice {
+    name: string;
+    gender: VoiceGender;
+}
+interface PlaceholderAccent {
+    code: string;
+    label: string;
+    voices: readonly PlaceholderVoice[];
+}
+/** The accents on offer, in the order the settings page lists them. */
+declare const PLACEHOLDER_ACCENTS: readonly PlaceholderAccent[];
+/** The accent for a code, or undefined when it isn't one on offer. */
+declare function placeholderAccent(code: string | undefined): PlaceholderAccent | undefined;
+/** The accent a project's main language implies: an exact match (`en-GB`), else the first accent on offer for
+ *  that language, so a bare `en` is British English (Ian, 2026-11-10), changeable in settings. Undefined for a
+ *  language with no accent on offer. */
+declare function accentForLanguage(locale: string | undefined): string | undefined;
+/** The voice a character gets with none chosen: a hash of their name picks from the accent's voices; when
+ *  their gender is male or female (any case) and that pick is the other, the pick moves within that gender's
+ *  voices. Characters whose pick already fits keep it, so setting a gender changes only the voices that were
+ *  wrong. Undefined when the accent isn't one on offer. */
+declare function defaultPlaceholderVoice(name: string, accent: string | undefined, gender?: string): string | undefined;
+/** A voice's name in words, for the Cast editor: "Female, English (British) 2". Falls back to the raw name. */
+declare function describePlaceholderVoice(voice: string): string;
+
+/** The text-hash stamp's chunk id, and the older name it's still read under. */
+declare const TEXT_STAMP = "PTRK";
+/** Placeholder Speech's request-hash stamp, and Patterstage's name for the same thing. */
+declare const GENERATED_STAMP = "PTPS";
+/** FNV-1a (32-bit) of the NORMALISED line text -> 4 little-endian bytes -> base64 -> first 6 chars.
+ *  Empty (after normalising) -> "000000". */
+declare function textHash(input: string): string;
+/** Whether the bytes start as a RIFF/WAVE file. */
+declare function isWav(bytes: Uint8Array): boolean;
+/** Every LIST/INFO sub-chunk in a WAV, by id, as text (trailing NULs dropped). Walks the RIFF chunks, so it
+ *  works wherever the list sits. Empty for anything that isn't a WAV. Reading only needs the file's chunk
+ *  headers and the list itself, so a caller may pass just the head of a large file when the list comes first. */
+declare function readInfoChunks(bytes: Uint8Array): Map<string, string>;
+/** A take's text-hash stamp (`PTRK`, else the older `DINK`), or null when it has none. */
+declare function readTextStamp(bytes: Uint8Array): string | null;
+/** A take's generated-speech stamp (`PTPS`, else Patterstage's `PSVT`), or null for a person's take. */
+declare function readGeneratedStamp(bytes: Uint8Array): string | null;
+/** A LIST/INFO chunk holding these sub-chunks, in order. Each value is written as ASCII with a NUL terminator
+ *  and padded to an even length, as RIFF wants. */
+declare function infoListChunk(stamps: Array<[string, string]>): Uint8Array;
+/** The same WAV with its LIST/INFO chunks replaced by one holding `stamps` (any other INFO entries, such as an
+ *  encoder's, are dropped), appended after the audio, with the RIFF size fixed. Throws on bytes that aren't a
+ *  WAV. */
+declare function withStamps(wav: Uint8Array, stamps: Array<[string, string]>): Uint8Array;
+
 /** Options for {@link canonicalStringify}. */
 interface StringifyOptions {
     /** Emit a trailing comma after the last item/entry (the canonical SOURCE form).
@@ -138,4 +189,4 @@ declare function planProject(opts: {
 /** Plan a stub scene for a card. Pure: nothing is read or written. */
 declare function planScene(target: ScenePlanTarget, scaffold: SceneScaffold): ScenePlan;
 
-export { type NeverRuns, type ProjectInput, type RunTreeNode, type ScenePlan, type ScenePlanTarget, type SceneScaffold, type StringifyOptions, type ValidationIssue, canonicalStringify, hash32, hash4, humanizeNodeRefs, neverRunNodes, planProject, planScene, slug, validateProject };
+export { GENERATED_STAMP, type NeverRuns, PLACEHOLDER_ACCENTS, type PlaceholderAccent, type PlaceholderVoice, type ProjectInput, type RunTreeNode, type ScenePlan, type ScenePlanTarget, type SceneScaffold, type StringifyOptions, TEXT_STAMP, type ValidationIssue, type VoiceGender, accentForLanguage, canonicalStringify, defaultPlaceholderVoice, describePlaceholderVoice, hash32, hash4, humanizeNodeRefs, infoListChunk, isWav, neverRunNodes, placeholderAccent, planProject, planScene, readGeneratedStamp, readInfoChunks, readTextStamp, slug, textHash, validateProject, withStamps };

package/dist/index.js

@@ -23,26 +23,242 @@ function humanizeNodeRefs(cond, label) {
   return cond.replace(VISIT_FN_RE, (_m, fn, _q, quoted, bare) => `${fn}(${label(quoted ?? bare ?? "")})`);
 }
 
+// src/placeholder-voices.ts
+import { fnv32 as fnv322 } from "@wildwinter/toolkit";
+var v = (name, gender) => ({ name, gender });
+var PLACEHOLDER_ACCENTS = [
+  { code: "en-GB", label: "English (British)", voices: [
+    v("en-GB-Standard-A", "female"),
+    v("en-GB-Standard-B", "male"),
+    v("en-GB-Standard-C", "female"),
+    v("en-GB-Standard-D", "male"),
+    v("en-GB-Standard-F", "female")
+  ] },
+  { code: "en-US", label: "English (American)", voices: [
+    v("en-US-Standard-A", "male"),
+    v("en-US-Standard-B", "male"),
+    v("en-US-Standard-C", "female"),
+    v("en-US-Standard-D", "male"),
+    v("en-US-Standard-E", "female"),
+    v("en-US-Standard-F", "female"),
+    v("en-US-Standard-G", "female"),
+    v("en-US-Standard-H", "female"),
+    v("en-US-Standard-I", "male"),
+    v("en-US-Standard-J", "male")
+  ] },
+  { code: "en-AU", label: "English (Australian)", voices: [
+    v("en-AU-Standard-A", "female"),
+    v("en-AU-Standard-B", "male"),
+    v("en-AU-Standard-C", "female"),
+    v("en-AU-Standard-D", "male")
+  ] },
+  { code: "en-IN", label: "English (Indian)", voices: [
+    v("en-IN-Standard-A", "female"),
+    v("en-IN-Standard-B", "male"),
+    v("en-IN-Standard-C", "male"),
+    v("en-IN-Standard-D", "female")
+  ] },
+  { code: "de-DE", label: "German", voices: [
+    v("de-DE-Standard-A", "female"),
+    v("de-DE-Standard-B", "male"),
+    v("de-DE-Standard-C", "female"),
+    v("de-DE-Standard-D", "male"),
+    v("de-DE-Standard-E", "male"),
+    v("de-DE-Standard-F", "female")
+  ] },
+  { code: "fr-FR", label: "French", voices: [
+    v("fr-FR-Standard-A", "female"),
+    v("fr-FR-Standard-B", "male"),
+    v("fr-FR-Standard-C", "female"),
+    v("fr-FR-Standard-D", "male"),
+    v("fr-FR-Standard-E", "female")
+  ] },
+  { code: "es-ES", label: "Spanish (Spain)", voices: [
+    v("es-ES-Standard-A", "female"),
+    v("es-ES-Standard-B", "male"),
+    v("es-ES-Standard-C", "female"),
+    v("es-ES-Standard-D", "female")
+  ] },
+  { code: "it-IT", label: "Italian", voices: [
+    v("it-IT-Standard-A", "female"),
+    v("it-IT-Standard-B", "female"),
+    v("it-IT-Standard-C", "male"),
+    v("it-IT-Standard-D", "male")
+  ] },
+  { code: "sv-SE", label: "Swedish", voices: [
+    v("sv-SE-Standard-A", "female"),
+    v("sv-SE-Standard-B", "female"),
+    v("sv-SE-Standard-C", "female"),
+    v("sv-SE-Standard-D", "male"),
+    v("sv-SE-Standard-E", "male")
+  ] },
+  { code: "ja-JP", label: "Japanese", voices: [
+    v("ja-JP-Standard-A", "female"),
+    v("ja-JP-Standard-B", "female"),
+    v("ja-JP-Standard-C", "male"),
+    v("ja-JP-Standard-D", "male")
+  ] }
+];
+function placeholderAccent(code) {
+  const want = code?.replace(/_/g, "-").toLowerCase();
+  return want === void 0 ? void 0 : PLACEHOLDER_ACCENTS.find((a) => a.code.toLowerCase() === want);
+}
+function accentForLanguage(locale) {
+  if (!locale) return void 0;
+  const exact = placeholderAccent(locale);
+  if (exact) return exact.code;
+  const lang = locale.split(/[-_]/)[0].toLowerCase();
+  const same = PLACEHOLDER_ACCENTS.filter((a) => a.code.split("-")[0].toLowerCase() === lang);
+  return same[0]?.code;
+}
+function defaultPlaceholderVoice(name, accent, gender) {
+  const voices = placeholderAccent(accent)?.voices;
+  if (!voices?.length) return void 0;
+  const h = fnv322(name);
+  const pick = voices[h % voices.length];
+  const want = gender?.trim().toLowerCase();
+  if (want !== "male" && want !== "female" || pick.gender === want) return pick.name;
+  const fitting = voices.filter((x) => x.gender === want);
+  return fitting.length ? fitting[h % fitting.length].name : pick.name;
+}
+function describePlaceholderVoice(voice) {
+  for (const a of PLACEHOLDER_ACCENTS) {
+    const sameGender = (g) => a.voices.filter((x) => x.gender === g);
+    const found = a.voices.find((x) => x.name === voice);
+    if (found) {
+      const n = sameGender(found.gender).indexOf(found) + 1;
+      return `${found.gender === "female" ? "Female" : "Male"}, ${a.label} ${n}`;
+    }
+  }
+  return voice;
+}
+
+// src/take-stamp.ts
+var TEXT_STAMP = "PTRK";
+var TEXT_STAMP_OLD = "DINK";
+var GENERATED_STAMP = "PTPS";
+var GENERATED_STAMP_OTHER = "PSVT";
+function normalizeForHash(input) {
+  return input.replace(/<\/?(?:b|i|bi)>/g, "").replace(/[^\p{L}\p{N}\s]/gu, "").replace(/\s+/g, " ").trim();
+}
+function textHash(input) {
+  const text = normalizeForHash(input);
+  if (!text) return "000000";
+  let hash = 2166136261;
+  for (let i = 0; i < text.length; i++) {
+    hash ^= text.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  const bytes = [hash & 255, hash >>> 8 & 255, hash >>> 16 & 255, hash >>> 24 & 255];
+  return btoa(String.fromCharCode(...bytes)).slice(0, 6);
+}
+var ascii = (bytes, at, n) => {
+  let s = "";
+  for (let i = 0; i < n && at + i < bytes.length; i++) s += String.fromCharCode(bytes[at + i]);
+  return s;
+};
+var u32 = (bytes, at) => (bytes[at] | bytes[at + 1] << 8 | bytes[at + 2] << 16 | bytes[at + 3] << 24) >>> 0;
+function isWav(bytes) {
+  return bytes.length >= 12 && ascii(bytes, 0, 4) === "RIFF" && ascii(bytes, 8, 4) === "WAVE";
+}
+function readInfoChunks(bytes) {
+  const out = /* @__PURE__ */ new Map();
+  if (!isWav(bytes)) return out;
+  let pos = 12;
+  while (pos + 8 <= bytes.length) {
+    const id = ascii(bytes, pos, 4);
+    const size = u32(bytes, pos + 4);
+    const body = pos + 8;
+    if (id === "LIST" && ascii(bytes, body, 4) === "INFO") {
+      const end = Math.min(body + size, bytes.length);
+      let sub = body + 4;
+      while (sub + 8 <= end) {
+        const subId = ascii(bytes, sub, 4);
+        const subSize = u32(bytes, sub + 4);
+        out.set(subId, ascii(bytes, sub + 8, subSize).replace(/\0+$/, ""));
+        sub += 8 + subSize + subSize % 2;
+      }
+    }
+    pos = body + size + size % 2;
+  }
+  return out;
+}
+function readTextStamp(bytes) {
+  const info = readInfoChunks(bytes);
+  return info.get(TEXT_STAMP) ?? info.get(TEXT_STAMP_OLD) ?? null;
+}
+function readGeneratedStamp(bytes) {
+  const info = readInfoChunks(bytes);
+  return info.get(GENERATED_STAMP) ?? info.get(GENERATED_STAMP_OTHER) ?? null;
+}
+function infoListChunk(stamps) {
+  const parts = stamps.map(([id, value]) => {
+    const data = new TextEncoder().encode(value + "\0");
+    const padded = data.length + data.length % 2;
+    const sub = new Uint8Array(8 + padded);
+    for (let i = 0; i < 4; i++) sub[i] = id.charCodeAt(i);
+    new DataView(sub.buffer).setUint32(4, data.length, true);
+    sub.set(data, 8);
+    return sub;
+  });
+  const content = 4 + parts.reduce((n, p) => n + p.length, 0);
+  const out = new Uint8Array(8 + content);
+  const view = new DataView(out.buffer);
+  out.set([76, 73, 83, 84], 0);
+  view.setUint32(4, content, true);
+  out.set([73, 78, 70, 79], 8);
+  let at = 12;
+  for (const p of parts) {
+    out.set(p, at);
+    at += p.length;
+  }
+  return out;
+}
+function withStamps(wav, stamps) {
+  if (!isWav(wav)) throw new Error("not a WAV file");
+  const kept = [];
+  let pos = 12;
+  while (pos + 8 <= wav.length) {
+    const id = ascii(wav, pos, 4);
+    const size = u32(wav, pos + 4);
+    const next = Math.min(pos + 8 + size + size % 2, wav.length);
+    if (!(id === "LIST" && ascii(wav, pos + 8, 4) === "INFO")) kept.push(wav.subarray(pos, next));
+    pos = next;
+  }
+  const list = infoListChunk(stamps);
+  const total = 12 + kept.reduce((n, c) => n + c.length, 0) + list.length;
+  const out = new Uint8Array(total);
+  out.set(wav.subarray(0, 12), 0);
+  let at = 12;
+  for (const c of kept) {
+    out.set(c, at);
+    at += c.length;
+  }
+  out.set(list, at);
+  new DataView(out.buffer).setUint32(4, total - 8, true);
+  return out;
+}
+
 // src/serialize.ts
 import "json5";
 import { parseSource } from "@wildwinter/toolkit";
 function canonicalStringify(value, opts) {
   return write(value, "", opts?.trailingComma ?? true) + "\n";
 }
-function write(v, indent, tc) {
-  if (v === null || typeof v === "boolean" || typeof v === "number") return JSON.stringify(v);
-  if (typeof v === "string") return JSON.stringify(v);
+function write(v2, indent, tc) {
+  if (v2 === null || typeof v2 === "boolean" || typeof v2 === "number") return JSON.stringify(v2);
+  if (typeof v2 === "string") return JSON.stringify(v2);
   const tail = tc ? "," : "";
-  if (Array.isArray(v)) {
-    if (v.length === 0) return "[]";
+  if (Array.isArray(v2)) {
+    if (v2.length === 0) return "[]";
     const next = indent + "  ";
-    const items = v.map((x) => next + write(x, next, tc));
+    const items = v2.map((x) => next + write(x, next, tc));
     return `[
 ${items.join(",\n")}${tail}
 ${indent}]`;
   }
-  if (typeof v === "object") {
-    const obj = v;
+  if (typeof v2 === "object") {
+    const obj = v2;
     const keys = Object.keys(obj).filter((k) => obj[k] !== void 0).sort();
     if (keys.length === 0) return "{}";
     const next = indent + "  ";
@@ -221,7 +437,7 @@ function contentlessJumpCycles(scenes) {
         code: "jump-cycle",
         severity: "warning",
         id: via[0],
-        message: `${via.length === 1 ? `snippet '${via[0]}' jumps` : `snippets ${via.map((v) => `'${v}'`).join(", ")} jump`} round a loop with nothing to deliver (blocks ${[...loop, at].map((b) => `'${b}'`).join(" -> ")}); play reaching it never gets out`
+        message: `${via.length === 1 ? `snippet '${via[0]}' jumps` : `snippets ${via.map((v2) => `'${v2}'`).join(", ")} jump`} round a loop with nothing to deliver (blocks ${[...loop, at].map((b) => `'${b}'`).join(" -> ")}); play reaching it never gets out`
       });
     }
     for (const b of path) settled.add(b);
@@ -896,18 +1112,32 @@ function planScene(target, scaffold) {
   };
 }
 export {
+  GENERATED_STAMP,
+  PLACEHOLDER_ACCENTS,
+  TEXT_STAMP,
+  accentForLanguage,
   canonicalStringify,
+  defaultPlaceholderVoice,
+  describePlaceholderVoice,
   effectiveGameId2 as effectiveGameId,
   gameIdify,
   hash32,
   hash4,
   humanizeNodeRefs,
+  infoListChunk,
   isValidGameId2 as isValidGameId,
+  isWav,
   neverRunNodes,
   newId,
   parseSource,
+  placeholderAccent,
   planProject,
   planScene,
+  readGeneratedStamp,
+  readInfoChunks,
+  readTextStamp,
   slug,
-  validateProject
+  textHash,
+  validateProject,
+  withStamps
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patterkit/core",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Patter core: stable id generation, readable-handle computation, canonical (de)serialisation, and the structural validator.",
   "keywords": [
     "patter",
@@ -46,9 +46,9 @@
     "build": "tsup src/index.ts --format esm,cjs --dts --clean"
   },
   "dependencies": {
-    "@patterkit/model": "1.0.0",
-    "@wildwinter/expr": "^1.0.0",
-    "@wildwinter/toolkit": "^1.0.0",
+    "@patterkit/model": "1.1.0",
+    "@wildwinter/expr": "^1.0.1",
+    "@wildwinter/toolkit": "^1.2.0",
     "json5": "^2.2.3"
   }
 }