@m0saic/templates 0.2.0

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

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * Highlight clips — `@m0saic/media/highlights/v1`.
+ *
+ * Pick one video, mark one or more `[startMs, endMs]` ranges (the
+ * `picker: "time-ranges"` editor, or hand-authored `--props` JSON), and
+ * every range renders as its own deliverable via an `emit:"multi"`
+ * pipeline — audio intact, canvas matched to the probed source (with an
+ * optional `maxWidth` cap), `mp4` or `webm` per batch.
+ *
+ * Rendering-model notes (rules 2/3/6/10 of the contract):
+ * - With ONE valid range the planner collapses the 1-output-step
+ *   `emit:"multi"` pipeline to a single render — the deliverable is the
+ *   bare `-o` path. Its container comes from the `outputFormat` prop via
+ *   the CLI's reserved prop-bag convention (template tier of rule 5), so
+ *   a `-o` extension that DISAGREES with the prop fails loudly at plan
+ *   time ("Output extension implies container …") rather than silently
+ *   winning — `-o clip.webm` needs `outputFormat: "webm"` too. With ≥2
+ *   ranges, each file's extension comes from its step's own format.
+ * - A CLI/UI duration override on a single-range render replaces the
+ *   authored step duration (`DURATION_MS_OVERRIDDEN_BY_CLI`) — expected
+ *   rule-5 behavior.
+ * - `outputHints` deliberately carries NO `format` — a template-level
+ *   container hint would override the user's `-o` extension in
+ *   `resolveOutputFormat`; each pipeline step declares its own format
+ *   instead (trickplay/watermark precedent).
+ * - The pipeline sets top-level `fps` from the probed source fps so
+ *   cuts aren't resampled to the engine default 30; CLI `--fps` still
+ *   wins with the `FPS_OVERRIDDEN_BY_CLI` diagnostic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Highlights = exports.MAX_RANGES = void 0;
+exports.resolveHighlightsKnobs = resolveHighlightsKnobs;
+const types_1 = require("@m0saic/types");
+const template_utils_1 = require("@m0saic/template-utils");
+const pipeline_1 = require("./pipeline");
+const onboarding_cover_1 = require("../../../_shared/onboarding-cover");
+/** Hard cap on ranges per invocation (mirrors the prop's jsonSchema). */
+exports.MAX_RANGES = 100;
+const propsSchema = (0, template_utils_1.definePropsSchema)({
+    sourceId: {
+        type: "media",
+        required: true,
+        description: "The video to pull highlight clips from.",
+        meta: {
+            ui: { label: "Source", order: 1 },
+            control: { picker: "file", accept: ["video"] },
+        },
+    },
+    ranges: {
+        type: "json",
+        required: true,
+        description: "Highlight ranges within the source video, milliseconds. Each { startMs, endMs, label? } entry becomes its own output clip; label (optional) feeds the output filename.",
+        meta: {
+            constraints: {
+                jsonSchema: {
+                    type: "array",
+                    minItems: 1,
+                    maxItems: exports.MAX_RANGES,
+                    items: {
+                        type: "object",
+                        required: ["startMs", "endMs"],
+                        properties: {
+                            startMs: { type: "integer", minimum: 0 },
+                            endMs: { type: "integer", minimum: 1 },
+                            label: { type: "string" },
+                        },
+                    },
+                },
+            },
+            control: { picker: "time-ranges", videoFromProp: "sourceId" },
+            ui: { label: "Highlight ranges", order: 2 },
+        },
+    },
+    outputFormat: {
+        type: "string",
+        required: false,
+        description: 'Container for every emitted clip: "mp4" (default) or "webm".',
+        meta: {
+            constraints: { oneOf: ["mp4", "webm"] },
+            ui: { label: "Format", order: 3 },
+        },
+    },
+    maxWidth: {
+        type: "number",
+        required: false,
+        description: "Optional output width cap in pixels — clips wider than this downscale (aspect-preserved, even-rounded). Never upscales.",
+        meta: { control: { placeholder: "source width" }, constraints: { min: 128, max: 3840 }, ui: { label: "Max width (px)", order: 4 } },
+    },
+    muteAudio: {
+        type: "boolean",
+        required: false,
+        description: "Strip the audio track from the clips. Off by default — audio passes through.",
+        meta: { ui: { label: "Mute audio", order: 5 } },
+    },
+});
+const DEFAULTS = {
+    outputFormat: "mp4",
+    muteAudio: false,
+};
+const clamp = (v, min, max) => Math.min(max, Math.max(min, v));
+/** Resolve + clamp props to deterministic step knobs. `outputFormat` is
+ * validated (not silently coerced) by render() BEFORE this runs. */
+function resolveHighlightsKnobs(props) {
+    return {
+        outputFormat: props.outputFormat === "webm" ? "webm" : "mp4",
+        ...(props.maxWidth != null && Number.isFinite(props.maxWidth)
+            ? { maxWidth: clamp(Math.round(props.maxWidth), 128, 3840) }
+            : {}),
+        muteAudio: props.muteAudio === true,
+    };
+}
+const ERROR_TITLE = "Highlights";
+exports.Highlights = {
+    id: (0, types_1.asTemplateId)("@m0saic/media/highlights/v1"),
+    label: "Highlight Clips",
+    description: "Pick a video, mark one or more time ranges, and get each range as its own clip — mp4 or webm, audio intact, one render for the whole batch.",
+    version: 1,
+    capabilities: { tier: "core" },
+    tags: ["media", "clips", "highlights", "promo", "multi-output", "creators", "marketers", "animated", "trailer", "teaser", "video"],
+    // No `format` hint on purpose (see file header): steps declare their own.
+    outputHints: {
+        format: { kind: "video", container: "mp4" },
+        width: 1920,
+        height: 1080,
+        fps: 30,
+        durationMs: 5000,
+    },
+    propsSchema,
+    defaultProps: { ...DEFAULTS },
+    async render(props, ctx) {
+        const fail = (message) => (0, template_utils_1.makeErrorMosaic)(message, {
+            title: ERROR_TITLE,
+            width: ctx.target.width,
+            height: ctx.target.height,
+        });
+        const sourceId = props.sourceId;
+        if (!sourceId) {
+            return fail('Missing required "Source": pick the video to pull highlight clips from.');
+        }
+        if (props.outputFormat !== undefined &&
+            props.outputFormat !== "mp4" &&
+            props.outputFormat !== "webm") {
+            return fail(`Unsupported outputFormat "${String(props.outputFormat)}" — use "mp4" or "webm".`);
+        }
+        const parsed = (0, template_utils_1.parseTimeRangesValue)(props.ranges);
+        if (!parsed.ok) {
+            return fail(parsed.error);
+        }
+        if (parsed.ranges.length === 0) {
+            return fail("Ranges are empty — mark at least one { startMs, endMs } highlight range.");
+        }
+        if (parsed.ranges.length > exports.MAX_RANGES) {
+            return fail(`Too many ranges (${parsed.ranges.length}) — the cap is ${exports.MAX_RANGES}.`);
+        }
+        const meta = ctx.media[(0, types_1.asAssetId)(sourceId)];
+        if (!meta || !(meta.width > 0) || !(meta.height > 0)) {
+            return fail(`No probed dimensions for input: ${sourceId}`);
+        }
+        if (meta.kind !== "video") {
+            return fail(`Highlights needs a video input (kind: ${meta.kind}): ${sourceId}`);
+        }
+        if (!(meta.durationMs != null && meta.durationMs > 0)) {
+            return fail(`Video input has no probed duration: ${sourceId}`);
+        }
+        const knobs = resolveHighlightsKnobs(props);
+        const stepBaseName = (0, template_utils_1.buildStepNames)([sourceId])[0];
+        const steps = (0, pipeline_1.buildHighlightSteps)({
+            inputPath: sourceId,
+            stepBaseName,
+            ranges: parsed.ranges,
+            sourceDurationMs: meta.durationMs,
+            sourceWidth: meta.width,
+            sourceHeight: meta.height,
+            knobs,
+            ctx,
+        });
+        const sourceFps = meta.fps != null && meta.fps > 0 ? Math.max(1, Math.round(meta.fps)) : undefined;
+        return {
+            kind: "mosaic_pipeline",
+            version: 1,
+            emit: "multi",
+            ...(sourceFps !== undefined ? { fps: sourceFps } : {}),
+            steps,
+        };
+    },
+    // Editor-only first-open cover — the mosaic-branding BAND: the REAL
+    // ranges-picker screenshot (bundled asset, web-safe string-concat path —
+    // this template is web-registered and node:path breaks the web build)
+    // above the brand band. Browser falls back to a dark stage.
+    async renderCover(_props, ctx) {
+        var _a;
+        const isNode = typeof process !== "undefined" && !!((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node);
+        const unpackedAsar = (p) => p.includes("/app.asar/")
+            ? p.split("/app.asar/").join("/app.asar.unpacked/")
+            : p.split("\\app.asar\\").join("\\app.asar.unpacked\\");
+        const coverAsset = isNode
+            ? {
+                kind: "file",
+                path: unpackedAsar(`${__dirname}/assets/cover-ranges.jpg`),
+                mediaType: "image",
+            }
+            : null;
+        const heroSource = coverAsset
+            ? {
+                type: "media",
+                mediaType: "image",
+                assetId: (0, types_1.asAssetId)("cover-ranges"),
+                placement: { fit: "contain" },
+                editor: { owner: "template", label: "highlights:cover-screenshot" },
+            }
+            : (0, template_utils_1.makeColorTile)("#1c2530");
+        return (0, onboarding_cover_1.buildBrandedCover)({
+            ctx,
+            variant: "band",
+            copy: { productName: "Highlight Clips", title: "Mark ranges; each renders as its own clip." },
+            hero: (theme) => (0, onboarding_cover_1.onboardingFrame)({ m0: "1", sources: [heroSource] }, theme.borderStrong),
+            heroAssets: (coverAsset ? { "cover-ranges": coverAsset } : {}),
+        });
+    },
+};
+(0, template_utils_1.registerTemplate)(exports.Highlights);

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

@@ -0,0 +1,3 @@
+export { Highlights, resolveHighlightsKnobs, MAX_RANGES, type HighlightsV1Props } from "./highlights";
+export { defaultRangeLabel, fmtRangeSeconds, inputLabel, rangeStepName, sanitizeLabel, scaleToMaxWidth, type HighlightsKnobs, type HighlightsOutputFormat, } from "./plan";
+export { buildHighlightSteps, ERROR_STEP_MS } from "./pipeline";

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

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_STEP_MS = exports.buildHighlightSteps = exports.scaleToMaxWidth = exports.sanitizeLabel = exports.rangeStepName = exports.inputLabel = exports.fmtRangeSeconds = exports.defaultRangeLabel = exports.MAX_RANGES = exports.resolveHighlightsKnobs = exports.Highlights = void 0;
+var highlights_1 = require("./highlights");
+Object.defineProperty(exports, "Highlights", { enumerable: true, get: function () { return highlights_1.Highlights; } });
+Object.defineProperty(exports, "resolveHighlightsKnobs", { enumerable: true, get: function () { return highlights_1.resolveHighlightsKnobs; } });
+Object.defineProperty(exports, "MAX_RANGES", { enumerable: true, get: function () { return highlights_1.MAX_RANGES; } });
+// NOTE: `evenRound` stays un-re-exported — trickplay's barrel already
+// exports one and both feed the media pack's star exports.
+var plan_1 = require("./plan");
+Object.defineProperty(exports, "defaultRangeLabel", { enumerable: true, get: function () { return plan_1.defaultRangeLabel; } });
+Object.defineProperty(exports, "fmtRangeSeconds", { enumerable: true, get: function () { return plan_1.fmtRangeSeconds; } });
+Object.defineProperty(exports, "inputLabel", { enumerable: true, get: function () { return plan_1.inputLabel; } });
+Object.defineProperty(exports, "rangeStepName", { enumerable: true, get: function () { return plan_1.rangeStepName; } });
+Object.defineProperty(exports, "sanitizeLabel", { enumerable: true, get: function () { return plan_1.sanitizeLabel; } });
+Object.defineProperty(exports, "scaleToMaxWidth", { enumerable: true, get: function () { return plan_1.scaleToMaxWidth; } });
+var pipeline_1 = require("./pipeline");
+Object.defineProperty(exports, "buildHighlightSteps", { enumerable: true, get: function () { return pipeline_1.buildHighlightSteps; } });
+Object.defineProperty(exports, "ERROR_STEP_MS", { enumerable: true, get: function () { return pipeline_1.ERROR_STEP_MS; } });

package/dist/m0saic/media/highlights/v1/pipeline.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Per-range step builder for the highlights pipeline.
+ *
+ * One valid range → one pipeline step: a hermetic single-cell document
+ * (m0 `"1"`, own assets manifest) whose one source is the input video
+ * trimmed via the engine's playback primitive
+ * (`clipStartMs` + `clipDurationMs`, `loopMode: "cut"`). Audio is left
+ * UNSET so the cut keeps the source's synced audio; the `muteAudio`
+ * knob opts out per-source. Each step declares its own canvas (probed
+ * dims, maxWidth-capped) and its own `format` — the per-step format is
+ * what gives an `emit:"multi"` batch correct per-file containers.
+ *
+ * Invalid ranges degrade to per-range error steps that keep their
+ * positional name/label slot, so one bad range never kills the batch
+ * (trickplay/watermark philosophy).
+ */
+import type { MosaicEngineContext, MosaicPipelineStep, MosaicTimeRangeMs } from "@m0saic/types";
+import { type HighlightsKnobs } from "./plan";
+/** Duration used for error-mosaic steps (bad ranges). */
+export declare const ERROR_STEP_MS = 1000;
+/**
+ * Build the pipeline steps for the input: one step per range, in the
+ * given order (never sorted — step names and output files are
+ * positional).
+ */
+export declare function buildHighlightSteps(args: {
+    inputPath: string;
+    stepBaseName: string;
+    ranges: MosaicTimeRangeMs[];
+    sourceDurationMs: number;
+    sourceWidth: number;
+    sourceHeight: number;
+    knobs: HighlightsKnobs;
+    ctx: MosaicEngineContext;
+}): MosaicPipelineStep[];

package/dist/m0saic/media/highlights/v1/pipeline.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Per-range step builder for the highlights pipeline.
+ *
+ * One valid range → one pipeline step: a hermetic single-cell document
+ * (m0 `"1"`, own assets manifest) whose one source is the input video
+ * trimmed via the engine's playback primitive
+ * (`clipStartMs` + `clipDurationMs`, `loopMode: "cut"`). Audio is left
+ * UNSET so the cut keeps the source's synced audio; the `muteAudio`
+ * knob opts out per-source. Each step declares its own canvas (probed
+ * dims, maxWidth-capped) and its own `format` — the per-step format is
+ * what gives an `emit:"multi"` batch correct per-file containers.
+ *
+ * Invalid ranges degrade to per-range error steps that keep their
+ * positional name/label slot, so one bad range never kills the batch
+ * (trickplay/watermark philosophy).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_STEP_MS = void 0;
+exports.buildHighlightSteps = buildHighlightSteps;
+const types_1 = require("@m0saic/types");
+const dsl_stdlib_1 = require("@m0saic/dsl-stdlib");
+const template_utils_1 = require("@m0saic/template-utils");
+const plan_1 = require("./plan");
+/** Duration used for error-mosaic steps (bad ranges). */
+exports.ERROR_STEP_MS = 1000;
+const ERROR_TITLE = "Highlights";
+function errorStep(stepName, label, message, ctx) {
+    return {
+        name: stepName,
+        label,
+        durationMs: exports.ERROR_STEP_MS,
+        file: (0, template_utils_1.makeErrorMosaic)(message, {
+            title: ERROR_TITLE,
+            width: ctx.target.width,
+            height: ctx.target.height,
+        }),
+    };
+}
+/**
+ * Build the pipeline steps for the input: one step per range, in the
+ * given order (never sorted — step names and output files are
+ * positional).
+ */
+function buildHighlightSteps(args) {
+    const { inputPath, stepBaseName, ranges, knobs, ctx } = args;
+    const labelBase = (0, plan_1.inputLabel)(inputPath);
+    const verdicts = (0, template_utils_1.normalizeTimeRanges)(ranges, args.sourceDurationMs);
+    const assetId = (0, types_1.asAssetId)((0, template_utils_1.slugifyAssetKeyFromPath)(inputPath));
+    const assets = {
+        [assetId]: { kind: "file", path: inputPath, mediaType: "video" },
+    };
+    const size = (0, plan_1.scaleToMaxWidth)(args.sourceWidth, args.sourceHeight, knobs.maxWidth);
+    return verdicts.map((verdict, i) => {
+        const name = (0, plan_1.rangeStepName)(stepBaseName, i);
+        if (!verdict.ok) {
+            const label = (verdict.range.label !== undefined ? (0, plan_1.sanitizeLabel)(verdict.range.label) : "") ||
+                (0, plan_1.defaultRangeLabel)(labelBase, verdict.range.startMs, verdict.range.endMs);
+            return errorStep(name, label, `Range ${i + 1} invalid: ${verdict.reason}`, ctx);
+        }
+        const { startMs, endMs } = verdict;
+        const label = (verdict.label !== undefined ? (0, plan_1.sanitizeLabel)(verdict.label) : "") ||
+            (0, plan_1.defaultRangeLabel)(labelBase, startMs, endMs);
+        const source = {
+            type: "media",
+            mediaType: "video",
+            assetId,
+            // Cell aspect == source aspect up to even-rounding, so cover is
+            // an exact fit (no visible crop).
+            placement: { fit: "cover" },
+            playback: { clipStartMs: startMs, clipDurationMs: endMs - startMs, loopMode: "cut" },
+            ...(knobs.muteAudio ? { audio: { enabled: false } } : {}),
+            editor: { owner: "template" },
+        };
+        const doc = {
+            kind: "mosaic_document",
+            version: 1,
+            m0: (0, dsl_stdlib_1.toM0String)("1", ERROR_TITLE),
+            assets,
+            sources: [source],
+            size,
+            backgroundColor: "#000000",
+            format: { kind: "video", container: knobs.outputFormat },
+            // Doc-level disable is what actually STRIPS the track (`-an` on the
+            // deliverable). The source-level knob above only mutes the mix
+            // contribution — alone it ships a silent placeholder track.
+            ...(knobs.muteAudio ? { audio: { mode: "off" } } : {}),
+        };
+        return { name, label, durationMs: endMs - startMs, file: doc };
+    });
+}

package/dist/m0saic/media/highlights/v1/plan.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Pure math + naming for `@m0saic/media/highlights/v1`.
+ *
+ * No IO, no ffmpeg, no ctx — everything here is unit-testable in
+ * isolation (trickplay's `plan.ts` precedent). Range parsing/clamping
+ * itself lives in `@m0saic/template-utils` (`parseTimeRangesValue` /
+ * `normalizeTimeRanges`) so the next ranges-consuming template reuses
+ * it; this module owns what is highlights-specific: step naming, label
+ * derivation, and output-canvas sizing.
+ */
+export type HighlightsOutputFormat = "mp4" | "webm";
+/** Resolved knobs a step needs (validated once by the template). */
+export type HighlightsKnobs = {
+    outputFormat: HighlightsOutputFormat;
+    /** Optional downscale cap (px). Never upscales. */
+    maxWidth?: number;
+    muteAudio: boolean;
+};
+/** Step name for range `rangeIndex` (0-based → `__range_01`). Positional
+ * across ALL ranges including invalid slots, so names stay stable. */
+export declare function rangeStepName(stepBaseName: string, rangeIndex: number): string;
+/** Input basename without directory or extension — the label base.
+ * Local (not node:path) so the template stays web-bundle clean. */
+export declare function inputLabel(p: string): string;
+/** Seconds with one decimal, for default labels: 5300 → "5.3s". */
+export declare function fmtRangeSeconds(ms: number): string;
+/**
+ * Filename-safe label: path-hostile characters collapse to `_`
+ * (`expandOutputPattern` does NOT sanitize `{{label}}`), trimmed,
+ * capped at 64 chars. Returns "" when nothing survives — callers
+ * fall back to {@link defaultRangeLabel}.
+ */
+export declare function sanitizeLabel(label: string): string;
+/** Default per-range label: `<input>_<start>-<end>` (e.g. `hero_1_0.5s-2.0s`). */
+export declare function defaultRangeLabel(inputBase: string, startMs: number, endMs: number): string;
+/** Nearest even integer ≥ 2 (yuv420p-safe dimensions). */
+export declare function evenRound(v: number): number;
+/**
+ * Output canvas from probed source dims: even-rounded always, and
+ * aspect-preservingly downscaled when `maxWidth` is set below the
+ * source width. Never upscales.
+ */
+export declare function scaleToMaxWidth(width: number, height: number, maxWidth?: number): {
+    width: number;
+    height: number;
+};

package/dist/m0saic/media/highlights/v1/plan.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Pure math + naming for `@m0saic/media/highlights/v1`.
+ *
+ * No IO, no ffmpeg, no ctx — everything here is unit-testable in
+ * isolation (trickplay's `plan.ts` precedent). Range parsing/clamping
+ * itself lives in `@m0saic/template-utils` (`parseTimeRangesValue` /
+ * `normalizeTimeRanges`) so the next ranges-consuming template reuses
+ * it; this module owns what is highlights-specific: step naming, label
+ * derivation, and output-canvas sizing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rangeStepName = rangeStepName;
+exports.inputLabel = inputLabel;
+exports.fmtRangeSeconds = fmtRangeSeconds;
+exports.sanitizeLabel = sanitizeLabel;
+exports.defaultRangeLabel = defaultRangeLabel;
+exports.evenRound = evenRound;
+exports.scaleToMaxWidth = scaleToMaxWidth;
+/** Step name for range `rangeIndex` (0-based → `__range_01`). Positional
+ * across ALL ranges including invalid slots, so names stay stable. */
+function rangeStepName(stepBaseName, rangeIndex) {
+    return `${stepBaseName}__range_${String(rangeIndex + 1).padStart(2, "0")}`;
+}
+/** Input basename without directory or extension — the label base.
+ * Local (not node:path) so the template stays web-bundle clean. */
+function inputLabel(p) {
+    var _a;
+    const base = (_a = p.split(/[\\/]/).pop()) !== null && _a !== void 0 ? _a : p;
+    const dot = base.lastIndexOf(".");
+    return dot > 0 ? base.slice(0, dot) : base;
+}
+/** Seconds with one decimal, for default labels: 5300 → "5.3s". */
+function fmtRangeSeconds(ms) {
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+/**
+ * Filename-safe label: path-hostile characters collapse to `_`
+ * (`expandOutputPattern` does NOT sanitize `{{label}}`), trimmed,
+ * capped at 64 chars. Returns "" when nothing survives — callers
+ * fall back to {@link defaultRangeLabel}.
+ */
+function sanitizeLabel(label) {
+    return label
+        .replace(/[^A-Za-z0-9._-]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .slice(0, 64);
+}
+/** Default per-range label: `<input>_<start>-<end>` (e.g. `hero_1_0.5s-2.0s`). */
+function defaultRangeLabel(inputBase, startMs, endMs) {
+    return sanitizeLabel(`${inputBase}_${fmtRangeSeconds(startMs)}-${fmtRangeSeconds(endMs)}`);
+}
+/** Nearest even integer ≥ 2 (yuv420p-safe dimensions). */
+function evenRound(v) {
+    return Math.max(2, Math.round(v / 2) * 2);
+}
+/**
+ * Output canvas from probed source dims: even-rounded always, and
+ * aspect-preservingly downscaled when `maxWidth` is set below the
+ * source width. Never upscales.
+ */
+function scaleToMaxWidth(width, height, maxWidth) {
+    if (maxWidth != null && maxWidth > 0 && width > maxWidth) {
+        const scale = maxWidth / width;
+        return { width: evenRound(maxWidth), height: evenRound(height * scale) };
+    }
+    return { width: evenRound(width), height: evenRound(height) };
+}

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

@@ -0,0 +1,13 @@
+export { Barcode } from "./barcode/v1";
+export * from "./blur-regions";
+export * from "./highlights";
+export * from "./logo-animate";
+export * from "./metadata-stamp";
+export * from "./qr";
+export * from "./screencap_grid";
+export * from "./screencap_grid_aspect_safe";
+export * from "./scroll_wall";
+export * from "./subtitle-burn";
+export * from "./trickplay";
+export * from "./video_to_png_sequence";
+export * from "./watermark";

package/dist/m0saic/media/index.js

@@ -0,0 +1,31 @@
+"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 });
+exports.Barcode = void 0;
+var v1_1 = require("./barcode/v1");
+Object.defineProperty(exports, "Barcode", { enumerable: true, get: function () { return v1_1.Barcode; } });
+__exportStar(require("./blur-regions"), exports);
+__exportStar(require("./highlights"), exports);
+__exportStar(require("./logo-animate"), exports);
+__exportStar(require("./metadata-stamp"), exports);
+__exportStar(require("./qr"), exports);
+__exportStar(require("./screencap_grid"), exports);
+__exportStar(require("./screencap_grid_aspect_safe"), exports);
+__exportStar(require("./scroll_wall"), exports);
+__exportStar(require("./subtitle-burn"), exports);
+__exportStar(require("./trickplay"), exports);
+__exportStar(require("./video_to_png_sequence"), exports);
+__exportStar(require("./watermark"), exports);

package/dist/m0saic/media/logo-animate/index.d.ts

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

package/dist/m0saic/media/logo-animate/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/logo-animate/v1/default-logo.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Baked placeholder logo for `@m0saic/media/logo-animate/v1` — the m0saic
+ * "M" mark (33 rectilinear shapes, 272×272 viewBox). Used only when the
+ * caller supplies neither `svg` nor `svgPath`, so the template renders a
+ * real animation out of the box (defaultProps must render standalone).
+ *
+ * Same geometry as `packages/dsl-stdlib/__fixtures__/svg/mlogo_v2/
+ * 01-normalized.svg`; baked as a constant because templates cannot read
+ * fixture files from other packages at render time (the inline path must
+ * stay pure).
+ */
+export declare const DEFAULT_LOGO_SVG = "<svg width=\"272\" height=\"272\" viewBox=\"0 0 272 272\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\">\n<path d=\"M19.7296 0.010376H0.0599976V48.117H19.7296V0.010376Z\" fill=\"#EF7525\"/>\n<path d=\"M34.9327 55.9604H0V104.067H34.9327V55.9604Z\" fill=\"#EF7525\"/>\n<path d=\"M62.2438 111.931H34.9327V160.038H62.2438V111.931Z\" fill=\"#EF7525\"/>\n<path d=\"M27.3212 111.931H0V160.038H27.3212V111.931Z\" fill=\"#EF7525\"/>\n<path d=\"M34.9327 167.912H0V216.019H34.9327V167.912Z\" fill=\"#EF7525\"/>\n<path d=\"M62.1336 223.893H27.3712V272H62.1336V223.893Z\" fill=\"#EF7525\"/>\n<path d=\"M19.7197 223.893H0.0100098V272H19.7197V223.893Z\" fill=\"#EF7525\"/>\n<path d=\"M131.799 111.931H103.496V160.038H131.799V111.931Z\" fill=\"#EF7525\"/>\n<path d=\"M174.503 56.0122L163.737 55.9915L139.49 89.6651V104.088L174.503 104.119V56.0122Z\" fill=\"#EF7525\"/>\n<path d=\"M118.248 104.067H131.799V89.52L107.582 55.9604H69.675V104.067H115.614H118.248Z\" fill=\"#EF7525\"/>\n<path d=\"M91.3477 33.9223L69.675 3.38805V48.1067H101.924L91.3477 33.9223Z\" fill=\"#EF7525\"/>\n<path d=\"M180.422 32.8758L169.886 48.1067H180.051H181.574H201.754V3.34662L180.422 32.9172V32.8758Z\" fill=\"#EF7525\"/>\n<path d=\"M139.49 160.069H165.81L200.512 111.962H139.49V160.069Z\" fill=\"#EF7525\"/>\n<path d=\"M95.8845 148.278L95.8946 111.931H69.675L95.8845 148.278Z\" fill=\"#EF7525\"/>\n<path d=\"M135.054 202.612L160.151 167.912L110.036 167.902L135.054 202.612Z\" fill=\"#EF7525\"/>\n<path d=\"M62.1738 55.9604H42.5742V75.6776H62.1738V55.9604Z\" fill=\"#EF7525\"/>\n<path d=\"M62.1738 83.5313H42.5742V104.057H62.1738V83.5313Z\" fill=\"#EF7525\"/>\n<path d=\"M182.185 104.088L201.714 104.067V55.9604L182.185 55.9915V104.088Z\" fill=\"#EF7525\"/>\n<path d=\"M62.1837 0.010376H27.3312V48.117H62.1837V0.010376Z\" fill=\"#EF7525\"/>\n<path d=\"M62.0736 167.912H42.5141V187.629H62.0736V167.912Z\" fill=\"#EF7525\"/>\n<path d=\"M62.0736 195.494H42.5141V216.019H62.0736V195.494Z\" fill=\"#EF7525\"/>\n<path d=\"M271.95 223.883H252.28V271.99H271.95V223.883Z\" fill=\"#EF7525\"/>\n<path d=\"M272 167.933H237.067V216.04H272V167.933Z\" fill=\"#EF7525\"/>\n<path d=\"M237.067 111.952H209.756V160.059H237.067V111.952Z\" fill=\"#EF7525\"/>\n<path d=\"M272 111.952H244.679V160.059H272V111.952Z\" fill=\"#EF7525\"/>\n<path d=\"M272 55.9707H237.067V104.077H272V55.9707Z\" fill=\"#EF7525\"/>\n<path d=\"M244.629 0H209.866V48.1067H244.629V0Z\" fill=\"#EF7525\"/>\n<path d=\"M271.99 0H252.28V48.1067H271.99V0Z\" fill=\"#EF7525\"/>\n<path d=\"M229.426 196.322H209.826V216.04H229.426V196.322Z\" fill=\"#EF7525\"/>\n<path d=\"M229.426 167.933H209.826V188.458H229.426V167.933Z\" fill=\"#EF7525\"/>\n<path d=\"M244.679 223.883H209.826V271.99H244.679V223.883Z\" fill=\"#EF7525\"/>\n<path d=\"M229.486 84.3602H209.926V104.077H229.486V84.3602Z\" fill=\"#EF7525\"/>\n<path d=\"M229.486 55.9707H209.926V76.4961H229.486V55.9707Z\" fill=\"#EF7525\"/>\n</svg>";

package/dist/m0saic/media/logo-animate/v1/default-logo.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Baked placeholder logo for `@m0saic/media/logo-animate/v1` — the m0saic
+ * "M" mark (33 rectilinear shapes, 272×272 viewBox). Used only when the
+ * caller supplies neither `svg` nor `svgPath`, so the template renders a
+ * real animation out of the box (defaultProps must render standalone).
+ *
+ * Same geometry as `packages/dsl-stdlib/__fixtures__/svg/mlogo_v2/
+ * 01-normalized.svg`; baked as a constant because templates cannot read
+ * fixture files from other packages at render time (the inline path must
+ * stay pure).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LOGO_SVG = void 0;
+exports.DEFAULT_LOGO_SVG = `<svg width="272" height="272" viewBox="0 0 272 272" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M19.7296 0.010376H0.0599976V48.117H19.7296V0.010376Z" fill="#EF7525"/>
+<path d="M34.9327 55.9604H0V104.067H34.9327V55.9604Z" fill="#EF7525"/>
+<path d="M62.2438 111.931H34.9327V160.038H62.2438V111.931Z" fill="#EF7525"/>
+<path d="M27.3212 111.931H0V160.038H27.3212V111.931Z" fill="#EF7525"/>
+<path d="M34.9327 167.912H0V216.019H34.9327V167.912Z" fill="#EF7525"/>
+<path d="M62.1336 223.893H27.3712V272H62.1336V223.893Z" fill="#EF7525"/>
+<path d="M19.7197 223.893H0.0100098V272H19.7197V223.893Z" fill="#EF7525"/>
+<path d="M131.799 111.931H103.496V160.038H131.799V111.931Z" fill="#EF7525"/>
+<path d="M174.503 56.0122L163.737 55.9915L139.49 89.6651V104.088L174.503 104.119V56.0122Z" fill="#EF7525"/>
+<path d="M118.248 104.067H131.799V89.52L107.582 55.9604H69.675V104.067H115.614H118.248Z" fill="#EF7525"/>
+<path d="M91.3477 33.9223L69.675 3.38805V48.1067H101.924L91.3477 33.9223Z" fill="#EF7525"/>
+<path d="M180.422 32.8758L169.886 48.1067H180.051H181.574H201.754V3.34662L180.422 32.9172V32.8758Z" fill="#EF7525"/>
+<path d="M139.49 160.069H165.81L200.512 111.962H139.49V160.069Z" fill="#EF7525"/>
+<path d="M95.8845 148.278L95.8946 111.931H69.675L95.8845 148.278Z" fill="#EF7525"/>
+<path d="M135.054 202.612L160.151 167.912L110.036 167.902L135.054 202.612Z" fill="#EF7525"/>
+<path d="M62.1738 55.9604H42.5742V75.6776H62.1738V55.9604Z" fill="#EF7525"/>
+<path d="M62.1738 83.5313H42.5742V104.057H62.1738V83.5313Z" fill="#EF7525"/>
+<path d="M182.185 104.088L201.714 104.067V55.9604L182.185 55.9915V104.088Z" fill="#EF7525"/>
+<path d="M62.1837 0.010376H27.3312V48.117H62.1837V0.010376Z" fill="#EF7525"/>
+<path d="M62.0736 167.912H42.5141V187.629H62.0736V167.912Z" fill="#EF7525"/>
+<path d="M62.0736 195.494H42.5141V216.019H62.0736V195.494Z" fill="#EF7525"/>
+<path d="M271.95 223.883H252.28V271.99H271.95V223.883Z" fill="#EF7525"/>
+<path d="M272 167.933H237.067V216.04H272V167.933Z" fill="#EF7525"/>
+<path d="M237.067 111.952H209.756V160.059H237.067V111.952Z" fill="#EF7525"/>
+<path d="M272 111.952H244.679V160.059H272V111.952Z" fill="#EF7525"/>
+<path d="M272 55.9707H237.067V104.077H272V55.9707Z" fill="#EF7525"/>
+<path d="M244.629 0H209.866V48.1067H244.629V0Z" fill="#EF7525"/>
+<path d="M271.99 0H252.28V48.1067H271.99V0Z" fill="#EF7525"/>
+<path d="M229.426 196.322H209.826V216.04H229.426V196.322Z" fill="#EF7525"/>
+<path d="M229.426 167.933H209.826V188.458H229.426V167.933Z" fill="#EF7525"/>
+<path d="M244.679 223.883H209.826V271.99H244.679V223.883Z" fill="#EF7525"/>
+<path d="M229.486 84.3602H209.926V104.077H229.486V84.3602Z" fill="#EF7525"/>
+<path d="M229.486 55.9707H209.926V76.4961H229.486V55.9707Z" fill="#EF7525"/>
+</svg>`;