@gentbajko/slopify 4.0.0 → 4.2.0

package/dist/slices/keywords/digest.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { keywordSpecs } from "./specs.js";
 // The keyword digest: one call to the project's AI model reads the article once and writes every
 // digest keyword (`{{Slopify_Summary}}`, `{{Slopify_Hook}}`…), so a run that uses several pays for
@@ -39,7 +40,7 @@ const digestSchema = z.object({
     tags: listOrText,
 });
 export function checkDigest(text) {
-    const fix = "Use Try again; if it keeps happening, choose another model in the Providers section of Edit project.";
+    const fix = `Use Try again; if it keeps happening, choose another model in ${editSettings.writer}.`;
     const parsed = digestSchema.safeParse(jsonObjectOf(text));
     if (!parsed.success)
         return {

package/dist/slices/keywords/rules.js

@@ -167,7 +167,7 @@ export function placedProblems(bodies, values) {
                 field,
                 message: place === "title"
                     ? problem.message
-                    : `${problem.message} Change the prompt in Library, or pick another one.`,
+                    : `${problem.message} Change the prompt in Prompts, or pick another one.`,
             });
         }
     return problems;
@@ -180,7 +180,7 @@ export function textEntryProblems(body, category) {
         ? [
             {
                 field: category,
-                message: `{{Slopify_Release_Date}} can't be used in a Text ${category}: Text is narrated as written, and the release date is only filled in when a step asks the AI model. Set this ${category}'s Mode to LLM in Library → Intros & Outros, or remove the keyword.`,
+                message: `{{Slopify_Release_Date}} can't be used in an ${category} that says these exact words: those are narrated as written, and the release date is only filled in when a step asks the AI model. In Prompts → Intros and outros, set this ${category}'s What the narrator reads to Let the AI write it from these instructions, or remove the keyword.`,
             },
         ]
         : [];

package/dist/slices/keywords/specs.js

@@ -38,7 +38,7 @@ export const keywordSpecs = [
     {
         name: "Slopify_Series",
         filler: "facts",
-        fills: "The channel's series brief from Channels → Edit. A line with an empty brief is left out.",
+        fills: "The channel's series brief, from the channel's page under Name and look. A line with an empty brief is left out.",
         example: "Calm histories of how things were made, one invention at a time.",
         available: atStart,
         places: everywhere,
@@ -88,7 +88,7 @@ export const keywordSpecs = [
     {
         name: "Slopify_Release_Date",
         filler: "release",
-        fills: "The release date from the posting plan. A line with no date is left out; moving the date later doesn't remake anything.",
+        fills: "The release date from the posting plan. A line with no date is left out; moving the date later makes nothing again.",
         example: "Thursday 22 October 2026",
         available: "When the step runs.",
         places: everywhere,
@@ -138,8 +138,8 @@ export const keywordSpecs = [
     {
         name: "Slopify_Brand",
         filler: "facts",
-        fills: "The brand kit's caption and title colours and font names. A line with an empty kit is left out.",
-        example: "Colours: #f5c542, #101010. Fonts: Barlow Condensed",
+        fills: "The brand kit's caption and title colors and font names. A line with an empty kit is left out.",
+        example: "Colors: #f5c542, #101010. Fonts: Barlow Condensed",
         available: atStart,
         places: pictures,
         cost: "free",
@@ -229,7 +229,7 @@ export const keywordSpecs = [
     {
         name: "Slopify_Mood",
         filler: "scenes",
-        fills: "The feeling of this picture's moment, for its light and colour.",
+        fills: "The feeling of this picture's moment, for its light and color.",
         example: "tense",
         available: sceneAvailable,
         places: pictures,

package/dist/slices/keywords/values.js

@@ -37,7 +37,7 @@ function brandText(brand) {
     if (brand === undefined)
         return "";
     const parts = [
-        ...(brand.colours.length === 0 ? [] : [`Colours: ${brand.colours.join(", ")}.`]),
+        ...(brand.colours.length === 0 ? [] : [`Colors: ${brand.colours.join(", ")}.`]),
         ...(brand.fonts.length === 0 ? [] : [`Fonts: ${brand.fonts.join(", ")}.`]),
     ];
     return parts.join(" ");

package/dist/slices/library/transfer.js

@@ -17,7 +17,7 @@ const itemsMax = 10_000;
 const sectionWords = {
     prompts: "prompts",
     entries: "intros or outros",
-    documentThemes: "PDF themes",
+    documentThemes: "PDF looks",
     aliases: "narration aliases",
 };
 // Only what the editor saves travels: ids, keywords and dates are the install's own.
@@ -93,7 +93,7 @@ export function readLibraryFile(text, section) {
     if (!top.success)
         return {
             ok: false,
-            message: `it isn't a Slopify library file. Pick a .json file made by Export on a Library tab.`,
+            message: `it isn't a Slopify library file. Pick a .json file made by Export on Prompts, the PDF looks or Pronunciation.`,
         };
     if (top.data.version > libraryFileVersion)
         return {
@@ -104,7 +104,7 @@ export function readLibraryFile(text, section) {
     if (!Array.isArray(list) || list.length === 0)
         return {
             ok: false,
-            message: `it holds no ${what}. Import it on the Library tab it was exported from.`,
+            message: `it holds no ${what}. Import it on the page it was exported from.`,
         };
     if (list.length > itemsMax)
         return {

package/dist/slices/loudness/loudnorm.js

@@ -1,5 +1,6 @@
 import { renameSync, rmSync } from "node:fs";
 import { z } from "zod";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { runFfmpeg } from "../video/ffmpeg.js";
 // ceiling: below -70 LUFS (the filter's absolute gate) or under 0.4 s (one measuring block)
 // there is nothing to measure: a piece that quiet or short is left as it is.
@@ -97,7 +98,7 @@ export async function measure(run, input, goal, chain = "") {
     });
     const measured = parseMeasured(stderr);
     if (measured === undefined)
-        throw new Error("Slopify couldn't measure the loudness of the narration (ffmpeg printed no measurement). Try again; if it happens again, turn off Level the volume in Edit project → Pauses and volume, then use Download diagnostics in Settings and report it.");
+        throw new Error(`Slopify couldn't measure the loudness of the narration (ffmpeg printed no measurement). Try again; if it happens again, turn off Level the volume in ${editSettings.sound}, then use Download diagnostics in Settings and report it.`);
     return measured;
 }
 export async function measureFile(run, path, goal) {

package/dist/slices/loudness/model.js

@@ -9,10 +9,11 @@
 // The ambient bed and the shorts' music are mixed before the master and ducked by the levelled
 // voice, so they keep their place under it.
 //
-// Browser-safe: Play, Edit project and Settings convert the same numbers.
+// Browser-safe: Create, Edit settings and Settings convert the same numbers.
 //
 // A run without the setting has no `loudness` at all, which is what every project saved before
 // it was, and every recipe leaves it out of its fingerprint then.
+import { createRows, editSettings } from "../../kernel/ports/settings-places.js";
 // YouTube and Spotify play everything back at about -14 LUFS, so a video mastered there is
 // neither turned down nor left quiet. Audiobook shops ask for about -18 to -20 LUFS with more
 // headroom, so the listening files sit lower.
@@ -87,7 +88,7 @@ export function loudnessProblem(lufs, target) {
         db >= loudnessDbMin - 1e-9 &&
         db <= loudnessDbMax + 1e-9
         ? undefined
-        : `The volume must be between ${String(loudnessDbMin)} dB and +${String(loudnessDbMax)} dB of the recommended level, in steps of ${String(loudnessDbStep)} dB. Change it under Level the volume (Play → Video and style, Edit project → Pauses and volume, or Settings → General).`;
+        : `The volume must be between ${String(loudnessDbMin)} dB and +${String(loudnessDbMax)} dB of the recommended level, in steps of ${String(loudnessDbStep)} dB. Change it under Level the volume (${createRows.video}, ${editSettings.sound}, or Settings → Production defaults).`;
 }
 export function loudnessFields(settings) {
     if (settings === undefined)

package/dist/slices/loudness/sentence-level.js

@@ -1,6 +1,7 @@
 import { spawn } from "node:child_process";
 import { mkdirSync } from "node:fs";
 import { isAbsolute, join, resolve as resolvePath } from "node:path";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { measurePiece } from "../narration/pauses.js";
 import { runFfmpeg } from "../video/ffmpeg.js";
 import { sentenceLevel } from "./sentence-level-model.js";
@@ -243,7 +244,7 @@ export async function meterFile(run, file) {
             else if (code === 0)
                 resolve();
             else
-                reject(new Error(`Slopify couldn't measure a narration piece's sentences (ffmpeg said: ${errors.trim().split("\n").at(-1) ?? "nothing"}). Try again; if it happens again, turn off Level each sentence in Edit project → Pauses and volume, then use Download diagnostics in Settings and report it.`));
+                reject(new Error(`Slopify couldn't measure a narration piece's sentences (ffmpeg said: ${errors.trim().split("\n").at(-1) ?? "nothing"}). Try again; if it happens again, turn off Level each sentence in ${editSettings.sound}, then use Download diagnostics in Settings and report it.`));
         });
     });
     return meter.readings();

package/dist/slices/model-checks/rules.js

@@ -110,3 +110,16 @@ export function dollarsText(dollars, unpriced = 0) {
     const more = `${String(unpriced)} model${unpriced === 1 ? "" : "s"} with no listed price`;
     return dollars <= 0 ? `${more} (price unknown)` : `${base}, plus ${more}`;
 }
+// The same estimate as the end of a sentence, "this costs …": "about $0.04 at list price",
+// and for models with no listed price "an unknown amount: 3 models have no listed price".
+export function costPhrase(dollars, unpriced = 0) {
+    const base = dollars <= 0
+        ? "nothing"
+        : `${dollars < 0.01 ? "less than a cent" : `about $${dollars.toFixed(2)}`} at list price`;
+    if (unpriced === 0)
+        return base;
+    const models = `${String(unpriced)} model${unpriced === 1 ? "" : "s"}`;
+    return dollars <= 0
+        ? `an unknown amount: ${models} ${unpriced === 1 ? "has" : "have"} no listed price`
+        : `${base}, plus an unknown amount for ${models} with no listed price`;
+}

package/dist/slices/model-upkeep/model.js

@@ -3,7 +3,7 @@
 export const usageSlots = ["llm", "audio", "images", "animate"];
 export const usageKinds = ["template", "schedule", "draft", "project"];
 export const slotLabels = {
-    llm: "Text model",
+    llm: "Writing model",
     audio: "Voice model",
     images: "Image model",
     animate: "Animation model",

package/dist/slices/model-upkeep/switch.js

@@ -94,7 +94,7 @@ export async function switchRetiredModel(deps, catalogue, request) {
             if (row.version !== row.head)
                 return {
                     ok: false,
-                    message: "This schedule runs an older version of its template. In Library → Schedules, choose Edit, pick the template again so it runs the latest version, then save.",
+                    message: "This schedule runs an older version of its template. In Calendar → Schedules, choose Edit, pick the template again so it runs the latest version, then save.",
                 };
             return switchTemplate(deps, catalogue, request, String(row.templateId));
         }
@@ -117,7 +117,7 @@ function switchTemplate(deps, catalogue, request, templateId) {
         return {
             ok: false,
             message: error.reason === "missing-prompt"
-                ? `The template "${template.name}" uses a prompt or intro/outro that was deleted, so it cannot be saved. Open it in Library → Templates, choose another, and save.`
+                ? `The template "${template.name}" uses a prompt or intro/outro that was deleted, so it cannot be saved. Open it in Templates → Edit template, choose another, and save.`
                 : changedMeanwhile,
         };
     }
@@ -230,7 +230,7 @@ async function switchProject(deps, catalogue, request) {
                 ? " because the project changed meanwhile"
                 : "fields" in saved && saved.fields?.[0] !== undefined
                     ? ` (${saved.fields[0].message})`
-                    : ""}. Open the project, choose Edit project and change it under Providers.`,
+                    : ""}. Open the project and change it in Edit settings.`,
         };
 }
 // "Switch all": every listed use that has a suggestion and no reason to hold back, one by one.

package/dist/slices/model-upkeep/usage.js

@@ -13,6 +13,17 @@ export { slotLabels, usageKinds, usageSlots } from "./model.js";
 function familyOf(slot) {
     return slot === "llm" ? "llm" : slot === "audio" ? "tts" : "image";
 }
+// A Create draft's name as Create's header says it: its title once every keyword in it is
+// filled, else "Untitled draft". Never a raw {{Topic}}.
+function draftName(title, values) {
+    const filled = title
+        .replace(/\{\{\s*([^{}]+?)\s*\}\}/g, (keyword, name) => {
+        const value = values[name]?.trim() ?? "";
+        return value === "" ? keyword : value;
+    })
+        .trim();
+    return filled === "" || filled.includes("{{") ? "Untitled draft" : filled;
+}
 // The model choices a Play form (a draft or a template) makes.
 export function formChoices(form) {
     const edit = form.videoEdit;
@@ -155,7 +166,7 @@ export function choiceSites(db) {
             choices: formChoices(template.document.form),
             blocked: head === row.template_version
                 ? null
-                : `This schedule runs an older version of the template "${template.name}". In Library → Schedules, choose Edit, pick the template again so it runs the latest version, then save.`,
+                : `This schedule runs an older version of the template "${template.name}". In Calendar → Schedules, choose Edit, pick the template again so it runs the latest version, then save.`,
         });
     }
     for (const row of draftRows(db)) {
@@ -167,7 +178,7 @@ export function choiceSites(db) {
         sites.push({
             kind: "draft",
             id: row.id,
-            name: row.title.trim() === "" ? "Untitled draft" : row.title,
+            name: draftName(row.title, document.form.values),
             choices: formChoices(document.form),
             blocked: null,
         });

package/dist/slices/narration/breaths.js

@@ -2,6 +2,7 @@ import { mkdirSync, rmSync } from "node:fs";
 import { open, stat } from "node:fs/promises";
 import { join } from "node:path";
 import { errorText } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { runFfmpeg } from "../video/ffmpeg.js";
 import { breathRate, scanBreaths, softenChunk } from "./breaths-detect.js";
 // Soften breaths, made in the join (`breaths-model.ts` says why there). Each narration piece is
@@ -39,7 +40,7 @@ export async function softenBreaths(run, files, directory) {
         catch (error) {
             if (run.signal.aborted)
                 throw error;
-            throw new Error(`Soften breaths could not process narration piece ${String(index + 1)} (${errorText(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Soften breaths in Edit project → Pauses and volume and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
+            throw new Error(`Soften breaths could not process narration piece ${String(index + 1)} (${errorText(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Soften breaths in ${editSettings.sound} and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
         }
         finally {
             rmSync(raw, { force: true });

package/dist/slices/narration/clean-pieces.js

@@ -1,6 +1,7 @@
 import { mkdirSync } from "node:fs";
 import { join } from "node:path";
 import { errorText } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { runFfmpeg } from "../video/ffmpeg.js";
 import { softenBreaths } from "./breaths.js";
 import { deEsser } from "./breaths-model.js";
@@ -37,7 +38,7 @@ export async function deEssPieces(run, files, directory) {
         catch (error) {
             if (run.signal.aborted)
                 throw error;
-            throw new Error(`Soften S sounds could not process narration piece ${String(index + 1)} (${errorText(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Soften S sounds in Edit project → Pauses and volume and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
+            throw new Error(`Soften S sounds could not process narration piece ${String(index + 1)} (${errorText(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Soften S sounds in ${editSettings.sound} and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
         }
         written.push(output);
     }

package/dist/slices/narration/pauses-model.js

@@ -9,9 +9,10 @@
 // A paragraph's minimum is separate and 0 (the sentence minimum only) unless set: the pause
 // between paragraphs is mostly the narration prompt's and the voice's to make.
 //
-// Browser-safe: Play and Edit project read these limits. A run without either has neither on
+// Browser-safe: Create and Edit settings read these limits. A run without either has neither on
 // its config, which is what every project saved before them was, and the joins keep their
 // fingerprints then.
+import { createRows, editSettings } from "../../kernel/ports/settings-places.js";
 // ceiling: a quarter second reads brisk, 0.35 to 0.45 natural or documentary, 0.5 to 0.8 an
 // audiobook's relaxed pace, and above 0.8 sleep content; beyond 2 s it stops sounding like a
 // pause between sentences.
@@ -33,7 +34,7 @@ export function pauseProblem(value, name) {
         value <= pauseSecondsMax &&
         Math.abs(steps - Math.round(steps)) < 1e-6
         ? undefined
-        : `The pause between ${name} must be between 0 and ${String(pauseSecondsMax)} seconds, in steps of ${String(pauseSecondsStep)}. Change it under Play → Video and style, or Edit project → Pauses and volume.`;
+        : `The pause between ${name} must be between 0 and ${String(pauseSecondsMax)} seconds, in steps of ${String(pauseSecondsStep)}. Change it under ${createRows.video}, or ${editSettings.sound}.`;
 }
 export function pauseFields(config) {
     const fields = [];

package/dist/slices/narration/pronunciation-check.js

@@ -0,0 +1,226 @@
+import { parsePronunciationGlossary, pronunciationMatches, pronunciationSpans, } from "./pronunciation.js";
+import { libraryGlossary } from "./pronunciations-library.js";
+import { withSharedGlossary } from "./shared-glossary.js";
+// Measured over the 30 finished videos in this install: "Do'Urden" spreads 0.36 in both videos
+// that say it and is heard several ways, while "Gygax" — a rare name the aligner always scores
+// low — never spreads past 0.29 in the 26 videos that say it, so a low score on its own never
+// flags. Eight mentions is the fewest from which the 10th and 90th percentiles mean anything.
+export const heardMinMentions = 8;
+export const heardSpreadFlag = 0.3;
+// The entries narration pronounces with, assembled the way `recipe-text.ts` assembles them.
+// Parsed twice: once under the rules the project narrates with, which is what actually guides
+// the voice, and once under the current rules, which is the fullest list of names the sources
+// name at all — a hyphenated term rules 1 had to skip is still a name this video says.
+export function pronunciationEntries(sources) {
+    const under = (rules) => {
+        const own = parsePronunciationGlossary(sources.glossary, sources.language, rules);
+        const list = libraryGlossary(sources.list, sources.language, rules);
+        return withSharedGlossary(list.ok ? list.entries : [], withSharedGlossary(own.ok ? own.entries : [], sources.shared));
+    };
+    return { guiding: under(sources.rules), listed: under(2) };
+}
+// Delivery tags are the preparation's instructions to the voice, not words it reads, so a name
+// inside one is not a mention. Blanked, not removed, so every offset still points at the text.
+function withoutTags(source) {
+    return source.replace(/\[[^\]\n]*\]/gu, (tag) => " ".repeat(tag.length));
+}
+// Everything between a pair of slashes already reached the voice as IPA. Whitespace inside is
+// never IPA, which keeps an "and/or … his/her" in ordinary prose from reading as a span.
+function ipaRanges(source) {
+    return Array.from(source.matchAll(/\/[^/\s]+\//gu), (match) => [match.index, match.index + match[0].length]);
+}
+// The names to look for: every term the sources name, and — because a two-word term never
+// matches one of its words said alone ("Belwar Dissengulp" listed, "Belwar" spoken) — each
+// capitalised word of a longer term as a name of its own.
+//
+// A one-word name of four letters or more that the text also writes in lower case is an
+// ordinary English word here, not a name: the pooled copy of the other projects' glossaries
+// carries "Hall" (of "Mithral Hall"), "Quick" and "Claw", and an article that also says "halls"
+// or "quickly" is not mispronouncing them. An ending of one or two letters counts as the same
+// word, which is why "quickly" speaks for "Quick"; more than that does not, so "torment" leaves
+// the god Torm alone. A term of several words, or a short one like "Bel", is never read this way.
+function lowercaseWords(source) {
+    const words = new Set();
+    for (const match of source.matchAll(/(?<![\p{L}\p{N}'’-])\p{Ll}[\p{L}'’-]*/gu)) {
+        const word = match[0];
+        words.add(word);
+        if (word.length > 1)
+            words.add(word.slice(0, -1));
+        if (word.length > 2)
+            words.add(word.slice(0, -2));
+    }
+    return words;
+}
+function ordinaryWord(term, lowercased) {
+    return (term.length >= 4 &&
+        !term.includes(" ") &&
+        // Only a name written with a capital can be mistaken for one: a term the glossary itself
+        // writes in lower case ("drow", "lich", "tiefling") is a common word by its own spelling,
+        // and is told apart by `proper` rather than left out.
+        /^\p{Lu}/u.test(term) &&
+        lowercased.has(term.toLowerCase()));
+}
+function nameCandidates(entries, source) {
+    const lowercased = lowercaseWords(source);
+    const candidates = new Map();
+    for (const entry of entries) {
+        if (ordinaryWord(entry.term, lowercased))
+            continue;
+        candidates.set(entry.term.toLowerCase(), entry);
+    }
+    for (const entry of entries) {
+        const words = entry.term.split(" ");
+        if (words.length < 2)
+            continue;
+        for (const [index, word] of words.entries()) {
+            const key = word.toLowerCase();
+            if (word.length < 3 || !/^\p{Lu}/u.test(word))
+                continue;
+            if (candidates.has(key) || ordinaryWord(word, lowercased))
+                continue;
+            candidates.set(key, { term: word, ipa: [entry.ipa[index] ?? ""] });
+        }
+    }
+    return [...candidates.values()];
+}
+function countUnguided(source, entries, guided) {
+    const text = withoutTags(source);
+    const rows = new Map();
+    // Possessives are always matched here, whatever the project's rules: a possessive the rules
+    // never wrapped is exactly the mention that reached the voice as written.
+    for (const match of pronunciationMatches(text, nameCandidates(entries, text), true)) {
+        if (guided.some(([from, to]) => match.start < to && match.end > from))
+            continue;
+        // Named by what the text says, not by the glossary's spelling of the term.
+        const said = text.slice(match.start, match.end);
+        const name = said.replace(/['’]s$/u, "");
+        const row = rows.get(name) ?? { plain: 0, possessive: 0, proper: /^\p{Lu}/u.test(name) };
+        if (match.possessive === undefined)
+            row.plain++;
+        else
+            row.possessive++;
+        rows.set(name, row);
+    }
+    const total = (row) => row.plain + row.possessive;
+    const names = [...rows.entries()]
+        .map(([name, row]) => ({ name, ...row }))
+        .sort((a, b) => Number(b.proper) - Number(a.proper) ||
+        total(b) - total(a) ||
+        a.name.localeCompare(b.name, "en"));
+    return {
+        names,
+        mentions: names.reduce((sum, row) => sum + total(row), 0),
+        proper: names.filter((row) => row.proper).reduce((sum, row) => sum + total(row), 0),
+    };
+}
+// Before the narration runs: the names this text says that the voice will have to invent. What
+// narration will wrap is `pronunciationSpans` itself, under the project's own rules, so a
+// project that narrates without possessives is told about its possessives and a newer one is not.
+export function namesAhead(text, sources, possessives) {
+    const { guiding, listed } = pronunciationEntries(sources);
+    const plain = withoutTags(text);
+    const guided = pronunciationSpans(plain, guiding, possessives).map((span) => [span.start, span.end]);
+    return countUnguided(plain, listed, guided);
+}
+// After the render: the same names, counted from the voice script, which is exactly the text the
+// voice was sent. A name with no IPA in front of it there was guessed, whatever the glossary says.
+export function namesNarrated(script, sources) {
+    const { listed } = pronunciationEntries(sources);
+    return countUnguided(script, listed, ipaRanges(withoutTags(script)));
+}
+// A word as the aligner read it: "Do'Urden," is the name, "Drizzt's" is the name too.
+function spokenName(text) {
+    return text
+        .replace(/^[^\p{L}\p{N}]+/u, "")
+        .replace(/[^\p{L}\p{N}'’-]+$/u, "")
+        .replace(/['’]s$/u, "");
+}
+function percentile(sorted, fraction) {
+    const at = Math.round(fraction * (sorted.length - 1));
+    return sorted[Math.min(sorted.length - 1, Math.max(0, at))] ?? 0;
+}
+// How the finished narration was heard saying each name, from the confidence the subtitle timing
+// already carries. Nothing here is listened to again and nothing is re-aligned: the numbers are
+// the ones written when the captions were timed.
+export function heardNames(words, sources, 
+// The narration as it was written: the corpus the candidates are judged against, so a pooled
+// "Hall" is left alone in a video that also says "hall" (see `nameCandidates`). The words as
+// the aligner wrote them down stand in when the narration itself is not at hand.
+corpus) {
+    const { listed } = pronunciationEntries(sources);
+    const heardText = corpus ?? words.map((word) => word.text).join(" ");
+    const lowercased = lowercaseWords(heardText);
+    const wanted = new Map();
+    // A word of the timing is one word, so a term of several reaches it a part at a time, and a
+    // hyphenated name may arrive whole or in parts. A part that is an ordinary word of this text
+    // ("Hall" of "Mithral Hall", in a video that also says "hall") is left out, as it is above.
+    for (const entry of nameCandidates(listed, heardText))
+        for (const part of [entry.term, ...entry.term.split(/[\s‐‑-]+/u)])
+            if (part.length >= 3 && !wanted.has(part.toLowerCase()) && !ordinaryWord(part, lowercased))
+                wanted.set(part.toLowerCase(), part);
+    const scored = words.flatMap((word) => typeof word.confidence === "number" ? [word.confidence] : []);
+    const by = new Map();
+    for (const word of words) {
+        if (typeof word.confidence !== "number")
+            continue;
+        const name = wanted.get(spokenName(word.text).toLowerCase());
+        if (name === undefined)
+            continue;
+        by.set(name, [...(by.get(name) ?? []), word.confidence]);
+    }
+    const names = [...by.entries()]
+        .map(([name, values]) => {
+        const sorted = [...values].sort((a, b) => a - b);
+        const low = percentile(sorted, 0.1);
+        const high = percentile(sorted, 0.9);
+        return {
+            name,
+            mentions: sorted.length,
+            mean: sorted.reduce((sum, value) => sum + value, 0) / sorted.length,
+            low,
+            high,
+            spread: high - low,
+            uneven: sorted.length >= heardMinMentions && high - low >= heardSpreadFlag,
+        };
+    })
+        .sort((a, b) => b.spread - a.spread || a.name.localeCompare(b.name, "en"));
+    return {
+        names,
+        uneven: names.filter((row) => row.uneven),
+        words: scored.length,
+        confidence: scored.length === 0 ? 0 : scored.reduce((sum, value) => sum + value, 0) / scored.length,
+    };
+}
+const list = (names, most = 6) => {
+    const shown = names.slice(0, most).map((row) => row.name);
+    const rest = names.length - shown.length;
+    return rest === 0 ? shown.join(", ") : `${shown.join(", ")} and ${String(rest)} more`;
+};
+// The one line before the narration is paid for. Names the names, says what will happen to them,
+// and says the one place that fixes them for every video at once.
+export function namesAheadNotice(result) {
+    const proper = result.names.filter((row) => row.proper);
+    if (proper.length === 0)
+        return null;
+    return (`${proper.length === 1 ? "1 name" : `${String(proper.length)} names`} in this article ` +
+        `${proper.length === 1 ? "has" : "have"} no pronunciation anywhere, so the voice will guess ` +
+        `${proper.length === 1 ? "it" : "them"}: ${list(proper)}. ` +
+        `To decide how they are said, add them to Settings → Voices → Name pronunciations, then make ` +
+        `the narration.`);
+}
+// The one line on the upload section, after the render: what the voice guessed, and what it was
+// heard saying more than one way. Null when there is nothing to say.
+export function narratedNotice(narrated, heard) {
+    const guessed = narrated?.names.filter((row) => row.proper) ?? [];
+    const uneven = heard?.uneven ?? [];
+    if (guessed.length === 0 && uneven.length === 0)
+        return null;
+    const parts = [];
+    if (guessed.length > 0)
+        parts.push(`the voice guessed ${guessed.length === 1 ? "1 name" : `${String(guessed.length)} names`} ` +
+            `(${list(guessed)})`);
+    if (uneven.length > 0)
+        parts.push(`${uneven.length === 1 ? "1 name was" : `${String(uneven.length)} names were`} heard more ` +
+            `than one way (${list(uneven)})`);
+    return `Names in this narration: ${parts.join(", and ")}. Open the check to see every mention.`;
+}

package/dist/slices/narration/pronunciation.js

@@ -1,7 +1,12 @@
 import { remark } from "remark";
 import remarkGfm from "remark-gfm";
 import { internalError } from "../../kernel/errors.js";
+import { createRows, editSettings } from "../../kernel/ports/settings-places.js";
 import { remembered } from "../../kernel/remembered.js";
+// How long Settings → Voices → Pronunciation's own list may be, and with it the copy a project
+// carries (`slices/narration/pronunciations-library.ts`). Long enough for a channel's whole cast
+// of names.
+export const libraryPronunciationsMax = 100_000;
 export const currentPronunciationRules = 2;
 export function pronunciationRulesOf(config) {
     return config.pronunciationRules ?? 1;
@@ -154,7 +159,7 @@ function parseGlossary(markdown, language, rules = currentPronunciationRules) {
 export function skippedGlossaryNotice(skipped, unpronounced = 0) {
     if (skipped.length === 0 && unpronounced === 0)
         return null;
-    const where = "in the Pronunciation Glossary at the end of the article in Edit project → Article";
+    const where = `in the Pronunciation Glossary at the end of the article in ${editSettings.article}`;
     const blank = unpronounced === 0
         ? ""
         : `${unpronounced === 1 ? "1 name has" : `${unpronounced} names have`} no pronunciation given and ${unpronounced === 1 ? "is" : "are"} read as written. To give ${unpronounced === 1 ? "it one" : "them one"}, fill in its IPA ${where}.`;
@@ -179,7 +184,7 @@ export function skippedSpeakerPronunciationsNotice(rows) {
         return null;
     const parts = rows.map((row) => `${row.speaker}: ${row.skipped.map((one) => `entry ${one.row}: ${one.reason}`).join("; ")}`);
     return (`Speaker pronunciations: some entries are skipped and read as ordinary text (${parts.join(". ")}). ` +
-        "The rest are used. To use them, fix those entries under Speakers → Pronunciations for that speaker (Play → Narration, or Edit project → Providers).");
+        `The rest are used. To use them, fix those entries under Speakers → Pronunciations for that speaker (${createRows.narration}, or ${editSettings.narration}).`);
 }
 // Remembered (`kernel/remembered.ts`): every plan rebuild matches the whole narration again.
 export const pronunciationMatches = remembered(1024, (source, entries, possessives) => `${possessives === true ? "p" : "-"}\u0000${source}\u0000${JSON.stringify(entries)}`, matchPronunciations);