@m0saic/templates 0.2.0

package/dist/m0saic/_shared/onboarding-cover.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onboardingBrandRow = exports.onboardingBrandAssets = exports.onboardingTimestampTile = exports.onboardingFrame = exports.onboardingSolid = exports.onboardingTextBlock = exports.onboardingTextSource = exports.onboardingGuttered = exports.onboardingOverlay = exports.onboardingSplit = exports.onboardingLeaf = exports.coverTypeRamp = exports.onboardingTypeRamp = exports.resolveOnboardingTheme = exports.ONBOARDING_THEME = void 0;
+exports.inlineHeroDoc = inlineHeroDoc;
+exports.buildBrandedCover = buildBrandedCover;
+exports.brandedCoverHeroBox = brandedCoverHeroBox;
+const screencap_grid_cover_1 = require("../media/screencap_grid/v2/screencap-grid-cover");
+const screencap_grid_tutorial_1 = require("../media/screencap_grid/v2/screencap-grid-tutorial");
+/** Only the brand M (data-uri) — covers never reference the tutorial sheet,
+ *  so the sheet's file asset must not ride every cover manifest. */
+function brandLogoAssets() {
+    const all = (0, screencap_grid_tutorial_1.tutorialAssets)();
+    const out = {};
+    for (const [id, entry] of Object.entries(all)) {
+        if ((entry === null || entry === void 0 ? void 0 : entry.kind) === "data-uri")
+            out[id] = entry;
+    }
+    return out;
+}
+// ── The kit, re-exported (byte-identical) ──
+var screencap_grid_cover_2 = require("../media/screencap_grid/v2/screencap-grid-cover");
+Object.defineProperty(exports, "ONBOARDING_THEME", { enumerable: true, get: function () { return screencap_grid_cover_2.SCREENCAP_ONBOARDING_THEME; } });
+Object.defineProperty(exports, "resolveOnboardingTheme", { enumerable: true, get: function () { return screencap_grid_cover_2.resolveScreencapOnboardingTheme; } });
+Object.defineProperty(exports, "onboardingTypeRamp", { enumerable: true, get: function () { return screencap_grid_cover_2.onboardingTypeRamp; } });
+Object.defineProperty(exports, "coverTypeRamp", { enumerable: true, get: function () { return screencap_grid_cover_2.coverTypeRamp; } });
+Object.defineProperty(exports, "onboardingLeaf", { enumerable: true, get: function () { return screencap_grid_cover_2.onboardingLeaf; } });
+Object.defineProperty(exports, "onboardingSplit", { enumerable: true, get: function () { return screencap_grid_cover_2.onboardingSplit; } });
+Object.defineProperty(exports, "onboardingOverlay", { enumerable: true, get: function () { return screencap_grid_cover_2.onboardingOverlay; } });
+Object.defineProperty(exports, "onboardingGuttered", { enumerable: true, get: function () { return screencap_grid_cover_2.onboardingGuttered; } });
+Object.defineProperty(exports, "onboardingTextSource", { enumerable: true, get: function () { return screencap_grid_cover_2.onboardingTextSource; } });
+Object.defineProperty(exports, "onboardingTextBlock", { enumerable: true, get: function () { return screencap_grid_cover_2.onboardingTextBlock; } });
+Object.defineProperty(exports, "onboardingSolid", { enumerable: true, get: function () { return screencap_grid_cover_2.onboardingSolid; } });
+Object.defineProperty(exports, "onboardingFrame", { enumerable: true, get: function () { return screencap_grid_cover_2.onboardingFrame; } });
+Object.defineProperty(exports, "onboardingTimestampTile", { enumerable: true, get: function () { return screencap_grid_cover_2.onboardingTimestampTile; } });
+var screencap_grid_tutorial_2 = require("../media/screencap_grid/v2/screencap-grid-tutorial");
+Object.defineProperty(exports, "onboardingBrandAssets", { enumerable: true, get: function () { return screencap_grid_tutorial_2.tutorialAssets; } });
+Object.defineProperty(exports, "onboardingBrandRow", { enumerable: true, get: function () { return screencap_grid_tutorial_2.tutorialBrand; } });
+function coverMessage(paneWidth, theme, type, label, body) {
+    const copy = (0, screencap_grid_cover_1.onboardingSplit)("row", [4, 11], [
+        (0, screencap_grid_cover_1.onboardingTextBlock)({
+            text: label,
+            fontSize: type.micro,
+            color: theme.accent,
+            cellWidthPx: paneWidth * 0.72,
+            hAlign: "left",
+            label: `cover ${label.toLowerCase()} label`,
+        }),
+        (0, screencap_grid_cover_1.onboardingTextBlock)({
+            text: body,
+            fontSize: type.label,
+            color: theme.textPrimary,
+            cellWidthPx: paneWidth * 0.72,
+            hAlign: "left",
+            widthFrac: 0.92,
+            label: `cover ${label.toLowerCase()} message`,
+        }),
+    ]);
+    const bubble = (0, screencap_grid_cover_1.onboardingOverlay)((0, screencap_grid_cover_1.onboardingSolid)(theme.surfaceRaised), (0, screencap_grid_cover_1.onboardingSplit)("col", [1, 18, 1], [null, copy, null]));
+    return (0, screencap_grid_cover_1.onboardingSplit)("col", [1, 19], [(0, screencap_grid_cover_1.onboardingSolid)(theme.accent), bubble]);
+}
+function coverTip(paneWidth, theme, type, label, body) {
+    const copy = (0, screencap_grid_cover_1.onboardingSplit)("row", [2, 5], [
+        (0, screencap_grid_cover_1.onboardingTextBlock)({
+            text: label,
+            fontSize: type.micro,
+            color: theme.accent,
+            cellWidthPx: paneWidth * 0.72,
+            hAlign: "left",
+            label: "cover start tip label",
+        }),
+        (0, screencap_grid_cover_1.onboardingTextBlock)({
+            text: body,
+            fontSize: type.label,
+            color: theme.textPrimary,
+            cellWidthPx: paneWidth * 0.72,
+            hAlign: "left",
+            widthFrac: 0.92,
+            label: "cover start tip",
+        }),
+    ]);
+    return (0, screencap_grid_cover_1.onboardingFrame)((0, screencap_grid_cover_1.onboardingOverlay)((0, screencap_grid_cover_1.onboardingSolid)(theme.surface), (0, screencap_grid_cover_1.onboardingSplit)("col", [1, 18, 1], [null, copy, null])), theme.borderStrong);
+}
+function coverChatPane(paneWidth, theme, type, compact, copy) {
+    var _a, _b, _c, _d, _e;
+    const brand = (0, screencap_grid_tutorial_1.tutorialBrand)(theme, type, copy.productName);
+    const title = (0, screencap_grid_cover_1.onboardingTextBlock)({
+        text: copy.title,
+        fontSize: type.headline,
+        color: theme.textPrimary,
+        cellWidthPx: paneWidth * 0.83,
+        hAlign: "left",
+        widthFrac: 0.9,
+        label: "cover title",
+    });
+    const overview = (0, screencap_grid_cover_1.onboardingTextBlock)({
+        text: (_b = (compact ? ((_a = copy.overviewCompact) !== null && _a !== void 0 ? _a : copy.overview) : copy.overview)) !== null && _b !== void 0 ? _b : "",
+        fontSize: type.callout,
+        color: theme.textSecondary,
+        cellWidthPx: paneWidth * 0.83,
+        hAlign: "left",
+        widthFrac: 0.9,
+        label: "cover overview",
+    });
+    const bubbles = ((_c = copy.messages) !== null && _c !== void 0 ? _c : []).map((m) => {
+        var _a;
+        return coverMessage(paneWidth, theme, type, m.label, compact ? ((_a = m.bodyCompact) !== null && _a !== void 0 ? _a : m.body) : m.body);
+    });
+    const tip = coverTip(paneWidth, theme, type, (_d = copy.tipLabel) !== null && _d !== void 0 ? _d : "START HERE", (_e = copy.tip) !== null && _e !== void 0 ? _e : "Set the props and render.");
+    // The subtitle-burn conversation weights, generalized over the bubble
+    // count: [lead 1, brand 6, 2, title, overview, 2, (bubble 7, 1)…, last
+    // bubble 7, 2, tip 6, tail 1] — three bubbles reproduces gate 26 exactly.
+    const weights = [1, 6, 2, compact ? 9 : 10, compact ? 8 : 9, 2];
+    const cells = [
+        null,
+        brand,
+        null,
+        title,
+        overview,
+        null,
+    ];
+    bubbles.forEach((b, i) => {
+        weights.push(7, i === bubbles.length - 1 ? 2 : 1);
+        cells.push(b, null);
+    });
+    weights.push(6, 1);
+    cells.push(tip, null);
+    const conversation = (0, screencap_grid_cover_1.onboardingSplit)("row", weights, cells);
+    const paddedConversation = (0, screencap_grid_cover_1.onboardingSplit)("col", [2, 26, 2], [null, conversation, null]);
+    return (0, screencap_grid_cover_1.onboardingFrame)((0, screencap_grid_cover_1.onboardingOverlay)((0, screencap_grid_cover_1.onboardingSolid)(theme.surfaceInset), paddedConversation), theme.border);
+}
+/** Band-variant height: px-clamped so it survives tiny canvases (gate-17). */
+function bandModePx(canvasH) {
+    return Math.max(34, Math.min(120, Math.round(canvasH * 0.12)));
+}
+/**
+ * Inline-flat hero from a rendered document — the gate-15/21 keeper path:
+ * procedural masked content (donut rings, rounded shapes) must NEVER ride a
+ * nested `type:"mosaic"` child (the child composite pass bleeds seams and
+ * distorts); its m0 + sources inline directly as the hero cell's claimant.
+ */
+function inlineHeroDoc(doc) {
+    var _a;
+    return {
+        m0: doc.m0,
+        sources: ((_a = doc.sources) !== null && _a !== void 0 ? _a : []),
+    };
+}
+/**
+ * Assemble the branded cover document: chat pane + hero on the onboarding
+ * theme surface, landscape `[4,30,3,59,4]` columns / stacked portrait /
+ * compact copy under 480px min-dim — the exact layout shipped on gates
+ * 24-26.
+ *
+ * `hero` receives the resolved theme + type ramp and the layout flags and
+ * returns the right-side composition (REAL MATERIAL — often the template's
+ * own static render nested via `children`). `heroAssets` merge over the
+ * brand assets; `children` attach to the returned document for nested-doc
+ * heroes (`{type:"mosaic", ref:"…"}` leaves).
+ */
+function buildBrandedCover(args) {
+    const { ctx, copy, hero, heroAssets, children } = args;
+    const canvasW = ctx.target.width;
+    const canvasH = ctx.target.height;
+    const theme = (0, screencap_grid_cover_1.resolveScreencapOnboardingTheme)(ctx);
+    const type = (0, screencap_grid_cover_1.coverTypeRamp)(canvasW, canvasH);
+    const compact = Math.min(canvasW, canvasH) < 480;
+    const stacked = canvasH > canvasW * 1.05;
+    // Band layout: always for variant "band"; for "pane" it is the
+    // tiny-canvas fallback (the gate-17 keeper: %-bands cull below ~310px —
+    // the conversation pane's text cells land under the ~20px min-cell floor
+    // and the entire cover culls blank).
+    if (args.variant === "band" ||
+        (!stacked && (canvasH < 420 || Math.min(canvasW, canvasH) < 380))) {
+        const bandPx = bandModePx(canvasH);
+        const brand = (0, screencap_grid_tutorial_1.tutorialBrand)(theme, type, copy.productName);
+        const title = (0, screencap_grid_cover_1.onboardingTextBlock)({
+            text: copy.title,
+            fontSize: type.callout,
+            color: theme.textSecondary,
+            cellWidthPx: canvasW * 0.55,
+            hAlign: "left",
+            label: "cover band title",
+        });
+        const band = (0, screencap_grid_cover_1.onboardingOverlay)((0, screencap_grid_cover_1.onboardingSolid)(theme.surface), (0, screencap_grid_cover_1.onboardingSplit)("col", [1, 12, 1, 22, 1], [null, brand, null, title, null]));
+        const heroComp = hero(theme, type, { stacked: false, compact: true });
+        const page = (0, screencap_grid_cover_1.onboardingSplit)("row", [Math.max(1, canvasH - bandPx), bandPx], [heroComp, band]);
+        const doc = {
+            kind: "mosaic_document",
+            version: 1,
+            assets: { ...brandLogoAssets(), ...(heroAssets !== null && heroAssets !== void 0 ? heroAssets : {}) },
+            size: { width: canvasW, height: canvasH },
+            backgroundColor: theme.surfaceApp,
+            m0: page.m0,
+            sources: page.sources,
+        };
+        if (children && Object.keys(children).length > 0) {
+            doc.children = children;
+        }
+        return doc;
+    }
+    const paneWidth = stacked ? canvasW * 0.88 : canvasW * 0.3;
+    const pane = coverChatPane(paneWidth, theme, type, compact, copy);
+    const heroComp = hero(theme, type, { stacked, compact });
+    const content = stacked
+        ? (0, screencap_grid_cover_1.onboardingSplit)("row", [47, 3, 50], [
+            (0, screencap_grid_cover_1.onboardingSplit)("col", [6, 88, 6], [null, pane, null]),
+            null,
+            (0, screencap_grid_cover_1.onboardingSplit)("col", [6, 88, 6], [null, heroComp, null]),
+        ])
+        : (0, screencap_grid_cover_1.onboardingSplit)("col", [4, 30, 3, 59, 4], [null, pane, null, heroComp, null]);
+    const page = (0, screencap_grid_cover_1.onboardingSplit)("row", [5, 90, 5], [null, content, null]);
+    const doc = {
+        kind: "mosaic_document",
+        version: 1,
+        assets: { ...brandLogoAssets(), ...(heroAssets !== null && heroAssets !== void 0 ? heroAssets : {}) },
+        size: { width: canvasW, height: canvasH },
+        backgroundColor: theme.surfaceApp,
+        m0: page.m0,
+        sources: page.sources,
+    };
+    if (children && Object.keys(children).length > 0) {
+        doc.children = children;
+    }
+    return doc;
+}
+/**
+ * The approximate pixel box the landscape hero composition paints into —
+ * for sizing a nested child render so its internal proportions match the
+ * tile it lands in (page row 90% × content hero column 59%).
+ */
+function brandedCoverHeroBox(ctx, variant) {
+    const stacked = ctx.target.height > ctx.target.width * 1.05;
+    const W = ctx.target.width;
+    const H = ctx.target.height;
+    if (variant === "band" || (!stacked && (H < 420 || Math.min(W, H) < 380))) {
+        return { width: W, height: Math.max(1, H - bandModePx(H)) };
+    }
+    return stacked
+        ? {
+            width: Math.max(1, Math.round(ctx.target.width * 0.88)),
+            height: Math.max(1, Math.round(ctx.target.height * 0.9 * 0.5 * 0.88)),
+        }
+        : {
+            width: Math.max(1, Math.round(ctx.target.width * 0.59)),
+            height: Math.max(1, Math.round(ctx.target.height * 0.9)),
+        };
+}

package/dist/m0saic/_shared/raster.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Pure-JS RGBA pixel helpers — the non-SVG half of what sharp used to do.
+ *
+ * No native binary, no wasm: plain typed-array work plus node's zlib for the
+ * PNG container. Mirrors the same primitives in `@m0saic/core`'s
+ * `core/svgRaster` — templates cannot import core (moat rule, the agent contract
+ * §7.4), and these are too small to justify a package. If a third consumer
+ * ever appears, promote them to `@m0saic/platform` (pure JS, browser-safe —
+ * unlike the resvg wrapper, which stays out of platform on purpose).
+ */
+/**
+ * Nearest-neighbour stretch to an exact size — replaces
+ * `sharp(raw).resize(w, h, { kernel: "nearest", fit: "fill" })`.
+ *
+ * `fit: "fill"` semantics: STRETCH, never preserve aspect, never crop. That
+ * distinction is load-bearing for the watermark grid — sharp's default
+ * (`cover`) center-cropped and silently discarded most of the cells on any
+ * canvas whose aspect differed from cols:rows.
+ */
+export declare function stretchNearestRgba(src: Buffer, srcW: number, srcH: number, dstW: number, dstH: number): Buffer;
+/**
+ * Three-pass separable box blur ≈ gaussian — replaces sharp's `.blur(sigma)`.
+ * All four channels blur together, so alpha ramps with colour (the
+ * low-frequency bump the watermark's soft cell edges rely on).
+ */
+export declare function blurRgba(px: Buffer, w: number, h: number, sigma: number): Buffer;
+/** RGBA8 → PNG bytes (filter 0 + deflate). Replaces `.png().toFile()`. */
+export declare function encodePng(rgba: Buffer, w: number, h: number, level?: number): Buffer;

package/dist/m0saic/_shared/raster.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Pure-JS RGBA pixel helpers — the non-SVG half of what sharp used to do.
+ *
+ * No native binary, no wasm: plain typed-array work plus node's zlib for the
+ * PNG container. Mirrors the same primitives in `@m0saic/core`'s
+ * `core/svgRaster` — templates cannot import core (moat rule, the agent contract
+ * §7.4), and these are too small to justify a package. If a third consumer
+ * ever appears, promote them to `@m0saic/platform` (pure JS, browser-safe —
+ * unlike the resvg wrapper, which stays out of platform on purpose).
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stretchNearestRgba = stretchNearestRgba;
+exports.blurRgba = blurRgba;
+exports.encodePng = encodePng;
+const zlib = __importStar(require("node:zlib"));
+/**
+ * Nearest-neighbour stretch to an exact size — replaces
+ * `sharp(raw).resize(w, h, { kernel: "nearest", fit: "fill" })`.
+ *
+ * `fit: "fill"` semantics: STRETCH, never preserve aspect, never crop. That
+ * distinction is load-bearing for the watermark grid — sharp's default
+ * (`cover`) center-cropped and silently discarded most of the cells on any
+ * canvas whose aspect differed from cols:rows.
+ */
+function stretchNearestRgba(src, srcW, srcH, dstW, dstH) {
+    const out = Buffer.alloc(dstW * dstH * 4);
+    for (let y = 0; y < dstH; y++) {
+        // +0.5 samples the CENTRE of the destination pixel, so the mapping is
+        // symmetric rather than biased toward the top-left.
+        const sy = Math.min(srcH - 1, Math.floor(((y + 0.5) * srcH) / dstH));
+        for (let x = 0; x < dstW; x++) {
+            const sx = Math.min(srcW - 1, Math.floor(((x + 0.5) * srcW) / dstW));
+            src.copy(out, (y * dstW + x) * 4, (sy * srcW + sx) * 4, (sy * srcW + sx) * 4 + 4);
+        }
+    }
+    return out;
+}
+/**
+ * Three-pass separable box blur ≈ gaussian — replaces sharp's `.blur(sigma)`.
+ * All four channels blur together, so alpha ramps with colour (the
+ * low-frequency bump the watermark's soft cell edges rely on).
+ */
+function blurRgba(px, w, h, sigma) {
+    const r = Math.max(1, Math.round(sigma * 1.5));
+    let src = Buffer.from(px);
+    let dst = Buffer.alloc(px.length);
+    const pass = (horizontal) => {
+        const outer = horizontal ? h : w;
+        const inner = horizontal ? w : h;
+        for (let a = 0; a < outer; a++) {
+            for (let b = 0; b < inner; b++) {
+                for (let c = 0; c < 4; c++) {
+                    let sum = 0;
+                    let n = 0;
+                    for (let k = -r; k <= r; k++) {
+                        const bb = b + k;
+                        if (bb < 0 || bb >= inner)
+                            continue;
+                        sum += src[horizontal ? (a * w + bb) * 4 + c : (bb * w + a) * 4 + c];
+                        n++;
+                    }
+                    dst[horizontal ? (a * w + b) * 4 + c : (b * w + a) * 4 + c] = Math.round(sum / n);
+                }
+            }
+        }
+        const t = src;
+        src = dst;
+        dst = t;
+    };
+    for (let i = 0; i < 3; i++) {
+        pass(true);
+        pass(false);
+    }
+    return src;
+}
+function crc32(buf) {
+    let c = ~0;
+    for (const byte of buf) {
+        c ^= byte;
+        for (let i = 0; i < 8; i++)
+            c = (c >>> 1) ^ (0xedb88320 & -(c & 1));
+    }
+    return ~c >>> 0;
+}
+function chunk(type, data) {
+    const len = Buffer.alloc(4);
+    len.writeUInt32BE(data.length);
+    const typed = Buffer.concat([Buffer.from(type, "ascii"), data]);
+    const crc = Buffer.alloc(4);
+    crc.writeUInt32BE(crc32(typed));
+    return Buffer.concat([len, typed, crc]);
+}
+/** RGBA8 → PNG bytes (filter 0 + deflate). Replaces `.png().toFile()`. */
+function encodePng(rgba, w, h, level = 6) {
+    const stride = w * 4;
+    const raw = Buffer.alloc((stride + 1) * h);
+    for (let y = 0; y < h; y++) {
+        raw[y * (stride + 1)] = 0;
+        rgba.copy(raw, y * (stride + 1) + 1, y * stride, (y + 1) * stride);
+    }
+    const ihdr = Buffer.alloc(13);
+    ihdr.writeUInt32BE(w, 0);
+    ihdr.writeUInt32BE(h, 4);
+    ihdr[8] = 8;
+    ihdr[9] = 6;
+    return Buffer.concat([
+        Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),
+        chunk("IHDR", ihdr),
+        chunk("IDAT", zlib.deflateSync(raw, { level })),
+        chunk("IEND", Buffer.alloc(0)),
+    ]);
+}

package/dist/m0saic/_shared/svgRaster.d.ts

@@ -0,0 +1,40 @@
+/**
+ * SVG rasterization for templates — the thin node-only seam that replaced
+ * sharp. Backed by `@resvg/resvg-wasm` (zero optional platform packages, no
+ * native binary), same engine core uses in `@m0saic/core/core/svgRaster`.
+ *
+ * Deliberately NOT shared through `@m0saic/platform`: platform is imported by
+ * the browser bundle, and putting a 2.4 MB wasm dependency there risks pulling
+ * it into the web build. Templates cannot import `@m0saic/core` (moat rule,
+ * the agent contract §7.4), so this thin wrapper is the seam for template code.
+ *
+ * ⭐ `loadSystemFonts: false` is load-bearing — resvg builds a system font DB
+ * per instance otherwise (364 ms/call vs 6 ms). Safe because template SVGs
+ * carry no `<text>`; glyphs arrive as paths.
+ */
+/**
+ * ⭐ resvg REQUIRES the SVG namespace; libvips/librsvg (what sharp used) did
+ * NOT. A namespace-less `<svg viewBox="…">` — invalid per spec but extremely
+ * common in hand-authored and inline markup — rasterized fine before the
+ * 2026-09-07 resvg swap and afterwards throws
+ * `"SVG data parsing failed cause the document does not have a root node"`.
+ *
+ * That reaches USER input (a template's `svg`/`svgPath` prop, an `svg-media`
+ * asset, a plain-SVG data URI), so silently losing it is a real regression,
+ * not a fixture problem. Inject the namespace when the root tag lacks one and
+ * leave every already-valid document byte-identical.
+ */
+export declare function ensureSvgNamespace<T extends Buffer | string>(svg: T): T;
+/** Rasterize an SVG to a PNG file at an exact pixel width (height follows). */
+export declare function renderSvgToPngFile(svg: string, outPath: string, widthPx: number): Promise<void>;
+/**
+ * Rasterize an SVG into a `res × res` RGBA buffer with CONTAIN semantics —
+ * aspect preserved, centred, transparent padding. Replaces
+ * `sharp(svg).resize(res, res, { fit: "contain", background: transparent })
+ *   .ensureAlpha().raw()`.
+ */
+export declare function renderSvgContainRgba(svg: string, res: number): Promise<{
+    data: Buffer;
+    width: number;
+    height: number;
+}>;

package/dist/m0saic/_shared/svgRaster.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * SVG rasterization for templates — the thin node-only seam that replaced
+ * sharp. Backed by `@resvg/resvg-wasm` (zero optional platform packages, no
+ * native binary), same engine core uses in `@m0saic/core/core/svgRaster`.
+ *
+ * Deliberately NOT shared through `@m0saic/platform`: platform is imported by
+ * the browser bundle, and putting a 2.4 MB wasm dependency there risks pulling
+ * it into the web build. Templates cannot import `@m0saic/core` (moat rule,
+ * the agent contract §7.4), so this thin wrapper is the seam for template code.
+ *
+ * ⭐ `loadSystemFonts: false` is load-bearing — resvg builds a system font DB
+ * per instance otherwise (364 ms/call vs 6 ms). Safe because template SVGs
+ * carry no `<text>`; glyphs arrive as paths.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureSvgNamespace = ensureSvgNamespace;
+exports.renderSvgToPngFile = renderSvgToPngFile;
+exports.renderSvgContainRgba = renderSvgContainRgba;
+const fs = __importStar(require("node:fs"));
+const NO_FONTS = { font: { loadSystemFonts: false } };
+/**
+ * ⭐ resvg REQUIRES the SVG namespace; libvips/librsvg (what sharp used) did
+ * NOT. A namespace-less `<svg viewBox="…">` — invalid per spec but extremely
+ * common in hand-authored and inline markup — rasterized fine before the
+ * 2026-09-07 resvg swap and afterwards throws
+ * `"SVG data parsing failed cause the document does not have a root node"`.
+ *
+ * That reaches USER input (a template's `svg`/`svgPath` prop, an `svg-media`
+ * asset, a plain-SVG data URI), so silently losing it is a real regression,
+ * not a fixture problem. Inject the namespace when the root tag lacks one and
+ * leave every already-valid document byte-identical.
+ */
+function ensureSvgNamespace(svg) {
+    const text = typeof svg === "string" ? svg : svg.toString("utf8");
+    const open = /<svg\b[^>]*>/i.exec(text);
+    // Not recognisably an SVG, or already namespaced — hand it through untouched
+    // so resvg still owns the error message for genuinely malformed input.
+    if (!open || /\bxmlns\s*=/i.test(open[0]))
+        return svg;
+    const patched = text.slice(0, open.index) +
+        open[0].replace(/^<svg\b/i, '<svg xmlns="http://www.w3.org/2000/svg"') +
+        text.slice(open.index + open[0].length);
+    return (typeof svg === "string" ? patched : Buffer.from(patched, "utf8"));
+}
+let _Resvg = null;
+let _init = null;
+async function resvg() {
+    if (_Resvg)
+        return _Resvg;
+    if (!_init) {
+        _init = (async () => {
+            // Lazy require keeps the wasm out of the import graph for templates that
+            // never rasterize — the same posture the sharp loader had.
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const mod = require("@resvg/resvg-wasm");
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const wasm = require.resolve("@resvg/resvg-wasm/index_bg.wasm");
+            await mod.initWasm(fs.readFileSync(wasm));
+            _Resvg = mod.Resvg;
+        })();
+    }
+    await _init;
+    return _Resvg;
+}
+/** Rasterize an SVG to a PNG file at an exact pixel width (height follows). */
+async function renderSvgToPngFile(svg, outPath, widthPx) {
+    const Resvg = await resvg();
+    const img = new Resvg(ensureSvgNamespace(svg), {
+        fitTo: { mode: "width", value: Math.max(1, Math.round(widthPx)) },
+        ...NO_FONTS,
+    }).render();
+    fs.writeFileSync(outPath, Buffer.from(img.asPng()));
+}
+/**
+ * Rasterize an SVG into a `res × res` RGBA buffer with CONTAIN semantics —
+ * aspect preserved, centred, transparent padding. Replaces
+ * `sharp(svg).resize(res, res, { fit: "contain", background: transparent })
+ *   .ensureAlpha().raw()`.
+ */
+async function renderSvgContainRgba(svg, res) {
+    const Resvg = await resvg();
+    const probe = new Resvg(ensureSvgNamespace(svg), NO_FONTS);
+    const iw = probe.width || 1;
+    const ih = probe.height || 1;
+    // Fit the LONG side to `res` so the whole graphic lands inside the box.
+    const fitTo = iw >= ih
+        ? { mode: "width", value: res }
+        : { mode: "height", value: res };
+    const img = new Resvg(ensureSvgNamespace(svg), { fitTo, ...NO_FONTS }).render();
+    const src = Buffer.from(img.pixels);
+    if (img.width === res && img.height === res) {
+        return { data: src, width: res, height: res };
+    }
+    // Centre onto a transparent res×res canvas (the padding sharp's `contain`
+    // would have added). Alpha 0 everywhere it isn't covered.
+    const out = Buffer.alloc(res * res * 4, 0);
+    const dx = Math.floor((res - img.width) / 2);
+    const dy = Math.floor((res - img.height) / 2);
+    for (let y = 0; y < img.height; y++) {
+        const ty = dy + y;
+        if (ty < 0 || ty >= res)
+            continue;
+        const from = y * img.width * 4;
+        const to = (ty * res + dx) * 4;
+        src.copy(out, to, from, from + img.width * 4);
+    }
+    return { data: out, width: res, height: res };
+}

package/dist/m0saic/agents/commit-feed/index.d.ts

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

package/dist/m0saic/agents/commit-feed/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);