@clipwright/core 0.33.0 → 0.34.0

package/dist/templates/checklist.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { faceZone, frameCanvasOf } from "../ugc-layers.js";
+import { sizedScale, templateSize } from "./size.js";
+export const CHECKLIST_ICONS = ["phone", "briefcase", "user", "clock", "chat", "star"];
+/** A row's label at medium on a 1080 short side, as the toggle cards of reference seconds 18–23. */
+export const CHECKLIST_FONT_PX = 60;
+/** Label sizes: a row's height, the gap between rows, the cursor's room under and right of the list, and the list's width. */
+export const CHECKLIST_EMS = { row: 1.9, gap: 0.3, cursor: 1.5, width: 14 };
+const item = z.object({ label: z.string().min(1).max(24), on: z.boolean(), icon: z.enum(CHECKLIST_ICONS).optional() }).strict();
+const click = z.object({ item: z.number().int().min(0).max(3), quote: z.string().min(1).max(200).optional() }).strict();
+const data = z.object({ items: z.array(item).min(2).max(4), clicks: z.array(click).max(6).optional(), style: z.enum(["switch", "check"]).optional(),
+    size: templateSize }).strict().superRefine((value, context) => {
+    for (const [index, entry] of (value.clicks ?? []).entries()) {
+        if (entry.item >= value.items.length)
+            context.addIssue({ code: z.ZodIssueCode.custom, path: ["clicks", index, "item"], message: `item ${entry.item} is past the ${value.items.length} items` });
+    }
+});
+/** Rows of toggles over the presenter, clicked on in turn by a cursor: below the face in tall and square frames, beside it in wide ones. */
+export const checklist = {
+    kind: "checklist",
+    kindVersion: 1,
+    description: "2–4 rows, each an optional icon, a label and a switch or check box set on or off; a cursor clicks rows in turn (item is the " +
+        "row's index from 0), each click flipping it; below the face",
+    placements: ["over"],
+    data,
+    text: { "items.label": 24 },
+    quotes: ["clicks.quote"],
+    // The rows are in by frame 9 and the cursor, shown from 8, reaches the first row two frames before its click.
+    beatsFrom: 12,
+    slots: {},
+    hidesCaptions: () => false,
+    onInserts: false,
+    rect: (value, aspectRatio) => {
+        const canvas = frameCanvasOf(aspectRatio), { width: w, height: h } = canvas, margin = Math.round(0.04 * Math.min(w, h)), face = faceZone(aspectRatio);
+        const rows = value.items.length, ems = rows * CHECKLIST_EMS.row + (rows - 1) * CHECKLIST_EMS.gap + CHECKLIST_EMS.cursor;
+        const wide = w > h, room = wide ? h - 2 * margin : h - margin - Math.round((face.top + face.height + 0.01) * h);
+        // The size scales the list, and a frame without room under the face shrinks it to fit.
+        const em = Math.min(CHECKLIST_FONT_PX * sizedScale(value.size, canvas), room / ems), height = Math.round(ems * em);
+        const width = Math.round(Math.min(wide ? face.left * w - 2 * margin : 0.9 * w, (CHECKLIST_EMS.width + CHECKLIST_EMS.cursor) * em));
+        const left = wide ? margin : Math.round((w - width) / 2);
+        const top = wide ? Math.round((h - height) / 2) : Math.min(h - margin - height, Math.max(Math.round((face.top + face.height + 0.01) * h), Math.round(0.71 * h - height / 2)));
+        return { left: left / w, top: top / h, width: width / w, height: height / h };
+    },
+    sample: { items: [{ label: "answers calls", on: true, icon: "phone" }, { label: "works 24/7", on: false, icon: "briefcase" },
+            { label: "gets annoyed", on: true, icon: "user" }], clicks: [{ item: 1, quote: "all day" }, { item: 2, quote: "never" }] },
+};
+//# sourceMappingURL=checklist.js.map

package/dist/templates/checklist.js.map

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

package/dist/templates/compare.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import type { TemplateKind } from "./index.js";
+/** The card's width at medium on a 1080 short side; it is 3:5, as tall as the reference's, and both pictures are cut to fill it. */
+export declare const COMPARE_WIDTH_PX = 760;
+export declare const COMPARE_CARD_SHAPE: number;
+declare const data: z.ZodObject<{
+    before: z.ZodObject<{
+        asset_id: z.ZodString;
+    }, z.core.$strict>;
+    after: z.ZodObject<{
+        asset_id: z.ZodString;
+    }, z.core.$strict>;
+    labels: z.ZodOptional<z.ZodObject<{
+        before: z.ZodOptional<z.ZodString>;
+        after: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    reveal_at: z.ZodString;
+    size: z.ZodOptional<z.ZodEnum<{
+        large: "large";
+        medium: "medium";
+        small: "small";
+    }>>;
+}, z.core.$strict>;
+/** Expectation against reality on a full frame: the before picture on a card, the after one swept in on a diagonal on a word (ref 50–55 s). */
+export declare const compare: TemplateKind<typeof data>;
+export {};

package/dist/templates/compare.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { frameCanvasOf } from "../ugc-layers.js";
+import { sizedScale, templateSize } from "./size.js";
+import { templateMedia } from "./slot.js";
+/** The card's width at medium on a 1080 short side; it is 3:5, as tall as the reference's, and both pictures are cut to fill it. */
+export const COMPARE_WIDTH_PX = 760;
+export const COMPARE_CARD_SHAPE = 3 / 5;
+const data = z.object({ before: templateMedia, after: templateMedia,
+    labels: z.object({ before: z.string().min(1).max(20).optional(), after: z.string().min(1).max(20).optional() }).strict().optional(),
+    reveal_at: z.string().min(1).max(200), size: templateSize }).strict();
+/** Expectation against reality on a full frame: the before picture on a card, the after one swept in on a diagonal on a word (ref 50–55 s). */
+export const compare = {
+    kind: "compare",
+    kindVersion: 1,
+    description: "a full-frame card showing the before image, then the after image sweeps in on a diagonal on reveal_at and both stay side by side, " +
+        "each with an optional label pill; both images are cut to fill a 3:5 card",
+    placements: ["full"],
+    data,
+    text: { "labels.before": 20, "labels.after": 20 },
+    quotes: ["reveal_at"],
+    beatsFrom: 9,
+    slots: { before: { type: "image", cover: COMPARE_CARD_SHAPE }, after: { type: "image", cover: COMPARE_CARD_SHAPE } },
+    hidesCaptions: () => true,
+    onInserts: false,
+    rect: (value, aspectRatio) => {
+        const canvas = frameCanvasOf(aspectRatio), { width: w, height: h } = canvas;
+        let width = COMPARE_WIDTH_PX * sizedScale(value.size, canvas);
+        width = Math.round(Math.min(width, 0.92 * w, 0.92 * h * COMPARE_CARD_SHAPE));
+        const height = Math.round(width / COMPARE_CARD_SHAPE);
+        return { left: Math.round((w - width) / 2) / w, top: Math.round((h - height) / 2) / h, width: width / w, height: height / h };
+    },
+    sample: { before: { asset_id: `ast_${"b".repeat(32)}` }, after: { asset_id: `ast_${"a".repeat(32)}` }, labels: { before: "expectation", after: "reality" },
+        reveal_at: "in reality" },
+};
+//# sourceMappingURL=compare.js.map

package/dist/templates/compare.js.map

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

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

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import type { TemplateKind } from "./index.js";
+/** The footprint is this many site font sizes high (pill, gap and call to action); the site at medium is the tag's 92 px. */
+export declare const END_CARD_RECT_EMS = 3.4;
+declare const data: z.ZodObject<{
+    site: z.ZodString;
+    cta: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodEnum<{
+        large: "large";
+        medium: "medium";
+        small: "small";
+    }>>;
+}, z.core.$strict>;
+/** The closing card in the caption spot: the site on the gradient pill and an optional call to action under it. */
+export declare const endCard: TemplateKind<typeof data>;
+export {};

package/dist/templates/end-card.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { frameCanvasOf } from "../ugc-layers.js";
+import { sizedScale, templateSize } from "./size.js";
+/** The footprint is this many site font sizes high (pill, gap and call to action); the site at medium is the tag's 92 px. */
+export const END_CARD_RECT_EMS = 3.4;
+const data = z.object({ site: z.string().min(1).max(32), cta: z.string().min(1).max(48).optional(), size: templateSize }).strict();
+/** The closing card in the caption spot: the site on the gradient pill and an optional call to action under it. */
+export const endCard = {
+    kind: "end_card",
+    kindVersion: 1,
+    description: "a site pill with an optional call to action in the caption spot; captions are hidden while it shows",
+    placements: ["over"],
+    data,
+    text: { site: 32, cta: 48 },
+    slots: {},
+    hidesCaptions: () => true,
+    onInserts: false,
+    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(END_CARD_RECT_EMS * 92 * scale);
+        return { left: Math.round((w - width) / 2) / w, top: Math.round(0.72 * h - height / 2) / h, width: width / w, height: height / h };
+    },
+    sample: { site: "clipwright.io", cta: "make your first video" },
+};
+//# sourceMappingURL=end-card.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"end-card.js","sourceRoot":"","sources":["../../src/templates/end-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;AAErD,6HAA6H;AAC7H,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,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,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEnI,mHAAmH;AACnH,MAAM,CAAC,MAAM,OAAO,GAA8B;IAChD,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,qGAAqG;IAClH,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,IAAI;IACJ,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IAC3B,KAAK,EAAE,EAAE;IACT,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,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,iBAAiB,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QACvH,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,IAAI,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IACrI,CAAC;IACD,MAAM,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,uBAAuB,EAAE;CAChE,CAAC"}

package/dist/templates/index.d.ts

@@ -0,0 +1,164 @@
+import { z } from "zod";
+import { type AnchoredItem, type LayerRect, type LayerRefusal, type OverlayPosition, type WordRange } from "../ugc-layers.js";
+import type { TemplateSlot } from "./slot.js";
+import { type TemplatePreset } from "./theme.js";
+export declare const TEMPLATE_PLACEMENTS: readonly ["over", "full"];
+export type TemplatePlacement = (typeof TEMPLATE_PLACEMENTS)[number];
+export declare const MAX_TEMPLATES = 12;
+export { contrastRatio, DEFAULT_TEMPLATE_PRESET, TEMPLATE_MIN_CONTRAST, TEMPLATE_PRESET_SURFACES, TEMPLATE_PRESETS, templateAccentRefusal, templateTheme, type TemplatePreset, type TemplateTheme } from "./theme.js";
+/** One kind: a strict data schema with no defaults or transforms; `kindVersion` moves only when that shape changes (A8). */
+export interface TemplateKind<D extends z.ZodObject = z.ZodObject> {
+    kind: string;
+    kindVersion: number;
+    description: string;
+    /** The placements it takes; the first is used when an item names none. */
+    placements: readonly TemplatePlacement[];
+    data: D;
+    /** Text fields and the most units each takes; a dotted path reaches into objects and every element of a list. */
+    text: Readonly<Record<string, number>>;
+    /** Inner quotes, as dotted paths: each value is one beat, in order, landing on its words inside the item's own; absent is spread evenly (D6). */
+    quotes?: readonly string[];
+    /** A list whose elements each take a beat when the item quotes none, spread evenly; absent is one beat per quote value. */
+    spreads?: string;
+    /** The first frame a beat may land on: the kind has entered and, for a checklist, its cursor has reached the rows; absent is the frame after the enter. */
+    beatsFrom?: number;
+    /** Media fields, each `{ asset_id }`, and what each takes; they pin as `<id>.<slot>` (A1). */
+    slots: Readonly<Record<string, TemplateSlot>>;
+    /** Whether captions are hidden while it shows: it sits in the caption spot. */
+    hidesCaptions(data: z.infer<D>): boolean;
+    /** Drawn on full-frame insert frames too; other over-presenter kinds step aside there. */
+    onInserts: boolean;
+    /** Where it draws, in shares of the frame: over the presenter its footprint, on a full frame the area its content takes. */
+    rect(data: z.infer<D>, aspectRatio: string, placement?: TemplatePlacement): LayerRect;
+    /** Named parts the composition draws in, in shares of the frame; they may reach past it, where the footprint crops them (A7). */
+    parts?(data: z.infer<D>, aspectRatio: string): Record<string, LayerRect>;
+    /** The part the face rule applies to, or none; absent is the whole footprint. */
+    faceRect?(data: z.infer<D>, aspectRatio: string): LayerRect | undefined;
+    sample: z.infer<D>;
+}
+export declare const TEMPLATE_KINDS: readonly TemplateKind[];
+export declare const TEMPLATE_KIND_IDS: readonly ["tag", "lower_third", "end_card", "title_card", "quote", "stat", "callout", "checklist", "phone_call", "compare", "notification", "progress", "rating"];
+/** Earlier versions of kinds a frozen timeline may still name, each with its own footprint (A8, #819); every kind is at its first version. */
+export declare const TEMPLATE_KIND_HISTORY: readonly TemplateKind[];
+/** A kind as it was at `version`: the current entry or one from its history; a version neither holds has no footprint to draw. */
+export declare function templateKindAt(kind: string, version: number | undefined, kinds?: readonly TemplateKind[], history?: readonly TemplateKind[]): TemplateKind;
+export { TEMPLATE_SIZES } from "./size.js";
+export { DEFAULT_TEMPLATE_SOUNDS, listTemplateSounds, mcpTemplateSounds, TEMPLATE_KIND_SOUNDS, TEMPLATE_SOUND_BEATS, TEMPLATE_SOUNDS, TEMPLATE_SOUNDS_PATH, templateSoundBeats, templateSoundMap, templateSounds, templateSoundsList, type TemplateSoundBeat, type TemplateSoundMap, type TemplateSounds, type TemplateSoundsList } from "./sounds.js";
+export { TAG_RECT_EMS } from "./tag.js";
+export { END_CARD_RECT_EMS } from "./end-card.js";
+export { TITLE_CARD_RECT_EMS } from "./title-card.js";
+export { QUOTE_RECT_EMS } from "./quote.js";
+export { STAT_RECT_EMS } from "./stat.js";
+export { CALLOUT_LABEL_EMS, calloutParts } from "./callout.js";
+export { CHECKLIST_EMS } from "./checklist.js";
+export { COMPARE_CARD_SHAPE } from "./compare.js";
+export { NOTIFICATION_EMS } from "./notification.js";
+export { PROGRESS_EMS } from "./progress.js";
+export { RATING_EMS } from "./rating.js";
+export { templateMedia, type TemplateSlot } from "./slot.js";
+/** Every value at a dotted path of a kind's data, one per element where the path crosses or ends in a list, with its own path; an absent last
+ * field is listed, a path through an absent object or list lists nothing. */
+export declare function templateFieldValues(data: unknown, field: string): {
+    path: (string | number)[];
+    value: unknown;
+}[];
+/** The data with every value at a dotted path set to `value`, through lists and in each element of a list it ends in; a missing object on the
+ * way is created. */
+export declare function withTemplateField(data: Record<string, unknown>, field: string, value: unknown): Record<string, unknown>;
+/** Frames a template takes to enter; a beat without a quote is spread evenly from there to 80% of its span (D6). */
+export declare const TEMPLATE_ENTER_FRAMES = 8;
+/** The word each beat of a template lands on: its quote's first word inside the item's words, after the beat before; none for a beat without
+ * a quote; or why it cannot land (D6, D10). */
+export declare function templateMomentWords(kind: TemplateKind, data: unknown, tokens: readonly string[], range: WordRange): {
+    path: (string | number)[];
+    word?: number;
+    refusal?: string;
+}[];
+/** Frames between a moved beat and the next, so a checklist's cursor still travels between two clicks. */
+export declare const TEMPLATE_BEAT_GAP = 6;
+/** Each beat's frame from the template's start, frozen in the timeline; the renderer reads frames only (D11). A beat spoken before the kind's
+ * `beatsFrom` moves there, the beats after it keep `TEMPLATE_BEAT_GAP`, and each move is a warning (rule 3, owner 23.10). */
+export declare function templateMoments(kind: TemplateKind, data: unknown, tokens: readonly string[], range: WordRange, words: readonly {
+    word: string;
+    startSec: number;
+}[], fps: number, span: {
+    startFrame: number;
+    endFrame: number;
+}, id?: string): {
+    moments: number[];
+    warnings: string[];
+};
+/** The most pins a run's templates take: each template's slots. */
+export declare const MAX_TEMPLATE_MEDIA: number;
+/** Every way a kind draws: each placement with its sample, then each value of each enum field over the sample at its first placement;
+ * the composition declares motion phases for each, and the media test checks them. */
+export declare function templateVariants(kind: TemplateKind): {
+    key: string;
+    placement: TemplatePlacement;
+    data: Record<string, unknown>;
+}[];
+/** Every media slot the templates fill, in item then slot order: what admission pins and every source walker reads (#778 S3a(ii)). */
+export declare function templateMediaOf(templates: readonly {
+    id: string;
+    kind: string;
+    data: Record<string, unknown>;
+}[] | undefined): {
+    index: number;
+    id: string;
+    slot: string;
+    asset_id: string;
+    media_type: "image" | "video";
+    cover?: number | undefined;
+}[];
+/** Code points template text may use besides the run script's letters, for a caption language; the glyph test reads this list. */
+export declare function templateCharRanges(language: string): [number, number][];
+/** Units of a text: a wide CJK character takes the room of two. */
+export declare const textUnits: (text: string) => number;
+/** Why a template text cannot be drawn, or nothing; the language is the run's, as the caption fonts read it. */
+export declare function templateTextRefusal(text: string, limit: number, language: string): string | undefined;
+export interface TemplateItem extends AnchoredItem {
+    kind: string;
+    placement?: TemplatePlacement | undefined;
+    transition?: string | undefined;
+    data: Record<string, unknown>;
+}
+/** Where a template draws and what it does to captions, at a format; a frozen `kindVersion` reads that version's geometry (#819). */
+export declare function templateFootprint(item: {
+    kind: string;
+    kindVersion?: number | undefined;
+    placement: TemplatePlacement;
+    data: Record<string, unknown>;
+}, aspectRatio: string, kinds?: readonly TemplateKind[], history?: readonly TemplateKind[]): {
+    rect: LayerRect;
+    hidesCaptions: boolean;
+    onInserts: boolean;
+    content?: LayerRect;
+    parts?: Record<string, LayerRect>;
+};
+/** Over-presenter templates whose footprint meets the face: drawn as asked, and named (rule 3); every kind's default stays off it. */
+export declare function templateFaceWarnings(input: {
+    templates?: unknown;
+    aspect_ratio?: unknown;
+}): string[];
+/** The `templates` description: the gate, the text rules and one catalog line per kind, all from the registry. */
+export declare function templateCatalogText(kinds?: readonly TemplateKind[]): string;
+export interface TemplateCheckInput {
+    script?: string | undefined;
+    segments?: unknown;
+    aspect_ratio?: string | undefined;
+    inserts?: readonly (AnchoredItem & {
+        transition?: string | undefined;
+    })[] | undefined;
+    overlays?: readonly (AnchoredItem & {
+        position: OverlayPosition;
+    })[] | undefined;
+    layout_windows?: readonly AnchoredItem[] | undefined;
+    templates?: readonly TemplateItem[] | undefined;
+    template_theme?: {
+        preset?: TemplatePreset | undefined;
+        accent?: string | undefined;
+    } | undefined;
+    template_sounds?: unknown;
+}
+/** Every refusal of `templates`, `template_theme` and `template_sounds` against the run, named by path; empty when they render (D4, D5, D6, D8, D10, A5, A6). */
+export declare function templateRefusals(input: TemplateCheckInput, kinds?: readonly TemplateKind[]): LayerRefusal[];