@gentbajko/slopify 2.4.0 → 3.0.0

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

@@ -0,0 +1,93 @@
+import { randomUUID } from "node:crypto";
+import { mkdirSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { stylePreviewSeconds } from "./schema.js";
+import { normalizeStylePreview, stylePreviewHash } from "./settings.js";
+// Rendered previews are kept in the data folder by the hash of their settings, so a setting
+// changed back, or the same style in another project, plays at once. `force` renders again
+// anyway. Requests for a preview already being rendered wait for that render instead of
+// starting a second one.
+export function stylePreviewDir(dataDir) {
+    return join(dataDir, "cache", "style-preview");
+}
+const hashPattern = /^[a-f0-9]{64}$/;
+export function createStylePreviews(deps) {
+    const inflight = new Map();
+    const pathOf = (hash) => join(deps.dir, `${hash}.mp4`);
+    const file = (hash) => {
+        if (!hashPattern.test(hash))
+            return undefined;
+        try {
+            const stats = statSync(pathOf(hash));
+            return stats.isFile() && stats.size > 0
+                ? { path: pathOf(hash), bytes: stats.size, version: Math.round(stats.mtimeMs) }
+                : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const run = async (hash, settings, picture) => {
+        mkdirSync(deps.dir, { recursive: true, mode: 0o700 });
+        const work = `${hash}.${randomUUID()}`;
+        const part = join(deps.dir, `${work}.part.mp4`);
+        // The picture is copied beside the render for its length only, so nothing but the
+        // finished previews is kept.
+        const still = picture === undefined ? undefined : join(deps.dir, `${work}.still${picture.extension}`);
+        try {
+            if (still !== undefined && picture !== undefined)
+                writeFileSync(still, picture.bytes, { mode: 0o600 });
+            await deps.render(settings, part, AbortSignal.timeout(deps.timeoutMs ?? 120_000), still);
+            renameSync(part, pathOf(hash));
+        }
+        finally {
+            rmSync(part, { force: true });
+            if (still !== undefined)
+                rmSync(still, { force: true });
+        }
+        prune(deps);
+        const saved = file(hash);
+        if (saved === undefined)
+            throw new Error("The style preview render finished without writing its video.");
+        return { hash, cached: false, seconds: stylePreviewSeconds, version: saved.version };
+    };
+    return {
+        file,
+        render: (request) => {
+            const picture = request.image === undefined ? undefined : deps.pictures?.(request.image);
+            const settings = normalizeStylePreview(request, picture?.sha256);
+            const hash = stylePreviewHash(settings);
+            const running = inflight.get(hash);
+            if (running !== undefined)
+                return running;
+            const saved = request.force === true ? undefined : file(hash);
+            if (saved !== undefined)
+                return Promise.resolve({
+                    hash,
+                    cached: true,
+                    seconds: stylePreviewSeconds,
+                    version: saved.version,
+                });
+            const started = run(hash, settings, picture).finally(() => {
+                inflight.delete(hash);
+            });
+            inflight.set(hash, started);
+            return started;
+        },
+    };
+}
+function prune(deps) {
+    try {
+        const kept = readdirSync(deps.dir)
+            .filter((name) => /^[a-f0-9]{64}\.mp4$/.test(name))
+            .map((name) => ({ name, at: statSync(join(deps.dir, name)).mtimeMs }))
+            .toSorted((left, right) => right.at - left.at);
+        for (const old of kept.slice(deps.keep ?? 200))
+            rmSync(join(deps.dir, old.name), { force: true });
+    }
+    catch (error) {
+        deps.log.write("warn", "style-preview.prune", {
+            detail: error instanceof Error ? error.message : String(error),
+        });
+    }
+}

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

@@ -0,0 +1,89 @@
+import { createHash } from "node:crypto";
+import { captionCues } from "../subtitles/captions.js";
+import { transitionSecondsMax, transitionSecondsMin, videoEditOf } from "../video/edit-settings.js";
+import { defaultPreviewText, stylePreviewSeconds } from "./schema.js";
+export function normalizeStylePreview(request, 
+// The sha256 of the picture the server found for request.image, if it found one.
+image) {
+    const edit = videoEditOf(request);
+    const { subtitles } = request;
+    const text = (request.previewText ?? "").replace(/\s+/g, " ").trim();
+    return {
+        version: 1,
+        format: request.format,
+        captions: subtitles.mode === "burn-in"
+            ? {
+                fontId: subtitles.fontId,
+                fontSize: Math.round(subtitles.fontSize),
+                position: subtitles.position,
+                text: text === "" ? defaultPreviewText : text,
+            }
+            : null,
+        look: {
+            vignette: edit.vignette,
+            grain: edit.grain,
+            grade: edit.grade,
+            atmosphere: edit.atmosphere,
+        },
+        transition: edit.transition === "cut"
+            ? null
+            : {
+                kind: edit.transition,
+                // Tenths, within the range the project editor offers.
+                seconds: Math.round(Math.min(transitionSecondsMax, Math.max(transitionSecondsMin, Number.isFinite(edit.transitionSeconds) ? edit.transitionSeconds : 0.6)) * 10) / 10,
+            },
+        chapterCard: edit.chapterCards ? { fontId: subtitles.fontId } : null,
+        ...(image === undefined ? {} : { image }),
+    };
+}
+// JSON with every object's keys in order, so equal settings always hash alike.
+export function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(",")}]`;
+    if (value !== null && typeof value === "object")
+        return `{${Object.entries(value)
+            .filter(([, one]) => one !== undefined)
+            .toSorted(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+            .map(([key, one]) => `${JSON.stringify(key)}:${stableJson(one)}`)
+            .join(",")}}`;
+    return JSON.stringify(value);
+}
+export function stylePreviewHash(settings) {
+    return createHash("sha256").update(stableJson(settings)).digest("hex");
+}
+// ceiling: three cues read comfortably in six seconds; a short text gets one per word.
+const cueCount = 3;
+// Longer than the 0.7 s pause `captionCues` starts a new cue at.
+const cueGap = 0.8;
+const lead = 0.4;
+// The sample text as timed words: split into up to three groups spread over the preview with
+// a pause between them, the words of each evenly spaced. `captionCues` then groups and wraps
+// them exactly as it does real narration.
+export function sampleWords(text, seconds = stylePreviewSeconds) {
+    const words = text.split(/\s+/).filter((word) => word !== "");
+    if (words.length === 0)
+        return [];
+    const groups = Math.min(cueCount, words.length);
+    const per = Math.ceil(words.length / groups);
+    const chunks = Array.from({ length: groups }, (_value, at) => words.slice(at * per, (at + 1) * per)).filter((chunk) => chunk.length > 0);
+    const span = (seconds - 2 * lead - cueGap * (chunks.length - 1)) / chunks.length;
+    const timed = [];
+    chunks.forEach((chunk, at) => {
+        const start = lead + at * (span + cueGap);
+        const each = span / chunk.length;
+        chunk.forEach((word, index) => {
+            timed.push({
+                text: word,
+                start: round(start + index * each),
+                end: round(start + (index + 1) * each),
+            });
+        });
+    });
+    return timed;
+}
+export function sampleCues(text, seconds = stylePreviewSeconds) {
+    return captionCues(sampleWords(text, seconds));
+}
+function round(value) {
+    return Math.round(value * 1000) / 1000;
+}

package/dist/slices/subtitles/captions.js

@@ -1,5 +1,7 @@
+import { assInlineColour } from "../voices/palette.js";
 import { subtitlePlacement } from "./layout.js";
-// Keep spoken spelling and punctuation. Word times come only from acoustic alignment.
+// Keep spoken spelling and punctuation. Word times come only from acoustic alignment. A cue
+// never holds two speakers' words.
 export function captionCues(words) {
     const cues = [];
     let pending = [];
@@ -12,6 +14,7 @@ export function captionCues(words) {
                 start: first.start,
                 end: last.end,
                 text: wrap(pending.map((word) => word.text)),
+                ...(first.speaker === undefined ? {} : { speaker: first.speaker }),
             });
         }
         pending = [];
@@ -21,11 +24,12 @@ export function captionCues(words) {
             !Number.isFinite(word.end) ||
             word.start < previousEnd - 0.001 ||
             word.end <= word.start) {
-            throw new Error("The saved caption timing is damaged. Use Re-run section on Video to time them again, then Retry stage.");
+            throw new Error("The saved caption timing is damaged. Use More → Render the video again in the Video section to time them again, then Try again.");
         }
         const first = pending[0];
         if (first !== undefined &&
             (word.start - previousEnd > 0.7 ||
+                word.speaker !== first.speaker ||
                 word.end - first.start > 5 ||
                 wrap([...pending.map((one) => one.text), word.text]).split("\n").length > 2)) {
             flush();
@@ -52,23 +56,44 @@ function wrap(words) {
         lines.push(line);
     return lines.join("\n");
 }
-export function serializeSrt(cues) {
+export function serializeSrt(cues, speakers) {
     return cues
-        .map((cue, index) => `${index + 1}\n${stamp(cue.start, ",")} --> ${stamp(cue.end, ",")}\n${markup(cue.text)}\n`)
+        .map((cue, index) => `${index + 1}\n${stamp(cue.start, ",")} --> ${stamp(cue.end, ",")}\n${markup(`${nameTag(cue, speakers)}${cue.text}`)}\n`)
         .join("\n");
 }
-export function serializeVtt(cues) {
-    return `WEBVTT\n\n${cues.map((cue) => `${stamp(cue.start, ".")} --> ${stamp(cue.end, ".")}\n${markup(cue.text)}\n`).join("\n")}`;
+// WebVTT names the speaker in its own voice span, which players can show or style.
+export function serializeVtt(cues, speakers) {
+    return `WEBVTT\n\n${cues.map((cue) => `${stamp(cue.start, ".")} --> ${stamp(cue.end, ".")}\n${voiceSpan(cue, speakers)}${markup(cue.text)}\n`).join("\n")}`;
+}
+function styleOf(cue, speakers) {
+    return cue.speaker === undefined ? undefined : speakers?.styles[cue.speaker];
+}
+function nameTag(cue, speakers) {
+    const style = styleOf(cue, speakers);
+    return style !== undefined && speakers?.nameTags === true ? `${style.name}: ` : "";
+}
+function voiceSpan(cue, speakers) {
+    const style = styleOf(cue, speakers);
+    return style === undefined ? "" : `<v ${style.name.replace(/[<>&]/g, "")}>`;
+}
+// The speaker's colour, and their name in bold ahead of the words when name tags are on.
+function speakerAss(cue, speakers) {
+    const style = styleOf(cue, speakers);
+    if (style === undefined)
+        return "";
+    const colour = `{\\1c${assInlineColour(style.colour)}}`;
+    return speakers?.nameTags === true ? `${colour}{\\b1}${assText(style.name)}:{\\b0} ` : colour;
 }
 export function serializeAss(cues, style) {
     const name = style.fontName.replace(/[\p{Cc},]/gu, " ").trim();
     const placement = subtitlePlacement(style.position ?? "bottom", style.height);
     const position = `{\\an${placement.alignment}\\pos(${style.width / 2},${placement.y})}`;
-    const header = `[Script Info]\nScriptType: v4.00+\nPlayResX: ${style.width}\nPlayResY: ${style.height}\nWrapStyle: 0\nScaledBorderAndShadow: yes\n\n[V4+ Styles]\nFormat: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding\nStyle: Default,${name},${style.fontSize},&H00FFFFFF,&H00FFFFFF,&H00101010,&H80000000,0,0,0,0,100,100,0,0,1,2.5,1,2,60,60,60,1\n\n[Events]\nFormat: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text\n`;
+    const header = `[Script Info]\nScriptType: v4.00+\nPlayResX: ${style.width}\nPlayResY: ${style.height}\nWrapStyle: 0\nScaledBorderAndShadow: yes\n\n[V4+ Styles]\nFormat: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding\nStyle: Default,${name},${style.fontSize},${assColour(style.color, "&H00FFFFFF")},${assColour(style.color, "&H00FFFFFF")},${assColour(style.outlineColor, "&H00101010")},&H80000000,0,0,0,0,100,100,0,0,1,2.5,1,2,60,60,60,1\n\n[Events]\nFormat: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text\n`;
     return (header +
         cues
-            .map((cue) => `Dialogue: 0,${assStamp(cue.start)},${assStamp(cue.end)},Default,,0,0,0,,${position}${assText(cue.text)}\n`)
-            .join(""));
+            .map((cue) => `Dialogue: 0,${assStamp(cue.start)},${assStamp(cue.end)},Default,,0,0,0,,${position}${speakerAss(cue, style.speakers)}${assText(cue.text)}\n`)
+            .join("") +
+        (style.overlay ?? []).map((line) => `${line}\n`).join(""));
 }
 function markup(text) {
     return text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
@@ -89,3 +114,11 @@ function assStamp(seconds) {
     const cs = Math.max(0, Math.round(seconds * 100));
     return `${Math.floor(cs / 360_000)}:${String(Math.floor(cs / 6000) % 60).padStart(2, "0")}:${String(Math.floor(cs / 100) % 60).padStart(2, "0")}.${String(cs % 100).padStart(2, "0")}`;
 }
+// ASS colours are &HAABBGGRR, alpha 00 being opaque.
+export function assColour(hex, fallback) {
+    const match = hex === undefined ? null : /^#([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})$/.exec(hex);
+    if (match === null)
+        return fallback;
+    const [, r, g, b] = match;
+    return `&H00${(b ?? "").toUpperCase()}${(g ?? "").toUpperCase()}${(r ?? "").toUpperCase()}`;
+}

package/dist/slices/subtitles/model.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { languageInfo } from "../../kernel/ports/languages.js";
 export const subtitleModes = ["off", "files", "burn-in"];
 export const subtitlePositions = [
     "top",
@@ -17,6 +18,16 @@ export const subtitleConfigSchema = z.object({
         .default("default"),
     position: z.enum(subtitlePositions).default("bottom"),
     fontSize: z.number().int().min(16).max(120).default(48),
+    // #RRGGBB, from the channel's brand kit. Absent is white text with a dark outline, as
+    // every caption before them.
+    color: z
+        .string()
+        .regex(/^#[0-9A-Fa-f]{6}$/)
+        .optional(),
+    outlineColor: z
+        .string()
+        .regex(/^#[0-9A-Fa-f]{6}$/)
+        .optional(),
 });
 export const defaultSubtitles = {
     mode: "off",
@@ -25,3 +36,14 @@ export const defaultSubtitles = {
     fontSize: 48,
     position: "bottom",
 };
+// The word-timing operation of a project language, which is part of the timing's fingerprint:
+// English keeps the operation it always had, so no English project is re-timed; the other
+// languages each name the model (or the sentence fallback) that times them.
+export const timingOperations = {
+    english: "wav2vec2-en-a19f851-v2-omissions",
+    multilingual: "wav2vec2-xlsr56-2d48b01-v1",
+    sentences: "sentence-timing-v1",
+};
+export function timingOperation(language) {
+    return timingOperations[languageInfo(language).timing];
+}

package/dist/slices/subtitles/prepare.js

@@ -3,13 +3,15 @@ import { copyFileSync, createReadStream, existsSync, mkdirSync, mkdtempSync, rea
 import { join, relative, sep } from "node:path";
 import { z } from "zod";
 import { subtitleModelDir } from "../../kernel/paths.js";
+import { projectLanguage } from "../../kernel/ports/languages.js";
 import { projectById, setStageProgress } from "../admission/repo.js";
+import { captionFont, captionFontDeps } from "../fonts/coverage.js";
 import { resolveFont } from "../fonts/index.js";
 import { outputPath, projectDir } from "../storage/layout.js";
 import { outputsOf } from "../storage/repo.js";
 import { spoken } from "../video/plan.js";
 import { captionCues, serializeAss, serializeSrt, serializeVtt } from "./captions.js";
-import { defaultSubtitles } from "./model.js";
+import { defaultSubtitles, timingOperation } from "./model.js";
 import { spokenText } from "./transcript.js";
 export const subtitleRoles = [
     "subtitles_srt",
@@ -52,24 +54,27 @@ export async function prepareSubtitles(deps, context, audio, frame) {
     setStageProgress(deps.db, context.stage.id, 0, 100);
     context.emit({ type: "stage.progress", projectId, stage: "video", current: 0, total: 100 });
     if (audio.length === 0)
-        throw new Error("Captions need narration audio, but this project has none. Turn captions off in Edit project → Subtitles, or turn narration on, then Retry stage.");
+        throw new Error("Captions need narration audio, but this project has none. Turn captions off in Edit project → Subtitles, or turn narration on, then Try again.");
     const outputs = outputsOf(deps.db, projectId);
     const segments = audio.map((segment) => ({
         ...segment,
         text: spoken(segment.kind) ? spokenText(deps, projectId, segment.kind, outputs) : "",
     }));
-    const key = await timingKey(segments, context.signal);
+    const language = projectLanguage(project.config);
+    const key = await timingKey(segments, language, context.signal);
     const cache = readCache(deps, projectId, outputs);
     const dir = projectDir(deps.paths, projectId);
     const directory = mkdtempSync(join(dir, "captions-"));
     try {
-        const font = await snapshotFont(deps, projectId, outputs, config.fontId, cache, directory);
+        const font = await snapshotFont(deps, projectId, outputs, config.fontId, cache, directory, language);
         const omissions = cache?.key === key ? [...cache.omissions] : [];
-        const words = cache?.key === key ? cache.words : await alignSegments(deps, context, segments, omissions);
+        const words = cache?.key === key
+            ? cache.words
+            : await alignSegments(deps, context, segments, omissions, language);
         context.signal.throwIfAborted();
         const cues = captionCues(words);
         if (cues.length === 0)
-            throw new Error("None of the narration could be matched to the article text, so captions can't be timed. Captions only work for English narration; if you uploaded your own audio, make sure it reads the article text, then Retry stage.");
+            throw new Error("None of the narration could be matched to the article text, so captions can't be timed. The narration must be in the project language set in Edit project → Language; if you uploaded your own audio, make sure it reads the article text, then Try again.");
         writeFileSync(join(directory, "subtitles.srt"), serializeSrt(cues), { mode: 0o600 });
         writeFileSync(join(directory, "subtitles.vtt"), serializeVtt(cues), { mode: 0o600 });
         writeFileSync(join(directory, "subtitles.ass"), serializeAss(cues, {
@@ -77,6 +82,8 @@ export async function prepareSubtitles(deps, context, audio, frame) {
             fontSize: config.fontSize,
             fontName: font.assName,
             position: config.position,
+            color: config.color,
+            outlineColor: config.outlineColor,
         }), { mode: 0o600 });
         writeFileSync(join(directory, "subtitles.json"), JSON.stringify({ key, words, font, omissions }), {
             mode: 0o600,
@@ -103,9 +110,10 @@ export async function prepareSubtitles(deps, context, audio, frame) {
         throw error;
     }
 }
-async function timingKey(segments, signal) {
+async function timingKey(segments, language, signal) {
     // Bump when alignment normalization/model changes. Hash file contents, not timestamps.
-    const hash = createHash("sha256").update("wav2vec2-en-a19f851-v2-omissions");
+    // English hashes the operation it always did (`timingOperation`).
+    const hash = createHash("sha256").update(timingOperation(language));
     for (const segment of segments) {
         signal.throwIfAborted();
         hash.update(JSON.stringify({ kind: segment.kind, seconds: segment.seconds, text: segment.text }));
@@ -117,9 +125,9 @@ async function timingKey(segments, signal) {
     }
     return hash.digest("hex");
 }
-async function alignSegments(deps, context, segments, omissions) {
+async function alignSegments(deps, context, segments, omissions, language) {
     if (deps.alignSubtitles === undefined)
-        throw new Error("Slopify hit an internal error (the caption timing tool is missing from this build). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error("Slopify hit an internal error (the caption timing tool is missing from this build). Try again; if it happens again, use Download diagnostics in Settings and report it.");
     const words = [];
     const total = segments.reduce((sum, segment) => sum + segment.seconds, 0);
     let offset = 0;
@@ -130,7 +138,8 @@ async function alignSegments(deps, context, segments, omissions) {
                 audioPath: segment.path,
                 onOmission: (omission) => omissions.push({ ...omission, start: omission.start + offset }),
                 text: segment.text,
-                cacheDir: subtitleModelDir(deps.paths.dataDir),
+                cacheDir: subtitleModelDir(deps.paths.dataDir, language),
+                ...(language === "en" ? {} : { language }),
                 ffmpeg: deps.ffmpeg,
                 signal: context.signal,
                 onProgress: (current, maximum) => {
@@ -147,7 +156,7 @@ async function alignSegments(deps, context, segments, omissions) {
             });
             for (const word of aligned) {
                 if (word.end > segment.seconds + 0.1)
-                    throw new Error("Caption timing came out longer than the narration audio. Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+                    throw new Error("Caption timing came out longer than the narration audio. Try again; if it happens again, use Download diagnostics in Settings and report it.");
                 words.push({
                     ...word,
                     start: word.start + offset,
@@ -170,12 +179,14 @@ function readCache(deps, projectId, outputs) {
         return undefined;
     }
 }
-async function snapshotFont(deps, projectId, outputs, id, cache, directory) {
+async function snapshotFont(deps, projectId, outputs, id, cache, directory, language) {
     const previous = outputs.find((one) => one.role === "subtitle_font");
     const previousPath = previous === undefined ? undefined : outputPath(deps.paths, projectId, previous.path);
-    const saved = cache?.font.id === id && previousPath !== undefined && existsSync(previousPath)
-        ? { ...cache.font, path: previousPath }
-        : await resolveFont(deps.paths, id);
+    const saved = language !== "en"
+        ? await captionFont(captionFontDeps(deps.paths), id, language)
+        : cache?.font.id === id && previousPath !== undefined && existsSync(previousPath)
+            ? { ...cache.font, path: previousPath }
+            : await resolveFont(deps.paths, id);
     mkdirSync(join(directory, "fonts"), { mode: 0o700 });
     copyFileSync(saved.path, join(directory, "fonts", `selected${saved.extension}`));
     return { id: saved.id, name: saved.name, assName: saved.assName, extension: saved.extension };

package/dist/slices/subtitles/transcript.js

@@ -27,7 +27,7 @@ export function spokenText(deps, projectId, kind, outputs) {
                 return segment.text;
         }
     }
-    throw new Error(`The saved text of the ${kind === "body" ? "article" : kind} is missing, and captions need the text spoken in the narration. Use Re-run section on Article, then Retry stage.`);
+    throw new Error(`The saved text of the ${kind === "body" ? "article" : kind} is missing, and captions need the text spoken in the narration. Use More → Write the article again in the Article section, then Try again.`);
 }
 function payload(raw) {
     return textPayload.parse(JSON.parse(raw ?? "null"));

package/dist/slices/thumbnail/run.js

@@ -22,13 +22,13 @@ export async function runThumbnail(deps, context, providers) {
     if (source !== "from_prompt" && source !== "prompt_by_llm") {
         // Off is `skipped` and Provide is `provided` at project creation,
         // so the runner never starts this stage for either.
-        throw new Error(`Slopify hit an internal error (the thumbnail stage cannot run with its source set to ${source}). Retry stage; if it happens again, use Download diagnostics in Settings and report it.`);
+        throw new Error(`Slopify hit an internal error (the thumbnail stage cannot run with its source set to ${source}). Try again; if it happens again, use Download diagnostics in Settings and report it.`);
     }
     const choice = project.config.images;
     if (choice === undefined) {
         // Admission requires the image provider whenever the thumbnail is generated, so reaching
         // here is a bug in admission rather than the user's.
-        throw new Error("No image model is set for the thumbnail. Choose one in Edit project → Providers, then Retry stage.");
+        throw new Error("No image model is set for the thumbnail. Choose one in Edit project → Providers, then Try again.");
     }
     const result = source === "from_prompt" ? undefined : await byLlm(deps, context, providers, project);
     if (result !== undefined && !result.ok)
@@ -60,7 +60,7 @@ export async function runThumbnail(deps, context, providers) {
 function fromTemplate(project) {
     const rendered = project.config.rendered.thumbnailPrompt;
     if (rendered === undefined) {
-        throw new Error("Slopify hit an internal error (the thumbnail prompt was never filled in). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error("Slopify hit an internal error (the thumbnail prompt was never filled in). Try again; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return rendered;
 }
@@ -83,7 +83,7 @@ async function byLlm(deps, context, providers, project) {
     }
     if (llm === undefined) {
         // Admission requires the LLM row when the thumbnail source is Prompt by LLM.
-        throw new Error("No AI model is set for writing the thumbnail prompt. Choose one in Edit project → Providers, then Retry stage.");
+        throw new Error("No AI model is set for writing the thumbnail prompt. Choose one in Edit project → Providers, then Try again.");
     }
     const messages = thumbnailMessages(brief(deps, project));
     const answer = await providers.llm({
@@ -117,7 +117,7 @@ function named(choice) {
 function brief(deps, project) {
     const instruction = project.config.rendered.thumbnailPrompt;
     if (instruction === undefined) {
-        throw new Error("Slopify hit an internal error (the thumbnail prompt was never filled in). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error("Slopify hit an internal error (the thumbnail prompt was never filled in). Try again; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return {
         instruction,
@@ -133,7 +133,7 @@ function brief(deps, project) {
 function articleText(deps, projectId) {
     const article = outputsOf(deps.db, projectId).find((output) => output.role === "article_txt");
     if (article === undefined) {
-        throw new Error("The thumbnail prompt is written from the article, but the article isn't ready. Let the Article stage finish, then Retry stage.");
+        throw new Error("The thumbnail prompt is written from the article, but the article isn't ready. Let the Article stage finish, then Try again.");
     }
     return readFileSync(outputPath(deps.paths, projectId, article.path), "utf8");
 }
@@ -212,7 +212,7 @@ function instructionsText(messages) {
 }
 function payloadOf(piece) {
     if (piece.payload === null) {
-        throw new Error("Slopify hit an internal error (the saved thumbnail prompt is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error("Slopify hit an internal error (the saved thumbnail prompt is empty). Try again; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return writtenPayload.parse(JSON.parse(piece.payload));
 }

package/dist/slices/trash/model.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+// Settings → Trash. Deleting a project, a Library prompt or intro/outro, a template or a
+// schedule stamps it instead of removing it; it stays here this long, then the daily purge
+// removes it for good (a project's folder with it).
+export const trashDays = 30;
+export const trashMs = trashDays * 24 * 60 * 60_000;
+export const trashKinds = ["project", "prompt", "entry", "template", "schedule"];
+export const trashItemSchema = z.object({
+    kind: z.enum(trashKinds),
+    id: z.string(),
+    name: z.string(),
+    // What sort of prompt ("article", "image"…) or entry ("intro", "outro"); null otherwise.
+    detail: z.string().nullable(),
+    deletedAt: z.string(),
+    // When the daily purge removes it for good.
+    purgeAt: z.string(),
+    daysLeft: z.number().int().nonnegative(),
+});
+export const restoredSchema = z.object({
+    kind: z.enum(trashKinds),
+    id: z.string(),
+    name: z.string(),
+    // The name it came back under when a live item had taken the old one meanwhile.
+    renamedFrom: z.string().nullable(),
+});