@gannochenko/staticstripes 0.0.1

package/dist/expression-parser.d.ts

@@ -0,0 +1,63 @@
+import { Expression } from 'expr-eval';
+export type TimeData = {
+    start: number;
+    end: number;
+    duration: number;
+};
+export type FragmentData = {
+    time: TimeData;
+};
+/**
+ * Context available for expression evaluation
+ * Contains fragment data with runtime timing information
+ */
+export type ExpressionContext = {
+    fragments: Map<string, FragmentData>;
+};
+/**
+ * Compiled expression that can be evaluated with runtime context
+ */
+export type CompiledExpression = {
+    original: string;
+    expression: Expression;
+};
+/**
+ * Parses a calc() expression into a compiled expression for later evaluation
+ *
+ * Supported syntax:
+ * - Fragment references: #fragment_id.property.path
+ * - Math operations: +, -, *, /, parentheses
+ * - Constants: numeric values
+ *
+ * Examples:
+ * - calc(-1 * #ending_screen.time.start)
+ * - calc(#intro.time.duration + 1000)
+ * - calc((#scene1.time.start + #scene2.time.end) / 2)
+ *
+ * @param expression - The expression string to parse
+ * @returns Compiled expression that can be evaluated later
+ */
+export declare function parseExpression(expression: string): CompiledExpression;
+/**
+ * Evaluates a compiled expression with runtime context
+ *
+ * @param compiled - Compiled expression from parseExpression()
+ * @param context - Context containing fragment data
+ * @returns Evaluated numeric result (in milliseconds)
+ */
+export declare function evaluateCompiledExpression(compiled: CompiledExpression, context: ExpressionContext): number;
+/**
+ * Checks if a string contains a calc() expression
+ * @param value - String to check
+ * @returns True if value contains calc()
+ */
+export declare function isCalcExpression(value: string): boolean;
+/**
+ * Parses a value into either a number or a compiled expression for later evaluation
+ * Use this during HTML parsing to compile expressions once
+ * @param value - Value to parse (number or calc expression string)
+ * @returns Number or CompiledExpression
+ */
+export declare function parseValueLazy(value: number | string): number | CompiledExpression;
+export declare function calculateFinalValue(value: number | CompiledExpression, context: ExpressionContext): number;
+//# sourceMappingURL=expression-parser.d.ts.map

package/dist/expression-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-parser.d.ts","sourceRoot":"","sources":["../src/expression-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAU,MAAM,WAAW,CAAC;AAE/C,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAoBtE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,iBAAiB,GACzB,MAAM,CA8CR;AAgCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,MAAM,GACrB,MAAM,GAAG,kBAAkB,CAkB7B;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAClC,OAAO,EAAE,iBAAiB,UAK3B"}

package/dist/expression-parser.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseExpression = parseExpression;
+exports.evaluateCompiledExpression = evaluateCompiledExpression;
+exports.isCalcExpression = isCalcExpression;
+exports.parseValueLazy = parseValueLazy;
+exports.calculateFinalValue = calculateFinalValue;
+const expr_eval_1 = require("expr-eval");
+/**
+ * Parses a calc() expression into a compiled expression for later evaluation
+ *
+ * Supported syntax:
+ * - Fragment references: #fragment_id.property.path
+ * - Math operations: +, -, *, /, parentheses
+ * - Constants: numeric values
+ *
+ * Examples:
+ * - calc(-1 * #ending_screen.time.start)
+ * - calc(#intro.time.duration + 1000)
+ * - calc((#scene1.time.start + #scene2.time.end) / 2)
+ *
+ * @param expression - The expression string to parse
+ * @returns Compiled expression that can be evaluated later
+ */
+function parseExpression(expression) {
+    const parser = new expr_eval_1.Parser();
+    // Transform expression to replace fragment references with variable names
+    // Convert: calc(-1 * #ending_screen.time.start)
+    // To:      -1 * ending_screen_time_start
+    const transformed = transformExpressionToVariables(expression);
+    try {
+        // Parse into Expression object
+        const expr = parser.parse(transformed);
+        return {
+            original: expression,
+            expression: expr,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to parse expression "${expression}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Evaluates a compiled expression with runtime context
+ *
+ * @param compiled - Compiled expression from parseExpression()
+ * @param context - Context containing fragment data
+ * @returns Evaluated numeric result (in milliseconds)
+ */
+function evaluateCompiledExpression(compiled, context) {
+    // Build evaluation context by resolving all fragment references
+    // Convert fragment references to flat variable names
+    const evalContext = {};
+    // Extract all fragment references from the original expression
+    const fragmentRefs = compiled.original.matchAll(/#(\w+)\.([\w.]+?)(?=\s|[+\-*/)]|$)/g);
+    for (const match of fragmentRefs) {
+        const id = match[1];
+        const prop = match[2];
+        const varName = `${id}_${prop.replace(/\./g, '_')}`;
+        // Resolve fragment value
+        const fragment = context.fragments.get(id);
+        if (!fragment) {
+            throw new Error(`Fragment with id "${id}" not found in expression: ${compiled.original}`);
+        }
+        // Navigate property path (e.g., "time.start" -> fragment.time.start)
+        const parts = prop.split('.');
+        let value = fragment;
+        for (const part of parts) {
+            value = value[part];
+            if (value === undefined) {
+                throw new Error(`Property "${prop}" not found on fragment "${id}" in expression: ${compiled.original}`);
+            }
+        }
+        evalContext[varName] = value;
+    }
+    try {
+        // Evaluate with resolved context
+        return compiled.expression.evaluate(evalContext);
+    }
+    catch (error) {
+        throw new Error(`Failed to evaluate expression "${compiled.original}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Transforms calc() expression syntax to use variable names instead of fragment references
+ * and converts time units to milliseconds
+ * @param expression - Original expression
+ * @returns Transformed expression
+ *
+ * Example: calc(url(#ending_screen.time.start) + 5s)
+ *       -> ending_screen_time_start + 5000
+ */
+function transformExpressionToVariables(expression) {
+    let transformed = expression
+        // Remove calc() wrapper
+        .replace(/calc\(/g, '(')
+        // Convert fragment references: url(#id.prop.path) -> id_prop_path
+        .replace(/url\(#(\w+)\.([\w.]+?)\)/g, (_, id, prop) => {
+        return `${id}_${prop.replace(/\./g, '_')}`;
+    })
+        // Convert time units to milliseconds
+        // Match numbers with 's' suffix (seconds): 5s -> 5000
+        .replace(/(\d+(?:\.\d+)?)s(?!\w)/g, (_, num) => {
+        return String(parseFloat(num) * 1000);
+    })
+        // Match numbers with 'ms' suffix (milliseconds): 5000ms -> 5000
+        .replace(/(\d+(?:\.\d+)?)ms(?!\w)/g, (_, num) => {
+        return String(parseFloat(num));
+    });
+    return transformed;
+}
+/**
+ * Checks if a string contains a calc() expression
+ * @param value - String to check
+ * @returns True if value contains calc()
+ */
+function isCalcExpression(value) {
+    return typeof value === 'string' && value.trim().startsWith('calc(');
+}
+/**
+ * Parses a value into either a number or a compiled expression for later evaluation
+ * Use this during HTML parsing to compile expressions once
+ * @param value - Value to parse (number or calc expression string)
+ * @returns Number or CompiledExpression
+ */
+function parseValueLazy(value) {
+    if (typeof value === 'number') {
+        return value;
+    }
+    if (isCalcExpression(value)) {
+        return parseExpression(value);
+    }
+    // Try to parse as plain number
+    const parsed = parseFloat(value);
+    if (!isNaN(parsed)) {
+        return parsed;
+    }
+    throw new Error(`Invalid value: "${value}". Expected number or calc() expression`);
+}
+function calculateFinalValue(value, context) {
+    return typeof value === 'number'
+        ? value
+        : evaluateCompiledExpression(value, context);
+}
+//# sourceMappingURL=expression-parser.js.map

package/dist/expression-parser.js.map

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

package/dist/ffmpeg.d.ts

@@ -0,0 +1,375 @@
+import { Project } from './project';
+export type Label = {
+    tag: string;
+    isAudio: boolean;
+};
+/**
+ * Checks if FFmpeg is installed and available in the system PATH
+ * @throws Error if FFmpeg is not found
+ */
+export declare function checkFFmpegInstalled(): Promise<void>;
+export type Millisecond = number;
+/**
+ * Helper function to format milliseconds for FFmpeg time parameters
+ * @param value - Time value in milliseconds
+ * @returns Formatted string with 'ms' suffix (e.g., "1500ms")
+ */
+export declare function ms(value: Millisecond): string;
+export declare class Filter {
+    private inputs;
+    outputs: Label[];
+    body: string;
+    constructor(inputs: Label[], outputs: Label[], body: string);
+    render(): string;
+}
+/**
+ * Generates the complete ffmpeg command for rendering the project
+ */
+export declare function makeFFmpegCommand(project: Project, filterComplex: string, outputName: string, preset?: 'ultrafast' | 'medium'): string;
+export declare const runFFMpeg: (ffmpegCommand: string) => Promise<void>;
+/**
+ * Creates a concat filter
+ * Automatically determines the number of segments (n) and stream counts (v, a) from input labels
+ * and generates appropriate output labels
+ * @param inputs - Array of input stream labels
+ * @returns Filter with auto-generated outputs
+ */
+export declare function makeConcat(inputs: Label[]): Filter;
+/**
+ * Creates an xfade (crossfade) filter for video streams
+ * Note: xfade only works with video, not audio
+ * @param input1 - First video input stream label
+ * @param input2 - Second video input stream label
+ * @param options - Transition parameters
+ * @returns Filter with auto-generated video output
+ */
+export declare function makeXFade(inputs: Label[], options: {
+    duration: Millisecond;
+    offset: Millisecond;
+    transition?: string;
+}): Filter;
+/**
+ * Creates a null filter (passthrough)
+ * @param input - Input stream label
+ */
+export declare function makeNull(inputs: Label[]): Filter;
+export declare function makeOverlay(inputs: Label[], options?: {
+    x?: string | number;
+    y?: string | number;
+}): Filter;
+export declare function makeFps(inputs: Label[], fps: number): Filter;
+export declare function makeScale(inputs: Label[], options: {
+    width: number | string;
+    height: number | string;
+    flags?: string;
+}): Filter;
+/**
+ * Creates a split filter (splits one input into multiple outputs)
+ * @param input - Input stream label
+ * @param outputLabels - Array of output stream labels
+ */
+export declare function makeSplit(inputs: Label[]): Filter;
+export declare function makeTranspose(inputs: Label[], direction: 0 | 1 | 2 | 3): Filter;
+/**
+ * Creates a trim filter to cut streams to a specific time range
+ * @param inputs - Input stream labels (video or audio)
+ * @param start - Start time in milliseconds
+ * @param end - End time in milliseconds
+ * @returns Filter with trimmed output
+ */
+export declare function makeTrim(inputs: Label[], start: Millisecond, end: Millisecond): Filter;
+/**
+ * Creates a tpad/apad filter to add temporal padding (frames/silence)
+ * @param inputs - Input stream labels (video or audio)
+ * @param options - Padding parameters
+ *   - start: Duration to add at the beginning (in milliseconds, default: 0)
+ *   - stop: Duration to add at the end (in milliseconds, default: 0)
+ *   - start_mode: 'clone' (duplicate frames) or 'add' (colored frames/silence, default)
+ *   - stop_mode: 'clone' (duplicate frames) or 'add' (colored frames/silence, default)
+ *   - color: Color of added frames (video only, e.g., 'black', '#00FF00', default: 'black')
+ */
+export declare function makeTPad(inputs: Label[], options?: {
+    start?: Millisecond;
+    stop?: Millisecond;
+    color?: string;
+    startMode?: 'clone' | 'add';
+    stopMode?: 'clone' | 'add';
+}): Filter;
+/**
+ * Creates a pad filter to add borders/letterboxing
+ * @param inputs - Input stream labels (must be video)
+ * @param width - Output width (can be expression like 'iw' or number)
+ * @param height - Output height (can be expression like 'ih' or number)
+ * @param x - X position (default: center using '(ow-iw)/2')
+ * @param y - Y position (default: center using '(oh-ih)/2')
+ * @param color - Background color (default: 'black')
+ */
+export declare function makePad(inputs: Label[], options: {
+    width: number | string;
+    height: number | string;
+    x?: string;
+    y?: string;
+    color?: string;
+}): Filter;
+/**
+ * Creates a crop filter to cut video to specific dimensions
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Crop parameters
+ *   - width: Output width (can be expression or number)
+ *   - height: Output height (can be expression or number)
+ *   - x: X position to start crop (default: center using '(in_w-out_w)/2')
+ *   - y: Y position to start crop (default: center using '(in_h-out_h)/2')
+ */
+export declare function makeCrop(inputs: Label[], options: {
+    width: number | string;
+    height: number | string;
+    x?: string;
+    y?: string;
+}): Filter;
+/**
+ * Creates an eq (equalization) filter for color correction
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Color adjustment parameters
+ *   - brightness: -1.0 to 1.0 (default: 0)
+ *   - contrast: -1000 to 1000 (default: 1.0)
+ *   - saturation: 0 to 3 (default: 1.0)
+ *   - gamma: 0.1 to 10 (default: 1.0)
+ */
+export declare function makeEq(inputs: Label[], options: {
+    brightness?: number;
+    contrast?: number;
+    saturation?: number;
+    gamma?: number;
+}): Filter;
+/**
+ * Creates a colorchannelmixer filter for advanced color adjustment
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Color channel mixing parameters
+ *   - rr: Red contribution to red channel (-2 to 2, default: 1)
+ *   - rg: Green contribution to red channel (-2 to 2, default: 0)
+ *   - rb: Blue contribution to red channel (-2 to 2, default: 0)
+ *   - ra: Alpha contribution to red channel (-2 to 2, default: 0)
+ *   - gr: Red contribution to green channel (-2 to 2, default: 0)
+ *   - gg: Green contribution to green channel (-2 to 2, default: 1)
+ *   - gb: Blue contribution to green channel (-2 to 2, default: 0)
+ *   - ga: Alpha contribution to green channel (-2 to 2, default: 0)
+ *   - br: Red contribution to blue channel (-2 to 2, default: 0)
+ *   - bg: Green contribution to blue channel (-2 to 2, default: 0)
+ *   - bb: Blue contribution to blue channel (-2 to 2, default: 1)
+ *   - ba: Alpha contribution to blue channel (-2 to 2, default: 0)
+ */
+export declare function makeColorChannelMixer(inputs: Label[], options?: {
+    rr?: number;
+    rg?: number;
+    rb?: number;
+    ra?: number;
+    gr?: number;
+    gg?: number;
+    gb?: number;
+    ga?: number;
+    br?: number;
+    bg?: number;
+    bb?: number;
+    ba?: number;
+}): Filter;
+/**
+ * Creates a curves filter for color grading (similar to Photoshop curves)
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Curves parameters
+ *   - preset: Preset curve name (e.g., 'darker', 'lighter', 'increase_contrast', 'vintage', etc.)
+ *   - master: Master curve points (affects all channels, e.g., '0/0 0.5/0.6 1/1')
+ *   - red: Red channel curve points
+ *   - green: Green channel curve points
+ *   - blue: Blue channel curve points
+ *   - all: Apply same curve to all RGB channels
+ */
+export declare function makeCurves(inputs: Label[], options?: {
+    preset?: string;
+    master?: string;
+    red?: string;
+    green?: string;
+    blue?: string;
+    all?: string;
+}): Filter;
+/**
+ * Creates a vignette filter to darken the corners/edges
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Vignette parameters
+ *   - angle: Lens angle (0 to PI/2, default: PI/5)
+ *   - x0: X coordinate of vignette center (0 to 1, default: w/2)
+ *   - y0: Y coordinate of vignette center (0 to 1, default: h/2)
+ *   - mode: Vignette mode ('forward' or 'backward', default: 'forward')
+ *   - eval: When to evaluate expressions ('init' or 'frame', default: 'init')
+ */
+export declare function makeVignette(inputs: Label[], options?: {
+    angle?: string;
+    x0?: string;
+    y0?: string;
+    mode?: 'forward' | 'backward';
+    eval?: 'init' | 'frame';
+}): Filter;
+/**
+ * Creates a colorbalance filter to adjust colors in shadows, midtones, and highlights
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Color balance parameters
+ *   - rs: Red shift for shadows (-1 to 1, default: 0)
+ *   - gs: Green shift for shadows (-1 to 1, default: 0)
+ *   - bs: Blue shift for shadows (-1 to 1, default: 0)
+ *   - rm: Red shift for midtones (-1 to 1, default: 0)
+ *   - gm: Green shift for midtones (-1 to 1, default: 0)
+ *   - bm: Blue shift for midtones (-1 to 1, default: 0)
+ *   - rh: Red shift for highlights (-1 to 1, default: 0)
+ *   - gh: Green shift for highlights (-1 to 1, default: 0)
+ *   - bh: Blue shift for highlights (-1 to 1, default: 0)
+ */
+export declare function makeColorBalance(inputs: Label[], options?: {
+    rs?: number;
+    gs?: number;
+    bs?: number;
+    rm?: number;
+    gm?: number;
+    bm?: number;
+    rh?: number;
+    gh?: number;
+    bh?: number;
+}): Filter;
+/**
+ * Creates a Gaussian blur filter
+ * @param inputs - Input stream labels (must be video)
+ * @param sigma - Blur strength (0.01 to 1024, default: 1.0)
+ * @param steps - Number of blur steps (1 to 6, default: 1, higher = smoother but slower)
+ */
+export declare function makeGblur(inputs: Label[], options?: {
+    sigma?: number;
+    steps?: number;
+}): Filter;
+/**
+ * Creates a box blur filter (simpler, faster blur)
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Blur parameters
+ *   - luma_radius (lr): Horizontal luma blur radius (0 to min(w,h)/2)
+ *   - luma_power (lp): Number of times to apply luma blur (0 to 2)
+ *   - chroma_radius (cr): Horizontal chroma blur radius (0 to min(w,h)/2)
+ *   - chroma_power (cp): Number of times to apply chroma blur (0 to 2)
+ */
+export declare function makeBoxblur(inputs: Label[], options?: {
+    luma_radius?: number;
+    luma_power?: number;
+    chroma_radius?: number;
+    chroma_power?: number;
+}): Filter;
+/**
+ * Creates an unsharp filter (sharpen or blur)
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Sharpening parameters
+ *   - luma_amount: Luma sharpening amount (-2 to 5, default: 1.0, negative = blur)
+ *   - chroma_amount: Chroma sharpening amount (-2 to 5, default: 0)
+ */
+export declare function makeUnsharp(inputs: Label[], options?: {
+    luma_amount?: number;
+    chroma_amount?: number;
+}): Filter;
+/**
+ * Creates a hue adjustment filter
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Hue adjustment parameters
+ *   - hue: Hue angle in degrees (0 to 360)
+ *   - saturation: Saturation multiplier (-10 to 10, default: 1.0)
+ *   - brightness: Brightness adjustment (-10 to 10, default: 0)
+ */
+export declare function makeHue(inputs: Label[], options?: {
+    hue?: number;
+    saturation?: number;
+    brightness?: number;
+}): Filter;
+/**
+ * Creates a horizontal flip filter (mirrors video left-right)
+ * Note: Only works with video streams
+ */
+export declare function makeHflip(inputs: Label[]): Filter;
+/**
+ * Creates a vertical flip filter (mirrors video top-bottom)
+ * Note: Only works with video streams
+ */
+export declare function makeVflip(inputs: Label[]): Filter;
+/**
+ * Creates a chromakey filter for green/blue screen removal
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Chromakey parameters
+ *   - color: Color to key out (e.g., 'green', '0x00FF00', '#00FF00')
+ *   - similarity: How similar colors need to be to match (0.01 to 1.0, default: 0.01)
+ *   - blend: Blend percentage for edges (0.0 to 1.0, default: 0.0)
+ */
+export declare function makeChromakey(inputs: Label[], options: {
+    color: string;
+    similarity?: number;
+    blend?: number;
+}): Filter;
+/**
+ * Creates a despill filter to remove color spill from chromakey
+ * @param inputs - Input stream labels (must be video)
+ * @param options - Despill parameters
+ *   - type: Color to despill ('green' or 'blue', default: 'green')
+ *   - mix: Mix factor (0.0 to 1.0, default: 0.5)
+ *   - expand: Expand factor (0.0 to 1.0, default: 0.0)
+ */
+export declare function makeDespill(inputs: Label[], options?: {
+    type?: 'green' | 'blue';
+    mix?: number;
+    expand?: number;
+}): Filter;
+export declare function makeFade(inputs: Label[], options: {
+    fades: Array<{
+        type: 'in' | 'out';
+        startTime: Millisecond;
+        duration: Millisecond;
+        color?: string;
+        curve?: string;
+    }>;
+}): Filter;
+/**
+ * Creates a color source filter to generate blank video
+ * @param options - Video parameters
+ *   - duration: Duration in milliseconds
+ *   - width: Video width in pixels
+ *   - height: Video height in pixels
+ *   - fps: Frame rate (default: 30)
+ *   - color: Color (default: 'black', supports alpha with format '#RRGGBBAA')
+ * @returns Filter with video output
+ */
+export declare function makeColor(options: {
+    duration: Millisecond;
+    width: number;
+    height: number;
+    fps?: number;
+    color?: string;
+}): Filter;
+/**
+ * Creates an anullsrc filter to generate silent audio
+ * @param options - Audio parameters
+ *   - duration: Duration in milliseconds
+ *   - channel_layout: Audio channel layout (default: 'stereo')
+ *   - sample_rate: Sample rate in Hz (default: 48000)
+ * @returns Filter with audio output
+ */
+export declare function makeAnullsrc(options: {
+    duration: Millisecond;
+    channel_layout?: string;
+    sample_rate?: number;
+}): Filter;
+/**
+ * Creates an amix filter to mix multiple audio streams
+ * @param inputs - Input stream labels (must all be audio)
+ * @param options - Mix parameters
+ *   - duration: Output duration mode ('longest', 'shortest', 'first', default: 'longest')
+ *   - dropout_transition: Transition time when input ends in seconds (default: 2)
+ *   - weights: Array of weights for each input (e.g., [1, 0.5] makes second input quieter)
+ *   - normalize: If true, automatically normalize weights to prevent clipping (default: true)
+ */
+export declare function makeAmix(inputs: Label[], options?: {
+    duration?: 'longest' | 'shortest' | 'first';
+    dropout_transition?: number;
+    weights?: number[];
+    normalize?: boolean;
+}): Filter;
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/ffmpeg.d.ts.map

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