@gentbajko/slopify 2.0.2 → 2.1.0

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`;
@@ -58,7 +61,7 @@ function body(db, kind, name, field, missing, into, key, snapshot) {
     }
     const prompt = snapshotPrompt(db, snapshot, kind, name);
     if (prompt === undefined) {
-        missing.push({ field, message: `That ${kind} prompt no longer exists; pick another.` });
+        missing.push({ field, message: `That ${kind} prompt was deleted. Choose another.` });
         return;
     }
     into.push({ key, body: prompt.body });
@@ -71,7 +74,7 @@ function pickEntry(db, category, choice, missing, snapshot) {
     if (entry === undefined) {
         missing.push({
             field: category,
-            message: `That ${category} entry no longer exists; pick another.`,
+            message: `That ${category} entry was deleted. Choose another.`,
         });
     }
     return entry;

package/dist/slices/narration/concat.js

@@ -46,7 +46,7 @@ export async function joinNarration(deps, input) {
     const first = input.files[0];
     if (first === undefined) {
         // The stage refuses an empty narration before it gets here, so this is a bug.
-        throw new Error("there are no audio chunks to join");
+        throw new Error("Slopify hit an internal error (there is no narration audio to join). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     mkdirSync(dirname(input.output), { recursive: true, mode: 0o700 });
     if (input.files.length === 1) {

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

@@ -18,7 +18,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
     const chunks = chunkNarration(source, chunking).map((text) => {
         const start = source.indexOf(text, offset);
         if (start < 0)
-            throw new Error("Narration chunk is missing from its source.");
+            throw new Error("Slopify hit an internal error (a narration chunk isn't in the article text). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         offset = start + text.length;
         return { key: nextKey(text), text, start, end: offset };
     });
@@ -78,7 +78,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
         }
         const chunk = chunks[index];
         if (chunk === undefined)
-            throw new Error("Narration chunk disappeared.");
+            throw new Error("Slopify hit an internal error (a narration chunk went missing). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         while ((matches[matchIndex]?.end ?? Infinity) <= chunk.end)
             matchIndex++;
         const match = matches[matchIndex];
@@ -90,7 +90,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
             continue;
         const first = chunks[from];
         if (first === undefined)
-            throw new Error("Narration group has no first chunk.");
+            throw new Error("Slopify hit an internal error (a group of narration chunks is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         const text = source.slice(first.start, chunk.end);
         result.push(from === index
             ? { key: chunk.key, text }

package/dist/slices/narration/pronunciation.js

@@ -105,7 +105,7 @@ export function pronunciationMatches(source, entries) {
             continue;
         const entry = ordered.find((_, index) => match[index + 1] !== undefined);
         if (entry === undefined)
-            throw new Error("Matched glossary term has no mapping.");
+            throw new Error("Slopify hit an internal error (a pronunciation glossary term has no pronunciation). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         matches.push({ start: match.index, end, entry });
     }
     return matches;
@@ -117,7 +117,7 @@ export function pronunciationSpans(source, entries) {
         for (const [index, word] of Array.from(words).entries()) {
             const ipa = match.entry.ipa[index];
             if (ipa === undefined)
-                throw new Error("Validated glossary term has no IPA word.");
+                throw new Error("Slopify hit an internal error (a pronunciation glossary term is missing a word). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
             const start = match.start + word.index;
             spans.push({ start, end: start + word[0].length, text: `/${ipa}/` });
         }

package/dist/slices/narration/run.js

@@ -14,7 +14,7 @@ import { planLegacyNarration } from "./legacy-plan.js";
 import { observeNarration } from "./live.js";
 // An empty narration source fails the stage immediately with no retries. Thrown from the
 // slice rather than from a provider call, so the attempt wrapper never sees it.
-export const nothingToNarrate = "nothing to narrate";
+export const nothingToNarrate = "There is nothing to narrate because the article is empty. Add article text in Edit project → Article, then Retry stage.";
 // What a chunk piece carries between runs: the text that was sent, and the file it came
 // back as once the provider answered. That is the whole of the resume.
 const chunkPayload = z.object({ text: z.string(), file: z.string().optional() });
@@ -35,13 +35,13 @@ export async function runNarration(deps, context, providers) {
     deps.audioPreviews?.clear(projectId);
     const project = projectById(deps.db, projectId);
     if (project === undefined) {
-        throw new Error(`project ${projectId} has no row`);
+        throw new Error("This project no longer exists; it may have been deleted while it was running.");
     }
     const choice = project.config.audio;
     if (choice === undefined) {
         // Admission refuses a run whose audio is Generate without a provider and a voice, so
         // reaching here is a bug in admission rather than something the user did.
-        throw new Error("the run has no TTS provider or voice");
+        throw new Error("No voice is set for the narration. Choose a voice in Edit project → Providers, then Retry stage.");
     }
     // Read once, before anything is written: the segment steps below ask it what a previous
     // run already stored, and the body step is the only thing that adds to it.
@@ -168,7 +168,7 @@ async function speakSegments(deps, context, providers, choice, outputs) {
         if (text === "") {
             // The same rule, applied to a segment: there is nothing to say, and silently
             // dropping an intro the user picked would lose it without telling anyone.
-            throw new Error(`the ${segment.category} segment has ${nothingToNarrate}`);
+            throw new Error(`The ${segment.category} is empty, so there is nothing to narrate for it. Write the ${segment.category} or remove it in Edit project, then Retry stage.`);
         }
         const spoken = await providers.forPiece(piece.id).tts({
             provider: choice.provider,
@@ -200,7 +200,7 @@ function segmentPieces(deps, projectId) {
     if (article === undefined) {
         // Admission writes all six stage rows with the project, so a project without an article
         // stage is a bug rather than a run the user configured.
-        throw new Error(`project ${projectId} has no article stage`);
+        throw new Error("Slopify hit an internal error (the project has no article stage). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return piecesOf(deps.db, article.id, "segment");
 }
@@ -257,13 +257,13 @@ function store(deps, projectId, role, path, durationMs, choice) {
 }
 function chunkOf(piece) {
     if (piece.payload === null) {
-        throw new Error(`chunk ${piece.id} has no payload`);
+        throw new Error("Slopify hit an internal error (a saved narration chunk is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return chunkPayload.parse(JSON.parse(piece.payload));
 }
 function segmentOf(piece) {
     if (piece.payload === null) {
-        throw new Error(`segment ${piece.id} has no payload`);
+        throw new Error("Slopify hit an internal error (a saved intro or outro is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return segmentPayload.parse(JSON.parse(piece.payload));
 }

package/dist/slices/narration/steering.js

@@ -9,14 +9,14 @@ function atoms(source, from, to, spans) {
         const span = spans.get(at);
         if (span !== undefined) {
             if (span.end > to || span.end <= at)
-                throw new Error("Pronunciation span crosses a word.");
+                throw new Error("Slopify hit an internal error (a pronunciation fix spans more than one word). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
             result.push({ text: span.text, spokenText: source.slice(at, span.end) });
             at = span.end;
         }
         else {
             const point = source.codePointAt(at);
             if (point === undefined)
-                throw new Error("Narration offset is outside the source.");
+                throw new Error("Slopify hit an internal error (a narration position is outside the article text). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
             const text = String.fromCodePoint(point);
             result.push({ text, spokenText: text });
             at += text.length;
@@ -34,7 +34,7 @@ function checkedSpans(source, pronunciation) {
             span.end <= span.start ||
             span.end > source.length ||
             !/^[^\s\uD800-\uDFFF]+$/u.test(source.slice(span.start, span.end)))
-            throw new Error("Pronunciation spans must cover disjoint whole source characters in a word.");
+            throw new Error("Slopify hit an internal error (pronunciation fixes overlap or split a word). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         spans.set(span.start, span);
         end = span.end;
     }

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 === "")
@@ -31,7 +44,7 @@ export function toAdmissionDraft(input) {
             return { name: saved.name, mode: saved.mode };
         fields.push({
             field: category,
-            message: `That ${category} entry no longer exists; pick another.`,
+            message: `That ${category} entry was deleted. Choose another.`,
         });
         return undefined;
     };
@@ -42,8 +55,8 @@ export function toAdmissionDraft(input) {
         fields.push({
             field,
             message: attachment?.state === "copying" || attachment?.state === "pending"
-                ? "This upload is still copying."
-                : "That upload is no longer available; pick the file again.",
+                ? "This file is still uploading. Wait for it to finish."
+                : "That upload is no longer available. Choose the file again.",
         });
         return undefined;
     };
@@ -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,12 +135,19 @@ 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)
         fields.push(...parsed.error.issues.map((issue) => ({
             field: issue.path.join("."),
-            message: issue.message,
+            // The schema carries no sentences of its own; its defaults read like code.
+            message: "This setting is not valid. Reload the page and choose it again.",
         })));
     return fields.length || !parsed.success
         ? { ok: false, fields }

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",
@@ -48,7 +49,7 @@ export async function checkDraftReadiness(deps, runs) {
                 field: c.field,
                 message: provider?.readiness.kind === "cli" && provider.readiness.issue
                     ? provider.readiness.issue
-                    : "Configure this provider before starting.",
+                    : "Set up this provider in Settings → Providers before starting.",
             });
             continue;
         }
@@ -56,12 +57,12 @@ export async function checkDraftReadiness(deps, runs) {
         if (result === "missing")
             fields.push({
                 field: `${c.field}.model`,
-                message: "Choose an available model before starting.",
+                message: "This model is no longer available. Choose another model.",
             });
         else if (result === "thinking")
             fields.push({
                 field: `${c.field}.thinking`,
-                message: "Choose a supported thinking setting.",
+                message: "This model does not support that thinking setting. Choose another.",
             });
     }
     return { fields: [...fields, ...localDraftReadiness(deps, runs, providers)], providers };
@@ -73,15 +74,21 @@ export function localDraftReadiness(deps, runs, providers) {
         if (cliPathChanged(deps.db, provider))
             fields.push({
                 field: `${c.field}.cliPath`,
-                message: "The configured CLI command changed. Check readiness again.",
+                message: "This provider's command-line tool changed in Settings → Providers. Choose Review and start again.",
             });
         if (provider?.readiness.kind === "keyed" && !hasKey(deps.db, provider.id))
-            fields.push({ field: c.field, message: "Save the provider key before starting." });
+            fields.push({
+                field: c.field,
+                message: "Add this provider's API key in Settings → Providers before starting.",
+            });
     }
     for (const { draft } of runs)
         if (draft.sources.audio === "generate" &&
             draft.audio &&
             !listVoices(deps.db).some((v) => v.provider === draft.audio?.provider && v.voiceId === draft.audio.voice))
-            fields.push({ field: "audio.voice", message: "Choose a saved voice before starting." });
+            fields.push({
+                field: "audio.voice",
+                message: "Choose one of your saved voices. Add voices in Settings → Voices.",
+            });
     return fields;
 }

package/dist/slices/play-drafts/review-inputs.js

@@ -47,7 +47,10 @@ export function resolveReviewInputs(deps, view, font) {
     if (!words.success)
         fields.push({ field: "expectedWords", message: "Enter a whole number between 1 and 100000." });
     if (document.variants.length > 49)
-        fields.push({ field: "variants", message: "Review at most 50 runs including the base run." });
+        fields.push({
+            field: "variants",
+            message: "You can review at most 50 videos at once, counting the first one. Remove some variations.",
+        });
     const converted = toAdmissionDraft({
         document,
         attachments: fresh.value.attachments,
@@ -96,7 +99,7 @@ export function resolveReviewInputs(deps, view, font) {
             field: index > 0 && (issue.field === "title" || issue.field.startsWith("values."))
                 ? `variants.${index - 1}.${issue.field}`
                 : issue.field,
-            message: `${index > 0 ? `Run ${index + 1}: ` : ""}${issue.message}`,
+            message: `${index > 0 ? `Video ${index + 1}: ` : ""}${issue.message}`,
         })));
         runs.push({
             draft: accepted,
@@ -118,7 +121,7 @@ export function resolveReviewInputs(deps, view, font) {
         if (!stat?.isFile() || font.id !== converted.draft.subtitles?.fontId)
             fields.push({
                 field: "subtitles.fontId",
-                message: "The selected font is no longer available. Choose another font.",
+                message: "This font was deleted. Choose another font.",
             });
         else
             fontHash = createHash("sha256").update(readFileSync(font.path)).digest("hex");
@@ -133,7 +136,7 @@ export function resolveReviewInputs(deps, view, font) {
                 : run.draft.sources[stage] !== "generate")
                 fields.push({
                     field: `checkpoints.${stage}`,
-                    message: "Choose a checkpoint only before an enabled generated stage or export.",
+                    message: "Checkpoints can only go before a step Slopify generates, or before export. Remove this checkpoint or turn that step on.",
                 });
     if (fields.length)
         return reviewRefusal(view, fields);

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

@@ -27,7 +27,7 @@ export async function resolvePlayReview(deps, view) {
             return reviewRefusal(view, [
                 {
                     field: "subtitles.fontId",
-                    message: "The selected font is no longer available. Choose another font.",
+                    message: "This font was deleted. Choose another font.",
                 },
             ]);
         }
@@ -41,12 +41,12 @@ export async function resolvePlayReview(deps, view) {
         if (result === "missing")
             fields.push({
                 field: `${choice.field}.model`,
-                message: "Choose an available model before reviewing.",
+                message: "This model is no longer available. Choose another model.",
             });
         else if (result === "thinking")
             fields.push({
                 field: `${choice.field}.thinking`,
-                message: "Choose a supported thinking setting.",
+                message: "This model does not support that thinking setting. Choose another.",
             });
     }
     if (fields.length)

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/play-drafts/service.js

@@ -68,7 +68,9 @@ function attachmentsOf(deps, id) {
             state,
             stagedFileId: invalid ? null : row.staged_file_id,
             bytes: invalid ? 0 : (staged?.bytes ?? 0),
-            error: invalid ? "Upload is missing or incomplete. Reattach the file." : row.error,
+            error: invalid
+                ? "This file is missing or did not finish uploading. Attach it again."
+                : row.error,
         };
     });
 }

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

@@ -43,7 +43,7 @@ export async function uploadDraftAttachment(deps, input) {
     if (!result.ok) {
         deps.db
             .prepare("UPDATE play_draft_attachments SET status='reattach',error=? WHERE id=? AND draft_id=? AND staged_file_id IS NULL")
-            .run("Upload failed. Reattach the file.", input.attachmentId, input.draftId);
+            .run("The upload failed. Attach the file again.", input.attachmentId, input.draftId);
         return refuse("invalid-edit");
     }
     const updated = deps.db

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/admission-repo.js

@@ -92,14 +92,14 @@ export function admitPreview(deps, input) {
                 continue;
             }
             if (existing?.state === "running")
-                throw new Error("Selected work has a mismatched running reservation.");
+                throw new Error("Slopify hit an internal error (a step is already running for a different version of the project). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             deps.db
                 .prepare("DELETE FROM revision_work_reservations WHERE revision_id=? AND work_key=?")
                 .run(view.revision.id, recipe.key);
             const key = reservationKey(recipe, view);
             const fingerprint = snapshot.anchors[key];
             if (fingerprint === undefined)
-                throw new Error("Selected work has no reviewed desired anchor.");
+                throw new Error("Slopify hit an internal error (a step has no saved starting point). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             const work = insertInvocation(deps, view, recipe, catalogue, { key, fingerprint }, false, view.revision.id, admissionId);
             workIds.push(work.workId);
         }

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)),
     ];
 }