import { type ReadableTransitionType, type TransitionType } from './transition-vocabulary';
import type { TransitionAlign } from './transition-plan';
export interface EditCut {
    audio?: false;
    mute?: unknown;
    in: number;
    out: number;
    src?: string;
    transform?: {
        x?: number;
        y?: number;
        scale?: number;
        scaleX?: number;
        scaleY?: number;
        rotate?: number;
    };
    opacity?: number;
    speed?: number;
    transitionOut?: {
        type: ReadableTransitionType;
        duration: number;
        [key: string]: unknown;
    };
    at?: number;
    track?: number;
    /**
     * 描画用の宣言だけが持つ（edit.json には書かない）。このクリップの最初のコマを、at の手前
     * headSeconds 秒のあいだ出しておく。at・in・out・表示の長さ・素材の時計には数えない。
     */
    transitionHold?: {
        headSeconds: number;
    };
}
export interface EditSource {
    id: string;
    path: string;
    proxy: string | null;
}
export interface EditBeat {
    id: string;
    src?: string;
    t: number;
    kind: string;
    strength: number;
    basis?: string;
}
export interface EditOverlay {
    id: string;
    start: number;
    duration: number;
    track: number;
    payload: Record<string, unknown>;
}
export type LayerBlendMode = 'normal' | 'screen' | 'multiply' | 'add' | 'difference' | 'darken' | 'lighten' | 'overlay' | 'hardlight' | 'softlight';
export interface EditLayer {
    in?: number;
    speed?: number;
    id: string;
    t: number;
    duration: number;
    kind: 'baked' | 'video';
    src: string;
    mask?: string;
    track?: number;
    preset?: string;
    transform?: {
        x?: number;
        y?: number;
        scale?: number;
        scaleX?: number;
        scaleY?: number;
        rotate?: number;
    };
    opacity?: number;
    blend?: LayerBlendMode;
    chromaKey?: {
        color: string;
        similarity?: number;
        blend?: number;
    };
}
export interface EditAudioKeyframe {
    t: number;
    gain_db?: number;
    easing?: string | Record<string, string>;
}
export interface EditAudioClipDenoise {
    method: 'fft' | 'nlm';
    strength: number;
}
export interface EditAudioSfx {
    id: string;
    t: number;
    duration: number;
    path: string;
    track?: number;
    gainDb?: number;
    in?: number;
    out?: number;
    speed?: number;
    pitch_semitones?: number;
    formant?: 'preserve' | 'shift';
    denoise?: EditAudioClipDenoise;
    lowcut_hz?: number;
    keyframes?: EditAudioKeyframe[];
    ducking?: boolean;
    duck_db?: number;
    duck_attack?: number;
    duck_release?: number;
}
export interface EditAudioNarrationProvenance {
    provider: string;
    engine?: string;
    voice?: string;
    credit?: string;
    generated_at?: string;
    [key: string]: unknown;
}
/** audio.narration[] の legacy 投影形。 */
export interface EditAudioNarration {
    id: string;
    t: number;
    path: string;
    track?: number;
    gainDb?: number;
    in?: number;
    out?: number;
    speed?: number;
    pitch_semitones?: number;
    formant?: 'preserve' | 'shift';
    denoise?: EditAudioClipDenoise;
    lowcut_hz?: number;
    keyframes?: EditAudioKeyframe[];
    ducking?: boolean;
    duck_db?: number;
    duck_attack?: number;
    duck_release?: number;
    script?: string;
    reading?: string;
    provenance?: EditAudioNarrationProvenance;
}
export interface CutTrackSegment {
    index: number;
    track: number;
    at: number;
    duration: number;
    end: number;
}
export interface EditAudioBgm {
    t?: number;
    duration?: number;
    id: 'bgm';
    path: string;
    track?: number;
    fadeIn?: number;
    fadeOut?: number;
    gainDb?: number;
    speed?: number;
    pitch_semitones?: number;
    formant?: 'preserve' | 'shift';
    denoise?: EditAudioClipDenoise;
    lowcut_hz?: number;
    ducking?: boolean;
    keyframes?: EditAudioKeyframe[];
    duck_db?: number;
    duck_attack?: number;
    duck_release?: number;
}
export type TimelineTrackKind = 'cuts' | 'layers' | 'overlays' | 'captions' | 'audio';
export interface EditTimelineTrack {
    id: string;
    kind: TimelineTrackKind;
    ref?: number;
    label?: string;
    muted?: boolean;
    hidden?: boolean;
    locked?: boolean;
}
export interface SourceElement {
    text: string;
    start: number;
    end: number;
}
export declare function findMatchingBracket(source: string, openIndex: number): number;
export declare function splitTopLevelElements(innerText: string): SourceElement[];
export declare function computeCutTrackSegments(cuts: readonly EditCut[]): CutTrackSegment[];
export declare function trimCutInSource(source: string, cutIndex: number, nextIn: number, nextOut: number, maxOutSeconds?: number): string;
/**
 * ソーストリマーの slip 操作: out−in（尺）と t（タイムライン位置）を固定したまま
 * in/out を同量シフトする。trimCutInSource と異なり尺そのものは変化しないため、
 * at の再計算・freezeNextImplicitCutAt（暗黙 at の凍結）は不要
 * （後続クリップのタイムライン位置に一切影響しない）。
 */
export declare function slipCutInSource(source: string, cutIndex: number, nextIn: number, nextOut: number, maxOutSeconds?: number): string;
export declare function setCutSpeedInSource(source: string, cutIndex: number, speed: number | null): string;
export declare function updateCutTransformInSource(source: string, cutIndex: number, updates: {
    x?: number | null;
    y?: number | null;
    scale?: number | null;
    scaleX?: number | null;
    scaleY?: number | null;
    rotate?: number | null;
}): string;
export declare function updateCutOpacityInSource(source: string, cutIndex: number, opacity: number | null): string;
export declare function setCutTransitionOutInSource(source: string, cutIndex: number, transitionOut: {
    type: TransitionType;
    duration: number;
    align?: TransitionAlign | null;
    /** 省けば保つ・null で消す。 */
    fill?: 'freeze' | null;
} | null): string;
export interface RemoveV2TransitionOutWithHandleRetractInput {
    itemId: string;
    retractFrames: number;
    fps: number;
}
/**
 * v0.1.20 の自動のりしろ debris を、transition_out の削除と同じ 1 回の
 * byte-preserving 手術で回収する。新意味論の通常操作では trim を一切変更しない。
 */
export declare function removeV2TransitionOutWithHandleRetractInSource(source: string, input: RemoveV2TransitionOutWithHandleRetractInput): string;
export declare function reorderCutsInSource(source: string, fromIndex: number, toIndex: number): string;
export declare function splitCutInSource(source: string, cutIndex: number, atSeconds: number): string;
export declare function deleteCutInSource(source: string, cutIndex: number): {
    source: string;
    removedText: string;
};
export declare function insertCutInSource(source: string, cutIndex: number, elementText: string): string;
export declare function deleteLayerByIdInSource(source: string, layerId: string): {
    source: string;
    removedText: string;
    layerIndex: number;
};
export declare function deleteLayerInSource(source: string, layerIndex: number): {
    source: string;
    removedText: string;
};
export declare function insertLayerInSource(source: string, layerIndex: number, elementText: string): string;
export declare function deleteSfxInSource(source: string, sfxIndex: number): {
    source: string;
    removedText: string;
};
export declare function insertSfxInSource(source: string, sfxIndex: number, elementText: string): string;
export declare function moveCutInSource(source: string, cutIndex: number, nextAt: number, nextTrack?: number | null, trackState?: Record<string, number | null>): string;
/**
 * クリップ移動と、移動で空になった宣言済み cuts トラックの除去を同じ候補全文へ畳む。
 * trackIds は UI が移動前の件数から特定したものだけを受け取り、他種別・使用中トラックは守る。
 */
export declare function moveCutAndPruneTracksInSource(source: string, cutIndex: number, nextAt: number, nextTrack?: number | null, trackState?: Record<string, number | null>, trackIds?: readonly string[]): {
    source: string;
    prunedTracks?: {
        before: EditTimelineTrack[];
        after: EditTimelineTrack[];
    };
};
export declare function setCutAtValuesInSource(source: string, entries: Array<{
    cutIndex: number;
    at: number | null;
}>): string;
export declare function updateLayerInSource(source: string, layerId: string, updates: {
    t?: number;
    duration?: number;
    track?: number;
}): string;
export declare function updateLayerTransformInSource(source: string, layerId: string, updates: {
    x?: number | null;
    y?: number | null;
    scale?: number | null;
    scaleX?: number | null;
    scaleY?: number | null;
    rotate?: number | null;
}): string;
export declare function updateLayerOpacityInSource(source: string, layerId: string, opacity: number | null): string;
export declare function updateLayerBlendInSource(source: string, layerId: string, blend: string | null): string;
export declare function moveLayerInSource(source: string, layerId: string, nextT: number, nextDuration: number, nextTrack?: number, trackState?: Record<string, number | null>): string;
export declare function moveSfxInSource(source: string, sfxIndex: number, nextT: number, nextTrack?: number, trackState?: Record<string, number | null>): string;
/**
 * SE の in/out（素材秒）を書き戻す。動画クリップのトリム（trimCutInSource）と同じ操作感に
 * 合わせ、左端ドラッグ（in の変更）は t も連動させる呼び出し側の責務で nextT を渡す。
 * null は「フィールドを削除して省略時意味論（in=0 / out=素材末尾）へ戻す」（undo 用）。
 */
export declare function trimSfxInSource(source: string, sfxIndex: number, nextIn: number | null, nextOut: number | null, nextT?: number): string;
export declare function setSfxGainDbInSource(source: string, sfxIndex: number, gainDb: number | null): string;
export declare function updateBgmInSource(source: string, updates: {
    gainDb?: number | null;
    fadeIn?: number | null;
    fadeOut?: number | null;
    ducking?: boolean | null;
}): string;
export declare function moveOverlayInSource(source: string, overlayId: string, nextStart: number, nextTrack?: number | null, trackState?: Record<string, number | null>): string;
export declare function resizeOverlayInSource(source: string, overlayId: string, nextDuration: number): string;
export declare function insertOverlayInSource(source: string, overlay: Record<string, unknown>): string;
export declare function removeOverlayInSource(source: string, overlayId: string): string;
export declare function writeTimelineTracksInSource(source: string, tracks: EditTimelineTrack[]): string;
export declare function updateArrayElementByIndex(source: string, key: string, index: number, label: string, update: (element: string) => string): string;
export declare function updateOverlayVarInSource(source: string, overlayId: string, varName: string, nextValue: string): string;