@kenkaiiii/gg-editor 0.1.0

package/dist/core/skin-grade.test.js

@@ -0,0 +1,182 @@
+import { describe, expect, it } from "vitest";
+import { buildSkinGradeFilter, parseSkinGradeResponse } from "./skin-grade.js";
+const NEUTRAL_GRADE = {
+    colorbalance: {
+        shadows: [0, 0, 0],
+        midtones: [0, 0, 0],
+        highlights: [0, 0, 0],
+    },
+    selectivecolor: {
+        reds: [0, 0, 0, 0],
+        yellows: [0, 0, 0, 0],
+    },
+    eq: {
+        saturation: 1,
+        contrast: 1,
+        brightness: 0,
+    },
+    cdl: {
+        slope: [1, 1, 1],
+        offset: [0, 0, 0],
+        power: [1, 1, 1],
+        saturation: 1,
+    },
+    confidence: 0,
+    why: "",
+};
+describe("buildSkinGradeFilter", () => {
+    it("emits empty string for neutral grade", () => {
+        expect(buildSkinGradeFilter(NEUTRAL_GRADE)).toBe("");
+    });
+    it("emits a colorbalance segment when color balance is non-neutral", () => {
+        const grade = {
+            ...NEUTRAL_GRADE,
+            colorbalance: {
+                shadows: [0.05, 0, -0.05],
+                midtones: [0.1, 0, -0.1],
+                highlights: [0, 0, 0],
+            },
+        };
+        const f = buildSkinGradeFilter(grade);
+        expect(f).toContain("colorbalance=");
+        expect(f).toContain("rs=0.05");
+        expect(f).toContain("bm=-0.1");
+        expect(f).toContain("rh=0");
+        expect(f).not.toContain("selectivecolor=");
+        expect(f).not.toContain("eq=");
+    });
+    it("emits a selectivecolor segment with reds/yellows tuples", () => {
+        const grade = {
+            ...NEUTRAL_GRADE,
+            selectivecolor: {
+                reds: [0.1, -0.05, 0.2, 0],
+                yellows: [0, 0.1, -0.1, 0.05],
+            },
+        };
+        const f = buildSkinGradeFilter(grade);
+        expect(f).toContain("selectivecolor=reds=0.1 -0.05 0.2 0");
+        expect(f).toContain("yellows=0 0.1 -0.1 0.05");
+    });
+    it("emits an eq segment when saturation/contrast/brightness are non-neutral", () => {
+        const grade = {
+            ...NEUTRAL_GRADE,
+            eq: { saturation: 1.1, contrast: 1.05, brightness: 0.02 },
+        };
+        const f = buildSkinGradeFilter(grade);
+        expect(f).toBe("eq=saturation=1.1:contrast=1.05:brightness=0.02");
+    });
+    it("chains all three components in canonical order", () => {
+        const grade = {
+            ...NEUTRAL_GRADE,
+            colorbalance: {
+                shadows: [0, 0, 0],
+                midtones: [0.05, 0, -0.05],
+                highlights: [0, 0, 0],
+            },
+            selectivecolor: {
+                reds: [0.1, 0, 0, 0],
+                yellows: [0, 0, 0, 0],
+            },
+            eq: { saturation: 1.05, contrast: 1, brightness: 0 },
+        };
+        const f = buildSkinGradeFilter(grade);
+        const cbIdx = f.indexOf("colorbalance=");
+        const scIdx = f.indexOf("selectivecolor=");
+        const eqIdx = f.indexOf("eq=");
+        expect(cbIdx).toBeGreaterThanOrEqual(0);
+        expect(scIdx).toBeGreaterThan(cbIdx);
+        expect(eqIdx).toBeGreaterThan(scIdx);
+    });
+});
+describe("parseSkinGradeResponse", () => {
+    it("parses a fully-populated response", () => {
+        const json = JSON.stringify({
+            colorbalance: {
+                shadows: [0, 0, 0],
+                midtones: [0.05, 0, -0.05],
+                highlights: [0.02, 0, -0.02],
+            },
+            selectivecolor: {
+                reds: [0.1, 0, -0.1, 0],
+                yellows: [0, 0.05, -0.05, 0],
+            },
+            eq: { saturation: 1.1, contrast: 1.05, brightness: 0.02 },
+            cdl: {
+                slope: [1.05, 1, 0.95],
+                offset: [0.02, 0, -0.02],
+                power: [1, 1, 1],
+                saturation: 1.05,
+            },
+            confidence: 0.7,
+            why: "warmth lift",
+        });
+        const g = parseSkinGradeResponse(json);
+        expect(g.colorbalance.midtones).toEqual([0.05, 0, -0.05]);
+        expect(g.selectivecolor.reds).toEqual([0.1, 0, -0.1, 0]);
+        expect(g.eq.saturation).toBe(1.1);
+        expect(g.cdl.slope).toEqual([1.05, 1, 0.95]);
+        expect(g.confidence).toBe(0.7);
+        expect(g.why).toBe("warmth lift");
+    });
+    it("falls back to neutral on missing fields", () => {
+        const g = parseSkinGradeResponse('{"confidence":0.9}');
+        expect(g.colorbalance.shadows).toEqual([0, 0, 0]);
+        expect(g.selectivecolor.reds).toEqual([0, 0, 0, 0]);
+        expect(g.eq.saturation).toBe(1);
+        expect(g.cdl.slope).toEqual([1, 1, 1]);
+        expect(g.confidence).toBe(0.9);
+    });
+    it("clamps colorbalance / selectivecolor / eq / cdl into safe ranges", () => {
+        const json = JSON.stringify({
+            colorbalance: {
+                shadows: [9, -9, 9],
+                midtones: [9, 9, 9],
+                highlights: [9, 9, 9],
+            },
+            selectivecolor: {
+                reds: [9, -9, 9, 9],
+                yellows: [-9, 9, -9, 9],
+            },
+            eq: { saturation: 99, contrast: 99, brightness: 99 },
+            cdl: {
+                slope: [99, 0.001, 99],
+                offset: [99, -99, 99],
+                power: [99, 99, 0.001],
+                saturation: 99,
+            },
+            confidence: 99,
+        });
+        const g = parseSkinGradeResponse(json);
+        expect(g.colorbalance.shadows).toEqual([0.5, -0.5, 0.5]);
+        expect(g.selectivecolor.reds).toEqual([1, -1, 1, 1]);
+        expect(g.eq.saturation).toBe(3);
+        expect(g.eq.brightness).toBe(0.3);
+        expect(g.cdl.slope[0]).toBe(2);
+        expect(g.cdl.slope[1]).toBe(0.5);
+        expect(g.cdl.offset[0]).toBe(0.3);
+        expect(g.cdl.offset[1]).toBe(-0.3);
+        expect(g.cdl.saturation).toBe(3);
+        expect(g.confidence).toBe(1);
+    });
+    it("survives prose wrapping around the JSON", () => {
+        const g = parseSkinGradeResponse('Here is the result:\n{"eq":{"saturation":1.1}}\nThanks.');
+        expect(g.eq.saturation).toBe(1.1);
+    });
+    it("rejects non-array tuple fields gracefully", () => {
+        const g = parseSkinGradeResponse(JSON.stringify({
+            colorbalance: { shadows: "nope", midtones: [1, 2] },
+            selectivecolor: { reds: [1, 2, 3] },
+        }));
+        expect(g.colorbalance.shadows).toEqual([0, 0, 0]);
+        expect(g.colorbalance.midtones).toEqual([0, 0, 0]);
+        expect(g.selectivecolor.reds).toEqual([0, 0, 0, 0]);
+    });
+    it("throws on totally absent JSON", () => {
+        expect(() => parseSkinGradeResponse("no json at all")).toThrow(/no JSON/);
+    });
+    it("neutral parsed grade produces empty filter string", () => {
+        const g = parseSkinGradeResponse("{}");
+        expect(buildSkinGradeFilter(g)).toBe("");
+    });
+});
+//# sourceMappingURL=skin-grade.test.js.map

package/dist/core/skin-grade.test.js.map

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

package/dist/core/speaker-changes.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Heuristic speaker-change detector.
+ *
+ * v1 limitation: silence-gap based. Any inter-segment gap > `minGapSec`
+ * counts as a candidate speaker boundary. This is REASONABLE for fast-cut
+ * interviews where speakers don't overlap and there's a clear pause when one
+ * stops talking. It's WRONG for natural conversation with overlap, rapid
+ * back-and-forth, or single-speaker monologues with dramatic pauses.
+ *
+ * Honest output: returns CANDIDATES, not assignments. The agent should
+ * present these to the user, not commit to them silently.
+ *
+ * Real diarization needs a speaker-embedding model (pyannote, WeSpeaker,
+ * whisperx). When we wire that, this v1 stays as a no-dependency fallback.
+ */
+import type { Transcript } from "./whisper.js";
+export interface SpeakerChangeCandidate {
+    /** Time of the candidate boundary (seconds). */
+    atSec: number;
+    /** Gap before this point in seconds. */
+    gapSec: number;
+    /** First segment AFTER the boundary (text preview). */
+    nextSegmentText: string;
+}
+export interface SpeakerChangeOptions {
+    /** Minimum inter-segment silence to count as a boundary. Default 1.5s. */
+    minGapSec?: number;
+}
+export declare function detectSpeakerChanges(transcript: Transcript, opts?: SpeakerChangeOptions): SpeakerChangeCandidate[];
+//# sourceMappingURL=speaker-changes.d.ts.map

package/dist/core/speaker-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speaker-changes.d.ts","sourceRoot":"","sources":["../../src/core/speaker-changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,EACtB,IAAI,GAAE,oBAAyB,GAC9B,sBAAsB,EAAE,CAiB1B"}

package/dist/core/speaker-changes.js

@@ -0,0 +1,19 @@
+export function detectSpeakerChanges(transcript, opts = {}) {
+    const minGapSec = opts.minGapSec ?? 1.5;
+    const segs = [...transcript.segments].sort((a, b) => a.start - b.start);
+    const out = [];
+    for (let i = 1; i < segs.length; i += 1) {
+        const prev = segs[i - 1];
+        const cur = segs[i];
+        const gap = cur.start - prev.end;
+        if (gap > minGapSec) {
+            out.push({
+                atSec: +cur.start.toFixed(3),
+                gapSec: +gap.toFixed(3),
+                nextSegmentText: cur.text.slice(0, 80),
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=speaker-changes.js.map

package/dist/core/speaker-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speaker-changes.js","sourceRoot":"","sources":["../../src/core/speaker-changes.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,oBAAoB,CAClC,UAAsB,EACtB,OAA6B,EAAE;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;IACxC,MAAM,IAAI,GAAG,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACxE,MAAM,GAAG,GAA6B,EAAE,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;QACjC,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC;gBACP,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC5B,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;gBACvB,eAAe,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/speaker-changes.test.d.ts

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

package/dist/core/speaker-changes.test.d.ts.map

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

package/dist/core/speaker-changes.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it } from "vitest";
+import { detectSpeakerChanges } from "./speaker-changes.js";
+function tx(segs) {
+    return {
+        language: "en",
+        durationSec: segs.at(-1)?.[1] ?? 0,
+        segments: segs.map(([start, end, text]) => ({ start, end, text })),
+    };
+}
+describe("detectSpeakerChanges", () => {
+    it("returns no boundaries for tightly-packed segments", () => {
+        const r = detectSpeakerChanges(tx([
+            [0, 1, "a"],
+            [1.1, 2, "b"],
+            [2.2, 3, "c"],
+        ]));
+        expect(r).toEqual([]);
+    });
+    it("returns one boundary for a gap > minGapSec", () => {
+        const r = detectSpeakerChanges(tx([
+            [0, 1, "first speaker"],
+            [3, 4, "second speaker"],
+        ]));
+        expect(r).toHaveLength(1);
+        expect(r[0].atSec).toBe(3);
+        expect(r[0].gapSec).toBe(2);
+    });
+    it("respects custom minGapSec", () => {
+        const r = detectSpeakerChanges(tx([
+            [0, 1, "a"],
+            [1.5, 2.5, "b"],
+            [4, 5, "c"],
+        ]), { minGapSec: 1.2 });
+        expect(r).toHaveLength(1); // only the 1.5s gap survives at threshold 1.2
+        expect(r[0].atSec).toBe(4);
+    });
+    it("clips long preview text to 80 chars", () => {
+        const long = "x".repeat(200);
+        const r = detectSpeakerChanges(tx([
+            [0, 1, "a"],
+            [5, 6, long],
+        ]));
+        expect(r[0].nextSegmentText.length).toBe(80);
+    });
+});
+//# sourceMappingURL=speaker-changes.test.js.map

package/dist/core/speaker-changes.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speaker-changes.test.js","sourceRoot":"","sources":["../../src/core/speaker-changes.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,SAAS,EAAE,CAAC,IAAqC;IAC/C,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAClC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,GAAG,oBAAoB,CAC5B,EAAE,CAAC;YACD,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC;YACX,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC;YACb,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC;SACd,CAAC,CACH,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,oBAAoB,CAC5B,EAAE,CAAC;YACD,CAAC,CAAC,EAAE,CAAC,EAAE,eAAe,CAAC;YACvB,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,CAAC;SACzB,CAAC,CACH,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,oBAAoB,CAC5B,EAAE,CAAC;YACD,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC;YACX,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;YACf,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC;SACZ,CAAC,EACF,EAAE,SAAS,EAAE,GAAG,EAAE,CACnB,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,8CAA8C;QACzE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,oBAAoB,CAC5B,EAAE,CAAC;YACD,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC;YACX,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;SACb,CAAC,CACH,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/speed-ramp.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Speed-ramp builder — piecewise-constant speed segments using ffmpeg's
+ * setpts (video) and atempo / asetrate (audio).
+ *
+ * Why piecewise-constant: stock ffmpeg's setpts can take an `if(...)` chain
+ * that switches PTS multiplier based on input time T. This is enough to
+ * express the common "slow → fast → slow" cinematic ramp by stepping
+ * through 2-3 segments. Smooth ramps (continuous interpolation) require
+ * the `vfrdec` / `minterpolate` complex chain, which is out of v1 scope.
+ *
+ * Real-world reference for the setpts shape: scottcjn/bottube and several
+ * VFXer scripts on GitHub. Confirmed against ffmpeg-filters man page.
+ *
+ * Mathematical model:
+ *   Each segment runs from points[i].atSec to points[i+1].atSec at speed
+ *   ((points[i].speed + points[i+1].speed) / 2). For >2 points we use the
+ *   LEFT speed within each segment (piecewise-constant) — easier to reason
+ *   about in the wild and matches what most tutorial code does.
+ *
+ *   Video: PTS multiplier = 1 / speed   → setpts=k*PTS where k = 1/speed.
+ *   Audio: atempo accepts 0.5..2 in one stage; we chain stages for wider
+ *          ranges. asetrate is faster but pitch-shifts; we don't use it for
+ *          voice content.
+ */
+export interface SpeedPoint {
+    /** Absolute time in seconds in the input. */
+    atSec: number;
+    /**
+     * Speed multiplier from this point until the next. 1 = normal,
+     * 0.5 = half speed (slow-mo), 2 = double speed.
+     */
+    speed: number;
+}
+/**
+ * Build the setpts expression for a piecewise-constant speed ramp.
+ *
+ * For points = [{atSec:0,speed:1},{atSec:2,speed:0.5},{atSec:5,speed:1}]
+ * the output is:
+ *   setpts='if(lt(T,2),1*PTS,if(lt(T,5),2*PTS,1*PTS))'
+ *
+ * (k = 1/speed for each segment.)
+ */
+export declare function buildSetpts(points: SpeedPoint[]): string;
+/**
+ * Build the audio-side filter chain. Returns null if every segment is
+ * speed=1 (no-op). For >0.5 / <2 segments uses one atempo stage; for wider
+ * ranges chains multiple stages (atempo's per-stage range is 0.5..2).
+ *
+ * Note: atempo is single-speed at a time. For piecewise ramps the fully
+ * accurate path is to split the audio at each ramp boundary and process
+ * each segment, then concat. We DON'T do that here — for the v1 scope this
+ * function returns the AVERAGE atempo factor, with a flag the caller can
+ * use to decide if a more complex split is needed.
+ */
+export declare function buildAtempo(points: SpeedPoint[]): {
+    filter: string | null;
+    stages: number;
+    avgSpeed: number;
+};
+//# sourceMappingURL=speed-ramp.d.ts.map

package/dist/core/speed-ramp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speed-ramp.d.ts","sourceRoot":"","sources":["../../src/core/speed-ramp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAIxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG;IACjD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CA2BA"}

package/dist/core/speed-ramp.js

@@ -0,0 +1,113 @@
+/**
+ * Speed-ramp builder — piecewise-constant speed segments using ffmpeg's
+ * setpts (video) and atempo / asetrate (audio).
+ *
+ * Why piecewise-constant: stock ffmpeg's setpts can take an `if(...)` chain
+ * that switches PTS multiplier based on input time T. This is enough to
+ * express the common "slow → fast → slow" cinematic ramp by stepping
+ * through 2-3 segments. Smooth ramps (continuous interpolation) require
+ * the `vfrdec` / `minterpolate` complex chain, which is out of v1 scope.
+ *
+ * Real-world reference for the setpts shape: scottcjn/bottube and several
+ * VFXer scripts on GitHub. Confirmed against ffmpeg-filters man page.
+ *
+ * Mathematical model:
+ *   Each segment runs from points[i].atSec to points[i+1].atSec at speed
+ *   ((points[i].speed + points[i+1].speed) / 2). For >2 points we use the
+ *   LEFT speed within each segment (piecewise-constant) — easier to reason
+ *   about in the wild and matches what most tutorial code does.
+ *
+ *   Video: PTS multiplier = 1 / speed   → setpts=k*PTS where k = 1/speed.
+ *   Audio: atempo accepts 0.5..2 in one stage; we chain stages for wider
+ *          ranges. asetrate is faster but pitch-shifts; we don't use it for
+ *          voice content.
+ */
+/**
+ * Build the setpts expression for a piecewise-constant speed ramp.
+ *
+ * For points = [{atSec:0,speed:1},{atSec:2,speed:0.5},{atSec:5,speed:1}]
+ * the output is:
+ *   setpts='if(lt(T,2),1*PTS,if(lt(T,5),2*PTS,1*PTS))'
+ *
+ * (k = 1/speed for each segment.)
+ */
+export function buildSetpts(points) {
+    validatePoints(points);
+    const expr = buildIfChain(points);
+    return `setpts='${expr}'`;
+}
+/**
+ * Build the audio-side filter chain. Returns null if every segment is
+ * speed=1 (no-op). For >0.5 / <2 segments uses one atempo stage; for wider
+ * ranges chains multiple stages (atempo's per-stage range is 0.5..2).
+ *
+ * Note: atempo is single-speed at a time. For piecewise ramps the fully
+ * accurate path is to split the audio at each ramp boundary and process
+ * each segment, then concat. We DON'T do that here — for the v1 scope this
+ * function returns the AVERAGE atempo factor, with a flag the caller can
+ * use to decide if a more complex split is needed.
+ */
+export function buildAtempo(points) {
+    validatePoints(points);
+    let totalSec = 0;
+    let weightedSpeed = 0;
+    for (let i = 0; i < points.length - 1; i++) {
+        const dt = points[i + 1].atSec - points[i].atSec;
+        totalSec += dt;
+        weightedSpeed += points[i].speed * dt;
+    }
+    const avg = totalSec > 0 ? weightedSpeed / totalSec : points[points.length - 1].speed;
+    if (Math.abs(avg - 1) < 1e-6) {
+        return { filter: null, stages: 0, avgSpeed: 1 };
+    }
+    // Chain atempo stages so each is in [0.5, 2].
+    const stages = [];
+    let remaining = avg;
+    while (remaining > 2.0001) {
+        stages.push("atempo=2");
+        remaining /= 2;
+    }
+    while (remaining < 0.4999) {
+        stages.push("atempo=0.5");
+        remaining /= 0.5;
+    }
+    // Final stage with the residual factor.
+    stages.push(`atempo=${fmt(remaining)}`);
+    return { filter: stages.join(","), stages: stages.length, avgSpeed: avg };
+}
+function validatePoints(points) {
+    if (points.length < 2) {
+        throw new Error("speed ramp requires >=2 points (start + end)");
+    }
+    for (const p of points) {
+        if (!(p.speed > 0)) {
+            throw new Error(`speed must be > 0; got ${p.speed} at ${p.atSec}s`);
+        }
+    }
+    for (let i = 1; i < points.length; i++) {
+        if (points[i].atSec <= points[i - 1].atSec) {
+            throw new Error(`speed-ramp points must be strictly increasing in atSec; offending pair at index ${i - 1}`);
+        }
+    }
+}
+function buildIfChain(points) {
+    // We have N points → N-1 segments. The last point's speed is used after
+    // the final boundary (i.e. an "else" speed).
+    const segments = [];
+    for (let i = 0; i < points.length - 1; i++) {
+        segments.push({ until: points[i + 1].atSec, k: 1 / points[i].speed });
+    }
+    const trailingK = 1 / points[points.length - 1].speed;
+    // Build right-to-left so the innermost else is the trailing speed.
+    let expr = `${fmt(trailingK)}*PTS`;
+    for (let i = segments.length - 1; i >= 0; i--) {
+        expr = `if(lt(T,${fmt(segments[i].until)}),${fmt(segments[i].k)}*PTS,${expr})`;
+    }
+    return expr;
+}
+function fmt(n) {
+    if (Number.isInteger(n))
+        return String(n);
+    return n.toFixed(6).replace(/\.?0+$/, "");
+}
+//# sourceMappingURL=speed-ramp.js.map

package/dist/core/speed-ramp.js.map

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

package/dist/core/speed-ramp.test.d.ts

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

package/dist/core/speed-ramp.test.d.ts.map

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

package/dist/core/speed-ramp.test.js

@@ -0,0 +1,74 @@
+import { describe, expect, it } from "vitest";
+import { buildAtempo, buildSetpts } from "./speed-ramp.js";
+describe("buildSetpts", () => {
+    it("rejects fewer than 2 points", () => {
+        expect(() => buildSetpts([{ atSec: 0, speed: 1 }])).toThrow(/>=2/);
+    });
+    it("rejects non-increasing time", () => {
+        expect(() => buildSetpts([
+            { atSec: 0, speed: 1 },
+            { atSec: 0, speed: 2 },
+        ])).toThrow(/strictly increasing/);
+    });
+    it("two-point identity ramp emits a simple setpts=1*PTS", () => {
+        const f = buildSetpts([
+            { atSec: 0, speed: 1 },
+            { atSec: 5, speed: 1 },
+        ]);
+        expect(f).toBe("setpts='if(lt(T,5),1*PTS,1*PTS)'");
+    });
+    it("two-point slow-mo (0.5x) emits k=2*PTS", () => {
+        const f = buildSetpts([
+            { atSec: 0, speed: 0.5 },
+            { atSec: 5, speed: 1 },
+        ]);
+        expect(f).toBe("setpts='if(lt(T,5),2*PTS,1*PTS)'");
+    });
+    it("three-point ramp slow → fast → slow nests two if()s", () => {
+        const f = buildSetpts([
+            { atSec: 0, speed: 0.5 },
+            { atSec: 2, speed: 2 },
+            { atSec: 5, speed: 0.5 },
+        ]);
+        expect(f).toBe("setpts='if(lt(T,2),2*PTS,if(lt(T,5),0.5*PTS,2*PTS))'");
+    });
+    it("four-point ramp produces 3 nested ifs", () => {
+        const f = buildSetpts([
+            { atSec: 0, speed: 1 },
+            { atSec: 1, speed: 0.5 },
+            { atSec: 3, speed: 2 },
+            { atSec: 4, speed: 1 },
+        ]);
+        expect(f).toContain("if(lt(T,1),1*PTS,");
+        expect(f).toContain("if(lt(T,3),2*PTS,");
+        expect(f).toContain("if(lt(T,4),0.5*PTS,1*PTS)");
+    });
+});
+describe("buildAtempo", () => {
+    it("returns null filter for unity-speed ramp", () => {
+        const r = buildAtempo([
+            { atSec: 0, speed: 1 },
+            { atSec: 5, speed: 1 },
+        ]);
+        expect(r.filter).toBeNull();
+        expect(r.avgSpeed).toBe(1);
+    });
+    it("uses one atempo stage for moderate average speed", () => {
+        const r = buildAtempo([
+            { atSec: 0, speed: 1.5 },
+            { atSec: 5, speed: 1.5 },
+        ]);
+        expect(r.filter).toBe("atempo=1.5");
+        expect(r.stages).toBe(1);
+    });
+    it("chains atempo for very fast (>2) average speed", () => {
+        const r = buildAtempo([
+            { atSec: 0, speed: 4 },
+            { atSec: 1, speed: 4 },
+        ]);
+        // Average = 4 → atempo=2,atempo=2.
+        expect(r.filter).toBe("atempo=2,atempo=2");
+        expect(r.stages).toBe(2);
+    });
+});
+//# sourceMappingURL=speed-ramp.test.js.map

package/dist/core/speed-ramp.test.js.map

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

package/dist/core/srt.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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).
+ */
+export interface SrtCue {
+    /** Start time in seconds. */
+    start: number;
+    /** End time in seconds. Must be > start. */
+    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.
+ *   - 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. */
+export declare function buildSrt(cues: SrtCue[]): string;
+/** Format seconds → "HH:MM:SS,mmm" (SRT timestamp). */
+export declare function formatSrtTime(seconds: number): string;
+//# 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;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,MAAM;IACrB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,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;;;;;;;;;;GAUG;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,CAqBR;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAgB/C;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiBrD"}