@kenkaiiii/gg-editor 0.1.0

package/dist/core/srt.js

@@ -0,0 +1,90 @@
+/**
+ * SRT (SubRip) writer.
+ *
+ * Standard format:
+ *   1
+ *   00:00:01,000 --> 00:00:03,500
+ *   Hello world.
+ *
+ *   2
+ *   00:00:04,000 --> 00:00:06,000
+ *   Second cue.
+ *
+ * Cue numbering is 1-indexed. Timestamps are HH:MM:SS,mmm with comma decimal.
+ * CRLF line endings are NOT required by the spec — most parsers accept LF
+ * (we emit LF for simplicity and cross-platform sanity).
+ *
+ * Input is a list of cues with seconds-precision start/end. Empty `text`
+ * cues are skipped (an empty cue is invalid SRT).
+ */
+/**
+ * Word-level SRT — one cue per word. Useful for vertical-format burned-in
+ * captions where each word pops as it's spoken.
+ *
+ * Behaviour:
+ *   - Skips empty / zero-duration words.
+ *   - Optional `groupSize` clusters N consecutive words into one cue (e.g. 2-3
+ *     words at a time for a more readable rhythm). Default 1.
+ *   - Optional `gapSec` extends a cue's end up to the next cue's start so the
+ *     caption stays on screen until the next word appears (closed-caption look).
+ */
+export function buildWordLevelSrt(words, opts = {}) {
+    const groupSize = Math.max(1, Math.floor(opts.groupSize ?? 1));
+    const filled = words.filter((w) => (w.text ?? "").trim() && w.end > w.start);
+    const cues = [];
+    for (let i = 0; i < filled.length; i += groupSize) {
+        const group = filled.slice(i, i + groupSize);
+        cues.push({
+            start: group[0].start,
+            end: group[group.length - 1].end,
+            text: group.map((g) => g.text.trim()).join(" "),
+        });
+    }
+    if (opts.gapSec !== undefined && opts.gapSec >= 0) {
+        for (let i = 0; i < cues.length - 1; i += 1) {
+            const gap = cues[i + 1].start - cues[i].end;
+            if (gap > 0 && gap <= opts.gapSec) {
+                cues[i].end = cues[i + 1].start;
+            }
+        }
+    }
+    return buildSrt(cues);
+}
+/** Build an SRT string from cues. Cues are emitted in input order. */
+export function buildSrt(cues) {
+    const out = [];
+    let n = 0;
+    for (const cue of cues) {
+        const text = (cue.text ?? "").trim();
+        if (!text)
+            continue;
+        if (cue.end <= cue.start) {
+            throw new Error(`cue ${n + 1}: end (${cue.end}) must be > start (${cue.start})`);
+        }
+        n += 1;
+        out.push(String(n));
+        out.push(`${formatSrtTime(cue.start)} --> ${formatSrtTime(cue.end)}`);
+        out.push(text);
+        out.push("");
+    }
+    return out.join("\n");
+}
+/** Format seconds → "HH:MM:SS,mmm" (SRT timestamp). */
+export function formatSrtTime(seconds) {
+    if (!Number.isFinite(seconds) || seconds < 0)
+        seconds = 0;
+    const totalMs = Math.round(seconds * 1000);
+    const ms = totalMs % 1000;
+    const totalSec = Math.floor(totalMs / 1000);
+    const ss = totalSec % 60;
+    const mm = Math.floor(totalSec / 60) % 60;
+    const hh = Math.floor(totalSec / 3600);
+    return (String(hh).padStart(2, "0") +
+        ":" +
+        String(mm).padStart(2, "0") +
+        ":" +
+        String(ss).padStart(2, "0") +
+        "," +
+        String(ms).padStart(3, "0"));
+}
+//# sourceMappingURL=srt.js.map

package/dist/core/srt.js.map

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

package/dist/core/srt.test.d.ts

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

package/dist/core/srt.test.d.ts.map

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

package/dist/core/srt.test.js

@@ -0,0 +1,107 @@
+import { describe, expect, it } from "vitest";
+import { buildSrt, buildWordLevelSrt, formatSrtTime } from "./srt.js";
+describe("formatSrtTime", () => {
+    it("formats zero", () => {
+        expect(formatSrtTime(0)).toBe("00:00:00,000");
+    });
+    it("formats sub-second", () => {
+        expect(formatSrtTime(0.5)).toBe("00:00:00,500");
+    });
+    it("formats hours/minutes/seconds/ms", () => {
+        expect(formatSrtTime(3661.234)).toBe("01:01:01,234");
+    });
+    it("clamps negatives to zero", () => {
+        expect(formatSrtTime(-3)).toBe("00:00:00,000");
+    });
+});
+describe("buildWordLevelSrt", () => {
+    it("emits one cue per word by default", () => {
+        const out = buildWordLevelSrt([
+            { start: 0, end: 0.3, text: "hello" },
+            { start: 0.3, end: 0.6, text: "world" },
+        ]);
+        expect(out).toContain("1\n00:00:00,000 --> 00:00:00,300\nhello");
+        expect(out).toContain("2\n00:00:00,300 --> 00:00:00,600\nworld");
+    });
+    it("groups words when groupSize > 1", () => {
+        const out = buildWordLevelSrt([
+            { start: 0, end: 0.2, text: "a" },
+            { start: 0.2, end: 0.4, text: "b" },
+            { start: 0.4, end: 0.6, text: "c" },
+            { start: 0.6, end: 0.8, text: "d" },
+        ], { groupSize: 2 });
+        expect(out).toContain("1\n00:00:00,000 --> 00:00:00,400\na b");
+        expect(out).toContain("2\n00:00:00,400 --> 00:00:00,800\nc d");
+        expect(out).not.toContain("3\n");
+    });
+    it("extends cue ends up to next cue start when gapSec allows", () => {
+        const out = buildWordLevelSrt([
+            { start: 0, end: 0.3, text: "first" },
+            { start: 0.5, end: 0.8, text: "second" },
+        ], { gapSec: 0.5 });
+        // First cue should now end at 0.5 (start of second).
+        expect(out).toContain("00:00:00,000 --> 00:00:00,500");
+    });
+    it("does NOT extend across gaps larger than gapSec", () => {
+        const out = buildWordLevelSrt([
+            { start: 0, end: 0.3, text: "first" },
+            { start: 5, end: 5.3, text: "second" },
+        ], { gapSec: 0.5 });
+        expect(out).toContain("00:00:00,000 --> 00:00:00,300");
+    });
+    it("skips empty / zero-duration words", () => {
+        const out = buildWordLevelSrt([
+            { start: 0, end: 0.3, text: "a" },
+            { start: 0.3, end: 0.3, text: "" },
+            { start: 0.3, end: 0.3, text: "   " },
+            { start: 0.3, end: 0.6, text: "b" },
+        ]);
+        // Only "a" and "b" survive.
+        expect(out).toContain("1\n00:00:00,000 --> 00:00:00,300\na");
+        expect(out).toContain("2\n00:00:00,300 --> 00:00:00,600\nb");
+        expect(out).not.toContain("3\n");
+    });
+});
+describe("buildSrt", () => {
+    it("emits 1-indexed cues with HH:MM:SS,mmm timestamps", () => {
+        const out = buildSrt([
+            { start: 1, end: 3.5, text: "Hello world." },
+            { start: 4, end: 6, text: "Second cue." },
+        ]);
+        expect(out).toBe([
+            "1",
+            "00:00:01,000 --> 00:00:03,500",
+            "Hello world.",
+            "",
+            "2",
+            "00:00:04,000 --> 00:00:06,000",
+            "Second cue.",
+            "",
+        ].join("\n"));
+    });
+    it("preserves multi-line cue text and trims edges", () => {
+        const out = buildSrt([{ start: 0, end: 1, text: "  line one\nline two  " }]);
+        expect(out.includes("line one\nline two")).toBe(true);
+    });
+    it("skips empty-text cues without breaking numbering", () => {
+        const out = buildSrt([
+            { start: 0, end: 1, text: "first" },
+            { start: 1, end: 2, text: "   " },
+            { start: 2, end: 3, text: "second" },
+        ]);
+        const lines = out.split("\n");
+        expect(lines[0]).toBe("1");
+        expect(lines[4]).toBe("2");
+        expect(out.includes("first")).toBe(true);
+        expect(out.includes("second")).toBe(true);
+    });
+    it("rejects zero-or-negative duration cues", () => {
+        expect(() => buildSrt([{ start: 5, end: 5, text: "x" }])).toThrow(/end/);
+        expect(() => buildSrt([{ start: 5, end: 4, text: "x" }])).toThrow(/end/);
+    });
+    it("returns empty string for no usable cues", () => {
+        expect(buildSrt([])).toBe("");
+        expect(buildSrt([{ start: 0, end: 1, text: "" }])).toBe("");
+    });
+});
+//# sourceMappingURL=srt.test.js.map

package/dist/core/srt.test.js.map

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

package/dist/core/stabilize.d.ts

@@ -0,0 +1,15 @@
+export interface StabilizeOptions {
+    shakiness?: number;
+    smoothing?: number;
+    zoom?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Run pass 1 (analyse) + pass 2 (transform). Returns the path of the
+ * transforms file (kept for inspection / re-use).
+ */
+export declare function stabilize(inputPath: string, outputPath: string, opts?: StabilizeOptions): Promise<{
+    output: string;
+    transformsPath: string;
+}>;
+//# sourceMappingURL=stabilize.d.ts.map

package/dist/core/stabilize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stabilize.d.ts","sourceRoot":"","sources":["../../src/core/stabilize.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CA6CrD"}

package/dist/core/stabilize.js

@@ -0,0 +1,69 @@
+/**
+ * Two-pass video stabilization via ffmpeg's vidstabdetect + vidstabtransform.
+ *
+ * Pass 1: vidstabdetect analyses motion and writes a transforms file (.trf).
+ * Pass 2: vidstabtransform applies the inverse motion to stabilize.
+ *
+ * Quality knobs:
+ *   - shakiness (1-10, default 5): how shaky the input is. Higher = stronger detection.
+ *   - smoothing (1-30, default 15): camera-path smoothing window in frames.
+ *   - zoom (-10..10, default 0): output zoom percent. Stabilization shrinks
+ *     the visible frame; positive zoom hides the resulting borders.
+ *
+ * Requires ffmpeg compiled with libvidstab. Most modern builds include it
+ * (Homebrew, deb-multimedia, the static builds). We probe availability.
+ */
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { runFfmpeg } from "./media/ffmpeg.js";
+/**
+ * Run pass 1 (analyse) + pass 2 (transform). Returns the path of the
+ * transforms file (kept for inspection / re-use).
+ */
+export async function stabilize(inputPath, outputPath, opts = {}) {
+    const shakiness = clamp(opts.shakiness ?? 5, 1, 10);
+    const smoothing = clamp(opts.smoothing ?? 15, 1, 30);
+    const zoom = clamp(opts.zoom ?? 0, -10, 10);
+    const dir = mkdtempSync(join(tmpdir(), "gg-editor-stab-"));
+    const trfPath = join(dir, "transforms.trf");
+    // Pass 1
+    const p1 = await runFfmpeg([
+        "-i",
+        inputPath,
+        "-vf",
+        `vidstabdetect=shakiness=${shakiness}:result=${escapePath(trfPath)}`,
+        "-f",
+        "null",
+        "-",
+    ], { signal: opts.signal });
+    if (p1.code !== 0) {
+        throw new Error(`vidstabdetect exited ${p1.code}. Ensure ffmpeg was compiled with libvidstab. ` +
+            `tail: ${tail(p1.stderr)}`);
+    }
+    // Pass 2 — preserve audio.
+    const p2 = await runFfmpeg([
+        "-i",
+        inputPath,
+        "-vf",
+        `vidstabtransform=input=${escapePath(trfPath)}:smoothing=${smoothing}:zoom=${zoom}`,
+        "-c:a",
+        "copy",
+        outputPath,
+    ], { signal: opts.signal });
+    if (p2.code !== 0) {
+        throw new Error(`vidstabtransform exited ${p2.code}: ${tail(p2.stderr)}`);
+    }
+    return { output: outputPath, transformsPath: trfPath };
+}
+function clamp(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, n));
+}
+function escapePath(p) {
+    // ffmpeg filter args use ':' and '\' as separators; escape both.
+    return p.replace(/\\/g, "\\\\").replace(/:/g, "\\:");
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+//# sourceMappingURL=stabilize.js.map

package/dist/core/stabilize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stabilize.js","sourceRoot":"","sources":["../../src/core/stabilize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAS9C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAAiB,EACjB,UAAkB,EAClB,OAAyB,EAAE;IAE3B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAE5C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAE5C,SAAS;IACT,MAAM,EAAE,GAAG,MAAM,SAAS,CACxB;QACE,IAAI;QACJ,SAAS;QACT,KAAK;QACL,2BAA2B,SAAS,WAAW,UAAU,CAAC,OAAO,CAAC,EAAE;QACpE,IAAI;QACJ,MAAM;QACN,GAAG;KACJ,EACD,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACxB,CAAC;IACF,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,wBAAwB,EAAE,CAAC,IAAI,gDAAgD;YAC7E,SAAS,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAC7B,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,MAAM,EAAE,GAAG,MAAM,SAAS,CACxB;QACE,IAAI;QACJ,SAAS;QACT,KAAK;QACL,0BAA0B,UAAU,CAAC,OAAO,CAAC,cAAc,SAAS,SAAS,IAAI,EAAE;QACnF,MAAM;QACN,MAAM;QACN,UAAU;KACX,EACD,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACxB,CAAC;IACF,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,KAAK,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,iEAAiE;IACjE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,IAAI,CAAC,CAAS;IACrB,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;AACzE,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * Style presets — persistent user prefs about voice, format, defaults.
+ *
+ * Different from skills:
+ *   - Skills are read on-demand via `read_skill` ("when X happens, do Y").
+ *   - Styles are ALWAYS-ON. Their content folds into the system prompt as a
+ *     "Active style" section so every reply respects the user's standing prefs.
+ *
+ * Layout (last wins on name collisions):
+ *   <cwd>/.gg/editor-styles/*.md  (project)
+ *   ~/.gg/editor-styles/*.md      (user)
+ *
+ * Project overrides user — opposite of skills (where user overrides project).
+ * The reasoning: a project's checked-in style is the one the team agreed on;
+ * a user's home preset is a default that defers to project conventions.
+ */
+export interface StyleSource {
+    name: string;
+    content: string;
+    origin: "project" | "user";
+    path: string;
+}
+export interface DiscoverStylesOptions {
+    cwd: string;
+    homeDir?: string;
+}
+export declare function discoverStyles(opts: DiscoverStylesOptions): StyleSource[];
+/**
+ * Render the active styles as a single markdown block to be embedded in the
+ * system prompt. Returns "" when no styles are active.
+ */
+export declare function renderStylesBlock(styles: StyleSource[]): string;
+//# sourceMappingURL=styles-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"styles-loader.d.ts","sourceRoot":"","sources":["../../src/core/styles-loader.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,WAAW,EAAE,CAYzE;AA2BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAe/D"}

package/dist/core/styles-loader.js

@@ -0,0 +1,67 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join, resolve as resolvePath } from "node:path";
+export function discoverStyles(opts) {
+    const home = opts.homeDir ?? homedir();
+    const projectDir = resolvePath(opts.cwd, ".gg/editor-styles");
+    const userDir = resolvePath(home, ".gg/editor-styles");
+    const user = readStyleDir(userDir, "user");
+    const project = readStyleDir(projectDir, "project");
+    // Project last so it overrides user (reverse of skills).
+    const byName = new Map();
+    for (const s of [...user, ...project])
+        byName.set(s.name, s);
+    return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+function readStyleDir(dir, origin) {
+    if (!existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        if (!e.endsWith(".md"))
+            continue;
+        const path = join(dir, e);
+        try {
+            const st = statSync(path);
+            if (!st.isFile())
+                continue;
+            const content = readFileSync(path, "utf8").trim();
+            if (!content)
+                continue;
+            out.push({ name: basename(e, ".md"), content, origin, path });
+        }
+        catch {
+            // skip unreadable
+        }
+    }
+    return out;
+}
+/**
+ * Render the active styles as a single markdown block to be embedded in the
+ * system prompt. Returns "" when no styles are active.
+ */
+export function renderStylesBlock(styles) {
+    if (styles.length === 0)
+        return "";
+    const lines = [
+        "",
+        "# Active style presets",
+        "",
+        "These persistent user prefs apply to EVERY decision in this session. " +
+            "Honour them unless explicitly overridden by the user.",
+        "",
+    ];
+    for (const s of styles) {
+        const tag = s.origin === "project" ? "_(project)_" : "_(user)_";
+        lines.push(`## ${s.name} ${tag}`, "", s.content, "");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=styles-loader.js.map

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

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

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, ".gg/editor-styles"), { recursive: true });
+        mkdirSync(join(home, ".gg/editor-styles"), { recursive: true });
+        writeFileSync(join(cwd, ".gg/editor-styles/voice.md"), "# voice\nproject voice");
+        writeFileSync(join(home, ".gg/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, ".gg/editor-styles"), { recursive: true });
+        mkdirSync(join(home, ".gg/editor-styles"), { recursive: true });
+        writeFileSync(join(cwd, ".gg/editor-styles/x.md"), "project");
+        writeFileSync(join(home, ".gg/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, ".gg/editor-styles"), { recursive: true });
+        writeFileSync(join(home, ".gg/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"}