@prestyj/editor 0.7.1

package/dist/core/styles-loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=styles-loader.test.d.ts.map

package/dist/core/styles-loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles-loader.test.d.ts","sourceRoot":"","sources":["../../src/core/styles-loader.test.ts"],"names":[],"mappings":""}

package/dist/core/styles-loader.test.js

@@ -0,0 +1,72 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+import { discoverStyles, renderStylesBlock } from "./styles-loader.js";
+function tmp(prefix) {
+    return mkdtempSync(join(tmpdir(), prefix));
+}
+describe("discoverStyles", () => {
+    it("returns empty when neither dir exists", () => {
+        const cwd = tmp("gg-styles-cwd-");
+        const home = tmp("gg-styles-home-");
+        expect(discoverStyles({ cwd, homeDir: home })).toEqual([]);
+    });
+    it("loads project + user styles", () => {
+        const cwd = tmp("gg-styles-cwd-");
+        const home = tmp("gg-styles-home-");
+        mkdirSync(join(cwd, ".ezcoder/editor-styles"), { recursive: true });
+        mkdirSync(join(home, ".ezcoder/editor-styles"), { recursive: true });
+        writeFileSync(join(cwd, ".ezcoder/editor-styles/voice.md"), "# voice\nproject voice");
+        writeFileSync(join(home, ".ezcoder/editor-styles/format.md"), "# format\nuser format");
+        const r = discoverStyles({ cwd, homeDir: home });
+        expect(r.map((s) => s.name).sort()).toEqual(["format", "voice"]);
+        expect(r.find((s) => s.name === "voice")?.origin).toBe("project");
+        expect(r.find((s) => s.name === "format")?.origin).toBe("user");
+    });
+    it("project overrides user on name collision (opposite of skills)", () => {
+        const cwd = tmp("gg-styles-cwd-");
+        const home = tmp("gg-styles-home-");
+        mkdirSync(join(cwd, ".ezcoder/editor-styles"), { recursive: true });
+        mkdirSync(join(home, ".ezcoder/editor-styles"), { recursive: true });
+        writeFileSync(join(cwd, ".ezcoder/editor-styles/x.md"), "project");
+        writeFileSync(join(home, ".ezcoder/editor-styles/x.md"), "user");
+        const r = discoverStyles({ cwd, homeDir: home });
+        expect(r).toHaveLength(1);
+        expect(r[0].origin).toBe("project");
+    });
+    it("skips empty files", () => {
+        const cwd = tmp("gg-styles-cwd-");
+        const home = tmp("gg-styles-home-");
+        mkdirSync(join(home, ".ezcoder/editor-styles"), { recursive: true });
+        writeFileSync(join(home, ".ezcoder/editor-styles/empty.md"), "   \n  \n");
+        expect(discoverStyles({ cwd, homeDir: home })).toEqual([]);
+    });
+});
+describe("renderStylesBlock", () => {
+    it("returns empty string when no styles", () => {
+        expect(renderStylesBlock([])).toBe("");
+    });
+    it("renders one block per style with origin tag", () => {
+        const out = renderStylesBlock([
+            {
+                name: "voice",
+                content: "Be terse.",
+                origin: "project",
+                path: "/x/voice.md",
+            },
+            {
+                name: "format",
+                content: "Use bullet lists.",
+                origin: "user",
+                path: "/y/format.md",
+            },
+        ]);
+        expect(out).toContain("# Active style presets");
+        expect(out).toContain("## voice _(project)_");
+        expect(out).toContain("Be terse.");
+        expect(out).toContain("## format _(user)_");
+        expect(out).toContain("Use bullet lists.");
+    });
+});
+//# sourceMappingURL=styles-loader.test.js.map

package/dist/core/styles-loader.test.js.map

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

package/dist/core/text-overlay.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Text-overlay builders — lower-thirds + title cards as ASS files.
+ *
+ * Why ASS and not ffmpeg drawtext: stock Homebrew ffmpeg ships WITHOUT
+ * libfreetype, so drawtext returns "Unknown filter". The libass-backed
+ * `subtitles` filter IS present in every build. We piggy-back on the same
+ * burn_subtitles tool used for captions.
+ *
+ * ASS animation primitives we use (verified against zhw2590582/ArtPlayer,
+ * Cyberbeing/xy-VSFilter, MPC-HC's RTS.cpp):
+ *   {\move(x1,y1,x2,y2,t1,t2)}  — slide a tag from (x1,y1) to (x2,y2) between
+ *                                 ms t1 and t2. Coordinates are PlayRes pixels.
+ *   {\fad(in,out)}              — fade in over `in` ms, fade out over `out` ms.
+ *   {\pos(x,y)}                 — absolute position override.
+ *   {\an<n>}                    — alignment (numpad layout).
+ *   {\fs<n>}                    — font size override.
+ *   {\b1}                        — bold.
+ *   {\c&Hbbggrr&}                — primary color override (BGR hex).
+ *   {\3c&Hbbggrr&}               — outline color.
+ *   {\bord<n>}                   — outline thickness.
+ *   {\blur<n>}                   — gaussian blur.
+ *
+ * Output: a complete ASS file ready for `burn_subtitles` or NLE import.
+ */
+export type LowerThirdPosition = "bottom-left" | "bottom-center" | "bottom-right" | "top-left" | "top-center" | "top-right";
+export type LowerThirdAnimation = "slide-left" | "slide-right" | "fade" | "none";
+export interface LowerThird {
+    /** Big text — name / topic. Required. */
+    primaryText: string;
+    /** Small text — title / role / source. Optional. */
+    secondaryText?: string;
+    /** When the lower-third appears, in seconds. */
+    startSec: number;
+    /** How long it stays on screen, in seconds. */
+    durationSec: number;
+    fontName?: string;
+    /** Hex RRGGBB. Default white. */
+    primaryColor?: string;
+    /** Outline / accent color. Default black. */
+    accentColor?: string;
+    position?: LowerThirdPosition;
+    animation?: LowerThirdAnimation;
+    /** Distance from the canvas edge in pixels. Default 80. */
+    marginPx?: number;
+}
+export type TitleCardAnimation = "fade-in-out" | "zoom-in" | "type-on" | "none";
+export interface TitleCard {
+    text: string;
+    startSec: number;
+    durationSec: number;
+    fontName?: string;
+    fontSize?: number;
+    /** Hex RRGGBB. Default white. */
+    color?: string;
+    /** Numpad alignment (1=bot-left, 2=bot-center, ..., 5=middle, 9=top-right). */
+    alignment?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+    animation?: TitleCardAnimation;
+}
+export interface CanvasOpts {
+    width: number;
+    height: number;
+}
+/**
+ * Build an ASS file containing one or more lower-thirds.
+ *
+ * Each lower-third becomes ONE ASS dialogue line whose text starts with
+ * the `{\move(...)\fad(...)}` override block. The ASS engine handles all
+ * tween math.
+ */
+export declare function buildLowerThirdAss(items: LowerThird[], canvas: CanvasOpts): string;
+/**
+ * Build an ASS file containing one or more title cards. Centred big-type
+ * cards with optional zoom-in / fade animations.
+ */
+export declare function buildTitleCardAss(items: TitleCard[], canvas: CanvasOpts): string;
+//# sourceMappingURL=text-overlay.d.ts.map

package/dist/core/text-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-overlay.d.ts","sourceRoot":"","sources":["../../src/core/text-overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,eAAe,GACf,cAAc,GACd,UAAU,GACV,YAAY,GACZ,WAAW,CAAC;AAEhB,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAiElF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CA0DhF"}

package/dist/core/text-overlay.js

@@ -0,0 +1,233 @@
+/**
+ * Text-overlay builders — lower-thirds + title cards as ASS files.
+ *
+ * Why ASS and not ffmpeg drawtext: stock Homebrew ffmpeg ships WITHOUT
+ * libfreetype, so drawtext returns "Unknown filter". The libass-backed
+ * `subtitles` filter IS present in every build. We piggy-back on the same
+ * burn_subtitles tool used for captions.
+ *
+ * ASS animation primitives we use (verified against zhw2590582/ArtPlayer,
+ * Cyberbeing/xy-VSFilter, MPC-HC's RTS.cpp):
+ *   {\move(x1,y1,x2,y2,t1,t2)}  — slide a tag from (x1,y1) to (x2,y2) between
+ *                                 ms t1 and t2. Coordinates are PlayRes pixels.
+ *   {\fad(in,out)}              — fade in over `in` ms, fade out over `out` ms.
+ *   {\pos(x,y)}                 — absolute position override.
+ *   {\an<n>}                    — alignment (numpad layout).
+ *   {\fs<n>}                    — font size override.
+ *   {\b1}                        — bold.
+ *   {\c&Hbbggrr&}                — primary color override (BGR hex).
+ *   {\3c&Hbbggrr&}               — outline color.
+ *   {\bord<n>}                   — outline thickness.
+ *   {\blur<n>}                   — gaussian blur.
+ *
+ * Output: a complete ASS file ready for `burn_subtitles` or NLE import.
+ */
+import { assColor, buildAss } from "./ass.js";
+/**
+ * Build an ASS file containing one or more lower-thirds.
+ *
+ * Each lower-third becomes ONE ASS dialogue line whose text starts with
+ * the `{\move(...)\fad(...)}` override block. The ASS engine handles all
+ * tween math.
+ */
+export function buildLowerThirdAss(items, canvas) {
+    if (items.length === 0) {
+        throw new Error("buildLowerThirdAss: items must not be empty");
+    }
+    const styles = [
+        {
+            name: "Default",
+            fontName: items[0].fontName ?? "Helvetica",
+            fontSize: 56,
+            primaryColor: "FFFFFF",
+            outlineColor: "000000",
+            outline: 3,
+            shadow: 1,
+            bold: true,
+            // Bottom-left numpad alignment by default; per-cue overrides via {\anN}.
+            alignment: 1,
+            marginV: 80,
+        },
+    ];
+    const cues = [];
+    for (const lt of items) {
+        if (lt.durationSec <= 0) {
+            throw new Error("lower-third durationSec must be > 0");
+        }
+        const margin = lt.marginPx ?? 80;
+        const pos = lt.position ?? "bottom-left";
+        const { x1, y1, x2, y2, an } = computeLowerThirdMotion(pos, lt.animation ?? "slide-left", {
+            width: canvas.width,
+            height: canvas.height,
+            margin,
+        });
+        const fadeIn = 250;
+        const fadeOut = 250;
+        const moveDurationMs = 500;
+        const fadeOnly = (lt.animation ?? "slide-left") === "fade" || lt.animation === "none";
+        const overrides = [];
+        overrides.push(`\\an${an}`);
+        if (fadeOnly) {
+            overrides.push(`\\pos(${x2},${y2})`);
+        }
+        else {
+            overrides.push(`\\move(${x1},${y1},${x2},${y2},0,${moveDurationMs})`);
+        }
+        overrides.push(`\\fad(${fadeIn},${fadeOut})`);
+        if (lt.primaryColor)
+            overrides.push(`\\c${assColor(lt.primaryColor)}`);
+        if (lt.accentColor)
+            overrides.push(`\\3c${assColor(lt.accentColor)}`);
+        const overridesBlock = `{${overrides.join("")}}`;
+        const text = lt.secondaryText
+            ? `${overridesBlock}${escapeText(lt.primaryText)}\\N${escapeText(lt.secondaryText)}`
+            : `${overridesBlock}${escapeText(lt.primaryText)}`;
+        cues.push({
+            start: lt.startSec,
+            end: lt.startSec + lt.durationSec,
+            text,
+        });
+    }
+    return buildAssRaw({
+        title: "lower-thirds",
+        playResX: canvas.width,
+        playResY: canvas.height,
+        styles,
+        cues,
+    }, canvas);
+}
+/**
+ * Build an ASS file containing one or more title cards. Centred big-type
+ * cards with optional zoom-in / fade animations.
+ */
+export function buildTitleCardAss(items, canvas) {
+    if (items.length === 0) {
+        throw new Error("buildTitleCardAss: items must not be empty");
+    }
+    const styles = [
+        {
+            name: "Default",
+            fontName: items[0].fontName ?? "Helvetica",
+            fontSize: items[0].fontSize ?? 110,
+            primaryColor: "FFFFFF",
+            outlineColor: "000000",
+            outline: 4,
+            shadow: 0,
+            bold: true,
+            alignment: 5,
+            marginV: 60,
+        },
+    ];
+    const cues = [];
+    for (const tc of items) {
+        if (tc.durationSec <= 0) {
+            throw new Error("title card durationSec must be > 0");
+        }
+        const overrides = [];
+        if (tc.alignment)
+            overrides.push(`\\an${tc.alignment}`);
+        if (tc.fontSize)
+            overrides.push(`\\fs${tc.fontSize}`);
+        if (tc.color)
+            overrides.push(`\\c${assColor(tc.color)}`);
+        const animation = tc.animation ?? "fade-in-out";
+        if (animation === "fade-in-out") {
+            overrides.push(`\\fad(400,400)`);
+        }
+        else if (animation === "zoom-in") {
+            overrides.push(`\\fad(200,200)`);
+            // Scale grows from 70% to 100% over the first half of the card.
+            const halfMs = Math.round(tc.durationSec * 1000 * 0.5);
+            overrides.push(`\\t(0,${halfMs},\\fscx100\\fscy100)`);
+            // Open with smaller size; \t will animate up.
+            overrides.unshift(`\\fscx70\\fscy70`);
+        }
+        else if (animation === "type-on") {
+            // Approximate type-on by stepping fade-in across the duration.
+            overrides.push(`\\fad(${Math.round(tc.durationSec * 1000 * 0.5)},200)`);
+        }
+        const text = `{${overrides.join("")}}${escapeText(tc.text)}`;
+        cues.push({
+            start: tc.startSec,
+            end: tc.startSec + tc.durationSec,
+            text,
+        });
+    }
+    return buildAssRaw({
+        title: "title-cards",
+        playResX: canvas.width,
+        playResY: canvas.height,
+        styles,
+        cues,
+    }, canvas);
+}
+/**
+ * Some override tags (\move, \fad inside the dialogue text) need to survive
+ * the existing ass.ts buildAss escaping. buildAss strips CR but doesn't
+ * touch our override syntax, so we can pass through. This wrapper is here
+ * mostly for future hardening.
+ */
+function buildAssRaw(opts, _canvas) {
+    return buildAss(opts);
+}
+function computeLowerThirdMotion(pos, animation, c) {
+    // ASS coords: (0,0) is top-left, +y is down. Positions reference the
+    // alignment anchor — a lower-third with \an1 (bottom-left) is anchored at
+    // the BOTTOM-LEFT of its bounding box.
+    const an = positionToAlignment(pos);
+    const final = anchorPoint(pos, c);
+    let start = { ...final };
+    if (animation === "slide-left") {
+        start = { x: -c.width, y: final.y };
+    }
+    else if (animation === "slide-right") {
+        start = { x: c.width * 2, y: final.y };
+    }
+    else if (animation === "fade" || animation === "none") {
+        start = { ...final };
+    }
+    return { x1: start.x, y1: start.y, x2: final.x, y2: final.y, an };
+}
+function anchorPoint(pos, c) {
+    const m = c.margin;
+    switch (pos) {
+        case "bottom-left":
+            return { x: m, y: c.height - m };
+        case "bottom-center":
+            return { x: c.width / 2, y: c.height - m };
+        case "bottom-right":
+            return { x: c.width - m, y: c.height - m };
+        case "top-left":
+            return { x: m, y: m };
+        case "top-center":
+            return { x: c.width / 2, y: m };
+        case "top-right":
+            return { x: c.width - m, y: m };
+    }
+}
+function positionToAlignment(pos) {
+    // Numpad layout: 1=bot-left, 2=bot-center, 3=bot-right, 7=top-left,
+    // 8=top-center, 9=top-right.
+    switch (pos) {
+        case "bottom-left":
+            return 1;
+        case "bottom-center":
+            return 2;
+        case "bottom-right":
+            return 3;
+        case "top-left":
+            return 7;
+        case "top-center":
+            return 8;
+        case "top-right":
+            return 9;
+    }
+}
+function escapeText(s) {
+    // Keep ASS override braces intact; strip CR so cues stay single-line.
+    // Real newlines become hard-break \N (matches buildAss's own escaping for
+    // plain text but we need to do it manually because we already wrap our
+    // text with overrides).
+    return s.replace(/\r\n?|\n/g, "\\N");
+}
+//# sourceMappingURL=text-overlay.js.map

package/dist/core/text-overlay.js.map

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

package/dist/core/text-overlay.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=text-overlay.test.d.ts.map

package/dist/core/text-overlay.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-overlay.test.d.ts","sourceRoot":"","sources":["../../src/core/text-overlay.test.ts"],"names":[],"mappings":""}

package/dist/core/text-overlay.test.js

@@ -0,0 +1,103 @@
+import { describe, expect, it } from "vitest";
+import { buildLowerThirdAss, buildTitleCardAss } from "./text-overlay.js";
+describe("buildLowerThirdAss", () => {
+    it("rejects empty list", () => {
+        expect(() => buildLowerThirdAss([], { width: 1920, height: 1080 })).toThrow(/empty/);
+    });
+    it("emits a slide-left lower-third with \\move + \\fad", () => {
+        const ass = buildLowerThirdAss([
+            {
+                primaryText: "Jane Doe",
+                secondaryText: "Director",
+                startSec: 1,
+                durationSec: 3,
+                position: "bottom-left",
+                animation: "slide-left",
+                marginPx: 80,
+            },
+        ], { width: 1920, height: 1080 });
+        expect(ass).toContain("[V4+ Styles]");
+        // \move from off-canvas-left to (80, 1000) — bottom-left anchor.
+        expect(ass).toMatch(/\\move\(-1920,1000,80,1000,0,500\)/);
+        expect(ass).toContain("\\fad(250,250)");
+        expect(ass).toContain("Jane Doe\\NDirector");
+        expect(ass).toMatch(/\\an1/);
+    });
+    it("uses \\pos (not \\move) for fade animation", () => {
+        const ass = buildLowerThirdAss([
+            {
+                primaryText: "Hello",
+                startSec: 0,
+                durationSec: 2,
+                position: "bottom-center",
+                animation: "fade",
+            },
+        ], { width: 1920, height: 1080 });
+        expect(ass).toMatch(/\\pos\(960,1000\)/);
+        expect(ass).not.toContain("\\move");
+        expect(ass).toMatch(/\\an2/);
+    });
+    it("supports top-right alignment", () => {
+        const ass = buildLowerThirdAss([
+            {
+                primaryText: "Note",
+                startSec: 0,
+                durationSec: 1,
+                position: "top-right",
+                animation: "none",
+                marginPx: 40,
+            },
+        ], { width: 1920, height: 1080 });
+        expect(ass).toMatch(/\\an9/);
+        // top-right anchor at (1880, 40).
+        expect(ass).toMatch(/\\pos\(1880,40\)/);
+    });
+    it("emits primary and accent color overrides as ASS &Hbbggrr&", () => {
+        const ass = buildLowerThirdAss([
+            {
+                primaryText: "Jane",
+                startSec: 0,
+                durationSec: 1,
+                primaryColor: "FF0000",
+                accentColor: "000000",
+                animation: "fade",
+            },
+        ], { width: 1920, height: 1080 });
+        // Red primary: ASS BGR = &H000000FF& with alpha 00.
+        expect(ass).toMatch(/\\c&H000000FF&/);
+        expect(ass).toMatch(/\\3c&H00000000&/);
+    });
+    it("rejects zero/negative duration", () => {
+        expect(() => buildLowerThirdAss([{ primaryText: "x", startSec: 0, durationSec: 0 }], {
+            width: 1920,
+            height: 1080,
+        })).toThrow();
+    });
+});
+describe("buildTitleCardAss", () => {
+    it("rejects empty list", () => {
+        expect(() => buildTitleCardAss([], { width: 1920, height: 1080 })).toThrow(/empty/);
+    });
+    it("default fade-in-out title card", () => {
+        const ass = buildTitleCardAss([{ text: "Chapter 1", startSec: 0, durationSec: 4 }], {
+            width: 1920,
+            height: 1080,
+        });
+        expect(ass).toContain("\\fad(400,400)");
+        expect(ass).toContain("Chapter 1");
+    });
+    it("zoom-in title card emits \\t scale tween", () => {
+        const ass = buildTitleCardAss([{ text: "Big", startSec: 0, durationSec: 2, animation: "zoom-in" }], { width: 1920, height: 1080 });
+        // Initial 70% scale, animate to 100% over half the duration.
+        expect(ass).toMatch(/\\fscx70\\fscy70/);
+        expect(ass).toMatch(/\\t\(0,1000,\\fscx100\\fscy100\)/);
+    });
+    it("respects custom font size override on the cue (\\fs)", () => {
+        const ass = buildTitleCardAss([{ text: "X", startSec: 0, durationSec: 1, fontSize: 200 }], {
+            width: 1920,
+            height: 1080,
+        });
+        expect(ass).toMatch(/\\fs200/);
+    });
+});
+//# sourceMappingURL=text-overlay.test.js.map

package/dist/core/text-overlay.test.js.map

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

package/dist/core/thumbnail-compose.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Pure helper for composing a single thumbnail frame: pull a frame at
+ * `atSec` and burn a headline on top with ffmpeg drawtext.
+ *
+ * Extracted from compose-thumbnail.ts so `compose_thumbnail_variants`
+ * can call the same logic three times without duplicating the drawtext
+ * filter construction.
+ */
+export interface ComposeThumbnailOpts {
+    /** Source video path (already absolute or pre-resolved). */
+    input: string;
+    /** Output .jpg/.png absolute path. */
+    output: string;
+    /** Frame timestamp. */
+    atSec: number;
+    /** Headline text overlay (raw — escaping is handled internally). */
+    text: string;
+    /** Path to a TTF font; falls back to common system locations. */
+    fontFile?: string;
+    fontSize?: number;
+    fontColor?: string;
+    /** Empty string disables outline. Default 'black'. */
+    outlineColor?: string;
+    position?: "top" | "center" | "bottom";
+    /** Optional output width (height auto). */
+    width?: number;
+    signal?: AbortSignal;
+}
+export interface ComposeThumbnailResult {
+    ok: true;
+    path: string;
+    fontFile: string;
+}
+/**
+ * Burn a headline onto a single frame from the source video and write
+ * it to disk. Returns the resolved font path so callers can surface it
+ * in their output.
+ *
+ * Throws on:
+ *   - no system font found (and none provided)
+ *   - ffmpeg drawtext exit ≠ 0
+ */
+export declare function composeThumbnailFrame(opts: ComposeThumbnailOpts, cwd?: string): Promise<ComposeThumbnailResult>;
+export declare function pickFont(): string | undefined;
+/**
+ * Escape a string for ffmpeg drawtext's `text='...'` parameter.
+ *
+ * Rules (verified against real-world implementations):
+ *   1. `\\` first  → `\\\\`
+ *   2. `:`         → `\\:`
+ *   3. `'`         → `\\'`
+ *   4. `%`         → `\\%`  (because `%{...}` is used for runtime expansions)
+ *   5. newlines    → literal `\\n` (drawtext renders as a line break)
+ *
+ * Backslash MUST come first so subsequent escapes don't double-escape.
+ */
+export declare function escapeDrawtextValue(text: string): string;
+//# sourceMappingURL=thumbnail-compose.d.ts.map

package/dist/core/thumbnail-compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail-compose.d.ts","sourceRoot":"","sources":["../../src/core/thumbnail-compose.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAUD,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,oBAAoB,EAC1B,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CA8CjC;AAED,wBAAgB,QAAQ,IAAI,MAAM,GAAG,SAAS,CAS7C;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOxD"}