// Kale's voices: technical terms from words/terms.tsv (written form, the words to say), replaced as // whole tokens before the text rules. A dictionary lookup, so it never decides what something means. import { readTable } from "./words/kaleTts.js"; const escape = (text: string) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"); /** The replacer for a terms table's text: longest written form first, case as written. */ export function termsReplacer(table: string): (text: string) => string { const terms = readTable(table); if (terms.size === 0) return (text) => text; // A written form starting with "." is a suffix too: ".js" also matches in "Node.js" and "main.js". const forms = [...terms.keys()] .toSorted((a, b) => b.length - a.length) .map((form) => (form.startsWith(".") ? escape(form) : `(? text.replace(pattern, (form: string, at: number, whole: string) => { const spoken = terms.get(form) ?? form; // A suffix right after a word gets its own word: "Node.js" -> "Node dot J S". return form.startsWith(".") && at > 0 && /[\p{L}\p{N}]/u.test(whole[at - 1]!) ? ` ${spoken}` : spoken; }); // Again after the split, for the words it frees ("getUserById" -> "... By Id" -> "... by ID"). return (text) => lookUp(splitCamelCase(lookUp(text))); } /** * camelCase code names as their words ("getUserById" -> "get User By Id"): a word starting in lower * case with capitals inside reads as one garbled word otherwise. Only that form, after the * dictionary, so listed names (useEffect, WebGPU, iOS) keep their own reading. */ const CAMEL = /(? text.replace(CAMEL, (word) => word.replace(/(?<=[a-z0-9])(?=[A-Z])/g, " "));