@prestyj/editor 0.7.1

package/dist/core/srt.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 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).
+ *
+ * ── Precision policy ─────────────────────────────────────────
+ * SRT's wire precision is exactly 1ms. We canonicalise every timestamp to a
+ * non-negative INTEGER millisecond at the boundary of this module:
+ *
+ *   secondsToMs(s) = Math.max(0, Math.round(s * 1000))
+ *
+ * All downstream math (cue ordering, gap extension, end>start validation,
+ * grouping) runs on those ms-ints. This eliminates two whole classes of
+ * float-arithmetic bugs:
+ *
+ *   1. Cues whose float `end > start` but whose ms-rounded values collide
+ *      (e.g. start=0.1001, end=0.1004 → both round to 100). The float check
+ *      would pass, then we'd emit `00:00:00,100 --> 00:00:00,100` — invalid.
+ *   2. Drift when extending a cue's end up to the next cue's start: float
+ *      assignment can carry a 1e-15 epsilon that flips a Math.round at the
+ *      ms boundary. Integer assignment is exact.
+ *
+ * Callers pass seconds (the natural unit for whisper / OpenAI output); the
+ * conversion happens exactly once per timestamp, here. If you already have
+ * ms-ints upstream, use `formatSrtTimeMs` directly to skip the round trip.
+ */
+export interface SrtCue {
+    /** Start time in seconds. Internally rounded to ms-int. */
+    start: number;
+    /** End time in seconds. Must be > start AFTER ms-rounding (see policy above). */
+    end: number;
+    /** Caption text. Multi-line OK. Trimmed. */
+    text: string;
+}
+/**
+ * A word with its own timing. Used by `buildWordLevelSrt` to emit one cue per
+ * word (TikTok / Reels burned-caption style).
+ */
+export interface WordCue {
+    start: number;
+    end: number;
+    text: string;
+}
+/**
+ * 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 (post-rounding, so 0.1001s/0.1004s
+ *     pairs that collapse to the same ms are dropped instead of producing
+ *     invalid same-stamp cues).
+ *   - 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 declare function buildWordLevelSrt(words: WordCue[], opts?: {
+    groupSize?: number;
+    gapSec?: number;
+}): string;
+/**
+ * Build an SRT string from cues. Cues are emitted in input order. Throws on
+ * cues that collapse to zero or negative duration AFTER ms-rounding —
+ * upstream code is expected to handle that ahead of time.
+ */
+export declare function buildSrt(cues: SrtCue[]): string;
+/** Format seconds → "HH:MM:SS,mmm" (SRT timestamp). Single rounding step. */
+export declare function formatSrtTime(seconds: number): string;
+/**
+ * Format ms-int → "HH:MM:SS,mmm". Use this when you already have ms-int
+ * timing (e.g. straight off whisper.cpp's `offsets.from`) to avoid an
+ * unnecessary round-trip through float seconds.
+ */
+export declare function msToSrtTime(ms: number): string;
+/**
+ * Convert float seconds → integer milliseconds with the same rounding rule
+ * used everywhere in this module. Negative inputs and NaN clamp to 0.
+ */
+export declare function secondsToMs(seconds: number): number;
+//# sourceMappingURL=srt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"srt.d.ts","sourceRoot":"","sources":["../../src/core/srt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,MAAM,WAAW,MAAM;IACrB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EAAE,EAChB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,MAAM,CAsCR;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAoB/C;AAkBD,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD"}

package/dist/core/srt.js

@@ -0,0 +1,159 @@
+/**
+ * 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).
+ *
+ * ── Precision policy ─────────────────────────────────────────
+ * SRT's wire precision is exactly 1ms. We canonicalise every timestamp to a
+ * non-negative INTEGER millisecond at the boundary of this module:
+ *
+ *   secondsToMs(s) = Math.max(0, Math.round(s * 1000))
+ *
+ * All downstream math (cue ordering, gap extension, end>start validation,
+ * grouping) runs on those ms-ints. This eliminates two whole classes of
+ * float-arithmetic bugs:
+ *
+ *   1. Cues whose float `end > start` but whose ms-rounded values collide
+ *      (e.g. start=0.1001, end=0.1004 → both round to 100). The float check
+ *      would pass, then we'd emit `00:00:00,100 --> 00:00:00,100` — invalid.
+ *   2. Drift when extending a cue's end up to the next cue's start: float
+ *      assignment can carry a 1e-15 epsilon that flips a Math.round at the
+ *      ms boundary. Integer assignment is exact.
+ *
+ * Callers pass seconds (the natural unit for whisper / OpenAI output); the
+ * conversion happens exactly once per timestamp, here. If you already have
+ * ms-ints upstream, use `formatSrtTimeMs` directly to skip the round trip.
+ */
+/**
+ * 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 (post-rounding, so 0.1001s/0.1004s
+ *     pairs that collapse to the same ms are dropped instead of producing
+ *     invalid same-stamp cues).
+ *   - 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 = [];
+    for (const w of words) {
+        const text = (w.text ?? "").trim();
+        if (!text)
+            continue;
+        const startMs = secondsToMs(w.start);
+        const endMs = secondsToMs(w.end);
+        if (endMs <= startMs)
+            continue;
+        filled.push({ startMs, endMs, text });
+    }
+    const cues = [];
+    for (let i = 0; i < filled.length; i += groupSize) {
+        const group = filled.slice(i, i + groupSize);
+        cues.push({
+            startMs: group[0].startMs,
+            endMs: group[group.length - 1].endMs,
+            text: group.map((g) => g.text).join(" "),
+        });
+    }
+    if (opts.gapSec !== undefined && opts.gapSec >= 0) {
+        const gapMs = secondsToMs(opts.gapSec);
+        for (let i = 0; i < cues.length - 1; i += 1) {
+            const gap = cues[i + 1].startMs - cues[i].endMs;
+            if (gap > 0 && gap <= gapMs) {
+                // Integer assignment — no float epsilon to lose.
+                cues[i].endMs = cues[i + 1].startMs;
+            }
+        }
+    }
+    return buildFromIntCues(cues);
+}
+/**
+ * Build an SRT string from cues. Cues are emitted in input order. Throws on
+ * cues that collapse to zero or negative duration AFTER ms-rounding —
+ * upstream code is expected to handle that ahead of time.
+ */
+export function buildSrt(cues) {
+    const intCues = cues.map((c) => ({
+        startMs: secondsToMs(c.start),
+        endMs: secondsToMs(c.end),
+        text: (c.text ?? "").trim(),
+    }));
+    // Validate each non-empty cue; matches the previous public contract of
+    // throwing when end <= start, but now in ms-int space so the error message
+    // reflects what would actually have been emitted.
+    let ordinal = 0;
+    for (const c of intCues) {
+        if (!c.text)
+            continue;
+        ordinal += 1;
+        if (c.endMs <= c.startMs) {
+            throw new Error(`cue ${ordinal}: end (${msToSrtTime(c.endMs)}) must be > start (${msToSrtTime(c.startMs)})`);
+        }
+    }
+    return buildFromIntCues(intCues);
+}
+/** Internal: skip empty-text cues, format the rest. */
+function buildFromIntCues(cues) {
+    const out = [];
+    let n = 0;
+    for (const cue of cues) {
+        if (!cue.text)
+            continue;
+        if (cue.endMs <= cue.startMs)
+            continue; // Defensive — public callers also validate.
+        n += 1;
+        out.push(String(n));
+        out.push(`${msToSrtTime(cue.startMs)} --> ${msToSrtTime(cue.endMs)}`);
+        out.push(cue.text);
+        out.push("");
+    }
+    return out.join("\n");
+}
+/** Format seconds → "HH:MM:SS,mmm" (SRT timestamp). Single rounding step. */
+export function formatSrtTime(seconds) {
+    return msToSrtTime(secondsToMs(seconds));
+}
+/**
+ * Format ms-int → "HH:MM:SS,mmm". Use this when you already have ms-int
+ * timing (e.g. straight off whisper.cpp's `offsets.from`) to avoid an
+ * unnecessary round-trip through float seconds.
+ */
+export function msToSrtTime(ms) {
+    if (!Number.isFinite(ms) || ms < 0)
+        ms = 0;
+    ms = Math.round(ms); // Defensive — callers should pass integers.
+    const milli = ms % 1000;
+    const totalSec = Math.floor(ms / 1000);
+    const ss = totalSec % 60;
+    const mm = Math.floor(totalSec / 60) % 60;
+    const hh = Math.floor(totalSec / 3600);
+    return pad2(hh) + ":" + pad2(mm) + ":" + pad2(ss) + "," + String(milli).padStart(3, "0");
+}
+/**
+ * Convert float seconds → integer milliseconds with the same rounding rule
+ * used everywhere in this module. Negative inputs and NaN clamp to 0.
+ */
+export function secondsToMs(seconds) {
+    if (!Number.isFinite(seconds) || seconds < 0)
+        return 0;
+    return Math.round(seconds * 1000);
+}
+function pad2(n) {
+    return n < 10 ? "0" + n : String(n);
+}
+//# 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,160 @@
+import { describe, expect, it } from "vitest";
+import { buildSrt, buildWordLevelSrt, formatSrtTime, msToSrtTime, secondsToMs } 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");
+    });
+    it("clamps NaN / Infinity to zero", () => {
+        expect(formatSrtTime(Number.NaN)).toBe("00:00:00,000");
+        expect(formatSrtTime(Number.POSITIVE_INFINITY)).toBe("00:00:00,000");
+    });
+    it("rounds half away from zero at the ms boundary", () => {
+        // 1.2345s → 1234.5ms → round to 1235 (Math.round rule).
+        expect(formatSrtTime(1.2345)).toBe("00:00:01,235");
+    });
+    it("survives float multiplication artifacts", () => {
+        // 0.1 + 0.2 = 0.30000000000000004 in IEEE-754; must still emit 300ms.
+        expect(formatSrtTime(0.1 + 0.2)).toBe("00:00:00,300");
+    });
+});
+describe("secondsToMs / msToSrtTime", () => {
+    it("secondsToMs rounds half-away-from-zero", () => {
+        expect(secondsToMs(0)).toBe(0);
+        expect(secondsToMs(0.0005)).toBe(1);
+        expect(secondsToMs(0.0014)).toBe(1);
+        expect(secondsToMs(35.123)).toBe(35123);
+    });
+    it("secondsToMs clamps negatives, NaN, Infinity to 0", () => {
+        expect(secondsToMs(-1)).toBe(0);
+        expect(secondsToMs(Number.NaN)).toBe(0);
+        expect(secondsToMs(Number.POSITIVE_INFINITY)).toBe(0);
+    });
+    it("msToSrtTime accepts pre-converted integer ms (no float round-trip)", () => {
+        expect(msToSrtTime(0)).toBe("00:00:00,000");
+        expect(msToSrtTime(35123)).toBe("00:00:35,123");
+        expect(msToSrtTime(3661234)).toBe("01:01:01,234");
+    });
+});
+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");
+    });
+    it("drops words whose ms-rounded duration collapses to zero", () => {
+        const out = buildWordLevelSrt([
+            { start: 0, end: 0.3, text: "keep" },
+            // start=0.3001, end=0.3004 — both round to 300ms. Drop silently rather
+            // than emit invalid `00:00:00,300 --> 00:00:00,300`.
+            { start: 0.3001, end: 0.3004, text: "drop" },
+            { start: 0.4, end: 0.6, text: "keep2" },
+        ]);
+        expect(out).toContain("keep");
+        expect(out).toContain("keep2");
+        expect(out).not.toContain("drop");
+        // Numbering must be contiguous (1, 2 — not 1, 3).
+        expect(out).toContain("1\n");
+        expect(out).toContain("2\n");
+        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("rejects cues whose float end>start collapses to the same ms-int", () => {
+        // start=0.1001, end=0.1004 — both round to 100ms. Float check would
+        // pass, but the SRT line `00:00:00,100 --> 00:00:00,100` is invalid
+        // (zero displayed duration). Must throw, matching the post-rounding
+        // wire reality.
+        expect(() => buildSrt([{ start: 0.1001, end: 0.1004, 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(), "ezeditor-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,gBAAgB,CAAC,CAAC,CAAC;IAC1D,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>/.ezcoder/editor-styles/*.md  (project)
+ *   ~/.ezcoder/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, ".ezcoder/editor-styles");
+    const userDir = resolvePath(home, ".ezcoder/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":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AA+BnE,MAAM,UAAU,cAAc,CAAC,IAA2B;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAEpD,yDAAyD;IACzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,MAA0B;IAC3D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE;gBAAE,SAAS;YAC3B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;QACpB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,KAAK,GAAa;QACtB,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,uEAAuE;YACrE,uDAAuD;QACzD,EAAE;KACH,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}