@m0saic/templates 0.2.0

package/dist/m0saic/hero/ffmpeg-pulse/top-contributors/v1/top-contributors.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FfmpegPulseTopContributors = 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 NEG = "#f85149";
+const GEOM = {
+    // Desktop: table-left + a 2×2 rail-right (square-ish cards → bigger KPI text than a
+    // 1×N strip, where the stat-card font is height-bound).
+    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 }, table: { x: 140, y: 384, w: 980, h: 600 }, rail: { x0: 1160, y0: 384, cols: 2, cw: 290, ch: 288, gx: 20, gy: 24 } },
+    // Square: table-top + a 2×2 rail below; the table is trimmed so the rail cards are
+    // taller (bigger KPI text).
+    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: 118, w: 628, h: 66 }, subtitle: { x: 172, y: 202, w: 720, h: 30 },
+        footer: { x: 170, y: 1026, w: 420, h: 34 }, table: { x: 170, y: 252, w: 740, h: 366 },
+        rail: { x0: 170, y0: 638, cols: 2, cw: 360, ch: 184, gx: 20, gy: 16 } },
+    // Mobile: the table panel stays PORTRAIT (taller than wide) so it reflows to the
+    // stacked-card layout; the aggregate rail is a 4×1 row of TALL cards (bigger text
+    // than a 2×2 of wide-short cards).
+    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: 224, w: 760, h: 80 }, subtitle: { x: 82, y: 332, w: 760, h: 38 },
+        footer: { x: 80, y: 1800, w: 640, h: 56 }, table: { x: 80, y: 430, w: 920, h: 1062 },
+        rail: { x0: 80, y0: 1516, cols: 4, cw: 218, ch: 270, gx: 16, gy: 0 } },
+};
+// rail KPI key → glyph key.
+const RAIL_GLYPH = { totalCommits: "commits", commits: "commits", contributors: "contributors", additions: "additions", deletions: "deletions", stars: "stars" };
+const propsSchema = (0, template_utils_1.definePropsSchema)({
+    pulse: { type: "group", required: false, description: "Weekly Pulse data sheet (contributors drives the table + rail).", meta: { ui: { label: "Pulse data", order: 1, consumer: "agent" } } },
+    eyebrow: { type: "string", required: false, description: "Beat chip label.", meta: { control: { placeholder: "BEAT 3" }, ui: { label: "Eyebrow", order: 1 } } },
+    headline: { type: "string", required: false, description: "Beat title.", meta: { control: { placeholder: "TOP CONTRIBUTORS" }, 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 table + rail 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 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.FfmpegPulseTopContributors = {
+    id: (0, types_1.asTemplateId)("@m0saic/hero/ffmpeg-pulse/top-contributors/v1"),
+    label: "Weekly Pulse · Top Contributors",
+    version: 1,
+    description: "FFmpeg Weekly Pulse — Top Contributors beat (Beat 3). The shared beat chrome wrapping a ranked contributor table (commits/additions/deletions, green/red diff) + a rail of aggregate stat tiles. Aspect-adaptive (table reflows to stacked cards on mobile).",
+    capabilities: { tier: "core" },
+    internal: true,
+    tags: ["hero", "ffmpeg-pulse", "top-contributors", "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 3",
+        headline: "TOP CONTRIBUTORS",
+        subtitle: "Who shipped the most this week.",
+        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 cRows = (_e = (_d = pulse.contributors) === null || _d === void 0 ? void 0 : _d.rows) !== null && _e !== void 0 ? _e : [];
+        if (!cRows.length)
+            return (0, template_utils_1.makeErrorMosaic)("top-contributors: pulse has no contributors", { title: `${this.id}`, width: W, height: H });
+        // Table rows: rank · name · [commits, additions, deletions].
+        const tableRows = cRows.map((r) => ({ rank: r.rank, name: r.name, values: [r.commits, r.additions, r.deletions] }));
+        // Rail tiles (aggregate KPIs, first 4 of pulse.contributors.rail).
+        const railData = ((_g = (_f = pulse.contributors) === 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 tableRSlot = (0, pulse_chrome_1.insetSlot)(scale(gm.table), W, H);
+        const tableR = tableRSlot.rect;
+        // ── Nested panels: the contributor table + the rail stat cards ──
+        const introMs = reduceMotion ? 0 : Math.max(500, Math.round(durationMs * anim.introFrac));
+        const tableChild = await (0, template_utils_1.renderNestedTemplate)("@m0saic/alpine/contributor-table/v1", {
+            rows: tableRows, columns: ["Commits", "Additions", "Deletions"],
+            columnColors: [undefined, theme.primaryBright, NEG], columnSigns: ["", "+", "-"],
+            preset: "dark", // alpine-light by default; the hero keeps its dark look
+            showHeader: false, // the beat chrome supplies the title
+            backgroundColor: "black@0", // transparent — the beat draws the table backdrop (panel alignment)
+            washColor: theme.card, // bands blend against the chrome card color (cohesive)
+            accent: theme.primaryBright, topTint: 3,
+            anim: { introFrac: anim.introFrac, countUp: !reduceMotion, easing: "easeOut", reduceMotion, renderMode }, // runner-controlled render weight (light = geq-free row cascade; premium = alpha fade)
+        }, ctx, { slot: { width: tableRSlot.slot.width, height: tableRSlot.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 = { table: tableChild };
+        const tableNode = (0, pulse_chrome_1.insetSafe)((0, pulse_chrome_1.withFade)((0, alpine_card_1.paint)({ type: "mosaic", ref: "table" }), bgFinishT, chromeFadeDur, animOn), tableR, 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 3", title: (_l = props.headline) !== null && _l !== void 0 ? _l : "TOP CONTRIBUTORS", subtitle: (_m = props.subtitle) !== null && _m !== void 0 ? _m : "Who shipped the most this 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 beat-drawn with the same ±pad inset so the table,
+        //    rail, header + footer panels share aligned edges (the table is transparent). ──
+        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 tableBg = (0, pulse_chrome_1.labelNode)((0, pulse_chrome_1.backdrop)(theme.card, { x: tableR.x - pad, y: tableR.y - pad, w: tableR.w + 2 * pad, h: tableR.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)(), tableBg, railBg, headerBg, footBg, ...header.nodes, footNode, tableNode, ...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 table/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/top-contributors/v1", constraints, flatten: false, debug: props.debugLayout === true });
+    },
+};
+(0, template_utils_1.registerTemplate)(exports.FfmpegPulseTopContributors);

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

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

package/dist/m0saic/hero/index.js

@@ -0,0 +1,18 @@
+"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 });
+/* Hero templates — canonical production-grade showcase templates. */
+__exportStar(require("./ffmpeg-pulse"), exports);

package/dist/m0saic/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./wireframe";
+export * from "./hello-world";
+export * from "./media";
+export * from "./brand";
+export * from "./hero";
+export * from "./primitives";
+export * from "./charts";
+export * from "./alpine";
+export * from "./collage";
+export * from "./forensic";
+export * from "./meta";
+export * from "./agents";
+export * from "./github";
+export * from "./theming";
+export * from "./dsl-tutorial";
+export * from "./benchmark";
+export * from "./social";
+export * from "./story";
+export * from "./web";
+export * from "./code";

package/dist/m0saic/index.js

@@ -0,0 +1,56 @@
+"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 });
+/* Built in standard utility template */
+__exportStar(require("./wireframe"), exports);
+/* Hello, World — the CLI's first render (`m0saic hello-world`) */
+__exportStar(require("./hello-world"), exports);
+/* Media */
+__exportStar(require("./media"), exports);
+/* Brand Logo */
+__exportStar(require("./brand"), exports);
+/* Hero */
+__exportStar(require("./hero"), exports);
+/* Primitives */
+__exportStar(require("./primitives"), exports);
+/* Charts (canonical data-viz primitives) */
+__exportStar(require("./charts"), exports);
+/* Alpine (friendly mobile-marketing data-viz pack) */
+__exportStar(require("./alpine"), exports);
+/* Collage (layout-solver family — packs images; the spread-grid mock dogfoods
+   the layout contract before the real packer) */
+__exportStar(require("./collage"), exports);
+/* Forensic */
+__exportStar(require("./forensic"), exports);
+/* Meta (templates about mosaic itself — post-mortem, camera-debug) */
+__exportStar(require("./meta"), exports);
+/* GitHub (data connector — host connection + REST client + week math; the
+   repo-facts fetcher + weekly-pulse adapter land in F5 Phases 2–3) */
+__exportStar(require("./agents"), exports);
+__exportStar(require("./github"), exports);
+/* Theming (design-token producer — publishes ThemeTokens over upstream) */
+__exportStar(require("./theming"), exports);
+/* DSL Tutorial (animated geometry-walk teaching template) */
+__exportStar(require("./dsl-tutorial"), exports);
+/* Benchmark (machine performance runner) */
+__exportStar(require("./benchmark"), exports);
+/* Social (share-ready social graphics) */
+__exportStar(require("./social"), exports);
+/* Story (agentic-video: narrated multi-chapter pipelines) */
+__exportStar(require("./story"), exports);
+/* Web (live webpage geometry → editable visual derivatives) */
+__exportStar(require("./web"), exports);
+__exportStar(require("./code"), exports);

package/dist/m0saic/media/barcode/v1/barcode.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Brand Barcode v1 — scannable 1D barcode (Code 128 / EAN-13 / UPC-A).
+ *
+ * Default is a Code 128 "M0SAIC" tag; any string that fits the chosen
+ * format works (printable ASCII for Code 128, 12/13 digits for EAN-13,
+ * 11/12 digits for UPC-A — short forms auto-append the check digit).
+ *
+ * Fully in-house: no SVG, no `sharp`, no PNG raster. Each dark bar is its
+ * own lavfi colour tile in the document's m0 — the engine paints them
+ * directly. When `showHumanReadable` is on, the carved HRI splice points
+ * are filled with `MosaicTextSource`s carrying the digit caption.
+ */
+import { type BarcodeFormat } from "@m0saic/dsl-stdlib";
+type Props = {
+    text?: string;
+    format?: BarcodeFormat;
+    mode?: "light" | "dark";
+    transparentBackground?: boolean;
+    showHumanReadable?: boolean;
+};
+export declare const Barcode: import("@m0saic/types").MosaicTemplate<Props, import("@m0saic/types").MosaicTemplateOutputs, import("@m0saic/types").MosaicTemplateUpstreamVariables, import("@m0saic/types").MosaicTemplateUpstreamData, import("@m0saic/types").MosaicTemplateSidecars>;
+export default Barcode;

package/dist/m0saic/media/barcode/v1/barcode.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * Brand Barcode v1 — scannable 1D barcode (Code 128 / EAN-13 / UPC-A).
+ *
+ * Default is a Code 128 "M0SAIC" tag; any string that fits the chosen
+ * format works (printable ASCII for Code 128, 12/13 digits for EAN-13,
+ * 11/12 digits for UPC-A — short forms auto-append the check digit).
+ *
+ * Fully in-house: no SVG, no `sharp`, no PNG raster. Each dark bar is its
+ * own lavfi colour tile in the document's m0 — the engine paints them
+ * directly. When `showHumanReadable` is on, the carved HRI splice points
+ * are filled with `MosaicTextSource`s carrying the digit caption.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Barcode = void 0;
+const types_1 = require("@m0saic/types");
+const dsl_stdlib_1 = require("@m0saic/dsl-stdlib");
+const template_utils_1 = require("@m0saic/template-utils");
+const BRAND_ORANGE = "#f97316";
+const BG_LIGHT = "#ffffff";
+const BG_DARK = "#000000";
+/** Pixel scale for the in-house bar layout (matches the dictionary generator). */
+const PX_PER_MODULE = 4;
+/** Bar region height in modules. Drives the rendered aspect ratio. */
+const BAR_HEIGHT_MODULES = 40;
+/** Default HRI band height as fraction of bar height. */
+const HRI_HEIGHT_PCT = 0.15;
+/**
+ * Font stack for the HRI digit caption. The convention for printed product-
+ * code barcodes is OCR-B (Optical Character Recognition B); m0saic doesn't
+ * bundle that font, so we fall back to widely-available monospaces. The
+ * stack survives even on systems where the first choice is missing — ffmpeg
+ * + fontconfig resolves the first available name.
+ */
+const HRI_FONT_FAMILY = "OCR-B, OCR B, Inconsolata, Menlo, Consolas, Courier New, monospace";
+const propsSchema = (0, template_utils_1.definePropsSchema)({
+    text: {
+        type: "string",
+        required: false,
+        description: "Payload to encode. Code 128: printable ASCII. EAN-13: 12 or 13 digits. UPC-A: 11 or 12 digits.",
+        meta: { ui: { label: "Payload" } },
+    },
+    format: {
+        type: "string",
+        required: false,
+        description: "Symbology. Code 128 for general-purpose ASCII; EAN-13 / UPC-A for retail product codes.",
+        meta: { ui: { label: "Symbology" }, constraints: { oneOf: ["code128", "ean13", "upca"] } },
+    },
+    mode: {
+        type: "string",
+        required: false,
+        description: "Background colour mode.",
+        meta: { ui: { label: "Background" }, constraints: { oneOf: ["light", "dark"] } },
+    },
+    transparentBackground: {
+        type: "boolean",
+        required: false,
+        description: "When true, the canvas background is transparent (alpha) instead of solid light/dark.",
+        meta: { ui: { label: "Transparent background" } },
+    },
+    showHumanReadable: {
+        type: "boolean",
+        required: false,
+        description: "When true, carve a band under the bars and splice in the digit caption (the human-readable interpretation). When false, output is bars only.",
+        meta: { ui: { label: "Human-readable caption" } },
+    },
+});
+const DEFAULTS = {
+    text: "M0SAIC",
+    format: "code128",
+    mode: "light",
+    transparentBackground: false,
+    showHumanReadable: true,
+};
+/**
+ * Build a `MosaicTextSource` to splice into an HRI splice-point F. The
+ * source paints `text` centered in its cell. `bg` matches the document
+ * background so the HRI tile visually blends into the canvas; `undefined`
+ * preserves alpha when the canvas is transparent.
+ */
+function buildHriTextSource(text, bg, fontSize) {
+    return {
+        type: "text",
+        ...(bg !== undefined ? { visual: { backgroundColor: bg } } : {}),
+        layers: [
+            {
+                content: { kind: "literal", text },
+                style: {
+                    fontSize,
+                    fontColor: BRAND_ORANGE,
+                    fontFamily: HRI_FONT_FAMILY,
+                },
+                // hAlign/vAlign only — an xExpr of "w/2" anchors the text's LEFT
+                // edge at canvas center (drawtext semantics), which shoved every
+                // caption right of center and ran long payloads off the canvas.
+                placement: {
+                    hAlign: "center",
+                    vAlign: "middle",
+                },
+            },
+        ],
+    };
+}
+exports.Barcode = (0, template_utils_1.defineMosaicTemplate)({
+    id: (0, types_1.asTemplateId)("@m0saic/media/barcode/v1"),
+    label: "Barcode",
+    version: 1,
+    // BITMAP drafting mode (handbook §3c): the split counts ARE Code 128 module widths —
+    // never live-composed, so the latticeSmooth convention does not apply.
+    lattice: { mode: "bitmap" },
+    description: "Scannable 1D barcode (Code 128, EAN-13, UPC-A). Orange bars on light, dark, or transparent backgrounds. Optional human-readable digit caption underneath.",
+    capabilities: { tier: "core" },
+    tags: ["media", "barcode", "designers", "marketers", "print", "label"],
+    outputHints: {
+        // Width × height chosen for a typical Code 128 payload at ~2.6:1 aspect.
+        // The document's `size` field below carries the payload-exact dims so
+        // bars stay square at render time; outputHints is just the engine target.
+        width: 1080,
+        height: 420,
+        fps: 30,
+        durationMs: 2000,
+        note: "1D barcode rendered as in-house m0 (no PNG raster).",
+        format: {
+            kind: "image",
+            container: "png",
+            pixelFormat: "rgba",
+        },
+    },
+    propsSchema,
+    defaultProps: DEFAULTS,
+    async render(props, ctx) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const text = (_a = props.text) !== null && _a !== void 0 ? _a : DEFAULTS.text;
+        const format = (_b = props.format) !== null && _b !== void 0 ? _b : DEFAULTS.format;
+        const mode = (_c = props.mode) !== null && _c !== void 0 ? _c : DEFAULTS.mode;
+        const transparentBackground = (_d = props.transparentBackground) !== null && _d !== void 0 ? _d : DEFAULTS.transparentBackground;
+        const showHumanReadable = (_e = props.showHumanReadable) !== null && _e !== void 0 ? _e : DEFAULTS.showHumanReadable;
+        // `solidBackground` appends `@1.0` to force opaque output on alpha-
+        // bearing formats (our `pixelFormat: "rgba"` PNG); see its docs for
+        // why. `undefined` (transparent mode) passes through unchanged.
+        const backgroundColor = transparentBackground
+            ? undefined
+            : (0, template_utils_1.solidBackground)(mode === "dark" ? BG_DARK : BG_LIGHT);
+        let renderable;
+        try {
+            renderable = (0, template_utils_1.barcodeToRenderable)({
+                text,
+                format,
+                moduleColor: BRAND_ORANGE,
+                moduleWidthPx: PX_PER_MODULE,
+                heightPx: BAR_HEIGHT_MODULES * PX_PER_MODULE,
+                humanReadable: showHumanReadable
+                    ? { mode: "carve", heightPct: HRI_HEIGHT_PCT }
+                    : { mode: "none" },
+            });
+        }
+        catch (err) {
+            return (0, template_utils_1.makeErrorMosaic)(`Barcode: ${err instanceof Error ? err.message : String(err)}`, {
+                title: "Brand Barcode (v1)",
+                width: ctx.target.width,
+                height: ctx.target.height,
+            });
+        }
+        // ── Splice HRI text sources into the carved splice points ──
+        // `barcodeToRenderable` lays out sources as [bars..., hri-carved...].
+        // For each HRI frame with a stableKey (carve mode only), replace the
+        // matching source with a MosaicTextSource carrying the digit caption.
+        const sources = [...renderable.sources];
+        const numBars = (_g = (_f = renderable.channelByRole.bars) === null || _f === void 0 ? void 0 : _f.frames.length) !== null && _g !== void 0 ? _g : 0;
+        if (showHumanReadable && renderable.humanReadableFrames.length > 0) {
+            for (let i = 0; i < renderable.humanReadableFrames.length; i++) {
+                const frame = renderable.humanReadableFrames[i];
+                if (!frame.stableKey)
+                    continue;
+                const sourceIndex = numBars + i;
+                if (sourceIndex >= sources.length)
+                    continue;
+                // Size font to roughly fill the HRI band's pixel height in the
+                // renderable's canvas space. The engine scales tile contents when
+                // mapping to the output canvas, so this stays proportional.
+                const fontSize = Math.max(6, Math.round(frame.bounds.height * 0.75));
+                // The caption SHOWS the `text` prop — bind it so Make's double-click
+                // edits the payload in place.
+                sources[sourceIndex] = (0, template_utils_1.bindProp)(buildHriTextSource(frame.text, backgroundColor, fontSize), "text");
+            }
+        }
+        // Solid modes ALSO paint the background as a real base tile: the resolver
+        // child path (.mosaicx template_invocation) drops the child doc's
+        // backgroundColor (candidate 2026-08-06-template-invocation-bg-drop), and a
+        // barcode losing its quiet-zone ground is a SCANNABILITY inversion (orange
+        // bars on black + white HRI patches). Transparent mode stays tile-free so
+        // alpha survives. Prepended AFTER the HRI splice so splice indices hold.
+        let m0Str = String(renderable.m0);
+        if (backgroundColor !== undefined) {
+            m0Str = `1{${m0Str}}`;
+            sources.unshift((0, template_utils_1.makeColorTile)(backgroundColor));
+        }
+        return {
+            kind: "mosaic_document",
+            version: 1,
+            m0: (0, dsl_stdlib_1.toM0String)(m0Str, "Barcode"),
+            sources,
+            assets: {},
+            // Engine-decided timing (same fix as media/qr/basic/v1). `outputHints`
+            // above still supply 30 / 2000 as DEFAULTS; authoring the literals here
+            // additionally beat an EXPLICIT ask, because stampRenderableOutput gives
+            // authored durationMs precedence over the resolved target (gate 26).
+            fps: ctx.target.fps,
+            durationMs: ctx.target.durationMs,
+            // Pass the renderable's natural canvas size so bars stay square at
+            // render time regardless of the engine target's aspect.
+            size: { width: renderable.canvasW, height: renderable.canvasH },
+            ...(backgroundColor !== undefined ? { backgroundColor } : {}),
+        };
+    },
+});
+(0, template_utils_1.registerTemplate)(exports.Barcode);
+exports.default = exports.Barcode;

package/dist/m0saic/media/barcode/v1/index.d.ts

@@ -0,0 +1 @@
+export { Barcode, default } from "./barcode";

package/dist/m0saic/media/barcode/v1/index.js

@@ -0,0 +1,9 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.Barcode = void 0;
+var barcode_1 = require("./barcode");
+Object.defineProperty(exports, "Barcode", { enumerable: true, get: function () { return barcode_1.Barcode; } });
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(barcode_1).default; } });

package/dist/m0saic/media/blur-regions/index.d.ts

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

package/dist/m0saic/media/blur-regions/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/media/blur-regions/v1/blur-regions.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Easy Blur — `@m0saic/media/blur-regions/v1`.
+ *
+ * Pick one video OR image, draw one or more rectangles over the areas
+ * to hide (the `picker: "regions"` draw-on-canvas editor, or
+ * hand-authored `--props` JSON), and get the same media back with those
+ * regions blurred or pixelated — audio intact on video, canvas matched
+ * to the probed source, container following the user's `-o` extension.
+ * Image inputs render as a single frame (watermark precedent).
+ *
+ * The result is a 1-step `emit:"multi"` pipeline, NOT a plain document:
+ * only a pipeline step's canvas tracks the input's probed dims (a plain
+ * document's `size` is overridden by explicit CLI `-w`/`-h`, which
+ * would misalign the mask regions against the re-fitted content). The
+ * planner collapses the single step to the bare `-o` file and the
+ * per-step format is inert — the `-o` extension wins (highlights
+ * single-range + watermark precedents).
+ *
+ * First adopter of the `picker: "regions"` prop contract
+ * (`MosaicRegionsValue` in `@m0saic/types`): integer px in the authored
+ * canvas, optional `canvas` wrapper for rescaling, missing `kind` =
+ * rect. Regions drawn in Make arrive in the preview canvas (= probed
+ * video dims once a source is picked); hand-authored regions may omit
+ * `canvas` and are read as px in the video's own canvas. The m0-native
+ * flavor (`{ m0 }` or a bare m0 string) takes a LAYOUT whose leaf cells
+ * are the regions — a series of rects is always expressible as m0.
+ *
+ * By default the regions become REAL m0 geometry (`geometry: "inset"`,
+ * via placeInsetPieces): each region is a cell whose source shows the
+ * exact media window underneath it (`placement.sourceRect` — this
+ * template is the primitive's first consumer) with the effect applied —
+ * visible and selectable in every m0 surface. `"exact"` trades DSL
+ * length for exact cells; `"mask"` keeps the original full-canvas
+ * inline-mask overlay (no geometry, cheapest for many regions).
+ *
+ * ZERO regions is the working BASE CASE, not an error: pick a source
+ * and the preview shows it untouched — that's the surface the user
+ * draws on. Fail-fast posture for what IS provided: any invalid region
+ * (entirely outside the canvas, degenerate size) fails the WHOLE render
+ * rather than silently dropping it — this is a privacy feature;
+ * partially-applied censoring must never ship quietly. Overshoot that
+ * still intersects the canvas is clamped, not rejected.
+ */
+import type { MosaicRegion, MosaicRegionsValue, MosaicTemplate } from "@m0saic/types";
+import { type BlurRegionsGeometry, type BlurRegionsMode } from "./plan";
+export type BlurRegionsV1Props = {
+    /** The video or image to blur regions of. */
+    sourceId?: string;
+    /** Regions to hide — drawn rects, hand-authored px rects, or an m0 layout. */
+    regions?: MosaicRegionsValue | MosaicRegion[] | string;
+    /** Effect style: gaussian "blur" (default) or censor-block "pixelate". */
+    mode?: BlurRegionsMode;
+    /** Effect strength: blur sigma px (1-200) / pixel block px (2-128). Default 24. */
+    strength?: number;
+    /** Region document structure: "inset" (default, compact real m0), "exact", "mask". */
+    geometry?: BlurRegionsGeometry;
+};
+export declare const BlurRegions: MosaicTemplate<BlurRegionsV1Props>;