@prestyj/editor 0.7.1

package/dist/cli.js

@@ -0,0 +1,278 @@
+#!/usr/bin/env node
+// Catch stray abort-related promise rejections that escape the normal error
+// handling chain (Ctrl+C race conditions, mid-stream tool aborts). Node 25+
+// crashes the process on any unhandled rejection without this.
+process.on("unhandledRejection", (reason) => {
+    if (reason instanceof Error) {
+        const msg = reason.message.toLowerCase();
+        if (reason.name === "AbortError" || msg.includes("aborted") || msg.includes("abort")) {
+            return;
+        }
+    }
+    throw reason;
+});
+// Drain ALL performance entries to prevent unbounded memory growth.
+// Node emits entries for marks, measures, resource timing (HTTP), DNS, net,
+// etc. Without clearing, these accumulate across every LLM call and tool
+// execution — hits the 1M cap with the
+// `MaxPerformanceEntryBufferExceededWarning` after a few hours of use.
+// Mirrors the identical block in ezcoder/src/cli.ts.
+import { PerformanceObserver, performance } from "node:perf_hooks";
+{
+    const allTypes = PerformanceObserver.supportedEntryTypes.filter((t) => t !== "gc" && t !== "function");
+    new PerformanceObserver((list) => {
+        for (const entry of list.getEntries()) {
+            switch (entry.entryType) {
+                case "measure":
+                    performance.clearMeasures(entry.name);
+                    break;
+                case "mark":
+                    performance.clearMarks(entry.name);
+                    break;
+                case "resource":
+                    performance.clearResourceTimings();
+                    break;
+            }
+        }
+    }).observe({ entryTypes: allTypes });
+}
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import chalk from "chalk";
+import { getDefaultModel } from "@prestyj/cli/models";
+import { AuthStorage, NotLoggedInError, runLogin, runLogout, runStatus, } from "./core/auth/index.js";
+import { isOnboarded, onboardedMarkerPath } from "./core/doctor.js";
+import { runDoctorInteractive } from "./core/doctor-runner.js";
+import { closeLogger, defaultLogPath, initLogger, logError, logInfo } from "./core/logger.js";
+import { getPackageVersion } from "./core/version.js";
+import { discoverSkills } from "./core/skills-loader.js";
+import { discoverStyles } from "./core/styles-loader.js";
+import { SKILLS } from "./skills.js";
+import { createLazyHost } from "./core/hosts/lazy.js";
+import { hasLastSession, loadLastSession } from "./core/sessions.js";
+import { buildEditorStaticBody, buildEditorSystemPrompt } from "./system-prompt.js";
+import { createEditorTools } from "./tools/index.js";
+import { renderEditorTui } from "./ui/render.js";
+/** Auto-pick order — same priority ezcoder uses for default-provider selection. */
+const PROVIDER_ORDER = [
+    "anthropic",
+    "openai",
+    "glm",
+    "moonshot",
+    "xiaomi",
+    "minimax",
+    "deepseek",
+    "openrouter",
+];
+function parseProviderArg(arg) {
+    if (!arg)
+        return undefined;
+    return PROVIDER_ORDER.includes(arg) ? arg : undefined;
+}
+function fail(msg) {
+    process.stderr.write(chalk.red(`error: ${msg}\n`));
+    process.exit(1);
+}
+function printHelp() {
+    process.stdout.write(`ezeditor — video editor agent for DaVinci Resolve and Premiere Pro
+
+USAGE
+  ezeditor           Launch the editor (auto-detects open NLE)
+  ezeditor continue  Resume the most recent session
+  ezeditor login     Authenticate
+  ezeditor logout    Clear credentials
+  ezeditor auth      Show stored credentials
+  ezeditor doctor    Walk through environment fixes (--all to view inventory)
+  ezeditor logs      Print the path to ~/.ezcoder/ezeditor.log (use with tail -f)
+
+Auth lives in ~/.ezcoder/auth.json — the SAME file ezcoder uses, so logging into
+either CLI works for both.
+
+Debug logs are appended to ~/.ezcoder/ezeditor.log — includes Python bridge
+spawn/handshake/exit events and every Resolve method call with timing.
+Tail it live: tail -f ~/.ezcoder/ezeditor.log
+`);
+}
+/**
+ * Mark the current home as onboarded so we don't re-run the doctor on
+ * subsequent launches. Called after a first-run doctor pass succeeds.
+ */
+function markOnboarded() {
+    const path = onboardedMarkerPath();
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, new Date().toISOString() + "\n", "utf8");
+    }
+    catch {
+        // Non-fatal — we'll just re-run onboarding next time.
+    }
+}
+async function pickProvider(auth) {
+    for (const p of PROVIDER_ORDER) {
+        if (await auth.hasCredentials(p))
+            return p;
+    }
+    return undefined;
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const sub = args[0];
+    if (sub === "-h" || sub === "--help") {
+        printHelp();
+        return;
+    }
+    if (sub === "login") {
+        await runLogin();
+        return;
+    }
+    if (sub === "logout") {
+        await runLogout(parseProviderArg(args[1]));
+        return;
+    }
+    if (sub === "auth" || sub === "status") {
+        await runStatus();
+        return;
+    }
+    if (sub === "doctor") {
+        const all = args.includes("--all") || args.includes("-a");
+        const yes = args.includes("--yes") || args.includes("-y");
+        await runDoctorInteractive({ all, nonInteractive: yes });
+        return;
+    }
+    if (sub === "logs") {
+        process.stdout.write(`${defaultLogPath()}\n`);
+        return;
+    }
+    const isContinue = sub === "continue";
+    if (sub && !isContinue) {
+        fail(`unknown command: ${sub}\nrun: ezeditor --help`);
+    }
+    // ── Bare `ezeditor` (or `ezeditor continue`) — interactive TUI ────────
+    if (!process.stdin.isTTY) {
+        fail("ezeditor requires an interactive terminal");
+    }
+    // First-run onboarding — only when the marker doesn't exist. Walks
+    // the user through every actionable item, offering Y/N confirms for
+    // anything we know how to install via a package manager.
+    if (!isOnboarded()) {
+        await runDoctorInteractive({ onboarding: true });
+        markOnboarded();
+    }
+    const auth = new AuthStorage();
+    await auth.load();
+    const provider = await pickProvider(auth);
+    if (!provider) {
+        process.stderr.write(chalk.red("Not logged in.\n") +
+            chalk.dim("Run: ezeditor login\n\n") +
+            chalk.dim("(Auth is shared with ezcoder via ~/.ezcoder/auth.json — log in once, both CLIs work.)\n"));
+        process.exit(1);
+    }
+    let token;
+    try {
+        token = await auth.resolveToken(provider);
+    }
+    catch (e) {
+        if (e instanceof NotLoggedInError) {
+            process.stderr.write(chalk.red(`${e.message}\n`));
+            process.exit(1);
+        }
+        fail(`auth refresh failed: ${e.message}`);
+    }
+    const accountId = (await auth.getCredentials(provider))?.accountId;
+    // Resume support — if `continue`, load prior messages.
+    let priorMessages = [];
+    if (isContinue) {
+        if (!(await hasLastSession())) {
+            process.stderr.write(chalk.yellow("No previous session to continue.\n") +
+                chalk.dim("Run `ezeditor` to start a new one.\n"));
+            process.exit(1);
+        }
+        const last = await loadLastSession();
+        if (last)
+            priorMessages = last.messages;
+    }
+    // Pick the right model for this provider via ezcoder's registry.
+    const model = getDefaultModel(provider).id;
+    // All providers the user has logged into — used by /model selector.
+    // Same set ezcoder supports.
+    const allProviders = await auth.listProviders();
+    const loggedInProviders = allProviders.filter((p) => PROVIDER_ORDER.includes(p));
+    // Initialize debug logger before host detection so the first detection
+    // line lands in the log. ~/.ezcoder/ezeditor.log, append-mode across sessions.
+    initLogger(defaultLogPath(), {
+        version: getPackageVersion(),
+        provider,
+        model,
+    });
+    // Lazy host: re-detects on every tool call (cached for 2s) so opening
+    // Resolve / Premiere mid-session is picked up without restarting.
+    const host = createLazyHost();
+    const caps = await host.capabilities();
+    const cwd = process.cwd();
+    logInfo("startup", "caps", {
+        host: host.name,
+        available: caps.isAvailable,
+        reason: caps.unavailableReason,
+    });
+    const skills = discoverSkills({ cwd, bundled: Object.values(SKILLS) });
+    const styles = discoverStyles({ cwd });
+    // Static body is host-independent and cached for the session. The host
+    // block is spliced in at startup and re-spliced by App.tsx whenever the
+    // user opens / closes their NLE.
+    const staticPromptBody = buildEditorStaticBody(cwd, { skills, styles });
+    const system = await buildEditorSystemPrompt(host, cwd, { skills, styles });
+    const reviewConfig = provider === "anthropic" ||
+        provider === "openai" ||
+        provider === "glm" ||
+        provider === "moonshot"
+        ? { provider, model, apiKey: token, maxTurns: 10 }
+        : undefined;
+    const tools = createEditorTools({ host, cwd, reviewConfig, skills });
+    const cleanup = () => {
+        host.shutdown();
+        closeLogger();
+    };
+    process.on("SIGINT", () => {
+        cleanup();
+        process.exit(130);
+    });
+    process.on("exit", cleanup);
+    await renderEditorTui({
+        provider: provider,
+        model,
+        apiKey: token,
+        accountId,
+        // OAuth tokens expire mid-session (Anthropic ~8h, OpenAI shorter). Without
+        // this callback, useAgentLoop reuses the startup token forever — the next
+        // turn after expiry returns 401 and the CLI dies. Re-resolve before each
+        // turn (and on 401 retry with forceRefresh) using whatever provider the
+        // user has currently selected via /model.
+        resolveCredentials: async (p, opts) => {
+            const c = await auth.resolveCredentials(p, opts);
+            return { apiKey: c.accessToken, accountId: c.accountId };
+        },
+        tools,
+        systemPrompt: system,
+        staticPromptBody,
+        host,
+        priorMessages,
+        loggedInProviders,
+        hostName: host.name,
+        hostDisplayName: host.displayName,
+        hostAvailable: caps.isAvailable,
+        hostReason: caps.unavailableReason,
+        cwd,
+        version: getPackageVersion(),
+        persistSessions: true,
+        onShutdown: cleanup,
+    });
+    cleanup();
+}
+main().catch((e) => {
+    const err = e;
+    logError("fatal", err.message, { stack: err.stack });
+    closeLogger();
+    process.stderr.write(chalk.red(`\nFatal: ${err.message}\n`));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

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 ?? "EZ 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