@m0saic/templates 0.2.0

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

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FfmpegPulseKpiOverview = 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: 640, h: 92 }, subtitle: { x: 142, y: 282, w: 640, h: 34 },
+        footer: { x: 140, y: 1006, w: 560, h: 50 }, grid: { x0: 140, y0: 380, cols: 4, cw: 386, ch: 266, gx: 32, gy: 32 } },
+    square: { nativeW: 1080, nativeH: 1080, margin: 56,
+        beat: { x: 56, y: 50, w: 120, h: 40 }, logo: { x: 56, y: 116, w: 100, h: 100 }, title: { x: 172, y: 126, w: 700, h: 82 }, subtitle: { x: 58, y: 224, w: 760, h: 32 },
+        footer: { x: 56, y: 1012, w: 460, h: 44 }, grid: { x0: 56, y0: 286, cols: 3, cw: 309, ch: 222, gx: 20, gy: 20 } },
+    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: 212, w: 700, h: 100 }, subtitle: { x: 82, y: 332, w: 760, h: 38 },
+        footer: { x: 80, y: 1800, w: 640, h: 56 }, grid: { x0: 80, y0: 430, cols: 2, cw: 446, ch: 300, gx: 28, gy: 28 } },
+};
+// Chrome helpers (text1/pill/withFade/insetSafe/backdrop/unionRect/header/footer/
+// scatter/timing) now live in ../../_shared/pulse-chrome.
+// ---------------------------------------------------------------------------
+// Template
+// ---------------------------------------------------------------------------
+const propsSchema = (0, template_utils_1.definePropsSchema)({
+    pulse: { type: "group", required: false, description: "Weekly Pulse data sheet (period + kpis drive the grid).", meta: { ui: { label: "Pulse data", order: 1, consumer: "agent" } } },
+    eyebrow: { type: "string", required: false, description: "Beat chip label.", meta: { control: { placeholder: "BEAT 1" }, ui: { label: "Eyebrow", order: 1 } } },
+    headline: { type: "string", required: false, description: "Beat title.", meta: { control: { placeholder: "KPI OVERVIEW" }, 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 (share of clip), reduceMotion.", meta: { ui: { label: "Animation", collapsedByDefault: true, consumer: "agent" } } },
+    animate: { type: "boolean", required: false, description: "Animate the cards counting up + content fading in.", 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) + the KPI grid panel 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.FfmpegPulseKpiOverview = {
+    id: (0, types_1.asTemplateId)("@m0saic/hero/ffmpeg-pulse/kpi-overview/v1"),
+    label: "Weekly Pulse · KPI Overview",
+    version: 1,
+    description: "FFmpeg Weekly Pulse — KPI Overview beat. Logo-left header cluster + an aspect-adaptive grid of KPI stat cards (4×2 desktop, 2×4 square/mobile) + WEEK/period footer, over the signature scatter. Grid driven by pulse.kpis.",
+    capabilities: { tier: "core" },
+    internal: true,
+    tags: ["hero", "ffmpeg-pulse", "kpi-overview", "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 1",
+        headline: "KPI OVERVIEW",
+        subtitle: "Key metrics at a glance for the week.",
+        preset: DEFAULT_PRESET,
+        renderMode: "premium",
+        anim: DEFAULT_ANIM,
+    },
+    async render(props, ctx) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        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 gd = gm.grid;
+        const kpis = ((_d = pulse.kpis) !== null && _d !== void 0 ? _d : []).slice(0, gd.cols * 4); // grid driven by kpi count
+        if (!kpis.length)
+            return (0, template_utils_1.makeErrorMosaic)("kpi-overview: pulse has no kpis", { title: `${this.id}`, width: W, height: H });
+        // KPI cells (row-major; a partial last row is centered), scaled to canvas.
+        const rowsNeeded = Math.max(1, Math.ceil(kpis.length / gd.cols));
+        const fullRowW = gd.cols * gd.cw + (gd.cols - 1) * gd.gx;
+        const cells = kpis.map((_, i) => {
+            const row = Math.floor(i / gd.cols);
+            const inRow = row === rowsNeeded - 1 ? kpis.length - row * gd.cols : gd.cols;
+            const col = i % gd.cols;
+            const rowX0 = gd.x0 + (inRow < gd.cols ? Math.round((fullRowW - (inRow * gd.cw + (inRow - 1) * gd.gx)) / 2) : 0);
+            return scale({ x: rowX0 + col * (gd.cw + gd.gx), y: gd.y0 + row * (gd.ch + gd.gy), w: gd.cw, h: gd.ch });
+        });
+        // Every card renders at the CELL its inset will produce, nudged 5-smooth
+        // (insetSlot, pulse-chrome): exact fit, no inherited rough factor.
+        const cellSlots = cells.map((r) => (0, pulse_chrome_1.insetSlot)(r, W, H));
+        cells.forEach((_, i) => { cells[i] = cellSlots[i].rect; });
+        // ── Nested KPI stat cards (each its own document; placed by mosaic ref) ──
+        // Per-KPI glyph: an Octicon SVG path masked onto the green chip (keyed by
+        // kpi.key, from pulse-glyphs); omitted keys fall back to the bare colored chip.
+        const introMs = reduceMotion ? 0 : Math.max(500, Math.round(durationMs * anim.introFrac));
+        const cards = await Promise.all(kpis.map((k, i) => {
+            var _a, _b;
+            return (0, template_utils_1.renderNestedTemplate)("@m0saic/alpine/stat-card/v1", {
+                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",
+                accent: theme.primaryBright,
+                iconPath: pulse_glyphs_1.KPI_GLYPHS[k.key],
+                // Whole-card fade is done at the beat level (below); keep only the count-up internally.
+                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: cellSlots[i].slot.width, height: cellSlots[i].slot.height, durationMs } });
+        }));
+        // Intro choreography (mirrors the title beat): the BAKED bg reveal plays first
+        // (its L→R wipe is pre-rendered into the scatter video, finishing ~22%); THEN the
+        // backdrops + header fade in; THEN the KPI cards cascade one-after-another (quick,
+        // the next starting as the previous ends → one flow). reduceMotion → all at t=0.
+        const t = (0, pulse_chrome_1.pulseTiming)(durationMs, reduceMotion);
+        const { bgFinishT, chromeFadeDur, cardStagger, cardsStart, animOn } = t;
+        const children = {};
+        const cardNodes = cards.map((c, i) => {
+            const ref = `kpi${i}`;
+            children[ref] = c;
+            // Staggered fade per card (whole-card alpha on the ref) → a sequential cascade.
+            return (0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)({ type: "mosaic", ref }), cardsStart + i * cardStagger, cardStagger, animOn), cells[i], W, H);
+        });
+        // ── Header cluster + footer (shared chrome; fade before the cards) ──
+        const beatR = scale(gm.beat), logoR = scale(gm.logo), titleR = scale(gm.title), subR = scale(gm.subtitle), footR = scale(gm.footer);
+        const footText = `WEEK ${(_f = (_e = pulse.period) === null || _e === void 0 ? void 0 : _e.weekNumber) !== null && _f !== void 0 ? _f : ""} · ${(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: (_g = props.eyebrow) !== null && _g !== void 0 ? _g : "BEAT 1", title: (_h = props.headline) !== null && _h !== void 0 ? _h : "KPI OVERVIEW", subtitle: (_j = props.subtitle) !== null && _j !== void 0 ? _j : "Key metrics at a glance for the week.", 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 share the LEFT edge (panelX) so header / grid / footer align. ──
+        const M = Math.round(gm.margin * sx);
+        const pad = Math.round(Math.min(W, H) * 0.018);
+        const panelX = Math.max(0, M - pad);
+        const panelRight = Math.min(W, W - M + pad);
+        const gridTop = Math.min(...cells.map((c) => c.y)), gridBot = Math.max(...cells.map((c) => c.y + c.h));
+        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 gridBg = (0, pulse_chrome_1.labelNode)((0, pulse_chrome_1.backdrop)(theme.card, { x: panelX, y: gridTop - pad, w: panelRight - panelX, h: gridBot - gridTop + 2 * pad }, W, H, bgFinishT, chromeFadeDur, animOn), "grid-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);
+        // Order: scatter → backdrops → chrome → KPI cards (each backdrop sits behind its content).
+        const root = (0, alpine_card_1.overlay)([(0, pulse_chrome_1.scatterNode)(), gridBg, headerBg, footBg, ...header.nodes, footNode, ...cardNodes]);
+        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 + the KPI grid panel, not the nested stat cards).
+        const constraints = [...pulse_chrome_1.PULSE_CHROME_CONSTRAINTS, { label: "grid-panel", within: { yFrac: [0.14, 0.98] } }];
+        return (0, template_utils_1.withLayoutContract)(doc, ctx, { templateId: "@m0saic/hero/ffmpeg-pulse/kpi-overview/v1", constraints, flatten: false, debug: props.debugLayout === true });
+    },
+};
+(0, template_utils_1.registerTemplate)(exports.FfmpegPulseKpiOverview);

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

@@ -0,0 +1 @@
+export { FfmpegPulseNotableCommits } from "./notable-commits";

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * ============================================================================
+ * @m0saic/hero/ffmpeg-pulse/notable-commits/v1 — Weekly Pulse · Notable Commits (Beat 6)
+ * ============================================================================
+ *
+ * The SAME chrome as the other beats wrapping a commit feed (nested
+ * @m0saic/alpine/commit-feed — kind icon + title + PR, area chip + author +
+ * reviewer discs + date, with a win/warn/neutral signal bar) on the left + a rail
+ * of maintainer stat tiles (Merged PRs / Review Coverage / Open Issues /
+ * Contributors) on the right.
+ *
+ * Driven by `pulse.notable` (items → feed, rail → tiles). The feed is transparent
+ * (washColor = theme.card) so the beat's theme.card backdrop shows through the row
+ * gaps (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 NotableCommitsProps = {
+    pulse: WeeklyPulse;
+    eyebrow?: string;
+    headline?: string;
+    subtitle?: string;
+    preset?: PulsePreset;
+    renderMode?: "premium" | "light";
+    anim?: AnimConfig;
+    animate?: boolean;
+    debugLayout?: boolean;
+};
+export declare const FfmpegPulseNotableCommits: MosaicTemplate<NotableCommitsProps>;
+export {};

package/dist/m0saic/hero/ffmpeg-pulse/notable-commits/v1/notable-commits.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FfmpegPulseNotableCommits = 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 }, feed: { 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 }, feed: { x: 170, y: 252, w: 740, h: 430 },
+        rail: { x0: 170, y0: 700, cols: 2, cw: 360, ch: 150, 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 }, feed: { x: 80, y: 430, w: 920, h: 880 },
+        rail: { x0: 80, y0: 1340, cols: 2, cw: 448, ch: 220, gx: 24, gy: 16 } },
+};
+const RAIL_GLYPH = { mergedPrs: "mergedPrs", reviewCoverage: "pullRequests", openIssues: "openIssues", contributors: "contributors", totalCommits: "commits" };
+const propsSchema = (0, template_utils_1.definePropsSchema)({
+    pulse: { type: "group", required: false, description: "Weekly Pulse data sheet (notable drives the feed + rail).", meta: { ui: { label: "Pulse data", order: 1, consumer: "agent" } } },
+    eyebrow: { type: "string", required: false, description: "Beat chip label.", meta: { control: { placeholder: "BEAT 6" }, ui: { label: "Eyebrow", order: 1 } } },
+    headline: { type: "string", required: false, description: "Beat title.", meta: { control: { placeholder: "NOTABLE COMMITS" }, 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 feed 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.FfmpegPulseNotableCommits = {
+    id: (0, types_1.asTemplateId)("@m0saic/hero/ffmpeg-pulse/notable-commits/v1"),
+    label: "Weekly Pulse · Notable Commits",
+    version: 1,
+    description: "FFmpeg Weekly Pulse — Notable Commits beat (Beat 6). The shared beat chrome wrapping a commit feed (kind icon + title + PR + area + reviewers + signal bar) + a rail of maintainer stat tiles (merged PRs / review coverage / open issues / contributors). Aspect-adaptive.",
+    capabilities: { tier: "core" },
+    internal: true,
+    tags: ["hero", "ffmpeg-pulse", "notable-commits", "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 6",
+        headline: "NOTABLE COMMITS",
+        subtitle: "Highlight interesting work.",
+        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 items = (_e = (_d = pulse.notable) === null || _d === void 0 ? void 0 : _d.items) !== null && _e !== void 0 ? _e : [];
+        if (!items.length)
+            return (0, template_utils_1.makeErrorMosaic)("notable-commits: pulse has no notable.items", { title: `${this.id}`, width: W, height: H });
+        const feedRows = items.map((it) => ({ kind: it.kind, title: it.title, author: it.author, date: (0, pulse_data_1.monthDay)(it.dateISO), pr: it.pr, reviewers: it.reviewers, area: it.area, signal: it.signal }));
+        const railData = ((_g = (_f = pulse.notable) === 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",
+            });
+        });
+        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 feedRSlot = (0, pulse_chrome_1.insetSlot)(scale(gm.feed), W, H);
+        const feedR = feedRSlot.rect;
+        const introMs = reduceMotion ? 0 : Math.max(500, Math.round(durationMs * anim.introFrac));
+        const feedChild = await (0, template_utils_1.renderNestedTemplate)("@m0saic/alpine/commit-feed/v1", {
+            rows: feedRows, preset: "dark", showHeader: false, backgroundColor: "black@0", washColor: theme.card,
+            accent: theme.primaryBright, anim: { introFrac: anim.introFrac, reduceMotion, renderMode }, // runner-controlled render weight (light = geq-free cascade; premium = alpha fade)
+        }, ctx, { slot: { width: feedRSlot.slot.width, height: feedRSlot.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 } });
+        }));
+        const t = (0, pulse_chrome_1.pulseTiming)(durationMs, reduceMotion);
+        const { bgFinishT, chromeFadeDur, cardStagger, cardsStart, animOn } = t;
+        const children = { feed: feedChild };
+        const feedNode = (0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)({ type: "mosaic", ref: "feed" }), bgFinishT, chromeFadeDur, animOn), feedR, 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);
+        });
+        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 6", title: (_l = props.headline) !== null && _l !== void 0 ? _l : "NOTABLE COMMITS", subtitle: (_m = props.subtitle) !== null && _m !== void 0 ? _m : "Highlight interesting work.", bind: { eyebrow: "eyebrow", title: "headline", subtitle: "subtitle" } }, t, W, H);
+        const footNode = (0, pulse_chrome_1.buildFooter)(footR, theme, footText, t, W, H);
+        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 feedBg = (0, pulse_chrome_1.labelNode)((0, pulse_chrome_1.backdrop)(theme.card, { x: feedR.x - pad, y: feedR.y - pad, w: feedR.w + 2 * pad, h: feedR.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)(), feedBg, railBg, headerBg, footBg, ...header.nodes, footNode, feedNode, ...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 feed/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/notable-commits/v1", constraints, flatten: false, debug: props.debugLayout === true });
+    },
+};
+(0, template_utils_1.registerTemplate)(exports.FfmpegPulseNotableCommits);

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

@@ -0,0 +1 @@
+export { FfmpegPulseRunner } from "./runner";

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

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

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

@@ -0,0 +1,54 @@
+/**
+ * ============================================================================
+ * @m0saic/hero/ffmpeg-pulse/runner/v1 — Weekly Pulse · Runner (pipeline)
+ * ============================================================================
+ *
+ * Sequences the eight FFmpeg Weekly Pulse beats into one MosaicDocumentPipeline:
+ *   title → kpi-overview → activity-trend → top-contributors → changes-breakdown
+ *         → contributions → notable-commits → fin
+ *
+ * Each beat renders full-canvas (renderNestedTemplate at the runner's target size)
+ * as its own pipeline step, so every step gets a fresh overlay-depth budget. The
+ * whole `pulse` data sheet is passed to each beat as a direct prop (Phase 4 swaps
+ * to upstream-first). Per-beat durations are props (deterministic defaults ~35s);
+ * steps cross-fade. Aspect-adaptive (the beats classify W/H themselves).
+ * ============================================================================
+ */
+import type { MosaicDocument, MosaicDocumentPipeline, MosaicEngineContext, MosaicTemplate } from "@m0saic/types";
+import { type WeeklyPulse } from "../../_shared/pulse-data";
+type BeatTimings = {
+    title?: number;
+    kpiOverview?: number;
+    activityTrend?: number;
+    contributions?: number;
+    topContributors?: number;
+    changesBreakdown?: number;
+    notableCommits?: number;
+    fin?: number;
+};
+/** Render weight applied to every beat — see `renderMode` prop. */
+type RenderMode = "premium" | "light";
+type RunnerProps = {
+    pulse: WeeklyPulse;
+    timings?: BeatTimings;
+    crossfadeMs?: number;
+    renderMode?: RenderMode;
+    requireUpstream?: boolean;
+};
+/**
+ * Sequence the eight beats into one cross-faded MosaicDocumentPipeline from an
+ * already-resolved pulse sheet. Shared by the core runner (mock / prop / upstream)
+ * and the capability-tier `@m0saic/github/weekly-pulse` (fetch → derive → render),
+ * so both produce the identical beat pipeline.
+ */
+export declare function buildPulsePipeline(pulse: WeeklyPulse, opts: {
+    timings?: BeatTimings;
+    crossfadeMs?: number;
+    renderMode?: RenderMode;
+}, ctx: MosaicEngineContext): Promise<MosaicDocumentPipeline>;
+/** The preview stand-in shown when the beat templates aren't registered (the
+ *  web build). The real 8-beat composition needs the native render templates,
+ *  which only exist in the desktop engine. */
+export declare function runnerPreviewStub(ctx: MosaicEngineContext): MosaicDocument;
+export declare const FfmpegPulseRunner: MosaicTemplate<RunnerProps>;
+export {};

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

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FfmpegPulseRunner = void 0;
+exports.buildPulsePipeline = buildPulsePipeline;
+exports.runnerPreviewStub = runnerPreviewStub;
+const types_1 = require("@m0saic/types");
+const template_utils_1 = require("@m0saic/template-utils");
+const pulse_data_1 = require("../../_shared/pulse-data");
+// Beat order + default per-beat durations (ms). Sum ≈ 35s. Order pairs the two
+// activity views (trend → heatmap) and ends on the closing card.
+const BEATS = [
+    { key: "title", id: "@m0saic/hero/ffmpeg-pulse/title/v1", defMs: 4000 },
+    { key: "kpiOverview", id: "@m0saic/hero/ffmpeg-pulse/kpi-overview/v1", defMs: 5000 },
+    { key: "activityTrend", id: "@m0saic/hero/ffmpeg-pulse/activity-trend/v1", defMs: 5000 },
+    { key: "contributions", id: "@m0saic/hero/ffmpeg-pulse/contributions/v1", defMs: 4500 },
+    { key: "topContributors", id: "@m0saic/hero/ffmpeg-pulse/top-contributors/v1", defMs: 5000 },
+    { key: "changesBreakdown", id: "@m0saic/hero/ffmpeg-pulse/changes-breakdown/v1", defMs: 5000 },
+    { key: "notableCommits", id: "@m0saic/hero/ffmpeg-pulse/notable-commits/v1", defMs: 5500 },
+    { key: "fin", id: "@m0saic/hero/ffmpeg-pulse/fin/v1", defMs: 4000 },
+];
+/**
+ * Sequence the eight beats into one cross-faded MosaicDocumentPipeline from an
+ * already-resolved pulse sheet. Shared by the core runner (mock / prop / upstream)
+ * and the capability-tier `@m0saic/github/weekly-pulse` (fetch → derive → render),
+ * so both produce the identical beat pipeline.
+ */
+async function buildPulsePipeline(pulse, opts, ctx) {
+    var _a, _b, _c;
+    const W = Math.max(1, Math.round(ctx.target.width));
+    const H = Math.max(1, Math.round(ctx.target.height));
+    const timings = (_a = opts.timings) !== null && _a !== void 0 ? _a : {};
+    const crossfadeMs = Math.max(0, Math.round((_b = opts.crossfadeMs) !== null && _b !== void 0 ? _b : 350));
+    const renderMode = opts.renderMode === "light" ? "light" : "premium";
+    const steps = [];
+    for (let i = 0; i < BEATS.length; i++) {
+        const b = BEATS[i];
+        const isLast = i === BEATS.length - 1;
+        const hasCrossfade = !isLast && crossfadeMs > 0;
+        // A crossfade OVERLAPS the two beats it joins — the stitched
+        // pipeline is `Σ steps − Σ crossfade`, not `Σ steps`. So a beat
+        // that fades out has to carry its own transition ON TOP of its
+        // visible time, or the hero renders short of the total its beat
+        // timings add up to (8 beats × 350ms fades = 2.45s short).
+        const visibleMs = Math.max(500, Math.round((_c = timings[b.key]) !== null && _c !== void 0 ? _c : b.defMs));
+        const durationMs = visibleMs + (hasCrossfade ? crossfadeMs : 0);
+        // Each beat binds its header text to ITS props (eyebrow / headline / …);
+        // composed here as a step of the runner, those keys would resolve against
+        // the runner's schema and reject. The runner owns the composition, so the
+        // beat's bindings are stripped at the seam (labels and geometry stay).
+        const file = (0, template_utils_1.stripPropBindings)((await (0, template_utils_1.renderNestedTemplate)(b.id, { pulse, renderMode }, ctx, { slot: { width: W, height: H, durationMs } })));
+        steps.push({
+            durationMs,
+            file,
+            ...(hasCrossfade ? { transitionToNext: { type: "fade", durationMs: crossfadeMs } } : {}),
+        });
+    }
+    return { kind: "mosaic_pipeline", version: 1, defaultTransition: { type: "cut" }, steps };
+}
+const propsSchema = (0, template_utils_1.definePropsSchema)({
+    pulse: { type: "group", required: false, description: "Weekly Pulse data sheet — passed to every beat.", meta: { ui: { label: "Pulse data", order: 1, consumer: "agent" } } },
+    timings: { type: "group", required: false, description: "Per-beat durations in ms (title/kpiOverview/activityTrend/contributions/topContributors/changesBreakdown/notableCommits/fin).", meta: { ui: { label: "Beat timings", collapsedByDefault: true, consumer: "agent" } } },
+    crossfadeMs: { type: "number", required: false, description: "Cross-fade duration between beats (ms). 0 = hard cut.", meta: { constraints: { min: 0, max: 2000 }, ui: { label: "Cross-fade" } } },
+    renderMode: { type: "string", required: false, description: "Render weight for ALL beats. \"premium\" (default): alpha-fade reveals across the nested charts/cards — the softer look; the engine's enable-gating makes the per-pixel geq nearly free. \"light\": geq-free enable-gate pops — cheapest, most composable. Propagates to every beat.", meta: { constraints: { oneOf: ["light", "premium"] }, ui: { label: "Render mode", order: 5 } } },
+    requireUpstream: { type: "boolean", required: false, description: "When true, render a visible error frame (instead of the built-in mock) if no upstream `weeklyPulse` block is present. Set this on data-connected pipelines (fetcher → adapter → runner) so a failed producer looks failed, not fake. Default false — standalone/preview renders use the mock.", meta: { ui: { label: "Require upstream data", order: 2 } } },
+});
+async function renderRunner(props, ctx) {
+    var _a;
+    const W = Math.max(1, Math.round(ctx.target.width));
+    const H = Math.max(1, Math.round(ctx.target.height));
+    // Data-connected pipelines set requireUpstream:true — a missing weeklyPulse
+    // then means the upstream producer failed, so surface a visible error frame
+    // instead of silently rendering the built-in mock.
+    if (props.requireUpstream && !((_a = ctx.upstreamData) === null || _a === void 0 ? void 0 : _a.weeklyPulse)) {
+        return (0, template_utils_1.makeErrorMosaic)("Weekly Pulse: upstream `weeklyPulse` is unavailable - the GitHub data producer failed or wasn't wired. (Preview on the mock with requireUpstream:false.)", { width: W, height: H, title: "Weekly Pulse", errorCode: "MISSING_UPSTREAM_WEEKLY_PULSE" });
+    }
+    const pulse = (0, pulse_data_1.resolvePulse)(props.pulse, ctx);
+    // "premium" (default): alpha-fade reveals across the nested charts/cards;
+    // "light": geq-free enable-gate pops. Propagated to every beat.
+    return buildPulsePipeline(pulse, { timings: props.timings, crossfadeMs: props.crossfadeMs, renderMode: props.renderMode }, ctx);
+}
+/** Are all eight beat templates registered? They import `node:path` and are
+ *  EXCLUDED from the web build — when absent, the runner can't compose them, so
+ *  `renderLite` shows a stand-in instead of throwing. */
+function beatsRegistered() {
+    return BEATS.every((b) => (0, template_utils_1.getTemplate)(b.id) !== undefined);
+}
+/** The preview stand-in shown when the beat templates aren't registered (the
+ *  web build). The real 8-beat composition needs the native render templates,
+ *  which only exist in the desktop engine. */
+function runnerPreviewStub(ctx) {
+    const W = Math.max(1, Math.round(ctx.target.width));
+    const H = Math.max(1, Math.round(ctx.target.height));
+    return (0, template_utils_1.makeStubMosaic)("Weekly Pulse - Runner", {
+        width: W,
+        height: H,
+        note: "Sequences 8 cross-faded beats from native render templates - build the full pulse in Mosaic Desktop.",
+    });
+}
+exports.FfmpegPulseRunner = {
+    id: (0, types_1.asTemplateId)("@m0saic/hero/ffmpeg-pulse/runner/v1"),
+    label: "Weekly Pulse · Runner",
+    version: 1,
+    description: "FFmpeg Weekly Pulse — the runner. Sequences all eight beats (title → kpi-overview → activity-trend → contributions → top-contributors → changes-breakdown → notable-commits → fin) into one cross-faded MosaicDocumentPipeline. Aspect-adaptive; per-beat durations as props.",
+    capabilities: { tier: "core" },
+    tags: ["data-viz", "hero", "ffmpeg-pulse", "runner", "pipeline", "animated", "developers", "marketers", "github", "changelog", "showcase"],
+    outputHints: { format: { kind: "video", container: "mp4" }, width: 1920, height: 1080, fps: 30, durationMs: 38000 },
+    upstreamDataSchema: pulse_data_1.WEEKLY_PULSE_UPSTREAM_SCHEMA,
+    propsSchema,
+    defaultProps: {
+        requireUpstream: false,
+        pulse: pulse_data_1.MOCK_FFMPEG_PULSE,
+        crossfadeMs: 350,
+        renderMode: "premium",
+    },
+    async render(props, ctx) {
+        return renderRunner(props, ctx);
+    },
+    // Preview / design hot path. The runner composes eight NESTED beat templates
+    // (title, kpi-overview, …) — node-only, and EXCLUDED from the web build. When
+    // they're registered (desktop) preview the real pulse; when they're not (web)
+    // return a stand-in instead of throwing "template not registered".
+    async renderLite(props, ctx) {
+        if (!beatsRegistered())
+            return runnerPreviewStub(ctx);
+        return renderRunner(props, ctx);
+    },
+};
+(0, template_utils_1.registerTemplate)(exports.FfmpegPulseRunner);

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

@@ -0,0 +1 @@
+export { FfmpegPulseScatterBake } from "./scatter-bake";

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * ============================================================================
+ * @m0saic/hero/ffmpeg-pulse/scatter-bake/v1 — one-off internal BAKE template
+ * ============================================================================
+ *
+ * Renders the signature rectangle scatter + its left→right rank-set reveal,
+ * full-canvas on the dark canvas, as a standalone clip — so it can be baked to
+ * a FLAT VIDEO and dropped into the beats as a single media source.
+ *
+ * Why: the live scatter is ~80K chars of m0 (225 per-tile sources) nested in
+ * every beat — heavy DSL + render. The field is CONSTANT across the video, so
+ * baking it once (the "reduce to 1 → flat video" perf win) collapses each beat's
+ * parent m0 to a single scatter `F` and renders cheap. Bake one per aspect:
+ *   m0saic make @m0saic/hero/ffmpeg-pulse/scatter-bake/v1 -w 1920 -h 1080 \
+ *     --durationMs 9000 -o .../_shared/assets/scatter-desktop.mp4
+ * (square 1080×1080 → scatter-square.mp4, mobile 1080×1920 → scatter-mobile.mp4)
+ *
+ * INTERNAL: not a curated/shippable template — purely a bake harness.
+ * ============================================================================
+ */
+import type { MosaicTemplate } from "@m0saic/types";
+type ScatterBakeProps = {
+    /** Fraction of the clip by which the reveal completes (matches the beats). */
+    revealFinishFrac?: number;
+    /** Per-tile fade duration (seconds). */
+    tileSec?: number;
+};
+export declare const FfmpegPulseScatterBake: MosaicTemplate<ScatterBakeProps>;
+export {};