@bylqwjc/media-editor-react 1.0.12

package/node_modules/@media-editor/core/dist/index.d.ts

@@ -0,0 +1,264 @@
+import { A as AudioClipT, C as ClipT, V as VideoEditStateT } from './state-B85vkf7_.js';
+export { a as AudioClip, b as Clip, c as Overlay, O as OverlayT, d as VideoEditState, e as defaultVideoEditState } from './state-B85vkf7_.js';
+export { D as DEFAULT_PLATFORM_TARGETS, a as EDITOR_MESSAGES, E as EditorLocale, I as IMAGE_PLATFORM_PRESETS, b as IMAGE_RATIO_PRESETS, P as PlatformPreset, c as PlatformTarget, R as RatioPreset, S as SizePreset, V as VIDEO_PLATFORM_RATIO_PRESETS, d as VIDEO_RATIO_PRESETS, e as VIDEO_SIZE_PRESETS, f as VideoPlatformRatioPreset, g as buildImagePlatformPresets, h as buildVideoPlatformRatioPresets, i as buildVideoSizePresets, p as parseRatio, t as tEditor, j as toHant } from './platform-presets-B-o4C6uY.js';
+import 'zod';
+
+type TransitionT = {
+    type: 'none' | 'fade' | 'slide' | 'wipe' | 'flip' | 'clockWipe' | 'star' | 'circle' | 'rectangle';
+    duration: number;
+};
+type VideoEditStateWithTransitions = VideoEditStateT & {
+    transitions?: TransitionT[];
+};
+
+/**
+ * editor-core/timeline v2 —— 输出时间轴纯函数（多素材 clips/audioClips 操作）。
+ * 从 UI 抽出,Vue/React 壳共用;全部不可变(返回新数组)。
+ *
+ * 模型:clips 数组顺序 = 输出拼接顺序;输出时间轴 x = Σ前序片段时长。
+ * 所有 "t" 参数除特别说明外都是**输出时间**;trimClipEdge 的 srcT 是源时间。
+ */
+
+declare const MIN_CLIP = 0.1;
+/** 片段时长 */
+declare function clipDuration(c: ClipT): number;
+/** 输出总时长 */
+declare function totalDuration(clips: ClipT[]): number;
+/** 第 idx 个片段在输出时间轴上的起点(前缀和) */
+declare function clipStartsAt(clips: ClipT[], idx: number): number;
+/**
+ * 输出时间 t → 所属片段与源内时刻。
+ * 交界时刻归后段(前段已播完);t === total 归末段(srcTime = out);
+ * t 越界或 clips 为空返回 null。
+ */
+declare function locateOutput(clips: ClipT[], t: number): {
+    idx: number;
+    srcTime: number;
+} | null;
+/** 在输出时刻 t 处把所属片段一分为二;距两端 <MIN_CLIP 返回原数组 */
+declare function splitAtOutput(clips: ClipT[], t: number): ClipT[];
+/** 删除第 idx 个片段;只剩一段时不可删,返回原数组 */
+declare function removeClip(clips: ClipT[], idx: number): ClipT[];
+/** 复制第 idx 个片段,插到原段之后 */
+declare function duplicateClip(clips: ClipT[], idx: number): ClipT[];
+/** 拖拽重排:把第 from 段移动到第 to 位 */
+declare function reorderClips(clips: ClipT[], from: number, to: number): ClipT[];
+/**
+ * 拖片段把手:把第 idx 段的 in/out 改到源时刻 srcT。
+ * in 钳 [0, out-MIN_CLIP];out 钳 [in+MIN_CLIP, srcDuration]。
+ */
+declare function trimClipEdge(clips: ClipT[], idx: number, edge: 'in' | 'out', srcT: number, srcDuration: number): ClipT[];
+/**
+ * 音乐片段钳制:in/out 在源时长内且 out-in≥MIN_CLIP;
+ * startAt ∈ [0, max(0, total-MIN_CLIP)] —— 允许尾部悬出输出末尾(导出 amix duration=first 截断)。
+ */
+declare function clampAudioClip(a: AudioClipT, srcDuration: number, total: number): AudioClipT;
+/**
+ * 时间轴内容时长 = max(视频总长, 音乐悬出末端)。
+ * 用于内容宽度/适应缩放/标尺——音乐尾部悬出视频末尾时也要看得见;
+ * 播放头/seek 仍以视频总长为界(导出 amix duration=first 同语义)。
+ */
+declare function contentDuration(clips: ClipT[], audioClips?: AudioClipT[]): number;
+/** clips 实际引用到的视频源序号(升序去重)——导出前压缩上传用 */
+declare function usedVideoSrcIndices(clips: ClipT[]): number[];
+/** 把 clips 的 srcIdx 重映射为 used 中的序号(与压缩后的上传文件序对齐) */
+declare function remapSrcIndices(clips: ClipT[], used: number[]): ClipT[];
+
+/**
+ * editor-core/ffmpeg-args v2 —— VideoEditState → FFmpeg 参数(纯函数,服务端执行)。
+ * 安全:只接受结构化 state + 服务端落盘的文件路径数组;文件内容不进命令行。
+ *
+ * 多素材模型:clips 数组序 = 输出拼接序;每片段先归一到画布
+ * (cover 居中裁剪 + setsar=1 + fps=30 + format=yuv420p,防 concat 流参数不齐),
+ * concat 后过全局画面链(flips → rotate → crop → scale → eq → 预设滤镜),最后 overlay。
+ * 音频:原声(keepAudio,无音轨源用 anullsrc 补齐) concat → 与音乐(atrim+volume+adelay)
+ * amix=duration=first(锚定视频长):normalize=0(不自动衰减)。
+ *
+ * 单视频源且无音乐时走 v1 快路径(-ss/-t 或单输入 filter_complex),隔离回归面。
+ */
+
+/** 服务端按 srcIdx 顺序落盘后的路径与探测结果 */
+interface FfmpegIo {
+    /** index 与 clip.srcIdx 对齐(客户端导出前已压缩重映射) */
+    videoPaths: string[];
+    /** 与 videoPaths 等长,probeHasAudio 结果 */
+    videoHasAudio: boolean[];
+    /** index 与 audioClip.srcIdx 对齐 */
+    audioPaths: string[];
+    overlayPath?: string;
+}
+/**
+ * v2 主入口:多视频源 concat + 音乐 amix + 全局链 + overlay。
+ * 输入序:视频 0..N-1 → 音乐 N..N+M-1 → overlay N+M。
+ */
+declare function buildFfmpegArgs(state: VideoEditStateWithTransitions, io: FfmpegIo, output: string): string[];
+/** 封面帧:在 time 处抽 1 帧 jpg */
+declare function buildPosterArgs(input: string, time: number, output: string): string[];
+
+/**
+ * editor-core/transform —— 旋转/坐标换算纯函数。
+ * 与 ffmpeg 的 rotw/roth 同公式,保证预览画布与导出尺寸一致。
+ */
+declare const DEG2RAD: number;
+/** 旋转 deg 度后的外接框尺寸(= ffmpeg rotate 滤镜 ow=rotw/oh=roth) */
+declare function rotatedSize(w: number, h: number, deg: number): {
+    w: number;
+    h: number;
+};
+/** 角度归一化到 [0,360) */
+declare function normalizeDeg(deg: number): number;
+/** h264 偶数像素对齐 */
+declare function evenize(n: number): number;
+/** 把 rect 钳制在 bounds 内(裁剪框拖拽用) */
+declare function clampRect(rect: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, bounds: {
+    w: number;
+    h: number;
+}, minSize?: number): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** 给定纵横比,在 bounds 内求居中最大 rect(比例预设落框用) */
+declare function centeredMaxRect(bounds: {
+    w: number;
+    h: number;
+}, aspect: number): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+type FitMode = 'cover' | 'contain' | 'force';
+/**
+ * scale 的 fit 语义 → 源/目标矩形对(预览画布与 ffmpeg 严格同语义):
+ * - cover:源侧取目标比例的居中最大区(= ffmpeg scale:force_original_aspect_ratio=increase + 居中 crop),不变形
+ * - contain:目标侧居中留黑边(= ffmpeg scale:decrease + pad)
+ * - force:双全幅拉伸(= ffmpeg scale=W:H)
+ * src 坐标相对 crop 区原点;dst 坐标相对输出原点。
+ */
+declare function fitRects(crop: {
+    width: number;
+    height: number;
+}, out: {
+    w: number;
+    h: number;
+}, fit: FitMode): {
+    src: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    dst: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+};
+/** 导出产物的最终输出尺寸(决定 overlay PNG 的分辨率) */
+declare function outputSize(source: {
+    w: number;
+    h: number;
+}, state: {
+    rotation: number;
+    crop?: {
+        width: number;
+        height: number;
+    } | undefined;
+    scale?: {
+        width: number;
+        height: number;
+    } | undefined;
+}): {
+    w: number;
+    h: number;
+};
+
+/**
+ * editor-core/filters —— 预设滤镜表(数据驱动)。
+ * vf = ffmpeg 滤镜片段(导出真值);css = 浏览器预览近似。
+ * 全部使用 ffmpeg-static 6.x 标配滤镜(hue/eq/colorbalance/colorchannelmixer)。
+ */
+interface FilterPreset {
+    id: string;
+    label: string;
+    vf: string;
+    css: string;
+}
+declare const FILTER_PRESETS: FilterPreset[];
+declare function findFilterPreset(id: string | undefined): FilterPreset | undefined;
+/**
+ * 拼出 canvas/CSS 用的 filter 字符串(预览与帧合成共用)。
+ * brightness/contrast/saturation 来自手调 [-1,1] → 1+v;叠加预设 css。
+ * gamma 无 CSS 等价(仅 ffmpeg 导出生效),此处不含。
+ */
+declare function buildFilterCss(filters: {
+    brightness: number;
+    contrast: number;
+    saturation: number;
+    temperature: number;
+    tint: number;
+    vibrance: number;
+    gamma: number;
+    highlights: number;
+    shadows: number;
+    whites: number;
+    blacks: number;
+    lightSense: number;
+    sharpen: number;
+    clarity: number;
+    grain: number;
+    fade: number;
+    vignette: number;
+}, presetId?: string): string;
+
+/**
+ * editor-core/history —— 不可变快照 undo/redo 栈(纯函数)。
+ * 泛型,对 EditState 的 JSON 快照工作;壳层(React/Vue)只持有 History<T> 并 set 回去。
+ */
+interface History<T> {
+    past: T[];
+    present: T;
+    future: T[];
+}
+declare function createHistory<T>(initial: T): History<T>;
+/** 写入新状态(清空 redo 栈);浅比较相同引用则原样返回 */
+declare function pushHistory<T>(h: History<T>, next: T): History<T>;
+/**
+ * 替换当前态但不入栈(高频拖拽的中间帧用):
+ * 拖动过程 replacePresent 持续刷新,pointerup 时再 pushHistory 定格一步。
+ */
+declare function replacePresent<T>(h: History<T>, next: T): History<T>;
+declare function canUndo<T>(h: History<T>): boolean;
+declare function canRedo<T>(h: History<T>): boolean;
+declare function undo<T>(h: History<T>): History<T>;
+declare function redo<T>(h: History<T>): History<T>;
+
+/**
+ * Filerobot 图片编辑器的标注旋转补偿(纯函数,供 ImageEditor 注入 config.onAnnotationAdd)。
+ *
+ * 背景:Filerobot 把 rotation 加在整个 Konva DesignLayer 上(DesignLayerWrapper),
+ * 新标注挂进同一层会继承父层旋转 → 旋转图片后再贴文字,文字方向跟着转。
+ * onAnnotationAdd 是 5.0.0-beta.159 真实存在但未写进 index.d.ts 的 config 钩子:
+ * 源码 lib/actions/setAnnotation.js 在「新建标注」时调用 (annotation, 全量state),
+ * 把返回的 partial 合并进标注 —— 这里给新标注反向初始 rotation,与父层旋转叠加后视觉正向。
+ */
+declare function compensateAnnotationRotation(ann: {
+    rotation?: number;
+    isDuplicated?: boolean;
+}, state: {
+    adjustments?: {
+        rotation?: number;
+    };
+}): {
+    rotation?: number;
+};
+
+export { AudioClipT, ClipT, DEG2RAD, FILTER_PRESETS, type FfmpegIo, type FilterPreset, type FitMode, type History, MIN_CLIP, TransitionT, VideoEditStateT, VideoEditStateWithTransitions, buildFfmpegArgs, buildFilterCss, buildPosterArgs, canRedo, canUndo, centeredMaxRect, clampAudioClip, clampRect, clipDuration, clipStartsAt, compensateAnnotationRotation, contentDuration, createHistory, duplicateClip, evenize, findFilterPreset, fitRects, locateOutput, normalizeDeg, outputSize, pushHistory, redo, remapSrcIndices, removeClip, reorderClips, replacePresent, rotatedSize, splitAtOutput, totalDuration, trimClipEdge, undo, usedVideoSrcIndices };