@bylqwjc/media-editor-server 1.0.24 → 1.0.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/core/dist/browser.cjs +1 -1
  2. package/core/dist/browser.d.ts +9 -3
  3. package/core/dist/browser.js +1 -1
  4. package/core/dist/{chunk-T5QIAKTR.js → chunk-7PSQLYXL.js} +1 -1
  5. package/core/dist/chunk-FAFKY4LX.js +1 -0
  6. package/core/dist/engine.cjs +1 -1
  7. package/core/dist/engine.d.ts +648 -549
  8. package/core/dist/engine.js +1 -1
  9. package/core/dist/filerobot.cjs +1 -1
  10. package/core/dist/filerobot.js +1 -1
  11. package/core/dist/index.cjs +1 -1
  12. package/core/dist/index.d.ts +2 -2
  13. package/core/dist/index.js +1 -1
  14. package/core/dist/{state-D7Of7b_y.d.ts → state-D2oM5s1a.d.ts} +10 -0
  15. package/core/package.json +1 -1
  16. package/core/zod/v3/types.js +1 -1
  17. package/dist/adapters/express.cjs +1 -1
  18. package/dist/adapters/express.d.ts +1 -1
  19. package/dist/adapters/express.js +1 -1
  20. package/dist/adapters/web.cjs +1 -1
  21. package/dist/adapters/web.d.ts +1 -1
  22. package/dist/adapters/web.js +1 -1
  23. package/dist/{handler-BEalyBz9.d.ts → handler-BiOIAlrh.d.ts} +8 -1
  24. package/dist/index.cjs +1 -1
  25. package/dist/index.d.ts +1 -1
  26. package/dist/index.js +1 -1
  27. package/package.json +1 -1
  28. package/core/dist/chunk-KO6CX4IJ.js +0 -1
package/core/dist/engine.d.ts CHANGED
@@ -1,564 +1,663 @@
1
- import * as zod from 'zod';
2
- import { V as VideoEditStateT, O as OverlayT } from './state-D7Of7b_y.js';
1
+ import * as zod from 'zod'
2
+ import { V as VideoEditStateT, O as OverlayT } from './state-D2oM5s1a.js'
3
3
 
4
4
  /** 视频源元数据(File/objectURL 是运行时的事,不进引擎;引擎只认 srcIdx + 元数据) */
5
5
  interface VideoSourceMeta {
6
- duration: number;
7
- width: number;
8
- height: number;
6
+ duration: number
7
+ width: number
8
+ height: number
9
9
  }
10
10
  /** 音频源元数据 */
11
11
  interface AudioSourceMeta {
12
- duration: number;
12
+ duration: number
13
13
  }
14
14
  interface MutOpts {
15
- /** true = 瞬时(拖拽中间帧,不入 undo 栈) */
16
- transient?: boolean;
15
+ /** true = 瞬时(拖拽中间帧,不入 undo 栈) */
16
+ transient?: boolean
17
17
  }
18
- type FilterKey = 'brightness' | 'contrast' | 'saturation' | 'temperature' | 'tint' | 'vibrance' | 'gamma' | 'highlights' | 'shadows' | 'whites' | 'blacks' | 'lightSense' | 'sharpen' | 'clarity' | 'grain' | 'fade' | 'vignette';
19
- type VideoEditStateWithTransitions = VideoEditStateT;
20
- type EngineListener = (state: VideoEditStateT) => void;
18
+ type FilterKey =
19
+ | 'brightness'
20
+ | 'contrast'
21
+ | 'saturation'
22
+ | 'temperature'
23
+ | 'tint'
24
+ | 'vibrance'
25
+ | 'gamma'
26
+ | 'highlights'
27
+ | 'shadows'
28
+ | 'whites'
29
+ | 'blacks'
30
+ | 'lightSense'
31
+ | 'sharpen'
32
+ | 'clarity'
33
+ | 'grain'
34
+ | 'fade'
35
+ | 'vignette'
36
+ type VideoEditStateWithTransitions = VideoEditStateT
37
+ type EngineListener = (state: VideoEditStateT) => void
21
38
  /** 导出计划:压缩后的状态 + 上传槽位映射(slot i 对应原 srcIdx = order[i]) */
22
39
  interface ExportPlan {
23
- state: VideoEditStateT;
24
- videoSrcOrder: number[];
25
- audioSrcOrder: number[];
40
+ state: VideoEditStateT
41
+ videoSrcOrder: number[]
42
+ audioSrcOrder: number[]
26
43
  }
27
44
  declare class VideoEditorEngine {
28
- private history;
29
- private videoSources;
30
- private audioSources;
31
- private listeners;
32
- /** 瞬时拖拽序列的起始 base(拖拽前的提交态);null = 不在拖拽中 */
33
- private transientBase;
34
- constructor(initial?: VideoEditStateT);
35
- /** 当前编辑状态(引用稳定:仅在变更时换新对象,适配 useSyncExternalStore) */
36
- getState(): VideoEditStateT;
37
- /** useSyncExternalStore 用别名 */
38
- getSnapshot: () => VideoEditStateT;
39
- subscribe: (fn: EngineListener) => (() => void);
40
- private emit;
41
- canUndo(): boolean;
42
- canRedo(): boolean;
43
- undo(): void;
44
- redo(): void;
45
- /**
46
- * 全部变更的唯一入口。mut 接收「计算基准态」返回新态。
47
- * 瞬时:基准恒为 transientBase(拖拽前态),replacePresent;
48
- * 提交:基准为 transientBase ?? present;若刚结束一段瞬时,先把 present 还原回 base 再 push,
49
- * 使整段拖拽只占一步 undo。
50
- */
51
- private applyMut;
52
- /**
53
- * 登记一个视频源并入时间轴。首源:用其分辨率初始化 canvas 并重建 history(清空 undo);
54
- * 后续源:追加整段 clip(pushHistory)。
55
- */
56
- registerVideoSource(meta: VideoSourceMeta): number;
57
- /** 登记一个音频源并入单音轨(整段、volume=1、追加到当前音频末尾,clamp 后 push) */
58
- registerAudioSource(meta: AudioSourceMeta): number;
59
- getVideoSource(idx: number): VideoSourceMeta | undefined;
60
- getAudioSource(idx: number): AudioSourceMeta | undefined;
61
- /** 把已登记源再追加一段整段 clip(同源可多次引用) */
62
- addClipFromSource(srcIdx: number): void;
63
- splitAtPlayhead(outputTime: number): void;
64
- removeClip(idx: number): void;
65
- duplicateClip(idx: number): void;
66
- reorderClips(from: number, to: number): void;
67
- /** 拖把手改 in/out 到源时刻 srcT;拖拽中传 {transient:true},松手再调一次提交 */
68
- trimClip(idx: number, edge: 'in' | 'out', srcT: number, opts?: MutOpts): void;
69
- moveAudioClip(idx: number, startAt: number, opts?: MutOpts): void;
70
- trimAudioClip(idx: number, edge: 'in' | 'out', t: number, opts?: MutOpts): void;
71
- setAudioVolume(idx: number, volume: number, opts?: MutOpts): void;
72
- removeAudioClip(idx: number): void;
73
- /** 改一条音频片段并 clamp(volume 改动不需 clamp 几何,clampGeom=false 跳过) */
74
- private patchAudio;
75
- setCrop(crop: NonNullable<VideoEditStateT['crop']>, opts?: MutOpts): void;
76
- clearCrop(): void;
77
- setScale(scale: NonNullable<VideoEditStateT['scale']>): void;
78
- clearScale(): void;
79
- setRotation(deg: number, opts?: MutOpts): void;
80
- /** 90° 步进(顺时针正);结果钳到 [-180,180] */
81
- rotateBy(step: number): void;
82
- flipX(): void;
83
- flipY(): void;
84
- setFilter(key: FilterKey, value: number, opts?: MutOpts): void;
85
- setFilters(partial: Partial<VideoEditStateT['filters']>, opts?: MutOpts): void;
86
- setFilterPreset(id: string | undefined): void;
87
- addOverlay(o: OverlayT): void;
88
- updateOverlay(idx: number, patch: Partial<OverlayT>, opts?: MutOpts): void;
89
- removeOverlay(idx: number): void;
90
- /**
91
- * 通用补丁:把 partial 浅合并进状态(UI 一次改多字段,如旋转同时重置 crop)。
92
- * - `{transient:true}`:拖拽中间帧,基于拖拽前 base 合并、replacePresent,不入栈(= 原 patchLive)。
93
- * - 默认:一次性提交(= commit(partial))。
94
- */
95
- patch(partial: Partial<VideoEditStateT>, opts?: MutOpts): void;
96
- /**
97
- * 定格当前态为一步 undo(= 原 commit):保留 present(含拖拽末值),可再合并 partial;
98
- * 若处于瞬时序列,先把 past 接到拖拽前 base 上,使整段拖拽只占一步。
99
- */
100
- commit(partial?: Partial<VideoEditStateT>): void;
101
- setKeepAudio(keep: boolean): void;
102
- setPoster(time: number): void;
103
- totalDuration(): number;
104
- contentDuration(): number;
105
- /** 输出时刻 → 所属片段与源内时刻(播放头定位) */
106
- locate(outputTime: number): {
107
- idx: number;
108
- srcTime: number;
109
- } | null;
110
- usedVideoSources(): number[];
111
- /**
112
- * 生成导出计划:剔除未引用源、把 clips/audioClips 的 srcIdx 重映射到 [0..n),
113
- * 返回压缩后的状态与上传槽位顺序(framework 按 order 取 File 上传)。
114
- */
115
- getExportPlan(): ExportPlan;
116
- /** 校验当前(导出)状态是否符合 schema —— 提交前兜底 */
117
- validate(): zod.SafeParseReturnType<{
118
- clips: {
119
- srcIdx: number;
120
- in: number;
121
- out: number;
122
- hidden?: boolean | undefined;
123
- locked?: boolean | undefined;
124
- }[];
125
- canvas: {
126
- w: number;
127
- h: number;
128
- };
129
- rotation?: number | undefined;
130
- filterPreset?: string | undefined;
131
- audioClips?: {
132
- startAt: number;
133
- srcIdx: number;
134
- in: number;
135
- out: number;
136
- volume: number;
137
- locked?: boolean | undefined;
138
- track?: number | undefined;
139
- speed?: number | undefined;
140
- muted?: boolean | undefined;
141
- fadeIn?: number | undefined;
142
- fadeOut?: number | undefined;
143
- }[] | undefined;
144
- crop?: {
145
- width: number;
146
- x: number;
147
- y: number;
148
- height: number;
149
- } | undefined;
150
- scale?: {
151
- width: number;
152
- height: number;
153
- fit: "contain" | "cover" | "force";
154
- backgroundColor?: string | undefined;
155
- } | undefined;
156
- flipX?: boolean | undefined;
157
- flipY?: boolean | undefined;
158
- filters?: {
159
- brightness?: number | undefined;
160
- contrast?: number | undefined;
161
- saturation?: number | undefined;
162
- temperature?: number | undefined;
163
- tint?: number | undefined;
164
- vibrance?: number | undefined;
165
- gamma?: number | undefined;
166
- highlights?: number | undefined;
167
- shadows?: number | undefined;
168
- whites?: number | undefined;
169
- blacks?: number | undefined;
170
- lightSense?: number | undefined;
171
- sharpen?: number | undefined;
172
- clarity?: number | undefined;
173
- grain?: number | undefined;
174
- fade?: number | undefined;
175
- vignette?: number | undefined;
176
- } | undefined;
177
- overlays?: ({
178
- type: "pen";
179
- points: number[];
180
- color: string;
181
- width: number;
182
- rotation?: number | undefined;
183
- startAt?: number | undefined;
184
- endAt?: number | undefined;
185
- timelineTrack?: number | undefined;
186
- hidden?: boolean | undefined;
187
- locked?: boolean | undefined;
188
- } | {
189
- type: "line";
190
- color: string;
191
- width: number;
192
- x1: number;
193
- y1: number;
194
- x2: number;
195
- y2: number;
196
- rotation?: number | undefined;
197
- startAt?: number | undefined;
198
- endAt?: number | undefined;
199
- timelineTrack?: number | undefined;
200
- hidden?: boolean | undefined;
201
- locked?: boolean | undefined;
202
- } | {
203
- type: "arrow";
204
- color: string;
205
- width: number;
206
- x1: number;
207
- y1: number;
208
- x2: number;
209
- y2: number;
210
- rotation?: number | undefined;
211
- startAt?: number | undefined;
212
- endAt?: number | undefined;
213
- timelineTrack?: number | undefined;
214
- hidden?: boolean | undefined;
215
- locked?: boolean | undefined;
216
- } | {
217
- type: "rect";
218
- color: string;
219
- width: number;
220
- x: number;
221
- y: number;
222
- w: number;
223
- h: number;
224
- rotation?: number | undefined;
225
- startAt?: number | undefined;
226
- endAt?: number | undefined;
227
- timelineTrack?: number | undefined;
228
- hidden?: boolean | undefined;
229
- locked?: boolean | undefined;
230
- } | {
231
- type: "ellipse";
232
- color: string;
233
- width: number;
234
- x: number;
235
- y: number;
236
- w: number;
237
- h: number;
238
- rotation?: number | undefined;
239
- startAt?: number | undefined;
240
- endAt?: number | undefined;
241
- timelineTrack?: number | undefined;
242
- hidden?: boolean | undefined;
243
- locked?: boolean | undefined;
244
- } | {
245
- type: "text";
246
- color: string;
247
- x: number;
248
- y: number;
249
- text: string;
250
- fontSize: number;
251
- rotation?: number | undefined;
252
- startAt?: number | undefined;
253
- endAt?: number | undefined;
254
- timelineTrack?: number | undefined;
255
- hidden?: boolean | undefined;
256
- locked?: boolean | undefined;
257
- width?: number | undefined;
258
- fontFamily?: string | undefined;
259
- fontWeight?: string | undefined;
260
- italic?: boolean | undefined;
261
- underline?: boolean | undefined;
262
- strikethrough?: boolean | undefined;
263
- align?: "left" | "center" | "right" | undefined;
264
- backgroundColor?: string | undefined;
265
- strokeColor?: string | undefined;
266
- borderWidth?: number | undefined;
267
- paddingX?: number | undefined;
268
- paddingY?: number | undefined;
269
- lineHeight?: number | undefined;
270
- opacity?: number | undefined;
271
- } | {
272
- type: "sticker";
273
- x: number;
274
- y: number;
275
- w: number;
276
- h: number;
277
- rotation?: number | undefined;
278
- startAt?: number | undefined;
279
- endAt?: number | undefined;
280
- timelineTrack?: number | undefined;
281
- hidden?: boolean | undefined;
282
- locked?: boolean | undefined;
283
- emoji?: string | undefined;
284
- src?: string | undefined;
285
- } | {
286
- type: "adjust";
287
- x: number;
288
- y: number;
289
- w: number;
290
- h: number;
291
- rotation?: number | undefined;
292
- startAt?: number | undefined;
293
- endAt?: number | undefined;
294
- timelineTrack?: number | undefined;
295
- hidden?: boolean | undefined;
296
- locked?: boolean | undefined;
297
- layerKind?: "filter" | "adjust" | undefined;
298
- filterPreset?: string | undefined;
299
- brightness?: number | undefined;
300
- contrast?: number | undefined;
301
- saturation?: number | undefined;
302
- temperature?: number | undefined;
303
- tint?: number | undefined;
304
- vibrance?: number | undefined;
305
- gamma?: number | undefined;
306
- highlights?: number | undefined;
307
- shadows?: number | undefined;
308
- whites?: number | undefined;
309
- blacks?: number | undefined;
310
- lightSense?: number | undefined;
311
- sharpen?: number | undefined;
312
- clarity?: number | undefined;
313
- grain?: number | undefined;
314
- fade?: number | undefined;
315
- vignette?: number | undefined;
316
- })[] | undefined;
317
- transitions?: {
318
- type?: "fade" | "none" | "slide" | "wipe" | "flip" | "clockWipe" | "star" | "circle" | "rectangle" | undefined;
319
- duration?: number | undefined;
320
- }[] | undefined;
321
- keepAudio?: boolean | undefined;
322
- poster?: {
323
- time: number;
324
- src?: string | undefined;
325
- useAsVideoCover?: boolean | undefined;
326
- preview?: string | undefined;
327
- } | undefined;
328
- exportSettings?: {
329
- width?: number | undefined;
330
- fileName?: string | undefined;
331
- format?: "mp4" | "mov" | "mxf" | undefined;
332
- height?: number | undefined;
333
- frameRate?: number | undefined;
334
- videoBitrateKbps?: number | undefined;
335
- audioBitrateKbps?: number | undefined;
336
- audioCodec?: "aac" | "mp3" | undefined;
337
- } | undefined;
338
- }, {
339
- rotation: number;
340
- clips: {
341
- srcIdx: number;
342
- in: number;
343
- out: number;
344
- hidden?: boolean | undefined;
345
- locked?: boolean | undefined;
346
- }[];
347
- audioClips: {
348
- startAt: number;
349
- srcIdx: number;
350
- in: number;
351
- out: number;
352
- track: number;
353
- speed: number;
354
- volume: number;
355
- fadeIn: number;
356
- fadeOut: number;
357
- locked?: boolean | undefined;
358
- muted?: boolean | undefined;
359
- }[];
360
- canvas: {
361
- w: number;
362
- h: number;
363
- };
364
- flipX: boolean;
365
- flipY: boolean;
366
- filters: {
367
- brightness: number;
368
- contrast: number;
369
- saturation: number;
370
- temperature: number;
371
- tint: number;
372
- vibrance: number;
373
- gamma: number;
374
- highlights: number;
375
- shadows: number;
376
- whites: number;
377
- blacks: number;
378
- lightSense: number;
379
- sharpen: number;
380
- clarity: number;
381
- grain: number;
382
- fade: number;
383
- vignette: number;
384
- };
385
- transitions: {
386
- type: "fade" | "none" | "slide" | "wipe" | "flip" | "clockWipe" | "star" | "circle" | "rectangle";
387
- duration: number;
388
- }[];
389
- keepAudio: boolean;
390
- filterPreset?: string | undefined;
391
- crop?: {
392
- width: number;
393
- x: number;
394
- y: number;
395
- height: number;
396
- } | undefined;
397
- scale?: {
398
- width: number;
399
- height: number;
400
- fit: "contain" | "cover" | "force";
401
- backgroundColor?: string | undefined;
402
- } | undefined;
403
- overlays?: ({
404
- type: "pen";
405
- points: number[];
406
- color: string;
407
- width: number;
408
- rotation?: number | undefined;
409
- startAt?: number | undefined;
410
- endAt?: number | undefined;
411
- timelineTrack?: number | undefined;
412
- hidden?: boolean | undefined;
413
- locked?: boolean | undefined;
414
- } | {
415
- type: "line";
416
- color: string;
417
- width: number;
418
- x1: number;
419
- y1: number;
420
- x2: number;
421
- y2: number;
422
- rotation?: number | undefined;
423
- startAt?: number | undefined;
424
- endAt?: number | undefined;
425
- timelineTrack?: number | undefined;
426
- hidden?: boolean | undefined;
427
- locked?: boolean | undefined;
428
- } | {
429
- type: "arrow";
430
- color: string;
431
- width: number;
432
- x1: number;
433
- y1: number;
434
- x2: number;
435
- y2: number;
436
- rotation?: number | undefined;
437
- startAt?: number | undefined;
438
- endAt?: number | undefined;
439
- timelineTrack?: number | undefined;
440
- hidden?: boolean | undefined;
441
- locked?: boolean | undefined;
442
- } | {
443
- type: "rect";
444
- color: string;
445
- width: number;
446
- x: number;
447
- y: number;
448
- w: number;
449
- h: number;
450
- rotation?: number | undefined;
451
- startAt?: number | undefined;
452
- endAt?: number | undefined;
453
- timelineTrack?: number | undefined;
454
- hidden?: boolean | undefined;
455
- locked?: boolean | undefined;
456
- } | {
457
- type: "ellipse";
458
- color: string;
459
- width: number;
460
- x: number;
461
- y: number;
462
- w: number;
463
- h: number;
464
- rotation?: number | undefined;
465
- startAt?: number | undefined;
466
- endAt?: number | undefined;
467
- timelineTrack?: number | undefined;
468
- hidden?: boolean | undefined;
469
- locked?: boolean | undefined;
470
- } | {
471
- type: "text";
472
- color: string;
473
- x: number;
474
- y: number;
475
- text: string;
476
- fontSize: number;
477
- rotation?: number | undefined;
478
- startAt?: number | undefined;
479
- endAt?: number | undefined;
480
- timelineTrack?: number | undefined;
481
- hidden?: boolean | undefined;
482
- locked?: boolean | undefined;
483
- width?: number | undefined;
484
- fontFamily?: string | undefined;
485
- fontWeight?: string | undefined;
486
- italic?: boolean | undefined;
487
- underline?: boolean | undefined;
488
- strikethrough?: boolean | undefined;
489
- align?: "left" | "center" | "right" | undefined;
490
- backgroundColor?: string | undefined;
491
- strokeColor?: string | undefined;
492
- borderWidth?: number | undefined;
493
- paddingX?: number | undefined;
494
- paddingY?: number | undefined;
495
- lineHeight?: number | undefined;
496
- opacity?: number | undefined;
497
- } | {
498
- type: "sticker";
499
- x: number;
500
- y: number;
501
- w: number;
502
- h: number;
503
- rotation?: number | undefined;
504
- startAt?: number | undefined;
505
- endAt?: number | undefined;
506
- timelineTrack?: number | undefined;
507
- hidden?: boolean | undefined;
508
- locked?: boolean | undefined;
509
- emoji?: string | undefined;
510
- src?: string | undefined;
511
- } | {
512
- type: "adjust";
513
- x: number;
514
- y: number;
515
- w: number;
516
- h: number;
517
- brightness: number;
518
- contrast: number;
519
- saturation: number;
520
- temperature: number;
521
- tint: number;
522
- vibrance: number;
523
- gamma: number;
524
- highlights: number;
525
- shadows: number;
526
- whites: number;
527
- blacks: number;
528
- lightSense: number;
529
- sharpen: number;
530
- clarity: number;
531
- grain: number;
532
- fade: number;
533
- vignette: number;
534
- rotation?: number | undefined;
535
- startAt?: number | undefined;
536
- endAt?: number | undefined;
537
- timelineTrack?: number | undefined;
538
- hidden?: boolean | undefined;
539
- locked?: boolean | undefined;
540
- layerKind?: "filter" | "adjust" | undefined;
541
- filterPreset?: string | undefined;
542
- })[] | undefined;
543
- poster?: {
544
- time: number;
545
- src?: string | undefined;
546
- useAsVideoCover?: boolean | undefined;
547
- preview?: string | undefined;
548
- } | undefined;
549
- exportSettings?: {
550
- format: "mp4" | "mov" | "mxf";
551
- frameRate: number;
552
- audioCodec: "aac" | "mp3";
553
- width?: number | undefined;
554
- fileName?: string | undefined;
555
- height?: number | undefined;
556
- videoBitrateKbps?: number | undefined;
557
- audioBitrateKbps?: number | undefined;
558
- } | undefined;
559
- }>;
560
- /** 重置为给定状态(清空 history、源登记保留) */
561
- reset(state?: VideoEditStateT): void;
45
+ private history
46
+ private videoSources
47
+ private audioSources
48
+ private listeners
49
+ /** 瞬时拖拽序列的起始 base(拖拽前的提交态);null = 不在拖拽中 */
50
+ private transientBase
51
+ constructor(initial?: VideoEditStateT)
52
+ /** 当前编辑状态(引用稳定:仅在变更时换新对象,适配 useSyncExternalStore) */
53
+ getState(): VideoEditStateT
54
+ /** useSyncExternalStore 用别名 */
55
+ getSnapshot: () => VideoEditStateT
56
+ subscribe: (fn: EngineListener) => () => void
57
+ private emit
58
+ canUndo(): boolean
59
+ canRedo(): boolean
60
+ undo(): void
61
+ redo(): void
62
+ /**
63
+ * 全部变更的唯一入口。mut 接收「计算基准态」返回新态。
64
+ * 瞬时:基准恒为 transientBase(拖拽前态),replacePresent;
65
+ * 提交:基准为 transientBase ?? present;若刚结束一段瞬时,先把 present 还原回 base 再 push,
66
+ * 使整段拖拽只占一步 undo。
67
+ */
68
+ private applyMut
69
+ /**
70
+ * 登记一个视频源并入时间轴。首源:用其分辨率初始化 canvas 并重建 history(清空 undo);
71
+ * 后续源:追加整段 clip(pushHistory)。
72
+ */
73
+ registerVideoSource(meta: VideoSourceMeta): number
74
+ /** 登记一个音频源并入单音轨(整段、volume=1、追加到当前音频末尾,clamp 后 push) */
75
+ registerAudioSource(meta: AudioSourceMeta): number
76
+ getVideoSource(idx: number): VideoSourceMeta | undefined
77
+ getAudioSource(idx: number): AudioSourceMeta | undefined
78
+ /** 把已登记源再追加一段整段 clip(同源可多次引用) */
79
+ addClipFromSource(srcIdx: number): void
80
+ splitAtPlayhead(outputTime: number): void
81
+ removeClip(idx: number): void
82
+ duplicateClip(idx: number): void
83
+ reorderClips(from: number, to: number): void
84
+ /** 拖把手改 in/out 到源时刻 srcT;拖拽中传 {transient:true},松手再调一次提交 */
85
+ trimClip(idx: number, edge: 'in' | 'out', srcT: number, opts?: MutOpts): void
86
+ moveAudioClip(idx: number, startAt: number, opts?: MutOpts): void
87
+ trimAudioClip(
88
+ idx: number,
89
+ edge: 'in' | 'out',
90
+ t: number,
91
+ opts?: MutOpts,
92
+ ): void
93
+ setAudioVolume(idx: number, volume: number, opts?: MutOpts): void
94
+ removeAudioClip(idx: number): void
95
+ /** 改一条音频片段并 clamp(volume 改动不需 clamp 几何,clampGeom=false 跳过) */
96
+ private patchAudio
97
+ setCrop(crop: NonNullable<VideoEditStateT['crop']>, opts?: MutOpts): void
98
+ clearCrop(): void
99
+ setScale(scale: NonNullable<VideoEditStateT['scale']>): void
100
+ clearScale(): void
101
+ setRotation(deg: number, opts?: MutOpts): void
102
+ /** 90° 步进(顺时针正);结果钳到 [-180,180] */
103
+ rotateBy(step: number): void
104
+ flipX(): void
105
+ flipY(): void
106
+ setFilter(key: FilterKey, value: number, opts?: MutOpts): void
107
+ setFilters(partial: Partial<VideoEditStateT['filters']>, opts?: MutOpts): void
108
+ setFilterPreset(id: string | undefined): void
109
+ addOverlay(o: OverlayT): void
110
+ updateOverlay(idx: number, patch: Partial<OverlayT>, opts?: MutOpts): void
111
+ removeOverlay(idx: number): void
112
+ /**
113
+ * 通用补丁:把 partial 浅合并进状态(UI 一次改多字段,如旋转同时重置 crop)。
114
+ * - `{transient:true}`:拖拽中间帧,基于拖拽前 base 合并、replacePresent,不入栈(= 原 patchLive)。
115
+ * - 默认:一次性提交(= commit(partial))。
116
+ */
117
+ patch(partial: Partial<VideoEditStateT>, opts?: MutOpts): void
118
+ /**
119
+ * 定格当前态为一步 undo(= 原 commit):保留 present(含拖拽末值),可再合并 partial;
120
+ * 若处于瞬时序列,先把 past 接到拖拽前 base 上,使整段拖拽只占一步。
121
+ */
122
+ commit(partial?: Partial<VideoEditStateT>): void
123
+ setKeepAudio(keep: boolean): void
124
+ setPoster(time: number): void
125
+ totalDuration(): number
126
+ contentDuration(): number
127
+ /** 输出时刻 → 所属片段与源内时刻(播放头定位) */
128
+ locate(outputTime: number): {
129
+ idx: number
130
+ srcTime: number
131
+ } | null
132
+ usedVideoSources(): number[]
133
+ /**
134
+ * 生成导出计划:剔除未引用源、把 clips/audioClips 的 srcIdx 重映射到 [0..n),
135
+ * 返回压缩后的状态与上传槽位顺序(framework 按 order 取 File 上传)。
136
+ */
137
+ getExportPlan(): ExportPlan
138
+ /** 校验当前(导出)状态是否符合 schema —— 提交前兜底 */
139
+ validate(): zod.SafeParseReturnType<
140
+ {
141
+ clips: {
142
+ srcIdx: number
143
+ in: number
144
+ out: number
145
+ hidden?: boolean | undefined
146
+ locked?: boolean | undefined
147
+ }[]
148
+ canvas: {
149
+ w: number
150
+ h: number
151
+ }
152
+ rotation?: number | undefined
153
+ filterPreset?: string | undefined
154
+ audioClips?:
155
+ | {
156
+ startAt: number
157
+ srcIdx: number
158
+ in: number
159
+ out: number
160
+ volume: number
161
+ locked?: boolean | undefined
162
+ track?: number | undefined
163
+ speed?: number | undefined
164
+ muted?: boolean | undefined
165
+ fadeIn?: number | undefined
166
+ fadeOut?: number | undefined
167
+ }[]
168
+ | undefined
169
+ crop?:
170
+ | {
171
+ width: number
172
+ x: number
173
+ y: number
174
+ height: number
175
+ }
176
+ | undefined
177
+ scale?:
178
+ | {
179
+ width: number
180
+ height: number
181
+ fit: 'contain' | 'cover' | 'force'
182
+ backgroundColor?: string | undefined
183
+ }
184
+ | undefined
185
+ flipX?: boolean | undefined
186
+ flipY?: boolean | undefined
187
+ filters?:
188
+ | {
189
+ brightness?: number | undefined
190
+ contrast?: number | undefined
191
+ saturation?: number | undefined
192
+ temperature?: number | undefined
193
+ tint?: number | undefined
194
+ vibrance?: number | undefined
195
+ gamma?: number | undefined
196
+ highlights?: number | undefined
197
+ shadows?: number | undefined
198
+ whites?: number | undefined
199
+ blacks?: number | undefined
200
+ lightSense?: number | undefined
201
+ sharpen?: number | undefined
202
+ clarity?: number | undefined
203
+ grain?: number | undefined
204
+ fade?: number | undefined
205
+ vignette?: number | undefined
206
+ }
207
+ | undefined
208
+ overlays?:
209
+ | (
210
+ | {
211
+ type: 'pen'
212
+ points: number[]
213
+ color: string
214
+ width: number
215
+ rotation?: number | undefined
216
+ startAt?: number | undefined
217
+ endAt?: number | undefined
218
+ timelineTrack?: number | undefined
219
+ hidden?: boolean | undefined
220
+ locked?: boolean | undefined
221
+ }
222
+ | {
223
+ type: 'line'
224
+ color: string
225
+ width: number
226
+ x1: number
227
+ y1: number
228
+ x2: number
229
+ y2: number
230
+ rotation?: number | undefined
231
+ startAt?: number | undefined
232
+ endAt?: number | undefined
233
+ timelineTrack?: number | undefined
234
+ hidden?: boolean | undefined
235
+ locked?: boolean | undefined
236
+ }
237
+ | {
238
+ type: 'arrow'
239
+ color: string
240
+ width: number
241
+ x1: number
242
+ y1: number
243
+ x2: number
244
+ y2: number
245
+ rotation?: number | undefined
246
+ startAt?: number | undefined
247
+ endAt?: number | undefined
248
+ timelineTrack?: number | undefined
249
+ hidden?: boolean | undefined
250
+ locked?: boolean | undefined
251
+ }
252
+ | {
253
+ type: 'rect'
254
+ color: string
255
+ width: number
256
+ x: number
257
+ y: number
258
+ w: number
259
+ h: number
260
+ rotation?: number | undefined
261
+ startAt?: number | undefined
262
+ endAt?: number | undefined
263
+ timelineTrack?: number | undefined
264
+ hidden?: boolean | undefined
265
+ locked?: boolean | undefined
266
+ }
267
+ | {
268
+ type: 'ellipse'
269
+ color: string
270
+ width: number
271
+ x: number
272
+ y: number
273
+ w: number
274
+ h: number
275
+ rotation?: number | undefined
276
+ startAt?: number | undefined
277
+ endAt?: number | undefined
278
+ timelineTrack?: number | undefined
279
+ hidden?: boolean | undefined
280
+ locked?: boolean | undefined
281
+ }
282
+ | {
283
+ type: 'text'
284
+ color: string
285
+ x: number
286
+ y: number
287
+ text: string
288
+ fontSize: number
289
+ rotation?: number | undefined
290
+ startAt?: number | undefined
291
+ endAt?: number | undefined
292
+ timelineTrack?: number | undefined
293
+ hidden?: boolean | undefined
294
+ locked?: boolean | undefined
295
+ width?: number | undefined
296
+ fontFamily?: string | undefined
297
+ fontWeight?: string | undefined
298
+ italic?: boolean | undefined
299
+ underline?: boolean | undefined
300
+ strikethrough?: boolean | undefined
301
+ align?: 'left' | 'center' | 'right' | undefined
302
+ backgroundColor?: string | undefined
303
+ strokeColor?: string | undefined
304
+ borderWidth?: number | undefined
305
+ paddingX?: number | undefined
306
+ paddingY?: number | undefined
307
+ lineHeight?: number | undefined
308
+ opacity?: number | undefined
309
+ }
310
+ | {
311
+ type: 'sticker'
312
+ x: number
313
+ y: number
314
+ w: number
315
+ h: number
316
+ rotation?: number | undefined
317
+ startAt?: number | undefined
318
+ endAt?: number | undefined
319
+ timelineTrack?: number | undefined
320
+ hidden?: boolean | undefined
321
+ locked?: boolean | undefined
322
+ emoji?: string | undefined
323
+ src?: string | undefined
324
+ }
325
+ | {
326
+ type: 'adjust'
327
+ x: number
328
+ y: number
329
+ w: number
330
+ h: number
331
+ rotation?: number | undefined
332
+ startAt?: number | undefined
333
+ endAt?: number | undefined
334
+ timelineTrack?: number | undefined
335
+ hidden?: boolean | undefined
336
+ locked?: boolean | undefined
337
+ layerKind?: 'filter' | 'adjust' | undefined
338
+ filterPreset?: string | undefined
339
+ brightness?: number | undefined
340
+ contrast?: number | undefined
341
+ saturation?: number | undefined
342
+ temperature?: number | undefined
343
+ tint?: number | undefined
344
+ vibrance?: number | undefined
345
+ gamma?: number | undefined
346
+ highlights?: number | undefined
347
+ shadows?: number | undefined
348
+ whites?: number | undefined
349
+ blacks?: number | undefined
350
+ lightSense?: number | undefined
351
+ sharpen?: number | undefined
352
+ clarity?: number | undefined
353
+ grain?: number | undefined
354
+ fade?: number | undefined
355
+ vignette?: number | undefined
356
+ }
357
+ )[]
358
+ | undefined
359
+ transitions?:
360
+ | {
361
+ type?:
362
+ | 'fade'
363
+ | 'none'
364
+ | 'slide'
365
+ | 'wipe'
366
+ | 'flip'
367
+ | 'clockWipe'
368
+ | 'star'
369
+ | 'circle'
370
+ | 'rectangle'
371
+ | undefined
372
+ duration?: number | undefined
373
+ }[]
374
+ | undefined
375
+ keepAudio?: boolean | undefined
376
+ poster?:
377
+ | {
378
+ time: number
379
+ src?: string | undefined
380
+ useAsVideoCover?: boolean | undefined
381
+ preview?: string | undefined
382
+ }
383
+ | undefined
384
+ exportSettings?:
385
+ | {
386
+ width?: number | undefined
387
+ fileName?: string | undefined
388
+ format?: 'mp4' | 'mov' | 'mxf' | undefined
389
+ height?: number | undefined
390
+ frameRate?: number | undefined
391
+ bitrateMode?: 'custom' | 'auto' | undefined
392
+ videoBitrateKbps?: number | undefined
393
+ audioBitrateKbps?: number | undefined
394
+ audioCodec?: 'aac' | 'mp3' | undefined
395
+ }
396
+ | undefined
397
+ },
398
+ {
399
+ rotation: number
400
+ clips: {
401
+ srcIdx: number
402
+ in: number
403
+ out: number
404
+ hidden?: boolean | undefined
405
+ locked?: boolean | undefined
406
+ }[]
407
+ audioClips: {
408
+ startAt: number
409
+ srcIdx: number
410
+ in: number
411
+ out: number
412
+ track: number
413
+ speed: number
414
+ volume: number
415
+ fadeIn: number
416
+ fadeOut: number
417
+ locked?: boolean | undefined
418
+ muted?: boolean | undefined
419
+ }[]
420
+ canvas: {
421
+ w: number
422
+ h: number
423
+ }
424
+ flipX: boolean
425
+ flipY: boolean
426
+ filters: {
427
+ brightness: number
428
+ contrast: number
429
+ saturation: number
430
+ temperature: number
431
+ tint: number
432
+ vibrance: number
433
+ gamma: number
434
+ highlights: number
435
+ shadows: number
436
+ whites: number
437
+ blacks: number
438
+ lightSense: number
439
+ sharpen: number
440
+ clarity: number
441
+ grain: number
442
+ fade: number
443
+ vignette: number
444
+ }
445
+ transitions: {
446
+ type:
447
+ | 'fade'
448
+ | 'none'
449
+ | 'slide'
450
+ | 'wipe'
451
+ | 'flip'
452
+ | 'clockWipe'
453
+ | 'star'
454
+ | 'circle'
455
+ | 'rectangle'
456
+ duration: number
457
+ }[]
458
+ keepAudio: boolean
459
+ filterPreset?: string | undefined
460
+ crop?:
461
+ | {
462
+ width: number
463
+ x: number
464
+ y: number
465
+ height: number
466
+ }
467
+ | undefined
468
+ scale?:
469
+ | {
470
+ width: number
471
+ height: number
472
+ fit: 'contain' | 'cover' | 'force'
473
+ backgroundColor?: string | undefined
474
+ }
475
+ | undefined
476
+ overlays?:
477
+ | (
478
+ | {
479
+ type: 'pen'
480
+ points: number[]
481
+ color: string
482
+ width: number
483
+ rotation?: number | undefined
484
+ startAt?: number | undefined
485
+ endAt?: number | undefined
486
+ timelineTrack?: number | undefined
487
+ hidden?: boolean | undefined
488
+ locked?: boolean | undefined
489
+ }
490
+ | {
491
+ type: 'line'
492
+ color: string
493
+ width: number
494
+ x1: number
495
+ y1: number
496
+ x2: number
497
+ y2: number
498
+ rotation?: number | undefined
499
+ startAt?: number | undefined
500
+ endAt?: number | undefined
501
+ timelineTrack?: number | undefined
502
+ hidden?: boolean | undefined
503
+ locked?: boolean | undefined
504
+ }
505
+ | {
506
+ type: 'arrow'
507
+ color: string
508
+ width: number
509
+ x1: number
510
+ y1: number
511
+ x2: number
512
+ y2: number
513
+ rotation?: number | undefined
514
+ startAt?: number | undefined
515
+ endAt?: number | undefined
516
+ timelineTrack?: number | undefined
517
+ hidden?: boolean | undefined
518
+ locked?: boolean | undefined
519
+ }
520
+ | {
521
+ type: 'rect'
522
+ color: string
523
+ width: number
524
+ x: number
525
+ y: number
526
+ w: number
527
+ h: number
528
+ rotation?: number | undefined
529
+ startAt?: number | undefined
530
+ endAt?: number | undefined
531
+ timelineTrack?: number | undefined
532
+ hidden?: boolean | undefined
533
+ locked?: boolean | undefined
534
+ }
535
+ | {
536
+ type: 'ellipse'
537
+ color: string
538
+ width: number
539
+ x: number
540
+ y: number
541
+ w: number
542
+ h: number
543
+ rotation?: number | undefined
544
+ startAt?: number | undefined
545
+ endAt?: number | undefined
546
+ timelineTrack?: number | undefined
547
+ hidden?: boolean | undefined
548
+ locked?: boolean | undefined
549
+ }
550
+ | {
551
+ type: 'text'
552
+ color: string
553
+ x: number
554
+ y: number
555
+ text: string
556
+ fontSize: number
557
+ rotation?: number | undefined
558
+ startAt?: number | undefined
559
+ endAt?: number | undefined
560
+ timelineTrack?: number | undefined
561
+ hidden?: boolean | undefined
562
+ locked?: boolean | undefined
563
+ width?: number | undefined
564
+ fontFamily?: string | undefined
565
+ fontWeight?: string | undefined
566
+ italic?: boolean | undefined
567
+ underline?: boolean | undefined
568
+ strikethrough?: boolean | undefined
569
+ align?: 'left' | 'center' | 'right' | undefined
570
+ backgroundColor?: string | undefined
571
+ strokeColor?: string | undefined
572
+ borderWidth?: number | undefined
573
+ paddingX?: number | undefined
574
+ paddingY?: number | undefined
575
+ lineHeight?: number | undefined
576
+ opacity?: number | undefined
577
+ }
578
+ | {
579
+ type: 'sticker'
580
+ x: number
581
+ y: number
582
+ w: number
583
+ h: number
584
+ rotation?: number | undefined
585
+ startAt?: number | undefined
586
+ endAt?: number | undefined
587
+ timelineTrack?: number | undefined
588
+ hidden?: boolean | undefined
589
+ locked?: boolean | undefined
590
+ emoji?: string | undefined
591
+ src?: string | undefined
592
+ }
593
+ | {
594
+ type: 'adjust'
595
+ x: number
596
+ y: number
597
+ w: number
598
+ h: number
599
+ brightness: number
600
+ contrast: number
601
+ saturation: number
602
+ temperature: number
603
+ tint: number
604
+ vibrance: number
605
+ gamma: number
606
+ highlights: number
607
+ shadows: number
608
+ whites: number
609
+ blacks: number
610
+ lightSense: number
611
+ sharpen: number
612
+ clarity: number
613
+ grain: number
614
+ fade: number
615
+ vignette: number
616
+ rotation?: number | undefined
617
+ startAt?: number | undefined
618
+ endAt?: number | undefined
619
+ timelineTrack?: number | undefined
620
+ hidden?: boolean | undefined
621
+ locked?: boolean | undefined
622
+ layerKind?: 'filter' | 'adjust' | undefined
623
+ filterPreset?: string | undefined
624
+ }
625
+ )[]
626
+ | undefined
627
+ poster?:
628
+ | {
629
+ time: number
630
+ src?: string | undefined
631
+ useAsVideoCover?: boolean | undefined
632
+ preview?: string | undefined
633
+ }
634
+ | undefined
635
+ exportSettings?:
636
+ | {
637
+ format: 'mp4' | 'mov' | 'mxf'
638
+ frameRate: number
639
+ audioCodec: 'aac' | 'mp3'
640
+ width?: number | undefined
641
+ fileName?: string | undefined
642
+ height?: number | undefined
643
+ bitrateMode?: 'custom' | 'auto' | undefined
644
+ videoBitrateKbps?: number | undefined
645
+ audioBitrateKbps?: number | undefined
646
+ }
647
+ | undefined
648
+ }
649
+ >
650
+ /** 重置为给定状态(清空 history、源登记保留) */
651
+ reset(state?: VideoEditStateT): void
562
652
  }
563
653
 
564
- export { type AudioSourceMeta, type EngineListener, type ExportPlan, type FilterKey, type MutOpts, type VideoEditStateWithTransitions, VideoEditorEngine, type VideoSourceMeta };
654
+ export {
655
+ type AudioSourceMeta,
656
+ type EngineListener,
657
+ type ExportPlan,
658
+ type FilterKey,
659
+ type MutOpts,
660
+ type VideoEditStateWithTransitions,
661
+ VideoEditorEngine,
662
+ type VideoSourceMeta,
663
+ }