@cut-workbench/core 0.4.0 → 0.4.1

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 (58) hide show
  1. package/dist/chunks/{canvas-size-Ct61OYjW.cjs → canvas-size-DIABzEW2.cjs} +212 -44
  2. package/dist/chunks/canvas-size-DIABzEW2.cjs.map +1 -0
  3. package/dist/chunks/{canvas-size-CM2oKApi.js → canvas-size-Dlnng74w.js} +168 -30
  4. package/dist/chunks/canvas-size-Dlnng74w.js.map +1 -0
  5. package/dist/chunks/id-CJsdlGei.js +35 -0
  6. package/dist/chunks/id-CJsdlGei.js.map +1 -0
  7. package/dist/chunks/id-DaCxD4-5.cjs +70 -0
  8. package/dist/chunks/id-DaCxD4-5.cjs.map +1 -0
  9. package/dist/chunks/{snap-DyIuO2hU.cjs → snap-Cfk15JVg.cjs} +2 -22
  10. package/dist/chunks/{snap-DyIuO2hU.cjs.map → snap-Cfk15JVg.cjs.map} +1 -1
  11. package/dist/chunks/{snap-CBV9G4xq.js → snap-DpkVPVJN.js} +3 -17
  12. package/dist/chunks/{snap-CBV9G4xq.js.map → snap-DpkVPVJN.js.map} +1 -1
  13. package/dist/chunks/thumbnails-DEjnao5r.cjs +81 -0
  14. package/dist/chunks/thumbnails-DEjnao5r.cjs.map +1 -0
  15. package/dist/chunks/thumbnails-qH0dX_Zs.js +64 -0
  16. package/dist/chunks/thumbnails-qH0dX_Zs.js.map +1 -0
  17. package/dist/chunks/{time-CnMfSVYX.cjs → time-CYEd91qN.cjs} +1 -69
  18. package/dist/chunks/time-CYEd91qN.cjs.map +1 -0
  19. package/dist/chunks/{time-C_gvkVl1.js → time-ChF1GwCy.js} +2 -34
  20. package/dist/chunks/time-ChF1GwCy.js.map +1 -0
  21. package/dist/chunks/{waveform-Ie-G5Lle.cjs → waveform-BYwDdKpC.cjs} +34 -15
  22. package/dist/chunks/waveform-BYwDdKpC.cjs.map +1 -0
  23. package/dist/chunks/{waveform-DJkRtMct.js → waveform-uyGNE01H.js} +32 -13
  24. package/dist/chunks/waveform-uyGNE01H.js.map +1 -0
  25. package/dist/engine/index.cjs +668 -76
  26. package/dist/engine/index.cjs.map +1 -1
  27. package/dist/engine/index.js +648 -57
  28. package/dist/engine/index.js.map +1 -1
  29. package/dist/engine/webav/exporter.d.ts +3 -1
  30. package/dist/engine/webav/import-files.d.ts +17 -2
  31. package/dist/engine/webav/import-pipeline.d.ts +10 -0
  32. package/dist/engine/webav/types.d.ts +15 -0
  33. package/dist/index.cjs +18 -13
  34. package/dist/index.cjs.map +1 -1
  35. package/dist/index.d.ts +1 -0
  36. package/dist/index.js +6 -5
  37. package/dist/index.js.map +1 -1
  38. package/dist/lib/error.d.ts +6 -0
  39. package/dist/media/thumbnails.d.ts +8 -0
  40. package/dist/project/schema.d.ts +16 -4
  41. package/dist/timeline/index.cjs +10 -6
  42. package/dist/timeline/index.d.ts +1 -0
  43. package/dist/timeline/index.js +4 -4
  44. package/dist/timeline/normalize.d.ts +28 -0
  45. package/dist/timeline/ops.d.ts +0 -4
  46. package/dist/timeline/snap.d.ts +0 -2
  47. package/dist/types.d.ts +14 -2
  48. package/package.json +1 -1
  49. package/dist/chunks/canvas-size-CM2oKApi.js.map +0 -1
  50. package/dist/chunks/canvas-size-Ct61OYjW.cjs.map +0 -1
  51. package/dist/chunks/import-pipeline-A8KkqtZT.cjs +0 -610
  52. package/dist/chunks/import-pipeline-A8KkqtZT.cjs.map +0 -1
  53. package/dist/chunks/import-pipeline-DLIdgrIb.js +0 -521
  54. package/dist/chunks/import-pipeline-DLIdgrIb.js.map +0 -1
  55. package/dist/chunks/time-C_gvkVl1.js.map +0 -1
  56. package/dist/chunks/time-CnMfSVYX.cjs.map +0 -1
  57. package/dist/chunks/waveform-DJkRtMct.js.map +0 -1
  58. package/dist/chunks/waveform-Ie-G5Lle.cjs.map +0 -1
@@ -1,4 +1,5 @@
1
- const require_time = require("./time-CnMfSVYX.cjs");
1
+ const require_id = require("./id-DaCxD4-5.cjs");
2
+ const require_time = require("./time-CYEd91qN.cjs");
2
3
  // src/timeline/model.ts
3
4
  /**
4
5
  * 时间轴纯数据模型与工厂函数。
@@ -8,7 +9,7 @@ const require_time = require("./time-CnMfSVYX.cjs");
8
9
  */
9
10
  function createTrack(kind, name) {
10
11
  return {
11
- id: require_time.createId("track"),
12
+ id: require_id.createId("track"),
12
13
  name,
13
14
  kind,
14
15
  locked: false,
@@ -18,7 +19,7 @@ function createTrack(kind, name) {
18
19
  }
19
20
  function createEmptyProject(name = "未命名工程") {
20
21
  return {
21
- id: require_time.createId("project"),
22
+ id: require_id.createId("project"),
22
23
  name,
23
24
  width: 1280,
24
25
  height: 720,
@@ -38,14 +39,14 @@ function createClip(input, project) {
38
39
  h = Math.round(assetHeight * scale);
39
40
  }
40
41
  return {
41
- id: require_time.createId("clip"),
42
+ id: require_id.createId("clip"),
42
43
  trackId: input.trackId,
43
44
  assetId: input.assetId,
44
45
  startUs: require_time.asUs(input.startUs),
45
46
  durationUs: require_time.asUs(input.durationUs),
46
47
  inPointUs: require_time.asUs(input.inPointUs ?? 0),
47
48
  playbackRate: 1,
48
- volume: require_time.DEFAULT_CLIP_VOLUME,
49
+ volume: require_id.DEFAULT_CLIP_VOLUME,
49
50
  muted: false,
50
51
  opacity: 1,
51
52
  flip: null,
@@ -62,7 +63,7 @@ function createClip(input, project) {
62
63
  }
63
64
  /** 静态素材(图片 / 文字 / 字幕)需要有限时长 */
64
65
  function clampStillDuration(us) {
65
- return us > 0 && Number.isFinite(us) ? us : require_time.DEFAULT_STILL_DURATION_US;
66
+ return us > 0 && Number.isFinite(us) ? us : require_id.DEFAULT_STILL_DURATION_US;
66
67
  }
67
68
  function getClipEnd(clip) {
68
69
  return clip.startUs + clip.durationUs;
@@ -91,39 +92,176 @@ function getTrackEnd(project, trackId) {
91
92
  function getSourceSpanUs(clip) {
92
93
  return Math.round(clip.durationUs * clip.playbackRate);
93
94
  }
94
- // src/timeline/ops.ts
95
- /** 在时间轴时刻 `atUs` 分割 clip,返回 [左, 右];时刻不在 clip 内部时返回 null */
96
- function splitClipData(clip, atUs) {
97
- const start = clip.startUs;
98
- const end = getClipEnd(clip);
99
- if (atUs <= start || atUs >= end) return null;
100
- const leftDuration = atUs - start;
101
- const rightDuration = end - atUs;
102
- const sourceOffset = Math.round(leftDuration * clip.playbackRate);
103
- const left = {
104
- ...clip,
105
- durationUs: require_time.asUs(leftDuration),
106
- fadeOutUs: require_time.asUs(Math.min(clip.fadeOutUs, leftDuration))
95
+ // src/timeline/normalize.ts
96
+ var DEFAULT_TEXT_STYLE = {
97
+ fontSize: 64,
98
+ color: "#ffffff",
99
+ fontFamily: "sans-serif",
100
+ fontWeight: 600,
101
+ fontStyle: "normal",
102
+ strokeColor: "#000000",
103
+ strokeWidth: 0,
104
+ shadowColor: "rgba(0,0,0,0.6)",
105
+ shadowBlur: 8,
106
+ align: "center",
107
+ background: "transparent"
108
+ };
109
+ var DEFAULT_SUBTITLE_STYLE = {
110
+ color: "#ffffff",
111
+ textBgColor: null,
112
+ fontFamily: "sans-serif",
113
+ fontSize: 30,
114
+ strokeStyle: "#000000",
115
+ lineWidth: null,
116
+ bottomOffset: 30
117
+ };
118
+ function isRecord(value) {
119
+ return value != null && typeof value === "object" && !Array.isArray(value);
120
+ }
121
+ /** 有限数值,否则用兜底值 */
122
+ function num(value, fallback) {
123
+ return typeof value === "number" && Number.isFinite(value) ? value : fallback;
124
+ }
125
+ function str(value, fallback) {
126
+ return typeof value === "string" && value.length > 0 ? value : fallback;
127
+ }
128
+ /** 补全 clip 的几何变换(缺 transform / 缺子字段都会兜底) */
129
+ function normalizeTransform(raw, projectWidth, projectHeight) {
130
+ const source = isRecord(raw) ? raw : {};
131
+ const w = Math.max(1, num(source.w, projectWidth));
132
+ const h = Math.max(1, num(source.h, projectHeight));
133
+ return {
134
+ x: num(source.x, Math.round((projectWidth - w) / 2)),
135
+ y: num(source.y, Math.round((projectHeight - h) / 2)),
136
+ w,
137
+ h,
138
+ angle: num(source.angle, 0)
107
139
  };
108
- const right = {
109
- ...clip,
110
- id: `${clip.id}_r`,
111
- startUs: require_time.asUs(atUs),
112
- durationUs: require_time.asUs(rightDuration),
113
- inPointUs: require_time.asUs(clip.inPointUs + sourceOffset),
114
- fadeInUs: require_time.asUs(Math.min(clip.fadeInUs, rightDuration))
140
+ }
141
+ function normalizeFlip(raw) {
142
+ return raw === "horizontal" || raw === "vertical" ? raw : null;
143
+ }
144
+ /** 补全单个 clip;`id` 缺失时生成一个,保证后续操作可用 */
145
+ function normalizeClip(raw, projectWidth, projectHeight) {
146
+ if (!isRecord(raw)) return null;
147
+ const trackId = typeof raw.trackId === "string" ? raw.trackId : "";
148
+ const assetId = typeof raw.assetId === "string" ? raw.assetId : "";
149
+ if (trackId === "" || assetId === "") return null;
150
+ const durationUs = Math.max(0, num(raw.durationUs, 0));
151
+ const normalized = {
152
+ id: str(raw.id, require_id.createId("clip")),
153
+ trackId,
154
+ assetId,
155
+ startUs: require_time.asUs(Math.max(0, num(raw.startUs, 0))),
156
+ durationUs: require_time.asUs(durationUs),
157
+ inPointUs: require_time.asUs(Math.max(0, num(raw.inPointUs, 0))),
158
+ playbackRate: require_time.clamp(num(raw.playbackRate, 1), .1, 10),
159
+ volume: require_time.clamp(num(raw.volume, require_id.DEFAULT_CLIP_VOLUME), 0, 4),
160
+ muted: raw.muted === true,
161
+ opacity: require_time.clamp(num(raw.opacity, 1), 0, 1),
162
+ flip: normalizeFlip(raw.flip),
163
+ transform: normalizeTransform(raw.transform, projectWidth, projectHeight),
164
+ fadeInUs: require_time.asUs(Math.max(0, num(raw.fadeInUs, 0))),
165
+ fadeOutUs: require_time.asUs(Math.max(0, num(raw.fadeOutUs, 0)))
166
+ };
167
+ if (raw.aspectLocked === true) normalized.aspectLocked = true;
168
+ if (typeof raw.text === "string") normalized.text = raw.text;
169
+ if (isRecord(raw.textStyle)) normalized.textStyle = {
170
+ ...DEFAULT_TEXT_STYLE,
171
+ ...raw.textStyle
115
172
  };
116
- left.fadeInUs = require_time.asUs(Math.min(clip.fadeInUs, leftDuration));
117
- return [left, right];
173
+ if (typeof raw.srt === "string") normalized.srt = raw.srt;
174
+ if (isRecord(raw.subtitleStyle)) normalized.subtitleStyle = {
175
+ ...DEFAULT_SUBTITLE_STYLE,
176
+ ...raw.subtitleStyle
177
+ };
178
+ return normalized;
118
179
  }
119
- /** 移动 clip:更新轨道与起点(不允许早于 0) */
120
- function moveClipData(clip, trackId, startUs) {
180
+ function normalizeTrack(raw, index) {
181
+ if (!isRecord(raw)) return null;
182
+ const kind = raw.kind === "audio" ? "audio" : "visual";
121
183
  return {
122
- ...clip,
123
- trackId,
124
- startUs: require_time.asUs(Math.max(0, startUs))
184
+ id: str(raw.id, require_id.createId("track")),
185
+ name: str(raw.name, kind === "audio" ? `音频 ${index + 1}` : `视频 ${index + 1}`),
186
+ kind,
187
+ locked: raw.locked === true,
188
+ muted: raw.muted === true,
189
+ hidden: raw.hidden === true
190
+ };
191
+ }
192
+ /** 补全工程;轨道为空时补一对默认轨道,否则 clip 无处可放 */
193
+ function normalizeProject(raw) {
194
+ if (!isRecord(raw)) return null;
195
+ const width = Math.max(2, Math.round(num(raw.width, 1280)));
196
+ const height = Math.max(2, Math.round(num(raw.height, 720)));
197
+ const tracks = (Array.isArray(raw.tracks) ? raw.tracks : []).map((track, index) => normalizeTrack(track, index)).filter((track) => track != null);
198
+ const effectiveTracks = tracks.length > 0 ? tracks : [{
199
+ id: require_id.createId("track"),
200
+ name: "视频 1",
201
+ kind: "visual",
202
+ locked: false,
203
+ muted: false,
204
+ hidden: false
205
+ }, {
206
+ id: require_id.createId("track"),
207
+ name: "音频 1",
208
+ kind: "audio",
209
+ locked: false,
210
+ muted: false,
211
+ hidden: false
212
+ }];
213
+ const trackIds = new Set(effectiveTracks.map((t) => t.id));
214
+ const clips = (Array.isArray(raw.clips) ? raw.clips : []).map((clip) => normalizeClip(clip, width, height)).filter((clip) => clip != null).filter((clip) => trackIds.has(clip.trackId));
215
+ return {
216
+ id: str(raw.id, require_id.createId("project")),
217
+ name: str(raw.name, "未命名工程"),
218
+ width,
219
+ height,
220
+ tracks: effectiveTracks,
221
+ clips,
222
+ updatedAt: num(raw.updatedAt, Date.now())
125
223
  };
126
224
  }
225
+ var KINDS = /* @__PURE__ */ new Set([
226
+ "video",
227
+ "audio",
228
+ "image",
229
+ "text",
230
+ "subtitle"
231
+ ]);
232
+ /** 补全素材元数据;`kind` 非法的条目直接丢弃(无法决定如何渲染) */
233
+ function normalizeAsset(raw) {
234
+ if (!isRecord(raw)) return null;
235
+ const kind = KINDS.has(raw.kind) ? raw.kind : null;
236
+ if (kind == null) return null;
237
+ const asset = {
238
+ id: typeof raw.id === "string" && raw.id !== "" ? raw.id : require_id.createId("asset"),
239
+ name: str(raw.name, kind === "video" ? "未命名视频" : "未命名素材"),
240
+ kind,
241
+ mimeType: str(raw.mimeType, "application/octet-stream"),
242
+ size: Math.max(0, num(raw.size, 0)),
243
+ durationUs: require_time.asUs(Math.max(0, num(raw.durationUs, 0))),
244
+ width: Math.max(0, num(raw.width, 0)),
245
+ height: Math.max(0, num(raw.height, 0)),
246
+ hasAudio: raw.hasAudio === true,
247
+ createdAt: num(raw.createdAt, Date.now())
248
+ };
249
+ if (typeof raw.text === "string") asset.text = raw.text;
250
+ if (isRecord(raw.textStyle)) asset.textStyle = {
251
+ ...DEFAULT_TEXT_STYLE,
252
+ ...raw.textStyle
253
+ };
254
+ if (typeof raw.srt === "string") asset.srt = raw.srt;
255
+ if (isRecord(raw.subtitleStyle)) asset.subtitleStyle = {
256
+ ...DEFAULT_SUBTITLE_STYLE,
257
+ ...raw.subtitleStyle
258
+ };
259
+ if (Array.isArray(raw.waveform) && raw.waveform.every((v) => typeof v === "number")) asset.waveform = raw.waveform;
260
+ if (typeof raw.sourcePath === "string") asset.sourcePath = raw.sourcePath;
261
+ if ((kind === "image" || kind === "text" || kind === "subtitle") && asset.durationUs <= 0) asset.durationUs = require_time.asUs(require_id.DEFAULT_STILL_DURATION_US);
262
+ return asset;
263
+ }
264
+ // src/timeline/ops.ts
127
265
  /**
128
266
  * 裁剪 clip 的边缘。
129
267
  *
@@ -499,6 +637,18 @@ Object.defineProperty(exports, "ASPECT_PRESETS", {
499
637
  return ASPECT_PRESETS;
500
638
  }
501
639
  });
640
+ Object.defineProperty(exports, "DEFAULT_SUBTITLE_STYLE", {
641
+ enumerable: true,
642
+ get: function() {
643
+ return DEFAULT_SUBTITLE_STYLE;
644
+ }
645
+ });
646
+ Object.defineProperty(exports, "DEFAULT_TEXT_STYLE", {
647
+ enumerable: true,
648
+ get: function() {
649
+ return DEFAULT_TEXT_STYLE;
650
+ }
651
+ });
502
652
  Object.defineProperty(exports, "MIN_TRANSFORM_SIZE", {
503
653
  enumerable: true,
504
654
  get: function() {
@@ -625,16 +775,28 @@ Object.defineProperty(exports, "isTrackAudible", {
625
775
  return isTrackAudible;
626
776
  }
627
777
  });
628
- Object.defineProperty(exports, "moveClipData", {
778
+ Object.defineProperty(exports, "normalizeAngle", {
629
779
  enumerable: true,
630
780
  get: function() {
631
- return moveClipData;
781
+ return normalizeAngle;
632
782
  }
633
783
  });
634
- Object.defineProperty(exports, "normalizeAngle", {
784
+ Object.defineProperty(exports, "normalizeAsset", {
635
785
  enumerable: true,
636
786
  get: function() {
637
- return normalizeAngle;
787
+ return normalizeAsset;
788
+ }
789
+ });
790
+ Object.defineProperty(exports, "normalizeClip", {
791
+ enumerable: true,
792
+ get: function() {
793
+ return normalizeClip;
794
+ }
795
+ });
796
+ Object.defineProperty(exports, "normalizeProject", {
797
+ enumerable: true,
798
+ get: function() {
799
+ return normalizeProject;
638
800
  }
639
801
  });
640
802
  Object.defineProperty(exports, "normalizeSize", {
@@ -643,6 +805,18 @@ Object.defineProperty(exports, "normalizeSize", {
643
805
  return normalizeSize;
644
806
  }
645
807
  });
808
+ Object.defineProperty(exports, "normalizeTrack", {
809
+ enumerable: true,
810
+ get: function() {
811
+ return normalizeTrack;
812
+ }
813
+ });
814
+ Object.defineProperty(exports, "normalizeTransform", {
815
+ enumerable: true,
816
+ get: function() {
817
+ return normalizeTransform;
818
+ }
819
+ });
646
820
  Object.defineProperty(exports, "pointInTransform", {
647
821
  enumerable: true,
648
822
  get: function() {
@@ -703,12 +877,6 @@ Object.defineProperty(exports, "sameTransform", {
703
877
  return sameTransform;
704
878
  }
705
879
  });
706
- Object.defineProperty(exports, "splitClipData", {
707
- enumerable: true,
708
- get: function() {
709
- return splitClipData;
710
- }
711
- });
712
880
  Object.defineProperty(exports, "toLocalPoint", {
713
881
  enumerable: true,
714
882
  get: function() {
@@ -722,4 +890,4 @@ Object.defineProperty(exports, "trimClipData", {
722
890
  }
723
891
  });
724
892
 
725
- //# sourceMappingURL=canvas-size-Ct61OYjW.cjs.map
893
+ //# sourceMappingURL=canvas-size-DIABzEW2.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"canvas-size-DIABzEW2.cjs","names":["createId","asUs","DEFAULT_CLIP_VOLUME","DEFAULT_STILL_DURATION_US","createId","asUs","clamp","DEFAULT_CLIP_VOLUME","DEFAULT_STILL_DURATION_US","asUs"],"sources":["../../src/timeline/model.ts","../../src/timeline/normalize.ts","../../src/timeline/ops.ts","../../src/timeline/geometry.ts","../../src/timeline/canvas-size.ts"],"sourcesContent":["/**\n * 时间轴纯数据模型与工厂函数。\n *\n * 这里没有任何 WebAV / React 依赖,所有函数都是纯函数或纯构造。\n * 时间单位统一微秒(µs)。\n */\n\nimport { createId } from '../lib/id'\nimport { DEFAULT_CLIP_VOLUME, DEFAULT_STILL_DURATION_US } from '../constants'\nimport type { Project, TimelineClip, Track } from '../types'\nimport { asUs } from './time'\n\nexport function createTrack(kind: Track['kind'], name: string): Track {\n return {\n id: createId('track'),\n name,\n kind,\n locked: false,\n muted: false,\n hidden: false,\n }\n}\n\nexport function createEmptyProject(name = '未命名工程'): Project {\n return {\n id: createId('project'),\n name,\n width: 1280,\n height: 720,\n tracks: [createTrack('visual', '视频 1'), createTrack('audio', '音频 1')],\n clips: [],\n updatedAt: Date.now(),\n }\n}\n\nexport interface CreateClipInput {\n assetId: string\n trackId: string\n startUs: number\n durationUs: number\n inPointUs?: number\n assetWidth?: number\n assetHeight?: number\n}\n\n/** 新建 clip 的默认几何:等比铺满工程画面 */\nexport function createClip(input: CreateClipInput, project: Project): TimelineClip {\n const { assetWidth = 0, assetHeight = 0 } = input\n let w = project.width\n let h = project.height\n if (assetWidth > 0 && assetHeight > 0) {\n const scale = Math.min(project.width / assetWidth, project.height / assetHeight)\n w = Math.round(assetWidth * scale)\n h = Math.round(assetHeight * scale)\n }\n return {\n id: createId('clip'),\n trackId: input.trackId,\n assetId: input.assetId,\n startUs: asUs(input.startUs),\n durationUs: asUs(input.durationUs),\n inPointUs: asUs(input.inPointUs ?? 0),\n playbackRate: 1,\n volume: DEFAULT_CLIP_VOLUME,\n muted: false,\n opacity: 1,\n flip: null,\n transform: {\n x: Math.round((project.width - w) / 2),\n y: Math.round((project.height - h) / 2),\n w,\n h,\n angle: 0,\n },\n fadeInUs: asUs(0),\n fadeOutUs: asUs(0),\n }\n}\n\n/** 静态素材(图片 / 文字 / 字幕)需要有限时长 */\nexport function clampStillDuration(us: number): number {\n return us > 0 && Number.isFinite(us) ? us : DEFAULT_STILL_DURATION_US\n}\n\nexport function getClipEnd(clip: TimelineClip): number {\n return clip.startUs + clip.durationUs\n}\n\n/** 工程总时长(取所有 clip 结束时间的最大值) */\nexport function getProjectDuration(project: Project): number {\n return project.clips.reduce((max, c) => Math.max(max, getClipEnd(c)), 0)\n}\n\nexport function getTrack(project: Project, trackId: string): Track | undefined {\n return project.tracks.find((t) => t.id === trackId)\n}\n\nexport function isTrackAudible(project: Project, trackId: string): boolean {\n const track = getTrack(project, trackId)\n if (!track) return false\n return !track.muted && !track.hidden\n}\n\n/** 某轨道上按时间排序的 clip */\nexport function getTrackClips(project: Project, trackId: string): TimelineClip[] {\n return project.clips\n .filter((c) => c.trackId === trackId)\n .sort((a, b) => a.startUs - b.startUs)\n}\n\n/** 轨道内最大结束时间,用于「轨道末尾」吸附点 */\nexport function getTrackEnd(project: Project, trackId: string): number {\n return getTrackClips(project, trackId).reduce((max, c) => Math.max(max, getClipEnd(c)), 0)\n}\n\n/** 源素材被消费的时长 = 时间轴时长 × 速率 */\nexport function getSourceSpanUs(clip: TimelineClip): number {\n return Math.round(clip.durationUs * clip.playbackRate)\n}\n","/**\n * 工程数据的容错归一化。\n *\n * 为什么需要:工程 JSON 是**跨版本、跨来源**的长期文件 ——\n * - 宿主可能手工拼、用脚本生成、或在旧版本里存的(那时还没有 `aspectLocked`\n * 这类后加字段);\n * - 我们自己也持续加字段。\n *\n * 直接把外部 JSON 塞进 store 会让 UI 在 `clip.transform.x` 这类读取上抛\n * \"Cannot read properties of undefined\",而这种错误发生在渲染期,用户只能\n * 看到白屏。这里把所有可选字段补成默认值,并把明显损坏的数值收敛到合法范围,\n * 让「字段缺失」降级为「使用默认值」。\n *\n * 本文件是纯函数,不依赖 WebAV / React。\n */\n\nimport type { ClipTransform, MediaAsset, Project, SubtitleStyle, TextStyle, TimelineClip, Track } from '../types'\nimport { DEFAULT_CLIP_VOLUME, DEFAULT_STILL_DURATION_US } from '../constants'\nimport { createId } from '../lib/id'\nimport { asUs, clamp } from './time'\n\nconst DEFAULT_TEXT_STYLE: TextStyle = {\n fontSize: 64,\n color: '#ffffff',\n fontFamily: 'sans-serif',\n fontWeight: 600,\n fontStyle: 'normal',\n strokeColor: '#000000',\n strokeWidth: 0,\n shadowColor: 'rgba(0,0,0,0.6)',\n shadowBlur: 8,\n align: 'center',\n background: 'transparent',\n}\n\nconst DEFAULT_SUBTITLE_STYLE: SubtitleStyle = {\n color: '#ffffff',\n textBgColor: null,\n fontFamily: 'sans-serif',\n fontSize: 30,\n strokeStyle: '#000000',\n lineWidth: null,\n bottomOffset: 30,\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return value != null && typeof value === 'object' && !Array.isArray(value)\n}\n\n/** 有限数值,否则用兜底值 */\nfunction num(value: unknown, fallback: number): number {\n return typeof value === 'number' && Number.isFinite(value) ? value : fallback\n}\n\nfunction str(value: unknown, fallback: string): string {\n return typeof value === 'string' && value.length > 0 ? value : fallback\n}\n\n/** 补全 clip 的几何变换(缺 transform / 缺子字段都会兜底) */\nexport function normalizeTransform(\n raw: unknown,\n projectWidth: number,\n projectHeight: number,\n): ClipTransform {\n const source = isRecord(raw) ? raw : {}\n const w = Math.max(1, num(source.w, projectWidth))\n const h = Math.max(1, num(source.h, projectHeight))\n return {\n x: num(source.x, Math.round((projectWidth - w) / 2)),\n y: num(source.y, Math.round((projectHeight - h) / 2)),\n w,\n h,\n angle: num(source.angle, 0),\n }\n}\n\nfunction normalizeFlip(raw: unknown): TimelineClip['flip'] {\n return raw === 'horizontal' || raw === 'vertical' ? raw : null\n}\n\n/** 补全单个 clip;`id` 缺失时生成一个,保证后续操作可用 */\nexport function normalizeClip(raw: unknown, projectWidth: number, projectHeight: number): TimelineClip | null {\n if (!isRecord(raw)) return null\n const trackId = typeof raw.trackId === 'string' ? raw.trackId : ''\n const assetId = typeof raw.assetId === 'string' ? raw.assetId : ''\n // 没有轨道或素材引用的 clip 无法渲染,直接丢弃(调用方会收到一条「已跳过」)\n if (trackId === '' || assetId === '') return null\n\n const durationUs = Math.max(0, num(raw.durationUs, 0))\n const normalized: TimelineClip = {\n id: str(raw.id, createId('clip')),\n trackId,\n assetId,\n startUs: asUs(Math.max(0, num(raw.startUs, 0))),\n durationUs: asUs(durationUs),\n inPointUs: asUs(Math.max(0, num(raw.inPointUs, 0))),\n playbackRate: clamp(num(raw.playbackRate, 1), 0.1, 10),\n volume: clamp(num(raw.volume, DEFAULT_CLIP_VOLUME), 0, 4),\n muted: raw.muted === true,\n opacity: clamp(num(raw.opacity, 1), 0, 1),\n flip: normalizeFlip(raw.flip),\n transform: normalizeTransform(raw.transform, projectWidth, projectHeight),\n fadeInUs: asUs(Math.max(0, num(raw.fadeInUs, 0))),\n fadeOutUs: asUs(Math.max(0, num(raw.fadeOutUs, 0))),\n }\n if (raw.aspectLocked === true) normalized.aspectLocked = true\n if (typeof raw.text === 'string') normalized.text = raw.text\n if (isRecord(raw.textStyle)) normalized.textStyle = { ...DEFAULT_TEXT_STYLE, ...raw.textStyle } as TextStyle\n if (typeof raw.srt === 'string') normalized.srt = raw.srt\n if (isRecord(raw.subtitleStyle)) {\n normalized.subtitleStyle = { ...DEFAULT_SUBTITLE_STYLE, ...raw.subtitleStyle } as SubtitleStyle\n }\n return normalized\n}\n\nexport function normalizeTrack(raw: unknown, index: number): Track | null {\n if (!isRecord(raw)) return null\n const kind = raw.kind === 'audio' ? 'audio' : 'visual'\n return {\n id: str(raw.id, createId('track')),\n // 名称缺失时按类型 + 序号给一个可读的默认值\n name: str(raw.name, kind === 'audio' ? `音频 ${index + 1}` : `视频 ${index + 1}`),\n kind,\n locked: raw.locked === true,\n muted: raw.muted === true,\n hidden: raw.hidden === true,\n }\n}\n\n/** 补全工程;轨道为空时补一对默认轨道,否则 clip 无处可放 */\nexport function normalizeProject(raw: unknown): Project | null {\n if (!isRecord(raw)) return null\n const width = Math.max(2, Math.round(num(raw.width, 1280)))\n const height = Math.max(2, Math.round(num(raw.height, 720)))\n\n const tracks = (Array.isArray(raw.tracks) ? raw.tracks : [])\n .map((track, index) => normalizeTrack(track, index))\n .filter((track): track is Track => track != null)\n\n const effectiveTracks =\n tracks.length > 0\n ? tracks\n : [\n { id: createId('track'), name: '视频 1', kind: 'visual' as const, locked: false, muted: false, hidden: false },\n { id: createId('track'), name: '音频 1', kind: 'audio' as const, locked: false, muted: false, hidden: false },\n ]\n const trackIds = new Set(effectiveTracks.map((t) => t.id))\n\n const clips = (Array.isArray(raw.clips) ? raw.clips : [])\n .map((clip) => normalizeClip(clip, width, height))\n .filter((clip): clip is TimelineClip => clip != null)\n // 引用了不存在轨道的 clip 无家可归,丢弃而不是让同步器每帧报错\n .filter((clip) => trackIds.has(clip.trackId))\n\n return {\n id: str(raw.id, createId('project')),\n name: str(raw.name, '未命名工程'),\n width,\n height,\n tracks: effectiveTracks,\n clips,\n updatedAt: num(raw.updatedAt, Date.now()),\n }\n}\n\nconst KINDS = new Set<MediaAsset['kind']>(['video', 'audio', 'image', 'text', 'subtitle'])\n\n/** 补全素材元数据;`kind` 非法的条目直接丢弃(无法决定如何渲染) */\nexport function normalizeAsset(raw: unknown): MediaAsset | null {\n if (!isRecord(raw)) return null\n const kind = KINDS.has(raw.kind as MediaAsset['kind']) ? (raw.kind as MediaAsset['kind']) : null\n if (kind == null) return null\n const id = typeof raw.id === 'string' && raw.id !== '' ? raw.id : createId('asset')\n\n const asset: MediaAsset = {\n id,\n name: str(raw.name, kind === 'video' ? '未命名视频' : '未命名素材'),\n kind,\n mimeType: str(raw.mimeType, 'application/octet-stream'),\n size: Math.max(0, num(raw.size, 0)),\n durationUs: asUs(Math.max(0, num(raw.durationUs, 0))),\n width: Math.max(0, num(raw.width, 0)),\n height: Math.max(0, num(raw.height, 0)),\n hasAudio: raw.hasAudio === true,\n createdAt: num(raw.createdAt, Date.now()),\n }\n\n // 只在内容真实存在时带上,避免给文字素材塞空串后 UI 显示空块\n if (typeof raw.text === 'string') asset.text = raw.text\n if (isRecord(raw.textStyle)) asset.textStyle = { ...DEFAULT_TEXT_STYLE, ...raw.textStyle } as TextStyle\n if (typeof raw.srt === 'string') asset.srt = raw.srt\n if (isRecord(raw.subtitleStyle)) {\n asset.subtitleStyle = { ...DEFAULT_SUBTITLE_STYLE, ...raw.subtitleStyle } as SubtitleStyle\n }\n // 波形是纯派生数据:只接受合法数字数组\n if (Array.isArray(raw.waveform) && raw.waveform.every((v) => typeof v === 'number')) {\n asset.waveform = raw.waveform as number[]\n }\n if (typeof raw.sourcePath === 'string') asset.sourcePath = raw.sourcePath\n\n // 静态素材没有自然时长:存成 0 会导致时间轴上的片段时长为 0\n if (\n (kind === 'image' || kind === 'text' || kind === 'subtitle') &&\n asset.durationUs <= 0\n ) {\n asset.durationUs = asUs(DEFAULT_STILL_DURATION_US)\n }\n return asset\n}\n\nexport { DEFAULT_TEXT_STYLE, DEFAULT_SUBTITLE_STYLE }\n","/**\n * 时间轴编辑操作(纯函数)。\n *\n * 全部返回新的数组/对象,不修改入参;异步部分(如真正切割 IClip 实例)由\n * `core/webav/clip-registry.ts` 负责,模型层只处理时间与轨道数据。\n */\n\nimport type { TimelineClip, Track } from '../types'\nimport { asUs } from './time'\nimport { getClipEnd } from './model'\n\nexport type TrimEdge = 'start' | 'end'\n\n/**\n * 裁剪 clip 的边缘。\n *\n * - start:改变起点与源入点,保持右边缘不动\n * - end:只改变时长\n *\n * `minDurationUs` 保证不会裁成 0 长度。\n */\nexport function trimClipData(\n clip: TimelineClip,\n edge: TrimEdge,\n deltaUs: number,\n minDurationUs = 100_000,\n): TimelineClip {\n const end = getClipEnd(clip)\n\n if (edge === 'start') {\n const nextStart = Math.min(\n Math.max(0, clip.startUs + deltaUs),\n end - minDurationUs,\n )\n const applied = nextStart - clip.startUs\n const sourceDelta = Math.round(applied * clip.playbackRate)\n const nextInPoint = Math.max(0, clip.inPointUs + sourceDelta)\n return {\n ...clip,\n startUs: asUs(nextStart),\n inPointUs: asUs(nextInPoint),\n durationUs: asUs(end - nextStart),\n }\n }\n\n const nextDuration = Math.max(minDurationUs, clip.durationUs + deltaUs)\n return { ...clip, durationUs: asUs(nextDuration) }\n}\n\n/** 删除指定 id 的 clip */\nexport function removeClipsData(clips: TimelineClip[], ids: string[]): TimelineClip[] {\n const set = new Set(ids)\n return clips.filter((c) => !set.has(c.id))\n}\n\n/** 复制 clip,起点顺延 `offsetUs`,返回 { originalId, copy } 便于重建 IClip 实例 */\nexport function duplicateClipsData(\n clips: TimelineClip[],\n ids: string[],\n offsetUs: number,\n makeId: () => string,\n): Array<{ sourceId: string; clip: TimelineClip }> {\n const set = new Set(ids)\n return clips\n .filter((c) => set.has(c.id))\n .map((c) => ({\n sourceId: c.id,\n clip: {\n ...c,\n id: makeId(),\n startUs: asUs(c.startUs + offsetUs),\n transform: { ...c.transform },\n },\n }))\n}\n\n/** 自动排布:把同一轨道上的 clip 按顺序首尾相接(用于「磁吸排序」) */\nexport function compactTrackData(clips: TimelineClip[], trackId: string): TimelineClip[] {\n const onTrack = clips\n .filter((c) => c.trackId === trackId)\n .sort((a, b) => a.startUs - b.startUs)\n let cursor = 0\n const updated = new Map<string, number>()\n for (const c of onTrack) {\n updated.set(c.id, cursor)\n cursor += c.durationUs\n }\n return clips.map((c) => {\n const next = updated.get(c.id)\n return next == null ? c : { ...c, startUs: asUs(next) }\n })\n}\n\n/** 重新排序轨道(拖拽调整垂直顺序) */\nexport function reorderTracksData(tracks: Track[], trackId: string, toIndex: number): Track[] {\n const from = tracks.findIndex((t) => t.id === trackId)\n if (from < 0) return tracks\n const next = [...tracks]\n const [moved] = next.splice(from, 1)\n if (!moved) return tracks\n next.splice(Math.max(0, Math.min(next.length, toIndex)), 0, moved)\n return next\n}\n\n/** 判断两个区间是否重叠(半开区间) */\nexport function rangesOverlap(aStart: number, aEnd: number, bStart: number, bEnd: number): boolean {\n return aStart < bEnd && bStart < aEnd\n}\n\n/** 找出与给定区间在指定轨道上重叠的 clip(排除自身) */\nexport function findOverlaps(\n clips: TimelineClip[],\n trackId: string,\n startUs: number,\n endUs: number,\n excludeId?: string,\n): TimelineClip[] {\n return clips.filter(\n (c) =>\n c.trackId === trackId &&\n c.id !== excludeId &&\n rangesOverlap(startUs, endUs, c.startUs, getClipEnd(c)),\n )\n}\n","/**\n * 画布几何计算(纯函数)。\n *\n * 坐标系:工程分辨率像素(`project.width × project.height`),\n * 与 `clip.transform` 完全一致,也与导出坐标映射的输入一致。\n *\n * 为什么单独放 core:画布的命中测试、自绘选框的手柄布局、缩放反算\n * 这三处必须用同一套数学,否则「点中的框」和「画出的框」会错位。\n */\n\nimport type { ClipTransform } from '../types'\n\n/** 手柄方位。边用 4 个字母,角用两两组合,另加旋转 */\nexport type HandleKey = 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw'\n\nexport const RESIZE_HANDLES: HandleKey[] = ['nw', 'n', 'ne', 'e', 'se', 's', 'sw', 'w']\n\n/** 最小尺寸(工程像素),与 WebAV 的内部控制点下限保持一致 */\nexport const MIN_TRANSFORM_SIZE = 10\n\nexport interface Point {\n x: number\n y: number\n}\n\nexport interface Rect {\n x: number\n y: number\n w: number\n h: number\n}\n\nexport function rectCenter(rect: Rect): Point {\n return { x: rect.x + rect.w / 2, y: rect.y + rect.h / 2 }\n}\n\n/** 角度(度)→ 弧度 */\nexport function degToRad(deg: number): number {\n return (deg * Math.PI) / 180\n}\n\n/**\n * 把世界坐标点转换到矩形自身的局部坐标(以中心为原点、已抵消旋转)。\n *\n * 旋转方向与 Canvas `rotate()` 一致(顺时针为正),因此用 `-angle` 做逆变换。\n */\nexport function toLocalPoint(point: Point, transform: Pick<ClipTransform, 'x' | 'y' | 'w' | 'h' | 'angle'>): Point {\n const cx = transform.x + transform.w / 2\n const cy = transform.y + transform.h / 2\n const rad = -degToRad(transform.angle)\n const dx = point.x - cx\n const dy = point.y - cy\n return {\n x: dx * Math.cos(rad) - dy * Math.sin(rad),\n y: dx * Math.sin(rad) + dy * Math.cos(rad),\n }\n}\n\n/** 局部坐标(相对中心)→ 世界坐标 */\nexport function fromLocalPoint(local: Point, transform: Pick<ClipTransform, 'x' | 'y' | 'w' | 'h' | 'angle'>): Point {\n const cx = transform.x + transform.w / 2\n const cy = transform.y + transform.h / 2\n const rad = degToRad(transform.angle)\n return {\n x: cx + local.x * Math.cos(rad) - local.y * Math.sin(rad),\n y: cy + local.x * Math.sin(rad) + local.y * Math.cos(rad),\n }\n}\n\n/** 点是否落在(可能旋转的)矩形内 */\nexport function pointInTransform(point: Point, transform: ClipTransform): boolean {\n if (transform.w <= 0 || transform.h <= 0) return false\n const local = toLocalPoint(point, transform)\n return Math.abs(local.x) <= transform.w / 2 && Math.abs(local.y) <= transform.h / 2\n}\n\n/**\n * 按方位返回手柄在**局部坐标**中的位置(相对中心)。\n *\n * 边手柄固定一个方向为 0,角手柄两个方向都取半宽/半高。\n */\nexport function handleLocalOffset(handle: HandleKey, w: number, h: number): Point {\n const hw = w / 2\n const hh = h / 2\n const x = handle.includes('w') ? -hw : handle.includes('e') ? hw : 0\n const y = handle.includes('n') ? -hh : handle.includes('s') ? hh : 0\n return { x, y }\n}\n\n/**\n * 计算缩放后的 transform。\n *\n * 采用「固定对角/对边」的直觉行为:拖右边缘时左边缘不动,拖左上角时右下角不动。\n * 指针先被投影到局部坐标轴,因此素材旋转后手柄仍沿自身方向缩放(而不是屏幕方向)。\n *\n * @param start 拖动开始时的 transform 快照\n * @param handle 被拖动的方位\n * @param pointer 当前指针(工程坐标)\n * @param keepAspect\n * - `false`(默认):自由缩放\n * - `true`:所有手柄都等比(Shift 临时约束)\n * - `'corners'`:只有角手柄等比,边手柄仍单维自由\n * (片段自身「锁定宽高比」用这个 —— 若边手柄也等比,\n * 就会出现「拖右边、上下也跟着变」的诡异手感)\n */\nexport function resizeTransform(\n start: ClipTransform,\n handle: HandleKey,\n pointer: Point,\n keepAspect: boolean | 'corners' = false,\n): ClipTransform {\n const local = toLocalPoint(pointer, start)\n const hw = start.w / 2\n const hh = start.h / 2\n\n // 局部坐标下的四条边;拖动某条边只改它,其余固定不动(= 固定对角/对边)\n let left = -hw\n let right = hw\n let top = -hh\n let bottom = hh\n\n if (handle.includes('w')) left = Math.min(local.x, right - MIN_TRANSFORM_SIZE)\n if (handle.includes('e')) right = Math.max(local.x, left + MIN_TRANSFORM_SIZE)\n if (handle.includes('n')) top = Math.min(local.y, bottom - MIN_TRANSFORM_SIZE)\n if (handle.includes('s')) bottom = Math.max(local.y, top + MIN_TRANSFORM_SIZE)\n\n let nextW = right - left\n let nextH = bottom - top\n\n const isCorner = handle.length === 2\n const aspectActive = keepAspect === true || (keepAspect === 'corners' && isCorner)\n\n if (aspectActive && start.w > 0 && start.h > 0) {\n const ratio = start.w / start.h\n if (isCorner) {\n // 以宽为准反算高,再按被拖动的方向贴住不动的对边\n nextH = nextW / ratio\n if (handle.includes('n')) top = bottom - nextH\n else bottom = top + nextH\n } else if (handle === 'e' || handle === 'w') {\n nextH = nextW / ratio\n top = -nextH / 2\n bottom = nextH / 2\n } else {\n nextW = nextH * ratio\n left = -nextW / 2\n right = nextW / 2\n }\n }\n\n nextW = Math.max(MIN_TRANSFORM_SIZE, right - left)\n nextH = Math.max(MIN_TRANSFORM_SIZE, bottom - top)\n\n // 新中心(局部坐标)→ 世界坐标 → 左上角\n const localCenter = { x: (left + right) / 2, y: (top + bottom) / 2 }\n const worldCenter = fromLocalPoint(localCenter, start)\n return {\n x: worldCenter.x - nextW / 2,\n y: worldCenter.y - nextH / 2,\n w: nextW,\n h: nextH,\n angle: start.angle,\n }\n}\n\n/** 把角度归一化到 (-180, 180],避免旋转多圈后数值无限增大 */\nexport function normalizeAngle(deg: number): number {\n let a = deg % 360\n if (a > 180) a -= 360\n if (a <= -180) a += 360\n return a\n}\n\n/** 按手柄方位给出鼠标光标(已考虑素材自身旋转) */\nexport function handleCursor(handle: HandleKey | 'rotate', angleDeg: number): string {\n if (handle === 'rotate') return 'grab'\n const base: Record<HandleKey, number> = {\n n: 0,\n ne: 45,\n e: 90,\n se: 135,\n s: 180,\n sw: 225,\n w: 270,\n nw: 315,\n }\n const cursors = ['ns-resize', 'nesw-resize', 'ew-resize', 'nwse-resize']\n // 把素材旋转叠加到手柄方位上,再落到 4 档光标\n const deg = ((base[handle] + angleDeg) % 180 + 180) % 180\n const index = Math.round(deg / 45) % 4\n return cursors[index] ?? 'default'\n}\n\n/** 两个尺寸是否近似相等(避免浮点噪声导致无谓的 store 写入) */\nexport function sameTransform(a: ClipTransform, b: ClipTransform, epsilon = 0.5): boolean {\n return (\n Math.abs(a.x - b.x) < epsilon &&\n Math.abs(a.y - b.y) < epsilon &&\n Math.abs(a.w - b.w) < epsilon &&\n Math.abs(a.h - b.h) < epsilon &&\n Math.abs(a.angle - b.angle) < epsilon\n )\n}\n","/**\n * 画布(工程)尺寸与比例。\n *\n * 为什么需要单独一层:时间轴里所有 `clip.transform` 都以工程分辨率为坐标系,\n * 换比例时如果不做变换,1280×720 里铺满的素材放到 1080×1920 画布里就会\n * 只剩顶部一条 —— 这正是「换了比例看起来没生效 / 画面全是黑的」的成因。\n *\n * 因此尺寸变更分两种语义:\n * - `scale`(保持构图):把所有素材按同样的比例缩放并平移,视觉上「整幅画面\n * 被重新装进新画布」,适合横屏切竖屏、改分辨率。\n * - `keep`(保持素材原样):只换画布,素材坐标原封不动,适合「画布留白变多」。\n *\n * 纯函数,不依赖 React。\n */\n\nimport type { ClipTransform, Project, TimelineClip } from '../types'\n\nexport interface AspectPreset {\n id: string\n label: string\n hint: string\n width: number\n height: number\n}\n\n/**\n * 常用比例预设。\n *\n * 尺寸都取该比例下「编辑器默认档」的常见值:横屏 720p、竖屏 720×1280、\n * 方形 1080×1080、竖版 1080×1920、横版 1920×1080。用户也可以自定义。\n */\nexport const ASPECT_PRESETS: AspectPreset[] = [\n { id: '16:9', label: '16:9', hint: '横屏 1280×720', width: 1280, height: 720 },\n { id: '9:16', label: '9:16', hint: '竖屏 720×1280', width: 720, height: 1280 },\n { id: '1:1', label: '1:1', hint: '方形 1080×1080', width: 1080, height: 1080 },\n { id: '4:3', label: '4:3', hint: '标准 960×720', width: 960, height: 720 },\n { id: '3:4', label: '3:4', hint: '竖版 720×960', width: 720, height: 960 },\n { id: '4:5', label: '4:5', hint: '社交媒体 864×1080', width: 864, height: 1080 },\n { id: '21:9', label: '21:9', hint: '宽银幕 1680×720', width: 1680, height: 720 },\n]\n\nexport type SizeChangeMode = 'scale' | 'keep'\n\n/** 求最大公约数(用于把尺寸化简成比例) */\nfunction gcd(a: number, b: number): number {\n let x = Math.abs(Math.round(a))\n let y = Math.abs(Math.round(b))\n while (y > 0) {\n const t = x % y\n x = y\n y = t\n }\n return x || 1\n}\n\n/** `1920×1080` → `16:9`;无法化简时返回 `1920:1080` 形式 */\nexport function ratioLabel(width: number, height: number): string {\n if (width <= 0 || height <= 0) return '—'\n const divisor = gcd(width, height)\n return `${width / divisor}:${height / divisor}`\n}\n\n/** 保留两位小数,避免属性面板里出现 123.456789 */\nfunction round2(n: number): number {\n return Math.round(n * 100) / 100\n}\n\n/**\n * 把素材几何从 `from` 画布映射到 `to` 画布。\n *\n * 用**同一个**缩放系数(取宽高比中较小者),保证素材不变形:\n * 16:9 → 9:16 时画面按高度缩小、水平居中,两侧留黑 —— 与剪辑软件里\n * 「按比例适配」的行为一致。若分别按宽、高缩放,人物会被横向拉扁。\n */\nexport function remapTransform(\n transform: ClipTransform,\n from: { width: number; height: number },\n to: { width: number; height: number },\n): ClipTransform {\n const fromW = Math.max(1, from.width)\n const fromH = Math.max(1, from.height)\n const scale = Math.min(to.width / fromW, to.height / fromH)\n const centerX = (transform.x + transform.w / 2) * scale + (to.width - fromW * scale) / 2\n const centerY = (transform.y + transform.h / 2) * scale + (to.height - fromH * scale) / 2\n const w = transform.w * scale\n const h = transform.h * scale\n return {\n x: round2(centerX - w / 2),\n y: round2(centerY - h / 2),\n w: round2(w),\n h: round2(h),\n angle: transform.angle,\n }\n}\n\n/**\n * 根据模式生成新的 clips 数组。\n *\n * @param mode `scale` = 素材随画布等比缩放;`keep` = 素材坐标不动\n */\nexport function remapClipsForSize(\n clips: TimelineClip[],\n from: { width: number; height: number },\n to: { width: number; height: number },\n mode: SizeChangeMode,\n): TimelineClip[] {\n if (mode === 'keep') return clips\n return clips.map((clip) => ({\n ...clip,\n transform: remapTransform(clip.transform, from, to),\n }))\n}\n\n/** 判断工程是否已是非标尺寸(不在预设里) */\nexport function isCustomSize(project: Project): boolean {\n return !ASPECT_PRESETS.some((p) => p.width === project.width && p.height === project.height)\n}\n\n/** 尺寸合法化:不小于 16,偶数(编码器要求) */\nexport function normalizeSize(width: number, height: number): { width: number; height: number } {\n const even = (n: number) => Math.max(16, Math.round(n / 2) * 2)\n return { width: even(width), height: even(height) }\n}\n"],"mappings":"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"}
@@ -1,4 +1,5 @@
1
- import { _ as DEFAULT_STILL_DURATION_US, g as DEFAULT_CLIP_VOLUME, h as createId, i as asUs } from "./time-C_gvkVl1.js";
1
+ import { n as DEFAULT_CLIP_VOLUME, r as DEFAULT_STILL_DURATION_US, t as createId } from "./id-CJsdlGei.js";
2
+ import { i as asUs, o as clamp } from "./time-ChF1GwCy.js";
2
3
  // src/timeline/model.ts
3
4
  /**
4
5
  * 时间轴纯数据模型与工厂函数。
@@ -91,39 +92,176 @@ function getTrackEnd(project, trackId) {
91
92
  function getSourceSpanUs(clip) {
92
93
  return Math.round(clip.durationUs * clip.playbackRate);
93
94
  }
94
- // src/timeline/ops.ts
95
- /** 在时间轴时刻 `atUs` 分割 clip,返回 [左, 右];时刻不在 clip 内部时返回 null */
96
- function splitClipData(clip, atUs) {
97
- const start = clip.startUs;
98
- const end = getClipEnd(clip);
99
- if (atUs <= start || atUs >= end) return null;
100
- const leftDuration = atUs - start;
101
- const rightDuration = end - atUs;
102
- const sourceOffset = Math.round(leftDuration * clip.playbackRate);
103
- const left = {
104
- ...clip,
105
- durationUs: asUs(leftDuration),
106
- fadeOutUs: asUs(Math.min(clip.fadeOutUs, leftDuration))
95
+ // src/timeline/normalize.ts
96
+ var DEFAULT_TEXT_STYLE = {
97
+ fontSize: 64,
98
+ color: "#ffffff",
99
+ fontFamily: "sans-serif",
100
+ fontWeight: 600,
101
+ fontStyle: "normal",
102
+ strokeColor: "#000000",
103
+ strokeWidth: 0,
104
+ shadowColor: "rgba(0,0,0,0.6)",
105
+ shadowBlur: 8,
106
+ align: "center",
107
+ background: "transparent"
108
+ };
109
+ var DEFAULT_SUBTITLE_STYLE = {
110
+ color: "#ffffff",
111
+ textBgColor: null,
112
+ fontFamily: "sans-serif",
113
+ fontSize: 30,
114
+ strokeStyle: "#000000",
115
+ lineWidth: null,
116
+ bottomOffset: 30
117
+ };
118
+ function isRecord(value) {
119
+ return value != null && typeof value === "object" && !Array.isArray(value);
120
+ }
121
+ /** 有限数值,否则用兜底值 */
122
+ function num(value, fallback) {
123
+ return typeof value === "number" && Number.isFinite(value) ? value : fallback;
124
+ }
125
+ function str(value, fallback) {
126
+ return typeof value === "string" && value.length > 0 ? value : fallback;
127
+ }
128
+ /** 补全 clip 的几何变换(缺 transform / 缺子字段都会兜底) */
129
+ function normalizeTransform(raw, projectWidth, projectHeight) {
130
+ const source = isRecord(raw) ? raw : {};
131
+ const w = Math.max(1, num(source.w, projectWidth));
132
+ const h = Math.max(1, num(source.h, projectHeight));
133
+ return {
134
+ x: num(source.x, Math.round((projectWidth - w) / 2)),
135
+ y: num(source.y, Math.round((projectHeight - h) / 2)),
136
+ w,
137
+ h,
138
+ angle: num(source.angle, 0)
107
139
  };
108
- const right = {
109
- ...clip,
110
- id: `${clip.id}_r`,
111
- startUs: asUs(atUs),
112
- durationUs: asUs(rightDuration),
113
- inPointUs: asUs(clip.inPointUs + sourceOffset),
114
- fadeInUs: asUs(Math.min(clip.fadeInUs, rightDuration))
140
+ }
141
+ function normalizeFlip(raw) {
142
+ return raw === "horizontal" || raw === "vertical" ? raw : null;
143
+ }
144
+ /** 补全单个 clip;`id` 缺失时生成一个,保证后续操作可用 */
145
+ function normalizeClip(raw, projectWidth, projectHeight) {
146
+ if (!isRecord(raw)) return null;
147
+ const trackId = typeof raw.trackId === "string" ? raw.trackId : "";
148
+ const assetId = typeof raw.assetId === "string" ? raw.assetId : "";
149
+ if (trackId === "" || assetId === "") return null;
150
+ const durationUs = Math.max(0, num(raw.durationUs, 0));
151
+ const normalized = {
152
+ id: str(raw.id, createId("clip")),
153
+ trackId,
154
+ assetId,
155
+ startUs: asUs(Math.max(0, num(raw.startUs, 0))),
156
+ durationUs: asUs(durationUs),
157
+ inPointUs: asUs(Math.max(0, num(raw.inPointUs, 0))),
158
+ playbackRate: clamp(num(raw.playbackRate, 1), .1, 10),
159
+ volume: clamp(num(raw.volume, DEFAULT_CLIP_VOLUME), 0, 4),
160
+ muted: raw.muted === true,
161
+ opacity: clamp(num(raw.opacity, 1), 0, 1),
162
+ flip: normalizeFlip(raw.flip),
163
+ transform: normalizeTransform(raw.transform, projectWidth, projectHeight),
164
+ fadeInUs: asUs(Math.max(0, num(raw.fadeInUs, 0))),
165
+ fadeOutUs: asUs(Math.max(0, num(raw.fadeOutUs, 0)))
166
+ };
167
+ if (raw.aspectLocked === true) normalized.aspectLocked = true;
168
+ if (typeof raw.text === "string") normalized.text = raw.text;
169
+ if (isRecord(raw.textStyle)) normalized.textStyle = {
170
+ ...DEFAULT_TEXT_STYLE,
171
+ ...raw.textStyle
115
172
  };
116
- left.fadeInUs = asUs(Math.min(clip.fadeInUs, leftDuration));
117
- return [left, right];
173
+ if (typeof raw.srt === "string") normalized.srt = raw.srt;
174
+ if (isRecord(raw.subtitleStyle)) normalized.subtitleStyle = {
175
+ ...DEFAULT_SUBTITLE_STYLE,
176
+ ...raw.subtitleStyle
177
+ };
178
+ return normalized;
118
179
  }
119
- /** 移动 clip:更新轨道与起点(不允许早于 0) */
120
- function moveClipData(clip, trackId, startUs) {
180
+ function normalizeTrack(raw, index) {
181
+ if (!isRecord(raw)) return null;
182
+ const kind = raw.kind === "audio" ? "audio" : "visual";
121
183
  return {
122
- ...clip,
123
- trackId,
124
- startUs: asUs(Math.max(0, startUs))
184
+ id: str(raw.id, createId("track")),
185
+ name: str(raw.name, kind === "audio" ? `音频 ${index + 1}` : `视频 ${index + 1}`),
186
+ kind,
187
+ locked: raw.locked === true,
188
+ muted: raw.muted === true,
189
+ hidden: raw.hidden === true
125
190
  };
126
191
  }
192
+ /** 补全工程;轨道为空时补一对默认轨道,否则 clip 无处可放 */
193
+ function normalizeProject(raw) {
194
+ if (!isRecord(raw)) return null;
195
+ const width = Math.max(2, Math.round(num(raw.width, 1280)));
196
+ const height = Math.max(2, Math.round(num(raw.height, 720)));
197
+ const tracks = (Array.isArray(raw.tracks) ? raw.tracks : []).map((track, index) => normalizeTrack(track, index)).filter((track) => track != null);
198
+ const effectiveTracks = tracks.length > 0 ? tracks : [{
199
+ id: createId("track"),
200
+ name: "视频 1",
201
+ kind: "visual",
202
+ locked: false,
203
+ muted: false,
204
+ hidden: false
205
+ }, {
206
+ id: createId("track"),
207
+ name: "音频 1",
208
+ kind: "audio",
209
+ locked: false,
210
+ muted: false,
211
+ hidden: false
212
+ }];
213
+ const trackIds = new Set(effectiveTracks.map((t) => t.id));
214
+ const clips = (Array.isArray(raw.clips) ? raw.clips : []).map((clip) => normalizeClip(clip, width, height)).filter((clip) => clip != null).filter((clip) => trackIds.has(clip.trackId));
215
+ return {
216
+ id: str(raw.id, createId("project")),
217
+ name: str(raw.name, "未命名工程"),
218
+ width,
219
+ height,
220
+ tracks: effectiveTracks,
221
+ clips,
222
+ updatedAt: num(raw.updatedAt, Date.now())
223
+ };
224
+ }
225
+ var KINDS = /* @__PURE__ */ new Set([
226
+ "video",
227
+ "audio",
228
+ "image",
229
+ "text",
230
+ "subtitle"
231
+ ]);
232
+ /** 补全素材元数据;`kind` 非法的条目直接丢弃(无法决定如何渲染) */
233
+ function normalizeAsset(raw) {
234
+ if (!isRecord(raw)) return null;
235
+ const kind = KINDS.has(raw.kind) ? raw.kind : null;
236
+ if (kind == null) return null;
237
+ const asset = {
238
+ id: typeof raw.id === "string" && raw.id !== "" ? raw.id : createId("asset"),
239
+ name: str(raw.name, kind === "video" ? "未命名视频" : "未命名素材"),
240
+ kind,
241
+ mimeType: str(raw.mimeType, "application/octet-stream"),
242
+ size: Math.max(0, num(raw.size, 0)),
243
+ durationUs: asUs(Math.max(0, num(raw.durationUs, 0))),
244
+ width: Math.max(0, num(raw.width, 0)),
245
+ height: Math.max(0, num(raw.height, 0)),
246
+ hasAudio: raw.hasAudio === true,
247
+ createdAt: num(raw.createdAt, Date.now())
248
+ };
249
+ if (typeof raw.text === "string") asset.text = raw.text;
250
+ if (isRecord(raw.textStyle)) asset.textStyle = {
251
+ ...DEFAULT_TEXT_STYLE,
252
+ ...raw.textStyle
253
+ };
254
+ if (typeof raw.srt === "string") asset.srt = raw.srt;
255
+ if (isRecord(raw.subtitleStyle)) asset.subtitleStyle = {
256
+ ...DEFAULT_SUBTITLE_STYLE,
257
+ ...raw.subtitleStyle
258
+ };
259
+ if (Array.isArray(raw.waveform) && raw.waveform.every((v) => typeof v === "number")) asset.waveform = raw.waveform;
260
+ if (typeof raw.sourcePath === "string") asset.sourcePath = raw.sourcePath;
261
+ if ((kind === "image" || kind === "text" || kind === "subtitle") && asset.durationUs <= 0) asset.durationUs = asUs(DEFAULT_STILL_DURATION_US);
262
+ return asset;
263
+ }
264
+ // src/timeline/ops.ts
127
265
  /**
128
266
  * 裁剪 clip 的边缘。
129
267
  *
@@ -493,6 +631,6 @@ function normalizeSize(width, height) {
493
631
  height: even(height)
494
632
  };
495
633
  }
496
- export { createEmptyProject as A, rangesOverlap as C, trimClipData as D, splitClipData as E, getTrack as F, getTrackClips as I, getTrackEnd as L, getClipEnd as M, getProjectDuration as N, clampStillDuration as O, getSourceSpanUs as P, isTrackAudible as R, moveClipData as S, reorderTracksData as T, sameTransform as _, remapClipsForSize as a, duplicateClipsData as b, RESIZE_HANDLES as c, handleCursor as d, handleLocalOffset as f, resizeTransform as g, rectCenter as h, ratioLabel as i, createTrack as j, createClip as k, degToRad as l, pointInTransform as m, isCustomSize as n, remapTransform as o, normalizeAngle as p, normalizeSize as r, MIN_TRANSFORM_SIZE as s, ASPECT_PRESETS as t, fromLocalPoint as u, toLocalPoint as v, removeClipsData as w, findOverlaps as x, compactTrackData as y };
634
+ export { normalizeProject as A, getTrack as B, removeClipsData as C, DEFAULT_TEXT_STYLE as D, DEFAULT_SUBTITLE_STYLE as E, createEmptyProject as F, getTrackEnd as H, createTrack as I, getClipEnd as L, normalizeTransform as M, clampStillDuration as N, normalizeAsset as O, createClip as P, getProjectDuration as R, rangesOverlap as S, trimClipData as T, isTrackAudible as U, getTrackClips as V, sameTransform as _, remapClipsForSize as a, duplicateClipsData as b, RESIZE_HANDLES as c, handleCursor as d, handleLocalOffset as f, resizeTransform as g, rectCenter as h, ratioLabel as i, normalizeTrack as j, normalizeClip as k, degToRad as l, pointInTransform as m, isCustomSize as n, remapTransform as o, normalizeAngle as p, normalizeSize as r, MIN_TRANSFORM_SIZE as s, ASPECT_PRESETS as t, fromLocalPoint as u, toLocalPoint as v, reorderTracksData as w, findOverlaps as x, compactTrackData as y, getSourceSpanUs as z };
497
635
 
498
- //# sourceMappingURL=canvas-size-CM2oKApi.js.map
636
+ //# sourceMappingURL=canvas-size-Dlnng74w.js.map