@clipwright/core 0.32.0 → 0.34.0

package/dist/templates/phone-call.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { faceZone, frameCanvasOf } from "../ugc-layers.js";
+import { sizedScale, templateSize } from "./size.js";
+import { templateMedia } from "./slot.js";
+/** The phone's width at medium on a 1080 short side; it is twice as high. */
+export const PHONE_CALL_WIDTH_PX = 360;
+const data = z.object({ caller: z.string().min(1).max(24), subtitle: z.string().min(1).max(32).optional(), avatar: templateMedia.optional(),
+    answer_at: z.string().min(1).max(200), side: z.enum(["left", "right"]).optional(), size: templateSize }).strict();
+/** An incoming call on a neutral phone at the side of the frame, ringing until it is answered on a word (reference seconds 26–43). */
+export const phoneCall = {
+    kind: "phone_call",
+    kindVersion: 1,
+    description: "an incoming call on a neutral phone at the side (right unless side left): the caller, a subtitle and a round avatar ring, then " +
+        "the call is answered on answer_at and its timer runs; beside the face in wide frames, under it in tall ones",
+    placements: ["over"],
+    data,
+    text: { caller: 24, subtitle: 32 },
+    quotes: ["answer_at"],
+    beatsFrom: 9,
+    slots: { avatar: { type: "image", cover: 1 } },
+    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);
+        let width = Math.round(PHONE_CALL_WIDTH_PX * sizedScale(value.size, canvas)), top = Math.round((face.top + face.height + 0.01) * h);
+        // A frame at least as wide as high has room beside the face, from the top; a tall one under it, down the side.
+        if (w >= h) {
+            width = Math.min(width, Math.floor((w * (1 - face.left - face.width) - 2 * margin) / 2) * 2, Math.floor((h - 2 * margin) / 4) * 2);
+            top = margin;
+        }
+        const left = value.side === "left" ? margin : w - margin - width;
+        return { left: left / w, top: top / h, width: width / w, height: (2 * width) / h };
+    },
+    sample: { caller: "+1 (305) 555-0147", subtitle: "incoming call", answer_at: "answers", side: "right" },
+};
+//# sourceMappingURL=phone-call.js.map

package/dist/templates/phone-call.js.map

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

package/dist/templates/progress.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { TemplateKind } from "./index.js";
+/** A step's label at medium on a 1080 short side. */
+export declare const PROGRESS_FONT_PX = 56;
+/** Label sizes: a step's row, the card's padding above and below, and the card's width. */
+export declare const PROGRESS_EMS: {
+    readonly row: 1.6;
+    readonly pad: 0.4;
+    readonly width: 12;
+};
+declare const data: z.ZodObject<{
+    steps: z.ZodArray<z.ZodString>;
+    advance_at: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    size: z.ZodOptional<z.ZodEnum<{
+        large: "large";
+        medium: "medium";
+        small: "small";
+    }>>;
+}, z.core.$strict>;
+/** Steps in a column on a card, completing in turn: below the face in tall and square frames, beside it in wide ones. */
+export declare const progress: TemplateKind<typeof data>;
+export {};

package/dist/templates/progress.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { faceZone, frameCanvasOf } from "../ugc-layers.js";
+import { sizedScale, templateSize } from "./size.js";
+/** A step's label at medium on a 1080 short side. */
+export const PROGRESS_FONT_PX = 56;
+/** Label sizes: a step's row, the card's padding above and below, and the card's width. */
+export const PROGRESS_EMS = { row: 1.6, pad: 0.4, width: 12 };
+const data = z.object({ steps: z.array(z.string().min(1).max(20)).min(2).max(5), advance_at: z.array(z.string().min(1).max(200)).min(2).max(5).optional(),
+    size: templateSize }).strict().superRefine((value, context) => {
+    if (value.advance_at && value.advance_at.length !== value.steps.length) {
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["advance_at"], message: `gives ${value.advance_at.length} quotes for ${value.steps.length} steps: one per step` });
+    }
+});
+/** Steps in a column on a card, completing in turn: below the face in tall and square frames, beside it in wide ones. */
+export const progress = {
+    kind: "progress",
+    kindVersion: 1,
+    description: "2–5 steps in a column on a card, each completing with a check in turn, on its advance_at quote (one per step, in order) or " +
+        "spread evenly; below the face",
+    placements: ["over"],
+    data,
+    text: { steps: 20 },
+    quotes: ["advance_at"],
+    beatsFrom: 9,
+    spreads: "steps",
+    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 ems = value.steps.length * PROGRESS_EMS.row + 2 * PROGRESS_EMS.pad, below = Math.round((face.top + face.height + 0.01) * h);
+        const wide = w > h, room = wide ? h - 2 * margin : h - margin - below;
+        // The size scales the card, and a frame without room under the face shrinks it to fit.
+        const em = Math.min(PROGRESS_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, PROGRESS_EMS.width * 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(below, Math.round(0.71 * h - height / 2)));
+        return { left: left / w, top: top / h, width: width / w, height: height / h };
+    },
+    sample: { steps: ["call answered", "slot found", "visit booked"], advance_at: ["answers", "finds", "books"] },
+};
+//# sourceMappingURL=progress.js.map

package/dist/templates/progress.js.map

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

package/dist/templates/quote.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import type { TemplateKind } from "./index.js";
+/** The quote's text at medium on a 1080 short side. */
+export declare const QUOTE_FONT_PX = 72;
+/** The drawn area is this many text sizes high: the marks, four lines and the author row. */
+export declare const QUOTE_RECT_EMS = 8.5;
+declare const data: z.ZodObject<{
+    text: z.ZodString;
+    author: z.ZodOptional<z.ZodString>;
+    photo: 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>;
+/** A full-frame quote: marks, then the text in up to four lines, then the author with an optional round photo. */
+export declare const quote: TemplateKind<typeof data>;
+export {};

package/dist/templates/quote.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { frameCanvasOf } from "../ugc-layers.js";
+import { sizedScale, templateSize } from "./size.js";
+import { templateMedia } from "./slot.js";
+/** The quote's text at medium on a 1080 short side. */
+export const QUOTE_FONT_PX = 72;
+/** The drawn area is this many text sizes high: the marks, four lines and the author row. */
+export const QUOTE_RECT_EMS = 8.5;
+const data = z.object({ text: z.string().min(1).max(120), author: z.string().min(1).max(32).optional(), photo: templateMedia.optional(),
+    size: templateSize }).strict();
+/** A full-frame quote: marks, then the text in up to four lines, then the author with an optional round photo. */
+export const quote = {
+    kind: "quote",
+    kindVersion: 1,
+    description: "a full-frame quote: marks, the text in up to four lines, then the author with an optional round photo, cut to a circle",
+    placements: ["full"],
+    data,
+    text: { text: 120, author: 32 },
+    slots: { photo: { type: "image", cover: 1 } },
+    hidesCaptions: () => true,
+    onInserts: false,
+    rect: (value, aspectRatio) => {
+        const canvas = frameCanvasOf(aspectRatio), { width: w, height: h } = canvas, scale = sizedScale(value.size, canvas);
+        const width = Math.round(Math.min(0.9 * w, 1000 * scale)), height = Math.round(Math.min(0.92 * h, QUOTE_RECT_EMS * QUOTE_FONT_PX * scale));
+        return { left: Math.round((w - width) / 2) / w, top: Math.round((h - height) / 2) / h, width: width / w, height: height / h };
+    },
+    sample: { text: "It answered every call while I was with patients, and nobody could tell.", author: "Maya Chen" },
+};
+//# sourceMappingURL=quote.js.map

package/dist/templates/quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.js","sourceRoot":"","sources":["../../src/templates/quote.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,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,6FAA6F;AAC7F,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,QAAQ,EAAE;IACrI,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEjC,kHAAkH;AAClH,MAAM,CAAC,MAAM,KAAK,GAA8B;IAC9C,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,wHAAwH;IACrI,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,IAAI;IACJ,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;IAC/B,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAC7C,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,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC;QAC3I,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,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IAChI,CAAC;IACD,MAAM,EAAE,EAAE,IAAI,EAAE,0EAA0E,EAAE,MAAM,EAAE,WAAW,EAAE;CAClH,CAAC"}

package/dist/templates/rating.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { TemplateKind } from "./index.js";
+/** A star's size at medium on a 1080 short side. */
+export declare const RATING_STAR_PX = 104;
+/** Star sizes: the card's height with the row of stars, the label's band under it, and the card's width (five stars, four gaps, padding). */
+export declare const RATING_EMS: {
+    readonly row: 1.44;
+    readonly label: 0.62;
+    readonly width: 6.32;
+};
+declare const data: z.ZodObject<{
+    stars: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodEnum<{
+        large: "large";
+        medium: "medium";
+        small: "small";
+    }>>;
+}, z.core.$strict>;
+/** Five stars on a card filling in turn up to a score, with an optional label: at chest level, off the face. */
+export declare const rating: TemplateKind<typeof data>;
+export {};

package/dist/templates/rating.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { frameCanvasOf } from "../ugc-layers.js";
+import { sizedScale, templateSize } from "./size.js";
+/** A star's size at medium on a 1080 short side. */
+export const RATING_STAR_PX = 104;
+/** Star sizes: the card's height with the row of stars, the label's band under it, and the card's width (five stars, four gaps, padding). */
+export const RATING_EMS = { row: 1.44, label: 0.62, width: 6.32 };
+const data = z.object({ stars: z.number().min(1).max(5).multipleOf(0.5), label: z.string().min(1).max(32).optional(), size: templateSize }).strict();
+/** Five stars on a card filling in turn up to a score, with an optional label: at chest level, off the face. */
+export const rating = {
+    kind: "rating",
+    kindVersion: 1,
+    description: "five stars on a card filling in turn up to stars (1–5 in halves, a half star half filled), an optional label under them; " +
+        "at chest level",
+    placements: ["over"],
+    data,
+    text: { label: 32 },
+    slots: {},
+    hidesCaptions: () => false,
+    onInserts: false,
+    rect: (value, aspectRatio) => {
+        const canvas = frameCanvasOf(aspectRatio), { width: w, height: h } = canvas, star = RATING_STAR_PX * sizedScale(value.size, canvas);
+        const width = Math.round(Math.min(0.9 * w, RATING_EMS.width * star)), height = Math.round((RATING_EMS.row + (value.label ? RATING_EMS.label : 0)) * star);
+        // At chest level, as the stat over the presenter, off the face (62–80% of the height).
+        return { left: Math.round((w - width) / 2) / w, top: Math.round(0.71 * h - height / 2) / h, width: width / w, height: height / h };
+    },
+    sample: { stars: 4.5, label: "rated by 312 patients" },
+};
+//# sourceMappingURL=rating.js.map

package/dist/templates/rating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.js","sourceRoot":"","sources":["../../src/templates/rating.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,oDAAoD;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,6IAA6I;AAC7I,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAW,CAAC;AAC3E,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,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;AAErJ,gHAAgH;AAChH,MAAM,CAAC,MAAM,MAAM,GAA8B;IAC/C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,2HAA2H;QACtI,gBAAgB;IAClB,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,IAAI;IACJ,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;IACnB,KAAK,EAAE,EAAE;IACT,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK;IAC1B,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,IAAI,GAAG,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpI,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1J,uFAAuF;QACvF,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,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,uBAAuB,EAAE;CACvD,CAAC"}

package/dist/templates/size.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+/** How large a kind draws; absent is medium, the reference scale (#778 S3, owner 2026-10-22). No default in the schema (A8). */
+export declare const TEMPLATE_SIZES: readonly ["small", "medium", "large"];
+export declare const templateSize: z.ZodOptional<z.ZodEnum<{
+    large: "large";
+    medium: "medium";
+    small: "small";
+}>>;
+/** Pixels per pixel at a 1080 short side, times the size's scale. */
+export declare function sizedScale(size: (typeof TEMPLATE_SIZES)[number] | undefined, canvas: {
+    width: number;
+    height: number;
+}): number;

package/dist/templates/size.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+/** How large a kind draws; absent is medium, the reference scale (#778 S3, owner 2026-10-22). No default in the schema (A8). */
+export const TEMPLATE_SIZES = ["small", "medium", "large"];
+export const templateSize = z.enum(TEMPLATE_SIZES).optional();
+const SCALE = { small: 0.75, medium: 1, large: 1.3 };
+/** Pixels per pixel at a 1080 short side, times the size's scale. */
+export function sizedScale(size, canvas) {
+    return (Math.min(canvas.width, canvas.height) / 1080) * SCALE[size ?? "medium"];
+}
+//# sourceMappingURL=size.js.map

package/dist/templates/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../src/templates/size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gIAAgI;AAChI,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AACpE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC9D,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAW,CAAC;AAE9D,qEAAqE;AACrE,MAAM,UAAU,UAAU,CAAC,IAAiD,EAAE,MAAyC;IACrH,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC;AAClF,CAAC"}

package/dist/templates/slot.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+/** A template's media slot: a ready asset of the account, pinned at admission by (template id, slot) (#778 S3a(ii), A1). */
+export declare const templateMedia: z.ZodObject<{
+    asset_id: z.ZodString;
+}, z.core.$strict>;
+/** What a slot takes; `cover` is the shape it fills, width over height, so a picture of another shape is cut and named. */
+export interface TemplateSlot {
+    type: "image" | "video";
+    cover?: number | undefined;
+}

package/dist/templates/slot.js

@@ -0,0 +1,5 @@
+import { z } from "zod";
+import { assetId } from "../asset-identity.js";
+/** A template's media slot: a ready asset of the account, pinned at admission by (template id, slot) (#778 S3a(ii), A1). */
+export const templateMedia = z.object({ asset_id: assetId.describe("A ready asset from list_assets, of the kind the slot takes.") }).strict();
+//# sourceMappingURL=slot.js.map

package/dist/templates/slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.js","sourceRoot":"","sources":["../../src/templates/slot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,4HAA4H;AAC5H,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,6DAA6D,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/templates/sounds.d.ts

@@ -0,0 +1,351 @@
+import { z } from "zod";
+export declare const TEMPLATE_SOUND_BEATS: readonly ["click", "toggle", "ring", "answer", "notify", "step", "whoosh", "flash"];
+export type TemplateSoundBeat = (typeof TEMPLATE_SOUND_BEATS)[number];
+/** 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 declare const TEMPLATE_SOUNDS: {
+    readonly click: {
+        readonly default: "click_mouse";
+        readonly names: readonly ["click_mouse", "click_soft", "click_crisp", "click_light"];
+        readonly plays: "a checklist's cursor clicks a row, on each click";
+    };
+    readonly toggle: {
+        readonly default: "switch_flip";
+        readonly names: readonly ["switch_flip", "toggle_snap", "switch_heavy", "switch_light"];
+        readonly plays: "a checklist row's switch or check box lands, just after each click";
+    };
+    readonly ring: {
+        readonly default: "ring_classic";
+        readonly names: readonly ["ring_classic", "ring_marimba", "ring_digital"];
+        readonly plays: "a phone_call rings from its pop, repeating, until it is answered";
+    };
+    readonly answer: {
+        readonly default: "answer_confirm";
+        readonly names: readonly ["answer_confirm", "answer_open", "answer_pop", "answer_select"];
+        readonly plays: "a phone_call is answered, on answer_at";
+    };
+    readonly notify: {
+        readonly default: "chime";
+        readonly names: readonly ["chime", "glass_ping", "glass_soft", "bong", "question_ping"];
+        readonly plays: "a notification drops in";
+    };
+    readonly step: {
+        readonly default: "drop";
+        readonly names: readonly ["drop", "drop_high", "tick", "pluck", "pluck_bright"];
+        readonly plays: "a progress step fills, and each rating star";
+    };
+    readonly whoosh: {
+        readonly default: "whoosh";
+        readonly names: readonly ["whoosh", "whip", "paper_swipe", "sweep"];
+        readonly plays: "a full-frame template's wipe or zoom, in and out, and a compare's reveal";
+    };
+    readonly flash: {
+        readonly default: "shutter";
+        readonly names: readonly ["shutter", "glitch"];
+        readonly 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 declare const TEMPLATE_KIND_SOUNDS: Readonly<Record<string, readonly TemplateSoundBeat[]>>;
+export type TemplateSoundMap = {
+    [B in TemplateSoundBeat]: (typeof TEMPLATE_SOUNDS)[B]["names"][number];
+};
+export declare const DEFAULT_TEMPLATE_SOUNDS: TemplateSoundMap;
+export declare const templateSounds: z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+    click: z.ZodOptional<z.ZodEnum<{
+        answer_confirm: "answer_confirm";
+        answer_open: "answer_open";
+        answer_pop: "answer_pop";
+        answer_select: "answer_select";
+        bong: "bong";
+        chime: "chime";
+        click_crisp: "click_crisp";
+        click_light: "click_light";
+        click_mouse: "click_mouse";
+        click_soft: "click_soft";
+        drop: "drop";
+        drop_high: "drop_high";
+        glass_ping: "glass_ping";
+        glass_soft: "glass_soft";
+        glitch: "glitch";
+        paper_swipe: "paper_swipe";
+        pluck: "pluck";
+        pluck_bright: "pluck_bright";
+        question_ping: "question_ping";
+        ring_classic: "ring_classic";
+        ring_digital: "ring_digital";
+        ring_marimba: "ring_marimba";
+        shutter: "shutter";
+        sweep: "sweep";
+        switch_flip: "switch_flip";
+        switch_heavy: "switch_heavy";
+        switch_light: "switch_light";
+        tick: "tick";
+        toggle_snap: "toggle_snap";
+        whip: "whip";
+        whoosh: "whoosh";
+    }>>;
+    toggle: z.ZodOptional<z.ZodEnum<{
+        answer_confirm: "answer_confirm";
+        answer_open: "answer_open";
+        answer_pop: "answer_pop";
+        answer_select: "answer_select";
+        bong: "bong";
+        chime: "chime";
+        click_crisp: "click_crisp";
+        click_light: "click_light";
+        click_mouse: "click_mouse";
+        click_soft: "click_soft";
+        drop: "drop";
+        drop_high: "drop_high";
+        glass_ping: "glass_ping";
+        glass_soft: "glass_soft";
+        glitch: "glitch";
+        paper_swipe: "paper_swipe";
+        pluck: "pluck";
+        pluck_bright: "pluck_bright";
+        question_ping: "question_ping";
+        ring_classic: "ring_classic";
+        ring_digital: "ring_digital";
+        ring_marimba: "ring_marimba";
+        shutter: "shutter";
+        sweep: "sweep";
+        switch_flip: "switch_flip";
+        switch_heavy: "switch_heavy";
+        switch_light: "switch_light";
+        tick: "tick";
+        toggle_snap: "toggle_snap";
+        whip: "whip";
+        whoosh: "whoosh";
+    }>>;
+    ring: z.ZodOptional<z.ZodEnum<{
+        answer_confirm: "answer_confirm";
+        answer_open: "answer_open";
+        answer_pop: "answer_pop";
+        answer_select: "answer_select";
+        bong: "bong";
+        chime: "chime";
+        click_crisp: "click_crisp";
+        click_light: "click_light";
+        click_mouse: "click_mouse";
+        click_soft: "click_soft";
+        drop: "drop";
+        drop_high: "drop_high";
+        glass_ping: "glass_ping";
+        glass_soft: "glass_soft";
+        glitch: "glitch";
+        paper_swipe: "paper_swipe";
+        pluck: "pluck";
+        pluck_bright: "pluck_bright";
+        question_ping: "question_ping";
+        ring_classic: "ring_classic";
+        ring_digital: "ring_digital";
+        ring_marimba: "ring_marimba";
+        shutter: "shutter";
+        sweep: "sweep";
+        switch_flip: "switch_flip";
+        switch_heavy: "switch_heavy";
+        switch_light: "switch_light";
+        tick: "tick";
+        toggle_snap: "toggle_snap";
+        whip: "whip";
+        whoosh: "whoosh";
+    }>>;
+    answer: z.ZodOptional<z.ZodEnum<{
+        answer_confirm: "answer_confirm";
+        answer_open: "answer_open";
+        answer_pop: "answer_pop";
+        answer_select: "answer_select";
+        bong: "bong";
+        chime: "chime";
+        click_crisp: "click_crisp";
+        click_light: "click_light";
+        click_mouse: "click_mouse";
+        click_soft: "click_soft";
+        drop: "drop";
+        drop_high: "drop_high";
+        glass_ping: "glass_ping";
+        glass_soft: "glass_soft";
+        glitch: "glitch";
+        paper_swipe: "paper_swipe";
+        pluck: "pluck";
+        pluck_bright: "pluck_bright";
+        question_ping: "question_ping";
+        ring_classic: "ring_classic";
+        ring_digital: "ring_digital";
+        ring_marimba: "ring_marimba";
+        shutter: "shutter";
+        sweep: "sweep";
+        switch_flip: "switch_flip";
+        switch_heavy: "switch_heavy";
+        switch_light: "switch_light";
+        tick: "tick";
+        toggle_snap: "toggle_snap";
+        whip: "whip";
+        whoosh: "whoosh";
+    }>>;
+    notify: z.ZodOptional<z.ZodEnum<{
+        answer_confirm: "answer_confirm";
+        answer_open: "answer_open";
+        answer_pop: "answer_pop";
+        answer_select: "answer_select";
+        bong: "bong";
+        chime: "chime";
+        click_crisp: "click_crisp";
+        click_light: "click_light";
+        click_mouse: "click_mouse";
+        click_soft: "click_soft";
+        drop: "drop";
+        drop_high: "drop_high";
+        glass_ping: "glass_ping";
+        glass_soft: "glass_soft";
+        glitch: "glitch";
+        paper_swipe: "paper_swipe";
+        pluck: "pluck";
+        pluck_bright: "pluck_bright";
+        question_ping: "question_ping";
+        ring_classic: "ring_classic";
+        ring_digital: "ring_digital";
+        ring_marimba: "ring_marimba";
+        shutter: "shutter";
+        sweep: "sweep";
+        switch_flip: "switch_flip";
+        switch_heavy: "switch_heavy";
+        switch_light: "switch_light";
+        tick: "tick";
+        toggle_snap: "toggle_snap";
+        whip: "whip";
+        whoosh: "whoosh";
+    }>>;
+    step: z.ZodOptional<z.ZodEnum<{
+        answer_confirm: "answer_confirm";
+        answer_open: "answer_open";
+        answer_pop: "answer_pop";
+        answer_select: "answer_select";
+        bong: "bong";
+        chime: "chime";
+        click_crisp: "click_crisp";
+        click_light: "click_light";
+        click_mouse: "click_mouse";
+        click_soft: "click_soft";
+        drop: "drop";
+        drop_high: "drop_high";
+        glass_ping: "glass_ping";
+        glass_soft: "glass_soft";
+        glitch: "glitch";
+        paper_swipe: "paper_swipe";
+        pluck: "pluck";
+        pluck_bright: "pluck_bright";
+        question_ping: "question_ping";
+        ring_classic: "ring_classic";
+        ring_digital: "ring_digital";
+        ring_marimba: "ring_marimba";
+        shutter: "shutter";
+        sweep: "sweep";
+        switch_flip: "switch_flip";
+        switch_heavy: "switch_heavy";
+        switch_light: "switch_light";
+        tick: "tick";
+        toggle_snap: "toggle_snap";
+        whip: "whip";
+        whoosh: "whoosh";
+    }>>;
+    whoosh: z.ZodOptional<z.ZodEnum<{
+        answer_confirm: "answer_confirm";
+        answer_open: "answer_open";
+        answer_pop: "answer_pop";
+        answer_select: "answer_select";
+        bong: "bong";
+        chime: "chime";
+        click_crisp: "click_crisp";
+        click_light: "click_light";
+        click_mouse: "click_mouse";
+        click_soft: "click_soft";
+        drop: "drop";
+        drop_high: "drop_high";
+        glass_ping: "glass_ping";
+        glass_soft: "glass_soft";
+        glitch: "glitch";
+        paper_swipe: "paper_swipe";
+        pluck: "pluck";
+        pluck_bright: "pluck_bright";
+        question_ping: "question_ping";
+        ring_classic: "ring_classic";
+        ring_digital: "ring_digital";
+        ring_marimba: "ring_marimba";
+        shutter: "shutter";
+        sweep: "sweep";
+        switch_flip: "switch_flip";
+        switch_heavy: "switch_heavy";
+        switch_light: "switch_light";
+        tick: "tick";
+        toggle_snap: "toggle_snap";
+        whip: "whip";
+        whoosh: "whoosh";
+    }>>;
+    flash: z.ZodOptional<z.ZodEnum<{
+        answer_confirm: "answer_confirm";
+        answer_open: "answer_open";
+        answer_pop: "answer_pop";
+        answer_select: "answer_select";
+        bong: "bong";
+        chime: "chime";
+        click_crisp: "click_crisp";
+        click_light: "click_light";
+        click_mouse: "click_mouse";
+        click_soft: "click_soft";
+        drop: "drop";
+        drop_high: "drop_high";
+        glass_ping: "glass_ping";
+        glass_soft: "glass_soft";
+        glitch: "glitch";
+        paper_swipe: "paper_swipe";
+        pluck: "pluck";
+        pluck_bright: "pluck_bright";
+        question_ping: "question_ping";
+        ring_classic: "ring_classic";
+        ring_digital: "ring_digital";
+        ring_marimba: "ring_marimba";
+        shutter: "shutter";
+        sweep: "sweep";
+        switch_flip: "switch_flip";
+        switch_heavy: "switch_heavy";
+        switch_light: "switch_light";
+        tick: "tick";
+        toggle_snap: "toggle_snap";
+        whip: "whip";
+        whoosh: "whoosh";
+    }>>;
+}, z.core.$strict>]>;
+export type TemplateSounds = z.infer<typeof templateSounds>;
+/** The slim MCP field, which keeps tools/list small: any beat and name pass here, and the server checks them strictly (S3 D3). */
+export declare const mcpTemplateSounds: z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodRecord<z.ZodString, z.ZodString>]>;
+/** A run's sounds: the defaults with its overrides, or none for `false` (S3c C2, C4). */
+export declare function templateSoundMap(sounds: TemplateSounds | undefined): TemplateSoundMap | undefined;
+/** The beats one template plays: its kind's, and on a full frame its wipe or zoom (whoosh) or flash. */
+export declare function templateSoundBeats(item: {
+    kind: string;
+    placement: string;
+    transition?: string | undefined;
+}): TemplateSoundBeat[];
+export declare const TEMPLATE_SOUNDS_PATH = "/v1/template-sounds";
+/** The catalog `GET /v1/template-sounds` and `list_template_sounds` return. */
+export declare const templateSoundsList: z.ZodObject<{
+    beats: z.ZodArray<z.ZodObject<{
+        beat: z.ZodEnum<{
+            answer: "answer";
+            click: "click";
+            flash: "flash";
+            notify: "notify";
+            ring: "ring";
+            step: "step";
+            toggle: "toggle";
+            whoosh: "whoosh";
+        }>;
+        default: z.ZodString;
+        names: z.ZodArray<z.ZodString>;
+        plays: z.ZodString;
+    }, z.core.$strict>>;
+    contract_version: z.ZodString;
+}, z.core.$strict>;
+export type TemplateSoundsList = z.infer<typeof templateSoundsList>;
+export declare function listTemplateSounds(): TemplateSoundsList["beats"];