@kenkaiiii/gg-editor 0.1.0

package/dist/core/ass.d.ts

@@ -0,0 +1,75 @@
+/**
+ * ASS (Advanced SubStation Alpha) writer.
+ *
+ * SRT only has text + timing. ASS supports:
+ *   - Font name + size
+ *   - Primary / outline / shadow color (hex BGRA)
+ *   - Position (canvas-relative — needed for vertical-format burned captions)
+ *   - Bold / italic / underline / strikeout
+ *   - Margins
+ *
+ * For TikTok / Reels / Shorts burned-in captions, this is the format you want.
+ * ffmpeg's `subtitles` filter renders ASS directly into a video stream:
+ *   ffmpeg -i in.mp4 -vf "subtitles=captions.ass" -c:a copy out.mp4
+ *
+ * Resolve also imports ASS as a subtitle track and lets the user style it
+ * further on the timeline.
+ *
+ * Time format is "H:MM:SS.cc" (centiseconds), NOT "HH:MM:SS,mmm" like SRT.
+ */
+export interface AssCue {
+    /** Start in seconds. */
+    start: number;
+    /** End in seconds. */
+    end: number;
+    /** Text. Newlines become \\N in ASS. */
+    text: string;
+    /** Optional override style name (must exist in `styles`). Default "Default". */
+    style?: string;
+}
+export interface AssStyle {
+    /** Style name; referenced by AssCue.style. "Default" is required. */
+    name: string;
+    fontName?: string;
+    fontSize?: number;
+    /** Primary color in hex RRGGBB or RRGGBBAA (alpha first byte in ASS). */
+    primaryColor?: string;
+    /** Outline color in hex RRGGBB or RRGGBBAA. */
+    outlineColor?: string;
+    /** Shadow color in hex RRGGBB or RRGGBBAA. */
+    shadowColor?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    /** 1-9 numpad layout. 2=bottom-center (default), 5=center, 8=top-center. */
+    alignment?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+    /** Outline thickness. Default 2. Critical for legibility on busy backgrounds. */
+    outline?: number;
+    /** Shadow distance. Default 0. */
+    shadow?: number;
+    /** Bottom margin in pixels (alignment 1-3) / top margin (7-9). Default 60. */
+    marginV?: number;
+    marginL?: number;
+    marginR?: number;
+}
+export interface AssOptions {
+    title?: string;
+    /** Canvas resolution. Default 1920x1080. For vertical burn use 1080x1920. */
+    playResX?: number;
+    playResY?: number;
+    styles: AssStyle[];
+    cues: AssCue[];
+}
+/**
+ * Build an ASS file. The `styles` array MUST include one named "Default".
+ * Cues without an explicit `style` field reference "Default".
+ */
+export declare function buildAss(opts: AssOptions): string;
+/** Format seconds as "H:MM:SS.cc" — ASS uses centiseconds, not ms. */
+export declare function formatAssTime(sec: number): string;
+/**
+ * Convert hex RRGGBB or RRGGBBAA into ASS &HAABBGGRR& format.
+ * ASS uses BGR byte order with the alpha BYTE FIRST (00 = opaque).
+ */
+export declare function assColor(hex: string): string;
+//# sourceMappingURL=ass.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ass.d.ts","sourceRoot":"","sources":["../../src/core/ass.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,MAAM;IACrB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9C,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA2CjD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASjD;AAiCD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAa5C"}

package/dist/core/ass.js

@@ -0,0 +1,128 @@
+/**
+ * ASS (Advanced SubStation Alpha) writer.
+ *
+ * SRT only has text + timing. ASS supports:
+ *   - Font name + size
+ *   - Primary / outline / shadow color (hex BGRA)
+ *   - Position (canvas-relative — needed for vertical-format burned captions)
+ *   - Bold / italic / underline / strikeout
+ *   - Margins
+ *
+ * For TikTok / Reels / Shorts burned-in captions, this is the format you want.
+ * ffmpeg's `subtitles` filter renders ASS directly into a video stream:
+ *   ffmpeg -i in.mp4 -vf "subtitles=captions.ass" -c:a copy out.mp4
+ *
+ * Resolve also imports ASS as a subtitle track and lets the user style it
+ * further on the timeline.
+ *
+ * Time format is "H:MM:SS.cc" (centiseconds), NOT "HH:MM:SS,mmm" like SRT.
+ */
+/**
+ * Build an ASS file. The `styles` array MUST include one named "Default".
+ * Cues without an explicit `style` field reference "Default".
+ */
+export function buildAss(opts) {
+    const playX = opts.playResX ?? 1920;
+    const playY = opts.playResY ?? 1080;
+    const styles = opts.styles;
+    if (!styles.find((s) => s.name === "Default")) {
+        throw new Error("buildAss: styles must include one named 'Default'");
+    }
+    const styleNames = new Set(styles.map((s) => s.name));
+    const lines = [];
+    lines.push("[Script Info]");
+    lines.push(`Title: ${(opts.title ?? "GG Editor").replace(/[\r\n]+/g, " ")}`);
+    lines.push("ScriptType: v4.00+");
+    lines.push("WrapStyle: 0");
+    lines.push("ScaledBorderAndShadow: yes");
+    lines.push(`PlayResX: ${playX}`);
+    lines.push(`PlayResY: ${playY}`);
+    lines.push("");
+    lines.push("[V4+ Styles]");
+    lines.push("Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding");
+    for (const s of styles)
+        lines.push(formatStyle(s));
+    lines.push("");
+    lines.push("[Events]");
+    lines.push("Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text");
+    for (const cue of opts.cues) {
+        if (cue.end <= cue.start) {
+            throw new Error(`ASS cue: end (${cue.end}) must be > start (${cue.start})`);
+        }
+        const text = (cue.text ?? "").trim();
+        if (!text)
+            continue;
+        const style = cue.style ?? "Default";
+        if (!styleNames.has(style)) {
+            throw new Error(`ASS cue references unknown style: ${style}`);
+        }
+        lines.push(`Dialogue: 0,${formatAssTime(cue.start)},${formatAssTime(cue.end)},${style},,0,0,0,,${escapeText(text)}`);
+    }
+    return lines.join("\n") + "\n";
+}
+/** Format seconds as "H:MM:SS.cc" — ASS uses centiseconds, not ms. */
+export function formatAssTime(sec) {
+    if (!Number.isFinite(sec) || sec < 0)
+        sec = 0;
+    const totalCs = Math.round(sec * 100);
+    const cs = totalCs % 100;
+    const totalSec = Math.floor(totalCs / 100);
+    const ss = totalSec % 60;
+    const mm = Math.floor(totalSec / 60) % 60;
+    const hh = Math.floor(totalSec / 3600);
+    return `${hh}:${String(mm).padStart(2, "0")}:${String(ss).padStart(2, "0")}.${String(cs).padStart(2, "0")}`;
+}
+function formatStyle(s) {
+    return [
+        "Style:",
+        [
+            s.name,
+            s.fontName ?? "Arial",
+            s.fontSize ?? 72,
+            assColor(s.primaryColor ?? "FFFFFF"),
+            assColor("FFFFFF"), // secondary
+            assColor(s.outlineColor ?? "000000"),
+            assColor(s.shadowColor ?? "000000"),
+            s.bold ? -1 : 0,
+            s.italic ? -1 : 0,
+            s.underline ? -1 : 0,
+            0, // strikeout
+            100, // scaleX
+            100, // scaleY
+            0, // spacing
+            0, // angle
+            1, // borderStyle 1=outline+shadow
+            s.outline ?? 2,
+            s.shadow ?? 0,
+            s.alignment ?? 2,
+            s.marginL ?? 20,
+            s.marginR ?? 20,
+            s.marginV ?? 60,
+            1, // encoding
+        ].join(","),
+    ].join(" ");
+}
+/**
+ * Convert hex RRGGBB or RRGGBBAA into ASS &HAABBGGRR& format.
+ * ASS uses BGR byte order with the alpha BYTE FIRST (00 = opaque).
+ */
+export function assColor(hex) {
+    const clean = hex.replace(/^#/, "").trim();
+    if (!/^[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$/.test(clean)) {
+        throw new Error(`bad color: ${hex} (expected RRGGBB or RRGGBBAA)`);
+    }
+    const r = clean.slice(0, 2);
+    const g = clean.slice(2, 4);
+    const b = clean.slice(4, 6);
+    // ASS alpha: 00 = opaque, FF = transparent. Convention is OPPOSITE of CSS.
+    // We accept CSS-style alpha (FF=opaque) and invert for the user.
+    const cssAlpha = clean.slice(6, 8);
+    const a = cssAlpha ? (255 - parseInt(cssAlpha, 16)).toString(16).padStart(2, "0") : "00";
+    return `&H${a}${b}${g}${r}&`.toUpperCase();
+}
+function escapeText(s) {
+    // Real newlines → ASS hard linebreak; commas inside text are fine on the
+    // last column. Strip CR.
+    return s.replace(/\r\n?|\n/g, "\\N");
+}
+//# sourceMappingURL=ass.js.map

package/dist/core/ass.js.map

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

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

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

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

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

package/dist/core/ass.test.js

@@ -0,0 +1,112 @@
+import { describe, expect, it } from "vitest";
+import { assColor, buildAss, formatAssTime } from "./ass.js";
+describe("formatAssTime", () => {
+    it("formats zero", () => {
+        expect(formatAssTime(0)).toBe("0:00:00.00");
+    });
+    it("uses centiseconds, not milliseconds", () => {
+        expect(formatAssTime(1.234)).toBe("0:00:01.23");
+    });
+    it("formats hours+minutes+seconds+cs", () => {
+        expect(formatAssTime(3661.99)).toBe("1:01:01.99");
+    });
+    it("clamps negatives to zero", () => {
+        expect(formatAssTime(-5)).toBe("0:00:00.00");
+    });
+});
+describe("assColor", () => {
+    it("converts RRGGBB to &HAABBGGRR& with opaque alpha", () => {
+        expect(assColor("FF0000")).toBe("&H000000FF&"); // pure red
+        expect(assColor("00FF00")).toBe("&H0000FF00&"); // pure green
+        expect(assColor("0000FF")).toBe("&H00FF0000&"); // pure blue
+        expect(assColor("FFFFFF")).toBe("&H00FFFFFF&"); // white
+    });
+    it("inverts CSS alpha to ASS alpha", () => {
+        // CSS FF (fully opaque) → ASS 00 (fully opaque)
+        expect(assColor("FFFFFFFF")).toBe("&H00FFFFFF&");
+        // CSS 00 (fully transparent) → ASS FF (fully transparent)
+        expect(assColor("FFFFFF00")).toBe("&HFFFFFFFF&");
+    });
+    it("accepts a leading #", () => {
+        expect(assColor("#FF0000")).toBe("&H000000FF&");
+    });
+    it("rejects bad input", () => {
+        expect(() => assColor("nope")).toThrow();
+        expect(() => assColor("FFFFF")).toThrow();
+    });
+});
+describe("buildAss", () => {
+    const minStyles = [{ name: "Default" }];
+    it("requires a Default style", () => {
+        expect(() => buildAss({ styles: [{ name: "Other" }], cues: [] })).toThrow(/Default/);
+    });
+    it("emits Script Info, V4+ Styles, and Events sections", () => {
+        const out = buildAss({
+            styles: minStyles,
+            cues: [{ start: 1, end: 2, text: "hi" }],
+        });
+        expect(out).toContain("[Script Info]");
+        expect(out).toContain("[V4+ Styles]");
+        expect(out).toContain("[Events]");
+    });
+    it("escapes newlines as \\N", () => {
+        const out = buildAss({
+            styles: minStyles,
+            cues: [{ start: 0, end: 1, text: "line1\nline2" }],
+        });
+        expect(out).toContain("line1\\Nline2");
+    });
+    it("rejects cues whose end <= start", () => {
+        expect(() => buildAss({ styles: minStyles, cues: [{ start: 5, end: 5, text: "x" }] })).toThrow(/must be > start/);
+    });
+    it("rejects cues that reference an undefined style", () => {
+        expect(() => buildAss({
+            styles: minStyles,
+            cues: [{ start: 0, end: 1, text: "x", style: "ghost" }],
+        })).toThrow(/unknown style: ghost/);
+    });
+    it("uses 1080x1920 vertical canvas when supplied", () => {
+        const out = buildAss({
+            playResX: 1080,
+            playResY: 1920,
+            styles: minStyles,
+            cues: [{ start: 0, end: 1, text: "hi" }],
+        });
+        expect(out).toContain("PlayResX: 1080");
+        expect(out).toContain("PlayResY: 1920");
+    });
+    it("emits one Dialogue line per cue with H:MM:SS.cc times", () => {
+        const out = buildAss({
+            styles: minStyles,
+            cues: [
+                { start: 1, end: 2.5, text: "first" },
+                { start: 3, end: 4, text: "second" },
+            ],
+        });
+        expect(out).toContain("Dialogue: 0,0:00:01.00,0:00:02.50,Default,,0,0,0,,first");
+        expect(out).toContain("Dialogue: 0,0:00:03.00,0:00:04.00,Default,,0,0,0,,second");
+    });
+    it("respects per-style font + alignment + margin overrides", () => {
+        const out = buildAss({
+            styles: [
+                {
+                    name: "Default",
+                    fontName: "Impact",
+                    fontSize: 96,
+                    alignment: 5,
+                    marginV: 200,
+                    outline: 4,
+                    bold: true,
+                },
+            ],
+            cues: [{ start: 0, end: 1, text: "hi" }],
+        });
+        expect(out).toContain("Impact");
+        expect(out).toContain(",96,");
+        // alignment 5 (center), marginV 200, outline 4, bold -1
+        expect(out).toMatch(/,4,0,5,/);
+        expect(out).toMatch(/,200,/);
+        expect(out).toMatch(/,-1,0,0,0,/); // bold,italic,underline,strikeout
+    });
+});
+//# sourceMappingURL=ass.test.js.map

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

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

package/dist/core/audio-cleanup.d.ts

@@ -0,0 +1,16 @@
+export type CleanupMode = "denoise" | "denoise-strong" | "rnnoise" | "dehum" | "deess";
+export interface CleanupOptions {
+    /** Mains frequency for `dehum`. Default 50 (most of the world); use 60 for North America. */
+    mainsHz?: 50 | 60;
+    /** Path to an `arnndn` model (.rnnn). Required for `rnnoise` mode. */
+    rnnoiseModel?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Build the ffmpeg `-af` filter string for a cleanup mode. Pure function so
+ * tests can verify the chain without spawning ffmpeg.
+ */
+export declare function buildCleanupFilter(mode: CleanupMode, opts?: CleanupOptions): string;
+/** Run a single cleanup pass on an audio/video file. Video stream is copied. */
+export declare function applyCleanup(inputPath: string, outputPath: string, mode: CleanupMode, opts?: CleanupOptions): Promise<void>;
+//# sourceMappingURL=audio-cleanup.d.ts.map

package/dist/core/audio-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-cleanup.d.ts","sourceRoot":"","sources":["../../src/core/audio-cleanup.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvF,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;IAClB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,cAAmB,GAAG,MAAM,CAmCvF;AAED,gFAAgF;AAChF,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/core/audio-cleanup.js

@@ -0,0 +1,79 @@
+/**
+ * Audio cleanup helpers — voice-noise reduction, de-essing, hum removal.
+ *
+ * All routes through ffmpeg filters. We expose a small set of "modes" so the
+ * agent doesn't have to learn ffmpeg syntax:
+ *   - denoise / denoise-strong: spectral noise gate (afftdn)
+ *   - rnnoise: RNN-based noise removal (arnndn). Needs a model file; if none
+ *     supplied we fall back to afftdn with a stronger setting.
+ *   - dehum: notch out 50/60Hz mains hum
+ *   - deess: tame harsh sibilance
+ */
+import { runFfmpeg } from "./media/ffmpeg.js";
+/**
+ * Build the ffmpeg `-af` filter string for a cleanup mode. Pure function so
+ * tests can verify the chain without spawning ffmpeg.
+ */
+export function buildCleanupFilter(mode, opts = {}) {
+    switch (mode) {
+        case "denoise":
+            // Mild spectral gate. Good default for podcast room tone.
+            return "afftdn=nr=12:nf=-25";
+        case "denoise-strong":
+            // Aggressive — will start to chew transients on bad source. Only use when
+            // the noise floor is genuinely loud.
+            return "afftdn=nr=24:nf=-20";
+        case "rnnoise":
+            if (!opts.rnnoiseModel) {
+                // Fallback: stronger afftdn so the tool still produces output even
+                // without a model file.
+                return "afftdn=nr=20:nf=-22";
+            }
+            return `arnndn=m=${escapeFfPath(opts.rnnoiseModel)}`;
+        case "dehum": {
+            const f = opts.mainsHz === 60 ? 60 : 50;
+            // Notch the fundamental + first three harmonics. Anchored Q for surgical
+            // cuts that don't muddy the rest of the band.
+            return [
+                `anequalizer=f=${f}:width_type=h:width=10:g=-30`,
+                `anequalizer=f=${f * 2}:width_type=h:width=10:g=-25`,
+                `anequalizer=f=${f * 3}:width_type=h:width=10:g=-20`,
+                `anequalizer=f=${f * 4}:width_type=h:width=10:g=-15`,
+            ].join(",");
+        }
+        case "deess":
+            // Sibilance lives 5-9kHz. Light shelf cut + dynamic compression on that band.
+            return "deesser=i=0.6:m=0.5:f=0.5:s=o";
+        default: {
+            const _exhaustive = mode;
+            throw new Error(`unknown cleanup mode: ${String(_exhaustive)}`);
+        }
+    }
+}
+/** Run a single cleanup pass on an audio/video file. Video stream is copied. */
+export async function applyCleanup(inputPath, outputPath, mode, opts = {}) {
+    const filter = buildCleanupFilter(mode, opts);
+    const isWav = /\.wav$/i.test(outputPath);
+    const args = [
+        "-i",
+        inputPath,
+        "-af",
+        filter,
+        "-c:v",
+        "copy",
+        ...(isWav ? ["-c:a", "pcm_s16le"] : ["-c:a", "aac", "-b:a", "192k"]),
+        outputPath,
+    ];
+    const r = await runFfmpeg(args, { signal: opts.signal });
+    if (r.code !== 0) {
+        throw new Error(`ffmpeg ${mode} exited ${r.code}: ${tail(r.stderr)}`);
+    }
+}
+function escapeFfPath(p) {
+    // ffmpeg filter args use ':' and '\' as separators; escape them.
+    return p.replace(/\\/g, "\\\\").replace(/:/g, "\\:");
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+//# sourceMappingURL=audio-cleanup.js.map

package/dist/core/audio-cleanup.js.map

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

package/dist/core/audio-cleanup.test.d.ts

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

package/dist/core/audio-cleanup.test.d.ts.map

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

package/dist/core/audio-cleanup.test.js

@@ -0,0 +1,41 @@
+import { describe, expect, it } from "vitest";
+import { buildCleanupFilter } from "./audio-cleanup.js";
+describe("buildCleanupFilter", () => {
+    it("builds afftdn for denoise modes", () => {
+        expect(buildCleanupFilter("denoise")).toMatch(/^afftdn=/);
+        expect(buildCleanupFilter("denoise-strong")).toMatch(/^afftdn=/);
+    });
+    it("falls back to afftdn when rnnoise mode is requested without a model", () => {
+        const f = buildCleanupFilter("rnnoise");
+        expect(f).toMatch(/^afftdn=/);
+    });
+    it("uses arnndn when a model is supplied", () => {
+        const f = buildCleanupFilter("rnnoise", { rnnoiseModel: "/path/to/model.rnnn" });
+        expect(f).toMatch(/^arnndn=m=/);
+        expect(f).toContain("/path/to/model.rnnn");
+    });
+    it("escapes colons in rnnoise model path", () => {
+        const f = buildCleanupFilter("rnnoise", {
+            rnnoiseModel: "C:/models/voice.rnnn",
+        });
+        expect(f).toContain("C\\:/models/voice.rnnn");
+    });
+    it("dehum at 50Hz hits 50/100/150/200", () => {
+        const f = buildCleanupFilter("dehum");
+        expect(f).toContain("f=50");
+        expect(f).toContain("f=100");
+        expect(f).toContain("f=150");
+        expect(f).toContain("f=200");
+    });
+    it("dehum at 60Hz hits 60/120/180/240", () => {
+        const f = buildCleanupFilter("dehum", { mainsHz: 60 });
+        expect(f).toContain("f=60");
+        expect(f).toContain("f=120");
+        expect(f).toContain("f=180");
+        expect(f).toContain("f=240");
+    });
+    it("deess uses the deesser filter", () => {
+        expect(buildCleanupFilter("deess")).toMatch(/^deesser=/);
+    });
+});
+//# sourceMappingURL=audio-cleanup.test.js.map

package/dist/core/audio-cleanup.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-cleanup.test.js","sourceRoot":"","sources":["../../src/core/audio-cleanup.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,CAAC,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,kBAAkB,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,kBAAkB,CAAC,SAAS,EAAE;YACtC,YAAY,EAAE,sBAAsB;SACrC,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/audio-mix.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Audio mixing chain — EQ, compressor, gate, reverb, de-esser, limiter.
+ *
+ * File-only path: pure ffmpeg filter strings, mirroring `audio-cleanup.ts`
+ * but with parameter knobs the agent can tune per-clip. We expose this as
+ * a single "chain" so the agent can express a full mixing decision in one
+ * call (e.g. "vocal preset = highpass 80Hz + 3dB peak at 5kHz + 4:1 comp +
+ * -1dB ceiling limiter").
+ *
+ * All filters confirmed present in stock Homebrew ffmpeg:
+ *   - equalizer / highpass / lowpass — eq bands
+ *   - acompressor — compressor
+ *   - agate — gate
+ *   - aecho / aphaser — pseudo-reverb
+ *   - alimiter — brick-wall limiter
+ *   - adynamicequalizer — de-esser (5-9 kHz dynamic shelf)
+ *
+ * Real-world reference for filter syntax: ffmpeg-filters man page +
+ * jiaaro/pydub's effect chains + scottcjn/bottube's mixing helpers.
+ */
+export interface EqBand {
+    /** Filter type. */
+    type: "low" | "high" | "peak" | "shelf-low" | "shelf-high";
+    /** Center / cutoff frequency in Hz. */
+    freqHz: number;
+    /** Gain in dB (peak / shelf only; ignored for low/high pass). */
+    gainDb?: number;
+    /** Bandwidth Q-factor. Default 1. Higher = narrower band. */
+    q?: number;
+}
+export interface Compressor {
+    /** Threshold in dB below which the comp doesn't act. -18 to -10 typical for voice. */
+    thresholdDb: number;
+    /** Ratio. 4 = 4:1 = strong voice control. */
+    ratio: number;
+    /** Attack in ms. Default 20. */
+    attackMs?: number;
+    /** Release in ms. Default 250. */
+    releaseMs?: number;
+    /** Makeup gain in dB. Default 0. */
+    makeupDb?: number;
+}
+export interface Gate {
+    /** Below threshold the signal is attenuated. -50 dB cuts most room tone. */
+    thresholdDb: number;
+    /** Ratio. Higher = more aggressive cut. Default 5. */
+    ratio?: number;
+    attackMs?: number;
+    releaseMs?: number;
+}
+export interface Reverb {
+    /** 0..1; how big the room sounds. */
+    roomSize: number;
+    /** 0..1; balance. 0 = dry, 1 = all wet. */
+    wetDryMix: number;
+}
+export interface Limiter {
+    /** Output ceiling in dB. -1 dBTP is the YouTube/Spotify-friendly default. */
+    ceilingDb: number;
+    releaseMs?: number;
+}
+export interface DeEsser {
+    /** Frequency in Hz where sibilance lives. Default 6500. */
+    freqHz?: number;
+    /** Threshold in dB above which the dynamic shelf engages. Default -25. */
+    thresholdDb?: number;
+}
+export interface AudioChain {
+    eq?: EqBand[];
+    compressor?: Compressor;
+    gate?: Gate;
+    reverb?: Reverb;
+    deess?: DeEsser;
+    limiter?: Limiter;
+}
+/**
+ * Build the ffmpeg `-af` filter string for a chain. Pure function — tests
+ * verify the full string assembly without spawning ffmpeg.
+ *
+ * Order: gate → eq → de-esser → compressor → reverb → limiter. This matches
+ * the conventional mixing console order: clean noise out first, shape tone,
+ * tame dynamics, add ambience, then catch peaks.
+ */
+export declare function buildMixFilter(chain: AudioChain): string;
+/** Apply a mixing chain to one input file. Video stream is copied. */
+export declare function applyMix(inputPath: string, outputPath: string, chain: AudioChain, opts?: {
+    signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=audio-mix.d.ts.map

package/dist/core/audio-mix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mix.d.ts","sourceRoot":"","sources":["../../src/core/audio-mix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,WAAW,MAAM;IACrB,mBAAmB;IACnB,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;IAC3D,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CA+ExD;AA+CD,sEAAsE;AACtE,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAiBf"}