@m0saic/templates 0.2.0

package/dist/m0saic/hero/ffmpeg-pulse/contributions/v1/contributions.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ============================================================================
+ * @m0saic/hero/ffmpeg-pulse/contributions/v1 — Weekly Pulse · Contributions (Beat 5)
+ * ============================================================================
+ *
+ * The SAME chrome as the other beats (BEAT chip top-left, FFmpeg logo in line with
+ * the title, subtitle, footer, baked scatter, bg-first timing) wrapping a
+ * GitHub-style contribution heatmap (nested @m0saic/alpine/heatmap — 7 weekday rows ×
+ * N week columns, green intensity scale) on the left + a rail of aggregate activity
+ * stat tiles (nested @m0saic/alpine/stat-card) on the right.
+ *
+ * Driven by `pulse.activity.grid` (trailing N-week commits-by-day matrix) + reuses
+ * `pulse.activity.rail`. The heatmap self-surfaces theme.card, so a theme.card
+ * backdrop at ±pad behind it keeps the panel edges aligned (cohesive).
+ * Aspect-adaptive; deterministic; reduceMotion → static.
+ * ============================================================================
+ */
+import type { MosaicTemplate } from "@m0saic/types";
+import { type PulsePreset } from "../../_shared/pulse-theme";
+import { type WeeklyPulse } from "../../_shared/pulse-data";
+type AnimConfig = {
+    introFrac: number;
+    reduceMotion: boolean;
+};
+type ContributionsProps = {
+    pulse: WeeklyPulse;
+    eyebrow?: string;
+    headline?: string;
+    subtitle?: string;
+    preset?: PulsePreset;
+    renderMode?: "premium" | "light";
+    anim?: AnimConfig;
+    animate?: boolean;
+    debugLayout?: boolean;
+};
+export declare const FfmpegPulseContributions: MosaicTemplate<ContributionsProps>;
+export {};

package/dist/m0saic/hero/ffmpeg-pulse/contributions/v1/contributions.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FfmpegPulseContributions = void 0;
+const types_1 = require("@m0saic/types");
+const template_utils_1 = require("@m0saic/template-utils");
+const alpine_card_1 = require("../../../../alpine/_shared/alpine-card");
+const pulse_chrome_1 = require("../../_shared/pulse-chrome");
+const pulse_theme_1 = require("../../_shared/pulse-theme");
+const pulse_data_1 = require("../../_shared/pulse-data");
+const pulse_glyphs_1 = require("../../_shared/pulse-glyphs");
+const DEFAULT_PRESET = "dark";
+const DEFAULT_ANIM = { introFrac: 0.7, reduceMotion: false };
+const GEOM = {
+    desktop: { nativeW: 1920, nativeH: 1080, margin: 140,
+        beat: { x: 140, y: 66, w: 128, h: 42 }, logo: { x: 140, y: 138, w: 116, h: 116 }, title: { x: 276, y: 150, w: 980, h: 92 }, subtitle: { x: 142, y: 282, w: 760, h: 34 },
+        footer: { x: 140, y: 1006, w: 560, h: 50 }, heat: { x: 140, y: 384, w: 980, h: 600 }, rail: { x0: 1160, y0: 384, cols: 2, cw: 290, ch: 288, gx: 20, gy: 24 } },
+    square: { nativeW: 1080, nativeH: 1080, margin: 170,
+        beat: { x: 170, y: 40, w: 120, h: 38 }, logo: { x: 170, y: 104, w: 92, h: 92 }, title: { x: 282, y: 120, w: 628, h: 60 }, subtitle: { x: 172, y: 202, w: 720, h: 30 },
+        footer: { x: 170, y: 1026, w: 420, h: 34 }, heat: { x: 170, y: 252, w: 740, h: 380 },
+        rail: { x0: 170, y0: 652, cols: 2, cw: 360, ch: 178, gx: 20, gy: 16 } },
+    mobile: { nativeW: 1080, nativeH: 1920, margin: 80,
+        beat: { x: 80, y: 110, w: 150, h: 46 }, logo: { x: 80, y: 196, w: 130, h: 130 }, title: { x: 230, y: 228, w: 760, h: 74 }, subtitle: { x: 82, y: 332, w: 760, h: 38 },
+        footer: { x: 80, y: 1800, w: 640, h: 56 }, heat: { x: 80, y: 430, w: 920, h: 740 },
+        rail: { x0: 80, y0: 1200, cols: 2, cw: 448, ch: 290, gx: 24, gy: 16 } },
+};
+// activity rail KPI key → glyph key.
+const RAIL_GLYPH = { totalCommits: "commits", peakDay: "stars", dailyAvg: "commits", activeDays: "contributors", contributors: "contributors", additions: "additions", deletions: "deletions" };
+const propsSchema = (0, template_utils_1.definePropsSchema)({
+    pulse: { type: "group", required: false, description: "Weekly Pulse data sheet (activity.grid drives the heatmap, activity.rail the tiles).", meta: { ui: { label: "Pulse data", order: 1, consumer: "agent" } } },
+    eyebrow: { type: "string", required: false, description: "Beat chip label.", meta: { control: { placeholder: "BEAT 5" }, ui: { label: "Eyebrow", order: 1 } } },
+    headline: { type: "string", required: false, description: "Beat title.", meta: { control: { placeholder: "CONTRIBUTIONS" }, ui: { label: "Headline", order: 2 } } },
+    subtitle: { type: "string", required: false, description: "One-line beat subtitle.", meta: { ui: { label: "Subtitle", order: 3 } } },
+    preset: { type: "string", required: false, description: "Pulse theme variant.", meta: { constraints: { oneOf: ["dark"] }, ui: { label: "Preset", order: 10 } } },
+    renderMode: { type: "string", required: false, description: "Render weight for this beat's nested charts/cards. \"premium\" (default): alpha-fade reveals — the softer look; the engine's enable-gating makes the per-pixel geq nearly free. \"light\": geq-free enable-gate pops — cheapest, most composable when nested many-deep. Set by the runner.", meta: { constraints: { oneOf: ["light", "premium"] }, ui: { label: "Render mode", order: 11 } } },
+    anim: { type: "group", required: false, description: "Intro: introFrac, reduceMotion.", meta: { ui: { label: "Animation", collapsedByDefault: true, consumer: "agent" } } },
+    animate: { type: "boolean", required: false, description: "Animate the heatmap cascade + content fade.", meta: { ui: { label: "Animate", consumer: "human", order: 1 }, control: { syncsTo: [{ prop: "anim.reduceMotion", map: { kind: "boolInvert" } }] } } },
+    debugLayout: { type: "boolean", required: false, description: "Dev-only layout contract: assert the shared chrome (header cluster top-band, footer bottom-band) + this beat's content/rail panels hold their canvas-fraction zones at any resolution/aspect; on violation render a LAYOUT_CONTRACT error mosaic + stamp editor.layoutContract. Default false; production never sets it. Swept by audit:layout-envelope.", meta: { ui: { label: "Debug layout", order: 20, collapsedByDefault: true } } },
+});
+exports.FfmpegPulseContributions = {
+    id: (0, types_1.asTemplateId)("@m0saic/hero/ffmpeg-pulse/contributions/v1"),
+    label: "Weekly Pulse · Contributions",
+    version: 1,
+    description: "FFmpeg Weekly Pulse — Contributions beat (Beat 5). The shared beat chrome wrapping a GitHub-style contribution heatmap (commits by weekday × trailing weeks) + a rail of aggregate activity stat tiles. Aspect-adaptive.",
+    capabilities: { tier: "core" },
+    internal: true,
+    tags: ["hero", "ffmpeg-pulse", "contributions", "heatmap", "beat"],
+    outputHints: { width: 1920, height: 1080, fps: 30, durationMs: 9000 },
+    upstreamDataSchema: pulse_data_1.WEEKLY_PULSE_UPSTREAM_SCHEMA,
+    propsSchema,
+    defaultProps: {
+        debugLayout: false,
+        pulse: pulse_data_1.MOCK_FFMPEG_PULSE,
+        eyebrow: "BEAT 5",
+        headline: "CONTRIBUTIONS",
+        subtitle: "Commits by day · last 8 weeks.",
+        preset: DEFAULT_PRESET,
+        renderMode: "premium",
+        anim: DEFAULT_ANIM,
+    },
+    async render(props, ctx) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        const W = Math.max(1, Math.round(ctx.target.width));
+        const H = Math.max(1, Math.round(ctx.target.height));
+        const theme = (0, pulse_theme_1.pulseTheme)((_a = props.preset) !== null && _a !== void 0 ? _a : DEFAULT_PRESET);
+        const pulse = (0, pulse_data_1.resolvePulse)(props.pulse, ctx);
+        const anim = { ...DEFAULT_ANIM, ...((_b = props.anim) !== null && _b !== void 0 ? _b : {}) };
+        const reduceMotion = anim.reduceMotion;
+        const renderMode = props.renderMode === "light" ? "light" : "premium";
+        const durationMs = (_c = ctx.target.durationMs) !== null && _c !== void 0 ? _c : 9000;
+        const variant = (0, pulse_chrome_1.classify)(W, H);
+        const gm = GEOM[variant];
+        const sx = W / gm.nativeW, sy = H / gm.nativeH;
+        const scale = (r) => ({ x: Math.round(r.x * sx), y: Math.round(r.y * sy), w: Math.round(r.w * sx), h: Math.round(r.h * sy) });
+        const grid = (_d = pulse.activity) === null || _d === void 0 ? void 0 : _d.grid;
+        if (!((_e = grid === null || grid === void 0 ? void 0 : grid.rows) === null || _e === void 0 ? void 0 : _e.length))
+            return (0, template_utils_1.makeErrorMosaic)("contributions: pulse has no activity.grid", { title: `${this.id}`, width: W, height: H });
+        // Rail tiles (aggregate activity KPIs, first 4 of pulse.activity.rail).
+        const railData = ((_g = (_f = pulse.activity) === null || _f === void 0 ? void 0 : _f.rail) !== null && _g !== void 0 ? _g : []).slice(0, 4).map((k) => {
+            var _a, _b, _c;
+            return ({
+                label: k.label, value: (0, pulse_data_1.kpiValue)(k), delta: (0, pulse_data_1.kpiDelta)(k), direction: (_a = k.direction) !== null && _a !== void 0 ? _a : "flat", sublabel: (_b = k.sublabel) !== null && _b !== void 0 ? _b : "vs last week", iconKey: (_c = RAIL_GLYPH[k.key]) !== null && _c !== void 0 ? _c : "commits",
+            });
+        });
+        // ── Rail cells (row-major) ──
+        const rg = gm.rail;
+        const railCells = railData.map((_, i) => {
+            const row = Math.floor(i / rg.cols), col = i % rg.cols;
+            return scale({ x: rg.x0 + col * (rg.cw + rg.gx), y: rg.y0 + row * (rg.ch + rg.gy), w: rg.cw, h: rg.ch });
+        });
+        // Every nested child renders at the CELL its inset will produce (exact fit
+        // for an absolutely-laid-out child at any canvas) — nudged so that cell is
+        // 5-smooth and hands the child no rough factor (insetSlot, pulse-chrome).
+        const railSlots = railCells.map((r) => (0, pulse_chrome_1.insetSlot)(r, W, H));
+        railCells.forEach((_, i) => { railCells[i] = railSlots[i].rect; });
+        const heatRSlot = (0, pulse_chrome_1.insetSlot)(scale(gm.heat), W, H);
+        const heatR = heatRSlot.rect;
+        // ── Nested panels: the heatmap + the rail stat cards ──
+        const introMs = reduceMotion ? 0 : Math.max(500, Math.round(durationMs * anim.introFrac));
+        const heatChild = await (0, template_utils_1.renderNestedTemplate)("@m0saic/alpine/heatmap/v1", {
+            rows: grid.rows, colLabels: grid.weekLabels, title: "", subtitle: "",
+            preset: "dark", color: theme.primaryBright, levels: 5, showLegend: true, showValues: false,
+            anim: { introFrac: anim.introFrac, easing: "easeOut", reduceMotion, renderMode }, // runner-controlled render weight (light = geq-free heatmap cascade; premium = alpha fade)
+        }, ctx, { slot: { width: heatRSlot.slot.width, height: heatRSlot.slot.height, durationMs } });
+        const railChildren = await Promise.all(railData.map((r, i) => {
+            var _a, _b, _c;
+            return (0, template_utils_1.renderNestedTemplate)("@m0saic/alpine/stat-card/v1", {
+                label: r.label, value: r.value, delta: (_a = r.delta) !== null && _a !== void 0 ? _a : "", direction: (_b = r.direction) !== null && _b !== void 0 ? _b : "flat", sublabel: (_c = r.sublabel) !== null && _c !== void 0 ? _c : "",
+                accent: theme.primaryBright, iconPath: r.iconKey ? pulse_glyphs_1.KPI_GLYPHS[r.iconKey] : undefined,
+                renderMode, // runner-controlled render weight (light = geq-free; premium = alpha-fade)
+                preset: "dark", // hero keeps its dark KPI look (stat-card now light by default)
+                backgroundColor: theme.card,
+                anim: { countUp: !reduceMotion, fade: false, introMs, reduceMotion },
+            }, ctx, { slot: { width: railSlots[i].slot.width, height: railSlots[i].slot.height, durationMs } });
+        }));
+        // ── Intro timing + content cascade (shared chrome) ──
+        const t = (0, pulse_chrome_1.pulseTiming)(durationMs, reduceMotion);
+        const { bgFinishT, chromeFadeDur, cardStagger, cardsStart, animOn } = t;
+        const children = { heat: heatChild };
+        const heatNode = (0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)({ type: "mosaic", ref: "heat" }), bgFinishT, chromeFadeDur, animOn), heatR, W, H);
+        const railNodes = railChildren.map((c, i) => {
+            const ref = `rail${i}`;
+            children[ref] = c;
+            return (0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)({ type: "mosaic", ref }), cardsStart + i * cardStagger, cardStagger, animOn), railCells[i], W, H);
+        });
+        // ── Header cluster + footer (shared chrome) ──
+        const beatR = scale(gm.beat), logoR = scale(gm.logo), titleR = scale(gm.title), subR = scale(gm.subtitle), footR = scale(gm.footer);
+        const footText = `WEEK ${(_j = (_h = pulse.period) === null || _h === void 0 ? void 0 : _h.weekNumber) !== null && _j !== void 0 ? _j : ""} · ${(0, pulse_data_1.periodLabel)(pulse.period)}`.trim();
+        const header = (0, pulse_chrome_1.buildHeader)({ beat: beatR, logo: logoR, title: titleR, subtitle: subR }, theme, { eyebrow: (_k = props.eyebrow) !== null && _k !== void 0 ? _k : "BEAT 5", title: (_l = props.headline) !== null && _l !== void 0 ? _l : "CONTRIBUTIONS", subtitle: (_m = props.subtitle) !== null && _m !== void 0 ? _m : "Commits by day · last 8 weeks.", bind: { eyebrow: "eyebrow", title: "headline", subtitle: "subtitle" } }, t, W, H);
+        const footNode = (0, pulse_chrome_1.buildFooter)(footR, theme, footText, t, W, H);
+        // ── Backdrop panels (all theme.card with the same ±pad inset → aligned edges).
+        //    The heatmap self-surfaces theme.card, so its ±pad backdrop blends seamlessly. ──
+        const M = Math.round(gm.margin * sx);
+        const pad = Math.round(Math.min(W, H) * 0.018);
+        const panelX = Math.max(0, M - pad), panelRight = Math.min(W, W - M + pad);
+        const railBbox = (0, pulse_chrome_1.unionRect)(railCells, 0, W, H);
+        const heatBg = (0, pulse_chrome_1.labelNode)((0, pulse_chrome_1.backdrop)(theme.card, { x: heatR.x - pad, y: heatR.y - pad, w: heatR.w + 2 * pad, h: heatR.h + 2 * pad }, W, H, bgFinishT, chromeFadeDur, animOn), "content-panel");
+        const headerBg = (0, pulse_chrome_1.backdrop)(theme.card, { x: panelX, y: Math.max(0, header.bbox.y - pad), w: panelRight - panelX, h: header.bbox.h + 2 * pad }, W, H, bgFinishT, chromeFadeDur, animOn);
+        const railBg = (0, pulse_chrome_1.labelNode)((0, pulse_chrome_1.backdrop)(theme.card, { x: railBbox.x - pad, y: railBbox.y - pad, w: railBbox.w + 2 * pad, h: railBbox.h + 2 * pad }, W, H, bgFinishT, chromeFadeDur, animOn), "rail-panel");
+        const footBg = (0, pulse_chrome_1.backdrop)(theme.card, { x: panelX, y: footR.y - pad, w: footR.w + 2 * pad, h: footR.h + 2 * pad }, W, H, bgFinishT, chromeFadeDur, animOn);
+        const root = (0, alpine_card_1.overlay)([(0, pulse_chrome_1.scatterNode)(), heatBg, railBg, headerBg, footBg, ...header.nodes, footNode, heatNode, ...railNodes]);
+        const doc = {
+            kind: "mosaic_document",
+            version: 1,
+            assets: { ...(0, pulse_chrome_1.chromeAssets)(variant) },
+            m0: root.m0,
+            sources: root.sources,
+            children,
+            backgroundColor: theme.canvas,
+            fps: ctx.target.fps,
+            durationMs,
+            size: { width: W, height: H },
+        };
+        // Layout contract (dev tripwire; flatten:false → judge only this beat's own
+        // top-level chrome + content/rail panels, not the nested heatmap/cards).
+        const constraints = [...pulse_chrome_1.PULSE_CHROME_CONSTRAINTS, ...pulse_chrome_1.PULSE_CONTENT_CONSTRAINTS];
+        return (0, template_utils_1.withLayoutContract)(doc, ctx, { templateId: "@m0saic/hero/ffmpeg-pulse/contributions/v1", constraints, flatten: false, debug: props.debugLayout === true });
+    },
+};
+(0, template_utils_1.registerTemplate)(exports.FfmpegPulseContributions);

package/dist/m0saic/hero/ffmpeg-pulse/contributions/v1/index.d.ts

@@ -0,0 +1 @@
+export { FfmpegPulseContributions } from "./contributions";

package/dist/m0saic/hero/ffmpeg-pulse/contributions/v1/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FfmpegPulseContributions = void 0;
+var contributions_1 = require("./contributions");
+Object.defineProperty(exports, "FfmpegPulseContributions", { enumerable: true, get: function () { return contributions_1.FfmpegPulseContributions; } });

package/dist/m0saic/hero/ffmpeg-pulse/fin/v1/fin.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ============================================================================
+ * @m0saic/hero/ffmpeg-pulse/fin/v1 — Weekly Pulse · Fin (closing card)
+ * ============================================================================
+ *
+ * The closing beat: a big centered headline + subhead, a KPI strip of the week's
+ * signature numbers (nested @m0saic/alpine/stat-card), and a QR to the full report
+ * (nested @m0saic/media/qr/basic) with a caption — over the signature scatter, with a
+ * "Built with m0saic" footer. Driven by `pulse.fin`. Aspect-adaptive (desktop 1×4
+ * strip, square/mobile 2×2). Deterministic; reduceMotion → static.
+ * ============================================================================
+ */
+import type { MosaicTemplate } from "@m0saic/types";
+import { type PulsePreset } from "../../_shared/pulse-theme";
+import { type WeeklyPulse } from "../../_shared/pulse-data";
+type AnimConfig = {
+    introFrac: number;
+    reduceMotion: boolean;
+};
+type FinProps = {
+    pulse: WeeklyPulse;
+    headline?: string;
+    subhead?: string;
+    preset?: PulsePreset;
+    renderMode?: "premium" | "light";
+    anim?: AnimConfig;
+    animate?: boolean;
+    debugLayout?: boolean;
+};
+export declare const FfmpegPulseFin: MosaicTemplate<FinProps>;
+export {};

package/dist/m0saic/hero/ffmpeg-pulse/fin/v1/fin.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FfmpegPulseFin = void 0;
+const types_1 = require("@m0saic/types");
+const template_utils_1 = require("@m0saic/template-utils");
+const alpine_card_1 = require("../../../../alpine/_shared/alpine-card");
+const pulse_chrome_1 = require("../../_shared/pulse-chrome");
+const pulse_theme_1 = require("../../_shared/pulse-theme");
+const pulse_data_1 = require("../../_shared/pulse-data");
+const pulse_glyphs_1 = require("../../_shared/pulse-glyphs");
+const DEFAULT_PRESET = "dark";
+const DEFAULT_ANIM = { introFrac: 0.7, reduceMotion: false };
+const GEOM = {
+    desktop: { nativeW: 1920, nativeH: 1080, margin: 140,
+        headline: { x: 160, y: 168, w: 1600, h: 150 }, subhead: { x: 160, y: 338, w: 1600, h: 54 },
+        strip: { x0: 348, y0: 452, cols: 4, cw: 288, ch: 240, gx: 24, gy: 0 },
+        qr: { x: 870, y: 736, w: 180, h: 180 }, caption: { x: 560, y: 930, w: 800, h: 38 }, footer: { x: 140, y: 1006, w: 640, h: 50 } },
+    square: { nativeW: 1080, nativeH: 1080, margin: 110,
+        headline: { x: 80, y: 110, w: 920, h: 120 }, subhead: { x: 80, y: 248, w: 920, h: 46 },
+        strip: { x0: 120, y0: 344, cols: 2, cw: 400, ch: 180, gx: 40, gy: 22 },
+        qr: { x: 450, y: 786, w: 178, h: 178 }, caption: { x: 140, y: 984, w: 800, h: 34 }, footer: { x: 110, y: 1030, w: 540, h: 32 } },
+    mobile: { nativeW: 1080, nativeH: 1920, margin: 80,
+        headline: { x: 60, y: 230, w: 960, h: 150 }, subhead: { x: 60, y: 404, w: 960, h: 54 },
+        strip: { x0: 80, y0: 540, cols: 2, cw: 448, ch: 300, gx: 24, gy: 24 },
+        qr: { x: 400, y: 1300, w: 280, h: 280 }, caption: { x: 100, y: 1606, w: 880, h: 46 }, footer: { x: 80, y: 1800, w: 640, h: 56 } },
+};
+const STRIP_GLYPH = { commits: "commits", contributors: "contributors", filesChanged: "additions", additions: "additions", deletions: "deletions", stars: "stars", mergedPrs: "mergedPrs", pullRequests: "pullRequests" };
+const propsSchema = (0, template_utils_1.definePropsSchema)({
+    pulse: { type: "group", required: false, description: "Weekly Pulse data sheet (fin drives the headline, KPI strip + QR).", meta: { ui: { label: "Pulse data", order: 1, consumer: "agent" } } },
+    headline: { type: "string", required: false, description: "Closing headline.", meta: { control: { placeholder: "THANK YOU!" }, ui: { label: "Headline", order: 1 } } },
+    subhead: { type: "string", required: false, description: "Closing subhead.", meta: { ui: { label: "Subhead", order: 2 } } },
+    preset: { type: "string", required: false, description: "Pulse theme variant.", meta: { constraints: { oneOf: ["dark"] }, ui: { label: "Preset", order: 10 } } },
+    renderMode: { type: "string", required: false, description: "Render weight for this beat's nested cards. \"premium\" (default): alpha-fade reveals — the softer look; the engine's enable-gating makes the per-pixel geq nearly free. \"light\": geq-free enable-gate pops — cheapest, most composable when nested many-deep. Set by the runner.", meta: { constraints: { oneOf: ["light", "premium"] }, ui: { label: "Render mode", order: 11 } } },
+    anim: { type: "group", required: false, description: "Intro: introFrac, reduceMotion.", meta: { ui: { label: "Animation", collapsedByDefault: true, consumer: "agent" } } },
+    animate: { type: "boolean", required: false, description: "Animate the closing intro.", meta: { ui: { label: "Animate", consumer: "human", order: 1 }, control: { syncsTo: [{ prop: "anim.reduceMotion", map: { kind: "boolInvert" } }] } } },
+    debugLayout: { type: "boolean", required: false, description: "Dev-only layout contract: assert the centered content panel + the footer hold their canvas-fraction zones at any resolution/aspect; on violation render a LAYOUT_CONTRACT error mosaic + stamp editor.layoutContract. Default false; production never sets it. Swept by audit:layout-envelope.", meta: { ui: { label: "Debug layout", order: 20, collapsedByDefault: true } } },
+});
+exports.FfmpegPulseFin = {
+    id: (0, types_1.asTemplateId)("@m0saic/hero/ffmpeg-pulse/fin/v1"),
+    label: "Weekly Pulse · Fin",
+    version: 1,
+    description: "FFmpeg Weekly Pulse — Fin (closing card). Centered headline + subhead, a KPI strip of the week's signature numbers, and a QR to the full report, over the signature scatter. Aspect-adaptive.",
+    capabilities: { tier: "core" },
+    internal: true,
+    tags: ["hero", "ffmpeg-pulse", "fin", "beat"],
+    outputHints: { width: 1920, height: 1080, fps: 30, durationMs: 6000 },
+    upstreamDataSchema: pulse_data_1.WEEKLY_PULSE_UPSTREAM_SCHEMA,
+    propsSchema,
+    defaultProps: {
+        debugLayout: false,
+        pulse: pulse_data_1.MOCK_FFMPEG_PULSE,
+        headline: "THANK YOU!",
+        subhead: "ANOTHER WEEK OF PROGRESS.",
+        preset: DEFAULT_PRESET,
+        renderMode: "premium",
+        anim: DEFAULT_ANIM,
+    },
+    async render(props, ctx) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        const W = Math.max(1, Math.round(ctx.target.width));
+        const H = Math.max(1, Math.round(ctx.target.height));
+        const theme = (0, pulse_theme_1.pulseTheme)((_a = props.preset) !== null && _a !== void 0 ? _a : DEFAULT_PRESET);
+        const pulse = (0, pulse_data_1.resolvePulse)(props.pulse, ctx);
+        const anim = { ...DEFAULT_ANIM, ...((_b = props.anim) !== null && _b !== void 0 ? _b : {}) };
+        const reduceMotion = anim.reduceMotion;
+        const renderMode = props.renderMode === "light" ? "light" : "premium";
+        const durationMs = (_c = ctx.target.durationMs) !== null && _c !== void 0 ? _c : 6000;
+        const fin = pulse.fin;
+        if (!fin)
+            return (0, template_utils_1.makeErrorMosaic)("fin: pulse has no fin", { title: `${this.id}`, width: W, height: H });
+        const variant = (0, pulse_chrome_1.classify)(W, H);
+        const gm = GEOM[variant];
+        const sx = W / gm.nativeW, sy = H / gm.nativeH;
+        const scale = (r) => ({ x: Math.round(r.x * sx), y: Math.round(r.y * sy), w: Math.round(r.w * sx), h: Math.round(r.h * sy) });
+        const strip = ((_d = fin.kpiStrip) !== null && _d !== void 0 ? _d : []).slice(0, 4);
+        const rg = gm.strip;
+        const stripCells = strip.map((_, i) => {
+            const row = Math.floor(i / rg.cols), col = i % rg.cols;
+            return scale({ x: rg.x0 + col * (rg.cw + rg.gx), y: rg.y0 + row * (rg.ch + rg.gy), w: rg.cw, h: rg.ch });
+        });
+        // Every card renders at the CELL its inset will produce, nudged 5-smooth
+        // (insetSlot, pulse-chrome): exact fit, no inherited rough factor.
+        const stripSlots = stripCells.map((r) => (0, pulse_chrome_1.insetSlot)(r, W, H));
+        stripCells.forEach((_, i) => { stripCells[i] = stripSlots[i].rect; });
+        const qrR = scale(gm.qr);
+        // ── Nested: KPI strip cards + QR ──
+        const introMs = reduceMotion ? 0 : Math.max(500, Math.round(durationMs * anim.introFrac));
+        const stripChildren = await Promise.all(strip.map((k, i) => {
+            var _a;
+            return (0, template_utils_1.renderNestedTemplate)("@m0saic/alpine/stat-card/v1", {
+                label: k.label, value: (0, pulse_data_1.kpiValue)(k), delta: "", direction: "flat", sublabel: (_a = k.sublabel) !== null && _a !== void 0 ? _a : "",
+                accent: theme.primaryBright, iconPath: STRIP_GLYPH[k.key] ? pulse_glyphs_1.KPI_GLYPHS[STRIP_GLYPH[k.key]] : undefined,
+                renderMode, // runner-controlled render weight (light = geq-free; premium = alpha-fade)
+                preset: "dark", // hero keeps its dark KPI look (stat-card now light by default)
+                backgroundColor: theme.card,
+                anim: { countUp: !reduceMotion, fade: false, introMs, reduceMotion },
+            }, ctx, { slot: { width: stripSlots[i].slot.width, height: stripSlots[i].slot.height, durationMs } });
+        }));
+        // Premium QR is BAKED (chromeAssets.qrFin → qr-fin.mp4): green QR Code with the
+        // FFmpeg logo carved in + pixelate assemble, pre-rendered to a flat video. Baking
+        // keeps fin cheap — no live per-module tile generation — and the assemble is a
+        // one-shot anyway. Re-bake via tools/bake-fin-qr.sh if the URL/logo/color changes.
+        // ── Timing ──
+        const t = (0, pulse_chrome_1.pulseTiming)(durationMs, reduceMotion);
+        const { bgFinishT, chromeFadeDur, cardStagger, cardsStart, animOn } = t;
+        const children = {};
+        const stripNodes = stripChildren.map((c, i) => {
+            const ref = `kpi${i}`;
+            children[ref] = c;
+            return (0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)({ type: "mosaic", ref }), cardsStart + i * cardStagger, cardStagger, animOn), stripCells[i], W, H);
+        });
+        // Baked QR (media asset), placed at the QR rect.
+        const qrNode = (0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)({ type: "media", mediaType: "video", assetId: "qrFin", placement: { fit: "contain" } }), cardsStart + strip.length * cardStagger, chromeFadeDur, animOn), qrR, W, H);
+        // ── Headline / subhead / caption / footer ──
+        const headR = scale(gm.headline), subR = scale(gm.subhead), capR = scale(gm.caption), footR = scale(gm.footer);
+        const headline = (_f = (_e = props.headline) !== null && _e !== void 0 ? _e : fin.headline) !== null && _f !== void 0 ? _f : "THANK YOU!";
+        const subhead = (_h = (_g = props.subhead) !== null && _g !== void 0 ? _g : fin.subhead) !== null && _h !== void 0 ? _h : "";
+        const headNode = (0, pulse_chrome_1.bindNode)((0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)((0, pulse_chrome_1.text1)(headline, (0, pulse_chrome_1.capFont)(headR.h * 0.86, headline, headR.w, 24, 0.6), theme.primaryBright, "center")), bgFinishT, chromeFadeDur, animOn), headR, W, H), "headline");
+        const subNode = (0, pulse_chrome_1.bindNode)((0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)((0, pulse_chrome_1.text1)(subhead, (0, pulse_chrome_1.capFont)(subR.h * 0.78, subhead, subR.w, 12, 0.5), theme.subtitle, "center")), bgFinishT + chromeFadeDur * 0.4, chromeFadeDur, animOn), subR, W, H), "subhead");
+        const capText = (_k = (_j = fin.qr) === null || _j === void 0 ? void 0 : _j.caption) !== null && _k !== void 0 ? _k : "";
+        const capNode = (0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)((0, pulse_chrome_1.text1)(capText, (0, pulse_chrome_1.capFont)(capR.h * 0.7, capText, capR.w, 10, 0.5), theme.label, "center")), cardsStart + (strip.length + 1) * cardStagger, chromeFadeDur, animOn), capR, W, H);
+        const footNode = (0, pulse_chrome_1.buildFooter)(footR, theme, (_l = fin.footer) !== null && _l !== void 0 ? _l : "Built with m0saic", t, W, H);
+        // Subtle m0saic attribution bottom-right (visible, not overbearing — FFmpeg is the subject).
+        const wmW = Math.round(240 * sx);
+        const wmR = { x: Math.max(0, W - Math.round(gm.margin * sx) - wmW), y: footR.y, w: wmW, h: footR.h };
+        const wmNode = (0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)((0, pulse_chrome_1.text1)("m0saic.io", (0, pulse_chrome_1.capFont)(wmR.h * 0.5, "m0saic.io", wmR.w, 11, 0.5), theme.label, "right")), bgFinishT, chromeFadeDur, animOn), wmR, W, H);
+        // ── Backdrop behind the centered content (headline + strip) for legibility ──
+        const pad = Math.round(Math.min(W, H) * 0.02);
+        const stripBbox = (0, pulse_chrome_1.unionRect)(stripCells, 0, W, H);
+        const contentBbox = (0, pulse_chrome_1.unionRect)([headR, subR, stripBbox, qrR, capR], pad, W, H);
+        const bg = (0, pulse_chrome_1.labelNode)((0, pulse_chrome_1.backdrop)(theme.card, contentBbox, W, H, bgFinishT, chromeFadeDur, animOn), "content-panel");
+        const root = (0, alpine_card_1.overlay)([(0, pulse_chrome_1.scatterNode)(), bg, ...stripNodes, qrNode, headNode, subNode, capNode, footNode, wmNode]);
+        const doc = {
+            kind: "mosaic_document",
+            version: 1,
+            assets: { ...(0, pulse_chrome_1.chromeAssets)(variant) },
+            m0: root.m0,
+            sources: root.sources,
+            children,
+            backgroundColor: theme.canvas,
+            fps: ctx.target.fps,
+            durationMs,
+            size: { width: W, height: H },
+        };
+        // Layout contract (dev tripwire; flatten:false → judge only fin's own top-level
+        // content panel + footer, not the nested KPI cards). Fin has no header cluster.
+        const constraints = [
+            { label: "content-panel", within: { yFrac: [0.04, 0.98] } },
+            { label: "footer", within: { yFrac: [0.84, 1.0] } },
+        ];
+        return (0, template_utils_1.withLayoutContract)(doc, ctx, { templateId: "@m0saic/hero/ffmpeg-pulse/fin/v1", constraints, flatten: false, debug: props.debugLayout === true });
+    },
+};
+(0, template_utils_1.registerTemplate)(exports.FfmpegPulseFin);

package/dist/m0saic/hero/ffmpeg-pulse/fin/v1/index.d.ts

@@ -0,0 +1 @@
+export { FfmpegPulseFin } from "./fin";

package/dist/m0saic/hero/ffmpeg-pulse/fin/v1/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FfmpegPulseFin = void 0;
+var fin_1 = require("./fin");
+Object.defineProperty(exports, "FfmpegPulseFin", { enumerable: true, get: function () { return fin_1.FfmpegPulseFin; } });

package/dist/m0saic/hero/ffmpeg-pulse/index.d.ts

@@ -0,0 +1,10 @@
+export { FfmpegPulseTitle } from "./title/v1";
+export { FfmpegPulseScatterBake } from "./scatter-bake/v1";
+export { FfmpegPulseKpiOverview } from "./kpi-overview/v1";
+export { FfmpegPulseActivityTrend } from "./activity-trend/v1";
+export { FfmpegPulseTopContributors } from "./top-contributors/v1";
+export { FfmpegPulseChangesBreakdown } from "./changes-breakdown/v1";
+export { FfmpegPulseContributions } from "./contributions/v1";
+export { FfmpegPulseNotableCommits } from "./notable-commits/v1";
+export { FfmpegPulseFin } from "./fin/v1";
+export { FfmpegPulseRunner } from "./runner/v1";

package/dist/m0saic/hero/ffmpeg-pulse/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FfmpegPulseRunner = exports.FfmpegPulseFin = exports.FfmpegPulseNotableCommits = exports.FfmpegPulseContributions = exports.FfmpegPulseChangesBreakdown = exports.FfmpegPulseTopContributors = exports.FfmpegPulseActivityTrend = exports.FfmpegPulseKpiOverview = exports.FfmpegPulseScatterBake = exports.FfmpegPulseTitle = void 0;
+/* FFmpeg Weekly Pulse — multi-beat hero pack (beats + runner). */
+var v1_1 = require("./title/v1");
+Object.defineProperty(exports, "FfmpegPulseTitle", { enumerable: true, get: function () { return v1_1.FfmpegPulseTitle; } });
+var v1_2 = require("./scatter-bake/v1");
+Object.defineProperty(exports, "FfmpegPulseScatterBake", { enumerable: true, get: function () { return v1_2.FfmpegPulseScatterBake; } });
+var v1_3 = require("./kpi-overview/v1");
+Object.defineProperty(exports, "FfmpegPulseKpiOverview", { enumerable: true, get: function () { return v1_3.FfmpegPulseKpiOverview; } });
+var v1_4 = require("./activity-trend/v1");
+Object.defineProperty(exports, "FfmpegPulseActivityTrend", { enumerable: true, get: function () { return v1_4.FfmpegPulseActivityTrend; } });
+var v1_5 = require("./top-contributors/v1");
+Object.defineProperty(exports, "FfmpegPulseTopContributors", { enumerable: true, get: function () { return v1_5.FfmpegPulseTopContributors; } });
+var v1_6 = require("./changes-breakdown/v1");
+Object.defineProperty(exports, "FfmpegPulseChangesBreakdown", { enumerable: true, get: function () { return v1_6.FfmpegPulseChangesBreakdown; } });
+var v1_7 = require("./contributions/v1");
+Object.defineProperty(exports, "FfmpegPulseContributions", { enumerable: true, get: function () { return v1_7.FfmpegPulseContributions; } });
+var v1_8 = require("./notable-commits/v1");
+Object.defineProperty(exports, "FfmpegPulseNotableCommits", { enumerable: true, get: function () { return v1_8.FfmpegPulseNotableCommits; } });
+var v1_9 = require("./fin/v1");
+Object.defineProperty(exports, "FfmpegPulseFin", { enumerable: true, get: function () { return v1_9.FfmpegPulseFin; } });
+var v1_10 = require("./runner/v1");
+Object.defineProperty(exports, "FfmpegPulseRunner", { enumerable: true, get: function () { return v1_10.FfmpegPulseRunner; } });

package/dist/m0saic/hero/ffmpeg-pulse/kpi-overview/v1/index.d.ts

@@ -0,0 +1 @@
+export { FfmpegPulseKpiOverview } from "./kpi-overview";

package/dist/m0saic/hero/ffmpeg-pulse/kpi-overview/v1/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FfmpegPulseKpiOverview = void 0;
+var kpi_overview_1 = require("./kpi-overview");
+Object.defineProperty(exports, "FfmpegPulseKpiOverview", { enumerable: true, get: function () { return kpi_overview_1.FfmpegPulseKpiOverview; } });

package/dist/m0saic/hero/ffmpeg-pulse/kpi-overview/v1/kpi-overview.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ============================================================================
+ * @m0saic/hero/ffmpeg-pulse/kpi-overview/v1 — Weekly Pulse · KPI Overview (Beat 1)
+ * ============================================================================
+ *
+ * The metrics-at-a-glance beat: a logo-left header cluster (FFmpeg logo + "BEAT 1"
+ * chip + "KPI OVERVIEW" title + subtitle), an aspect-adaptive grid of KPI stat
+ * cards (4×2 desktop, 2×4 square/mobile), and a "WEEK N · period" footer — all
+ * over the signature baked scatter (shared with the title beat).
+ *
+ * Each KPI cell is a NESTED @m0saic/alpine/stat-card/v1 (renderNestedTemplate →
+ * its own document, referenced as a `{type:"mosaic"}` source) so the parent stays
+ * shallow and each card sizes its fonts off its own slot. The grid is driven by
+ * `pulse.kpis` (flexible count; the mock ships 8 API-derivable metrics). Geometry
+ * is the sandbox-approved candidate-002 layout, authored per aspect and scaled to
+ * the render canvas. Deterministic; `anim.reduceMotion` → static.
+ * ============================================================================
+ */
+import type { MosaicTemplate } from "@m0saic/types";
+import { type PulsePreset } from "../../_shared/pulse-theme";
+import { type WeeklyPulse } from "../../_shared/pulse-data";
+type AnimConfig = {
+    introFrac: number;
+    reduceMotion: boolean;
+};
+type KpiOverviewProps = {
+    pulse: WeeklyPulse;
+    eyebrow?: string;
+    headline?: string;
+    subtitle?: string;
+    preset?: PulsePreset;
+    renderMode?: "premium" | "light";
+    anim?: AnimConfig;
+    animate?: boolean;
+    debugLayout?: boolean;
+};
+export declare const FfmpegPulseKpiOverview: MosaicTemplate<KpiOverviewProps>;
+export {};