@jtdigital/renderbox-sdk 0.4.0 → 0.5.0

package/dist/pipelines.js

@@ -0,0 +1,16 @@
+// GENERATED FILE — DO NOT EDIT.
+// Regenerate from renderbox-pipelines: `cargo run --bin gen-ts-pipelines`.
+//
+// Typed args for renderbox's named pipelines. Each interface is rendered from
+// the exact serde struct the pipeline's Rust builder parses, so a compile-clean
+// submission is also a parse-clean one. Submit as `{ pipeline_id, args }` on a
+// JobMessage (named-pipeline path — no graph_ir).
+/** Edge-only pipelines (mqtt I/O) — the worker security gate rejects them
+ * on the remote fleet; submit only to local/edge runners. */
+export const LOCAL_ONLY_PIPELINES = ['detect-mqtt', 'helmet-detect-mqtt', 'mqtt-to-jsonl'];
+/** The `{ pipeline_id, args }` slice of a named-pipeline JobMessage, with
+ * `args` typechecked against the pipeline's schema. */
+export function pipelineArgs(pipelineId, args) {
+    return { pipeline_id: pipelineId, args };
+}
+//# sourceMappingURL=pipelines.js.map

package/dist/pipelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelines.js","sourceRoot":"","sources":["../src/pipelines.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,2EAA2E;AAC3E,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,+EAA+E;AAC/E,kDAAkD;AAyiBlD;6DAC6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAA0B,CAAC,aAAa,EAAE,oBAAoB,EAAE,eAAe,CAAC,CAAC;AAElH;uDACuD;AACvD,MAAM,UAAU,YAAY,CAC1B,UAAa,EACb,IAAwB;IAExB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAC3C,CAAC"}

package/dist/presets/audio.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Audio presets — dynamics, effects, mastering, mixing, routing, and synthesis
+ * chains. The TS port of the Rust SDK's `presets::audio`.
+ */
+import type { Graph } from '../graph.js';
+import type { AudioStream, AmixOpts, SidechaincompressOpts } from '../streams.js';
+/** Mastering profile for {@link masterAudio}. */
+export type MasterProfile = 'podcast' | 'music' | 'broadcast' | 'youtube';
+/** Channel-mapping preset for {@link channelMapPreset}. */
+export type ChannelPreset = 'mono' | 'stereo' | 'swapLr' | 'leftOnly' | 'rightOnly';
+/** Notification tone profile for {@link notification}. */
+export type NotificationProfile = 'beep' | 'chime' | 'ding';
+/** Ambient background profile for {@link ambience}. */
+export type AmbienceProfile = 'rain' | 'cafe' | 'wind' | 'ocean';
+/** Noise gate with podcast-friendly defaults. */
+export declare function noiseGate(input: AudioStream): AudioStream;
+/** Limiter with mastering defaults. */
+export declare function limiter(input: AudioStream): AudioStream;
+/** Bandpass to simulate a radio voice (300 Hz – 5000 Hz + compression). */
+export declare function radioVoice(input: AudioStream): AudioStream;
+/** Bandpass to simulate a telephone voice (300 Hz – 3400 Hz). */
+export declare function telephone(input: AudioStream): AudioStream;
+/**
+ * Mastering chain matched to a {@link MasterProfile}:
+ * - `podcast` — speechnorm + deesser + compressor + loudnorm -16 LUFS
+ * - `music` — bass EQ + treble EQ + compand + limiter + loudnorm -14 LUFS
+ * - `broadcast` — gate + dynaudnorm + compressor + loudnorm -24 LUFS
+ * - `youtube` — speechnorm + gate + loudnorm -14 LUFS
+ */
+export declare function masterAudio(input: AudioStream, profile: MasterProfile): AudioStream;
+/** Sidechain ducking with sensible defaults for voice-over-music. */
+export declare function ducking(target: AudioStream, sidechain: AudioStream, opts?: SidechaincompressOpts): AudioStream;
+/** Mix streams into one via `amix`. Requires at least 2 streams. */
+export declare function audioMix(streams: AudioStream[], opts?: AmixOpts): AudioStream;
+/** Named channel-mapping presets via {@link ChannelPreset}. */
+export declare function channelMapPreset(input: AudioStream, preset: ChannelPreset): AudioStream;
+/** Short notification tone from a {@link NotificationProfile}. */
+export declare function notification(g: Graph, profile: NotificationProfile): AudioStream;
+/** Ambient background sound (approximated with noise + filtering + echo). */
+export declare function ambience(g: Graph, profile: AmbienceProfile, duration: number): AudioStream;
+/** Sustained drone: multiple sine harmonics mixed together. */
+export declare function drone(g: Graph, freq: number, harmonics: number, duration: number): AudioStream;
+//# sourceMappingURL=audio.d.ts.map

package/dist/presets/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/presets/audio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAElF,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAE1E,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpF,0DAA0D;AAC1D,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAMjE,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAEzD;AAED,uCAAuC;AACvC,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAEvD;AAMD,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAK1D;AAED,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAEzD;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,WAAW,CA2BnF;AAMD,qEAAqE;AACrE,wBAAgB,OAAO,CACrB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,WAAW,EACtB,IAAI,CAAC,EAAE,qBAAqB,GAC3B,WAAW,CAQb;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAK7E;AAMD,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,CASvF;AAMD,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,GAAG,WAAW,CAWhF;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAqB1F;AAED,+DAA+D;AAC/D,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAW9F"}

package/dist/presets/audio.js

@@ -0,0 +1,148 @@
+// ---------------------------------------------------------------------------
+// Dynamics
+// ---------------------------------------------------------------------------
+/** Noise gate with podcast-friendly defaults. */
+export function noiseGate(input) {
+    return input.agate({ threshold: 0.01, ratio: 2, attack: 20, release: 250 });
+}
+/** Limiter with mastering defaults. */
+export function limiter(input) {
+    return input.alimiter({ limit: 0.95, attack: 5, release: 50 });
+}
+// ---------------------------------------------------------------------------
+// Effects
+// ---------------------------------------------------------------------------
+/** Bandpass to simulate a radio voice (300 Hz – 5000 Hz + compression). */
+export function radioVoice(input) {
+    return input
+        .highpass({ f: 300 })
+        .lowpass({ f: 5000 })
+        .acompressor({ threshold: 0.1, ratio: 4 });
+}
+/** Bandpass to simulate a telephone voice (300 Hz – 3400 Hz). */
+export function telephone(input) {
+    return input.highpass({ f: 300 }).lowpass({ f: 3400 });
+}
+// ---------------------------------------------------------------------------
+// Mastering
+// ---------------------------------------------------------------------------
+/**
+ * Mastering chain matched to a {@link MasterProfile}:
+ * - `podcast` — speechnorm + deesser + compressor + loudnorm -16 LUFS
+ * - `music` — bass EQ + treble EQ + compand + limiter + loudnorm -14 LUFS
+ * - `broadcast` — gate + dynaudnorm + compressor + loudnorm -24 LUFS
+ * - `youtube` — speechnorm + gate + loudnorm -14 LUFS
+ */
+export function masterAudio(input, profile) {
+    switch (profile) {
+        case 'podcast':
+            return input
+                .speechnorm({ peak: 0.95 })
+                .deesser({ i: 0.4 })
+                .acompressor({ threshold: 0.1, ratio: 3 })
+                .loudnorm({ I: -16, TP: -1.5, LRA: 11 });
+        case 'music':
+            return input
+                .bass({ gain: 2, frequency: 100 })
+                .treble({ gain: 1.5, frequency: 8000 })
+                .compand({ attacks: '0.3', decays: '0.8', points: '-70/-90|-24/-12|0/-6' })
+                .alimiter({ limit: 0.95 })
+                .loudnorm({ I: -14, TP: -1 });
+        case 'broadcast':
+            return input
+                .agate({ threshold: 0.01 })
+                .dynaudnorm({ peak: 0.95 })
+                .acompressor({ threshold: 0.125, ratio: 4 })
+                .loudnorm({ I: -24, TP: -2, LRA: 7 });
+        case 'youtube':
+            return input
+                .speechnorm({ peak: 0.95 })
+                .agate({ threshold: 0.01 })
+                .loudnorm({ I: -14, TP: -1 });
+    }
+}
+// ---------------------------------------------------------------------------
+// Mixing
+// ---------------------------------------------------------------------------
+/** Sidechain ducking with sensible defaults for voice-over-music. */
+export function ducking(target, sidechain, opts) {
+    return target.sidechaincompress(sidechain, {
+        ...opts,
+        threshold: opts?.threshold ?? 0.05,
+        ratio: opts?.ratio ?? 6,
+        attack: opts?.attack ?? 10,
+        release: opts?.release ?? 200,
+    });
+}
+/** Mix streams into one via `amix`. Requires at least 2 streams. */
+export function audioMix(streams, opts) {
+    if (streams.length < 2) {
+        throw new Error(`audioMix: requires at least 2 streams, got ${streams.length}`);
+    }
+    return streams[0].amix(streams.slice(1), opts);
+}
+// ---------------------------------------------------------------------------
+// Routing
+// ---------------------------------------------------------------------------
+/** Named channel-mapping presets via {@link ChannelPreset}. */
+export function channelMapPreset(input, preset) {
+    const map = {
+        mono: 'FC',
+        stereo: 'FL|FR',
+        swapLr: 'FR|FL',
+        leftOnly: 'FL|FL',
+        rightOnly: 'FR|FR',
+    }[preset];
+    return input.channelmap({ map });
+}
+// ---------------------------------------------------------------------------
+// Synthesis
+// ---------------------------------------------------------------------------
+/** Short notification tone from a {@link NotificationProfile}. */
+export function notification(g, profile) {
+    const [frequency, duration] = {
+        beep: [880, 0.2],
+        chime: [1046.5, 0.5],
+        ding: [523.25, 0.3],
+    }[profile];
+    const fadeDur = Math.max(duration * 0.25, 0.01);
+    return g.sine({ frequency, duration })
+        .volume({ volume: 0.7 })
+        .afade({ type: 'in', duration: 0.01 })
+        .afade({ type: 'out', start_time: duration - fadeDur, duration: fadeDur });
+}
+/** Ambient background sound (approximated with noise + filtering + echo). */
+export function ambience(g, profile, duration) {
+    const src = g.anoisesrc({ d: duration });
+    switch (profile) {
+        case 'rain':
+            return src
+                .bandpass({ f: 4000, width: 2000 })
+                .volume({ volume: 0.3 })
+                .aecho({ delays: '100', decays: '0.3' });
+        case 'cafe':
+            return src
+                .bandpass({ f: 1500, width: 1000 })
+                .volume({ volume: 0.2 })
+                .aecho({ delays: '200|400', decays: '0.4|0.2' });
+        case 'wind':
+            return src.lowpass({ f: 800 }).volume({ volume: 0.4 });
+        case 'ocean':
+            return src
+                .bandpass({ f: 500, width: 300 })
+                .volume({ volume: 0.5 })
+                .aecho({ delays: '500|1000', decays: '0.5|0.3' });
+    }
+}
+/** Sustained drone: multiple sine harmonics mixed together. */
+export function drone(g, freq, harmonics, duration) {
+    if (harmonics < 1) {
+        throw new Error(`drone: harmonics must be at least 1, got ${harmonics}`);
+    }
+    const streams = [];
+    for (let h = 1; h <= harmonics; h++) {
+        streams.push(g.sine({ frequency: freq * h, duration }).volume({ volume: h === 1 ? 0.5 : 1 / h }));
+    }
+    return streams.length === 1 ? streams[0] : audioMix(streams);
+}
+//# sourceMappingURL=audio.js.map

package/dist/presets/audio.js.map

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

package/dist/presets/index.d.ts

@@ -0,0 +1,5 @@
+export { type AxisVars, type Axis, type Position, OVERLAY_NS, DRAWTEXT_NS, pos, resolvePos, } from './position.js';
+export { escapeDrawtext, type Shadow, type Background, type TextOpts, text, title, caption, textWatermark, type LowerThirdOpts, lowerThird, } from './text.js';
+export { type MasterProfile, type ChannelPreset, type NotificationProfile, type AmbienceProfile, noiseGate, limiter, radioVoice, telephone, masterAudio, ducking, audioMix, channelMapPreset, notification, ambience, drone, } from './audio.js';
+export { type TimedClip, xfadeChain, concatChain, fadeBookend, type KenBurnsPreset, kenBurnsExprs, kenBurns, type KenBurnsSlide, kenBurnsChain, } from './video.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,UAAU,EACV,WAAW,EACX,GAAG,EACH,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,IAAI,EACJ,KAAK,EACL,OAAO,EACP,aAAa,EACb,KAAK,cAAc,EACnB,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,SAAS,EACT,OAAO,EACP,UAAU,EACV,SAAS,EACT,WAAW,EACX,OAAO,EACP,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,SAAS,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,KAAK,cAAc,EACnB,aAAa,EACb,QAAQ,EACR,KAAK,aAAa,EAClB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/presets/index.js

@@ -0,0 +1,5 @@
+export { OVERLAY_NS, DRAWTEXT_NS, pos, resolvePos, } from './position.js';
+export { escapeDrawtext, text, title, caption, textWatermark, lowerThird, } from './text.js';
+export { noiseGate, limiter, radioVoice, telephone, masterAudio, ducking, audioMix, channelMapPreset, notification, ambience, drone, } from './audio.js';
+export { xfadeChain, concatChain, fadeBookend, kenBurnsExprs, kenBurns, kenBurnsChain, } from './video.js';
+//# sourceMappingURL=index.js.map

package/dist/presets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,UAAU,EACV,WAAW,EACX,GAAG,EACH,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EAId,IAAI,EACJ,KAAK,EACL,OAAO,EACP,aAAa,EAEb,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EAKL,SAAS,EACT,OAAO,EACP,UAAU,EACV,SAAS,EACT,WAAW,EACX,OAAO,EACP,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,UAAU,EACV,WAAW,EACX,WAAW,EAEX,aAAa,EACb,QAAQ,EAER,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/presets/position.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Position system for FFmpeg placement expressions — the TS port of the Rust
+ * SDK's `ops::position`. An {@link Axis} names where content sits along one
+ * dimension; a namespace ({@link DRAWTEXT_NS}, {@link OVERLAY_NS}) supplies the
+ * FFmpeg variable names the expression resolves against.
+ */
+/** FFmpeg variable names for one filter's coordinate space. */
+export interface AxisVars {
+    containerW: string;
+    contentW: string;
+    containerH: string;
+    contentH: string;
+}
+/** Coordinate space of `overlay` (main_w/overlay_w). */
+export declare const OVERLAY_NS: AxisVars;
+/** Coordinate space of `drawtext` (w/text_w). */
+export declare const DRAWTEXT_NS: AxisVars;
+/**
+ * Placement along one axis: `{ start }` / `{ end }` inset from an edge by a
+ * pixel margin, `'center'`, or a raw FFmpeg expression as the escape hatch.
+ */
+export type Axis = {
+    start: number;
+} | {
+    end: number;
+} | 'center' | {
+    expr: string;
+};
+export interface Position {
+    x: Axis;
+    y: Axis;
+}
+export declare function pos(x: Axis, y: Axis): Position;
+/** Resolve a position to `(x, y)` FFmpeg expressions in the given namespace. */
+export declare function resolvePos(p: Position, ns: AxisVars): {
+    x: string;
+    y: string;
+};
+//# sourceMappingURL=position.d.ts.map

package/dist/presets/position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../src/presets/position.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+DAA+D;AAC/D,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wDAAwD;AACxD,eAAO,MAAM,UAAU,EAAE,QAKxB,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,WAAW,EAAE,QAKzB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,IAAI,GACZ;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACf,QAAQ,GACR;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,IAAI,CAAC;IACR,CAAC,EAAE,IAAI,CAAC;CACT;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,QAAQ,CAE9C;AASD,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK9E"}

package/dist/presets/position.js

@@ -0,0 +1,40 @@
+/**
+ * Position system for FFmpeg placement expressions — the TS port of the Rust
+ * SDK's `ops::position`. An {@link Axis} names where content sits along one
+ * dimension; a namespace ({@link DRAWTEXT_NS}, {@link OVERLAY_NS}) supplies the
+ * FFmpeg variable names the expression resolves against.
+ */
+/** Coordinate space of `overlay` (main_w/overlay_w). */
+export const OVERLAY_NS = {
+    containerW: 'main_w',
+    contentW: 'overlay_w',
+    containerH: 'main_h',
+    contentH: 'overlay_h',
+};
+/** Coordinate space of `drawtext` (w/text_w). */
+export const DRAWTEXT_NS = {
+    containerW: 'w',
+    contentW: 'text_w',
+    containerH: 'h',
+    contentH: 'text_h',
+};
+export function pos(x, y) {
+    return { x, y };
+}
+function resolveAxis(a, container, content) {
+    if (a === 'center')
+        return `(${container}-${content})/2`;
+    if ('start' in a)
+        return `${a.start}`;
+    if ('end' in a)
+        return `${container}-${content}-${a.end}`;
+    return a.expr;
+}
+/** Resolve a position to `(x, y)` FFmpeg expressions in the given namespace. */
+export function resolvePos(p, ns) {
+    return {
+        x: resolveAxis(p.x, ns.containerW, ns.contentW),
+        y: resolveAxis(p.y, ns.containerH, ns.contentH),
+    };
+}
+//# sourceMappingURL=position.js.map

package/dist/presets/position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.js","sourceRoot":"","sources":["../../src/presets/position.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAa;IAClC,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,WAAW;CACtB,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,WAAW,GAAa;IACnC,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAiBF,MAAM,UAAU,GAAG,CAAC,CAAO,EAAE,CAAO;IAClC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,CAAO,EAAE,SAAiB,EAAE,OAAe;IAC9D,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,SAAS,IAAI,OAAO,KAAK,CAAC;IACzD,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;IACtC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,GAAG,SAAS,IAAI,OAAO,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;IAC1D,OAAO,CAAC,CAAC,IAAI,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,CAAW,EAAE,EAAY;IAClD,OAAO;QACL,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC;QAC/C,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC;KAChD,CAAC;AACJ,CAAC"}

package/dist/presets/text.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Text presets — ergonomic `drawtext` compositions, the TS port of the Rust
+ * SDK's `presets::text`. Positions resolve against {@link DRAWTEXT_NS}; text is
+ * escaped via {@link escapeDrawtext} before reaching the filter.
+ */
+import type { VideoStream } from '../streams.js';
+import { type Position } from './position.js';
+/** Escape drawtext-special characters (`\`, `:`, `'`). */
+export declare function escapeDrawtext(text: string): string;
+/** Drop-shadow for {@link TextOpts}. */
+export interface Shadow {
+    color?: string;
+    x?: number;
+    y?: number;
+}
+/** Semi-transparent background box for {@link TextOpts}. */
+export interface Background {
+    color: string;
+    borderWidth?: number;
+}
+/**
+ * Options for the {@link text} atom. Everything is optional; the preset
+ * molecules ({@link title}, {@link caption}, {@link textWatermark}) fill their
+ * own defaults into the fields a caller leaves unset, then delegate here.
+ */
+export interface TextOpts {
+    position?: Position;
+    font?: string;
+    fontSize?: number;
+    fontColor?: string;
+    shadow?: Shadow;
+    background?: Background;
+    /** Constant opacity in `[0, 1]`. For a time-varying ramp, drive the
+     * underlying `drawtext` op directly. */
+    alpha?: number;
+    /** Raw FFmpeg `enable` guard, e.g. `"between(t,2,8)"`. */
+    enable?: string;
+}
+/**
+ * Positioned text with sensible defaults: centred, font size `48`, white.
+ * Throws if `alpha` falls outside `[0, 1]`.
+ */
+export declare function text(input: VideoStream, textStr: string, opts?: TextOpts): VideoStream;
+/**
+ * Large centred title, white with a soft black shadow.
+ * Defaults: centred, font size `72`, shadow `black@0.8` offset `(2, 2)`.
+ */
+export declare function title(input: VideoStream, textStr: string, opts?: TextOpts): VideoStream;
+/**
+ * Bottom caption with a semi-transparent background box.
+ * Defaults: bottom-centre 20px margin, font size `36`, box `black@0.5` border `5`.
+ */
+export declare function caption(input: VideoStream, textStr: string, opts?: TextOpts): VideoStream;
+/**
+ * Semi-transparent corner watermark text.
+ * Defaults: bottom-right 20px margin, font size `24`, alpha `0.3`.
+ */
+export declare function textWatermark(input: VideoStream, textStr: string, opts?: TextOpts): VideoStream;
+/** Options for {@link lowerThird}. `startTime` and `endTime` are required. */
+export interface LowerThirdOpts {
+    /** When the lower third appears (seconds). */
+    startTime: number;
+    /** When the lower third disappears (seconds). */
+    endTime: number;
+    /** Background bar colour. Default `"black@0.7"`. */
+    backgroundColor?: string;
+    /** Name (top line) colour. Default `"white"`. */
+    nameColor?: string;
+    /** Title (bottom line) colour. Default `"white@0.8"`. */
+    titleColor?: string;
+    /** Name font size. Default `42`. */
+    nameFontSize?: number;
+    /** Title font size. Default `28`. */
+    titleFontSize?: number;
+    /** Font family. */
+    font?: string;
+    /** Horizontal margin from the left edge. Default `40`. */
+    margin?: number;
+    /** Fade in/out duration in seconds. Default `0.3`. */
+    fadeDuration?: number;
+}
+/**
+ * Name + title on a semi-transparent bar (`drawbox` + 2× `drawtext`), all timed
+ * together with a synchronized fade in/out. The bar height is
+ * `nameFontSize + titleFontSize + 30`, anchored `margin` px above the bottom;
+ * the `enable` guard and alpha ramp are shared across all three filters so the
+ * whole unit appears and disappears as one.
+ */
+export declare function lowerThird(input: VideoStream, name: string, titleStr: string, opts: LowerThirdOpts): VideoStream;
+//# sourceMappingURL=text.d.ts.map

package/dist/presets/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/presets/text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAgC,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE5E,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,wCAAwC;AACxC,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;4CACwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAqBtF;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAQvF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAQzF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAQ/F;AAkBD,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,cAAc,GACnB,WAAW,CAyCb"}

package/dist/presets/text.js

@@ -0,0 +1,132 @@
+import { DRAWTEXT_NS, pos, resolvePos } from './position.js';
+/** Escape drawtext-special characters (`\`, `:`, `'`). */
+export function escapeDrawtext(text) {
+    return text
+        .replaceAll('\\', '\\\\')
+        .replaceAll(':', '\\:')
+        .replaceAll("'", "'\\\\\\''");
+}
+/**
+ * Positioned text with sensible defaults: centred, font size `48`, white.
+ * Throws if `alpha` falls outside `[0, 1]`.
+ */
+export function text(input, textStr, opts) {
+    if (opts?.alpha !== undefined && !(opts.alpha >= 0 && opts.alpha <= 1)) {
+        throw new Error(`text: alpha must be in [0, 1], got ${opts.alpha}`);
+    }
+    const { x, y } = resolvePos(opts?.position ?? pos('center', 'center'), DRAWTEXT_NS);
+    const dt = {
+        text: escapeDrawtext(textStr),
+        fontsize: opts?.fontSize ?? 48,
+        fontcolor: opts?.fontColor ?? 'white',
+        x,
+        y,
+        ...(opts?.font !== undefined ? { font: opts.font } : {}),
+        ...(opts?.background ? { boxcolor: opts.background.color } : {}),
+        ...(opts?.background?.borderWidth !== undefined ? { borderw: opts.background.borderWidth } : {}),
+        ...(opts?.shadow?.color !== undefined ? { shadowcolor: opts.shadow.color } : {}),
+        ...(opts?.shadow?.x !== undefined ? { shadowx: opts.shadow.x } : {}),
+        ...(opts?.shadow?.y !== undefined ? { shadowy: opts.shadow.y } : {}),
+        ...(opts?.alpha !== undefined ? { alpha: `${opts.alpha}` } : {}),
+        ...(opts?.enable !== undefined ? { enable: opts.enable } : {}),
+    };
+    return input.drawtext(dt);
+}
+/**
+ * Large centred title, white with a soft black shadow.
+ * Defaults: centred, font size `72`, shadow `black@0.8` offset `(2, 2)`.
+ */
+export function title(input, textStr, opts) {
+    return text(input, textStr, {
+        ...opts,
+        position: opts?.position ?? pos('center', 'center'),
+        fontSize: opts?.fontSize ?? 72,
+        fontColor: opts?.fontColor ?? 'white',
+        shadow: opts?.shadow ?? { color: 'black@0.8', x: 2, y: 2 },
+    });
+}
+/**
+ * Bottom caption with a semi-transparent background box.
+ * Defaults: bottom-centre 20px margin, font size `36`, box `black@0.5` border `5`.
+ */
+export function caption(input, textStr, opts) {
+    return text(input, textStr, {
+        ...opts,
+        position: opts?.position ?? pos('center', { end: 20 }),
+        fontSize: opts?.fontSize ?? 36,
+        fontColor: opts?.fontColor ?? 'white',
+        background: opts?.background ?? { color: 'black@0.5', borderWidth: 5 },
+    });
+}
+/**
+ * Semi-transparent corner watermark text.
+ * Defaults: bottom-right 20px margin, font size `24`, alpha `0.3`.
+ */
+export function textWatermark(input, textStr, opts) {
+    return text(input, textStr, {
+        ...opts,
+        position: opts?.position ?? pos({ end: 20 }, { end: 20 }),
+        fontSize: opts?.fontSize ?? 24,
+        fontColor: opts?.fontColor ?? 'white',
+        alpha: opts?.alpha ?? 0.3,
+    });
+}
+// ---------------------------------------------------------------------------
+// Lower third
+// ---------------------------------------------------------------------------
+/** Opacity ramp: `0` before `start`, linear to `1` by `end`. */
+function fadeInExpr(start, end) {
+    const dur = end - start;
+    return `if(lt(t,${start}),0,if(lt(t,${end}),(t-${start})/${dur},1))`;
+}
+/** Opacity ramp: `1` before `start`, linear to `0` by `end`. */
+function fadeOutExpr(start, end) {
+    const dur = end - start;
+    return `if(lt(t,${start}),1,if(lt(t,${end}),1-(t-${start})/${dur},0))`;
+}
+/**
+ * Name + title on a semi-transparent bar (`drawbox` + 2× `drawtext`), all timed
+ * together with a synchronized fade in/out. The bar height is
+ * `nameFontSize + titleFontSize + 30`, anchored `margin` px above the bottom;
+ * the `enable` guard and alpha ramp are shared across all three filters so the
+ * whole unit appears and disappears as one.
+ */
+export function lowerThird(input, name, titleStr, opts) {
+    const bg = opts.backgroundColor ?? 'black@0.7';
+    const nameColor = opts.nameColor ?? 'white';
+    const titleColor = opts.titleColor ?? 'white@0.8';
+    const nameFs = opts.nameFontSize ?? 42;
+    const titleFs = opts.titleFontSize ?? 28;
+    const margin = opts.margin ?? 40;
+    const fade = opts.fadeDuration ?? 0.3;
+    const start = opts.startTime;
+    const end = opts.endTime;
+    // Bar dimensions — bottom-anchored, full width, tall enough for two lines.
+    const barHeight = nameFs + titleFs + 30;
+    const barY = `h-${barHeight}-${margin}`;
+    // Name on the top line, title below it.
+    const nameY = `h-${barHeight}-${margin}+10`;
+    const titleY = `h-${barHeight}-${margin}+${nameFs + 15}`;
+    const enable = `between(t,${start},${end})`;
+    const alpha = `min(${fadeInExpr(start, start + fade)},${fadeOutExpr(end - fade, end)})`;
+    return input
+        .drawbox({
+        x: '0', y: barY, w: 'w', h: `${barHeight}`,
+        color: bg, t: 'fill', enable,
+    })
+        .drawtext({
+        text: escapeDrawtext(name),
+        fontsize: nameFs, fontcolor: nameColor,
+        x: `${margin}`, y: nameY,
+        alpha, enable,
+        ...(opts.font !== undefined ? { font: opts.font } : {}),
+    })
+        .drawtext({
+        text: escapeDrawtext(titleStr),
+        fontsize: titleFs, fontcolor: titleColor,
+        x: `${margin}`, y: titleY,
+        alpha, enable,
+        ...(opts.font !== undefined ? { font: opts.font } : {}),
+    });
+}
+//# sourceMappingURL=text.js.map

package/dist/presets/text.js.map

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

package/dist/presets/video.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Video presets — crossfade/concat sequencing, fade bookends, and Ken Burns
+ * motion. The TS port of the Rust SDK's `presets::video`; also the single
+ * home of the Ken Burns implementation the `makeSlideshow` recipe uses.
+ */
+import type { VideoStream } from '../streams.js';
+/** A clip paired with its content duration in seconds. */
+export interface TimedClip {
+    stream: VideoStream;
+    duration: number;
+}
+/**
+ * Chain clips with `xfade` transitions, computing each cumulative offset from
+ * the clip durations: every transition overlaps `crossfade` seconds of the
+ * outgoing and incoming clips. Requires at least 2 clips.
+ */
+export declare function xfadeChain(clips: TimedClip[], transition: string, crossfade: number): VideoStream;
+/** Concatenate clips back-to-back. Requires at least 2 clips. */
+export declare function concatChain(clips: VideoStream[]): VideoStream;
+export declare function fadeBookend(video: VideoStream, fadeInDur: number, fadeOutStart: number, fadeOutDur: number): VideoStream;
+export type KenBurnsPreset = 'gentleZoomIn' | 'gentleZoomOut' | 'gentlePan' | 'zoomIn' | 'zoomOut' | 'panRight' | 'panLeft' | 'punchIn' | 'pullBack' | 'spiral' | 'diagonal' | 'parallax';
+/** The zoompan `z`/`x`/`y` expressions for a preset over `frames` frames. */
+export declare function kenBurnsExprs(preset: KenBurnsPreset, frames: number): {
+    z: string;
+    x: string;
+    y: string;
+};
+/**
+ * Apply a Ken Burns move to a clip, emitting `w`×`h` at `fps`.
+ *
+ * Modest 2x working size for zoom headroom. NOT 4x: that produced ~8K
+ * intermediate frames which, with the deflicker/tmix/gblur smoothing stack,
+ * OOM'd render workers (ffmpeg exit 254). Integer (trunc'd) pan positions keep
+ * the motion jitter-free without any of that smoothing — the lean approach
+ * proven in production.
+ */
+export declare function kenBurns(input: VideoStream, preset: KenBurnsPreset, duration: number, w: number, h: number, fps: number): VideoStream;
+/** A slide for {@link kenBurnsChain}. */
+export interface KenBurnsSlide {
+    stream: VideoStream;
+    preset: KenBurnsPreset;
+    duration: number;
+}
+/** Prepare slides with Ken Burns moves, ready to feed {@link xfadeChain}. */
+export declare function kenBurnsChain(slides: KenBurnsSlide[], w: number, h: number, fps: number): TimedClip[];
+//# sourceMappingURL=video.d.ts.map

package/dist/presets/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../src/presets/video.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,WAAW,CAWb;AAMD,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,CAK7D;AAMD,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,WAAW,CAIb;AAMD,MAAM,MAAM,cAAc,GACtB,cAAc,GAAG,eAAe,GAAG,WAAW,GAC9C,QAAQ,GAAG,SAAS,GACpB,UAAU,GAAG,SAAS,GACtB,SAAS,GAAG,UAAU,GACtB,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAiBvC,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CA2BzG;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,MAAM,GACV,WAAW,CAWb;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EAAE,EACvB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,MAAM,GACV,SAAS,EAAE,CAKb"}