@gentbajko/slopify 3.0.5 → 3.0.7

package/dist/slices/storage/downloads.js

@@ -58,7 +58,10 @@ export function findDownload(deps, projectId, asset) {
     if (stats === undefined) {
         return { ok: false, reason: "missing-file" };
     }
-    const shown = output.role === "youtube_description" || output.role === "youtube_tags"
+    const shown = output.role === "youtube_description" ||
+        output.role === "youtube_tags" ||
+        output.role === "youtube_pinned_comment" ||
+        output.role === "youtube_titles"
         ? shownYoutubeText(deps, projectId, output.role)
         : undefined;
     return {
@@ -72,7 +75,7 @@ export function findDownload(deps, projectId, asset) {
         },
     };
 }
-// The description and tags download as the project page shows and copies them, and as Prepare
+// The description, tags, pinned comment and other titles download as the project page shows and copies them, and as Prepare
 // upload hands them on: the user's hand edits over the written text, chapters fitted, and the
 // channel's and project's links filled in (`youtube/edits-repo.ts`). The file on disk stays
 // the generated text, so regeneration can tell the user's edits from its own.
@@ -92,11 +95,19 @@ function shownYoutubeText(deps, projectId, role) {
     const shown = effectiveDescription(deps.db, projectId, {
         description,
         tags: read("youtube_tags") ?? "",
+        pinnedComment: read("youtube_pinned_comment"),
+        titles: read("youtube_titles"),
         durationSeconds: video?.durationMs === null || video?.durationMs === undefined
             ? undefined
             : video.durationMs / 1000,
     });
-    const text = role === "youtube_description" ? shown.description : shown.tags;
+    const text = role === "youtube_description"
+        ? shown.description
+        : role === "youtube_tags"
+            ? shown.tags
+            : role === "youtube_pinned_comment"
+                ? shown.pinnedComment
+                : shown.titles;
     return new TextEncoder().encode(`${text}\n`);
 }
 // "download all" images as `<title-slug>-images.zip`, thumbnail included.

package/dist/slices/storage/layout.js

@@ -68,6 +68,10 @@ export function outputFileName(role, index, extension, stageKind) {
             return "description.txt";
         case "youtube_tags":
             return "tags.txt";
+        case "youtube_pinned_comment":
+            return "pinned-comment.txt";
+        case "youtube_titles":
+            return "titles.txt";
         case "shorts":
             return "shorts.json";
         case "short_image":

package/dist/slices/storage/model.js

@@ -27,6 +27,11 @@ export const outputRoles = [
     "document_pdf",
     "youtube_description",
     "youtube_tags",
+    // A comment to pin under the video, written with the description. Projects described before
+    // it existed have none until the description is written again.
+    "youtube_pinned_comment",
+    // Other titles for YouTube's title A/B test, one per line, written with the description.
+    "youtube_titles",
     // The Shorts step: the picked clips (JSON), each clip's vertical images, and each clip.
     "shorts",
     "short_image",

package/dist/slices/storage/portable.js

@@ -23,8 +23,7 @@ import { appearances, providerById, providerIds } from "../settings/model.js";
 import { listVoices } from "../settings/repo.js";
 import { realPersonVoicesKey, voiceIdMax, voiceNameMax } from "../settings/voices.js";
 import { whatsNewSeenKey } from "../settings/whats-new.js";
-import { studioPlaylistMax } from "../studio/model.js";
-import { studioChannelPlaylistPrefix, studioFillQueuePrefix, studioPairingKey, studioPlaylistKey, studioRealFootageKey, } from "../studio/settings.js";
+import { storedPlaylistsSchema, storedProjectPlaylistsSchema, studioChannelPlaylistPrefix, studioFillQueuePrefix, studioPairingKey, studioPlaylistKey, studioProjectPlaylistsKey, studioRealFootageKey, } from "../studio/settings.js";
 import { channelLinksKey } from "../youtube/edits-repo.js";
 import { defaultBackupsDir, projectDir, stagingPath } from "./layout.js";
 import { stageKinds } from "./model.js";
@@ -354,7 +353,6 @@ const storedAppearance = z.enum(appearances);
 const storedLoudness = z
     .object({ enabled: z.boolean(), videoLufs: z.number(), audioFilesLufs: z.number() })
     .strict();
-const storedPlaylist = z.string().max(studioPlaylistMax);
 // Settings → Channel links, and the providers a fresh Play form starts with.
 // The AI use marks: ticked voices, Image prompts and projects, by id.
 const storedIds = z.array(z.string().max(200)).max(100_000);
@@ -389,7 +387,9 @@ function portableSettings(settings) {
         else if (key === "loudness")
             storedLoudness.parse(parsed);
         else if (key === studioPlaylistKey || key.startsWith(studioChannelPlaylistPrefix))
-            storedPlaylist.parse(parsed);
+            storedPlaylistsSchema.parse(parsed);
+        else if (key === studioProjectPlaylistsKey)
+            storedProjectPlaylistsSchema.parse(parsed);
         else if (key === channelLinksKey)
             storedChannelLinks.parse(parsed);
         else if (key === realPersonVoicesKey ||

package/dist/slices/storage/trim.js

@@ -21,6 +21,8 @@ export const outputRoles = [
     "sources",
     "youtube_description",
     "youtube_tags",
+    "youtube_pinned_comment",
+    "youtube_titles",
     "document_pdf",
     "audio_export",
     "subtitles_srt",

package/dist/slices/studio/pack.js

@@ -17,7 +17,7 @@ import { usesVoices } from "../voices/model.js";
 import { effectiveDescription } from "../youtube/edits-repo.js";
 import { aiDisclosureOf } from "./disclosure.js";
 import { studioAudience, studioTitleMax, } from "./model.js";
-import { readRealFootage, readStudioPlaylist } from "./settings.js";
+import { projectPlaylists, readRealFootage } from "./settings.js";
 // What `shorts.json` holds for each picked clip; only what the pack uses.
 const clipsSchema = z.object({
     shorts: z.array(z.object({
@@ -50,8 +50,10 @@ export function uploadPack(deps, projectId) {
         ? undefined
         : readFileSync(outputPath(deps.paths, projectId, output.path), "utf8").trim();
     const channelId = projectChannelId(deps.db, projectId);
-    // The channel's own playlist, else the default (Settings → YouTube Studio).
-    const playlist = readStudioPlaylist(deps.db, channelId);
+    // The channel's playlists (Settings → YouTube Studio), ticked as this project chose.
+    const playlistChoices = projectPlaylists(deps.db, projectId, channelId);
+    const playlists = playlistChoices.filter((one) => one.chosen).map((one) => one.name);
+    const playlist = playlists[0] ?? null;
     const missing = [];
     // The channel's setting, then what the project narrates and shows (`disclosure.ts`).
     const setting = channelById(deps.db, channelId)?.aiDisclosure ?? "auto";
@@ -84,6 +86,7 @@ export function uploadPack(deps, projectId) {
         : effectiveDescription(deps.db, projectId, {
             description: written,
             tags: writtenTags ?? "",
+            titles: text(outputs.find((output) => output.role === "youtube_titles")),
             // The last chapter is checked against the video's own length when it is known.
             durationSeconds: video?.durationMs === null || video?.durationMs === undefined
                 ? undefined
@@ -107,18 +110,23 @@ export function uploadPack(deps, projectId) {
             : "The thumbnail isn't made yet. Let the Thumbnail stage finish, then open Prepare upload again.");
     else if (thumbnails.length < count)
         missing.push(`Only ${String(thumbnails.length)} of the ${String(count)} thumbnails are made. Regenerate the missing ones in the project's Images section.`);
-    if (playlist === null)
-        missing.push("No playlist is set for this project's channel, so the playlist step is left to you. Set one in Settings → YouTube Studio → Playlist.");
+    if (playlistChoices.length === 0)
+        missing.push("No playlist is set for this project's channel, so the playlist step is left to you. Set one in Settings → YouTube Studio → Playlists.");
     const items = [
         {
             kind: "video",
             video: video === undefined ? null : file(video),
             title: project.title.slice(0, studioTitleMax),
+            titles: (edited?.titles ?? "")
+                .split("\n")
+                .map((one) => one.trim().slice(0, studioTitleMax))
+                .filter((one) => one !== ""),
             description: description ?? "",
             tags: tagsOf(tagsFile),
             thumbnails: thumbnails.map(file),
             audience: studioAudience,
             alteredContent: disclosure("video"),
+            playlists,
             playlist,
             ...(edited?.chapterNotice === undefined ? {} : { chapterNotice: edited.chapterNotice }),
         },
@@ -140,6 +148,7 @@ export function uploadPack(deps, projectId) {
             short: clip.number,
             video: render === undefined ? null : file(render),
             title: clip.title.slice(0, studioTitleMax),
+            titles: [],
             description: [
                 clip.description,
                 fullVideoLine(config.shorts?.fullVideoLink),
@@ -152,6 +161,7 @@ export function uploadPack(deps, projectId) {
             thumbnails: [],
             audience: studioAudience,
             alteredContent: disclosure("short"),
+            playlists,
             playlist,
         });
     }
@@ -162,6 +172,7 @@ export function uploadPack(deps, projectId) {
             projectTitle: project.title,
             items,
             missing,
+            playlistChoices,
             ...(uploadedClips > 0 ? { footage: { clips: uploadedClips, real: realFootage } } : {}),
         },
     };

package/dist/slices/studio/settings.js

@@ -2,7 +2,7 @@ import { randomBytes, timingSafeEqual } from "node:crypto";
 import { z } from "zod";
 import { readSetting, writeSetting } from "../settings/repo.js";
 import { studioPlaylistMax } from "./model.js";
-// Two rows of the key/value `settings` table. The playlist travels with a backup; the
+// Rows of the key/value `settings` table. The playlists travel with a backup; the
 // pairing stays on this machine (`slices/storage/portable.ts`): its token is what lets the
 // browser extension read a project's upload pack.
 export const studioPlaylistKey = "studio.playlist";
@@ -12,23 +12,37 @@ const pairingSchema = z.object({
     origin: z.string().nullable(),
     pairedAt: z.string().nullable(),
 });
-// A channel's own playlist is a row of its own, `studio.playlist.<channelId>`; a channel
-// without one uses the default above.
+// A channel's own playlists are a row of their own, `studio.playlist.<channelId>`; a channel
+// without one uses the default list above. Each playlist is ticked by default or not; a
+// project's Prepare upload can change which it goes into. A row saved before lists existed
+// holds one name, read as one playlist ticked by default.
 export const studioChannelPlaylistPrefix = `${studioPlaylistKey}.`;
 function playlistKey(channelId) {
     return channelId === undefined ? studioPlaylistKey : `${studioChannelPlaylistPrefix}${channelId}`;
 }
-// The playlist an upload pack names: the channel's own, else the default. Without a channel,
-// the default alone.
-export function readStudioPlaylist(db, channelId) {
+// Up to 20 playlists a list: Studio's own dialog shows every playlist of the channel, and a
+// video in more than a handful of them is rare.
+export const studioPlaylistsMax = 20;
+export const studioPlaylistSchema = z.object({
+    name: z.string().trim().min(1).max(studioPlaylistMax),
+    byDefault: z.boolean(),
+});
+// What a row holds: the list, or the one name a row held before lists.
+export const storedPlaylistsSchema = z.union([
+    z.string().max(studioPlaylistMax),
+    z.array(studioPlaylistSchema).max(studioPlaylistsMax),
+]);
+// The playlists a channel's upload packs offer: the channel's own list, else the default.
+// Without a channel, the default alone.
+export function readStudioPlaylists(db, channelId) {
     if (channelId !== undefined) {
-        const own = storedPlaylist(db, playlistKey(channelId));
+        const own = storedPlaylists(db, playlistKey(channelId));
         if (own !== null)
             return own;
     }
-    return storedPlaylist(db, studioPlaylistKey);
+    return storedPlaylists(db, studioPlaylistKey) ?? [];
 }
-// Every channel's own playlist, by channel id.
+// Every channel's own list, by channel id.
 export function readChannelPlaylists(db) {
     const prefix = studioChannelPlaylistPrefix;
     const rows = db
@@ -36,41 +50,92 @@ export function readChannelPlaylists(db) {
         .all(prefix.length, prefix);
     const out = {};
     for (const { key } of rows) {
-        const value = storedPlaylist(db, key);
+        const value = storedPlaylists(db, key);
         if (value !== null)
             out[key.slice(prefix.length)] = value;
     }
     return out;
 }
-function storedPlaylist(db, key) {
+function storedPlaylists(db, key) {
     const stored = readSetting(db, key);
     if (stored === undefined)
         return null;
     try {
-        const value = JSON.parse(stored);
-        return typeof value === "string" && value.trim() !== "" ? value : null;
+        const parsed = storedPlaylistsSchema.safeParse(JSON.parse(stored));
+        if (!parsed.success)
+            return null;
+        if (typeof parsed.data === "string")
+            return parsed.data.trim() === "" ? null : [{ name: parsed.data.trim(), byDefault: true }];
+        return parsed.data.length === 0 ? null : parsed.data;
     }
     catch {
         return null;
     }
 }
-export function studioPlaylistProblem(raw) {
-    return raw.trim().length > studioPlaylistMax
-        ? `The playlist name is longer than YouTube allows (${String(studioPlaylistMax)} characters). Shorten it in Settings → YouTube Studio.`
-        : undefined;
-}
-// Saves the default playlist, or a channel's own; empty clears it (the channel then uses the
-// default again).
-export function saveStudioPlaylist(db, raw, channelId) {
-    const value = raw.trim();
+// Why a list can't be saved, in words for Settings → YouTube Studio; undefined when it can.
+export function studioPlaylistsProblem(list) {
+    const long = list.find((one) => one.name.trim().length > studioPlaylistMax);
+    if (long !== undefined)
+        return `The playlist name "${long.name.slice(0, 40)}…" is longer than YouTube allows (${String(studioPlaylistMax)} characters). Shorten it in Settings → YouTube Studio.`;
+    const seen = new Set();
+    for (const one of list) {
+        const key = one.name.trim().toLowerCase();
+        if (seen.has(key))
+            return `"${one.name.trim()}" is listed twice. Remove one in Settings → YouTube Studio.`;
+        seen.add(key);
+    }
+    return undefined;
+}
+// Saves the default list, or a channel's own; an empty list clears it (the channel then uses
+// the default again). Blank names are dropped.
+export function saveStudioPlaylists(db, list, channelId) {
+    const value = list
+        .map((one) => ({ name: one.name.trim(), byDefault: one.byDefault }))
+        .filter((one) => one.name !== "");
     const key = playlistKey(channelId);
-    if (value === "") {
+    if (value.length === 0) {
         db.prepare("DELETE FROM settings WHERE key = ?").run(key);
-        return null;
+        return [];
     }
     writeSetting(db, key, JSON.stringify(value));
     return value;
 }
+// The playlists a project's uploads go into, when its Prepare upload changed them from the
+// channel's defaults: one row, project id to names.
+export const studioProjectPlaylistsKey = "studio.projectPlaylists";
+export const storedProjectPlaylistsSchema = z.record(z.string().max(64), z.array(z.string().max(studioPlaylistMax)).max(studioPlaylistsMax));
+function projectChoices(db) {
+    const stored = readSetting(db, studioProjectPlaylistsKey);
+    if (stored === undefined)
+        return {};
+    try {
+        const parsed = storedProjectPlaylistsSchema.safeParse(JSON.parse(stored));
+        return parsed.success ? parsed.data : {};
+    }
+    catch {
+        return {};
+    }
+}
+// The channel's playlists, each ticked as this project goes into it: the project's own choice
+// when it made one (a playlist the channel no longer lists is dropped), else the defaults.
+export function projectPlaylists(db, projectId, channelId) {
+    const list = readStudioPlaylists(db, channelId);
+    const own = projectChoices(db)[projectId];
+    return list.map((one) => ({
+        name: one.name,
+        chosen: own === undefined
+            ? one.byDefault
+            : own.some((name) => name.toLowerCase() === one.name.toLowerCase()),
+    }));
+}
+export function saveProjectPlaylists(db, projectId, names) {
+    const { [projectId]: _previous, ...others } = projectChoices(db);
+    const next = names === null ? others : { ...others, [projectId]: [...names] };
+    if (Object.keys(next).length === 0)
+        db.prepare("DELETE FROM settings WHERE key = ?").run(studioProjectPlaylistsKey);
+    else
+        writeSetting(db, studioProjectPlaylistsKey, JSON.stringify(next));
+}
 // The projects whose uploaded clips are real footage (filmed, not generated): ticked in the
 // project's Prepare upload, under AI use. One row holding their ids; YouTube's second AI use
 // case is footage of a real event or place altered by AI (`disclosure.ts`).

package/dist/slices/youtube/answer.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { descriptionMaxCharacters, hashtagsMax, minChapterSeconds, minChapters, tagMaxCharacters, tagsMaxCharacters, } from "./model.js";
+import { alternativeTitles, descriptionMaxCharacters, hashtagsMax, minChapterSeconds, minChapters, pinnedCommentMaxCharacters, tagMaxCharacters, tagsMaxCharacters, titleMaxCharacters, } from "./model.js";
 import { parseTimestamp, youtubeTimestamp } from "./timestamps.js";
 export function descriptionMessages(brief) {
     const end = youtubeTimestamp(brief.durationSeconds);
@@ -8,7 +8,7 @@ export function descriptionMessages(brief) {
             role: "system",
             content: [
                 "You write YouTube descriptions. Answer with one JSON object and nothing else, in this shape:",
-                '{"summary": "...", "chapters": [{"start": "0:00", "title": "..."}], "hashtags": ["#Example"], "tags": ["example tag"]}',
+                '{"summary": "...", "chapters": [{"start": "0:00", "title": "..."}], "hashtags": ["#Example"], "tags": ["example tag"], "pinnedComment": "...", "titles": ["...", "..."]}',
                 "",
                 "Rules YouTube enforces, which the answer must follow:",
                 '- The first chapter starts at exactly "0:00".',
@@ -20,6 +20,11 @@ export function descriptionMessages(brief) {
                 `- Tags are plain search terms without # or commas, each at most ${String(tagMaxCharacters)} characters, no tag repeated, and all tags together at most ${String(tagsMaxCharacters)} characters.`,
                 "- No < or > anywhere.",
                 "- The summary is plain text without chapters, hashtags or links.",
+                `- The pinned comment is plain text without links, at most ${String(pinnedCommentMaxCharacters)} characters.`,
+                `- Titles are exactly ${String(alternativeTitles)} other titles for this video, for YouTube's title A/B test beside the video's own title: each at most ${String(titleMaxCharacters)} characters, one line, different from the video title and from each other.`,
+                "",
+                "The pinned comment is what the channel pins under the video, unless the instructions below say otherwise: one or two short sentences, at most 200 characters, in the same voice as the summary. Ask one question a viewer can answer from their own experience of the subject, and invite a suggestion for the next video.",
+                "The other titles try different angles on the same video (a question, a stake, a surprising fact) while staying true to it and in the video title's language and tone.",
             ].join("\n"),
         },
         {
@@ -42,16 +47,20 @@ const answerSchema = z.object({
     chapters: z.array(z.object({ start: z.union([z.string(), z.number()]), title: z.string() })),
     hashtags: z.array(z.string()),
     tags: z.array(z.string()),
+    pinnedComment: z.string(),
+    titles: z.array(z.string()),
 });
 const fix = "Try again, or choose another model in Edit project → Providers.";
 // Reads and checks the model's answer. The reason is the sentence the stage shows; the
 // provider wrapper's `check` asks the model again while attempts remain.
-export function checkDescriptionAnswer(text, durationSeconds) {
+export function checkDescriptionAnswer(text, durationSeconds, 
+// The video's own title, which the other titles must differ from.
+title = "") {
     const parsed = answerSchema.safeParse(jsonOf(text));
     if (!parsed.success)
         return {
             ok: false,
-            reason: `The AI model's YouTube description didn't come back in the expected format (a JSON object with a summary, chapters, hashtags and tags). ${fix}`,
+            reason: `The AI model's YouTube description didn't come back in the expected format (a JSON object with a summary, chapters, hashtags, tags, a pinned comment and titles). ${fix}`,
         };
     const summary = parsed.data.summary.trim();
     if (summary === "")
@@ -65,7 +74,25 @@ export function checkDescriptionAnswer(text, durationSeconds) {
     const tags = checkTags(parsed.data.tags);
     if (!tags.ok)
         return tags;
-    const value = { summary, chapters: chapters.value, hashtags: hashtags.value, tags: tags.value };
+    const pinnedComment = parsed.data.pinnedComment.trim();
+    if (pinnedComment === "")
+        return { ok: false, reason: `The AI model wrote no pinned comment. ${fix}` };
+    if (pinnedComment.length > pinnedCommentMaxCharacters)
+        return {
+            ok: false,
+            reason: `The AI model's pinned comment is ${String(pinnedComment.length)} characters, over the ${String(pinnedCommentMaxCharacters)} Slopify allows. ${fix}`,
+        };
+    const titles = checkTitles(parsed.data.titles, title);
+    if (!titles.ok)
+        return titles;
+    const value = {
+        titles: titles.value,
+        summary,
+        chapters: chapters.value,
+        hashtags: hashtags.value,
+        tags: tags.value,
+        pinnedComment,
+    };
     const description = assembleDescription(value);
     if (/[<>]/.test(description))
         return {
@@ -139,6 +166,28 @@ function checkChapters(raw, durationSeconds) {
     }
     return { ok: true, value: chapters };
 }
+function checkTitles(raw, title) {
+    const broke = (rule) => ({
+        ok: false,
+        reason: `The AI model's other titles broke YouTube's rules (${rule}). ${fix}`,
+    });
+    const titles = raw.map((one) => one.trim().replace(/\s+/g, " ")).filter((one) => one !== "");
+    if (titles.length !== alternativeTitles)
+        return broke(`there must be ${String(alternativeTitles)} other titles, and it wrote ${String(titles.length)}`);
+    const long = titles.find((one) => one.length > titleMaxCharacters);
+    if (long !== undefined)
+        return broke(`"${long.slice(0, 40)}…" is over ${String(titleMaxCharacters)} characters`);
+    const odd = titles.find((one) => /[<>]/.test(one));
+    if (odd !== undefined)
+        return broke(`"${odd}" contains < or >`);
+    const seen = new Set([title.trim().toLowerCase()]);
+    for (const one of titles) {
+        if (seen.has(one.toLowerCase()))
+            return broke(`"${one}" repeats a title`);
+        seen.add(one.toLowerCase());
+    }
+    return { ok: true, value: titles };
+}
 function checkHashtags(raw) {
     const broke = (rule) => ({
         ok: false,

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

@@ -63,7 +63,8 @@ export function readChannelLinksFor(db, channelId) {
         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 description, tags, pinned comment and other titles 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 its channel's links (one with no link stays as typed). For anything that hands
@@ -71,7 +72,10 @@ export function readChannelLinksFor(db, channelId) {
 // 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 shown = shownFields(resolveFields(splitDescription(generated.description, generated.tags, {
+        pinnedComment: generated.pinnedComment,
+        titles: generated.titles,
+    }), edits.fields));
     const fitted = fitChapters(shown.chapters, generated.durationSeconds);
     const notice = chapterNotice(fitted.adjustments);
     const links = mergeLinks(readChannelLinksFor(db, projectChannelId(db, projectId)), edits.links);
@@ -79,6 +83,8 @@ export function effectiveDescription(db, projectId, generated) {
         description: fillPlaceholders(composeDescription({ ...shown, chapters: fitted.text }), links)
             .text,
         tags: fillPlaceholders(shown.tags, links).text,
+        pinnedComment: fillPlaceholders(shown.pinnedComment, links).text,
+        titles: shown.titles,
         ...(notice === undefined ? {} : { chapterNotice: notice }),
     };
 }

package/dist/slices/youtube/edits.js

@@ -1,14 +1,22 @@
 // Hand edits to the YouTube description. The project page lets the user edit the summary,
-// the chapters, the hashtags and the tags in place; each edit is saved with the generated
+// the chapters, the hashtags, the tags and the pinned comment in place; each edit is saved with the generated
 // text it was made from (`base`), so when the description is written again the page can tell
 // a field the user changed from one they left alone. Browser-safe: the project page applies
 // these rules to what it shows, and the server only stores the edits.
 import { parseTimestamp } from "./timestamps.js";
-export const descriptionFields = ["summary", "chapters", "hashtags", "tags"];
-// Splits a written description back into its three parts. `assembleDescription` (answer.ts) lays it out as
+export const descriptionFields = [
+    "summary",
+    "chapters",
+    "hashtags",
+    "tags",
+    "pinnedComment",
+    "titles",
+];
+// Splits a written description back into its three parts, beside the tags, the pinned comment
+// and the other titles (each empty for a description written before it existed). `assembleDescription` (answer.ts) lays it out as
 // the summary, a blank line, one chapter per line, a blank line and the hashtags; reading it
 // from the end keeps a summary with blank lines of its own whole.
-export function splitDescription(description, tags) {
+export function splitDescription(description, tags, extras = {}) {
     const lines = description.replace(/\r\n?/gu, "\n").split("\n");
     while (lines.length > 0 && lines.at(-1)?.trim() === "")
         lines.pop();
@@ -29,6 +37,8 @@ export function splitDescription(description, tags) {
         chapters: chapters.join("\n"),
         hashtags,
         tags: tags.trim(),
+        pinnedComment: (extras.pinnedComment ?? "").trim(),
+        titles: (extras.titles ?? "").trim(),
     };
 }
 function isChapterLine(line) {
@@ -65,6 +75,8 @@ export function resolveFields(generated, edits) {
         chapters: one("chapters"),
         hashtags: one("hashtags"),
         tags: one("tags"),
+        pinnedComment: one("pinnedComment"),
+        titles: one("titles"),
     };
 }
 export function shownFields(resolved) {
@@ -73,6 +85,8 @@ export function shownFields(resolved) {
         chapters: resolved.chapters.text,
         hashtags: resolved.hashtags.text,
         tags: resolved.tags.text,
+        pinnedComment: resolved.pinnedComment.text,
+        titles: resolved.titles.text,
     };
 }
 // Saving an edit: text equal to the generated text is no edit at all, so the field follows the

package/dist/slices/youtube/model.js

@@ -1,5 +1,6 @@
 // The optional YouTube description step of the Video stage: a short summary, a chapter list
-// YouTube turns into chapters, hashtags, and a separate list for YouTube's Tags field.
+// YouTube turns into chapters, hashtags, a separate list for YouTube's Tags field, a comment
+// to pin under the video, and two more titles for YouTube's title A/B test.
 // Browser-safe: Play, Edit project and the project page read these names and limits too.
 // YouTube's own rules for chapters in a description: the first starts at 0:00, there are at
 // least three, and each lasts at least ten seconds.
@@ -12,6 +13,13 @@ export const tagMaxCharacters = 100;
 export const hashtagsMax = 15;
 // YouTube's limit on a description.
 export const descriptionMaxCharacters = 5000;
+// YouTube's title A/B test ("Test & compare") takes up to three titles: the video's own and
+// these alternatives. YouTube's limit on a title.
+export const alternativeTitles = 2;
+export const titleMaxCharacters = 100;
+// YouTube's limit on a comment is 10,000; a pinned comment people read in full is a line or
+// two. The model is asked for 200; this is the most a hand-picked prompt may make it.
+export const pinnedCommentMaxCharacters = 500;
 // What a project uses when no Description prompt from the library is picked. No keywords,
 // so it never asks Play for a field.
 export const defaultDescriptionPrompt = [

package/dist/tutorials/Document-Themes.md

@@ -57,7 +57,7 @@ Sizes are in millimetres (mm) unless marked pt (points; 1 pt is about 0.35 mm).
 
 ### Fonts
 
-Each font has three controls: the family, its weight or italic, and **Letter spacing (mm)** from −0.5 to 2. The families are **Cinzel** (bundled; four weights, no italics) and **Times**, **Helvetica** and **Courier** (built into every PDF reader).
+Each font has three controls: the family, its weight or italic, and **Letter spacing (mm)** from −0.5 to 2. The families are **Cinzel** (bundled; four weights, no italics), **Literata** (bundled; a text face made for long reading, in regular, bold, italic and bold italic) and **Times**, **Helvetica** and **Courier** (built into every PDF reader).
 
 | Setting | Where it is used | Default |
 |---|---|---|

package/dist/tutorials/Home-and-Projects.md

@@ -19,7 +19,7 @@ From top to bottom:
 | Destinations | **Home**, **Projects**, **Calendar** (also lit on Schedules), **Channels**, **Library** (Prompts, Intros & Outros, Templates, Document themes, Narration aliases), **Settings** (also lit on Usage). |
 | **N running** | Shown while runs are going. It links to Running now on Home. |
 | **Channel** | The channel picker (see below). |
-| **New video** | Opens Play (`C` from anywhere). |
+| **New project** | Opens Play (`C` from anywhere). |
 | Links | **GitHub**, **Patreon** and **Buy Me a Coffee**, each opening in a new tab. |
 | Foot | "Free. Your keys, your machine.", the updates button (circular arrows, see [Updating and Patch Notes](Updating-and-Patch-Notes)) and the tutorial button (question mark, **Start interactive tutorial**). |
 
@@ -33,7 +33,7 @@ In every list, a press anywhere on a row or tile opens or picks it, not only on
 
 ### The command palette
 
-Press `Ctrl+K`, or click **Search or run a command**, to jump anywhere or run an action by typing. The **Go to** group has **Open home**, **Open projects**, **Open calendar**, **Open schedules**, **Open channels**, **Open library**, **Open settings**, **Open usage and costs** and **Show patch notes**. **New video** opens Play. The **Channel** group has **Show all channels** and **Switch to <channel>**. See [Keyboard Shortcuts and Command Palette](Keyboard-Shortcuts-and-Command-Palette).
+Press `Ctrl+K`, or click **Search or run a command**, to jump anywhere or run an action by typing. The **Go to** group has **Open home**, **Open projects**, **Open calendar**, **Open schedules**, **Open channels**, **Open library**, **Open settings**, **Open usage and costs** and **Show patch notes**. **New project** opens Play. The **Channel** group has **Show all channels** and **Switch to <channel>**. See [Keyboard Shortcuts and Command Palette](Keyboard-Shortcuts-and-Command-Palette).
 
 ### The Channel picker
 
@@ -43,7 +43,7 @@ The **Channel** picker near the foot of the sidebar (at the top of Home on a pho
 
 **Where to find it:** the sidebar → **Home**.
 
-The page title is the channel you picked (or **Home**), under today's date. At the top right are **Open calendar** and **New video**.
+The page title is the channel you picked (or **Home**), under today's date. At the top right are **Open calendar** and **New project**.
 
 On a fresh install, Home sends you to the first-run screen once. See [First Launch and Welcome](First-Launch-and-Welcome).
 
@@ -98,7 +98,7 @@ See [Costs and Run Cost](Costs-and-Run-Cost).
 
 **Where to find it:** the sidebar → **Projects**.
 
-Every run ever started, newest first, for the channel picked in the sidebar. The heading says how many projects there are and for which channel. **New video** opens Play.
+Every run ever started, newest first, for the channel picked in the sidebar. The heading says how many projects there are and for which channel. **New project** opens Play.
 
 ### Search and filter
 

package/dist/tutorials/Keyboard-Shortcuts-and-Command-Palette.md

@@ -7,7 +7,7 @@ The command palette lets you reach every screen, every project and the frequent
 ## Use the command palette
 
 1. Press `Ctrl+K`.
-2. Type a few letters of what you want, such as `set` for **Open settings** or `back` for **Back up now**. Letters only need to appear in order, so `nwv` finds **New video**. Commands also match other words, for example `keys` finds **Open settings**. Several words match in any order across the command's name, the project it acts on and its other words: `cleopatra regenerate image 3` finds **Regenerate image 3 in Cleopatra**.
+2. Type a few letters of what you want, such as `set` for **Open settings** or `back` for **Back up now**. Letters only need to appear in order, so `nwv` finds **New project**. Commands also match other words, for example `keys` finds **Open settings**. Several words match in any order across the command's name, the project it acts on and its other words: `cleopatra regenerate image 3` finds **Regenerate image 3 in Cleopatra**.
 3. Use `Up` and `Down` to move through the list, `Home` and `End` to jump to the first or last, and `Enter` to run the highlighted command. You can also click a command.
 4. Press `Esc` (or `Ctrl+K` again) to close the palette without running anything.
 
@@ -23,7 +23,7 @@ Press `?` anywhere (outside a text field) to see **Keyboard shortcuts**: every k
 |---|---|---|
 | `Ctrl+K` / `Cmd+K` | Anywhere | Opens or closes the command palette. |
 | `?` | Anywhere | Shows the keyboard shortcuts. |
-| `C` | Anywhere | **New video** (opens Play). |
+| `C` | Anywhere | **New project** (opens Play). |
 | `G` then `H` | Anywhere | Go to Home. |
 | `G` then `P` | Anywhere | Go to Projects. |
 | `G` then `C` | Anywhere | Go to the Calendar. |
@@ -70,7 +70,7 @@ Commands are grouped under headings in the palette. Group names below are the he
 
 | Command | What it does |
 |---|---|
-| **New video** (`C`) | Opens Play. |
+| **New project** (`C`) | Opens Play. |
 | **Show all channels** | Shows every channel's projects, schedules and costs. |
 | **Switch to <channel>** | Shows one channel only. There is one command per channel. |