@gentbajko/slopify 2.0.3 → 2.1.0

package/dist/slices/document/writer.js

@@ -0,0 +1,66 @@
+import { useFace } from "./fonts.js";
+import { parseHexColor } from "./theme.js";
+export function createWriter(doc, theme, assets) {
+    const width = doc.internal.pageSize.getWidth();
+    const height = doc.internal.pageSize.getHeight();
+    const colors = {
+        heading: parseHexColor(theme.colors.heading),
+        text: parseHexColor(theme.colors.text),
+        muted: parseHexColor(theme.colors.muted),
+        faint: parseHexColor(theme.colors.faint),
+    };
+    const writer = {
+        doc,
+        theme,
+        colors,
+        width,
+        height,
+        left: theme.page.margin,
+        contentWidth: width - theme.page.margin * 2,
+        bottom: height - theme.footer.bottom - theme.footer.reserve,
+        y: theme.page.contentTop,
+        addPage() {
+            doc.addPage();
+            paintBackground(doc, theme, assets, width, height);
+            writer.y = theme.page.contentTop;
+        },
+        ensure(needed) {
+            if (writer.y + needed > writer.bottom)
+                writer.addPage();
+        },
+        page() {
+            return doc.getCurrentPageInfo().pageNumber;
+        },
+        write(text, x, y, face, size, color, align = "left") {
+            useFace(doc, face, size);
+            const rgb = colors[color];
+            doc.setTextColor(rgb.r, rgb.g, rgb.b);
+            doc.text(text, x, y, align === "left" ? {} : { align });
+            doc.setCharSpace(0);
+        },
+    };
+    paintBackground(doc, theme, assets, width, height);
+    return writer;
+}
+// The texture when the theme has one, otherwise the flat colour with slightly darker edges.
+function paintBackground(doc, theme, assets, width, height) {
+    if (theme.background.image === "parchment") {
+        // The alias embeds the image once and points every page at it.
+        doc.addImage(assets.parchment, "JPEG", 0, 0, width, height, "parchment");
+        return;
+    }
+    const base = parseHexColor(theme.background.color);
+    doc.setFillColor(base.r, base.g, base.b);
+    doc.rect(0, 0, width, height, "F");
+    const steps = 4;
+    const thickness = 2;
+    for (let step = 0; step < steps; step += 1) {
+        const inset = step * 2;
+        const shade = (channel) => Math.max(0, Math.round(channel - 15 * (1 - step / steps)));
+        doc.setFillColor(shade(base.r), shade(base.g), shade(base.b));
+        doc.rect(inset, inset, width - 2 * inset, thickness, "F");
+        doc.rect(inset, height - inset - thickness, width - 2 * inset, thickness, "F");
+        doc.rect(inset, inset, thickness, height - 2 * inset, "F");
+        doc.rect(width - inset - thickness, inset, thickness, height - 2 * inset, "F");
+    }
+}

package/dist/slices/estimate/index.js

@@ -1,10 +1,12 @@
 import { z } from "zod";
-import { usesNarrationPreparation } from "../admission/rules.js";
+import { sourceOf } from "../admission/model.js";
+import { usesNarrationPreparation, usesYoutubeDescription } from "../admission/rules.js";
 import { plainText } from "../article/plain.js";
 import { splitEndMatter } from "../article/split.js";
 import { chunkNarration, defaultChunking } from "../narration/chunk.js";
 import { normalizeNarrationText } from "../narration/plan.js";
 import { preparationMessages } from "../narration/preparation.js";
+import { defaultDescriptionPrompt } from "../youtube/model.js";
 import { estimateRequests, groupEstimateRows } from "./requests.js";
 export { estimateRequests } from "./requests.js";
 export function estimateRun(draft, rendered, expectedWords, catalogue) {
@@ -32,7 +34,7 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
         !model.deprecated)?.pricing.note ?? "Model or account pricing is unknown.";
     const generatedArticle = draft.sources.article === "generate";
     const articleChars = generatedArticle ? expectedWords * 6 : (draft.provided.article?.length ?? 0);
-    const promptChars = Object.entries(rendered).reduce((sum, [key, value]) => sum + (key === "narration" ? 0 : value.length), 0);
+    const promptChars = Object.entries(rendered).reduce((sum, [key, value]) => sum + (key === "narration" || key === "description" ? 0 : value.length), 0);
     const local = (stage, detail) => {
         requests.push({ kind: "local", stage, detail });
     };
@@ -122,6 +124,16 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
     if (draft.sources.thumbnail === "prompt_by_llm")
         text("Thumbnail prompt", promptChars + articleChars, 1200);
     local("Export / subtitles", "Local processing; no API fee.");
+    // The timed transcript is the narration with a time before every passage of about 20 s,
+    // plus the fixed rules of the answer.
+    if (usesYoutubeDescription(draft))
+        text("YouTube description", (rendered.description?.trim()
+            ? rendered.description.length
+            : defaultDescriptionPrompt.length) +
+            Math.round(articleChars * 1.05) +
+            1500, 2400, "One LLM call on the timed transcript.");
+    if (sourceOf(draft.sources, "document") === "generate")
+        local("Document", "Laid out locally from the article; no API fee.");
     return {
         ...groupEstimateRows(estimateRequests(requests, data)),
         expectedWords,

package/dist/slices/library/model.js

@@ -2,7 +2,7 @@
 // set covers both, which is why the drafts, the lint and the save path below are shared
 // rather than mirrored.
 export { entryModes } from "../admission/model.js";
-export const promptKinds = ["article", "image", "thumbnail", "narration"];
+export const promptKinds = ["article", "image", "thumbnail", "narration", "description"];
 export const entryCategories = ["intro", "outro"];
 // The name is what the Play pickers show, so it shares admission's title bound.
 export const nameMax = 200;

package/dist/slices/library/slots.js

@@ -2,7 +2,7 @@
 // the picked templates, the slot names they ask for, and the rendered text stored on the
 // project. The bodies are read at the click, not at selection, so an edit made in between
 // is the one that runs.
-import { normaliseDraft, usesNarrationPreparation } from "../admission/rules.js";
+import { normaliseDraft, usesNarrationPreparation, usesYoutubeDescription, } from "../admission/rules.js";
 import { collectFields, render } from "../admission/substitute.js";
 import { snapshotEntry, snapshotPrompt } from "./snapshot.js";
 export function pickTemplates(db, input, snapshot) {
@@ -22,6 +22,9 @@ export function pickTemplates(db, input, snapshot) {
     const outro = pickEntry(db, "outro", draft.outro, missing, snapshot);
     push(text, "intro", intro);
     push(text, "outro", outro);
+    // None picked is the built-in prompt, which asks for no keyword.
+    if (usesYoutubeDescription(draft))
+        body(db, "description", draft.descriptionPrompt, "descriptionPrompt", missing, text, "description", snapshot);
     if (sources.images === "generate") {
         for (const [index, picked] of draft.imagePrompts.entries()) {
             const field = `imagePrompts.${String(index)}.name`;

package/dist/slices/play-drafts/convert.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
-import { numberPerPromptMax } from "../admission/rules.js";
+import { defaultEdgeSilenceSeconds, defaultImageSeconds, defaultZoomPercent, edgeSilenceSecondsProblem, imageSecondsProblem, numberPerPromptMax, zoomPercentProblem, } from "../admission/rules.js";
 import { runDraftSchema } from "../admission/schema.js";
+import { documentThemeOf } from "../document/model.js";
 import { defaultSubtitles } from "../subtitles/model.js";
 export function toAdmissionDraft(input) {
     const { form } = input.document;
@@ -22,6 +23,18 @@ export function toAdmissionDraft(input) {
         fields.push({ field, message: `Enter a whole number between ${min} and ${max}.` });
         return min;
     };
+    // A value the run uses is refused in the rule's words; one it ignores (the control is
+    // hidden) falls back to the default rather than holding up the run.
+    const measure = (field, used, fallback, problem) => {
+        const raw = form[field].trim();
+        const value = raw === "" ? Number.NaN : Number(raw);
+        const refused = problem(value);
+        if (refused === undefined)
+            return value;
+        if (used)
+            fields.push({ field, message: refused });
+        return fallback;
+    };
     const entry = (category) => {
         const name = form[category];
         if (sources.audio !== "generate" || name === "")
@@ -58,6 +71,9 @@ export function toAdmissionDraft(input) {
         title: form.title,
         format: form.format,
         sources,
+        ...(sources.document === "generate"
+            ? { document: { theme: documentThemeOf(form.document) } }
+            : {}),
         llm: form.llm,
         audio: sources.audio === "generate" || form.audio.usePronunciationGlossary !== undefined
             ? form.audio
@@ -67,6 +83,13 @@ export function toAdmissionDraft(input) {
         ...(sources.audio === "generate" && form.narrationPrompt?.trim()
             ? { narrationPrompt: form.narrationPrompt }
             : {}),
+        // Timed from the narration, so a switch left on with narration Off asks for nothing.
+        ...(sources.audio !== "off" && form.youtubeDescription === true
+            ? {
+                youtubeDescription: true,
+                ...(form.descriptionPrompt?.trim() ? { descriptionPrompt: form.descriptionPrompt } : {}),
+            }
+            : {}),
         imagePrompts: sources.images === "generate"
             ? form.imagePrompts.map((prompt, index) => ({
                 name: prompt.name,
@@ -112,6 +135,12 @@ export function toAdmissionDraft(input) {
                 fontSize: number(form.subtitles.fontSize, "subtitles.fontSize", 120, 16),
             },
         silenceGapSeconds: input.silenceGapSeconds,
+        imageSeconds: measure("imageSeconds", sources.video === "generate", defaultImageSeconds, imageSecondsProblem),
+        zoomPercent: measure("zoomPercent", sources.video === "generate", defaultZoomPercent, zoomPercentProblem),
+        // A choice from a list, so there is nothing to refuse; a run without a video keeps it
+        // for when the video is turned back on.
+        motionStyle: form.motionStyle,
+        edgeSilenceSeconds: measure("edgeSilenceSeconds", sources.audio !== "off", defaultEdgeSilenceSeconds, edgeSilenceSecondsProblem),
     };
     const parsed = runDraftSchema.safeParse(draft);
     if (!parsed.success)

package/dist/slices/play-drafts/readiness.js

@@ -1,7 +1,7 @@
 import { checkRuntimeModel } from "../../catalog/runtime-models.js";
 import { modelFields } from "../../catalog/validate.js";
 import { readinessIsUsable } from "../../kernel/ports/model.js";
-import { usesNarrationPreparation } from "../admission/rules.js";
+import { usesNarrationPreparation, usesYoutubeDescription, } from "../admission/rules.js";
 import { cliPathChanged } from "../settings/cli-paths.js";
 import { hasKey, listVoices } from "../settings/repo.js";
 export function choices(runs) {
@@ -16,7 +16,8 @@ export function choices(runs) {
                 d.sources.thumbnail === "prompt_by_llm" ||
                 d.intro?.mode === "llm" ||
                 d.outro?.mode === "llm" ||
-                usesNarrationPreparation(d),
+                usesNarrationPreparation(d) ||
+                usesYoutubeDescription(d),
         },
         {
             field: "audio",

package/dist/slices/play-drafts/schema.js

@@ -1,9 +1,11 @@
 import { z } from "zod";
-import { formats } from "../../kernel/pipeline.js";
+import { formats, stageKinds } from "../../kernel/pipeline.js";
 import { thinkingModes } from "../../kernel/ports/llm.js";
-import { stageSources } from "../admission/model.js";
+import { motionStyles, stageSources } from "../admission/model.js";
+import { defaultEdgeSilenceSeconds, defaultImageSeconds, defaultMotionStyle, defaultZoomPercent, } from "../admission/rules.js";
 import { runDraftSchema } from "../admission/schema.js";
 import { checkpointRowSchema, checkpointStageSchema } from "../checkpoints/schema.js";
+import { documentThemes } from "../document/model.js";
 import { librarySnapshotSchema } from "../library/snapshot.js";
 import { chunkModes } from "../narration/chunk.js";
 import { subtitleModes, subtitlePositions } from "../subtitles/model.js";
@@ -27,9 +29,17 @@ export const playDraftFormSchema = z
         images: z.enum(stageSources),
         thumbnail: z.enum(stageSources),
         video: z.enum(stageSources),
+        // Absent on drafts and templates saved before the Document stage: Off.
+        document: z.enum(stageSources).optional(),
     })
         .strict()
         .readonly(),
+    // Absent until the theme is first chosen: the default theme.
+    document: z
+        .object({ theme: z.enum(documentThemes) })
+        .strict()
+        .readonly()
+        .optional(),
     llm: provider.readonly(),
     audio: provider
         .extend({ voice: text, usePronunciationGlossary: z.boolean().optional() })
@@ -37,6 +47,9 @@ export const playDraftFormSchema = z
     images: provider.readonly(),
     articlePrompt: text,
     narrationPrompt: text.optional(),
+    // Absent on drafts and templates saved before the YouTube description: off, built-in prompt.
+    youtubeDescription: z.boolean().optional(),
+    descriptionPrompt: text.optional(),
     imagePrompts: z.array(z.object({ name: text, number: text }).strict().readonly()).readonly(),
     thumbnailPrompt: text,
     intro: text,
@@ -55,6 +68,12 @@ export const playDraftFormSchema = z
     })
         .strict()
         .readonly(),
+    // Raw text, like every other number on Play, so what was typed survives a reload.
+    // Defaulted for drafts and templates saved before these controls existed.
+    imageSeconds: text.default(String(defaultImageSeconds)),
+    edgeSilenceSeconds: text.default(String(defaultEdgeSilenceSeconds)),
+    zoomPercent: text.default(String(defaultZoomPercent)),
+    motionStyle: z.enum(motionStyles).default(defaultMotionStyle),
     values,
     provided: z
         .object({
@@ -183,9 +202,7 @@ export const playReviewSchema = z
         stage: checkpointStageSchema,
         fingerprint: text,
         workKeys: z.array(text).readonly(),
-        dependents: z
-            .array(z.enum(["research", "article", "audio", "images", "thumbnail", "video"]))
-            .readonly(),
+        dependents: z.array(z.enum(stageKinds)).readonly(),
     })
         .strict()
         .readonly())

package/dist/slices/project-templates/from-project.js

@@ -74,6 +74,7 @@ function documentFromProject(deps, revision) {
     };
     addPrompt("article", config.articlePrompt, "article");
     addPrompt("narration", config.narrationPrompt, "narration");
+    addPrompt("description", config.descriptionPrompt, "description");
     const definitions = revision.content.imageOrder.flatMap((key) => {
         const definition = revision.content.imageDefinitions[key];
         return definition === undefined ? [] : [definition];
@@ -127,12 +128,17 @@ function documentFromProject(deps, revision) {
             title: config.title,
             format: config.format,
             sources: config.sources,
+            ...(config.document === undefined ? {} : { document: config.document }),
             checkpoints: listCheckpoints(deps.db, revision.projectId, revision.id).map((gate) => gate.stage),
             llm: config.llm ?? { provider: "", model: "" },
             audio: config.audio ?? { provider: "", model: "", voice: "" },
             images: config.images ?? { provider: "", model: "" },
             articlePrompt: config.articlePrompt ?? "",
             ...(config.narrationPrompt === undefined ? {} : { narrationPrompt: config.narrationPrompt }),
+            ...(config.youtubeDescription === true ? { youtubeDescription: true } : {}),
+            ...(config.descriptionPrompt === undefined
+                ? {}
+                : { descriptionPrompt: config.descriptionPrompt }),
             imagePrompts,
             thumbnailPrompt: config.thumbnailPrompt ?? "",
             intro: config.intro?.name ?? "",
@@ -149,6 +155,10 @@ function documentFromProject(deps, revision) {
                 fontSize: config.subtitles?.fontSize === undefined ? "48" : String(config.subtitles.fontSize),
                 position: config.subtitles?.position ?? "bottom",
             },
+            imageSeconds: String(config.imageSeconds),
+            edgeSilenceSeconds: String(config.edgeSilenceSeconds),
+            zoomPercent: String(config.zoomPercent),
+            motionStyle: config.motionStyle,
             values: config.values,
             provided,
         },

package/dist/slices/project-templates/setup.js

@@ -5,6 +5,7 @@ export function templateSetup(deps, input) {
     const choices = [
         { kind: "article", name: input.form.articlePrompt },
         { kind: "narration", name: input.form.narrationPrompt ?? "" },
+        { kind: "description", name: input.form.descriptionPrompt ?? "" },
         ...input.form.imagePrompts.map((row) => ({ kind: "image", name: row.name })),
         { kind: "thumbnail", name: input.form.thumbnailPrompt },
     ];

package/dist/slices/rebuild/preview-details.js

@@ -1,4 +1,7 @@
 import { stageKinds } from "../../kernel/pipeline.js";
+import { sourceOf } from "../admission/model.js";
+import { motionStyleLabels } from "../admission/rules.js";
+import { documentThemeLabels, documentThemeOf } from "../document/model.js";
 import { getRevisionView } from "../revisions/view.js";
 export function previewDetails(deps, view, allRecipes, selected) {
     const parent = view.revision.parentId === null
@@ -111,7 +114,7 @@ function inputChanges(parent, view) {
     add("Project title", before.title, after.title);
     add("Aspect ratio", before.format, after.format);
     for (const kind of stageKinds)
-        add(`${kind[0]?.toUpperCase()}${kind.slice(1)} source`, before.sources[kind], after.sources[kind]);
+        add(`${kind[0]?.toUpperCase()}${kind.slice(1)} source`, sourceOf(before.sources, kind), sourceOf(after.sources, kind));
     for (const [name, a, b] of [
         ["Text", before.llm, after.llm],
         ["Narration", before.audio, after.audio],
@@ -124,10 +127,17 @@ function inputChanges(parent, view) {
     add("Narration voice", before.audio?.voice, after.audio?.voice);
     add("Narration Preparation", before.narrationPrompt, after.narrationPrompt);
     add("Narration chunking", before.chunking, after.chunking);
+    add("YouTube description", before.youtubeDescription === true ? "On" : "Off", after.youtubeDescription === true ? "On" : "Off");
+    add("Description prompt", before.descriptionPrompt, after.descriptionPrompt);
     add("Silence gap (seconds)", before.silenceGapSeconds, after.silenceGapSeconds);
+    add("Silence at start and end (seconds)", before.edgeSilenceSeconds, after.edgeSilenceSeconds);
+    add("Seconds per image", before.imageSeconds, after.imageSeconds);
+    add("Zoom (%)", before.zoomPercent, after.zoomPercent);
+    add("Motion", motionStyleLabels[before.motionStyle], motionStyleLabels[after.motionStyle]);
     add("Intro", before.intro, after.intro);
     add("Outro", before.outro, after.outro);
     add("Subtitle settings", before.subtitles, after.subtitles);
+    add("Document theme", documentThemeLabels[documentThemeOf(before.document)], documentThemeLabels[documentThemeOf(after.document)]);
     add("Article text", parent.articleMarkdown, view.articleMarkdown);
     add("Provided research", before.provided.research, after.provided.research);
     for (const key of new Set([...Object.keys(before.values), ...Object.keys(after.values)]))

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

@@ -152,6 +152,9 @@ export function audioRecipes(context, text) {
             "audio-media-v1",
             ordered.map(({ value }) => resourceIdentity(context, value)),
             config.silenceGapSeconds,
+            // The exported timeline, not a narration piece: the silence only reaches the
+            // exports that read this fingerprint.
+            config.edgeSilenceSeconds,
         ]),
         timeline,
         keys: ordered.map(({ value }) => value.key),

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

@@ -1,17 +1,22 @@
 import { audioRecipes } from "./recipe-audio.js";
+import { documentRecipes } from "./recipe-document.js";
 import { exportRecipes } from "./recipe-exports.js";
 import { textRecipes } from "./recipe-text.js";
 import { thumbnailRecipes, visualAssets, visualRecipes } from "./recipe-visual.js";
+import { youtubeRecipes } from "./recipe-youtube.js";
 export function buildRecipes(context) {
     const text = textRecipes(context);
     const audio = audioRecipes(context, text);
     const exports = exportRecipes(context, audio);
     const captions = exports.find((value) => value.key === "subtitles:files");
+    const thumbnail = thumbnailRecipes(context, text.recipes);
     return [
         ...text.recipes,
         ...audio.recipes,
         ...exports,
-        ...thumbnailRecipes(context, text.recipes),
+        ...youtubeRecipes(context, exports),
+        ...thumbnail,
+        ...documentRecipes(context, text, thumbnail),
         ...visualAssets(context, visualRecipes(context.config, context.content, audio.mediaFingerprint, captions?.fingerprint ?? null)),
     ];
 }

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

@@ -0,0 +1,36 @@
+import { sourceOf } from "../admission/model.js";
+import { documentThemeOf } from "../document/model.js";
+import { builtInTheme } from "../document/theme.js";
+import { recipe, resourceIdentity, } from "./recipe-model.js";
+// Bumped when the renderer's output changes for the same inputs, so documents made by an
+// older one read as outdated rather than current.
+const renderer = "document-v1";
+// The PDF is made from the saved article (whose end matter feeds the Sources page), the
+// research notes' links, the thumbnail as a cover and the resolved theme. It waits for
+// nothing else, so narration and images run beside it.
+export function documentRecipes(context, text, thumbnail) {
+    const { config } = context;
+    if (sourceOf(config.sources, "document") !== "generate")
+        return [];
+    const notes = text.recipes.find((value) => value.key === "research:notes");
+    const cover = thumbnail.find((value) => value.key === "thumbnail:image");
+    const theme = builtInTheme(documentThemeOf(config.document));
+    return [
+        recipe(context, "document:pdf", "document", {
+            kind: "local",
+            version: 1,
+            operation: "render-document",
+            values: [
+                renderer,
+                config.title,
+                JSON.parse(JSON.stringify(theme)),
+                resourceIdentity(context, text.article),
+                notes === undefined ? null : resourceIdentity(context, notes),
+                cover === undefined ? null : resourceIdentity(context, cover),
+            ],
+        }, [
+            text.article.key,
+            ...[notes, cover].flatMap((value) => (value === undefined ? [] : [value.key])),
+        ]),
+    ];
+}

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

@@ -1,3 +1,4 @@
+import { usesYoutubeDescription } from "../admission/rules.js";
 import { audioExportArgs } from "../video/audio-export-args.js";
 import { recipe, resourceIdentity, } from "./recipe-model.js";
 export function exportRecipes(context, audio) {
@@ -15,15 +16,26 @@ export function exportRecipes(context, audio) {
                 audioExportArgs([{ kind: "body", path: "$body", seconds: 0 }], "$output"),
             ],
         }, audio.keys));
-    if (config.subtitles === undefined || config.subtitles.mode === "off")
+    const captions = config.subtitles !== undefined && config.subtitles.mode !== "off";
+    // The YouTube description's chapters use the same word timing, so it runs for them even
+    // with captions off; only the caption files below wait for captions.
+    if (!captions && !usesYoutubeDescription(config))
         return recipes;
     const timing = recipe(context, "subtitles:timing", "video", {
         kind: "local",
         version: 1,
         operation: "wav2vec2-en-a19f851-v2-omissions",
-        values: [audio.timeline, config.silenceGapSeconds, config.subtitles.language],
+        // The lead-in moves every word, so the edge silence is part of the timing.
+        values: [
+            audio.timeline,
+            config.silenceGapSeconds,
+            config.subtitles?.language ?? "en",
+            config.edgeSilenceSeconds,
+        ],
     }, audio.keys);
     recipes.push(timing);
+    if (config.subtitles === undefined || config.subtitles.mode === "off")
+        return recipes;
     const cues = content.subtitleCues;
     const cueRecipe = cues === undefined
         ? recipe(context, "subtitles:cues", "video", {

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

@@ -17,6 +17,10 @@ export const config = {
     values: {},
     provided: { article: "First paragraph.\n\nSecond paragraph." },
     silenceGapSeconds: 0,
+    imageSeconds: 15,
+    zoomPercent: 22.5,
+    motionStyle: "zoom",
+    edgeSilenceSeconds: 0,
     rendered: { article: "Write an article." },
 };
 export const content = {

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

@@ -54,6 +54,11 @@ export function legacyOutputWorkKey(output, config) {
             return "export:wav";
         case "video":
             return "export:video";
+        case "document_pdf":
+            return "document:pdf";
+        case "youtube_description":
+        case "youtube_tags":
+            return "youtube:description";
         case "subtitles_srt":
         case "subtitles_vtt":
         case "subtitle_ass":

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

@@ -15,6 +15,8 @@ export const localOperations = [
     "entry-text",
     "concat-narration",
     "narration-files-v1",
+    "render-document",
+    "youtube-description-v1",
 ];
 export const deferredOperations = [
     "narration-preparation",

package/dist/slices/rebuild/recipe-provider-choice.js

@@ -2,6 +2,9 @@ export function recipeProviderChoice(recipe, config) {
     const input = recipe.input;
     if (input.kind === "llm" || input.kind === "tts" || input.kind === "image")
         return { ...input, family: input.kind };
+    // The YouTube description's request is built when it runs, from the project's LLM row.
+    if (input.kind === "local" && input.operation === "youtube-description-v1")
+        return config.llm === undefined ? undefined : { ...config.llm, family: "llm" };
     if (input.kind !== "deferred")
         return undefined;
     const family = input.operation === "narration-preparation"

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

@@ -1,5 +1,6 @@
 import { stageKinds } from "../../kernel/pipeline.js";
-import { allowedSources, normaliseDraft, silenceGapSecondsMax, } from "../admission/rules.js";
+import { sourceOf } from "../admission/model.js";
+import { allowedSources, edgeSilenceSecondsProblem, imageSecondsProblem, normaliseDraft, silenceGapSecondsMax, zoomPercentProblem, } from "../admission/rules.js";
 import { render } from "../admission/substitute.js";
 import { buildRecipes } from "./recipe-build.js";
 import { selectedReference } from "./recipe-model.js";
@@ -153,10 +154,10 @@ function normalizeImages(content) {
 export function validateRevisionEdit(config, content) {
     const fields = [];
     for (const kind of stageKinds)
-        if (!allowedSources[kind].includes(config.sources[kind]))
+        if (!allowedSources[kind].includes(sourceOf(config.sources, kind)))
             fields.push({
                 field: `sources.${kind}`,
-                message: `The ${kind} stage cannot be set to ${config.sources[kind]}.`,
+                message: `The ${kind} stage cannot be set to ${sourceOf(config.sources, kind)}.`,
             });
     if (config.sources.images === "provide" &&
         content.imageOrder.some((key) => content.imageDefinitions[key]?.source === "generate"))
@@ -187,6 +188,17 @@ export function validateRevisionEdit(config, content) {
             field: "silenceGapSeconds",
             message: `Use a gap between 0 and ${silenceGapSecondsMax} seconds.`,
         });
+    const imageProblem = config.sources.video === "off" ? undefined : imageSecondsProblem(config.imageSeconds);
+    if (imageProblem !== undefined)
+        fields.push({ field: "imageSeconds", message: imageProblem });
+    const zoomProblem = config.sources.video === "off" ? undefined : zoomPercentProblem(config.zoomPercent);
+    if (zoomProblem !== undefined)
+        fields.push({ field: "zoomPercent", message: zoomProblem });
+    const edgeProblem = config.sources.audio === "off"
+        ? undefined
+        : edgeSilenceSecondsProblem(config.edgeSilenceSeconds);
+    if (edgeProblem !== undefined)
+        fields.push({ field: "edgeSilenceSeconds", message: edgeProblem });
     if (config.sources.article === "generate" &&
         content.articleEdited === true &&
         !content.articleMarkdown?.trim())

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

@@ -1,11 +1,15 @@
-import { narrationPreparationFields, usesNarrationPreparation, } from "../admission/rules.js";
+import { narrationPreparationFields, usesNarrationPreparation, usesYoutubeDescription, youtubeDescriptionFields, } from "../admission/rules.js";
 import { detectSlots, render } from "../admission/substitute.js";
 export function validateRecipeInputs(config, content) {
-    const fields = [...narrationPreparationFields(config)];
+    const fields = [
+        ...narrationPreparationFields(config),
+        ...youtubeDescriptionFields(config),
+    ];
     const llm = (config.sources.research === "generate" && config.sources.article !== "provide") ||
         (config.sources.article === "generate" && !content.articleEdited) ||
         config.sources.thumbnail === "prompt_by_llm" ||
         usesNarrationPreparation(config) ||
+        usesYoutubeDescription(config) ||
         (config.sources.audio === "generate" &&
             (config.intro?.mode === "llm" || config.outro?.mode === "llm"));
     if (llm && (!config.llm?.provider.trim() || !config.llm.model.trim()))
@@ -43,6 +47,15 @@ export function validateRecipeInputs(config, content) {
             raw: content.promptTemplates.narration ?? null,
             literal: config.rendered.narration,
         });
+    // Only a picked Description prompt is checked: none picked uses the built-in one.
+    if (usesYoutubeDescription(config) &&
+        config.descriptionPrompt?.trim() &&
+        content.promptTemplates.description != null)
+        prompts.push({
+            field: "rendered.description",
+            raw: content.promptTemplates.description,
+            literal: config.rendered.description,
+        });
     if ((config.sources.article === "generate" && !content.articleEdited) ||
         (config.sources.research === "generate" && config.sources.article !== "provide"))
         prompts.push({

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

@@ -45,7 +45,16 @@ export function visualRecipes(config, content, audioFingerprint, captionFingerpr
                 recipes.map((value) => value.fingerprint),
                 audioFingerprint,
                 config.subtitles?.mode === "burn-in" ? captionFingerprint : null,
-                "slideshow-zoom-v1",
+                // Only here: how long a still is held and how it moves change the render,
+                // never an image.
+                config.imageSeconds,
+                config.zoomPercent,
+                // Left out for "zoom", which is what every video did before the setting
+                // existed, so a project that keeps it keeps its render; the other styles
+                // each render differently.
+                ...(config.motionStyle === "zoom" ? [] : [config.motionStyle]),
+                // v1 split the timeline evenly across the images; v2 cycles them.
+                "slideshow-zoom-v2",
             ],
         }, [
             ...recipes.map((value) => value.key),

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

@@ -177,6 +177,9 @@ function retainedFor(row, logical, manifest, available) {
         pieceIds: [],
     }));
 }
+// ceiling: the timed transcript of a 20-minute narration, about 3,000 words. The real one
+// is only built once the word timing lands.
+const youtubeTranscriptEstimate = 20000;
 export function priceRecipe(work, value) {
     if (value === undefined || work.disposition !== "generate")
         return {
@@ -214,6 +217,18 @@ export function priceRecipe(work, value) {
         };
     if (input.kind === "image")
         return { kind: "image", stage: work.key, provider: input.provider, model: input.model };
+    if (input.kind === "local" && input.operation === "youtube-description-v1") {
+        const [, provider, model, , prompt] = Array.isArray(input.values) ? input.values : [];
+        return {
+            kind: "llm",
+            stage: work.key,
+            provider: typeof provider === "string" ? provider : "",
+            model: typeof model === "string" ? model : "",
+            inputCharacters: (typeof prompt === "string" ? prompt.length : 0) + youtubeTranscriptEstimate,
+            outputCharacters: 2400,
+            detail: "The timed transcript is built when the step runs; its length is estimated. Retries are excluded.",
+        };
+    }
     return {
         kind: "tts-estimate",
         stage: work.key,