@gentbajko/slopify 2.1.1 → 2.3.0

package/dist/assets/document/SOURCE.txt

@@ -1,7 +1,11 @@
 background.jpg
-The parchment page texture of the DiceMaster document theme, from the lore2script2 PDF
+The parchment page texture any document theme can use as its background, from the lore2script2 PDF
 generator (same owner).
 SHA-256: 18f9701b476f299e942cbb99c05ba3267d8341df2b6136e3aebbafad83b03b31
 
 fonts/
 Cinzel, SIL Open Font License 1.1: see fonts/SOURCE.txt and fonts/OFL.txt.
+
+sample-cover.jpg
+A plain gradient made with ImageMagick for the Library theme preview, standing in for a project's
+thumbnail. No third-party content.

package/dist/edge/http/app.js

@@ -6,6 +6,7 @@ import { actionRoutes } from "./actions.js";
 import { audioPreviewRoutes } from "./audio-preview.js";
 import { checkpointRoutes } from "./checkpoints.js";
 import { diagnosticsRoutes } from "./diagnostics.js";
+import { documentThemeRoutes } from "./document-themes.js";
 import { draftRoutes } from "./drafts.js";
 import { entryRoutes } from "./entries.js";
 import { fileRoutes } from "./files.js";
@@ -16,6 +17,7 @@ import { problem, problemFromError, titleOf } from "./problem.js";
 import { projectTemplateRoutes } from "./project-templates.js";
 import { projectRoutes } from "./projects.js";
 import { promptRoutes } from "./prompts.js";
+import { pronunciationRoutes } from "./pronunciations.js";
 import { providerRoutes } from "./providers.js";
 import { revisionFileRoutes, revisionFolderRoutes } from "./revision-files.js";
 import { revisionRoutes } from "./revisions.js";
@@ -58,6 +60,8 @@ function apiRoutes(deps, startedAt) {
         .route("/fonts", fontsRoutes(deps))
         .route("/prompts", promptRoutes(deps))
         .route("/entries", entryRoutes(deps))
+        .route("/document-themes", documentThemeRoutes(deps))
+        .route("/pronunciations", pronunciationRoutes(deps))
         .route("/telemetry", telemetryRoutes(deps))
         .route("/usage", usageRoutes(deps))
         .route("/settings", settingsRoutes(deps))

package/dist/edge/http/document-themes.js

@@ -0,0 +1,80 @@
+import { zValidator } from "@hono/zod-validator";
+import { Hono } from "hono";
+import { z } from "zod";
+import { createDocumentTheme, listDocumentThemes, removeDocumentTheme, updateDocumentTheme, } from "../../slices/document/library.js";
+import { documentThemeLabels, documentThemes } from "../../slices/document/model.js";
+import { renderSampleDocument } from "../../slices/document/sample.js";
+import { builtInTheme, resolveTheme } from "../../slices/document/theme.js";
+import { documentThemeSchema } from "../../slices/document/theme-schema.js";
+import { onInvalid, problem, titleOf } from "./problem.js";
+const idParam = z.object({
+    id: z
+        .string()
+        .min(1)
+        .max(64)
+        .regex(/^[0-9A-Za-z_-]+$/),
+});
+// Shape only: the values' ranges are the slice's, so the editor gets field-by-field sentences.
+const themeBody = z.object({ name: z.string(), values: z.unknown() });
+// Library → Documents. The return type is inferred so Hono keeps the route types the SPA's
+// client is generated from; see stagingRoutes.
+export function documentThemeRoutes(deps) {
+    const library = { db: deps.db, ids: deps.ids, clock: deps.clock };
+    return (new Hono()
+        // The built-ins come with their values, so Duplicate starts from them.
+        .get("/", (c) => c.json({
+        builtIns: documentThemes.map((name) => ({
+            name,
+            label: documentThemeLabels[name],
+            values: builtInTheme(name),
+        })),
+        themes: listDocumentThemes(deps.db),
+    }))
+        .post("/", zValidator("json", themeBody, onInvalid), (c) => {
+        const result = createDocumentTheme(library, c.req.valid("json"));
+        return result.ok ? c.json(result.value, 201) : refused(c, result);
+    })
+        .put("/:id", zValidator("param", idParam, onInvalid), zValidator("json", themeBody, onInvalid), (c) => {
+        const result = updateDocumentTheme(library, c.req.valid("param").id, c.req.valid("json"));
+        return result.ok ? c.json(result.value) : refused(c, result);
+    })
+        // A project keeps its own copy of a theme's values, so nothing cascades.
+        .delete("/:id", zValidator("param", idParam, onInvalid), (c) => {
+        const result = removeDocumentTheme(library, c.req.valid("param").id);
+        return result.ok ? c.body(null, 204) : refused(c, result);
+    })
+        // The editor's live preview: the sample article laid out with unsaved values.
+        .post("/preview", zValidator("json", z.object({ values: documentThemeSchema }), onInvalid), (c) => {
+        const rendered = renderSampleDocument(resolveTheme(c.req.valid("json").values));
+        return c.body(rendered.bytes.slice().buffer, 200, {
+            "Content-Type": "application/pdf",
+            "Cache-Control": "no-store",
+        });
+    }));
+}
+function refused(c, failure) {
+    switch (failure.reason) {
+        case "invalid":
+            return problem(c, {
+                status: 400,
+                title: titleOf(400),
+                detail: "This theme can't be saved yet. Fix the highlighted settings and try again.",
+                extensions: { fields: failure.fields },
+            });
+        case "duplicate-name": {
+            const message = "Another document theme already has this name. Choose a different name.";
+            return problem(c, {
+                status: 409,
+                title: titleOf(409),
+                detail: message,
+                extensions: { fields: [{ field: "name", message }] },
+            });
+        }
+        case "not-found":
+            return problem(c, {
+                status: 404,
+                title: titleOf(404),
+                detail: "This document theme no longer exists; it may have been deleted in another tab. Go back to Library → Documents.",
+            });
+    }
+}

package/dist/edge/http/pronunciations.js

@@ -0,0 +1,17 @@
+import { zValidator } from "@hono/zod-validator";
+import { Hono } from "hono";
+import { z } from "zod";
+import { collectSharedGlossary } from "../../slices/narration/shared-glossary.js";
+import { onInvalid } from "./problem.js";
+// The pronunciations of every project's glossary, merged, for Edit project to copy into a
+// project that shares them. `except` leaves out the project being edited, whose own glossary
+// already comes first.
+export function pronunciationRoutes(deps) {
+    return new Hono().get("/shared", zValidator("query", z.object({
+        except: z
+            .string()
+            .max(64)
+            .regex(/^[0-9A-Za-z_-]*$/)
+            .optional(),
+    }), onInvalid), (c) => c.json(collectSharedGlossary(deps, c.req.valid("query").except)));
+}

package/dist/edge/http/storage.js

@@ -1,39 +1,86 @@
 import { Hono } from "hono";
-import { exportPortable, importPortable, portableMaxArchiveBytes, storageUsage, } from "../../slices/storage/portable.js";
+import { BackupBusyError, planBackup, streamBackup, } from "../../slices/storage/backup-export.js";
+import { BackupImportRefused, importBackup } from "../../slices/storage/backup-import.js";
+import { importPortable, portableMaxArchiveBytes, storageUsage, } from "../../slices/storage/portable.js";
 import { reconcileStorage } from "../../slices/storage/reconcile.js";
 import { problem, titleOf } from "./problem.js";
+const exportFailed = "Slopify could not create the backup. Check there is free disk space and try again; if it keeps failing, use Download diagnostics in Settings and report it.";
 export function storageRoutes(deps) {
-    return new Hono()
+    const backup = () => ({
+        db: deps.db,
+        paths: deps.paths,
+        clock: deps.clock,
+        ids: deps.ids,
+        appVersion: deps.version,
+        hasInflight: deps.runner.hasInflight,
+    });
+    return (new Hono()
         .get("/", (c) => c.json(storageUsage({ db: deps.db, paths: deps.paths })))
-        .get("/export", (c) => {
+        // What Export everything would write, asked before the download starts: a download
+        // link cannot show a refusal, the browser would save it as the file.
+        .get("/export/summary", (c) => {
         try {
-            const bytes = exportPortable({
-                db: deps.db,
-                paths: deps.paths,
-                ids: deps.ids,
-                now: () => deps.clock.now().toISOString(),
-            });
-            return c.body(bytes, 200, {
-                "content-type": "application/zip",
-                "content-length": String(bytes.byteLength),
-                "content-disposition": 'attachment; filename="slopify-backup.zip"',
+            const plan = planBackup(backup());
+            return c.json({
+                ready: true,
+                projects: plan.manifest.projects.length,
+                files: plan.manifest.files,
+                bytes: plan.archiveBytes,
             });
         }
-        catch {
-            return problem(c, {
-                status: 500,
-                title: titleOf(500),
-                detail: "Slopify could not create the backup. Check there is free disk space and try again; if it keeps failing, use Download diagnostics in Settings and report it.",
-            });
+        catch (error) {
+            if (error instanceof BackupBusyError)
+                return c.json({ ready: false, detail: error.message, busy: error.projects });
+            deps.log.write("error", "storage.export", { detail: String(error) });
+            return problem(c, { status: 500, title: titleOf(500), detail: exportFailed });
         }
+    })
+        .get("/export", (c) => {
+        let plan;
+        try {
+            plan = planBackup(backup());
+        }
+        catch (error) {
+            if (error instanceof BackupBusyError)
+                return problem(c, { status: 409, title: titleOf(409), detail: error.message });
+            deps.log.write("error", "storage.export", { detail: String(error) });
+            return problem(c, { status: 500, title: titleOf(500), detail: exportFailed });
+        }
+        // Pulled one chunk at a time, so a slow download reads files no faster than it sends.
+        const chunks = streamBackup(plan);
+        const body = new ReadableStream({
+            async pull(controller) {
+                try {
+                    const next = await chunks.next();
+                    if (next.done === true)
+                        controller.close();
+                    else
+                        controller.enqueue(next.value);
+                }
+                catch (error) {
+                    deps.log.write("error", "storage.export", { detail: String(error) });
+                    controller.error(error);
+                }
+            },
+            async cancel() {
+                await chunks.return(undefined);
+            },
+        });
+        return c.body(body, 200, {
+            "content-type": "application/x-tar",
+            "content-length": String(plan.archiveBytes),
+            "content-disposition": `attachment; filename="${plan.fileName}"`,
+        });
     })
         .put("/import", async (c) => {
         const contentType = c.req.header("content-type") ?? "";
+        if (contentType.includes("application/x-tar"))
+            return importFull(c.req.raw);
         if (!contentType.includes("application/zip"))
             return problem(c, {
                 status: 415,
                 title: titleOf(415),
-                detail: "Choose a Slopify backup file (.zip) made with Backup & storage in Settings.",
+                detail: "Choose a Slopify backup file: a .tar made with Export everything, or an older .zip made with Export backup, both in Settings → Backup & storage.",
             });
         const upload = await readPortableUpload(c.req.raw);
         if (!upload.ok)
@@ -58,8 +105,46 @@ export function storageRoutes(deps) {
                 detail: "This file is not a complete Slopify backup; it may be damaged or a different kind of ZIP. Choose a backup made with Backup & storage in Settings.",
             });
         }
+        async function importFull(request) {
+            if (request.body === null)
+                return problem(c, {
+                    status: 400,
+                    title: titleOf(400),
+                    detail: "The backup file arrived empty. Choose the .tar made with Export everything and import it again.",
+                });
+            const reader = request.body.getReader();
+            try {
+                return c.json(await importBackup(backup(), chunksOf(reader)));
+            }
+            catch (error) {
+                if (error instanceof BackupImportRefused)
+                    return problem(c, {
+                        status: error.status,
+                        title: titleOf(error.status),
+                        detail: error.message,
+                    });
+                deps.log.write("error", "storage.import", { detail: String(error) });
+                return problem(c, {
+                    status: 500,
+                    title: titleOf(500),
+                    detail: "The backup wasn't imported and nothing in this install changed. Try again; if it keeps failing, use Download diagnostics in Settings and report it.",
+                });
+            }
+            finally {
+                // A refusal mid-upload stops reading the rest of a file that may be gigabytes.
+                await reader.cancel().catch(() => undefined);
+            }
+        }
     })
-        .post("/cleanup", (c) => c.json(reconcileStorage(deps.db, deps.paths)));
+        .post("/cleanup", (c) => c.json(reconcileStorage(deps.db, deps.paths))));
+}
+async function* chunksOf(reader) {
+    while (true) {
+        const next = await reader.read();
+        if (next.done)
+            return;
+        yield next.value;
+    }
 }
 async function readPortableUpload(request) {
     const declared = request.headers.get("content-length");

package/dist/kernel/db/migrate.js

@@ -3,7 +3,7 @@ import { readdirSync, readFileSync } from "node:fs";
 // under Vitest (src/kernel/db/migrations) and after the build (dist/kernel/db/migrations,
 // filled by packages/app/scripts/copy-migrations.mjs).
 const migrationsDir = new URL("./migrations/", import.meta.url);
-export function migrate(db, clock) {
+export function migrate(db, clock, options = {}) {
     const files = readdirSync(migrationsDir)
         .filter((file) => file.endsWith(".sql"))
         .sort();
@@ -20,6 +20,9 @@ export function migrate(db, clock) {
         if (version === undefined || applied.has(version)) {
             continue;
         }
+        if (options.through !== undefined && version > options.through) {
+            break;
+        }
         const sql = readFileSync(new URL(file, migrationsDir), "utf8");
         // A migration that rebuilds a table other tables reference must run with enforcement
         // off: dropping the old table would otherwise cascade into every row that points at it.
@@ -51,6 +54,12 @@ export function migrate(db, clock) {
         }
     }
 }
+// The newest schema this build knows, which a backup records as the schema its rows fit.
+export function newestMigration() {
+    return Math.max(0, ...readdirSync(migrationsDir)
+        .filter((file) => file.endsWith(".sql"))
+        .map(versionOf));
+}
 // The first line of such a migration, compared without its line ending.
 const foreignKeysOff = "-- foreign-keys: off";
 function foreignKeysOn(db) {

package/dist/kernel/db/migrations/0016-document-themes.sql

@@ -0,0 +1,10 @@
+-- Document themes saved in Library → Documents. A project keeps its own copy of the values
+-- it was given, so nothing references these rows and a delete never cascades.
+CREATE TABLE document_themes (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  values_json TEXT NOT NULL CHECK (json_valid(values_json)),
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+CREATE UNIQUE INDEX document_themes_name ON document_themes(lower(name));

package/dist/kernel/db/migrations/0017-legacy-dicemaster-theme.sql

@@ -0,0 +1,12 @@
+-- DiceMaster stopped being a built-in document theme: it is one brand's look (DiceMaster.io),
+-- not Slopify's. An install that has already used the Document stage gets it back as a saved
+-- Library → Documents theme with exactly the values it had, so it can still be picked for new
+-- projects. Projects saved with it keep drawing with it either way (legacy-dicemaster.ts).
+-- A fresh install gets nothing, and an existing theme of that name is left alone.
+-- The JSON below is legacyDiceMasterTheme; legacy-dicemaster.test.ts holds the two equal.
+INSERT INTO document_themes (id, name, values_json, created_at, updated_at)
+SELECT 'legacy-dicemaster', 'DiceMaster',
+  '{"page":{"format":"a4","margin":22,"contentTop":32},"background":{"image":"parchment","color":"#f5ebd7"},"colors":{"heading":"#8c1e14","text":"#000000","muted":"#50463c","faint":"#786e5f"},"fonts":{"body":{"family":"Cinzel","style":"normal","letterSpacing":0.01},"strong":{"family":"Cinzel","style":"bold","letterSpacing":0.02},"emphasis":{"family":"times","style":"italic","letterSpacing":0},"heading":{"family":"Cinzel","style":"bold","letterSpacing":0.02},"dramatic":{"family":"Cinzel","style":"black","letterSpacing":0.03},"decorative":{"family":"Cinzel","style":"medium","letterSpacing":0.015},"dropCap":{"family":"Cinzel","style":"black","letterSpacing":0},"footer":{"family":"times","style":"normal","letterSpacing":0}},"sizes":{"brand":31,"title":22,"section":19,"heading":17,"subheading":13,"body":10.5,"footer":9,"meta":10},"spacing":{"bodyLine":8,"headingLine":11,"subheadingLine":9,"paragraphGap":0.5,"headingGap":1,"itemGap":0.2,"listIndent":6,"quoteIndent":8,"ruleWidth":30},"dropCap":{"enabled":true,"lines":3,"scale":3,"gap":4,"minLength":50,"minRoom":0.25},"titlePage":{"brandY":60,"taglineOffset":10,"titleY":80,"titleLine":10,"metaOffset":20,"metaLine":10,"showDate":true,"showWordCount":true,"cover":{"enabled":true,"gap":6,"maxHeight":110}},"contents":{"enabled":true,"title":"Table of Contents","depth":2,"titleOffset":20,"firstEntryOffset":40,"line":8,"indent":5},"header":{"enabled":true,"top":15,"maxTitleCharacters":35},"footer":{"enabled":true,"bottom":10,"reserve":15,"text":"Page {page}"},"brand":{"name":"DiceMaster.io","url":"https://dicemaster.io/","tagline":"Let us Handle the Crunch, You Focus on the Story","linkLabel":"Visit DiceMaster.io"},"metadata":{"author":"Created with DiceMaster.io","subject":"{title} - Powered by DiceMaster.io","keywords":"D&D, DnD, Dungeons and Dragons, lore, script, tabletop, RPG, TTRPG, DiceMaster.io","creator":"DiceMaster.io - The AI-Powered Virtual Tabletop"},"sources":{"enabled":true,"title":"Sources Consulted","titleOffset":20,"bodyOffset":40,"line":8,"gap":2},"endPage":{"enabled":true,"title":"About DiceMaster.io","titleOffset":20,"bodyOffset":40,"lines":["About DiceMaster.io:","• Character Engine - Form-driven creation with automatic leveling","• Automated Rules Engine - D&D mechanics and spells run automatically","• AI-Generated NPCs - Instant personalities with full stat blocks","• Granular Inventory Tracking - Live gear & condition management","• Real-Time Rule Guidance - Context-aware clarifications","• Dynamic Storytelling AI - On-the-fly narration & dialogue","• True-Physics Dice - RNG-driven rolls with animated suspense","• Cinematic Combat Module - Positional tracking & narrative summaries","• Voice Commands - Seamless STT/TTS multimodal interaction","• AI Dungeon Master Layer - Rules adjudication & encounter balancing"],"showDocumentDetails":true,"link":{"text":"Visit DiceMaster.io","url":"https://dicemaster.io/"},"closing":"Experience the future of tabletop RPGs!"}}',
+  strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+WHERE EXISTS (SELECT 1 FROM stages WHERE kind = 'document' AND source <> 'off')
+  AND NOT EXISTS (SELECT 1 FROM document_themes WHERE lower(name) = 'dicemaster');

package/dist/kernel/db/migrations/0018-backup-imports.sql

@@ -0,0 +1,7 @@
+-- One row per backup archive imported (Settings → Backup & storage). A backup carries its own
+-- id, so importing the same file twice adds its usage history once.
+CREATE TABLE backup_imports (
+  backup_id TEXT PRIMARY KEY,
+  imported_at TEXT NOT NULL,
+  summary_json TEXT NOT NULL CHECK (json_valid(summary_json))
+);

package/dist/slices/admission/schema.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { thinkingModes } from "../../kernel/ports/llm.js";
 import { checkpointStageSchema } from "../checkpoints/schema.js";
-import { documentThemes } from "../document/model.js";
+import { documentSettingsSchema } from "../document/theme-schema.js";
 import { chunkModes } from "../narration/chunk.js";
 import { subtitleConfigSchema } from "../subtitles/model.js";
 import { entryModes, formats, motionStyles, stageSources } from "./model.js";
@@ -37,7 +37,19 @@ export const runDraftSchema = z.object({
     }),
     llm: providerChoice.optional(),
     audio: providerChoice
-        .extend({ voice: z.string(), usePronunciationGlossary: z.boolean().optional() })
+        .extend({
+        voice: z.string(),
+        usePronunciationGlossary: z.boolean().optional(),
+        shareGlossary: z.boolean().optional(),
+    })
+        .optional(),
+    sharedGlossary: z
+        .array(z.object({
+        term: z.string().min(1).max(200),
+        ipa: z.array(z.string().min(1).max(200)).min(1).max(20).readonly(),
+    }))
+        .max(20000)
+        .readonly()
         .optional(),
     images: providerChoice.optional(),
     articlePrompt: z.string().optional(),
@@ -71,7 +83,7 @@ export const runDraftSchema = z.object({
     motionStyle: z.enum(motionStyles).default(defaultMotionStyle),
     edgeSilenceSeconds: z.number().default(defaultEdgeSilenceSeconds),
     subtitles: subtitleConfigSchema.optional(),
-    document: z.object({ theme: z.enum(documentThemes) }).optional(),
+    document: documentSettingsSchema.optional(),
     youtubeDescription: z.boolean().optional(),
     descriptionPrompt: z.string().optional(),
 });

package/dist/slices/admission/start.js

@@ -1,12 +1,15 @@
 import { transact } from "../../kernel/db/tx.js";
 import { stageKinds } from "../../kernel/pipeline.js";
 import { storeArticleText } from "../article/store.js";
+import { defaultDocumentTheme } from "../document/model.js";
+import { collectSharedGlossary } from "../narration/shared-glossary.js";
 import { admitInitialRevision } from "../rebuild/runtime-admission.js";
 import { adoptBaseline } from "../revisions/adopt.js";
 import { attachStagedFile, storeText } from "../storage/staging.js";
 import { releaseStagedFile } from "../storage/staging-refs.js";
 import { sourceOf, } from "./model.js";
 import { insertProject, insertStage } from "./repo.js";
+import { usesPronunciationGlossary } from "./rules.js";
 // Provide → `provided` with its output attached; Off → `skipped`;
 // everything else → `pending`.
 export function initialState(source) {
@@ -20,7 +23,19 @@ export function initialState(source) {
 export function startRun(deps, draft, rendered, retainStaged = false, templates) {
     const id = deps.ids.next();
     const at = deps.clock.now().toISOString();
-    const config = { ...draft, rendered };
+    const shared = usesPronunciationGlossary(draft) && draft.audio?.shareGlossary === true
+        ? collectSharedGlossary(deps).entries
+        : [];
+    const config = {
+        ...draft,
+        // A new project always names its document theme: a config without one reads as the
+        // DiceMaster of older projects (see documentThemeOf), which no new project should get.
+        ...(sourceOf(draft.sources, "document") === "generate" && draft.document === undefined
+            ? { document: { theme: defaultDocumentTheme } }
+            : {}),
+        rendered,
+        ...(shared.length === 0 ? {} : { sharedGlossary: shared }),
+    };
     const project = {
         id,
         title: draft.title,

package/dist/slices/article/source-lines.js

@@ -0,0 +1,20 @@
+// The entries of an article's "Sources Consulted" section, one per source. Models write the
+// list as bullets, as numbered lines, or as plain lines with no blank line between them;
+// markdown would join the last kind into one paragraph, so the section is read line by line
+// instead. A line indented under an entry continues it. The section starts with its own
+// heading (`splitEndMatter` cuts it there), which is not an entry. Browser-safe: the project
+// page lists the same entries the PDF prints.
+const marker = /^(?:[-*+]|\d+[.)])\s+/u;
+export function sourceEntries(section) {
+    const lines = section.split(/\r?\n/u).filter((line) => line.trim() !== "");
+    const entries = [];
+    for (const raw of lines.slice(1)) {
+        const line = raw.trim().replace(marker, "").trim();
+        const last = entries.length - 1;
+        if (/^\s/u.test(raw) && !marker.test(raw.trim()) && last >= 0)
+            entries[last] = `${entries[last] ?? ""} ${line}`;
+        else if (line !== "")
+            entries.push(line);
+    }
+    return entries;
+}

package/dist/slices/document/legacy-dicemaster.js

@@ -0,0 +1,118 @@
+// The DiceMaster look, the built-in default before 2.3.0. It is one brand's look (DiceMaster.io),
+// not one Slopify offers, so no picker and no built-in list shows it any more. It stays in the
+// code for two reasons only: a project saved with `document: { theme: "dicemaster" }`, or
+// with the Document stage on and no theme at all, must keep drawing (and fingerprinting) exactly
+// as it did, or its PDF would read as outdated; and migration 0017 copies these values into
+// Library → Documents as a saved "DiceMaster" theme, which a test holds to this literal.
+//
+// Ported from the lore2script2 PDF generator's stock DiceMaster.io look, value for value. Do not
+// edit it: any change reaches the documents of every project that still uses it.
+const cinzel = (style, letterSpacing) => ({
+    family: "Cinzel",
+    style,
+    letterSpacing,
+});
+export const legacyDiceMasterTheme = {
+    page: { format: "a4", margin: 22, contentTop: 32 },
+    background: { image: "parchment", color: "#f5ebd7" },
+    colors: { heading: "#8c1e14", text: "#000000", muted: "#50463c", faint: "#786e5f" },
+    fonts: {
+        body: cinzel("normal", 0.01),
+        strong: cinzel("bold", 0.02),
+        // Cinzel has no italic, so emphasis borrows the standard serif's.
+        emphasis: { family: "times", style: "italic", letterSpacing: 0 },
+        heading: cinzel("bold", 0.02),
+        dramatic: cinzel("black", 0.03),
+        decorative: cinzel("medium", 0.015),
+        dropCap: cinzel("black", 0),
+        footer: { family: "times", style: "normal", letterSpacing: 0 },
+    },
+    // lore2script2 scaled its Cinzel sizes and line heights (by 1.1, 1.05 and 1.2) and
+    // rounded; these are the results.
+    sizes: {
+        brand: 31,
+        title: 22,
+        section: 19,
+        heading: 17,
+        subheading: 13,
+        body: 10.5,
+        footer: 9,
+        meta: 10,
+    },
+    spacing: {
+        bodyLine: 8,
+        headingLine: 11,
+        subheadingLine: 9,
+        paragraphGap: 0.5,
+        headingGap: 1,
+        itemGap: 0.2,
+        listIndent: 6,
+        quoteIndent: 8,
+        ruleWidth: 30,
+    },
+    dropCap: { enabled: true, lines: 3, scale: 3, gap: 4, minLength: 50, minRoom: 0.25 },
+    titlePage: {
+        brandY: 60,
+        taglineOffset: 10,
+        titleY: 80,
+        titleLine: 10,
+        metaOffset: 20,
+        metaLine: 10,
+        showDate: true,
+        showWordCount: true,
+        cover: { enabled: true, gap: 6, maxHeight: 110 },
+    },
+    contents: {
+        enabled: true,
+        title: "Table of Contents",
+        depth: 2,
+        titleOffset: 20,
+        firstEntryOffset: 40,
+        line: 8,
+        indent: 5,
+    },
+    header: { enabled: true, top: 15, maxTitleCharacters: 35 },
+    footer: { enabled: true, bottom: 10, reserve: 15, text: "Page {page}" },
+    brand: {
+        name: "DiceMaster.io",
+        url: "https://dicemaster.io/",
+        tagline: "Let us Handle the Crunch, You Focus on the Story",
+        linkLabel: "Visit DiceMaster.io",
+    },
+    metadata: {
+        author: "Created with DiceMaster.io",
+        subject: "{title} - Powered by DiceMaster.io",
+        keywords: "D&D, DnD, Dungeons and Dragons, lore, script, tabletop, RPG, TTRPG, DiceMaster.io",
+        creator: "DiceMaster.io - The AI-Powered Virtual Tabletop",
+    },
+    sources: {
+        enabled: true,
+        title: "Sources Consulted",
+        titleOffset: 20,
+        bodyOffset: 40,
+        line: 8,
+        gap: 2,
+    },
+    endPage: {
+        enabled: true,
+        title: "About DiceMaster.io",
+        titleOffset: 20,
+        bodyOffset: 40,
+        lines: [
+            "About DiceMaster.io:",
+            "• Character Engine - Form-driven creation with automatic leveling",
+            "• Automated Rules Engine - D&D mechanics and spells run automatically",
+            "• AI-Generated NPCs - Instant personalities with full stat blocks",
+            "• Granular Inventory Tracking - Live gear & condition management",
+            "• Real-Time Rule Guidance - Context-aware clarifications",
+            "• Dynamic Storytelling AI - On-the-fly narration & dialogue",
+            "• True-Physics Dice - RNG-driven rolls with animated suspense",
+            "• Cinematic Combat Module - Positional tracking & narrative summaries",
+            "• Voice Commands - Seamless STT/TTS multimodal interaction",
+            "• AI Dungeon Master Layer - Rules adjudication & encounter balancing",
+        ],
+        showDocumentDetails: true,
+        link: { text: "Visit DiceMaster.io", url: "https://dicemaster.io/" },
+        closing: "Experience the future of tabletop RPGs!",
+    },
+};