@jtdigital/renderbox-sdk 0.4.1 → 0.6.0

package/dist/streams.d.ts

@@ -1,125 +1,151 @@
-import type { SortTag, ParamValue } from './types.js';
+import type { SortTag, ParamValue, Expr, FFmpegColor } from './types.js';
 import type { Graph } from './graph.js';
 export interface AcompressorOpts {
-    threshold?: number;
-    ratio?: number;
+    threshold?: number | undefined;
+    ratio?: number | undefined;
 }
 export interface AcontrastOpts {
-    contrast?: number;
+    contrast?: number | undefined;
 }
 export interface AcrossfadeOpts {
-    d?: number;
+    d?: number | undefined;
 }
 export interface AdeclickOpts {
-    window?: number;
-    overlap?: number;
-    arorder?: number;
-    threshold?: number;
-    burst?: number;
-    method?: 'add' | 'a' | 'save' | 's';
+    window?: number | undefined;
+    overlap?: number | undefined;
+    arorder?: number | undefined;
+    threshold?: number | undefined;
+    burst?: number | undefined;
+    method?: 'add' | 'a' | 'save' | 's' | undefined;
 }
 export interface AdelayOpts {
     delays: string;
 }
 export interface AechoOpts {
-    in_gain?: number;
-    out_gain?: number;
+    in_gain?: number | undefined;
+    out_gain?: number | undefined;
     delays: string;
     decays: string;
 }
 export interface AfadeOpts {
     type: 'in' | 'out';
     /** @range greater than 0 */
-    duration?: number;
+    duration?: number | undefined;
     /** @range at least 0 */
-    start_time?: number;
+    start_time?: number | undefined;
 }
 export interface AfftdnOpts {
-    nr?: number;
-    nt?: 'w' | 'v' | 's' | 'p';
-    bn?: string;
+    nr?: number | undefined;
+    nt?: 'w' | 'v' | 's' | 'p' | undefined;
+    bn?: string | undefined;
 }
 export interface AgateOpts {
-    threshold?: number;
-    ratio?: number;
-    attack?: number;
-    release?: number;
-    range?: number;
-    detection?: 'peak' | 'rms';
+    threshold?: number | undefined;
+    ratio?: number | undefined;
+    attack?: number | undefined;
+    release?: number | undefined;
+    range?: number | undefined;
+    detection?: 'peak' | 'rms' | undefined;
 }
 export interface AggregateTracksOpts {
-    attribute?: string;
-    method?: 'majority_vote' | 'weighted_avg' | 'last_n';
+    attribute?: string | undefined;
+    method?: 'majority_vote' | 'weighted_avg' | 'last_n' | undefined;
     /** @range greater than 0 */
-    window?: number;
+    window?: number | undefined;
 }
 export interface AlimiterOpts {
-    limit?: number;
-    attack?: number;
-    release?: number;
-    level_in?: number;
-    level_out?: number;
-    asc?: boolean;
+    limit?: number | undefined;
+    attack?: number | undefined;
+    release?: number | undefined;
+    level_in?: number | undefined;
+    level_out?: number | undefined;
+    level?: boolean | undefined;
+    asc?: boolean | undefined;
 }
 export interface AloopOpts {
-    loop?: number;
-    size?: number;
-    start?: number;
+    loop?: number | undefined;
+    size?: number | undefined;
+    start?: number | undefined;
 }
 export interface AmergeOpts {
-    inputs?: number;
+    inputs?: number | undefined;
 }
 export interface AmixOpts {
-    normalize?: boolean;
-    duration?: 'longest' | 'shortest' | 'first';
+    normalize?: boolean | undefined;
+    duration?: 'longest' | 'shortest' | 'first' | undefined;
 }
 export interface AnchorGraphicOpts {
     keypoint: string;
-    offset_x?: number;
-    offset_y?: number;
+    offset_x?: number | undefined;
+    offset_y?: number | undefined;
 }
 export interface AnlmdnOpts {
-    s?: number;
-    p?: number;
-    r?: number;
-}
-export interface AnnotateOpts {
-    style?: 'bbox' | 'label' | 'bbox+label' | 'mask';
-    thickness?: number;
-    show_confidence?: boolean;
-    fontsize?: number;
-    fontcolor?: string;
-    color?: string;
-    class_colors?: Record<string, ParamValue>;
-}
+    s?: number | undefined;
+    p?: number | undefined;
+    r?: number | undefined;
+}
+/** Variants by `style`: 'mask' forbids `thickness`/`fontsize`/`fontcolor`. */
+export type AnnotateOpts = {
+    show_confidence?: boolean | undefined;
+    color?: FFmpegColor | undefined;
+    class_colors?: Record<string, ParamValue> | undefined;
+} & ({
+    style?: never;
+    thickness?: number | undefined;
+    fontsize?: number | undefined;
+    fontcolor?: FFmpegColor | undefined;
+} | {
+    style: 'bbox';
+    thickness?: number | undefined;
+    fontsize?: number | undefined;
+    fontcolor?: FFmpegColor | undefined;
+} | {
+    style: 'label';
+    thickness?: number | undefined;
+    fontsize?: number | undefined;
+    fontcolor?: FFmpegColor | undefined;
+} | {
+    style: 'bbox+label';
+    thickness?: number | undefined;
+    fontsize?: number | undefined;
+    fontcolor?: FFmpegColor | undefined;
+} | {
+    style: 'mask';
+    thickness?: never;
+    fontsize?: never;
+    fontcolor?: never;
+});
 export interface ApadOpts {
-    whole_dur?: number;
+    whole_dur?: number | undefined;
 }
 export interface AphaserOpts {
-    in_gain?: number;
-    out_gain?: number;
-    delay?: number;
-    decay?: number;
-    speed?: number;
-    type?: 'triangular' | 'sinusoidal';
+    in_gain?: number | undefined;
+    out_gain?: number | undefined;
+    delay?: number | undefined;
+    decay?: number | undefined;
+    speed?: number | undefined;
+    type?: 'triangular' | 'sinusoidal' | undefined;
 }
 export interface AresampleOpts {
     rate: number;
 }
+export interface AsetptsOpts {
+    expr: Expr;
+}
 export interface AstatsOpts {
-    metadata?: number;
-    reset?: number;
-    measure_perchannel?: string;
-    measure_overall?: string;
+    metadata?: number | undefined;
+    reset?: number | undefined;
+    measure_perchannel?: string | undefined;
+    measure_overall?: string | undefined;
 }
 export interface AsubboostOpts {
-    dry?: number;
-    wet?: number;
-    decay?: number;
-    feedback?: number;
-    cutoff?: number;
-    slope?: number;
-    delay?: number;
+    dry?: number | undefined;
+    wet?: number | undefined;
+    decay?: number | undefined;
+    feedback?: number | undefined;
+    cutoff?: number | undefined;
+    slope?: number | undefined;
+    delay?: number | undefined;
 }
 export interface AtempoOpts {
     /** @range [0.5, 100] */
@@ -127,256 +153,256 @@ export interface AtempoOpts {
 }
 export interface AtrimOpts {
     /** @range at least 0 */
-    start?: number;
+    start?: number | undefined;
     /** @range greater than 0 */
-    end?: number;
+    end?: number | undefined;
 }
 export interface AutoEnhanceOpts {
     model: string;
     /** @range [0, 1] */
-    strength?: number;
+    strength?: number | undefined;
 }
 export interface BackgroundkeyOpts {
-    threshold?: number;
-    similarity?: number;
-    blend?: number;
+    threshold?: number | undefined;
+    similarity?: number | undefined;
+    blend?: number | undefined;
 }
 export interface BandpassOpts {
     f: number;
-    width_type?: 'h' | 'q' | 'o' | 's' | 'k';
+    width_type?: 'h' | 'q' | 'o' | 's' | 'k' | undefined;
     width: number;
 }
 export interface BassOpts {
     gain: number;
-    frequency?: number;
-    width_type?: 'h' | 'q' | 'o' | 's' | 'k';
-    width?: number;
+    frequency?: number | undefined;
+    width_type?: 'h' | 'q' | 'o' | 's' | 'k' | undefined;
+    width?: number | undefined;
 }
 export interface BilateralOpts {
-    sigmaS?: number;
-    sigmaR?: number;
-    planes?: number;
+    sigmaS?: number | undefined;
+    sigmaR?: number | undefined;
+    planes?: number | undefined;
 }
 export interface BlackdetectOpts {
-    d?: number;
-    pix_th?: number;
-    pic_th?: number;
+    d?: number | undefined;
+    pix_th?: number | undefined;
+    pic_th?: number | undefined;
 }
 export interface BlendOpts {
-    all_mode?: string;
-    all_opacity?: number;
-    all_expr?: string;
+    all_mode?: string | undefined;
+    all_opacity?: number | undefined;
+    all_expr?: Expr | undefined;
 }
 export interface Bm3dOpts {
-    sigma?: number;
-    block?: number;
-    bstep?: number;
-    group?: number;
-    range?: number;
-    mstep?: number;
-    thmse?: number;
-    hdthr?: number;
-    estim?: 'basic' | 'final';
+    sigma?: number | undefined;
+    block?: number | undefined;
+    bstep?: number | undefined;
+    group?: number | undefined;
+    range?: number | undefined;
+    mstep?: number | undefined;
+    thmse?: number | undefined;
+    hdthr?: number | undefined;
+    estim?: 'basic' | 'final' | undefined;
 }
 export interface BoxblurOpts {
-    luma_radius?: string;
-    chroma_radius?: string;
-    luma_power?: number;
-    chroma_power?: number;
+    luma_radius?: string | undefined;
+    chroma_radius?: string | undefined;
+    luma_power?: number | undefined;
+    chroma_power?: number | undefined;
 }
 export interface CasOpts {
     /** @range [0, 1] */
-    strength?: number;
-    planes?: number;
+    strength?: number | undefined;
+    planes?: number | undefined;
 }
 export interface ChannelmapOpts {
-    map?: string;
-    channel_layout?: string;
+    map?: string | undefined;
+    channel_layout?: string | undefined;
 }
 export interface ChorusOpts {
-    in_gain?: number;
-    out_gain?: number;
-    delays?: string;
-    speeds?: string;
-    depths?: string;
-    decays?: string;
+    in_gain?: number | undefined;
+    out_gain?: number | undefined;
+    delays?: string | undefined;
+    speeds?: string | undefined;
+    depths?: string | undefined;
+    decays?: string | undefined;
 }
 export interface ChromakeyOpts {
-    color: string;
+    color: FFmpegColor;
     /** @range [0, 1] */
-    similarity?: number;
+    similarity?: number | undefined;
     /** @range [0, 1] */
-    blend?: number;
+    blend?: number | undefined;
 }
 export interface ClassifyAudioEventOpts {
-    model?: string;
+    model?: string | undefined;
     /** @range [0, 1] */
-    threshold?: number;
+    threshold?: number | undefined;
     /** @range greater than 0 */
-    window_seconds?: number;
+    window_seconds?: number | undefined;
     /** @range greater than 0 */
-    hop_seconds?: number;
+    hop_seconds?: number | undefined;
 }
 export interface ClassifyDetectionsOpts {
     model: string;
     /** @range [0, 1] */
-    crop_region?: number;
+    crop_region?: number | undefined;
     /** @range at least 0 */
-    padding?: number;
-    attribute?: string;
+    padding?: number | undefined;
+    attribute?: string | undefined;
     /** @range [0, 1] */
-    threshold?: number;
-    labels?: string;
-    crop_anchor?: string;
+    threshold?: number | undefined;
+    labels?: string | undefined;
+    crop_anchor?: string | undefined;
     /** @range [0, 1] */
-    crop_height_ratio?: number;
-    norm?: string;
+    crop_height_ratio?: number | undefined;
+    norm?: string | undefined;
 }
 export interface ClassifySceneOpts {
-    model?: string;
+    model?: string | undefined;
     /** @range [0, 1] */
-    threshold?: number;
+    threshold?: number | undefined;
     /** @range greater than 0 */
-    top_k?: number;
-    batchSize?: number;
+    top_k?: number | undefined;
+    batchSize?: number | undefined;
 }
 export interface ColorCorrectOpts {
     model: string;
     /** @range [0, 1] */
-    strength?: number;
+    strength?: number | undefined;
 }
 export interface ColorbalanceOpts {
-    rs?: number;
-    gs?: number;
-    bs?: number;
-    rm?: number;
-    gm?: number;
-    bm?: number;
-    rh?: number;
-    gh?: number;
-    bh?: number;
+    rs?: number | undefined;
+    gs?: number | undefined;
+    bs?: number | undefined;
+    rm?: number | undefined;
+    gm?: number | undefined;
+    bm?: number | undefined;
+    rh?: number | undefined;
+    gh?: number | undefined;
+    bh?: number | undefined;
 }
 export interface ColorchannelmixerOpts {
-    rr?: number;
-    rg?: number;
-    rb?: number;
-    ra?: number;
-    gr?: number;
-    gg?: number;
-    gb?: number;
-    ga?: number;
-    br?: number;
-    bg?: number;
-    bb?: number;
-    ba?: number;
-    ar?: number;
-    ag?: number;
-    ab?: number;
-    aa?: number;
+    rr?: number | undefined;
+    rg?: number | undefined;
+    rb?: number | undefined;
+    ra?: number | undefined;
+    gr?: number | undefined;
+    gg?: number | undefined;
+    gb?: number | undefined;
+    ga?: number | undefined;
+    br?: number | undefined;
+    bg?: number | undefined;
+    bb?: number | undefined;
+    ba?: number | undefined;
+    ar?: number | undefined;
+    ag?: number | undefined;
+    ab?: number | undefined;
+    aa?: number | undefined;
 }
 export interface ColorgradeOpts {
-    lut?: string;
+    lut?: string | undefined;
 }
 export interface ColorholdOpts {
-    color: string;
-    similarity?: number;
-    blend?: number;
+    color: FFmpegColor;
+    similarity?: number | undefined;
+    blend?: number | undefined;
 }
 export interface ColorizeOpts {
     model: string;
     /** @range greater than 0 */
-    saturation?: number;
+    saturation?: number | undefined;
     /** @range [0, 1] */
-    temporal_stability?: number;
+    temporal_stability?: number | undefined;
 }
 export interface ColorkeyOpts {
-    color: string;
+    color: FFmpegColor;
     /** @range [0, 1] */
-    similarity?: number;
+    similarity?: number | undefined;
     /** @range [0, 1] */
-    blend?: number;
+    blend?: number | undefined;
 }
 export interface ColorspaceOpts {
-    all?: 'bt470m' | 'bt470bg' | 'bt601-6-525' | 'bt601-6-625' | 'bt709' | 'smpte170m' | 'smpte240m' | 'bt2020';
-    space?: string;
-    trc?: string;
-    primaries?: string;
-    range?: 'tv' | 'mpeg' | 'pc' | 'jpeg';
-    format?: string;
-    fast?: number;
-    iall?: string;
-    ispace?: string;
-    itrc?: string;
-    iprimaries?: string;
-    irange?: 'tv' | 'mpeg' | 'pc' | 'jpeg';
+    all?: 'bt470m' | 'bt470bg' | 'bt601-6-525' | 'bt601-6-625' | 'bt709' | 'smpte170m' | 'smpte240m' | 'bt2020' | undefined;
+    space?: string | undefined;
+    trc?: string | undefined;
+    primaries?: string | undefined;
+    range?: 'tv' | 'mpeg' | 'pc' | 'jpeg' | undefined;
+    format?: string | undefined;
+    fast?: number | undefined;
+    iall?: string | undefined;
+    ispace?: string | undefined;
+    itrc?: string | undefined;
+    iprimaries?: string | undefined;
+    irange?: 'tv' | 'mpeg' | 'pc' | 'jpeg' | undefined;
 }
 export interface ColortemperatureOpts {
     temperature: number;
 }
 export interface CompandOpts {
-    attacks?: string;
-    decays?: string;
-    points?: string;
-    'soft-knee'?: number;
-    gain?: number;
-    volume?: number;
-    delay?: number;
+    attacks?: string | undefined;
+    decays?: string | undefined;
+    points?: string | undefined;
+    'soft-knee'?: number | undefined;
+    gain?: number | undefined;
+    volume?: number | undefined;
+    delay?: number | undefined;
 }
 export interface ComputeAnglesOpts {
-    angles?: string;
+    angles?: string | undefined;
 }
 export interface ConcatOpts {
-    a?: number;
-    v?: number;
+    a?: number | undefined;
+    v?: number | undefined;
 }
 export interface ContainsDetectionsOpts {
     /** @range [0, 1] */
-    min_containment?: number;
-    region?: string;
+    min_containment?: number | undefined;
+    region?: string | undefined;
 }
 export interface CountOpts {
-    aggregate?: 'sum' | 'avg' | 'max' | 'min';
+    aggregate?: 'sum' | 'avg' | 'max' | 'min' | undefined;
 }
 export interface CropOpts {
     /** @range greater than 0 */
-    w?: number | string;
+    w?: number | Expr | undefined;
     /** @range greater than 0 */
-    h?: number | string;
-    x?: number | string;
-    y?: number | string;
+    h?: number | Expr | undefined;
+    x?: number | Expr | undefined;
+    y?: number | Expr | undefined;
 }
 export interface CrossfeedOpts {
-    strength?: number;
-    range?: number;
-    slope?: number;
-    level_in?: number;
-    level_out?: number;
+    strength?: number | undefined;
+    range?: number | undefined;
+    slope?: number | undefined;
+    level_in?: number | undefined;
+    level_out?: number | undefined;
 }
 export interface CurvesOpts {
     preset: 'none' | 'color_negative' | 'cross_process' | 'darker' | 'increase_contrast' | 'lighter' | 'linear_contrast' | 'medium_contrast' | 'negative' | 'strong_contrast' | 'vintage';
 }
 export interface DebandOpts {
-    '1thr'?: number;
-    range?: number;
-    blur?: boolean;
+    '1thr'?: number | undefined;
+    range?: number | undefined;
+    blur?: boolean | undefined;
 }
 export interface DeblockOpts {
-    strong?: boolean;
+    strong?: boolean | undefined;
 }
 export interface DeblurOpts {
     model: string;
     /** @range [0, 1] */
-    strength?: number;
+    strength?: number | undefined;
 }
 export interface DeesserOpts {
-    i?: number;
-    m?: number;
-    f?: number;
-    s?: 'i' | 'o' | 'e';
+    i?: number | undefined;
+    m?: number | undefined;
+    f?: number | undefined;
+    s?: 'i' | 'o' | 'e' | undefined;
 }
 export interface DeflickerOpts {
-    size?: number;
-    mode?: string;
+    size?: number | undefined;
+    mode?: string | undefined;
 }
 export interface DeinterlaceOpts {
     model: string;
@@ -390,242 +416,251 @@ export interface DelogoOpts {
 export interface DenoiseOpts {
     model: string;
     /** @range [0, 1] */
-    strength?: number;
+    strength?: number | undefined;
 }
 export interface DenoiseHqdn3dOpts {
-    strength?: number;
+    strength?: number | undefined;
 }
 export interface DensityOverlayOpts {
-    colormap?: string;
+    colormap?: string | undefined;
     /** @range [0, 1] */
-    alpha?: number;
+    alpha?: number | undefined;
 }
 export interface DepthBlurOpts {
     /** @range at least 0 */
-    max_blur?: number;
-    near_plane?: number;
-    far_plane?: number;
+    max_blur?: number | undefined;
+    near_plane?: number | undefined;
+    far_plane?: number | undefined;
 }
 export interface DepthFogOpts {
     /** @range [0, 1] */
-    density?: number;
-    color?: string;
-    near_plane?: number;
-    far_plane?: number;
+    density?: number | undefined;
+    color?: FFmpegColor | undefined;
+    near_plane?: number | undefined;
+    far_plane?: number | undefined;
 }
 export interface DeshakeOpts {
-    rx?: number;
-    ry?: number;
+    rx?: number | undefined;
+    ry?: number | undefined;
 }
 export interface DetectOpts {
     model: string;
     /** @range [0, 1] */
-    threshold?: number;
-    classes?: string;
-    filter_classes?: string;
-    inputSize?: string;
-    stride?: number;
-    batchSize?: number;
+    threshold?: number | undefined;
+    classes?: string | undefined;
+    filter_classes?: string | undefined;
+    inputSize?: string | undefined;
+    stride?: number | undefined;
+    batchSize?: number | undefined;
 }
 export interface DialoguenhanceOpts {
-    original?: number;
-    enhance?: number;
-    voice?: number;
+    original?: number | undefined;
+    enhance?: number | undefined;
+    voice?: number | undefined;
 }
 export interface DiarizeOpts {
     /** @range greater than 0 */
-    max_speakers?: number;
+    max_speakers?: number | undefined;
     /** @range at least 0 */
-    min_duration?: number;
+    min_duration?: number | undefined;
 }
 export interface DilationOpts {
-    threshold0?: number;
-    threshold1?: number;
-    threshold2?: number;
-    threshold3?: number;
-    coordinates?: number;
+    threshold0?: number | undefined;
+    threshold1?: number | undefined;
+    threshold2?: number | undefined;
+    threshold3?: number | undefined;
+    coordinates?: number | undefined;
 }
 export interface DrawSkeletonOpts {
     /** @range greater than 0 */
-    line_width?: number;
+    line_width?: number | undefined;
     /** @range greater than 0 */
-    keypoint_radius?: number;
-    color?: string;
+    keypoint_radius?: number | undefined;
+    color?: FFmpegColor | undefined;
     /** @range [0, 1] */
-    min_confidence?: number;
-    show_labels?: boolean;
+    min_confidence?: number | undefined;
+    show_labels?: boolean | undefined;
 }
 export interface DrawboxOpts {
-    x?: number | string;
-    y?: number | string;
-    w?: number | string;
-    h?: number | string;
-    color?: string;
-    t?: string;
-    enable?: string;
+    x?: number | Expr | undefined;
+    y?: number | Expr | undefined;
+    w?: number | Expr | undefined;
+    h?: number | Expr | undefined;
+    color?: FFmpegColor | undefined;
+    t?: string | undefined;
+    enable?: Expr | undefined;
 }
 export interface DrawgridOpts {
-    x?: string;
-    y?: string;
-    w?: string;
-    h?: string;
-    color?: string;
-    t?: string;
-    replace?: number;
-}
-export interface DrawtextOpts {
-    text?: string;
-    textfile?: string;
-    fontfile?: string;
-    fontsize?: number | string;
-    fontcolor?: string;
-    x?: number | string;
-    y?: number | string;
-    boxcolor?: string;
-    borderw?: number;
-    shadowcolor?: string;
-    shadowx?: number;
-    shadowy?: number;
-    alpha?: number | string;
-    font?: string;
-    line_spacing?: number;
-    enable?: string;
-    expansion?: 'none' | 'normal' | 'strftime';
-}
+    x?: string | undefined;
+    y?: string | undefined;
+    w?: string | undefined;
+    h?: string | undefined;
+    color?: FFmpegColor | undefined;
+    t?: string | undefined;
+    replace?: number | undefined;
+}
+/** `align` and `x`/`y` are mutually exclusive — supply one or the other. */
+export type DrawtextOpts = {
+    text?: string | undefined;
+    textfile?: string | undefined;
+    fontfile?: string | undefined;
+    fontsize?: number | Expr | undefined;
+    fontcolor?: FFmpegColor | undefined;
+    box?: number | undefined;
+    boxcolor?: FFmpegColor | undefined;
+    boxborderw?: number | undefined;
+    borderw?: number | undefined;
+    shadowcolor?: FFmpegColor | undefined;
+    shadowx?: number | undefined;
+    shadowy?: number | undefined;
+    alpha?: number | Expr | undefined;
+    font?: string | undefined;
+    line_spacing?: number | undefined;
+    enable?: Expr | undefined;
+    expansion?: 'none' | 'normal' | 'strftime' | undefined;
+} & ({
+    align?: 'top-left' | 'top' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom' | 'bottom-right' | undefined;
+    x?: never;
+    y?: never;
+} | {
+    align?: never;
+    x?: number | Expr | undefined;
+    y?: number | Expr | undefined;
+});
 export interface DynamicCropOpts {
     /** @range greater than 0 */
     target_aspect_w: number;
     /** @range greater than 0 */
     target_aspect_h: number;
     /** @range [0, 1] */
-    smoothing?: number;
+    smoothing?: number | undefined;
     /** @range at least 0 */
-    padding?: number;
-    subject?: string;
+    padding?: number | undefined;
+    subject?: string | undefined;
 }
 export interface DynaudnormOpts {
-    framelen?: number;
-    gausssize?: number;
-    peak?: number;
-    maxgain?: number;
-    targetrms?: number;
-    compress?: number;
-    threshold?: number;
+    framelen?: number | undefined;
+    gausssize?: number | undefined;
+    peak?: number | undefined;
+    maxgain?: number | undefined;
+    targetrms?: number | undefined;
+    compress?: number | undefined;
+    threshold?: number | undefined;
 }
 export interface EdgedetectOpts {
-    low?: number;
-    high?: number;
-    mode?: 'wires' | 'colormix' | 'canny';
+    low?: number | undefined;
+    high?: number | undefined;
+    mode?: 'wires' | 'colormix' | 'canny' | undefined;
 }
 export interface EqOpts {
     /** @range [-1, 1] */
-    brightness?: number;
+    brightness?: number | undefined;
     /** @range [-1000, 1000] */
-    contrast?: number;
+    contrast?: number | undefined;
     /** @range [0, 3] */
-    saturation?: number;
+    saturation?: number | undefined;
     /** @range [0.1, 10] */
-    gamma?: number;
+    gamma?: number | undefined;
 }
 export interface EqualizerOpts {
     f: number;
-    width_type?: 'h' | 'q' | 'o' | 's' | 'k';
+    width_type?: 'h' | 'q' | 'o' | 's' | 'k' | undefined;
     width: number;
     gain: number;
 }
 export interface ErosionOpts {
-    threshold0?: number;
-    threshold1?: number;
-    threshold2?: number;
-    threshold3?: number;
-    coordinates?: number;
+    threshold0?: number | undefined;
+    threshold1?: number | undefined;
+    threshold2?: number | undefined;
+    threshold3?: number | undefined;
+    coordinates?: number | undefined;
 }
 export interface EstimateDensityOpts {
-    model?: string;
+    model?: string | undefined;
 }
 export interface EstimateDepthOpts {
-    model?: string;
+    model?: string | undefined;
 }
 export interface EstimatePoseOpts {
-    model?: string;
+    model?: string | undefined;
     /** @range [0, 1] */
-    threshold?: number;
+    threshold?: number | undefined;
     /** @range greater than 0 */
-    max_persons?: number;
+    max_persons?: number | undefined;
 }
 export interface EstimatePoseDetectionsOpts {
     model: string;
     /** @range at least 0 */
-    threshold?: number;
+    threshold?: number | undefined;
     /** @range at least 0 */
-    padding?: number;
+    padding?: number | undefined;
 }
 export interface FadeOpts {
     type: 'in' | 'out';
     /** @range at least 0 */
-    st?: number;
+    st?: number | undefined;
     /** @range greater than 0 */
-    d?: number;
-    color?: string;
-    alpha?: number;
+    d?: number | undefined;
+    color?: FFmpegColor | undefined;
+    alpha?: number | undefined;
 }
 export interface FillbordersOpts {
-    left?: number;
-    right?: number;
-    top?: number;
-    bottom?: number;
-    mode?: 'smear' | 'mirror' | 'fixed' | 'reflect' | 'wrap' | 'fade' | 'margins';
-    color?: string;
+    left?: number | undefined;
+    right?: number | undefined;
+    top?: number | undefined;
+    bottom?: number | undefined;
+    mode?: 'smear' | 'mirror' | 'fixed' | 'reflect' | 'wrap' | 'fade' | 'margins' | undefined;
+    color?: FFmpegColor | undefined;
 }
 export interface FilterAudioEventsOpts {
-    include?: string;
-    exclude?: string;
+    include?: string | undefined;
+    exclude?: string | undefined;
     /** @range [0, 1] */
-    min_confidence?: number;
+    min_confidence?: number | undefined;
     /** @range at least 0 */
-    min_duration?: number;
+    min_duration?: number | undefined;
 }
 export interface FilterDetectionsOpts {
-    include?: string;
-    exclude?: string;
+    include?: string | undefined;
+    exclude?: string | undefined;
     /** @range [0, 1] */
-    min_confidence?: number;
+    min_confidence?: number | undefined;
     /** @range [0, 1] */
-    min_area?: number;
+    min_area?: number | undefined;
     /** @range at least 0 */
-    min_track_frames?: number;
-    attribute?: string;
-    attribute_value?: string;
-    attribute_absent?: string;
+    min_track_frames?: number | undefined;
+    attribute?: string | undefined;
+    attribute_value?: string | undefined;
+    attribute_absent?: string | undefined;
     /** @range at least 0 */
-    track_id?: number;
+    track_id?: number | undefined;
     /** @range at least 0 */
-    exclude_track_id?: number;
+    exclude_track_id?: number | undefined;
 }
 export interface FilterPosesOpts {
     /** @range [0, 1] */
-    min_score?: number;
+    min_score?: number | undefined;
     /** @range greater than 0 */
-    max_persons?: number;
+    max_persons?: number | undefined;
 }
 export interface FilterScenesOpts {
     /** @range [0, 1] */
-    min_confidence?: number;
+    min_confidence?: number | undefined;
 }
 export interface FilterSegmentationOpts {
-    classes?: string;
+    classes?: string | undefined;
     /** @range at least 0 */
-    min_area?: number;
+    min_area?: number | undefined;
 }
 export interface FilterTextOpts {
     /** @range [0, 1] */
-    min_confidence?: number;
-    pattern?: string;
+    min_confidence?: number | undefined;
+    pattern?: string | undefined;
 }
 export interface FlangerOpts {
-    delay?: number;
-    depth?: number;
-    speed?: number;
+    delay?: number | undefined;
+    depth?: number | undefined;
+    speed?: number | undefined;
 }
 export interface FormatOpts {
     pix_fmts: string;
@@ -637,81 +672,81 @@ export interface FpsOpts {
 export interface FrameInterpolateOpts {
     model: string;
     /** @range greater than 0 */
-    factor?: number;
+    factor?: number | undefined;
 }
 export interface FramestepOpts {
     /** @range at least 1 */
     step: number;
 }
 export interface FreezedetectOpts {
-    noise?: number;
-    duration?: number;
+    noise?: number | undefined;
+    duration?: number | undefined;
 }
 export interface GblurOpts {
     /** @range greater than 0 */
     sigma: number;
 }
 export interface GeqOpts {
-    r?: string;
-    g?: string;
-    b?: string;
-    a?: string;
-    lum_expr?: string;
+    r?: string | undefined;
+    g?: string | undefined;
+    b?: string | undefined;
+    a?: string | undefined;
+    lum_expr?: string | undefined;
 }
 export interface HighpassOpts {
     f: number;
 }
 export interface HistogramOpts {
-    level_height?: number;
-    display_mode?: 'stack' | 'parade' | 'overlay';
-    levels_mode?: 'logarithmic' | 'linear';
+    level_height?: number | undefined;
+    display_mode?: 'stack' | 'parade' | 'overlay' | undefined;
+    levels_mode?: 'logarithmic' | 'linear' | undefined;
 }
 export interface Hqdn3dOpts {
-    luma_spatial?: number;
-    chroma_spatial?: number;
-    luma_tmp?: number;
-    chroma_tmp?: number;
+    luma_spatial?: number | undefined;
+    chroma_spatial?: number | undefined;
+    luma_tmp?: number | undefined;
+    chroma_tmp?: number | undefined;
 }
 export interface HstackOpts {
-    shortest?: boolean;
+    shortest?: boolean | undefined;
 }
 export interface HueOpts {
-    h?: number | string;
-    s?: number | string;
-    b?: number | string;
+    h?: number | Expr | undefined;
+    s?: number | Expr | undefined;
+    b?: number | Expr | undefined;
 }
 export interface InsertChaptersOpts {
     /** @range at least 0 */
-    min_duration?: number;
-    format?: string;
+    min_duration?: number | undefined;
+    format?: string | undefined;
 }
 export interface IntersectionDetectionsOpts {
     /** @range [0, 1] */
-    iou_threshold?: number;
+    iou_threshold?: number | undefined;
 }
 export interface LagfunOpts {
-    decay?: number;
-    planes?: number;
+    decay?: number | undefined;
+    planes?: number | undefined;
 }
 export interface LenscorrectionOpts {
-    cx?: number;
-    cy?: number;
-    k1?: number;
-    k2?: number;
-    i?: 'nearest' | 'bilinear';
+    cx?: number | undefined;
+    cy?: number | undefined;
+    k1?: number | undefined;
+    k2?: number | undefined;
+    i?: 'nearest' | 'bilinear' | undefined;
 }
 export interface LoopOpts {
     loop: number;
-    size?: number;
-    start?: number;
+    size?: number | undefined;
+    start?: number | undefined;
 }
 export interface LoudnormOpts {
     /** @range [-70, -5] */
-    I?: number;
+    I?: number | undefined;
     /** @range [-9, 0] */
-    TP?: number;
+    TP?: number | undefined;
     /** @range [1, 50] */
-    LRA?: number;
+    LRA?: number | undefined;
 }
 export interface LowpassOpts {
     f: number;
@@ -724,393 +759,447 @@ export interface Lut3dOpts {
 }
 export interface MaskBlurOpts {
     /** @range at least 0 */
-    radius?: number;
+    radius?: number | undefined;
     /** @range at least 0 */
-    sigma?: number;
-    invert?: boolean;
+    sigma?: number | undefined;
+    invert?: boolean | undefined;
 }
 export interface MaskColorGradeOpts {
-    saturation?: number;
-    brightness?: number;
-    contrast?: number;
-    hue?: number;
-    invert?: boolean;
+    saturation?: number | undefined;
+    brightness?: number | undefined;
+    contrast?: number | undefined;
+    hue?: number | undefined;
+    invert?: boolean | undefined;
 }
 export interface MaskCompositeOpts {
-    mode?: 'replace' | 'overlay' | 'multiply';
-    background?: string;
+    mode?: 'replace' | 'overlay' | 'multiply' | undefined;
+    background?: string | undefined;
     /** @range [0, 1] */
-    opacity?: number;
+    opacity?: number | undefined;
 }
 export interface MinterpolateOpts {
-    fps?: number;
-    mi_mode?: 'dup' | 'blend' | 'mci';
-    mc_mode?: 'obmc' | 'aobmc';
-    me_mode?: 'bidir' | 'bilat';
-    me?: 'esa' | 'tss' | 'tdls' | 'ntss' | 'fss' | 'ds' | 'hexbs' | 'epzs' | 'umh';
-    mb_size?: number;
-    search_param?: number;
-    scd?: 'none' | 'fdiff';
-    scd_threshold?: number;
+    fps?: number | undefined;
+    mi_mode?: 'dup' | 'blend' | 'mci' | undefined;
+    mc_mode?: 'obmc' | 'aobmc' | undefined;
+    me_mode?: 'bidir' | 'bilat' | undefined;
+    me?: 'esa' | 'tss' | 'tdls' | 'ntss' | 'fss' | 'ds' | 'hexbs' | 'epzs' | 'umh' | undefined;
+    mb_size?: number | undefined;
+    search_param?: number | undefined;
+    scd?: 'none' | 'fdiff' | undefined;
+    scd_threshold?: number | undefined;
+}
+export interface MotionRedactOpts {
+    mode?: 'black' | 'blur' | 'pixelate' | undefined;
+    /** @range greater than 0 */
+    radius?: number | undefined;
+    /** @range [1, 255] */
+    sensitivity?: number | undefined;
+    /** @range greater than 0 */
+    decay_secs?: number | undefined;
+    /** @range at least 0 */
+    dilate_px?: number | undefined;
+    /** @range at least 0 */
+    warmup_secs?: number | undefined;
+    /** @range [0, 1] */
+    learning_rate?: number | undefined;
+    /** @range greater than 0 */
+    fps?: number | undefined;
 }
 export interface MpdecimateOpts {
-    max?: number;
-    lo?: number;
-    hi?: number;
-    frac?: number;
+    max?: number | undefined;
+    lo?: number | undefined;
+    hi?: number | undefined;
+    frac?: number | undefined;
 }
 export interface NegateOpts {
-    negate?: number;
-    alpha?: number;
+    negate?: number | undefined;
+    alpha?: number | undefined;
 }
 export interface NlmeansOpts {
-    s?: number;
+    s?: number | undefined;
 }
 export interface NoiseOpts {
     /** @range [0, 100] */
-    alls?: number;
-    allf?: string;
-    seed?: number;
+    alls?: number | undefined;
+    allf?: string | undefined;
+    seed?: number | undefined;
 }
-export interface OverlayOpts {
-    x?: number | string;
-    y?: number | string;
+/** `align` and `x`/`y` are mutually exclusive — supply one or the other. */
+export type OverlayOpts = {
     /** @range [0, 1] */
-    alpha?: number;
-}
+    alpha?: number | undefined;
+} & ({
+    align?: 'top-left' | 'top' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom' | 'bottom-right' | undefined;
+    x?: never;
+    y?: never;
+} | {
+    align?: never;
+    x?: number | Expr | undefined;
+    y?: number | Expr | undefined;
+});
 export interface OverlayTranslationOpts {
     target_language: string;
-    font_family?: string;
+    font_family?: string | undefined;
     /** @range greater than 0 */
-    font_size?: number;
-    background_color?: string;
+    font_size?: number | undefined;
+    background_color?: FFmpegColor | undefined;
 }
-export interface PadOpts {
+/** `align` and `x`/`y` are mutually exclusive — supply one or the other. */
+export type PadOpts = {
     /** @range greater than 0 */
-    w?: number | string;
+    w?: number | Expr | undefined;
     /** @range greater than 0 */
-    h?: number | string;
-    x?: number | string;
-    y?: number | string;
-    color?: string;
-}
+    h?: number | Expr | undefined;
+    color?: FFmpegColor | undefined;
+} & ({
+    align?: 'top-left' | 'top' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom' | 'bottom-right' | undefined;
+    x?: never;
+    y?: never;
+} | {
+    align?: never;
+    x?: number | Expr | undefined;
+    y?: number | Expr | undefined;
+});
 export interface PalettegenOpts {
-    max_colors?: number;
-    reserve_transparent?: number;
-    stats_mode?: 'full' | 'diff' | 'single';
+    max_colors?: number | undefined;
+    reserve_transparent?: number | undefined;
+    stats_mode?: 'full' | 'diff' | 'single' | undefined;
 }
 export interface PaletteuseOpts {
-    dither?: 'bayer' | 'heckbert' | 'floyd_steinberg' | 'sierra2' | 'sierra2_4a' | 'sierra3' | 'burkes' | 'atkinson' | 'none';
-    bayer_scale?: number;
-    diff_mode?: 'rectangle' | 'none';
-    new?: number;
+    dither?: 'bayer' | 'heckbert' | 'floyd_steinberg' | 'sierra2' | 'sierra2_4a' | 'sierra3' | 'burkes' | 'atkinson' | 'none' | undefined;
+    bayer_scale?: number | undefined;
+    diff_mode?: 'rectangle' | 'none' | undefined;
+    new?: number | undefined;
 }
 export interface PanOpts {
     layout: string;
 }
 export interface ParallaxOpts {
     /** @range at least 0 */
-    amplitude?: number;
-    direction?: 'horizontal' | 'vertical' | 'zoom';
-    duration?: number;
+    amplitude?: number | undefined;
+    direction?: 'horizontal' | 'vertical' | 'zoom' | undefined;
+    duration?: number | undefined;
 }
 export interface PerspectiveOpts {
-    x0?: string;
-    y0?: string;
-    x1?: string;
-    y1?: string;
-    x2?: string;
-    y2?: string;
-    x3?: string;
-    y3?: string;
-    interpolation?: 'linear' | 'cubic';
-    sense?: 'source' | 'destination';
+    x0?: string | undefined;
+    y0?: string | undefined;
+    x1?: string | undefined;
+    y1?: string | undefined;
+    x2?: string | undefined;
+    y2?: string | undefined;
+    x3?: string | undefined;
+    y3?: string | undefined;
+    interpolation?: 'linear' | 'cubic' | undefined;
+    sense?: 'source' | 'destination' | undefined;
 }
 export interface PhotosensitivityOpts {
-    threshold?: number;
-    frames?: number;
-    skip?: number;
+    threshold?: number | undefined;
+    frames?: number | undefined;
+    skip?: number | undefined;
 }
 export interface PseudocolorOpts {
-    preset?: string;
-    c0?: string;
-    c1?: string;
-    c2?: string;
-    c3?: string;
-    index?: number;
-    opacity?: number;
+    preset?: string | undefined;
+    c0?: string | undefined;
+    c1?: string | undefined;
+    c2?: string | undefined;
+    c3?: string | undefined;
+    index?: number | undefined;
+    opacity?: number | undefined;
 }
 export interface PsnrOpts {
-    stats_file?: string;
+    stats_file?: string | undefined;
 }
 export interface RecognizeTextOpts {
-    model?: string;
+    model?: string | undefined;
     /** @range [0, 1] */
-    threshold?: number;
+    threshold?: number | undefined;
 }
 export interface RecognizeTextInOpts {
     model: string;
     /** @range [0, 1] */
-    threshold?: number;
+    threshold?: number | undefined;
     /** @range at least 0 */
-    padding?: number;
+    padding?: number | undefined;
 }
-export interface RedactOpts {
-    mode?: 'blur' | 'pixelate' | 'black';
+/** Variants by `mode`: 'blur' requires `radius`; 'black' forbids `radius`. */
+export type RedactOpts = ({
+    mode?: never;
     /** @range at least 0 */
-    radius?: number;
-}
-export interface RedactTextOpts {
-    mode?: 'blur' | 'pixelate' | 'black';
+    radius?: number | undefined;
+} | {
+    mode: 'blur';
     /** @range at least 0 */
-    radius?: number;
+    radius: number;
+} | {
+    mode: 'pixelate';
     /** @range at least 0 */
-    padding?: number;
-}
+    radius?: number | undefined;
+} | {
+    mode: 'black';
+    radius?: never;
+});
+/** Variants by `mode`: 'blur' requires `radius`; 'black' forbids `radius`. */
+export type RedactTextOpts = {
+    /** @range at least 0 */
+    padding?: number | undefined;
+} & ({
+    mode?: never;
+    /** @range at least 0 */
+    radius?: number | undefined;
+} | {
+    mode: 'blur';
+    /** @range at least 0 */
+    radius: number;
+} | {
+    mode: 'pixelate';
+    /** @range at least 0 */
+    radius?: number | undefined;
+} | {
+    mode: 'black';
+    radius?: never;
+});
 export interface RedactTracksOpts {
     tracks: string;
 }
 export interface RenderHeatmapOpts {
-    colormap?: string;
+    colormap?: string | undefined;
     /** @range [0, 1] */
-    alpha?: number;
+    alpha?: number | undefined;
     /** @range greater than 0 */
-    radius?: number;
-    blur?: number;
+    radius?: number | undefined;
+    blur?: number | undefined;
 }
 export interface ResizeOpts {
     w: number;
     h: number;
 }
 export interface RgbashiftOpts {
-    rh?: number;
-    rv?: number;
-    gh?: number;
-    gv?: number;
-    bh?: number;
-    bv?: number;
-    ah?: number;
-    av?: number;
-    edge?: 'smear' | 'wrap';
-    enable?: string;
+    rh?: number | undefined;
+    rv?: number | undefined;
+    gh?: number | undefined;
+    gv?: number | undefined;
+    bh?: number | undefined;
+    bv?: number | undefined;
+    ah?: number | undefined;
+    av?: number | undefined;
+    edge?: 'smear' | 'wrap' | undefined;
+    enable?: Expr | undefined;
 }
 export interface RotateOpts {
-    angle?: number | string;
-    a?: number | string;
-    fillcolor?: string;
-    bilinear?: number;
+    angle?: number | Expr | undefined;
+    a?: number | Expr | undefined;
+    fillcolor?: FFmpegColor | undefined;
+    bilinear?: number | undefined;
 }
 export interface RubberbandOpts {
-    tempo?: number;
-    pitch?: number;
-    transients?: 'crisp' | 'mixed' | 'smooth';
-    detector?: 'compound' | 'percussive' | 'soft';
-    phase?: 'laminar' | 'independent';
-    window?: 'standard' | 'short' | 'long';
-    smoothing?: 'off' | 'on';
-    formant?: 'shifted' | 'preserved';
-    pitchq?: 'quality' | 'speed' | 'consistency';
-    channels?: 'apart' | 'together';
+    tempo?: number | undefined;
+    pitch?: number | undefined;
+    transients?: 'crisp' | 'mixed' | 'smooth' | undefined;
+    detector?: 'compound' | 'percussive' | 'soft' | undefined;
+    phase?: 'laminar' | 'independent' | undefined;
+    window?: 'standard' | 'short' | 'long' | undefined;
+    smoothing?: 'off' | 'on' | undefined;
+    formant?: 'shifted' | 'preserved' | undefined;
+    pitchq?: 'quality' | 'speed' | 'consistency' | undefined;
+    channels?: 'apart' | 'together' | undefined;
 }
 export interface ScaleOpts {
-    /** @range greater than 0 */
     w: number;
-    /** @range greater than 0 */
     h: number;
-    force_original_aspect_ratio?: string;
-    flags?: string;
+    force_original_aspect_ratio?: string | undefined;
+    flags?: string | undefined;
 }
 export interface ScaleCudaOpts {
-    w?: string;
-    h?: string;
-    interp_algo?: 'nearest' | 'bilinear' | 'bicubic' | 'lanczos';
+    w?: string | undefined;
+    h?: string | undefined;
+    interp_algo?: 'nearest' | 'bilinear' | 'bicubic' | 'lanczos' | undefined;
 }
 export interface SceneColorGradeOpts {
-    preset?: string;
+    preset?: string | undefined;
     /** @range [0, 1] */
-    intensity?: number;
+    intensity?: number | undefined;
     /** @range at least 0 */
-    transition_frames?: number;
+    transition_frames?: number | undefined;
 }
 export interface SegmentOpts {
-    model?: string;
+    model?: string | undefined;
     /** @range [0, 1] */
-    threshold?: number;
-    pointsPerSide?: number;
+    threshold?: number | undefined;
+    pointsPerSide?: number | undefined;
 }
 export interface SelectOpts {
-    expr: string;
+    expr: Expr;
 }
 export interface SelectivecolorOpts {
-    correction_method?: 'absolute' | 'relative';
-    reds?: string;
-    yellows?: string;
-    greens?: string;
-    cyans?: string;
-    blues?: string;
-    magentas?: string;
-    whites?: string;
-    neutrals?: string;
-    blacks?: string;
+    correction_method?: 'absolute' | 'relative' | undefined;
+    reds?: string | undefined;
+    yellows?: string | undefined;
+    greens?: string | undefined;
+    cyans?: string | undefined;
+    blues?: string | undefined;
+    magentas?: string | undefined;
+    whites?: string | undefined;
+    neutrals?: string | undefined;
+    blacks?: string | undefined;
 }
 export interface SendcmdOpts {
-    filename?: string;
-    commands?: string;
+    filename?: string | undefined;
+    commands?: string | undefined;
 }
 export interface SetdarOpts {
     dar: string;
 }
 export interface SetptsOpts {
-    expr: string;
+    expr: Expr;
 }
 export interface SetsarOpts {
     sar: string;
 }
 export interface ShowcqtOpts {
-    s?: string;
-    fps?: number;
-    bar_h?: number;
-    axis_h?: number;
-    sono_h?: number;
-    fullhd?: number;
-    sono_v?: string;
-    bar_v?: string;
-    count?: number;
-    fcount?: number;
-    fontcolor?: string;
-    font?: string;
-    fontsize?: number;
+    s?: string | undefined;
+    fps?: number | undefined;
+    bar_h?: number | undefined;
+    axis_h?: number | undefined;
+    sono_h?: number | undefined;
+    fullhd?: number | undefined;
+    sono_v?: string | undefined;
+    bar_v?: string | undefined;
+    count?: number | undefined;
+    fcount?: number | undefined;
+    fontcolor?: FFmpegColor | undefined;
+    font?: string | undefined;
+    fontsize?: number | undefined;
 }
 export interface ShowspectrumOpts {
-    s?: string;
-    mode?: 'combined' | 'separate';
-    slide?: 'replace' | 'scroll' | 'fullframe' | 'rscroll';
-    color?: string;
-    scale?: 'lin' | 'log' | 'sqrt' | 'cbrt' | '5thrt' | '4thrt';
-    fscale?: 'lin' | 'log';
-    saturation?: number;
-    win_func?: string;
-    orientation?: 'vertical' | 'horizontal';
-    overlap?: number;
-    gain?: number;
-    data?: 'magnitude' | 'phase' | 'uphase';
-    rotation?: number;
-    start?: number;
-    stop?: number;
-    fps?: number;
-    legend?: number;
+    s?: string | undefined;
+    mode?: 'combined' | 'separate' | undefined;
+    slide?: 'replace' | 'scroll' | 'fullframe' | 'rscroll' | undefined;
+    color?: FFmpegColor | undefined;
+    scale?: 'lin' | 'log' | 'sqrt' | 'cbrt' | '5thrt' | '4thrt' | undefined;
+    fscale?: 'lin' | 'log' | undefined;
+    saturation?: number | undefined;
+    win_func?: string | undefined;
+    orientation?: 'vertical' | 'horizontal' | undefined;
+    overlap?: number | undefined;
+    gain?: number | undefined;
+    data?: 'magnitude' | 'phase' | 'uphase' | undefined;
+    rotation?: number | undefined;
+    start?: number | undefined;
+    stop?: number | undefined;
+    fps?: number | undefined;
+    legend?: number | undefined;
 }
 export interface ShowwavesOpts {
-    s?: string;
-    mode?: 'point' | 'line' | 'p2p' | 'cline';
-    rate?: number;
-    n?: number;
-    colors?: string;
-    scale?: 'lin' | 'log' | 'sqrt' | 'cbrt' | '5thrt';
-    draw?: 'full' | 'scale';
-    split_channels?: number;
+    s?: string | undefined;
+    mode?: 'point' | 'line' | 'p2p' | 'cline' | undefined;
+    rate?: number | undefined;
+    n?: number | undefined;
+    colors?: string | undefined;
+    scale?: 'lin' | 'log' | 'sqrt' | 'cbrt' | '5thrt' | undefined;
+    draw?: 'full' | 'scale' | undefined;
+    split_channels?: number | undefined;
 }
 export interface SidechaincompressOpts {
-    threshold?: number;
-    ratio?: number;
-    attack?: number;
-    release?: number;
-    level_sc?: number;
+    threshold?: number | undefined;
+    ratio?: number | undefined;
+    attack?: number | undefined;
+    release?: number | undefined;
+    level_sc?: number | undefined;
 }
 export interface SilencedetectOpts {
-    noise?: string;
-    d?: number;
+    noise?: string | undefined;
+    d?: number | undefined;
 }
 export interface SilenceremoveOpts {
-    stop_periods?: number;
-    stop_duration?: number;
-    stop_threshold?: string;
+    stop_periods?: number | undefined;
+    stop_duration?: number | undefined;
+    stop_threshold?: string | undefined;
 }
 export interface SlideshowOpts {
-    transition?: string;
-    duration?: number;
-    segment_duration?: number;
+    transition?: string | undefined;
+    duration?: number | undefined;
+    segment_duration?: number | undefined;
 }
 export interface SpeechnormOpts {
-    peak?: number;
-    expansion?: number;
-    compression?: number;
-    threshold?: number;
-    raise?: number;
-    fall?: number;
+    peak?: number | undefined;
+    expansion?: number | undefined;
+    compression?: number | undefined;
+    threshold?: number | undefined;
+    raise?: number | undefined;
+    fall?: number | undefined;
 }
 export interface SsimOpts {
-    stats_file?: string;
+    stats_file?: string | undefined;
 }
 export interface StereowidenOpts {
-    delay?: number;
-    feedback?: number;
-    crossfeed?: number;
+    delay?: number | undefined;
+    feedback?: number | undefined;
+    crossfeed?: number | undefined;
 }
 export interface SubtitlesOpts {
     filename: string;
-    fontsdir?: string;
-    force_style?: string;
-    charenc?: string;
-    stream_index?: number;
+    fontsdir?: string | undefined;
+    force_style?: string | undefined;
+    charenc?: string | undefined;
+    stream_index?: number | undefined;
 }
 export interface SurroundOpts {
-    chl_out?: string;
-    chl_in?: string;
-    level_in?: number;
-    level_out?: number;
-    lfe?: boolean;
-    lfe_low?: number;
-    lfe_high?: number;
-    fc_in?: number;
-    fc_out?: number;
-    fl_in?: number;
-    fl_out?: number;
-    fr_in?: number;
-    fr_out?: number;
-    bl_in?: number;
-    bl_out?: number;
-    br_in?: number;
-    br_out?: number;
-    lfe_in?: number;
-    lfe_out?: number;
+    chl_out?: string | undefined;
+    chl_in?: string | undefined;
+    level_in?: number | undefined;
+    level_out?: number | undefined;
+    lfe?: boolean | undefined;
+    lfe_low?: number | undefined;
+    lfe_high?: number | undefined;
+    fc_in?: number | undefined;
+    fc_out?: number | undefined;
+    fl_in?: number | undefined;
+    fl_out?: number | undefined;
+    fr_in?: number | undefined;
+    fr_out?: number | undefined;
+    bl_in?: number | undefined;
+    bl_out?: number | undefined;
+    br_in?: number | undefined;
+    br_out?: number | undefined;
+    lfe_in?: number | undefined;
+    lfe_out?: number | undefined;
 }
 export interface TblendOpts {
-    all_mode?: string;
-    all_opacity?: number;
-    all_expr?: string;
+    all_mode?: string | undefined;
+    all_opacity?: number | undefined;
+    all_expr?: Expr | undefined;
 }
 export interface ThumbnailOpts {
-    n?: number;
+    n?: number | undefined;
 }
 export interface TileOpts {
-    layout?: string;
-    nb_frames?: number;
-    padding?: number;
-    margin?: number;
-    color?: string;
+    layout?: string | undefined;
+    nb_frames?: number | undefined;
+    padding?: number | undefined;
+    margin?: number | undefined;
+    color?: FFmpegColor | undefined;
 }
 export interface TmixOpts {
-    frames?: number;
-    weights?: string;
-    scale?: number;
-    planes?: number;
+    frames?: number | undefined;
+    weights?: string | undefined;
+    scale?: number | undefined;
+    planes?: number | undefined;
 }
 export interface TpadOpts {
-    start?: number;
-    stop?: number;
-    start_mode?: 'add' | 'clone';
-    stop_mode?: 'add' | 'clone';
-    start_duration?: number;
-    stop_duration?: number;
-    color?: string;
+    start?: number | undefined;
+    stop?: number | undefined;
+    start_mode?: 'add' | 'clone' | undefined;
+    stop_mode?: 'add' | 'clone' | undefined;
+    start_duration?: number | undefined;
+    stop_duration?: number | undefined;
+    color?: FFmpegColor | undefined;
 }
 export interface TrackOpts {
     algorithm: 'bytetrack' | 'sort' | 'deepsort';
 }
 export interface TranscribeOpts {
-    model?: string;
-    language?: string;
+    model?: string | undefined;
+    language?: string | undefined;
 }
 export interface TransposeOpts {
     /** @range [0, 3] */
@@ -1118,128 +1207,129 @@ export interface TransposeOpts {
 }
 export interface TrebleOpts {
     gain: number;
-    frequency?: number;
-    width_type?: 'h' | 'q' | 'o' | 's' | 'k';
-    width?: number;
+    frequency?: number | undefined;
+    width_type?: 'h' | 'q' | 'o' | 's' | 'k' | undefined;
+    width?: number | undefined;
 }
 export interface TremoloOpts {
-    f?: number;
-    d?: number;
+    f?: number | undefined;
+    d?: number | undefined;
 }
 export interface TrimOpts {
     /** @range at least 0 */
-    start?: number;
+    start?: number | undefined;
     /** @range greater than 0 */
-    end?: number;
+    end?: number | undefined;
 }
 export interface UnsharpOpts {
-    luma_msize_x?: number;
-    luma_msize_y?: number;
-    luma_amount?: number;
+    luma_msize_x?: number | undefined;
+    luma_msize_y?: number | undefined;
+    luma_amount?: number | undefined;
 }
 export interface UpscaleOpts {
     model: string;
     /** @range greater than 0 */
-    scale?: number;
+    scale?: number | undefined;
     /** @range greater than 0 */
-    tileSize?: number;
+    tileSize?: number | undefined;
 }
 export interface V360Opts {
-    input?: string;
-    output?: string;
-    interp?: string;
-    w?: number;
-    h?: number;
-    yaw?: number;
-    pitch?: number;
-    roll?: number;
-    d_fov?: number;
-    id_fov?: number;
-    h_flip?: boolean;
-    v_flip?: boolean;
-    in_stereo?: string;
-    out_stereo?: string;
+    input?: string | undefined;
+    output?: string | undefined;
+    interp?: string | undefined;
+    w?: number | undefined;
+    h?: number | undefined;
+    yaw?: number | undefined;
+    pitch?: number | undefined;
+    roll?: number | undefined;
+    d_fov?: number | undefined;
+    id_fov?: number | undefined;
+    h_flip?: boolean | undefined;
+    v_flip?: boolean | undefined;
+    in_stereo?: string | undefined;
+    out_stereo?: string | undefined;
 }
 export interface VectorscopeOpts {
-    mode?: 'gray' | 'tint' | 'color' | 'color2' | 'color3' | 'color4' | 'color5';
-    intensity?: number;
-    envelope?: number;
+    mode?: 'gray' | 'tint' | 'color' | 'color2' | 'color3' | 'color4' | 'color5' | undefined;
+    intensity?: number | undefined;
+    envelope?: number | undefined;
 }
 export interface VibratoOpts {
-    f?: number;
-    d?: number;
+    f?: number | undefined;
+    d?: number | undefined;
 }
 export interface VidstabOpts {
-    shakiness?: number;
-    smoothing?: number;
+    shakiness?: number | undefined;
+    smoothing?: number | undefined;
 }
 export interface VidstabdetectOpts {
-    shakiness?: number;
-    accuracy?: number;
-    stepsize?: number;
-    mincontrast?: number;
-    result?: string;
+    shakiness?: number | undefined;
+    accuracy?: number | undefined;
+    stepsize?: number | undefined;
+    mincontrast?: number | undefined;
+    result?: string | undefined;
 }
 export interface VidstabtransformOpts {
-    input?: string;
-    smoothing?: number;
-    optalgo?: 'opt' | 'gauss' | 'avg';
-    maxshift?: number;
-    maxangle?: number;
-    crop?: 'keep' | 'black';
-    zoom?: number;
-    optzoom?: number;
-    interpol?: 'no' | 'linear' | 'bilinear' | 'bicubic';
+    input?: string | undefined;
+    smoothing?: number | undefined;
+    optalgo?: 'opt' | 'gauss' | 'avg' | undefined;
+    maxshift?: number | undefined;
+    maxangle?: number | undefined;
+    crop?: 'keep' | 'black' | undefined;
+    zoom?: number | undefined;
+    optzoom?: number | undefined;
+    interpol?: 'no' | 'linear' | 'bilinear' | 'bicubic' | undefined;
 }
 export interface VignetteOpts {
     /** @range [0, 1.5707963267948966] */
-    angle?: number;
+    angle?: number | undefined;
 }
 export interface VolumeOpts {
     /** @range at least 0 */
     volume: number;
 }
 export interface VstackOpts {
-    shortest?: boolean;
+    shortest?: boolean | undefined;
 }
 export interface WaveformOpts {
-    mode?: 'row' | 'column' | 'color' | 'color2' | 'acolor';
-    intensity?: number;
-    mirror?: number;
+    mode?: 'row' | 'column' | 'color' | 'color2' | 'acolor' | undefined;
+    intensity?: number | undefined;
+    mirror?: number | undefined;
 }
 export interface WeightedDetectionsOpts {
     /** @range at least 0 */
-    weight_a?: number;
+    weight_a?: number | undefined;
     /** @range at least 0 */
-    weight_b?: number;
+    weight_b?: number | undefined;
 }
 export interface XfadeOpts {
-    transition?: string;
-    duration?: number;
-    offset?: number;
+    transition?: string | undefined;
+    duration?: number | undefined;
+    offset?: number | undefined;
 }
 export interface XstackOpts {
-    layout?: string;
-    fill?: string;
+    layout?: string | undefined;
+    fill?: string | undefined;
 }
 export interface ZoneOpts {
-    polygon?: string;
-    anchor?: 'centroid' | 'bottom_center' | 'bbox';
-    invert?: boolean;
-    attribute?: string;
+    polygon?: string | undefined;
+    anchor?: 'centroid' | 'bottom_center' | 'bbox' | undefined;
+    invert?: boolean | undefined;
+    attribute?: string | undefined;
 }
 export interface ZoompanOpts {
-    z?: string;
-    x?: string;
-    y?: string;
+    z?: Expr | undefined;
+    x?: Expr | undefined;
+    y?: Expr | undefined;
     d: number;
-    fps?: number;
-    s?: string;
+    fps?: number | undefined;
+    s?: string | undefined;
 }
 /** @internal */
 export declare function mk(sort: SortTag, id: number, g: Graph): any;
-/** @internal — drop undefined so absent opts don't reach the wire. */
-export declare function _p(opts: object): Record<string, ParamValue>;
+/** @internal — drop undefined so absent opts don't reach the wire; when `op`
+ * is given, enforce the registry's numeric ranges (throws RangeError). */
+export declare function _p(opts: object, op?: string): Record<string, ParamValue>;
 export interface VideoStream {
     alphaextract(): VideoStream;
     anchorGraphic(b: PoseStream, opts: AnchorGraphicOpts): VideoStream;
@@ -1320,6 +1410,7 @@ export interface VideoStream {
     maskComposite(b: SegmentationStream, opts?: MaskCompositeOpts): VideoStream;
     maskedmerge(b: VideoStream): VideoStream;
     minterpolate(opts?: MinterpolateOpts): VideoStream;
+    motionRedact(opts?: MotionRedactOpts): VideoStream;
     mpdecimate(opts?: MpdecimateOpts): VideoStream;
     negate(opts?: NegateOpts): VideoStream;
     nlmeans(opts?: NlmeansOpts): VideoStream;
@@ -1400,6 +1491,7 @@ export interface AudioStream {
     aphaser(opts?: AphaserOpts): AudioStream;
     aresample(opts: AresampleOpts): AudioStream;
     areverse(): AudioStream;
+    asetpts(opts: AsetptsOpts): AudioStream;
     astats(opts?: AstatsOpts): AudioStream;
     asubboost(opts?: AsubboostOpts): AudioStream;
     atempo(opts: AtempoOpts): AudioStream;