@m0saic/templates 0.2.0

package/dist/m0saic/story/scrapbook/v1/pages.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STAND_IN_PAGES = void 0;
+exports.resolvePages = resolvePages;
+const placeholder_1 = require("./placeholder");
+/** How many pages to lay out when no pictures have arrived yet. */
+exports.STAND_IN_PAGES = 4;
+/** A stand-in line, so the layout is judged with words in it rather than blanks. */
+function standInNote(i, hasPhotos) {
+    if (hasPhotos)
+        return "";
+    return [
+        "the summer everything changed",
+        "she never let me carry anything",
+        "we drove until the map ran out",
+        "and then there were four of us",
+    ][i % 4];
+}
+/**
+ * Resolve pages from the props. With no photos the film is laid out with
+ * stand-ins so its pacing can be judged before any real picture exists;
+ * with photos, the count follows the photos and the notes fill in beside
+ * them (a missing note is a wordless page, never an error).
+ */
+function resolvePages(p) {
+    const photos = p.photos.filter((s) => typeof s === "string" && s.trim() !== "");
+    const count = photos.length > 0 ? photos.length : exports.STAND_IN_PAGES;
+    return Array.from({ length: count }, (_, i) => {
+        const real = photos[i];
+        return {
+            index: i,
+            image: real ? { kind: "file", path: real } : { kind: "data-uri", uri: (0, placeholder_1.standInPhotoUrl)(i, p.paperColor) },
+            note: typeof p.notes[i] === "string" ? p.notes[i] : standInNote(i, photos.length > 0),
+            standIn: !real,
+        };
+    });
+}

package/dist/m0saic/story/scrapbook/v1/pipeline.d.ts

@@ -0,0 +1,44 @@
+import type { MosaicDocument, MosaicDocumentPipeline } from "@m0saic/types";
+import type { Page } from "./pages";
+import type { ResolvedProps } from "./props";
+/**
+ * The film: an opening card, a page per picture, a closing line — every
+ * join a cross-fade, because a scrapbook turns pages, it does not cut.
+ *
+ * Timing law (the same one the rest of the house keeps): a fade rides on
+ * the OUTGOING step, so the stitched length equals the authored
+ * `durationMs` exactly.
+ */
+export type ScrapbookPlan = {
+    width: number;
+    height: number;
+    fps: number;
+    props: ResolvedProps;
+    pages: Page[];
+};
+/**
+ * A card: a big line, and a small one under it when there is one.
+ *
+ * The rows are built from the text that EXISTS. An empty line is not an
+ * empty row — a blank svg text source still paints its box, which is how
+ * the closing card grew a grey bar the first time.
+ */
+export declare function cardDoc(o: {
+    width: number;
+    height: number;
+    fps: number;
+    durationMs: number;
+    props: ResolvedProps;
+    headline: string;
+    sub: string;
+    /** Which prop the headline IS, so Make can edit it where it is drawn. */
+    headlineProp: string;
+    /** When this card's own time starts, on the PARENT clock (see buildPageDoc). */
+    originSec?: number;
+    /** See `buildPageDoc` — false as one layer of a single document. */
+    entrances?: boolean;
+}): MosaicDocument;
+/** The whole film, as an `emit:"single"` pipeline. */
+export declare function buildScrapbookPipeline(plan: ScrapbookPlan): MosaicDocumentPipeline;
+/** The film's natural length, for the output hint and the timing gate. */
+export declare function naturalDurationMs(p: ResolvedProps, pageCount: number): number;

package/dist/m0saic/story/scrapbook/v1/pipeline.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cardDoc = cardDoc;
+exports.buildScrapbookPipeline = buildScrapbookPipeline;
+exports.naturalDurationMs = naturalDurationMs;
+const types_1 = require("@m0saic/types");
+const dsl_stdlib_1 = require("@m0saic/dsl-stdlib");
+const template_utils_1 = require("@m0saic/template-utils");
+const page_1 = require("./page");
+/**
+ * A card: a big line, and a small one under it when there is one.
+ *
+ * The rows are built from the text that EXISTS. An empty line is not an
+ * empty row — a blank svg text source still paints its box, which is how
+ * the closing card grew a grey bar the first time.
+ */
+function cardDoc(o) {
+    var _a;
+    const { width: W, height: H, fps, durationMs, props: p } = o;
+    const t0 = (_a = o.originSec) !== null && _a !== void 0 ? _a : 0;
+    const hasSub = o.sub.trim() !== "";
+    // Rows in UNITS, not pixels. Pixel weights would make this a split with
+    // one slot per pixel of canvas — far past the planner's px-per-weight
+    // floor, where cells quantize and squash.
+    const units = hasSub ? [10, 11, 4] : [12, 13];
+    const total = units.reduce((a, b) => a + b, 0);
+    const headH = Math.round((H * units[1]) / total);
+    const subH = hasSub ? Math.round((H * units[2]) / total) : 0;
+    const sources = [
+        { type: "lavfi", color: p.paperColor },
+        (0, template_utils_1.bindProp)({
+            ...(0, template_utils_1.svgLabel)(o.headline, W, headH, { color: p.inkColor, maxPx: Math.round(headH * 0.46), maxLines: 2 }),
+            ...(o.entrances === false ? {} : { overlay: (0, template_utils_1.entrance)({ kind: "rise", durationMs: 700, atSec: t0 + 0.15, ease: "easeOut" }) }),
+        }, o.headlineProp),
+    ];
+    if (hasSub) {
+        sources.push((0, template_utils_1.bindProp)({
+            ...(0, template_utils_1.svgLabel)(o.sub, W, subH, { color: p.accentColor, maxPx: Math.round(subH * 0.5), maxLines: 1 }),
+            ...(o.entrances === false ? {} : { overlay: (0, template_utils_1.entrance)({ kind: "fade", durationMs: 700, atSec: t0 + 0.55, ease: "easeOut" }) }),
+        }, "subtitle"));
+    }
+    return {
+        kind: "mosaic_document",
+        version: 1,
+        m0: (0, dsl_stdlib_1.weightedSplit)(units, "row", { precision: total }),
+        size: { width: W, height: H },
+        fps,
+        durationMs,
+        backgroundColor: p.paperColor,
+        audio: { mode: "off" },
+        assets: {},
+        sources,
+    };
+}
+/**
+ * Put the music bed under one step. An audio-only source still holds a
+ * frame, so it arrives as a nested leaf on the document's m0 — and it
+ * starts `atMs` INTO the track, so the bed runs continuously across the
+ * film instead of restarting on every page.
+ */
+function withMusic(doc, music, id, atMs) {
+    var _a;
+    if (!music)
+        return doc;
+    return {
+        ...doc,
+        m0: (0, dsl_stdlib_1.toM0String)(`${String(doc.m0)}{F}`, "Scrapbook-audio"),
+        audio: { mode: "auto" },
+        assets: { ...((_a = doc.assets) !== null && _a !== void 0 ? _a : {}), [id]: { kind: "file", path: music, mediaType: "audio" } },
+        sources: [
+            ...doc.sources,
+            { type: "media", mediaType: "audio", assetId: id, playback: { clipStartMs: Math.max(0, Math.round(atMs)) } },
+        ],
+    };
+}
+/** The whole film, as an `emit:"single"` pipeline. */
+function buildScrapbookPipeline(plan) {
+    const { width: W, height: H, fps, props: p, pages } = plan;
+    const x = Math.round(p.xfadeMs);
+    const steps = [];
+    const fade = x > 0 ? ({ transitionToNext: { type: "fade", durationMs: x } }) : {};
+    const openMs = Math.round(p.introMs);
+    const pageMs = Math.round(p.perPageMs);
+    const closeMs = Math.round(p.outroMs);
+    const music = p.music.trim();
+    const musicId = (0, types_1.asAssetId)("music_bed");
+    // Where the film has got to — the bed picks up from here on each step.
+    let atMs = 0;
+    if (openMs > 0) {
+        const d = openMs + x;
+        const doc = cardDoc({ width: W, height: H, fps, durationMs: d, props: p, headline: p.title, sub: p.subtitle, headlineProp: "title" });
+        steps.push({ name: "open", label: "Opening", durationMs: d, file: withMusic(doc, music, musicId, atMs), ...fade });
+        atMs += openMs;
+    }
+    pages.forEach((page, i) => {
+        const last = i === pages.length - 1 && closeMs <= 0;
+        const d = pageMs + (last ? 0 : x);
+        const doc = (0, page_1.buildPageDoc)({ page, width: W, height: H, fps, durationMs: d, props: p });
+        steps.push({
+            name: `page-${page.index + 1}`,
+            label: `Page ${page.index + 1}`,
+            durationMs: d,
+            file: withMusic(doc, music, musicId, atMs),
+            ...(last ? {} : fade),
+        });
+        atMs += pageMs;
+    });
+    if (closeMs > 0) {
+        const doc = cardDoc({ width: W, height: H, fps, durationMs: closeMs, props: p, headline: p.closing, sub: "", headlineProp: "closing" });
+        steps.push({ name: "close", label: "Closing", durationMs: closeMs, file: withMusic(doc, music, musicId, atMs) });
+    }
+    // Fades ride on the outgoing step, so the stitched total is exactly this.
+    const totalMs = openMs + pageMs * pages.length + closeMs;
+    return {
+        kind: "mosaic_pipeline",
+        version: 1,
+        emit: "single",
+        size: { width: W, height: H },
+        fps,
+        durationMs: totalMs,
+        durationFit: "cut",
+        defaultTransition: { type: "cut" },
+        backgroundColor: p.paperColor,
+        steps,
+    };
+}
+/** The film's natural length, for the output hint and the timing gate. */
+function naturalDurationMs(p, pageCount) {
+    return Math.round(p.introMs) + Math.round(p.perPageMs) * pageCount + Math.round(p.outroMs);
+}

package/dist/m0saic/story/scrapbook/v1/placeholder.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Stand-in pictures, so the film can be laid out and paced before a single
+ * real photograph exists.
+ *
+ * Deliberately NOT photographic: soft warm shapes that read as "a picture
+ * goes here" at a glance. Fakes that looked real would flatter the layout
+ * and hide what the real thing has to survive.
+ *
+ * Generated as URL-encoded SVG data URIs — no `Buffer` (so this module is
+ * browser-safe) and no `;utf8` parameter, which the engine's plain-SVG
+ * parser rejects.
+ */
+export type ClaimImageLike = {
+    kind: "file";
+    path: string;
+} | {
+    kind: "data-uri";
+    uri: string;
+};
+/** One stand-in picture, deterministic per page index. */
+export declare function standInPhotoSvg(i: number, paper: string): string;
+export declare function standInPhotoUrl(i: number, paper: string): string;

package/dist/m0saic/story/scrapbook/v1/placeholder.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Stand-in pictures, so the film can be laid out and paced before a single
+ * real photograph exists.
+ *
+ * Deliberately NOT photographic: soft warm shapes that read as "a picture
+ * goes here" at a glance. Fakes that looked real would flatter the layout
+ * and hide what the real thing has to survive.
+ *
+ * Generated as URL-encoded SVG data URIs — no `Buffer` (so this module is
+ * browser-safe) and no `;utf8` parameter, which the engine's plain-SVG
+ * parser rejects.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.standInPhotoSvg = standInPhotoSvg;
+exports.standInPhotoUrl = standInPhotoUrl;
+/** Warm, faded-snapshot palettes: [sky, ground, subject]. */
+const PALETTES = [
+    ["#D8C7A8", "#B49B78", "#6E5842"],
+    ["#C9CFC0", "#9FAE94", "#4F5C4A"],
+    ["#E2C7B4", "#C39A85", "#7A5545"],
+    ["#C6CDD8", "#98A5B6", "#4C5769"],
+    ["#E0D2B6", "#BFA97F", "#6B5636"],
+];
+function hash(i, salt) {
+    let h = (i * 0x9e3779b1) ^ (salt * 0x85ebca6b);
+    h = Math.imul(h ^ (h >>> 16), 0x7feb352d);
+    h = Math.imul(h ^ (h >>> 15), 0x846ca68b);
+    return (h ^ (h >>> 16)) >>> 0;
+}
+/** One stand-in picture, deterministic per page index. */
+function standInPhotoSvg(i, paper) {
+    const [sky, ground, subject] = PALETTES[hash(i, 1) % PALETTES.length];
+    const horizon = 96 + (hash(i, 2) % 40);
+    const sunX = 40 + (hash(i, 3) % 120);
+    const figures = 1 + (hash(i, 4) % 3);
+    const people = Array.from({ length: figures }, (_, k) => {
+        const x = 40 + ((hash(i, 10 + k) % 120));
+        const h = 26 + (hash(i, 20 + k) % 18);
+        return `<circle cx="${x}" cy="${horizon + 14 - h}" r="7" fill="${subject}"/><rect x="${x - 7}" y="${horizon + 22 - h}" width="14" height="${h}" rx="6" fill="${subject}"/>`;
+    }).join("");
+    return (`<svg xmlns="http://www.w3.org/2000/svg" width="200" height="200" viewBox="0 0 200 200">` +
+        `<rect width="200" height="200" fill="${sky}"/>` +
+        `<circle cx="${sunX}" cy="${horizon - 54}" r="18" fill="${paper}" opacity="0.55"/>` +
+        `<rect y="${horizon}" width="200" height="${200 - horizon}" fill="${ground}"/>` +
+        people +
+        `</svg>`);
+}
+function standInPhotoUrl(i, paper) {
+    return `data:image/svg+xml,${encodeURIComponent(standInPhotoSvg(i, paper))}`;
+}

package/dist/m0saic/story/scrapbook/v1/props.d.ts

@@ -0,0 +1,66 @@
+/**
+ * `@m0saic/story/scrapbook/v1` — props.
+ *
+ * THE CONTRACT (what this template is, before any layout):
+ *
+ * A short personal film. A handful of pictures, each with a line in the
+ * author's own words, laid down like the pages of a scrapbook: pinned
+ * slightly askew on paper, drifting gently, handing over with soft
+ * cross-fades, optionally over music. Warm and unhurried — the opposite
+ * register to a product demo.
+ *
+ * What it is NOT: a gallery, a grid, or a slideshow with effects. One page
+ * at a time, and the words matter as much as the pictures.
+ *
+ * CONTENT COMES LATER. `photos` and `notes` are index-aligned and both may
+ * be empty: at defaults the template lays out generated stand-in pages so
+ * the pacing and motion can be judged before a single real picture exists.
+ * Dropping real files in replaces them one for one.
+ */
+export type ScrapbookProps = {
+    /** Opening line — a name, usually. */
+    title?: string;
+    /** Under the title: a date range, a place, a dedication. */
+    subtitle?: string;
+    /** The pictures, in order. Empty = generated stand-in pages. */
+    photos?: string[];
+    /** One line per picture, index-aligned with `photos`. Blank entries are fine. */
+    notes?: string[];
+    /** The last thing on screen. */
+    closing?: string;
+    /** Optional music bed under the whole film. */
+    music?: string;
+    /** How long each page holds (ms). */
+    perPageMs?: number;
+    /** The opening card (ms). */
+    introMs?: number;
+    /** The closing card (ms). */
+    outroMs?: number;
+    /** Cross-fade between pages (ms) — the scrapbook's page turn. */
+    xfadeMs?: number;
+    /** How far each picture drifts while it holds (0 = still, 1 = a lot). */
+    drift?: number;
+    /** How far off square a picture is pinned, in degrees. */
+    tilt?: number;
+    /** The paper the scrapbook is made of. */
+    paperColor?: string;
+    /** The pen. */
+    inkColor?: string;
+    /** The one colour that is not paper or ink. */
+    accentColor?: string;
+};
+export declare const DEFAULT_PROPS: Required<Omit<ScrapbookProps, "photos" | "notes" | "music">> & {
+    photos: string[];
+    notes: string[];
+    music: string;
+};
+export declare const propsSchema: Record<keyof ScrapbookProps, import("@m0saic/types").MosaicTemplatePropDefinition>;
+export type ResolvedProps = typeof DEFAULT_PROPS;
+/** Merge defaults + fail-fast validation. */
+export declare function resolveProps(props: ScrapbookProps): {
+    ok: true;
+    value: ResolvedProps;
+} | {
+    ok: false;
+    errors: string[];
+};

package/dist/m0saic/story/scrapbook/v1/props.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.propsSchema = exports.DEFAULT_PROPS = void 0;
+exports.resolveProps = resolveProps;
+const template_utils_1 = require("@m0saic/template-utils");
+exports.DEFAULT_PROPS = {
+    title: "A few good years",
+    subtitle: "the people who were there",
+    photos: [],
+    notes: [],
+    closing: "more soon",
+    music: "",
+    perPageMs: 3600,
+    introMs: 2200,
+    outroMs: 2600,
+    xfadeMs: 700,
+    drift: 0.18,
+    tilt: 2.2,
+    paperColor: "#EFE7D8",
+    inkColor: "#221E19",
+    accentColor: "#C2410C",
+};
+exports.propsSchema = (0, template_utils_1.definePropsSchema)({
+    title: { type: "string", required: false, description: "Opening line — a name, usually.", meta: { ui: { label: "Title", order: 1, primary: true } } },
+    subtitle: { type: "string", required: false, description: "Under the title: a date range, a place, a dedication.", meta: { ui: { label: "Subtitle", order: 2 } } },
+    photos: {
+        type: "media[]",
+        required: false,
+        description: "The pictures, in order. Leave empty to lay the film out with generated stand-in pages and drop real ones in later.",
+        meta: { control: { accept: ["image"], picker: "folder", multiple: true }, ui: { label: "Photos", order: 3, primary: true } },
+    },
+    notes: {
+        type: "string[]",
+        required: false,
+        description: "One line per picture, in the same order. A blank entry leaves that page wordless.",
+        meta: { ui: { label: "Notes", order: 4, primary: true } },
+    },
+    closing: { type: "string", required: false, description: "The last thing on screen.", meta: { ui: { label: "Closing line", order: 5 } } },
+    music: {
+        type: "media",
+        required: false,
+        description: "Optional music bed under the whole film.",
+        meta: { control: { accept: ["audio"], placeholder: "no music" }, ui: { label: "Music", order: 6 } },
+    },
+    perPageMs: { type: "number", required: false, description: "How long each page holds (ms).", meta: { constraints: { min: 800, max: 20000 }, ui: { label: "Per page" } } },
+    introMs: { type: "number", required: false, description: "The opening card (ms).", meta: { constraints: { min: 0, max: 15000 }, ui: { label: "Opening" } } },
+    outroMs: { type: "number", required: false, description: "The closing card (ms).", meta: { constraints: { min: 0, max: 15000 }, ui: { label: "Closing" } } },
+    xfadeMs: { type: "number", required: false, description: "Cross-fade between pages (ms) — the page turn.", meta: { constraints: { min: 0, max: 3000 }, ui: { label: "Page turn" } } },
+    drift: { type: "number", required: false, description: "How far each picture drifts while it holds. 0 = perfectly still.", meta: { constraints: { min: 0, max: 1 }, ui: { label: "Drift" } } },
+    tilt: { type: "number", required: false, description: "How far off square a picture is pinned, in degrees.", meta: { constraints: { min: 0, max: 8 }, ui: { label: "Tilt" } } },
+    paperColor: { type: "string", required: false, description: "The paper the scrapbook is made of.", meta: { ui: { label: "Paper" }, constraints: { isColor: true }, control: { colorPicker: true } } },
+    inkColor: { type: "string", required: false, description: "The pen.", meta: { ui: { label: "Ink" }, constraints: { isColor: true }, control: { colorPicker: true } } },
+    accentColor: { type: "string", required: false, description: "The one colour that is not paper or ink.", meta: { ui: { label: "Accent" }, constraints: { isColor: true }, control: { colorPicker: true } } },
+});
+/** Merge defaults + fail-fast validation. */
+function resolveProps(props) {
+    const given = Object.fromEntries(Object.entries(props !== null && props !== void 0 ? props : {}).filter(([, v]) => v !== undefined));
+    const v = { ...exports.DEFAULT_PROPS, ...given };
+    const errors = [];
+    const num = (name, lo, hi) => {
+        const n = v[name];
+        if (!Number.isFinite(n) || n < lo || n > hi)
+            errors.push(`${String(name)} must be ${lo}..${hi} (got ${String(n)})`);
+    };
+    num("perPageMs", 800, 20000);
+    num("introMs", 0, 15000);
+    num("outroMs", 0, 15000);
+    num("xfadeMs", 0, 3000);
+    num("drift", 0, 1);
+    num("tilt", 0, 8);
+    if (!Array.isArray(v.photos))
+        errors.push("photos must be a list");
+    if (!Array.isArray(v.notes))
+        errors.push("notes must be a list");
+    for (const c of ["paperColor", "inkColor", "accentColor"]) {
+        if (!/^#[0-9a-fA-F]{6}$/.test(v[c]))
+            errors.push(`${c} must be #rrggbb (got "${v[c]}")`);
+    }
+    return errors.length ? { ok: false, errors } : { ok: true, value: v };
+}

package/dist/m0saic/story/scrapbook/v1/scrapbook.d.ts

@@ -0,0 +1,23 @@
+import { type ScrapbookProps } from "./props";
+/**
+ * `@m0saic/story/scrapbook/v1` — a short personal film.
+ *
+ * A handful of pictures, each with a line in the author's own words, laid
+ * down like the pages of a scrapbook: pinned slightly askew on paper,
+ * drifting gently, handing over with soft cross-fades, optionally over
+ * music. Warm and unhurried.
+ *
+ * The content arrives later on purpose. With no photos it lays out
+ * generated stand-in pages, so the pacing, the tilt, the drift and the
+ * words can all be judged before a single real picture exists — then real
+ * files replace the stand-ins one for one.
+ *
+ * It renders as a PIPELINE — a step per page, the same cost whatever the
+ * length. A single-document form (which would keep its geometry and could
+ * BE a Community M piece) is written and tested in `document.ts` but is NOT
+ * offered: it is blocked on an engine defect. See that file.
+ *
+ * See `props.ts` for the contract this keeps.
+ */
+export declare const ScrapbookV1: import("@m0saic/types").MosaicTemplate<ScrapbookProps, import("@m0saic/types").MosaicTemplateOutputs, import("@m0saic/types").MosaicTemplateUpstreamVariables, import("@m0saic/types").MosaicTemplateUpstreamData, import("@m0saic/types").MosaicTemplateSidecars>;
+export default ScrapbookV1;

package/dist/m0saic/story/scrapbook/v1/scrapbook.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScrapbookV1 = void 0;
+const types_1 = require("@m0saic/types");
+const template_utils_1 = require("@m0saic/template-utils");
+const pages_1 = require("./pages");
+const pipeline_1 = require("./pipeline");
+const props_1 = require("./props");
+/**
+ * `@m0saic/story/scrapbook/v1` — a short personal film.
+ *
+ * A handful of pictures, each with a line in the author's own words, laid
+ * down like the pages of a scrapbook: pinned slightly askew on paper,
+ * drifting gently, handing over with soft cross-fades, optionally over
+ * music. Warm and unhurried.
+ *
+ * The content arrives later on purpose. With no photos it lays out
+ * generated stand-in pages, so the pacing, the tilt, the drift and the
+ * words can all be judged before a single real picture exists — then real
+ * files replace the stand-ins one for one.
+ *
+ * It renders as a PIPELINE — a step per page, the same cost whatever the
+ * length. A single-document form (which would keep its geometry and could
+ * BE a Community M piece) is written and tested in `document.ts` but is NOT
+ * offered: it is blocked on an engine defect. See that file.
+ *
+ * See `props.ts` for the contract this keeps.
+ */
+exports.ScrapbookV1 = (0, template_utils_1.defineMosaicTemplate)({
+    id: (0, types_1.asTemplateId)("@m0saic/story/scrapbook/v1"),
+    label: "Scrapbook",
+    version: 1,
+    description: "A short personal film: a few pictures, a line each, pinned askew on paper and drifting past to music. Lays itself out with stand-in pages until your own photos arrive.",
+    capabilities: { tier: "core" },
+    tags: ["story", "personal", "photos", "animated", "creators", "social", "memories", "photo-album"],
+    outputHints: {
+        width: 1920,
+        height: 1080,
+        fps: 30,
+        durationMs: (0, pipeline_1.naturalDurationMs)(props_1.DEFAULT_PROPS, pages_1.STAND_IN_PAGES),
+        note: "Length follows the page count: opening + per-page × pictures + closing.",
+        format: { kind: "video", container: "mp4" },
+    },
+    propsSchema: props_1.propsSchema,
+    defaultProps: props_1.DEFAULT_PROPS,
+    render(props, ctx) {
+        const width = ctx.output.width;
+        const height = ctx.output.height;
+        const fps = ctx.target.fps;
+        const fail = (title, message) => Promise.resolve((0, template_utils_1.makeErrorMosaic)(message, { title: `${this.id} ${title}`, width, height }));
+        const rp = (0, props_1.resolveProps)(props);
+        if (!rp.ok)
+            return fail("props", rp.errors.join(" | "));
+        const p = rp.value;
+        if (Math.min(width, height) < 320)
+            return fail("canvas", `canvas too small: the short side must be at least 320 px (got ${width}×${height})`);
+        const pages = (0, pages_1.resolvePages)(p);
+        if (pages.length === 0)
+            return fail("pages", "no pages to show");
+        // A pinned length re-paces the film rather than cutting it off: the
+        // pages share whatever is left after the two cards.
+        const pinned = (0, template_utils_1.resolvePinnedDurationMs)(ctx);
+        const paced = { ...p };
+        if (pinned !== undefined) {
+            const forPages = Math.round(pinned) - Math.round(p.introMs) - Math.round(p.outroMs);
+            const perPage = Math.floor(forPages / pages.length);
+            if (perPage < 400)
+                return fail("duration", `pinned duration ${Math.round(pinned)} ms leaves under 400 ms a page for ${pages.length} pages`);
+            paced.perPageMs = perPage;
+            // Absorb the rounding into the closing card so the total is exact.
+            paced.outroMs = Math.round(pinned) - Math.round(p.introMs) - perPage * pages.length;
+        }
+        return Promise.resolve((0, pipeline_1.buildScrapbookPipeline)({ width, height, fps, props: paced, pages }));
+    },
+});
+(0, template_utils_1.registerTemplate)(exports.ScrapbookV1);
+exports.default = exports.ScrapbookV1;

package/dist/m0saic/theming/index.d.ts

@@ -0,0 +1 @@
+export * from "./v1";

package/dist/m0saic/theming/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./v1"), exports);

package/dist/m0saic/theming/v1/brand-m-glyph.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The m0saic brand 'M' mark as a single-colour SVG silhouette, sourced from the
+ * canonical asset `apps/mosaic/assets/brand/mosaic-m.svg` (33 mosaic
+ * tiles combined into one mask path). TODO: hoist to a shared brand-glyph module.
+ */
+export declare const BRAND_M_GLYPH: {
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    path: string;
+};

package/dist/m0saic/theming/v1/brand-m-glyph.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BRAND_M_GLYPH = void 0;
+/**
+ * The m0saic brand 'M' mark as a single-colour SVG silhouette, sourced from the
+ * canonical asset `apps/mosaic/assets/brand/mosaic-m.svg` (33 mosaic
+ * tiles combined into one mask path). TODO: hoist to a shared brand-glyph module.
+ */
+exports.BRAND_M_GLYPH = {
+    bounds: { x: 0, y: 0, width: 272, height: 272 },
+    path: "M19.7296 0.010376H0.0599976V48.117H19.7296V0.010376Z M34.9327 55.9604H0V104.067H34.9327V55.9604Z M62.2438 111.931H34.9327V160.038H62.2438V111.931Z M27.3212 111.931H0V160.038H27.3212V111.931Z M34.9327 167.912H0V216.019H34.9327V167.912Z M62.1336 223.893H27.3712V272H62.1336V223.893Z M19.7197 223.893H0.0100098V272H19.7197V223.893Z M131.799 111.931H103.496V160.038H131.799V111.931Z M174.503 56.0122L163.737 55.9915L139.49 89.6651V104.088L174.503 104.119V56.0122Z M118.248 104.067H131.799V89.52L107.582 55.9604H69.675V104.067H115.614H118.248Z M91.3477 33.9223L69.675 3.38805V48.1067H101.924L91.3477 33.9223Z M180.422 32.8758L169.886 48.1067H180.051H181.574H201.754V3.34662L180.422 32.9172V32.8758Z M139.49 160.069H165.81L200.512 111.962H139.49V160.069Z M95.8845 148.278L95.8946 111.931H69.675L95.8845 148.278Z M135.054 202.612L160.151 167.912L110.036 167.902L135.054 202.612Z M62.1738 55.9604H42.5742V75.6776H62.1738V55.9604Z M62.1738 83.5313H42.5742V104.057H62.1738V83.5313Z M182.185 104.088L201.714 104.067V55.9604L182.185 55.9915V104.088Z M62.1837 0.010376H27.3312V48.117H62.1837V0.010376Z M62.0736 167.912H42.5141V187.629H62.0736V167.912Z M62.0736 195.494H42.5141V216.019H62.0736V195.494Z M271.95 223.883H252.28V271.99H271.95V223.883Z M272 167.933H237.067V216.04H272V167.933Z M237.067 111.952H209.756V160.059H237.067V111.952Z M272 111.952H244.679V160.059H272V111.952Z M272 55.9707H237.067V104.077H272V55.9707Z M244.629 0H209.866V48.1067H244.629V0Z M271.99 0H252.28V48.1067H271.99V0Z M229.426 196.322H209.826V216.04H229.426V196.322Z M229.426 167.933H209.826V188.458H229.426V167.933Z M244.679 223.883H209.826V271.99H244.679V223.883Z M229.486 84.3602H209.926V104.077H229.486V84.3602Z M229.486 55.9707H209.926V76.4961H229.486V55.9707Z",
+};

package/dist/m0saic/theming/v1/index.d.ts

@@ -0,0 +1,2 @@
+export { Theming, default } from "./theming";
+export { M0SAIC_BRAND, THEME_PRESETS, THEME_MODES, DEFAULT_THEME_MODE, DEFAULT_THEME_PRESET, resolveTheme, type ThemeTokens, type ThemeMode, type ThemePreset, type M0saicBrand, } from "./theme-tokens";

package/dist/m0saic/theming/v1/index.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTheme = exports.DEFAULT_THEME_PRESET = exports.DEFAULT_THEME_MODE = exports.THEME_MODES = exports.THEME_PRESETS = exports.M0SAIC_BRAND = exports.default = exports.Theming = void 0;
+var theming_1 = require("./theming");
+Object.defineProperty(exports, "Theming", { enumerable: true, get: function () { return theming_1.Theming; } });
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(theming_1).default; } });
+var theme_tokens_1 = require("./theme-tokens");
+Object.defineProperty(exports, "M0SAIC_BRAND", { enumerable: true, get: function () { return theme_tokens_1.M0SAIC_BRAND; } });
+Object.defineProperty(exports, "THEME_PRESETS", { enumerable: true, get: function () { return theme_tokens_1.THEME_PRESETS; } });
+Object.defineProperty(exports, "THEME_MODES", { enumerable: true, get: function () { return theme_tokens_1.THEME_MODES; } });
+Object.defineProperty(exports, "DEFAULT_THEME_MODE", { enumerable: true, get: function () { return theme_tokens_1.DEFAULT_THEME_MODE; } });
+Object.defineProperty(exports, "DEFAULT_THEME_PRESET", { enumerable: true, get: function () { return theme_tokens_1.DEFAULT_THEME_PRESET; } });
+Object.defineProperty(exports, "resolveTheme", { enumerable: true, get: function () { return theme_tokens_1.resolveTheme; } });