@clipwright/core 0.33.0 → 0.34.0

package/dist/templates/sounds.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+// Template sounds (#778 S3c): the owner's library of 23.10, one list of names per beat, with his default first in each.
+export const TEMPLATE_SOUND_BEATS = ["click", "toggle", "ring", "answer", "notify", "step", "whoosh", "flash"];
+/** Each beat's names, its default and where it plays; the composition bundles `<beat>__<name>.mp3` for each, and a test keeps the two equal. */
+export const TEMPLATE_SOUNDS = {
+    click: { default: "click_mouse", names: ["click_mouse", "click_soft", "click_crisp", "click_light"],
+        plays: "a checklist's cursor clicks a row, on each click" },
+    toggle: { default: "switch_flip", names: ["switch_flip", "toggle_snap", "switch_heavy", "switch_light"],
+        plays: "a checklist row's switch or check box lands, just after each click" },
+    ring: { default: "ring_classic", names: ["ring_classic", "ring_marimba", "ring_digital"],
+        plays: "a phone_call rings from its pop, repeating, until it is answered" },
+    answer: { default: "answer_confirm", names: ["answer_confirm", "answer_open", "answer_pop", "answer_select"],
+        plays: "a phone_call is answered, on answer_at" },
+    notify: { default: "chime", names: ["chime", "glass_ping", "glass_soft", "bong", "question_ping"], plays: "a notification drops in" },
+    step: { default: "drop", names: ["drop", "drop_high", "tick", "pluck", "pluck_bright"], plays: "a progress step fills, and each rating star" },
+    whoosh: { default: "whoosh", names: ["whoosh", "whip", "paper_swipe", "sweep"],
+        plays: "a full-frame template's wipe or zoom, in and out, and a compare's reveal" },
+    flash: { default: "shutter", names: ["shutter", "glitch"], plays: "a full-frame template's flash, on each of its cuts" },
+};
+/** The beats each kind plays over the presenter; a full-frame template adds its transition's beat (see `templateSoundBeats`). */
+export const TEMPLATE_KIND_SOUNDS = {
+    checklist: ["click", "toggle"], phone_call: ["ring", "answer"], notification: ["notify"], progress: ["step"], rating: ["step"], compare: ["whoosh"],
+};
+export const DEFAULT_TEMPLATE_SOUNDS = Object.freeze(Object.fromEntries(TEMPLATE_SOUND_BEATS.map(beat => [beat, TEMPLATE_SOUNDS[beat].default])));
+const name = (beat) => z.enum(TEMPLATE_SOUNDS[beat].names, {
+    error: issue => `${JSON.stringify(issue.input)} is not a ${beat} sound: use ${TEMPLATE_SOUNDS[beat].names.join(", ")}`,
+}).optional();
+const overrides = z.strictObject({ click: name("click"), toggle: name("toggle"), ring: name("ring"), answer: name("answer"), notify: name("notify"),
+    step: name("step"), whoosh: name("whoosh"), flash: name("flash") }, {
+    error: issue => (issue.code === "unrecognized_keys" ? `template_sounds has no beat ${issue.keys.join(", ")}: the beats are ${TEMPLATE_SOUND_BEATS.join(", ")}` : undefined),
+});
+/** Why a value cannot be the field, with the beat's path; a union names no branch on its own, so the message does. */
+function soundsRefusal(input) {
+    if (input === null || typeof input !== "object" || Array.isArray(input))
+        return "template_sounds is false (no sounds) or { beat: name }";
+    const issue = overrides.safeParse(input).error?.issues[0];
+    // zod 4.6 may surface the unknown-beat issue past the union, so that message carries its own path.
+    if (issue?.code === "unrecognized_keys")
+        return issue.message;
+    return `${["template_sounds", ...(issue?.path ?? []).map(String)].join(".")} ${issue?.message ?? "is invalid"}`;
+}
+export const templateSounds = z.union([z.literal(false), overrides], { error: issue => soundsRefusal(issue.input) })
+    .describe("Template sounds: false for none, or { beat: name } over the defaults; list_template_sounds names them.");
+/** The slim MCP field, which keeps tools/list small: any beat and name pass here, and the server checks them strictly (S3 D3). */
+export const mcpTemplateSounds = z.union([z.literal(false), z.record(z.string(), z.string())]).describe(templateSounds.description);
+/** A run's sounds: the defaults with its overrides, or none for `false` (S3c C2, C4). */
+export function templateSoundMap(sounds) {
+    return sounds === false ? undefined : { ...DEFAULT_TEMPLATE_SOUNDS, ...sounds };
+}
+/** The beats one template plays: its kind's, and on a full frame its wipe or zoom (whoosh) or flash. */
+export function templateSoundBeats(item) {
+    const transition = item.placement !== "full" ? [] : item.transition === "wipe" || item.transition === "zoom" ? ["whoosh"]
+        : item.transition === "flash" ? ["flash"] : [];
+    return [...new Set([...(TEMPLATE_KIND_SOUNDS[item.kind] ?? []), ...transition])];
+}
+export const TEMPLATE_SOUNDS_PATH = "/v1/template-sounds";
+/** The catalog `GET /v1/template-sounds` and `list_template_sounds` return. */
+export const templateSoundsList = z.strictObject({
+    beats: z.array(z.strictObject({ beat: z.enum(TEMPLATE_SOUND_BEATS), default: z.string().min(1), names: z.array(z.string().min(1)).min(1),
+        plays: z.string().min(1) })),
+    contract_version: z.string().min(1),
+});
+export function listTemplateSounds() {
+    return TEMPLATE_SOUND_BEATS.map(beat => ({ beat, default: TEMPLATE_SOUNDS[beat].default, names: [...TEMPLATE_SOUNDS[beat].names],
+        plays: TEMPLATE_SOUNDS[beat].plays }));
+}
+//# sourceMappingURL=sounds.js.map

package/dist/templates/sounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sounds.js","sourceRoot":"","sources":["../../src/templates/sounds.ts"],"names":[],"mappings":"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"}

package/dist/templates/stat.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import type { TemplateKind } from "./index.js";
+/** The number at medium on a 1080 short side over the presenter; on a full frame it draws 1.6 times larger. */
+export declare const STAT_FONT_PX = 120;
+/** The drawn area is this many number sizes high: the number and its label; the composition reads the size back. */
+export declare const STAT_RECT_EMS = 1.9;
+declare const data: z.ZodObject<{
+    value: z.ZodNumber;
+    prefix: z.ZodOptional<z.ZodString>;
+    suffix: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodEnum<{
+        large: "large";
+        medium: "medium";
+        small: "small";
+    }>>;
+}, z.core.$strict>;
+/** A number that counts up from zero to `value`, with an optional prefix, suffix and label under it. */
+export declare const stat: TemplateKind<typeof data>;
+export {};

package/dist/templates/stat.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { frameCanvasOf } from "../ugc-layers.js";
+import { sizedScale, templateSize } from "./size.js";
+/** The number at medium on a 1080 short side over the presenter; on a full frame it draws 1.6 times larger. */
+export const STAT_FONT_PX = 120;
+const FULL_SCALE = 1.6;
+/** The drawn area is this many number sizes high: the number and its label; the composition reads the size back. */
+export const STAT_RECT_EMS = 1.9;
+const data = z.object({ value: z.number().min(0).max(999_999_999).multipleOf(0.01), prefix: z.string().min(1).max(6).optional(),
+    suffix: z.string().min(1).max(6).optional(), label: z.string().min(1).max(32).optional(), size: templateSize }).strict();
+/** A number that counts up from zero to `value`, with an optional prefix, suffix and label under it. */
+export const stat = {
+    kind: "stat",
+    kindVersion: 1,
+    description: "a number counting up from 0 to value (up to 2 decimals), with prefix and suffix around it and a label under it; " +
+        "full fills the frame, over sits at chest level on a card",
+    placements: ["full", "over"],
+    data,
+    text: { prefix: 6, suffix: 6, label: 32 },
+    slots: {},
+    hidesCaptions: () => false,
+    onInserts: false,
+    rect: (value, aspectRatio, placement) => {
+        const canvas = frameCanvasOf(aspectRatio), { width: w, height: h } = canvas, short = Math.min(w, h);
+        const scale = sizedScale(value.size, canvas) * (placement === "full" ? FULL_SCALE : 1);
+        const width = Math.round(Math.min(0.9 * w, 1.1 * short * Math.min(scale, 1))), height = Math.round(STAT_RECT_EMS * STAT_FONT_PX * scale);
+        // Over the presenter it sits at chest level, as the reference's toggle card (62–80% of the height), off the face.
+        const centre = placement === "full" ? 0.5 : 0.71;
+        return { left: Math.round((w - width) / 2) / w, top: Math.round(centre * h - height / 2) / h, width: width / w, height: height / h };
+    },
+    sample: { value: 17, prefix: "$", suffix: "M", label: "raised this year" },
+};
+//# sourceMappingURL=stat.js.map

package/dist/templates/stat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat.js","sourceRoot":"","sources":["../../src/templates/stat.ts"],"names":[],"mappings":"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"}

package/dist/templates/tag.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { TemplateKind } from "./index.js";
+export declare const TAG_POSITIONS: readonly ["top", "center", "bottom"];
+/** The pill's text at medium on a 1080 short side: the reference pill's cap height, about 3.5% of a 9:16 frame. */
+export declare const TAG_FONT_PX = 92;
+/** The footprint is this many font sizes high: the pill and its glow; the composition reads the font back from it. */
+export declare const TAG_RECT_EMS = 1.6;
+declare const data: z.ZodObject<{
+    text: z.ZodString;
+    position: z.ZodOptional<z.ZodEnum<{
+        bottom: "bottom";
+        center: "center";
+        top: "top";
+    }>>;
+    size: z.ZodOptional<z.ZodEnum<{
+        large: "large";
+        medium: "medium";
+        small: "small";
+    }>>;
+}, z.core.$strict>;
+/** A short gradient pill over the presenter, centred on a caption line or in the caption spot; it may sit on insert frames. */
+export declare const tag: TemplateKind<typeof data>;
+export {};

package/dist/templates/tag.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { frameCanvasOf } from "../ugc-layers.js";
+import { sizedScale, templateSize } from "./size.js";
+export const TAG_POSITIONS = ["top", "center", "bottom"];
+/** Absent position is the reference's: two thirds down, at chest level, in the caption spot. */
+const CENTRES = { top: 0.22, center: 0.5, bottom: 0.78, caption: 0.66 };
+/** The pill's text at medium on a 1080 short side: the reference pill's cap height, about 3.5% of a 9:16 frame. */
+export const TAG_FONT_PX = 92;
+/** The footprint is this many font sizes high: the pill and its glow; the composition reads the font back from it. */
+export const TAG_RECT_EMS = 1.6;
+const data = z.object({ text: z.string().min(1).max(32), position: z.enum(TAG_POSITIONS).optional(), size: templateSize }).strict();
+/** A short gradient pill over the presenter, centred on a caption line or in the caption spot; it may sit on insert frames. */
+export const tag = {
+    kind: "tag",
+    kindVersion: 1,
+    description: "a short gradient pill over the presenter or an insert; without position it sits in the caption spot and hides captions while it shows",
+    placements: ["over"],
+    data,
+    text: { text: 32 },
+    slots: {},
+    hidesCaptions: value => value.position === undefined,
+    onInserts: true,
+    rect: (value, aspectRatio) => {
+        const canvas = frameCanvasOf(aspectRatio), { width: w, height: h } = canvas, short = Math.min(w, h), scale = sizedScale(value.size, canvas);
+        const width = Math.round(Math.min(0.9 * w, 1.25 * short * scale)), height = Math.round(TAG_RECT_EMS * TAG_FONT_PX * scale);
+        return { left: Math.round((w - width) / 2) / w, top: Math.round(CENTRES[value.position ?? "caption"] * h - height / 2) / h, width: width / w,
+            height: height / h };
+    },
+    sample: { text: "sounds natural", position: "center" },
+};
+//# sourceMappingURL=tag.js.map

package/dist/templates/tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../src/templates/tag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAClE,gGAAgG;AAChG,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAW,CAAC;AACjF,mHAAmH;AACnH,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,sHAAsH;AACtH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC;AAChC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEpI,+HAA+H;AAC/H,MAAM,CAAC,MAAM,GAAG,GAA8B;IAC5C,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,uIAAuI;IACpJ,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,IAAI;IACJ,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAClB,KAAK,EAAE,EAAE;IACT,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS;IACpD,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5I,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,WAAW,GAAG,KAAK,CAAC,CAAC;QAC3H,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC;YAC1I,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IACzB,CAAC;IACD,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE;CACvD,CAAC"}

package/dist/templates/theme.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+/** Looks the composition draws templates in (#778 S3, D8); presets are judged by eye on sheets, only a customer's colour is checked. */
+export declare const TEMPLATE_PRESETS: readonly ["clean_light", "bold_dark", "neon", "paper", "mono"];
+export type TemplatePreset = (typeof TEMPLATE_PRESETS)[number];
+/** The look of a run whose `template_theme` names none; the schema has no default (A8). */
+export declare const DEFAULT_TEMPLATE_PRESET: TemplatePreset;
+/** The colours an accent meets in each look: the text drawn on it, and the grounds it is drawn on as ink. The composition's themes
+ * hold the same values; a test keeps them equal. */
+export declare const TEMPLATE_PRESET_SURFACES: Readonly<Record<TemplatePreset, {
+    onAccent: string;
+    grounds: readonly string[];
+}>>;
+/** Large text needs 3:1 (WCAG 1.4.3); every template text is large. */
+export declare const TEMPLATE_MIN_CONTRAST = 3;
+export declare const templateTheme: z.ZodObject<{
+    preset: z.ZodOptional<z.ZodEnum<{
+        bold_dark: "bold_dark";
+        clean_light: "clean_light";
+        mono: "mono";
+        neon: "neon";
+        paper: "paper";
+    }>>;
+    accent: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type TemplateTheme = z.infer<typeof templateTheme>;
+/** The WCAG contrast ratio of two `#RRGGBB` colours. */
+export declare function contrastRatio(a: string, b: string): number;
+/** Why a customer accent cannot be drawn in a look, or nothing: it is refused, never shifted (D8). */
+export declare function templateAccentRefusal(preset: TemplatePreset, accent: string): string | undefined;

package/dist/templates/theme.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+/** Looks the composition draws templates in (#778 S3, D8); presets are judged by eye on sheets, only a customer's colour is checked. */
+export const TEMPLATE_PRESETS = ["clean_light", "bold_dark", "neon", "paper", "mono"];
+/** The look of a run whose `template_theme` names none; the schema has no default (A8). */
+export const DEFAULT_TEMPLATE_PRESET = "clean_light";
+/** The colours an accent meets in each look: the text drawn on it, and the grounds it is drawn on as ink. The composition's themes
+ * hold the same values; a test keeps them equal. */
+export const TEMPLATE_PRESET_SURFACES = {
+    clean_light: { onAccent: "#FFFFFF", grounds: ["#FFFFFF", "#EAF1FC", "#D9E7FB"] },
+    bold_dark: { onAccent: "#0B0F19", grounds: ["#1F2937", "#0B0F17", "#1C222C"] },
+    neon: { onAccent: "#FFFFFF", grounds: ["#0A0E16", "#05070D", "#0A1428"] },
+    paper: { onAccent: "#FFFFFF", grounds: ["#FDF8EF", "#F6EFE3", "#EADCC8"] },
+    mono: { onAccent: "#FFFFFF", grounds: ["#FFFFFF", "#F4F4F4", "#E2E2E2"] },
+};
+/** Large text needs 3:1 (WCAG 1.4.3); every template text is large. */
+export const TEMPLATE_MIN_CONTRAST = 3;
+export const templateTheme = z.object({
+    preset: z.enum(TEMPLATE_PRESETS).optional().describe("clean_light (light cards on our blue gradient), bold_dark (dark cards, a yellow accent), neon (black, " +
+        "cyan to blue), paper (warm cream, terracotta) or mono (black and white); omitted is clean_light."),
+    accent: z.string().regex(/^#[0-9A-Fa-f]{6}$/, "must be a #RRGGBB hex colour").optional()
+        .describe("#RRGGBB in place of the preset's accent: the pills' fill and the accent text. Refused below 3:1 against the colours it meets."),
+}).strict();
+const luminance = (hex) => {
+    const [r, g, b] = [1, 3, 5].map(at => Number.parseInt(hex.slice(at, at + 2), 16) / 255)
+        .map(channel => (channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4));
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+};
+/** The WCAG contrast ratio of two `#RRGGBB` colours. */
+export function contrastRatio(a, b) {
+    const [light, dark] = [luminance(a), luminance(b)].sort((x, y) => y - x);
+    return (light + 0.05) / (dark + 0.05);
+}
+/** Why a customer accent cannot be drawn in a look, or nothing: it is refused, never shifted (D8). */
+export function templateAccentRefusal(preset, accent) {
+    const { onAccent, grounds } = TEMPLATE_PRESET_SURFACES[preset];
+    const worst = [{ against: onAccent, role: `the ${onAccent} text drawn on it` },
+        ...grounds.map(ground => ({ against: ground, role: `the ${ground} card or ground it is drawn on` }))]
+        .map(entry => ({ ...entry, ratio: contrastRatio(accent, entry.against) })).sort((a, b) => a.ratio - b.ratio)[0];
+    if (worst.ratio >= TEMPLATE_MIN_CONTRAST)
+        return undefined;
+    // Towards the nearest luminance that clears them all: in neon the white text and the dark grounds sit on opposite sides of it.
+    const own = luminance(accent), levels = [onAccent, ...grounds].map(luminance);
+    const nearest = Array.from({ length: 1001 }, (_, step) => step / 1000).filter(level => levels.every(other => (Math.max(level, other) + 0.05) / (Math.min(level, other) + 0.05) >= TEMPLATE_MIN_CONTRAST)).sort((a, b) => Math.abs(a - own) - Math.abs(b - own))[0];
+    return `${accent} reaches ${worst.ratio.toFixed(2)}:1 against ${worst.role} in ${preset}, under the ${TEMPLATE_MIN_CONTRAST}:1 large text needs: ` +
+        (nearest === undefined ? "pick another preset" : `pick a ${nearest < own ? "darker" : "lighter"} accent or another preset`);
+}
+//# sourceMappingURL=theme.js.map

package/dist/templates/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/templates/theme.ts"],"names":[],"mappings":"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"}

package/dist/templates/title-card.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import type { TemplateKind } from "./index.js";
+/** The title at medium on a 1080 short side, as reference frames 1–2 draw the brand on the card. */
+export declare const TITLE_CARD_FONT_PX = 96;
+/** The drawn area is this many title sizes high: the card with two title lines, the gap and the chip; the composition reads the size back. */
+export declare const TITLE_CARD_RECT_EMS = 5;
+declare const data: z.ZodObject<{
+    title: z.ZodString;
+    chip: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodObject<{
+        asset_id: z.ZodString;
+    }, z.core.$strict>>;
+    size: z.ZodOptional<z.ZodEnum<{
+        large: "large";
+        medium: "medium";
+        small: "small";
+    }>>;
+}, z.core.$strict>;
+/** The hook card of reference frames 1–2: the title on a white card beside an optional logo, a gradient chip under it, on a full frame. */
+export declare const titleCard: TemplateKind<typeof data>;
+export {};

package/dist/templates/title-card.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { frameCanvasOf } from "../ugc-layers.js";
+import { sizedScale, templateSize } from "./size.js";
+import { templateMedia } from "./slot.js";
+/** The title at medium on a 1080 short side, as reference frames 1–2 draw the brand on the card. */
+export const TITLE_CARD_FONT_PX = 96;
+/** The drawn area is this many title sizes high: the card with two title lines, the gap and the chip; the composition reads the size back. */
+export const TITLE_CARD_RECT_EMS = 5;
+const data = z.object({ title: z.string().min(1).max(48), chip: z.string().min(1).max(32).optional(), logo: templateMedia.optional(),
+    size: templateSize }).strict();
+/** The hook card of reference frames 1–2: the title on a white card beside an optional logo, a gradient chip under it, on a full frame. */
+export const titleCard = {
+    kind: "title_card",
+    kindVersion: 1,
+    description: "a full-frame hook card: the title (up to two lines) on a white card beside an optional logo image, and an optional chip under it",
+    placements: ["full"],
+    data,
+    text: { title: 48, chip: 32 },
+    slots: { logo: { type: "image" } },
+    hidesCaptions: () => true,
+    onInserts: false,
+    rect: (value, aspectRatio) => {
+        const canvas = frameCanvasOf(aspectRatio), { width: w, height: h } = canvas, scale = sizedScale(value.size, canvas);
+        // The reference card is 89% of a 1080 width; the drawn area adds a 3% margin on each side.
+        const width = Math.round(Math.min(0.95 * w, 1022 * scale)), height = Math.round(TITLE_CARD_RECT_EMS * TITLE_CARD_FONT_PX * scale);
+        return { left: Math.round((w - width) / 2) / w, top: Math.round((h > w ? 0.38 : 0.5) * h - height / 2) / h, width: width / w, height: height / h };
+    },
+    sample: { title: "fonio.ai", chip: "raised $17 million" },
+};
+//# sourceMappingURL=title-card.js.map

package/dist/templates/title-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-card.js","sourceRoot":"","sources":["../../src/templates/title-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,oGAAoG;AACpG,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,8IAA8I;AAC9I,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,QAAQ,EAAE;IAClI,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEjC,2IAA2I;AAC3I,MAAM,CAAC,MAAM,SAAS,GAA8B;IAClD,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,kIAAkI;IAC/I,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,IAAI;IACJ,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;IAClC,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI;IACzB,SAAS,EAAE,KAAK;IAChB,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpH,2FAA2F;QAC3F,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,kBAAkB,GAAG,KAAK,CAAC,CAAC;QAClI,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IACrJ,CAAC;IACD,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,oBAAoB,EAAE;CAC1D,CAAC"}

package/dist/tts-backend.d.ts

@@ -45,3 +45,12 @@ export interface TtsBackend {
 /** Joins per-character timings into words, shared by vendors with that format. Whitespace */
 /** ends a word without joining it; empty words are never produced. */
 export declare function charTimingsToWords(characters: readonly string[], startTimes: readonly number[], endTimes: readonly number[]): WordTiming[];
+/** One speech model's alignment ends 80 ms past its decoded audio on every measured take (#779), */
+/** fresh and recovered alike; a tail up to this long is the model's, not a timing error. */
+export declare const ALIGNMENT_TAIL_TOLERANCE_SEC = 0.1;
+/** Word ends past the decoded audio pulled back to its end, or null when a word starts at */
+/** or after it or overshoots by more than the tolerance. `clippedSec` is the largest pull. */
+export declare function clampAlignmentTail(words: readonly WordTiming[], durationSec: number): {
+    words: WordTiming[];
+    clippedSec: number;
+} | null;

package/dist/tts-backend.js

@@ -30,4 +30,25 @@ export function charTimingsToWords(characters, startTimes, endTimes) {
     flush();
     return words;
 }
+/** One speech model's alignment ends 80 ms past its decoded audio on every measured take (#779), */
+/** fresh and recovered alike; a tail up to this long is the model's, not a timing error. */
+export const ALIGNMENT_TAIL_TOLERANCE_SEC = 0.1;
+/** Word ends past the decoded audio pulled back to its end, or null when a word starts at */
+/** or after it or overshoots by more than the tolerance. `clippedSec` is the largest pull. */
+export function clampAlignmentTail(words, durationSec) {
+    let clippedSec = 0;
+    const clamped = [];
+    for (const word of words) {
+        if (word.endSec <= durationSec) {
+            clamped.push({ ...word });
+            continue;
+        }
+        const overshoot = word.endSec - durationSec;
+        if (!(word.startSec < durationSec) || overshoot > ALIGNMENT_TAIL_TOLERANCE_SEC + 1e-9)
+            return null;
+        clippedSec = Math.max(clippedSec, overshoot);
+        clamped.push({ ...word, endSec: durationSec });
+    }
+    return { words: clamped, clippedSec };
+}
 //# sourceMappingURL=tts-backend.js.map

package/dist/tts-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"tts-backend.js","sourceRoot":"","sources":["../src/tts-backend.ts"],"names":[],"mappings":"AAsDA,6FAA6F;AAC7F,sEAAsE;AACtE,MAAM,UAAU,kBAAkB,CAChC,UAA6B,EAC7B,UAA6B,EAC7B,QAA2B;IAE3B,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CACb,qCAAqC,UAAU,CAAC,MAAM,UAAU;YAC9D,GAAG,UAAU,CAAC,MAAM,YAAY,QAAQ,CAAC,MAAM,OAAO,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACxD,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,KAAK,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QAClC,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAW,CAAC;IAC9B,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"tts-backend.js","sourceRoot":"","sources":["../src/tts-backend.ts"],"names":[],"mappings":"AAsDA,6FAA6F;AAC7F,sEAAsE;AACtE,MAAM,UAAU,kBAAkB,CAChC,UAA6B,EAC7B,UAA6B,EAC7B,QAA2B;IAE3B,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CACb,qCAAqC,UAAU,CAAC,MAAM,UAAU;YAC9D,GAAG,UAAU,CAAC,MAAM,YAAY,QAAQ,CAAC,MAAM,OAAO,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACxD,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,KAAK,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QAClC,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAW,CAAC;IAC9B,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oGAAoG;AACpG,4FAA4F;AAC5F,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD,6FAA6F;AAC7F,8FAA8F;AAC9F,MAAM,UAAU,kBAAkB,CAAC,KAA4B,EAAE,WAAmB;IAElF,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACxE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC5C,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,IAAI,SAAS,GAAG,4BAA4B,GAAG,IAAI;YAAE,OAAO,IAAI,CAAC;QACnG,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACxC,CAAC"}

package/dist/ugc-layers.d.ts

@@ -0,0 +1,84 @@
+import type { WordTiming } from "./tts-backend.js";
+export declare const OVERLAY_POSITIONS: readonly ["top_left", "top_right", "bottom_left", "bottom_right", "top", "bottom"];
+export type OverlayPosition = (typeof OVERLAY_POSITIONS)[number];
+export declare const LAYER_ENTERS: readonly ["cut", "fade", "slide", "tilt_in"];
+export type LayerEnter = (typeof LAYER_ENTERS)[number];
+export declare const LAYOUT_WINDOW_KINDS: readonly ["split", "card"];
+export type LayoutWindowKind = (typeof LAYOUT_WINDOW_KINDS)[number];
+export declare const INSERT_TRANSITIONS: readonly ["cut", "wipe", "flash", "zoom"];
+export type InsertTransition = (typeof INSERT_TRANSITIONS)[number];
+export declare const MAX_OVERLAYS = 10;
+export declare const MAX_LAYOUT_WINDOWS = 5;
+export declare const MAX_OVERLAYS_AT_ONCE = 2;
+/** A footprint on the frame, in shares of its width and height (#778 S3 D5). */
+export interface LayerRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** The frame of a `W:H` format in pixels, as the composition's `canvasForRatio` derives it: the short side 1080, both sides even. */
+export declare function frameCanvasOf(aspectRatio: string): {
+    width: number;
+    height: number;
+};
+/** The most an overlay at `position` takes, as `overlayBox` draws it: a corner 42% wide, a band the width less margins, 30% high. */
+export declare function overlayRect(position: OverlayPosition, canvas: {
+    width: number;
+    height: number;
+}): LayerRect;
+/** Two footprints collide when they share an area; touching edges do not. */
+export declare function rectsOverlap(a: LayerRect, b: LayerRect): boolean;
+/** Where the presenter's face sits: 12–48% of the height and the middle 60% of a 9:16 clip, which other formats fit whole and centre (#778 S3). */
+export declare function faceZone(aspectRatio: string): LayerRect;
+type WordAnchor = {
+    startWord: number;
+    endWord: number;
+} | {
+    quote: string;
+    occurrence?: number | undefined;
+};
+export interface AnchoredItem {
+    id: string;
+    anchor: WordAnchor;
+    cover_words?: number | undefined;
+}
+export interface WordRange {
+    startWord: number;
+    coverWord: number;
+}
+/** The words an item covers, `[startWord, coverWord)`, as an insert anchor resolves; a string names why it does not resolve. */
+export declare function layerWordRange(tokens: readonly string[], item: AnchoredItem): WordRange | string;
+export interface LayerRefusal {
+    path: (string | number)[];
+    message: string;
+}
+export interface LayerCheckInput {
+    script: string;
+    aspect_ratio?: string | undefined;
+    inserts?: readonly AnchoredItem[] | undefined;
+    overlays?: readonly (AnchoredItem & {
+        position: OverlayPosition;
+    })[] | undefined;
+    layout_windows?: readonly (AnchoredItem & {
+        layout: LayoutWindowKind;
+    })[] | undefined;
+}
+/** Every refusal of overlays and layout windows against the script, named by path; empty when they render. */
+export declare function layerRefusals(input: LayerCheckInput): LayerRefusal[];
+export interface LayerFrames {
+    id: string;
+    startFrame: number;
+    endFrame: number;
+}
+/** Frames of each word range on the run's narration, by the rule inserts follow: a range ends where its first uncovered word starts. */
+export declare function resolveLayerFrames(input: {
+    tokens: readonly string[];
+    words: readonly WordTiming[];
+    totalFrames: number;
+    fps: number;
+    layers: readonly (WordRange & {
+        id: string;
+    })[];
+}): LayerFrames[];
+export {};