@gentbajko/slopify 3.0.0 → 3.0.2

package/dist/slices/style-preview/settings.js

@@ -1,22 +1,49 @@
 import { createHash } from "node:crypto";
 import { captionCues } from "../subtitles/captions.js";
-import { transitionSecondsMax, transitionSecondsMin, videoEditOf } from "../video/edit-settings.js";
+import { legacyVideoEdit, transitionSecondsMax, transitionSecondsMin, videoEditOf, } from "../video/edit-settings.js";
+import { sampleNarrationText, sampleNarrationWords, sampleShortTitle } from "./narration.js";
 import { defaultPreviewText, stylePreviewSeconds } from "./schema.js";
 export function normalizeStylePreview(request, 
 // The sha256 of the picture the server found for request.image, if it found one.
 image) {
     const edit = videoEditOf(request);
     const { subtitles } = request;
-    const text = (request.previewText ?? "").replace(/\s+/g, " ").trim();
+    const typed = (request.previewText ?? "").replace(/\s+/g, " ").trim();
+    const text = typed === "" || typed === defaultPreviewText ? sampleNarrationText : typed;
+    const shorts = request.shorts;
+    if (shorts !== undefined) {
+        const title = shorts.title?.replace(/\s+/g, " ").trim() ?? "";
+        const none = videoEditOf({ videoEdit: legacyVideoEdit });
+        return {
+            version: 2,
+            format: "9:16",
+            captions: null,
+            look: {
+                vignette: none.vignette,
+                grain: none.grain,
+                grade: none.grade,
+                atmosphere: none.atmosphere,
+            },
+            transition: null,
+            chapterCard: null,
+            short: {
+                fontId: subtitles.fontId,
+                text,
+                title: shorts.titleOnScreen ? (title === "" ? sampleShortTitle : title) : null,
+                speed: Math.round(Math.min(1.25, Math.max(1, shorts.speed ?? 1)) * 100) / 100,
+            },
+            ...(image === undefined ? {} : { image }),
+        };
+    }
     return {
-        version: 1,
+        version: 2,
         format: request.format,
         captions: subtitles.mode === "burn-in"
             ? {
                 fontId: subtitles.fontId,
                 fontSize: Math.round(subtitles.fontSize),
                 position: subtitles.position,
-                text: text === "" ? defaultPreviewText : text,
+                text,
             }
             : null,
         look: {
@@ -51,38 +78,61 @@ export function stableJson(value) {
 export function stylePreviewHash(settings) {
     return createHash("sha256").update(stableJson(settings)).digest("hex");
 }
-// ceiling: three cues read comfortably in six seconds; a short text gets one per word.
-const cueCount = 3;
-// Longer than the 0.7 s pause `captionCues` starts a new cue at.
-const cueGap = 0.8;
-const lead = 0.4;
-// The sample text as timed words: split into up to three groups spread over the preview with
-// a pause between them, the words of each evenly spaced. `captionCues` then groups and wraps
-// them exactly as it does real narration.
-export function sampleWords(text, seconds = stylePreviewSeconds) {
+// How long the rendered preview runs: a Shorts preview at a higher speed is shorter.
+export function previewSeconds(settings) {
+    return settings.short === undefined
+        ? stylePreviewSeconds
+        : round(stylePreviewSeconds / settings.short.speed);
+}
+// ceiling: a pause this long between two words of the sample narration starts a new phrase,
+// the same pause `captionCues` starts a new cue at.
+const phraseGap = 0.7;
+// The caption text as timed words. The sample narration's own text is its word timing as it
+// was aligned; any other text is spread over the stretches the narration speaks, each phrase
+// taking a share of the words by its length, the words of each evenly spaced. `captionCues`
+// and the Shorts captions then group and wrap them exactly as they do real narration.
+export function previewWords(text, narration = sampleNarrationWords) {
     const words = text.split(/\s+/).filter((word) => word !== "");
     if (words.length === 0)
         return [];
-    const groups = Math.min(cueCount, words.length);
-    const per = Math.ceil(words.length / groups);
-    const chunks = Array.from({ length: groups }, (_value, at) => words.slice(at * per, (at + 1) * per)).filter((chunk) => chunk.length > 0);
-    const span = (seconds - 2 * lead - cueGap * (chunks.length - 1)) / chunks.length;
+    if (words.join(" ") === narration.map((word) => word.text).join(" "))
+        return narration;
+    const phrases = [];
+    for (const word of narration) {
+        const last = phrases.at(-1);
+        if (last !== undefined && word.start - last.end < phraseGap)
+            last.end = word.end;
+        else
+            phrases.push({ start: word.start, end: word.end });
+    }
+    if (phrases.length === 0)
+        phrases.push({ start: 0.4, end: stylePreviewSeconds - 0.4 });
+    const spoken = phrases.reduce((sum, phrase) => sum + (phrase.end - phrase.start), 0);
     const timed = [];
-    chunks.forEach((chunk, at) => {
-        const start = lead + at * (span + cueGap);
-        const each = span / chunk.length;
+    let used = 0;
+    let before = 0;
+    for (const [at, phrase] of phrases.entries()) {
+        before += phrase.end - phrase.start;
+        // The words up to the end of this phrase, by its share of the speech; the last takes
+        // what is left, and none is left empty while words remain.
+        const upTo = at === phrases.length - 1
+            ? words.length
+            : Math.min(words.length - (phrases.length - 1 - at), Math.max(used + 1, Math.round((words.length * before) / spoken)));
+        const chunk = words.slice(used, Math.max(used, upTo));
+        used += chunk.length;
+        const each = (phrase.end - phrase.start) / Math.max(1, chunk.length);
         chunk.forEach((word, index) => {
             timed.push({
                 text: word,
-                start: round(start + index * each),
-                end: round(start + (index + 1) * each),
+                start: round(phrase.start + index * each),
+                end: round(phrase.start + (index + 1) * each),
             });
         });
-    });
+    }
     return timed;
 }
-export function sampleCues(text, seconds = stylePreviewSeconds) {
-    return captionCues(sampleWords(text, seconds));
+export function previewCues(text) {
+    return captionCues(previewWords(text));
 }
 function round(value) {
     return Math.round(value * 1000) / 1000;

package/dist/slices/tutorials/anchors.js

@@ -0,0 +1,57 @@
+// The tutorials are the GitHub wiki's pages (docs/wiki), so their links name sections the way
+// GitHub does: `[text](Page-Name#section-anchor)`. These helpers work out those anchors, for
+// the server's search, the web page that scrolls to them and the test that checks every help
+// entry's Learn more link. Pure: the web bundle imports this file.
+export const tutorialPageIdPattern = /^[A-Za-z0-9][A-Za-z0-9-]{0,79}$/;
+// A heading's text as GitHub renders it: link targets, code ticks and emphasis marks dropped.
+export function headingText(markdown) {
+    return markdown
+        .replace(/!?\[([^\]]*)\]\([^)]*\)/g, "$1")
+        .replace(/`([^`]*)`/g, "$1")
+        .replace(/(\*\*|__)(.+?)\1/g, "$2")
+        .replace(/(^|[^\p{L}\p{N}])[*_]([^*_]+)[*_](?![\p{L}\p{N}])/gu, "$1$2")
+        .replace(/<[^>]+>/g, "")
+        .trim();
+}
+// GitHub's anchor for a heading's text: lower case, punctuation dropped, each space a hyphen.
+export function githubSlug(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}\p{M} _-]/gu, "")
+        .replace(/ /g, "-");
+}
+const headingLine = /^ {0,3}(#{1,6})\s+(.+?)\s*#*\s*$/;
+// Every heading of a page in order, with GitHub's anchor; a repeated anchor gets `-1`, `-2`.
+// `#` inside fenced code is not a heading.
+export function tutorialHeadings(markdown) {
+    const lines = markdown.replace(/\r\n?/g, "\n").split("\n");
+    const seen = new Map();
+    const headings = [];
+    let fenced = false;
+    for (const [line, raw] of lines.entries()) {
+        if (/^\s*(```|~~~)/.test(raw))
+            fenced = !fenced;
+        const match = fenced ? null : headingLine.exec(raw);
+        if (match === null)
+            continue;
+        const text = headingText(match[2] ?? "");
+        const base = githubSlug(text);
+        const count = seen.get(base) ?? 0;
+        seen.set(base, count + 1);
+        headings.push({
+            level: (match[1] ?? "#").length,
+            text,
+            anchor: count === 0 ? base : `${base}-${String(count)}`,
+            line,
+        });
+    }
+    return headings;
+}
+// The anchors a page offers, for checking a link.
+export function tutorialAnchors(markdown) {
+    return new Set(tutorialHeadings(markdown).map((heading) => heading.anchor));
+}
+// A page id as a title when the sidebar gives none: "Play-Overview" → "Play Overview".
+export function pageTitleOf(id) {
+    return id.replace(/-/g, " ");
+}

package/dist/slices/tutorials/library.js

@@ -0,0 +1,185 @@
+import { existsSync } from "node:fs";
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { pageTitleOf, tutorialHeadings, tutorialPageIdPattern } from "./anchors.js";
+// dist/tutorials when running the build; the repository's docs/wiki when running from source
+// (tests, `tsx`).
+export function bundledTutorialsDir() {
+    const candidates = ["../../tutorials/", "../../../../../docs/wiki/"].map((path) => fileURLToPath(new URL(path, import.meta.url)));
+    return candidates.find((dir) => existsSync(join(dir, "Home.md"))) ?? candidates[0];
+}
+export class TutorialsMissing extends Error {
+}
+// `[Title](Page-Name)` links of the sidebar, under its `**Group**` lines. The first link
+// before any group is the home page.
+export function parseSidebar(markdown, titleOf = () => undefined) {
+    const groups = [];
+    let home;
+    for (const line of markdown.replace(/\r\n?/g, "\n").split("\n")) {
+        const group = /^\s*\*\*([^*[\]]+)\*\*\s*$/.exec(line);
+        if (group !== null) {
+            groups.push({ title: (group[1] ?? "").trim(), pages: [] });
+            continue;
+        }
+        for (const link of line.matchAll(/\[([^\]]+)\]\(([^)#\s]+)\)/g)) {
+            const id = link[2] ?? "";
+            if (!tutorialPageIdPattern.test(id))
+                continue;
+            const page = { id, title: (link[1] ?? titleOf(id) ?? pageTitleOf(id)).trim() };
+            const last = groups[groups.length - 1];
+            if (last === undefined)
+                home ??= page;
+            else
+                last.pages.push(page);
+        }
+    }
+    return { home, groups: groups.filter((group) => group.pages.length > 0) };
+}
+// Reads every page once; they never change while the app runs.
+export async function loadTutorials(dir) {
+    let names;
+    try {
+        names = await readdir(dir);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            throw new TutorialsMissing("This copy of Slopify has no tutorials: its docs/wiki folder is missing. Reinstall Slopify (or run npm run build) and reload the page.");
+        throw error;
+    }
+    const pages = new Map();
+    for (const name of names.sort()) {
+        const id = name.replace(/\.md$/, "");
+        if (!name.endsWith(".md") || !tutorialPageIdPattern.test(id))
+            continue;
+        pages.set(id, await readFile(join(dir, name), "utf8"));
+    }
+    if (!pages.has("Home"))
+        throw new TutorialsMissing("This copy of Slopify has damaged tutorials: docs/wiki/Home.md is missing. Reinstall Slopify (or run npm run build) and reload the page.");
+    const extra = async (name) => readFile(join(dir, name), "utf8").catch((error) => {
+        if (error.code === "ENOENT")
+            return "";
+        throw error;
+    });
+    const sidebar = parseSidebar(await extra("_Sidebar.md"));
+    const groups = sidebar.groups
+        .map((group) => ({ ...group, pages: group.pages.filter((page) => pages.has(page.id)) }))
+        .filter((group) => group.pages.length > 0);
+    const listed = new Map();
+    const home = sidebar.home ?? { id: "Home", title: "Home" };
+    listed.set(home.id, home);
+    for (const group of groups)
+        for (const page of group.pages)
+            listed.set(page.id, page);
+    for (const id of pages.keys())
+        if (!listed.has(id))
+            listed.set(id, { id, title: pageTitleOf(id) });
+    return {
+        index: {
+            home,
+            groups,
+            pages: [...listed.values()],
+            footer: (await extra("_Footer.md")).trim(),
+        },
+        pages,
+    };
+}
+// Plain words of a Markdown line: links become their text, marks and tables' pipes go.
+function plain(markdown) {
+    return markdown
+        .replace(/^\s*\|?\s*:?-{3,}[-|: ]*$/gm, "")
+        .replace(/!?\[([^\]]*)\]\([^)]*\)/g, "$1")
+        .replace(/[`*_>|]/g, " ")
+        .replace(/^\s*(?:[-+]|\d+\.)\s+/gm, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function sectionsOf(markdown) {
+    const lines = markdown.replace(/\r\n?/g, "\n").split("\n");
+    const headings = tutorialHeadings(markdown);
+    const sections = [];
+    const first = headings[0]?.line ?? lines.length;
+    sections.push({ anchor: "", heading: undefined, text: plain(lines.slice(0, first).join("\n")) });
+    for (const [at, heading] of headings.entries()) {
+        const end = headings[at + 1]?.line ?? lines.length;
+        sections.push({
+            anchor: heading.anchor,
+            heading: heading.text,
+            text: plain(lines.slice(heading.line + 1, end).join("\n")),
+        });
+    }
+    return sections.filter((section) => section.heading !== undefined || section.text !== "");
+}
+function snippetOf(text, term) {
+    const at = term === "" ? -1 : text.toLowerCase().indexOf(term);
+    if (at < 0)
+        return text.length > 180 ? `${text.slice(0, 177).trimEnd()}…` : text;
+    // Whole words at both ends.
+    const from = Math.max(0, at - 60);
+    const start = from === 0 ? 0 : text.indexOf(" ", from) + 1 || from;
+    const to = Math.min(text.length, at + term.length + 120);
+    const end = to === text.length ? to : text.lastIndexOf(" ", to) > at ? text.lastIndexOf(" ", to) : to;
+    return `${start > 0 ? "…" : ""}${text.slice(start, end).trim()}${end < text.length ? "…" : ""}`;
+}
+// The sections that hold every word typed, best first: a word in the page's title or the
+// section's heading counts more than one in its text. The first heading (the page's own
+// title) stands for the page.
+export function searchTutorials(book, query, limit = 30) {
+    const terms = query
+        .toLowerCase()
+        .split(/\s+/)
+        .map((term) => term.trim())
+        .filter((term) => term.length > 0)
+        .slice(0, 8);
+    if (terms.length === 0)
+        return [];
+    const titles = new Map(book.index.pages.map((page) => [page.id, page.title]));
+    const scored = [];
+    let order = 0;
+    for (const summary of book.index.pages) {
+        const markdown = book.pages.get(summary.id);
+        if (markdown === undefined)
+            continue;
+        const pageTitle = titles.get(summary.id) ?? pageTitleOf(summary.id);
+        for (const section of sectionsOf(markdown)) {
+            order += 1;
+            const heading = (section.heading ?? "").toLowerCase();
+            const text = section.text.toLowerCase();
+            const title = pageTitle.toLowerCase();
+            let score = 0;
+            let all = true;
+            let own = false;
+            for (const term of terms) {
+                const inHeading = heading.includes(term);
+                const inTitle = title.includes(term);
+                const inText = text.includes(term);
+                if (!inHeading && !inText && !inTitle) {
+                    all = false;
+                    break;
+                }
+                own ||= inHeading || inText;
+                score += (inHeading ? 6 : 0) + (inTitle ? 3 : 0) + (inText ? 1 : 0);
+            }
+            // A word only in the page's title would list every section of the page.
+            if (!all || !own)
+                continue;
+            if (heading === query.trim().toLowerCase())
+                score += 10;
+            scored.push({
+                hit: {
+                    page: summary.id,
+                    pageTitle,
+                    anchor: section.anchor,
+                    heading: section.heading,
+                    snippet: snippetOf(section.text, terms.find((term) => text.includes(term)) ?? ""),
+                },
+                score,
+                order,
+            });
+        }
+    }
+    return scored
+        .sort((a, b) => b.score - a.score || a.order - b.order)
+        .slice(0, limit)
+        .map(({ hit }) => hit);
+}

package/dist/slices/voices/audio-files.js

@@ -26,9 +26,14 @@ export function audioChapters(input) {
         endMs: points[at + 1]?.startMs ?? totalMs,
     }));
 }
-// FFMETADATA1: `=`, `;`, `#`, `\` and line breaks are escaped with a backslash.
-export function ffmetadata(title, chapters) {
+// FFMETADATA1: `=`, `;`, `#`, `\` and line breaks are escaped with a backslash. A chapter of a
+// book also carries the book as its album and the chapter number as its track (ID3 TALB and
+// TRCK in the MP3, the album and track atoms in the M4B), so a player files the chapters together
+// and in order.
+export function ffmetadata(title, chapters, book) {
     const lines = [";FFMETADATA1", `title=${escapeMeta(title)}`];
+    if (book !== undefined)
+        lines.push(`album=${escapeMeta(book.title.trim())}`, `track=${String(book.chapter)}`);
     for (const chapter of chapters)
         lines.push("", "[CHAPTER]", "TIMEBASE=1/1000", `START=${String(chapter.startMs)}`, `END=${String(chapter.endMs)}`, `title=${escapeMeta(chapter.title)}`);
     return `${lines.join("\n")}\n`;

package/dist/slices/voices/cast.js

@@ -2,18 +2,36 @@
 // cast in a run. A speaker picked from the cast keeps the member's id, and every run started
 // later takes the member's voice as it is then, so a character or a host sounds the same in
 // every episode; editing the cast later changes no project already made.
-export function castSpeakers(members) {
-    return {
-        speakers: () => members.flatMap((member) => member.voice === undefined ? [] : [speakerFromCast(member, "character")]),
-    };
+// The channel's hosts as speakers: every member marked as a host who has a voice, in the cast's
+// order. A new podcast or interview starts with them (`defaultVoicesSettings`), so the channel's
+// recurring voices are there without adding them each time.
+export function castHosts(members) {
+    return members.flatMap((member) => member.host === true && member.voice !== undefined ? [speakerFromCast(member, "host")] : []);
+}
+// A speaker id no other member can share: the member's whole id (a UUID) rather than its first
+// eight characters, which two members may have in common. An id the speaker schema cannot hold
+// (never one the app made) falls back to a hash of it. A speaker already saved keeps its id.
+export function castSpeakerId(memberId) {
+    const lower = memberId.toLowerCase();
+    return /^[a-z0-9-]{1,55}$/.test(lower) ? `cast-${lower}` : `cast-h${hashOf(memberId)}`;
+}
+// cyrb53: 53 bits, the same in the browser and on the server.
+function hashOf(text) {
+    let h1 = 0xdeadbeef;
+    let h2 = 0x41c6ce57;
+    for (let i = 0; i < text.length; i += 1) {
+        const code = text.charCodeAt(i);
+        h1 = Math.imul(h1 ^ code, 2654435761);
+        h2 = Math.imul(h2 ^ code, 1597334677);
+    }
+    h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507) ^ Math.imul(h2 ^ (h2 >>> 13), 3266489909);
+    h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507) ^ Math.imul(h1 ^ (h1 >>> 13), 3266489909);
+    return (4294967296 * (2097151 & h2) + (h1 >>> 0)).toString(36);
 }
 export function speakerFromCast(member, role) {
     const voice = member.voice;
     return {
-        id: `cast-${member.id
-            .slice(0, 8)
-            .toLowerCase()
-            .replace(/[^a-z0-9-]/g, "")}`,
+        id: castSpeakerId(member.id),
         name: member.name.slice(0, 40),
         role,
         voice: voice === undefined

package/dist/slices/voices/grouping.js

@@ -1,6 +1,16 @@
 import { speakerPace } from "./model.js";
 export const dialogueCapabilities = [
     { provider: "elevenlabs", models: ["eleven_v3"], maxVoices: 10, maxCharacters: 2000 },
+    {
+        provider: "google-tts",
+        models: [
+            "gemini-2.5-flash-preview-tts",
+            "gemini-2.5-pro-preview-tts",
+            "gemini-3.1-flash-tts-preview",
+        ],
+        maxVoices: 2,
+        maxCharacters: 3000,
+    },
 ];
 export function dialogueCapability(provider, model) {
     return dialogueCapabilities.find((capability) => capability.provider === provider && capability.models.includes(model));

package/dist/slices/voices/model.js

@@ -47,6 +47,19 @@ export const speakerSchema = z.object({
         .regex(/^[0-9a-f]{64}$/)
         .optional(),
 });
+// A book: a series of audiobook projects, one per chapter, that share their speakers, voices,
+// cast and settings. "Make the next chapter" on a finished chapter starts the next one in Play.
+// The MP3 and M4B carry it as their album and track. Absent is a project on its own, which is
+// every project made before this.
+export const bookTitleMax = 200;
+export const bookChapterMax = 9999;
+export const bookSchema = z
+    .object({ title: z.string().max(bookTitleMax), chapter: z.number() })
+    .strict()
+    .readonly();
+export function bookLabel(book) {
+    return `${book.title.trim()} · Chapter ${String(book.chapter)}`;
+}
 export const voicesSettingsSchema = z.object({
     format: z.enum(voiceFormats),
     source: z.enum(scriptSources),
@@ -58,18 +71,33 @@ export const voicesSettingsSchema = z.object({
     nativeDialogue: z.boolean(),
     // MP3 and M4B files with chapter markers beside the video.
     audioFiles: z.boolean(),
+    // The book this project is a chapter of. Absent is none.
+    book: bookSchema.optional(),
 });
-export function defaultVoicesSettings(format) {
+// `hosts` are the channel's hosts as speakers (`castHosts`): a podcast or an interview starts
+// with them in place of the placeholder hosts, and the other formats ignore them.
+export function defaultVoicesSettings(format, hosts = []) {
     return {
         format,
         source: "script",
-        speakers: starterSpeakers(format),
+        speakers: withHosts(format, starterSpeakers(format), hosts),
         turnGapSeconds: defaultTurnGapSeconds,
         nameTags: format === "podcast" || format === "interview",
         nativeDialogue: true,
         audioFiles: true,
     };
 }
+// A podcast keeps a placeholder host only while it has fewer than two; an interview keeps its
+// guest after the hosts.
+function withHosts(format, starters, hosts) {
+    if (hosts.length === 0 || (format !== "podcast" && format !== "interview"))
+        return [...starters];
+    const cast = hosts.slice(0, speakersMax - 1).map((host) => ({ ...host, role: "host" }));
+    const fill = format === "podcast"
+        ? starters.slice(0, Math.max(0, 2 - cast.length))
+        : starters.filter((one) => one.role !== "host");
+    return [...cast, ...fill.filter((one) => !cast.some((host) => host.id === one.id))];
+}
 function starterSpeakers(format) {
     const blank = { provider: "", model: "", voice: "" };
     const speaker = (id, name, role) => ({
@@ -99,9 +127,6 @@ export function usesVoices(draft) {
 export function usesScriptPrompt(draft) {
     return usesVoices(draft) && draft.voices?.source === "script";
 }
-export function runSpeakers(settings) {
-    return { speakers: () => settings.speakers };
-}
 // The rules a multi-voice run must pass before it starts, named for the control to fix.
 export function voicesProblems(settings) {
     const problems = [];
@@ -109,23 +134,23 @@ export function voicesProblems(settings) {
     if (speakers.length === 0)
         problems.push({
             field: "voices.speakers",
-            message: "Add at least one speaker under Speakers (Play → Audio, or Edit project → Providers).",
+            message: "Add at least one speaker under Speakers (Play → Narration, or Edit project → Providers).",
         });
     if (settings.source === "attribute" && settings.format !== "audiobook")
         problems.push({
             field: "voices.source",
-            message: "Only audiobooks can hand an existing text's dialogue to speakers. Choose Write a script under Speakers (Play → Audio, or Edit project → Providers).",
+            message: "Only audiobooks can hand an existing text's dialogue to speakers. Choose Write a script under Speakers (Play → Narration, or Edit project → Providers).",
         });
     if ((settings.format === "podcast" || settings.format === "interview") && speakers.length < 2)
         problems.push({
             field: "voices.speakers",
-            message: `A ${voiceFormatLabels[settings.format].toLowerCase()} needs at least two speakers. Add one under Speakers (Play → Audio, or Edit project → Providers).`,
+            message: `A ${voiceFormatLabels[settings.format].toLowerCase()} needs at least two speakers. Add one under Speakers (Play → Narration, or Edit project → Providers).`,
         });
     if ((settings.format === "audiobook" || settings.format === "drama") &&
         !speakers.some((speaker) => speaker.role === "narrator"))
         problems.push({
             field: "voices.speakers",
-            message: `An ${settings.format === "drama" ? "radio drama" : "audiobook"} needs a narrator. Set one speaker's role to Narrator under Speakers (Play → Audio, or Edit project → Providers).`,
+            message: `An ${settings.format === "drama" ? "radio drama" : "audiobook"} needs a narrator. Set one speaker's role to Narrator under Speakers (Play → Narration, or Edit project → Providers).`,
         });
     const names = new Set();
     const ids = new Set();
@@ -167,10 +192,24 @@ export function voicesProblems(settings) {
                 message: `Pick a pace from the list for ${name || "this speaker"}.`,
             });
     }
+    if (settings.book !== undefined) {
+        if (settings.book.title.trim() === "")
+            problems.push({
+                field: "voices.book.title",
+                message: "Enter the book's title under Speakers (Play → Narration), or remove the book to make a project on its own.",
+            });
+        if (!Number.isInteger(settings.book.chapter) ||
+            settings.book.chapter < 1 ||
+            settings.book.chapter > bookChapterMax)
+            problems.push({
+                field: "voices.book.chapter",
+                message: `Enter a chapter number from 1 to ${String(bookChapterMax)} under Speakers (Play → Narration).`,
+            });
+    }
     if (!turnGapSteps.includes(settings.turnGapSeconds))
         problems.push({
             field: "voices.turnGapSeconds",
-            message: "Pick a gap between turns from the list under Speakers (Play → Audio, or Edit project → Providers).",
+            message: "Pick a gap between turns from the list under Speakers (Play → Narration, or Edit project → Providers).",
         });
     return problems;
 }

package/dist/slices/voices/script.js

@@ -42,7 +42,7 @@ export function parseScript(markdown, speakers, keepMarkdown = false) {
             ok: false,
             reason: turn === null
                 ? `Line ${String(number)} of the script is not a turn. Start every turn with a speaker's name and a colon (${names}), one turn per paragraph.`
-                : `Line ${String(number)} of the script is spoken by "${(turn[1] ?? "").trim()}", who is not one of the speakers (${names}). Use only these names, or add the speaker under Speakers (Play → Audio, or Edit project → Providers).`,
+                : `Line ${String(number)} of the script is spoken by "${(turn[1] ?? "").trim()}", who is not one of the speakers (${names}). Use only these names, or add the speaker under Speakers (Play → Narration, or Edit project → Providers).`,
         };
     }
     const spoken = [];

package/dist/slices/youtube/edits-repo.js

@@ -1,6 +1,9 @@
 // Where the hand edits and the channel links are kept: the edits per project in
-// `youtube_description_edits`, the Settings list of links as one `settings` row.
+// `youtube_description_edits`, each channel's links in its brand kit, and the older Settings list
+// of links (read as the default channel's until its Brand tab saves its own) as one `settings` row.
 import { z } from "zod";
+import { defaultChannelId } from "../channels/model.js";
+import { channelById, projectChannelId } from "../channels/repo.js";
 import { readSetting, writeSetting } from "../settings/repo.js";
 import { chapterNotice, fitChapters } from "./chapters.js";
 import { composeDescription, descriptionFields, resolveFields, shownFields, splitDescription, } from "./edits.js";
@@ -49,17 +52,29 @@ export function readChannelLinks(db) {
 export function writeChannelLinks(db, links) {
     writeSetting(db, channelLinksKey, JSON.stringify(links.map((link) => ({ name: link.name.trim(), url: link.url.trim() }))));
 }
+// A channel's links: the ones its Brand tab saved. The default channel, until its Brand tab
+// saves a list of its own (even an empty one), reads the older Settings list, so links saved
+// before channels had their own keep filling. A channel that is gone has none.
+export function readChannelLinksFor(db, channelId) {
+    const channel = channelById(db, channelId);
+    if (channel === undefined)
+        return [];
+    if (channel.brand.links !== undefined)
+        return channel.brand.links;
+    return channel.id === defaultChannelId ? readChannelLinks(db) : [];
+}
 // The description and tags as the project page shows and copies them: the user's edits over
 // the generated text, the chapters fitted to YouTube's rules (`chapters.ts`; the last one's
 // length only checked when the video's length is given), placeholders filled from the
-// project's and Settings' links (one with no link stays as typed). For anything that hands the
-// description on, such as Prepare upload. `chapterNotice` says what the fitting changed.
+// project's and its channel's links (one with no link stays as typed). For anything that hands
+// the description on, such as Prepare upload and the downloads. `chapterNotice` says what the
+// fitting changed.
 export function effectiveDescription(db, projectId, generated) {
     const edits = readDescriptionEdits(db, projectId);
     const shown = shownFields(resolveFields(splitDescription(generated.description, generated.tags), edits.fields));
     const fitted = fitChapters(shown.chapters, generated.durationSeconds);
     const notice = chapterNotice(fitted.adjustments);
-    const links = mergeLinks(readChannelLinks(db), edits.links);
+    const links = mergeLinks(readChannelLinksFor(db, projectChannelId(db, projectId)), edits.links);
     return {
         description: fillPlaceholders(composeDescription({ ...shown, chapters: fitted.text }), links)
             .text,

package/dist/slices/youtube/placeholders.js

@@ -5,7 +5,7 @@
 // A placeholder with no link of that name stays in the text as typed and is marked, never
 // silently dropped. Browser-safe.
 // The link YouTube descriptions most often point at, and the one that changes per project:
-// the project page offers it by name, and a project's own value wins over the Settings list.
+// the project page offers it by name, and a project's own value wins over its channel's list.
 export const previousVideoLink = "Previous video";
 export const channelLinkNameMax = 60;
 export const channelLinkUrlMax = 2000;
@@ -63,7 +63,7 @@ export function fillPlaceholders(text, links) {
 // Why a list of links cannot be saved, in the words Settings shows; undefined when it can.
 export function channelLinksProblem(links) {
     if (links.length > channelLinksMax)
-        return `Keep at most ${String(channelLinksMax)} channel links. Remove some in Settings → Channel links.`;
+        return `Keep at most ${String(channelLinksMax)} links. Remove some.`;
     const seen = new Set();
     for (const [index, link] of links.entries()) {
         const row = `Link ${String(index + 1)}`;