@gentbajko/slopify 3.21.0 → 3.22.0

package/dist/patch-notes/3.22.0.md

@@ -0,0 +1,12 @@
+# Slopify 3.22.0
+
+Released 13 October 2026.
+
+- **Names keep their pronunciation in possessives.** "Gygax's", "Lolth's" and every other possessive of a name in the Pronunciation Glossary were read without the glossary's pronunciation. They now get it, with the right ending sound added.
+- **Hyphenated names work in the glossary.** Names like "Arach-Tinilith" or "Catti-brie" with one pronunciation per part were refused; they are now used.
+- **Blank glossary entries are no longer reported as errors.** When the article leaves a name's pronunciation blank ("—"), the Pronunciation tab now says how many names are read as written, instead of listing them as broken entries.
+- **A project's page no longer scrolls into an empty screen.** On wide screens, scrolling outside the columns of a project (most of all on Video) could slide the whole page up past its content.
+
+## Upgrading from 3.21.0
+
+- The new glossary rules apply to projects made from now on. Projects already made keep the old rules, so nothing already voiced becomes outdated.

package/dist/patch-notes/index.json

@@ -1,4 +1,10 @@
 [
+  {
+    "id": "3.22.0",
+    "title": "Slopify 3.22.0",
+    "version": "3.22.0",
+    "date": "2026-10-13"
+  },
   {
     "id": "3.21.0",
     "title": "Slopify 3.21.0",

package/dist/slices/admission/schema.js

@@ -70,6 +70,7 @@ export const runDraftSchema = z.object({
     })
         .optional(),
     narrationAliases: narrationAliasesSchema.optional(),
+    pronunciationRules: z.union([z.literal(1), z.literal(2)]).optional(),
     sharedGlossary: z
         .array(z.object({
         term: z.string().min(1).max(200),

package/dist/slices/admission/start.js

@@ -5,6 +5,7 @@ import { resolveChannelId, setProjectChannel } from "../channels/repo.js";
 import { defaultDocumentTheme } from "../document/model.js";
 import { earlierEpisodesFor } from "../episodes/related.js";
 import { listNarrationAliases } from "../narration/aliases-library.js";
+import { currentPronunciationRules } from "../narration/pronunciation.js";
 import { collectSharedGlossary } from "../narration/shared-glossary.js";
 import { admitInitialRevision } from "../rebuild/runtime-admission.js";
 import { adoptBaseline } from "../revisions/adopt.js";
@@ -60,6 +61,7 @@ export function startRun(deps, draft, rendered, retainStaged = false, templates)
         rendered,
         ...(shared.length === 0 ? {} : { sharedGlossary: shared }),
         ...(aliases.length === 0 ? {} : { narrationAliases: aliases }),
+        pronunciationRules: currentPronunciationRules,
         ...(earlier === undefined ? {} : { earlierEpisodes: earlier }),
     };
     const project = {

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

@@ -15,7 +15,7 @@ export function chunkingFingerprintOf(chunking) {
 export function narrationChunkTexts(source, chunking, anchors) {
     return anchoredChunks(source, chunking, anchors?.chunkingFingerprint === chunkingFingerprintOf(chunking) ? anchors.texts : undefined);
 }
-export function pronunciationChunks(source, chunking, entries, overriddenKeys = new Set(), sources = {}, anchors) {
+export function pronunciationChunks(source, chunking, entries, overriddenKeys = new Set(), sources = {}, anchors, possessives = false) {
     const occurrences = new Map();
     const usedKeys = new Set();
     const nextKey = (text) => {
@@ -67,7 +67,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
         })),
     ].sort((a, b) => a.start - b.start);
     let blockedIndex = 0;
-    const matches = pronunciationMatches(source, entries).filter((match) => {
+    const matches = pronunciationMatches(source, entries, possessives).filter((match) => {
         while ((blocked[blockedIndex]?.end ?? Infinity) <= match.start)
             blockedIndex++;
         return (blocked[blockedIndex]?.start ?? Infinity) >= match.end;

package/dist/slices/narration/pronunciation.js

@@ -1,6 +1,15 @@
 import { remark } from "remark";
 import remarkGfm from "remark-gfm";
 import { remembered } from "../../kernel/remembered.js";
+export const currentPronunciationRules = 2;
+export function pronunciationRulesOf(config) {
+    return config.pronunciationRules ?? 1;
+}
+// "'s" after a name is English; another language's glossary has no such ending to add.
+export function readsPossessives(config) {
+    return (pronunciationRulesOf(config) === 2 &&
+        (config.language === undefined || config.language === "en"));
+}
 // Inworld requires English IPA, not every symbol in Unicode's IPA Extensions block.
 // https://docs.inworld.ai/tts/capabilities/custom-pronunciation
 const ipaAtom = "[ˈˌ]?[abdefghijklmnoprstuvwxzæðŋθɑɒɔəɚɛɜɝɡɪɹʃʊʌʒʔɫɾ][\\u0303\\u031a\\u0325\\u0329\\u032a\\u032c\\u032f\\u035c\\u0361ʰʲʷ]*[ːˑ]?";
@@ -50,8 +59,29 @@ function termIdentity(term) {
 }
 // `language` is the project's (`kernel/ports/languages.ts`): absent or English accepts the
 // standard-English IPA Inworld asks for, as it always did; any other accepts full IPA.
-export const parsePronunciationGlossary = remembered(8, (markdown, language) => `${language ?? ""}\u0000${markdown}`, parseGlossary);
-function parseGlossary(markdown, language) {
+export const parsePronunciationGlossary = remembered(8, (markdown, language, rules) => `${rules ?? currentPronunciationRules}\u0000${language ?? ""}\u0000${markdown}`, parseGlossary);
+// A cell the writer left out on purpose: empty, a dash, or "n/a", with or without slashes.
+const blankIpa = /^(?:\/\s*(?:[—–-]+|n\/a)\s*\/|[—–-]+|n\/a)?$/iu;
+const hyphens = /[-\u2010\u2011]/u;
+// One IPA word per written word. A hyphenated name is one written word, so its parts' IPA words
+// are joined with "." (a syllable break) into the one word Inworld wants between a pair of slashes.
+function pairWords(term, ipa) {
+    const words = term.split(" ");
+    if (words.length === ipa.length)
+        return ipa;
+    const parts = words.map((word) => word.split(hyphens).filter((part) => part !== "").length || 1);
+    if (parts.reduce((sum, count) => sum + count, 0) !== ipa.length)
+        return null;
+    let next = 0;
+    return parts.map((count) => {
+        const joined = ipa.slice(next, next + count).join(".");
+        next += count;
+        return joined;
+    });
+}
+function parseGlossary(markdown, language, rules = currentPronunciationRules) {
+    const modern = rules === 2;
+    let unpronounced = 0;
     const english = language === undefined || language === "en";
     const symbols = english ? ipaSymbols : worldSymbols;
     const kind = english ? "standard-English IPA" : "IPA";
@@ -65,7 +95,7 @@ function parseGlossary(markdown, language) {
         const trimmed = row.trim();
         if (trimmed === "" || /^pronunciation glossary:?\s*$/iu.test(trimmed))
             continue;
-        const pair = /^([^:]+):\s*(.+)$/u.exec(trimmed);
+        const pair = (modern ? /^([^:]+):\s*(.*)$/u : /^([^:]+):\s*(.+)$/u).exec(trimmed);
         const term = pair?.[1]?.trim().replace(/\s+/gu, " ");
         const pronunciation = pair?.[2];
         if (term === undefined ||
@@ -75,6 +105,10 @@ function parseGlossary(markdown, language) {
             skip("use Term: /IPA/ or a Term | IPA table");
             continue;
         }
+        if (modern && blankIpa.test(pronunciation.trim())) {
+            unpronounced++;
+            continue;
+        }
         const notation = /^(\/[^/]+\/(?:\s+\/[^/]+\/)*)(?:\s+[^/]+)?$/u.exec(pronunciation);
         if (notation?.[1] === undefined) {
             skip(`use slash-delimited ${kind}`);
@@ -87,37 +121,54 @@ function parseGlossary(markdown, language) {
                 : "use IPA, not ARPAbet or delivery tags");
             continue;
         }
-        if (term.split(" ").length !== ipa.length) {
-            skip("supply one IPA word for each written word");
+        const paired = modern
+            ? pairWords(term, ipa)
+            : term.split(" ").length === ipa.length
+                ? ipa
+                : null;
+        if (paired === null) {
+            skip(modern
+                ? "supply one IPA word for each written word, or for each hyphen-separated part of it"
+                : "supply one IPA word for each written word");
             continue;
         }
         const key = termIdentity(term);
         const previous = entries.get(key);
-        if (previous !== undefined && previous.ipa.join(" ") !== ipa.join(" ")) {
+        if (previous !== undefined && previous.ipa.join(" ") !== paired.join(" ")) {
             skip("an earlier entry already gives this term a different pronunciation");
             continue;
         }
         if (previous === undefined)
-            entries.set(key, { term, ipa });
+            entries.set(key, { term, ipa: paired });
     }
-    return skipped.length === 0
-        ? { ok: true, entries: [...entries.values()] }
-        : { ok: true, entries: [...entries.values()], skipped };
+    return {
+        ok: true,
+        entries: [...entries.values()],
+        ...(unpronounced === 0 ? {} : { unpronounced }),
+        ...(skipped.length === 0 ? {} : { skipped }),
+    };
 }
-// What a person reads about the skipped rows: where they are and why, never their text.
-export function skippedGlossaryNotice(skipped) {
-    if (skipped.length === 0)
+// What a person reads about the skipped rows: where they are and why, never their text. Names
+// left without a pronunciation on purpose are not errors, so they get one calm line of their own.
+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 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}.`;
+    if (skipped.length === 0)
+        return `Pronunciation Glossary: ${blank}`;
     const rows = skipped.map((one) => `entry ${one.row}: ${one.reason}`).join("; ");
     return (`Pronunciation Glossary: ${skipped.length === 1 ? "1 entry is" : `${skipped.length} entries are`} ` +
         `skipped and read as ordinary text (${rows}). The rest of the glossary is used. ` +
-        "To use them, fix those entries in the Pronunciation Glossary at the end of the article in Edit project → Article.");
+        `To use them, fix those entries ${where}.${blank === "" ? "" : ` ${blank}`}`);
 }
-export function skippedSpeakerPronunciations(speakers, language) {
+export function skippedSpeakerPronunciations(speakers, language, rules) {
     return speakers.flatMap((speaker) => {
         if (!speaker.pronunciations?.trim())
             return [];
-        const parsed = parsePronunciationGlossary(speaker.pronunciations, language);
+        const parsed = parsePronunciationGlossary(speaker.pronunciations, language, rules);
         const skipped = parsed.ok ? (parsed.skipped ?? []) : [];
         return skipped.length === 0 ? [] : [{ speaker: speaker.name.trim() || "A speaker", skipped }];
     });
@@ -130,8 +181,8 @@ export function skippedSpeakerPronunciationsNotice(rows) {
         "The rest are used. To use them, fix those entries under Speakers → Pronunciations for that speaker (Play → Narration, or Edit project → Providers).");
 }
 // Remembered (`kernel/remembered.ts`): every plan rebuild matches the whole narration again.
-export const pronunciationMatches = remembered(1024, (source, entries) => `${source}\u0000${JSON.stringify(entries)}`, matchPronunciations);
-function matchPronunciations(source, entries) {
+export const pronunciationMatches = remembered(1024, (source, entries, possessives) => `${possessives === true ? "p" : "-"}\u0000${source}\u0000${JSON.stringify(entries)}`, matchPronunciations);
+function matchPronunciations(source, entries, possessives = false) {
     if (entries.length === 0)
         return [];
     const ordered = [...entries].sort((a, b) => b.term.length - a.term.length);
@@ -140,11 +191,15 @@ function matchPronunciations(source, entries) {
         .map((word) => word.replace(/[|\\{}()[\]^$+*?.]/gu, "\\$&"))
         .join("\\s+"));
     const boundary = "[\\p{L}\\p{M}\\p{N}_\\-\u00ad\u2010\u2011\ufe63\uff0d]";
+    // A bare trailing apostrophe ("Iuz' henchmen") is never a possessive here: it can't be told
+    // from a closing quote, and a wrong "z" is worse than a name read as written.
     const expression = new RegExp("(?<!" +
         boundary +
         "['’]?)(?:" +
         patterns.map((pattern) => `(${pattern})`).join("|") +
-        ")(?!['’]?" +
+        ")" +
+        (possessives ? "(['’]s)?" : "") +
+        "(?!['’]?" +
         boundary +
         ")", "giu");
     const matches = [];
@@ -157,20 +212,35 @@ function matchPronunciations(source, entries) {
         const entry = ordered.find((_, index) => match[index + 1] !== undefined);
         if (entry === undefined)
             throw new Error("Slopify hit an internal error (a pronunciation glossary term has no pronunciation). Try again; if it happens again, use Download diagnostics in Settings and report it.");
-        matches.push({ start: match.index, end, entry });
+        const possessive = possessives ? match[ordered.length + 1] : undefined;
+        matches.push({
+            start: match.index,
+            end,
+            entry,
+            ...(possessive === undefined ? {} : { possessive }),
+        });
     }
     return matches;
 }
-export function pronunciationSpans(source, entries) {
+// The sound a possessive adds to the last sound of the name: "iz" after s z sh zh ch j,
+// "s" after the other voiceless sounds, "z" after everything else.
+function withPossessive(ipa) {
+    const last = ipa.replace(/[\u0300-\u036fʰʲʷːˑ]+$/u, "").slice(-1);
+    if ("sz\u0283\u0292".includes(last))
+        return `${ipa}\u026az`;
+    return `${ipa}${"ptkfθ".includes(last) ? "s" : "z"}`;
+}
+export function pronunciationSpans(source, entries, possessives = false) {
     const spans = [];
-    for (const match of pronunciationMatches(source, entries)) {
-        const words = source.slice(match.start, match.end).matchAll(/\S+/gu);
-        for (const [index, word] of Array.from(words).entries()) {
+    for (const match of pronunciationMatches(source, entries, possessives)) {
+        const words = Array.from(source.slice(match.start, match.end).matchAll(/\S+/gu));
+        for (const [index, word] of words.entries()) {
             const ipa = match.entry.ipa[index];
             if (ipa === undefined)
                 throw new Error("Slopify hit an internal error (a pronunciation glossary term is missing a word). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             const start = match.start + word.index;
-            spans.push({ start, end: start + word[0].length, text: `/${ipa}/` });
+            const spoken = match.possessive !== undefined && index === words.length - 1 ? withPossessive(ipa) : ipa;
+            spans.push({ start, end: start + word[0].length, text: `/${spoken}/` });
         }
     }
     return spans;

package/dist/slices/rebuild/recipe-audio-parts.js

@@ -2,7 +2,7 @@ import { aliasMatches } from "../../kernel/ports/narration-aliases.js";
 import { narrationAliasesOf, usesNarrationPreparation, usesPronunciationGlossary, } from "../admission/rules.js";
 import { aliasSpans, withAliasSpans } from "../narration/aliases.js";
 import { narrationRegenerationToken, normalizeNarrationText, planNarration, } from "../narration/plan.js";
-import { pronunciationSpans } from "../narration/pronunciation.js";
+import { pronunciationSpans, readsPossessives, } from "../narration/pronunciation.js";
 import { prepareRequests } from "../narration/steering.js";
 import { recipe } from "./recipe-model.js";
 import { preparationForGroup } from "./recipe-preparation.js";
@@ -25,7 +25,7 @@ export function narrationParts(context, logicalKey, originalText, segment, depen
     // Aliases first: where one applies, the glossary does not.
     const aliases = narrationAliasesOf(context.config);
     const matches = aliasMatches(logicalText, aliases);
-    const spans = withAliasSpans(pronunciationSpans(logicalText, glossary.entries), aliasSpans(logicalText, aliases));
+    const spans = withAliasSpans(pronunciationSpans(logicalText, glossary.entries, readsPossessives(context.config)), aliasSpans(logicalText, aliases));
     const wholeRequest = segment !== "body" || (context.config.chunking?.mode ?? "whole") === "whole";
     const choice = context.config.audio;
     // A retired model's character limit is still its limit: the automatic catalogue check marks
@@ -128,7 +128,7 @@ export function pronunciationFutureValues(context, glossary, article, logicalKey
                 ],
             ];
     const clean = normalizeNarrationText(override?.kind === "text" ? override.text : source);
-    const spans = pronunciationSpans(clean, glossary.entries);
+    const spans = pronunciationSpans(clean, glossary.entries, readsPossessives(context.config));
     return spans.length === 0
         ? []
         : [

package/dist/slices/rebuild/recipe-audio.js

@@ -3,6 +3,7 @@ import { usesNarrationPreparation, usesPronunciationGlossary } from "../admissio
 import { defaultChunking } from "../narration/chunk.js";
 import { concatArgs } from "../narration/concat.js";
 import { normalizeNarrationText } from "../narration/plan.js";
+import { readsPossessives } from "../narration/pronunciation.js";
 import { pronunciationChunks } from "../narration/pronunciation-chunks.js";
 import { aliasFutureValues, narrationParts, pronunciationFutureValues, voiceValues, } from "./recipe-audio-parts.js";
 import { breathValues } from "./recipe-breaths.js";
@@ -15,7 +16,7 @@ import { voiceBodyRecipes } from "./recipe-voices.js";
 export function bodyNarrationGroups(context, text) {
     if (text.narrationText === null)
         return [];
-    const groups = pronunciationChunks(normalizeNarrationText(text.narrationText), context.config.chunking ?? defaultChunking, usesPronunciationGlossary(context.config) && text.glossary?.ok ? text.glossary.entries : [], new Set(Object.keys(context.content.narrationOverrides)), context.content.narrationSources, context.content.narrationAnchors);
+    const groups = pronunciationChunks(normalizeNarrationText(text.narrationText), context.config.chunking ?? defaultChunking, usesPronunciationGlossary(context.config) && text.glossary?.ok ? text.glossary.entries : [], new Set(Object.keys(context.content.narrationOverrides)), context.content.narrationSources, context.content.narrationAnchors, readsPossessives(context.config));
     // A chunk's key is its text's, so an article edit that makes a chunk say what its narration
     // edit already said (a line dropped from both) would make a new chunk to voice again. It
     // keeps the edited chunk's key instead, and with it the narration already made.

package/dist/slices/rebuild/recipe-text.js

@@ -10,7 +10,7 @@ import { plainText } from "../article/plain.js";
 import { segmentMessages } from "../article/segments.js";
 import { splitEndMatter } from "../article/split.js";
 import { withEarlierEpisodes } from "../episodes/related.js";
-import { parsePronunciationGlossary } from "../narration/pronunciation.js";
+import { parsePronunciationGlossary, pronunciationRulesOf, } from "../narration/pronunciation.js";
 import { withSharedGlossary } from "../narration/shared-glossary.js";
 import { researchDocuments } from "../research/documents.js";
 import { plannerMessages, subAgentMessages } from "../research/planner.js";
@@ -287,7 +287,7 @@ function glossaryOf(context, endMatter) {
         return { ok: true, entries: [] };
     if (endMatter === null)
         return null;
-    return withShared(parsePronunciationGlossary(endMatter.glossary, context.config.language), context.config);
+    return withShared(parsePronunciationGlossary(endMatter.glossary, context.config.language, pronunciationRulesOf(context.config)), context.config);
 }
 // The narration glossary this revision uses, or null while its article is still unwritten.
 export function narrationGlossary(context) {

package/dist/slices/rebuild/recipe-voices.js

@@ -3,7 +3,7 @@ import { splitText } from "../../kernel/ports/text.js";
 import { narrationAliasesOf, usesNarrationPreparation } from "../admission/rules.js";
 import { aliasSpans, withAliasSpans } from "../narration/aliases.js";
 import { normalizeNarrationText } from "../narration/plan.js";
-import { parsePronunciationGlossary, pronunciationSpans, } from "../narration/pronunciation.js";
+import { parsePronunciationGlossary, pronunciationRulesOf, pronunciationSpans, readsPossessives, } from "../narration/pronunciation.js";
 import { withSharedGlossary } from "../narration/shared-glossary.js";
 import { prepareRequests } from "../narration/steering.js";
 import { groupTurns } from "../voices/grouping.js";
@@ -193,7 +193,7 @@ function groupParts(context, voices, native, turns, speaker, glossary, script, p
         row.enabled &&
         !row.deprecated)?.tts.maxCharacters ?? Math.max(2, logicalText.length * 4);
     // Narration aliases apply to every voice, the speaker's pronunciations to IPA voices only.
-    const spans = withAliasSpans(pronunciationSpans(logicalText, entries.entries), aliasSpans(logicalText, narrationAliasesOf(context.config)));
+    const spans = withAliasSpans(pronunciationSpans(logicalText, entries.entries, readsPossessives(context.config)), aliasSpans(logicalText, narrationAliasesOf(context.config)));
     if (preparesTurns(context.config, speaker)) {
         const prepared = preparationForGroup(context, logicalKey, logicalText, "body", script.dependsOn, maxCharacters, spans, aliasMatches(logicalText, narrationAliasesOf(context.config)), { name: speaker.name.trim(), role: speaker.role });
         preparations.push(prepared.preparation);
@@ -246,7 +246,7 @@ function speakerGlossary(context, speaker, glossary) {
     if (!readsIpa(speaker))
         return { ok: true, entries: [] };
     const own = speaker.pronunciations?.trim()
-        ? parsePronunciationGlossary(speaker.pronunciations, context.config.language)
+        ? parsePronunciationGlossary(speaker.pronunciations, context.config.language, pronunciationRulesOf(context.config))
         : { ok: true, entries: [] };
     if (!own.ok)
         return {

package/dist/slices/rebuild/recipe-work.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { estimateRequests } from "../estimate/index.js";
-import { skippedGlossaryNotice, skippedSpeakerPronunciations, skippedSpeakerPronunciationsNotice, } from "../narration/pronunciation.js";
+import { pronunciationRulesOf, skippedGlossaryNotice, skippedSpeakerPronunciations, skippedSpeakerPronunciationsNotice, } from "../narration/pronunciation.js";
 import { isLocalCliProvider } from "../settings/model.js";
 import { defaultShortsPrompt, shortsImageUpperBound } from "../shorts/model.js";
 import { usesVoices } from "../voices/model.js";
@@ -82,12 +82,12 @@ export function planRevisionWork(revision, manifest, catalogue, availableAssetId
             (revision.config.chunking?.mode ?? "whole") === "whole"
             ? "Whole-text narration is one logical request. Editing its text rebuilds every provider part of that request."
             : null,
-        glossaryNotice: glossary?.ok === true && glossary.skipped !== undefined
-            ? skippedGlossaryNotice(glossary.skipped)
+        glossaryNotice: glossary?.ok === true
+            ? skippedGlossaryNotice(glossary.skipped ?? [], glossary.unpronounced)
             : null,
         // Only speakers whose voice reads IPA use their pronunciations at all.
         speakerPronunciationNotice: usesVoices(revision.config) && revision.config.voices !== undefined
-            ? skippedSpeakerPronunciationsNotice(skippedSpeakerPronunciations(revision.config.voices.speakers.filter(readsIpa), revision.config.language))
+            ? skippedSpeakerPronunciationsNotice(skippedSpeakerPronunciations(revision.config.voices.speakers.filter(readsIpa), revision.config.language, pronunciationRulesOf(revision.config)))
             : null,
         costs: estimateRequests(priced, catalogue),
     };