@cut-workbench/core 0.3.1 → 0.4.1

package/dist/engine/index.cjs

@@ -1,7 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_canvas_size = require("../chunks/canvas-size-IzoEg2cq.cjs");
-const require_waveform = require("../chunks/waveform-Bhvv2t7-.cjs");
+const require_rolldown_runtime = require("../chunks/rolldown-runtime-B2SfzNBj.cjs");
+const require_id = require("../chunks/id-DaCxD4-5.cjs");
+const require_time = require("../chunks/time-CYEd91qN.cjs");
+const require_canvas_size = require("../chunks/canvas-size-DIABzEW2.cjs");
+const require_waveform = require("../chunks/waveform-BYwDdKpC.cjs");
 const require_file_reader = require("../chunks/file-reader-DfMEluGr.cjs");
+const require_thumbnails = require("../chunks/thumbnails-DEjnao5r.cjs");
 let _webav_av_cliper = require("@webav/av-cliper");
 let _webav_av_canvas = require("@webav/av-canvas");
 // src/engine/webav/styles.ts
@@ -223,7 +227,7 @@ async function createClipFromFile(file, kind) {
 			return {
 				clip,
 				meta: {
-					durationUs: Number.isFinite(meta.duration) ? meta.duration : require_canvas_size.DEFAULT_STILL_DURATION_US,
+					durationUs: Number.isFinite(meta.duration) ? meta.duration : require_id.DEFAULT_STILL_DURATION_US,
 					width: meta.width,
 					height: meta.height,
 					hasAudio: false
@@ -240,7 +244,7 @@ async function createClipFromFile(file, kind) {
 			return {
 				clip,
 				meta: {
-					durationUs: Number.isFinite(meta.duration) ? meta.duration : require_canvas_size.DEFAULT_STILL_DURATION_US,
+					durationUs: Number.isFinite(meta.duration) ? meta.duration : require_id.DEFAULT_STILL_DURATION_US,
 					width: meta.width,
 					height: meta.height,
 					hasAudio: false
@@ -310,7 +314,10 @@ var OffsetClip = class OffsetClip {
 			height: 0,
 			duration: opts.durationUs
 		};
-		this.ready = inner.ready.then((meta) => {
+		this.ready = inner.ready.then(async (meta) => {
+			try {
+				await inner.tick(opts.inPointUs);
+			} catch {}
 			this.metaValue = {
 				width: meta.width,
 				height: meta.height,
@@ -356,49 +363,6 @@ var OffsetClip = class OffsetClip {
 		this.inner.destroy();
 	}
 };
-// src/media/thumbnails.ts
-var cache = /* @__PURE__ */ new Map();
-/**
-* 生成等间隔缩略图条。
-*
-* @param clip MP4Clip 实例（调用方负责生命周期）
-* @param assetId 缓存 key
-* @param count 期望张数
-* @param durationUs 素材总时长，用来算 step
-* @param width 单张宽度
-*/
-async function generateThumbnails(clip, assetId, count, durationUs, width = 100) {
-	const cached = cache.get(assetId);
-	if (cached) return cached;
-	const stepUs = Math.max(Math.floor(durationUs / count), require_canvas_size.usToMs(200));
-	const raw = await clip.thumbnails(width, {
-		start: 0,
-		end: Math.max(0, durationUs - 1),
-		step: stepUs
-	});
-	const picked = [];
-	if (raw.length <= count) picked.push(...raw);
-	else {
-		const stride = raw.length / count;
-		for (let i = 0; i < count; i += 1) {
-			const item = raw[Math.min(raw.length - 1, Math.floor(i * stride))];
-			if (item) picked.push(item);
-		}
-	}
-	const frames = picked.map((item) => ({
-		ts: item.ts,
-		url: URL.createObjectURL(item.img)
-	}));
-	cache.set(assetId, frames);
-	return frames;
-}
-/** 释放某素材的缩略图 URL */
-function releaseThumbnails(assetId) {
-	const frames = cache.get(assetId);
-	if (!frames) return;
-	for (const f of frames) URL.revokeObjectURL(f.url);
-	cache.delete(assetId);
-}
 // src/engine/webav/clip-registry.ts
 var ClipRegistry = class {
 	assets = /* @__PURE__ */ new Map();
@@ -508,7 +472,7 @@ var ClipRegistry = class {
 			runtime?.master?.destroy();
 		} catch {}
 		this.assets.delete(assetId);
-		releaseThumbnails(assetId);
+		require_thumbnails.releaseThumbnails(assetId);
 	}
 	destroyAllInstances() {
 		for (const [id] of this.derived) this.destroyInstance(id);
@@ -520,7 +484,7 @@ var ClipRegistry = class {
 			try {
 				runtime.master?.destroy();
 			} catch {}
-			releaseThumbnails(assetId);
+			require_thumbnails.releaseThumbnails(assetId);
 		}
 		this.assets.clear();
 	}
@@ -834,22 +798,39 @@ function createEditorRuntime() {
 		}
 	};
 }
+// src/lib/error.ts
+/**
+* 异常 → 可展示文本。
+*
+* 各模块都会在 catch 里把 `unknown` 转成字符串，集中一处避免多份实现漂移。
+*/
+function errorMessage(err) {
+	return err instanceof Error ? err.message : String(err);
+}
 // src/editor/create-editor.ts
 function resolveBridge(bridge) {
 	if (bridge != null) return bridge;
 	return require_waveform.createWebBridge();
 }
+var loadImportFiles = () => Promise.resolve().then(() => import_files_exports);
+var loadImportPipeline = () => Promise.resolve().then(() => import_pipeline_exports);
+var loadExportRunner = () => Promise.resolve().then(() => export_runner_exports);
 /**
 * 创建编辑器实例。
 *
-* 不加载 WebAV：`engine` 子入口需要由调用方按需 `await import()`，因为 opfs-tools
+* 不加载 WebAV：引擎模块在首次导入素材 / 导出时才动态加载 —— opfs-tools
 * 在模块加载期就会访问 `navigator.storage`，非 Chromium 环境会直接抛错。
 */
 function createEditor(options = {}) {
 	const id = `editor_${Math.random().toString(36).slice(2, 10)}`;
 	const bridge = resolveBridge(options.bridge);
-	const storage = options.storage ?? require_waveform.createMemoryStorage();
-	const namespace = options.namespace ?? "default";
+	let storage = options.storage ?? require_waveform.createMemoryStorage();
+	let namespace = options.namespace ?? "default";
+	let autoSave = options.autoSave ?? null;
+	const initialProject = options.project ?? (options.projectId != null && options.projectId !== "" ? {
+		...require_canvas_size.createEmptyProject(),
+		id: options.projectId
+	} : require_canvas_size.createEmptyProject());
 	const bus = require_waveform.createEventBus((err) => {
 		bus.emit("error", {
 			scope: "event-listener",
@@ -858,19 +839,91 @@ function createEditor(options = {}) {
 	});
 	const history = require_waveform.createHistoryStore();
 	const store = require_waveform.createEditorStore({
-		history,
-		project: options.project,
-		assets: options.assets
+		project: initialProject,
+		assets: options.assets,
+		history
 	});
 	const runtime = createEditorRuntime();
 	let disposed = false;
 	let lastPlaying = false;
+	let capabilityPromise = null;
+	/** 防抖计时器：最后一次变更后等待 intervalMs 再写盘 */
+	let autoSaveTimer = null;
+	/** 串行化写盘：自动保存与手动保存永不并发（并发会交错写同一 namespace） */
+	let saveChain = Promise.resolve({ ok: true });
 	let prevProject = store.getState().project;
 	let prevAssets = store.getState().assets;
 	let prevSelection = store.getState().selectedClipIds;
 	let prevAssetId = store.getState().selectedAssetId;
 	let prevPlayhead = store.getState().playheadUs;
 	let prevCanUndo = history.getState().canUndo();
+	let prevDirty = store.getState().dirty;
+	/** 当前写盘的存储与命名空间（autoSave 指定了自己的目标时以它为准） */
+	function saveTarget() {
+		if (autoSave != null) return {
+			port: autoSave.storage,
+			ns: autoSave.namespace
+		};
+		return {
+			port: storage,
+			ns: namespace
+		};
+	}
+	/**
+	* 自动保存调度（防抖）。
+	*
+	* 语义是「最后一次结构性变更后静置 intervalMs 才写盘」，而不是
+	* 「第一次变更后固定 intervalMs 写盘」：
+	* 后者在持续编辑（拖滑块、连续裁剪）时会中途写一次，既浪费 I/O，
+	* 又会在宿主展示「保存中」时产生无意义的闪烁。每次新变更都重置计时器。
+	*/
+	function scheduleAutoSave() {
+		if (autoSave == null || disposed) return;
+		if (autoSaveTimer != null) clearTimeout(autoSaveTimer);
+		autoSaveTimer = setTimeout(() => {
+			autoSaveTimer = null;
+			enqueueSave().catch((err) => {
+				bus.emit("error", {
+					scope: "auto-save",
+					error: err
+				});
+			});
+		}, autoSave.intervalMs ?? 2e3);
+	}
+	/** 把一次保存排进队列，返回该次保存的结果 */
+	function enqueueSave() {
+		const run = saveChain.then(() => writeProject());
+		saveChain = run.catch(() => ({ ok: false }));
+		return run;
+	}
+	/** 真正写盘 + 广播 project:saved */
+	async function writeProject() {
+		const { port, ns } = saveTarget();
+		const projectAtStart = store.getState().project;
+		const result = await port.save(ns, editor.serialize());
+		const changedDuringSave = store.getState().project !== projectAtStart;
+		if (result.ok) {
+			if (!changedDuringSave) store.getState().markSaved();
+			else scheduleAutoSave();
+			bus.emit("project:saved", result.path != null ? {
+				ok: true,
+				path: result.path
+			} : { ok: true });
+		} else bus.emit("project:saved", {
+			ok: false,
+			...result.error != null ? { error: result.error } : {},
+			...result.path != null ? { path: result.path } : {}
+		});
+		return result;
+	}
+	/** 卸载 / 关闭前把待写的防抖任务立刻执行 */
+	function flushAutoSave() {
+		if (autoSaveTimer != null) {
+			clearTimeout(autoSaveTimer);
+			autoSaveTimer = null;
+		}
+		return enqueueSave();
+	}
 	const unsubscribeStore = store.subscribe((state) => {
 		if (disposed) return;
 		if (state.project !== prevProject) {
@@ -879,6 +932,11 @@ function createEditor(options = {}) {
 				project: state.project,
 				dirty: state.dirty
 			});
+			if (autoSave != null) scheduleAutoSave();
+		}
+		if (state.dirty !== prevDirty) {
+			prevDirty = state.dirty;
+			bus.emit("project:dirty", { dirty: state.dirty });
 		}
 		if (state.assets !== prevAssets) {
 			prevAssets = state.assets;
@@ -915,9 +973,28 @@ function createEditor(options = {}) {
 		history,
 		runtime,
 		bridge,
-		storage,
+		get storage() {
+			return saveTarget().port;
+		},
 		events: bus,
+		commands: {
+			updateClip: (clipId, patch, recordHistory, mergeKey) => store.getState().updateClip(clipId, patch, recordHistory, mergeKey),
+			moveClip: (clipId, trackId, startUs, recordHistory) => store.getState().moveClip(clipId, trackId, startUs, recordHistory),
+			trimClip: (clipId, edge, deltaUs, recordHistory) => store.getState().trimClip(clipId, edge, deltaUs, recordHistory),
+			splitClipsAt: (atUs, clipIds) => store.getState().splitClipsAt(atUs, clipIds),
+			duplicateSelection: (offsetUs) => store.getState().duplicateSelection(offsetUs),
+			addTrack: (kind) => store.getState().addTrack(kind),
+			removeTrack: (trackId) => store.getState().removeTrack(trackId),
+			updateTrack: (trackId, patch) => store.getState().updateTrack(trackId, patch)
+		},
 		getProject: () => store.getState().project,
+		getProjectId: () => store.getState().project.id,
+		setProjectId(nextId) {
+			if (nextId === store.getState().project.id) return;
+			store.getState().setProjectId(nextId);
+		},
+		renameProject: (name) => store.getState().renameProject(name),
+		setProjectSize: (width, height, mode) => store.getState().setProjectSize(width, height, mode),
 		getAssets: () => store.getState().assets,
 		getState: () => store.getState(),
 		setProject(project, assets, missingAssetIds = []) {
@@ -925,17 +1002,135 @@ function createEditor(options = {}) {
 			history.getState().clear();
 		},
 		serialize: () => require_waveform.serializeProject(store.getState().project, store.getState().assets),
+		exportJson: () => require_waveform.serializeProject(store.getState().project, store.getState().assets),
 		async load(input) {
 			if ("schemaVersion" in input) {
 				const { project, assets, missingAssetIds } = require_waveform.deserializeProject(input);
 				editor.setProject(project, assets, missingAssetIds);
+				bus.emit("project:loaded", {
+					project,
+					assetCount: assets.length,
+					missing: missingAssetIds.length
+				});
 				return;
 			}
 			editor.setProject(input, []);
+			bus.emit("project:loaded", {
+				project: input,
+				assetCount: 0,
+				missing: 0
+			});
+		},
+		async importJson(data, importOptions = {}) {
+			const { project, assets, missingAssetIds } = require_waveform.deserializeProject(data);
+			editor.setProject(project, assets, missingAssetIds);
+			const stillMissing = new Set(missingAssetIds);
+			if (importOptions.resolveFile != null) {
+				const { importFile } = await loadImportPipeline();
+				for (const asset of assets) {
+					if (asset.kind === "text" || asset.kind === "subtitle") continue;
+					let file;
+					try {
+						file = await importOptions.resolveFile(asset);
+					} catch (err) {
+						bus.emit("error", {
+							scope: "import-json:resolve-file",
+							error: err
+						});
+						continue;
+					}
+					if (file == null) continue;
+					try {
+						const result = await importFile(runtime.clips, file, void 0, { id: asset.id });
+						const { regenerateDerived } = await loadImportPipeline();
+						const withDerived = await regenerateDerived(runtime.clips, result.asset, file);
+						store.getState().replaceAsset(asset.id, {
+							...withDerived,
+							id: asset.id
+						});
+						stillMissing.delete(asset.id);
+					} catch (err) {
+						bus.emit("error", {
+							scope: "import-json:reconnect",
+							error: err
+						});
+					}
+				}
+			}
+			const remaining = [...stillMissing];
+			store.getState().setMissingAssetIds(remaining);
+			bus.emit("project:loaded", {
+				project: store.getState().project,
+				assetCount: assets.length,
+				missing: remaining.length
+			});
+			return { missingAssetIds: remaining };
 		},
 		async save() {
-			const data = editor.serialize();
-			return storage.save(namespace, data);
+			return enqueueSave();
+		},
+		async saveAs(nextStorage, nextNamespace) {
+			storage = nextStorage;
+			namespace = nextNamespace;
+			if (autoSave != null) autoSave = {
+				...autoSave,
+				storage: nextStorage,
+				namespace: nextNamespace
+			};
+			return enqueueSave();
+		},
+		isDirty: () => store.getState().dirty,
+		isEmpty: () => store.getState().project.clips.length === 0,
+		async addFiles(files, addOptions = {}) {
+			const { importFiles } = await loadImportFiles();
+			return importFiles(runtime.clips, store, files, addOptions);
+		},
+		async addTextAsset(params) {
+			const { createTextAsset } = await loadImportPipeline();
+			const { project } = store.getState();
+			const { asset } = createTextAsset({
+				registry: runtime.clips,
+				text: params.text,
+				width: project.width,
+				height: project.height,
+				...params.style != null ? { style: params.style } : {},
+				...params.durationUs != null ? { durationUs: params.durationUs } : {}
+			});
+			store.getState().addAsset(asset);
+			return asset;
+		},
+		async addSubtitleAsset(params) {
+			const { createSubtitleAsset } = await loadImportPipeline();
+			const { parseSrtDurationUs } = await Promise.resolve().then(() => require("../chunks/srt-DaL36mXN.cjs")).then((n) => n.srt_exports);
+			const { project } = store.getState();
+			const durationUs = params.durationUs != null && params.durationUs > 0 ? params.durationUs : parseSrtDurationUs(params.srt);
+			const { asset } = createSubtitleAsset({
+				registry: runtime.clips,
+				srt: params.srt,
+				width: project.width,
+				height: project.height,
+				...durationUs > 0 ? { durationUs } : {},
+				...params.style != null ? { style: params.style } : {}
+			});
+			store.getState().addAsset(asset);
+			return asset;
+		},
+		async reconnectAsset(assetId, file) {
+			const { importFile } = await loadImportPipeline();
+			if (!store.getState().assets.some((a) => a.id === assetId)) throw new Error(`素材不存在：${assetId}`);
+			const result = await importFile(runtime.clips, file, void 0, { id: assetId });
+			const { regenerateDerived } = await loadImportPipeline();
+			const withDerived = await regenerateDerived(runtime.clips, result.asset, file);
+			store.getState().replaceAsset(assetId, {
+				...withDerived,
+				id: assetId
+			});
+			store.getState().clearMissing(assetId);
+		},
+		getMissingAssetIds: () => [...store.getState().missingAssetIds],
+		removeAsset(assetId) {
+			runtime.clips.removeAsset(assetId);
+			store.getState().removeAsset(assetId);
 		},
 		play() {
 			const { project, playing } = store.getState();
@@ -967,15 +1162,116 @@ function createEditor(options = {}) {
 		isPlaying: () => store.getState().playing,
 		undo: () => store.getState().undo(),
 		redo: () => store.getState().redo(),
+		canUndo: () => history.getState().canUndo(),
+		canRedo: () => history.getState().canRedo(),
 		addClip: (clip) => store.getState().addClip(clip),
 		removeClips: (ids) => store.getState().removeClips(ids),
 		selectClips: (ids) => store.getState().selectClips(ids),
+		getSelectedClipIds: () => [...store.getState().selectedClipIds],
+		setSelection(clipIds, assetId) {
+			store.getState().selectClips(clipIds);
+			if (assetId !== void 0) store.getState().selectAsset(assetId);
+		},
+		updateClip: (clipId, patch, recordHistory, mergeKey) => store.getState().updateClip(clipId, patch, recordHistory, mergeKey),
+		moveClip: (clipId, trackId, startUs, recordHistory) => store.getState().moveClip(clipId, trackId, startUs, recordHistory),
+		trimClip: (clipId, edge, deltaUs, recordHistory) => store.getState().trimClip(clipId, edge, deltaUs, recordHistory),
+		splitClipsAt: (atUs, clipIds) => store.getState().splitClipsAt(atUs, clipIds),
+		duplicateSelection: (offsetUs) => store.getState().duplicateSelection(offsetUs),
+		addTrack: (kind) => store.getState().addTrack(kind),
+		removeTrack: (trackId) => store.getState().removeTrack(trackId),
+		updateTrack: (trackId, patch) => store.getState().updateTrack(trackId, patch),
+		export(request = {}) {
+			const snapshot = store.getState();
+			const settings = require_waveform.resolveExportSettings(snapshot.project, request.settings);
+			const mimeType = request.mimeType ?? "video/mp4";
+			const filename = request.filename ?? require_waveform.createExportFilename();
+			bus.emit("export:start", {
+				totalUs: require_canvas_size.getProjectDuration(snapshot.project),
+				settings
+			});
+			let cancelled = false;
+			let inner = null;
+			const cancel = () => {
+				cancelled = true;
+				inner?.cancel();
+			};
+			return {
+				promise: (async () => {
+					try {
+						const { startExport, computeExportDuration } = await loadExportRunner();
+						if (cancelled) throw new require_waveform.ExportCancelledError();
+						const handle = startExport({
+							registry: runtime.clips,
+							project: snapshot.project,
+							assets: snapshot.assets,
+							settings,
+							maxTimeUs: computeExportDuration(snapshot.project),
+							mimeType,
+							filename,
+							...bridge.createExportWorker != null ? { createWorker: () => {
+								try {
+									return bridge.createExportWorker?.() ?? null;
+								} catch (err) {
+									bus.emit("error", {
+										scope: "export:worker",
+										error: err
+									});
+									return null;
+								}
+							} } : {}
+						}, (progress) => {
+							if (!cancelled) bus.emit("export:progress", { progress });
+						});
+						inner = handle;
+						const result = await handle.promise;
+						if (cancelled) throw new require_waveform.ExportCancelledError();
+						bus.emit("export:done", {
+							result,
+							blob: result.blob,
+							filename: result.filename
+						});
+						return result;
+					} catch (err) {
+						if (cancelled || err instanceof require_waveform.ExportCancelledError) throw err instanceof require_waveform.ExportCancelledError ? err : new require_waveform.ExportCancelledError();
+						bus.emit("export:error", {
+							message: errorMessage(err),
+							error: err
+						});
+						throw err;
+					}
+				})(),
+				cancel
+			};
+		},
+		async saveExport(result, suggestedName) {
+			const saveBlob = bridge.files?.saveBlob;
+			if (saveBlob == null) return {
+				ok: false,
+				error: "宿主未提供 saveBlob，无法保存成片"
+			};
+			try {
+				return await saveBlob.call(bridge.files, result.blob, suggestedName ?? result.filename);
+			} catch (err) {
+				return {
+					ok: false,
+					error: errorMessage(err)
+				};
+			}
+		},
+		getCapabilities() {
+			capabilityPromise ??= require_waveform.detectEnvironment();
+			return capabilityPromise;
+		},
 		async dispose() {
 			if (disposed) return;
 			disposed = true;
+			const pending = flushAutoSave();
 			unsubscribeStore();
 			bus.emit("dispose", {});
 			await runtime.dispose();
+			try {
+				await pending;
+			} catch {}
 			bus.clear();
 		}
 	};
@@ -989,6 +1285,15 @@ function createEditor(options = {}) {
 *
 * ⚠️ 所有 WebAV 调用都落在 core 内；本文件位于 core/webav 下，允许 import '@webav/*'。
 */
+var import_pipeline_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	UnsupportedFileError: () => require_file_reader.UnsupportedFileError,
+	createSubtitleAsset: () => createSubtitleAsset,
+	createTextAsset: () => createTextAsset,
+	importFile: () => importFile,
+	loadAudioClipForAsset: () => loadAudioClipForAsset,
+	loadPcmForAsset: () => loadPcmForAsset,
+	regenerateDerived: () => regenerateDerived
+});
 var THUMBNAIL_COUNT = 4;
 var THUMBNAIL_WIDTH = 120;
 var WAVEFORM_BUCKETS = 400;
@@ -998,19 +1303,19 @@ var WAVEFORM_BUCKETS = 400;
 * @param onProgress 0~1 进度（用于卡片骨架/进度条）
 * @throws UnsupportedFileError 类型不支持时
 */
-async function importFile(registry, file, onProgress) {
+async function importFile(registry, file, onProgress, options = {}) {
 	const detected = require_file_reader.detectFileType(file);
 	onProgress?.(.1);
 	const { clip, meta } = await createClipFromFile(file, detected.kind);
 	onProgress?.(.4);
-	const assetId = require_canvas_size.createId("asset");
+	const assetId = options.id ?? require_id.createId("asset");
 	const asset = {
 		id: assetId,
 		name: file.name,
 		kind: detected.kind,
 		mimeType: detected.mimeType,
 		size: file.size,
-		durationUs: require_canvas_size.asUs(meta.durationUs),
+		durationUs: require_time.asUs(meta.durationUs),
 		width: meta.width,
 		height: meta.height,
 		hasAudio: meta.hasAudio,
@@ -1018,7 +1323,7 @@ async function importFile(registry, file, onProgress) {
 	};
 	if (detected.kind === "video") {
 		try {
-			asset.thumbnailUrls = (await generateThumbnails(clip, assetId, THUMBNAIL_COUNT, meta.durationUs, THUMBNAIL_WIDTH)).map((f) => f.url);
+			asset.thumbnailUrls = (await require_thumbnails.generateThumbnails(clip, assetId, THUMBNAIL_COUNT, meta.durationUs, THUMBNAIL_WIDTH)).map((f) => f.url);
 		} catch (err) {
 			console.warn("[importFile] 缩略图生成失败", err);
 		}
@@ -1043,9 +1348,40 @@ async function importFile(registry, file, onProgress) {
 		master: clip
 	};
 }
+/**
+* 为一个「已有元数据」的素材重新生成派生数据（缩略图 / 波形）。
+*
+* 用于重新打开工程后 `resolveFile` / `reconnectAsset` 找回文件时：
+* 元数据里不含 thumbnailUrls（那是会话内 object URL，刷新即失效），
+* 如果不补这一步，素材卡片会一直显示图标占位 —— 用户看到的就是「资源坏了」。
+*
+* 失败只记警告：派生数据缺失不影响素材可用性。
+*/
+async function regenerateDerived(registry, asset, file) {
+	const master = registry.getMaster(asset.id);
+	if (master == null) return asset;
+	const next = { ...asset };
+	if (asset.kind === "video") {
+		const { regenerateThumbnails } = await Promise.resolve().then(() => require("../chunks/thumbnails-DEjnao5r.cjs")).then((n) => n.thumbnails_exports);
+		try {
+			next.thumbnailUrls = (await regenerateThumbnails(master, asset.id, THUMBNAIL_COUNT, asset.durationUs, THUMBNAIL_WIDTH)).map((f) => f.url);
+		} catch (err) {
+			console.warn("[regenerateDerived] 缩略图生成失败", asset.id, err);
+		}
+	}
+	if (asset.kind === "audio" || asset.kind === "video" && asset.hasAudio) try {
+		if (asset.kind === "audio") {
+			const pcm = master.getPCMData();
+			next.waveform = require_waveform.computeWaveform(pcm, WAVEFORM_BUCKETS);
+		}
+	} catch (err) {
+		console.warn("[regenerateDerived] 波形生成失败", asset.id, err);
+	}
+	return next;
+}
 /** 新建文字素材（非文件来源，无需二进制） */
 function createTextAsset(params) {
-	const assetId = require_canvas_size.createId("asset");
+	const assetId = params.id ?? require_id.createId("asset");
 	const style = {
 		...DEFAULT_TEXT_STYLE,
 		...params.style
@@ -1064,7 +1400,7 @@ function createTextAsset(params) {
 		kind: "text",
 		mimeType: "text/x-title",
 		size: 0,
-		durationUs: require_canvas_size.asUs(durationUs),
+		durationUs: require_time.asUs(durationUs),
 		width: params.width,
 		height: params.height,
 		hasAudio: false,
@@ -1120,7 +1456,7 @@ function subtitleName(srt) {
 }
 /** 新建字幕素材（内容来自粘贴的 SRT，无源文件） */
 function createSubtitleAsset(params) {
-	const assetId = require_canvas_size.createId("asset");
+	const assetId = params.id ?? require_id.createId("asset");
 	const style = {
 		...DEFAULT_SUBTITLE_STYLE,
 		...params.style
@@ -1138,7 +1474,7 @@ function createSubtitleAsset(params) {
 		kind: "subtitle",
 		mimeType: "text/plain",
 		size: params.srt.length,
-		durationUs: require_canvas_size.asUs(durationUs),
+		durationUs: require_time.asUs(durationUs),
 		width: params.width,
 		height: params.height,
 		hasAudio: false,
@@ -1152,6 +1488,62 @@ function createSubtitleAsset(params) {
 		clipId: assetId
 	};
 }
+// src/engine/webav/import-files.ts
+var import_files_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ importFiles: () => importFiles });
+/** 找出可以「重连」的素材 id（同名 + 同类型 + 当前确实缺少二进制） */
+function findReconnectableId(state, registry, file, kind) {
+	if (state.missingAssetIds.length === 0) return null;
+	return state.assets.find((asset) => state.missingAssetIds.includes(asset.id) && asset.kind === kind && asset.name === file.name && registry.getFile(asset.id) == null)?.id ?? null;
+}
+/**
+* 批量导入素材。
+*
+* - 串行处理，避免同时开辟多个解码器把内存打爆；
+* - 单个文件失败只影响自身，最后汇总返回；
+* - 进度由调用方通过 `onProgress` 展示（不写 store，避免高频全局重渲染）；
+* - 与「缺失源文件」的素材同名同类型时重连，复用原 assetId。
+*/
+async function importFiles(registry, store, files, options = {}) {
+	const { select = true, onProgress, idFor, reconnect = true } = options;
+	const imported = [];
+	const failures = [];
+	let reconnected = 0;
+	for (let index = 0; index < files.length; index += 1) {
+		const file = files[index];
+		if (file == null) continue;
+		try {
+			const detected = require_file_reader.detectFileType(file);
+			const reconnectId = reconnect ? findReconnectableId(store.getState(), registry, file, detected.kind) : null;
+			const requestedId = reconnectId ?? idFor?.(file, index) ?? null;
+			const assetId = requestedId != null && requestedId !== "" ? requestedId : void 0;
+			if (reconnectId != null) registry.removeAsset(reconnectId);
+			const result = await importFile(registry, file, (progress) => onProgress?.(index, progress), assetId != null ? { id: assetId } : void 0);
+			if (reconnectId != null) {
+				store.getState().replaceAsset(reconnectId, result.asset);
+				store.getState().clearMissing(reconnectId);
+				imported.push(result.asset);
+				reconnected += 1;
+			} else {
+				store.getState().addAsset(result.asset);
+				imported.push(result.asset);
+			}
+		} catch (err) {
+			const message = errorMessage(err);
+			failures.push({
+				name: file.name,
+				error: message
+			});
+			onProgress?.(index, 1);
+			if (!(err instanceof require_file_reader.UnsupportedFileError)) console.warn("[importFiles] 导入失败", file.name, err);
+		}
+	}
+	if (select && imported.length > 0) store.getState().selectAsset(imported[0]?.id ?? null);
+	return {
+		imported,
+		failures,
+		reconnected
+	};
+}
 // src/engine/webav/sprite-factory.ts
 /**
 * 时间轴数据 → Sprite 的转换。
@@ -1177,8 +1569,8 @@ function applyClipToSprite(sprite, clip) {
 	sprite.opacity = clip.opacity;
 	sprite.flip = clip.flip;
 	sprite.time = {
-		offset: require_canvas_size.asUs(clip.startUs),
-		duration: require_canvas_size.asUs(clip.durationUs),
+		offset: require_time.asUs(clip.startUs),
+		duration: require_time.asUs(clip.durationUs),
 		playbackRate: clip.playbackRate
 	};
 }
@@ -1220,144 +1612,685 @@ function applyOpacityFade(sprite, clip) {
 		iterCount: 1
 	});
 }
-// src/engine/webav/sprite-sync.ts
-function zIndexOf(tracks, trackId, clip) {
-	const trackIndex = tracks.findIndex((t) => t.id === trackId);
-	return Math.max(0, trackIndex) * 1e3 + Math.round(clip.startUs / 1e6);
-}
-/**
-* 计算需要重建实例的 clip（入点 / 时长变了，旧 IClip 的数据窗口不再匹配）。
-*/
-function needsRebuild(previous, next) {
-	if (!previous) return true;
-	return previous.inPointUs !== next.inPointUs;
-}
-var SpriteSynchronizer = class {
-	/** 由创建方注入，保证一个预览画布只操作自己的 clip 实例 */
-	registry;
-	sprites = /* @__PURE__ */ new Map();
-	/** 记录上一次同步的数据，用于检测属性变化 */
-	lastClips = /* @__PURE__ */ new Map();
-	constructor(registry) {
-		this.registry = registry;
-	}
-	getSprite(clipId) {
-		return this.sprites.get(clipId);
+// src/engine/webav/gain-clip.ts
+var GainClip = class GainClip {
+	ready;
+	inner;
+	opts;
+	destroyed = false;
+	constructor(inner, opts) {
+		this.inner = inner;
+		this.opts = opts;
+		this.ready = inner.ready;
 	}
-	listSprites() {
-		return Array.from(this.sprites.values());
+	get meta() {
+		return this.inner.meta;
 	}
-	/**
-	* 全量对齐：以 store 的 clips 为准增删 sprite。
-	*
-	* @param assets 素材表（用于判断类型）
-	* @returns 变更详情，调用方据此把 sprite 挂到 AVCanvas
-	*/
-	async sync(project, assets, handlers) {
-		const assetMap = new Map(assets.map((a) => [a.id, a]));
-		const nextIds = new Set(project.clips.map((c) => c.id));
-		const removed = [];
-		for (const [id, sprite] of Array.from(this.sprites)) {
-			if (nextIds.has(id)) continue;
-			handlers.onRemove(sprite);
-			this.sprites.delete(id);
-			this.lastClips.delete(id);
-			this.registry.destroyInstance(id);
-			removed.push(id);
-		}
-		const created = [];
-		const errors = [];
-		for (const clip of project.clips) {
-			const track = project.tracks.find((t) => t.id === clip.trackId);
-			if (!track) continue;
-			const asset = assetMap.get(clip.assetId);
-			if (!asset) {
-				errors.push({
-					clipId: clip.id,
-					message: "引用的素材已不存在，请重新导入"
-				});
-				continue;
-			}
-			if ((asset.kind === "video" || asset.kind === "audio" || asset.kind === "image") && this.registry.getFile(asset.id) == null) {
-				errors.push({
-					clipId: clip.id,
-					message: `素材文件未载入：${asset.name}`
-				});
-				continue;
-			}
-			const previous = this.lastClips.get(clip.id);
-			const existing = this.sprites.get(clip.id);
-			if (existing && !needsRebuild(previous, clip)) {
-				applyClipToSprite(existing, clip);
-				existing.zIndex = zIndexOf(project.tracks, clip.trackId, clip);
-				existing.visible = !track.hidden;
-				this.lastClips.set(clip.id, clip);
-				continue;
-			}
-			if (existing) {
-				handlers.onRemove(existing);
-				this.sprites.delete(clip.id);
-				this.registry.destroyInstance(clip.id);
-			}
-			try {
-				const instance = await this.registry.createInstance({
-					timelineClipId: clip.id,
-					assetId: clip.assetId,
-					inPointUs: clip.inPointUs,
-					durationUs: clip.durationUs * clip.playbackRate,
-					text: clip.text,
-					textStyle: clip.textStyle,
-					srt: clip.srt,
-					subtitleStyle: clip.subtitleStyle,
-					projectWidth: project.width,
-					projectHeight: project.height
-				});
-				const sprite = createVisibleSprite(track.kind === "audio" ? instance : instance, clip, { zIndex: zIndexOf(project.tracks, clip.trackId, clip) });
-				sprite.visible = !track.hidden;
-				if (track.kind === "audio" && asset.kind === "audio") {
-					sprite.rect.w = 0;
-					sprite.rect.h = 0;
-				}
-				await handlers.onAdd(sprite);
-				this.sprites.set(clip.id, sprite);
-				this.lastClips.set(clip.id, clip);
-				created.push(clip.id);
-			} catch (err) {
-				errors.push({
-					clipId: clip.id,
-					message: err instanceof Error ? err.message : String(err)
-				});
-			}
-		}
+	async tick(time) {
+		if (this.destroyed) return { state: "done" };
+		const result = await this.inner.tick(time);
+		if (result.audio == null || result.audio.length === 0) return result;
+		const gain = this.gainAt(time);
+		if (gain === 1) return result;
 		return {
-			sprites: new Map(this.sprites),
-			removed,
-			created,
-			errors
+			...result,
+			audio: result.audio.map((channel) => {
+				const out = new Float32Array(channel.length);
+				for (let i = 0; i < channel.length; i += 1) out[i] = (channel[i] ?? 0) * gain;
+				return out;
+			})
 		};
 	}
-	/** 清空所有 sprite（销毁实例） */
-	clear(handlers) {
-		for (const [id, sprite] of this.sprites) {
-			handlers.onRemove(sprite);
-			this.registry.destroyInstance(id);
-		}
-		this.sprites.clear();
-		this.lastClips.clear();
+	/** 计算某个时刻（源时间，微秒）的线性增益 */
+	gainAt(time) {
+		const { volume, fadeInUs, fadeOutUs, durationUs, playbackRate } = this.opts;
+		const base = Math.max(0, Math.min(1, volume));
+		const totalUs = Math.max(1, durationUs * (playbackRate > 0 ? playbackRate : 1));
+		const fadeIn = Math.min(fadeInUs * (playbackRate > 0 ? playbackRate : 1), totalUs / 2);
+		const fadeOut = Math.min(fadeOutUs * (playbackRate > 0 ? playbackRate : 1), totalUs / 2);
+		let gain = base;
+		if (fadeIn > 0 && time < fadeIn) gain *= Math.max(0, time / fadeIn);
+		if (fadeOut > 0 && time > totalUs - fadeOut) gain *= Math.max(0, (totalUs - time) / fadeOut);
+		return Math.max(0, Math.min(1, gain));
 	}
-	stats() {
-		return this.sprites.size;
+	async clone() {
+		const copy = new GainClip(await this.inner.clone(), { ...this.opts });
+		await copy.ready;
+		return copy;
 	}
-};
-// src/engine/webav/preview-canvas.ts
-/**
-* AVCanvas 的封装层（feature 与 WebAV 之间的唯一桥梁）。
-*
-* 目的：把 WebAV 的实例管理、sprite 同步、事件订阅全部收拢到 core，
-* 使 features / hooks 不直接依赖 `@webav/*`（分层规则要求）。
-*
-* 关键设计：
-* - 本类 **不** 调用 `av.play()`。AVCanvas 自带 33ms 步进与自己的 AudioContext，
+	async split(time) {
+		if (time <= 0 || time >= this.opts.durationUs) throw new Error("\"time\" out of bounds");
+		const leftInner = await this.inner.clone();
+		const rightInner = await this.inner.clone();
+		const left = new GainClip(leftInner, {
+			...this.opts,
+			durationUs: time
+		});
+		const right = new GainClip(rightInner, {
+			...this.opts,
+			durationUs: this.opts.durationUs - time
+		});
+		await Promise.all([left.ready, right.ready]);
+		return [left, right];
+	}
+	destroy() {
+		if (this.destroyed) return;
+		this.destroyed = true;
+		this.inner.destroy();
+	}
+};
+// src/engine/webav/coordinate.ts
+/**
+* 把工程坐标下的 transform 等比映射到输出尺寸。
+*
+* 使用同一个缩放系数（分别算宽高再取较小值会改变构图，横竖比不同时更明显），
+* 并按输出画布居中，保证「预览里居中」在导出后依然居中。
+*
+* @param transform 工程坐标系下的变换
+* @param source 工程分辨率
+* @param target 输出分辨率
+*/
+function mapTransformToOutput(transform, source, target) {
+	const safeSourceW = Math.max(1, source.width);
+	const safeSourceH = Math.max(1, source.height);
+	const scaleX = target.width / safeSourceW;
+	const scaleY = target.height / safeSourceH;
+	const scale = Math.min(scaleX, scaleY);
+	const scaledW = transform.w * scale;
+	const scaledH = transform.h * scale;
+	const centerX = (transform.x + transform.w / 2) * scaleX;
+	const centerY = (transform.y + transform.h / 2) * scaleY;
+	const offsetX = (target.width - safeSourceW * scale) / 2;
+	const offsetY = (target.height - safeSourceH * scale) / 2;
+	return {
+		x: centerX + offsetX - scaledW / 2,
+		y: centerY + offsetY - scaledH / 2,
+		w: scaledW,
+		h: scaledH,
+		angle: transform.angle
+	};
+}
+/** 便捷版：直接返回换算后的 clip（浅拷贝，只替换 transform） */
+function mapClipToOutput(clip, source, target) {
+	return {
+		...clip,
+		transform: mapTransformToOutput(clip.transform, source, target)
+	};
+}
+// src/engine/webav/exporter.ts
+/**
+* 导出流水线：时间轴数据 → Combinator → MP4 二进制。
+*
+* 该模块不依赖 React；`buildCombinator` 同时被主线程与 Worker 复用。
+*
+* ⚠️ `Combinator.output()` 在当前线程同步步进渲染，会阻塞 UI。
+* 主线程路径（`exportProject`）只作为 Worker 不可用时的降级方案，必须配全屏遮罩。
+*/
+/**
+* 给 clip 套上音量包络。
+*
+* WebAV 的音频混音是直接相加，没有每轨音量；`MP4Clip` / `AudioClip` 的 volume
+* 只能在构造时指定，且 clone 会沿用（同一素材被多个 clip 复用时无法区分）。
+* 因此统一用 `GainClip` 包装：每个时间轴 clip 走自己的实例与包络。
+*
+* @param instance 该 clip 独占的 IClip
+* @param clip 时间轴数据（提供 volume / fadeIn / fadeOut）
+*/
+function withClipGain(instance, clip, options = {}) {
+	const volume = options.trackMuted === true ? 0 : clip.volume;
+	if (!(clip.muted || options.trackMuted === true || volume !== 1 || clip.fadeInUs > 0 || clip.fadeOutUs > 0)) return instance;
+	if (clip.muted) return instance;
+	return new GainClip(instance, {
+		volume,
+		fadeInUs: clip.fadeInUs,
+		fadeOutUs: clip.fadeOutUs,
+		durationUs: clip.durationUs,
+		playbackRate: clip.playbackRate
+	});
+}
+/**
+* 组装 Combinator。
+*
+* - 只加入未隐藏轨道的 clip；`includeAudio === false` 时跳过音频轨；
+* - 显式给 `output({ maxTime })`，因此不依赖 main sprite（静态素材不会导致
+*   "Unable to determine the end time"）；
+* - 音频 sprite 不参与画面，但仍需加入才能混合音轨。
+*/
+async function buildCombinator(inputs, opts) {
+	const combinator = new _webav_av_cliper.Combinator({
+		width: opts.width,
+		height: opts.height,
+		fps: opts.fps,
+		bitrate: opts.bitrate,
+		bgColor: opts.bgColor ?? "#000000",
+		audio: opts.includeAudio ? void 0 : false
+	});
+	const skipped = [];
+	const usable = inputs.filter((item) => !item.track.hidden);
+	if (usable.length === 0) throw new Error("时间轴为空，无法导出");
+	const ordered = [...usable].sort((a, b) => {
+		const aAudio = a.track.kind === "audio" ? 1 : 0;
+		const bAudio = b.track.kind === "audio" ? 1 : 0;
+		if (aAudio !== bAudio) return aAudio - bAudio;
+		if (a.clip.startUs !== b.clip.startUs) return a.clip.startUs - b.clip.startUs;
+		return a.clip.id.localeCompare(b.clip.id);
+	});
+	const sourceSize = {
+		width: opts.projectWidth ?? opts.width,
+		height: opts.projectHeight ?? opts.height
+	};
+	const targetSize = {
+		width: opts.width,
+		height: opts.height
+	};
+	let maxTimeUs = 0;
+	let zIndex = 0;
+	for (const item of ordered) {
+		const { instance, track } = item;
+		const clip = mapClipToOutput(item.clip, sourceSize, targetSize);
+		if (track.kind === "audio" && !opts.includeAudio) continue;
+		const trackMuted = track.muted;
+		if (clip.muted) continue;
+		const duration = require_canvas_size.clampStillDuration(clip.durationUs);
+		if (clip.durationUs <= 0) {
+			skipped.push({
+				clipId: clip.id,
+				reason: "时长为 0，已跳过"
+			});
+			continue;
+		}
+		const normalized = {
+			...clip,
+			durationUs: duration
+		};
+		const sprite = createOffscreenSprite(withClipGain(instance, normalized, { trackMuted }), normalized, { zIndex });
+		applyOpacityFade(sprite, normalized);
+		await combinator.addSprite(sprite, { main: false });
+		maxTimeUs = Math.max(maxTimeUs, clip.startUs + duration);
+		zIndex += 1;
+	}
+	if (!Number.isFinite(maxTimeUs) || maxTimeUs <= 0) throw new Error("无法确定导出时长：请确认时间轴上有有效片段");
+	return {
+		combinator,
+		maxTimeUs,
+		skipped
+	};
+}
+/**
+* 主线程导出（Worker 不可用时的降级路径）。
+*
+* @param inputs 已构建好的 clip 实例（调用方负责 destroy）
+* @param opts 输出配置
+* @param onProgress 0~1 进度回调
+*/
+async function exportProject(inputs, opts, onProgress) {
+	const startedAt = performance.now();
+	const { combinator, maxTimeUs, skipped } = await buildCombinator(inputs, opts);
+	const unsubscribe = onProgress ? combinator.on("OutputProgress", (p) => onProgress(p)) : () => void 0;
+	try {
+		const stream = combinator.output({ maxTime: maxTimeUs });
+		const raw = await new Response(stream).arrayBuffer();
+		if (opts.fixDuration) {
+			const fixed = await (0, _webav_av_cliper.fixFMP4Duration)(new Response(raw).body);
+			return {
+				buffer: await new Response(fixed).arrayBuffer(),
+				elapsedMs: performance.now() - startedAt,
+				skipped
+			};
+		}
+		return {
+			buffer: raw,
+			elapsedMs: performance.now() - startedAt,
+			skipped
+		};
+	} finally {
+		unsubscribe();
+		combinator.destroy();
+	}
+}
+/** 检查分辨率 / 帧率 / 码率组合是否可编码 */
+async function checkExportSupport(opts) {
+	return _webav_av_cliper.Combinator.isSupported({
+		width: opts.width,
+		height: opts.height,
+		bitrate: opts.bitrate
+	});
+}
+/** 时间轴结束时间（微秒） */
+function computeTimelineEnd(clips) {
+	return clips.reduce((max, c) => Math.max(max, c.startUs + c.durationUs), 0);
+}
+// src/engine/webav/export-runner.ts
+var export_runner_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	buildWorkerPayload: () => buildWorkerPayload,
+	canUseWorker: () => canUseWorker,
+	computeExportDuration: () => computeExportDuration,
+	setDefaultExportWorkerFactory: () => setDefaultExportWorkerFactory,
+	startExport: () => startExport
+});
+/** 标记取消的哨兵：只在本模块内部流转，不暴露给宿主 */
+var CANCELLED = "__export_cancelled__";
+/**
+* 默认 Worker 工厂（构建形态相关）。
+*
+* core 不能知道 UI 包把导出 Worker 打成了哪种资源（独立 chunk / UMD 内联），
+* 因此由 `@cut-workbench/workbench` 在模块加载时注册一份；宿主若提供了
+* `HostBridge.createExportWorker`，那个优先级更高。两者都没有时走主线程。
+*/
+var defaultWorkerFactory = null;
+function setDefaultExportWorkerFactory(factory) {
+	defaultWorkerFactory = factory;
+}
+/** 判断是否可以用 Worker 导出（文字素材依赖 DOM） */
+function canUseWorker(project, assets) {
+	const kinds = new Map(assets.map((a) => [a.id, a.kind]));
+	return !project.clips.some((clip) => kinds.get(clip.assetId) === "text");
+}
+/** 参与导出的片段最大结束时间（跳过隐藏轨道） */
+function computeExportDuration(project, maxTimeUs) {
+	if (maxTimeUs != null) return maxTimeUs;
+	const hidden = new Set(project.tracks.filter((t) => t.hidden).map((t) => t.id));
+	return project.clips.reduce((max, clip) => hidden.has(clip.trackId) ? max : Math.max(max, clip.startUs + clip.durationUs), 0);
+}
+/**
+* 构建 Worker 载荷。
+*
+* 音频素材需要主线程预解码 PCM（Worker 无 AudioContext）。为避免无谓解码，
+* 只有「音频轨素材」或「含音轨且会被播放的视频」才解码。
+*/
+async function buildWorkerPayload(registry, project, assets, settings, maxTimeUs) {
+	const usedAssetIds = new Set(project.clips.map((c) => c.assetId));
+	const missing = [];
+	const payloadAssets = [];
+	for (const asset of assets) {
+		if (!usedAssetIds.has(asset.id)) continue;
+		const file = registry.getFile(asset.id);
+		if (file == null && asset.kind !== "text" && asset.kind !== "subtitle") {
+			missing.push(asset.name);
+			continue;
+		}
+		let pcm;
+		if (settings.includeAudio && (asset.kind === "audio" || asset.kind === "video" && asset.hasAudio)) pcm = await loadPcmForAsset(registry, asset.id);
+		payloadAssets.push({
+			id: asset.id,
+			kind: asset.kind,
+			file,
+			width: asset.width,
+			height: asset.height,
+			durationUs: asset.durationUs,
+			hasAudio: asset.hasAudio,
+			pcm,
+			text: asset.text,
+			textStyle: asset.textStyle,
+			srt: asset.srt,
+			subtitleStyle: asset.subtitleStyle
+		});
+	}
+	const kindOf = new Map(assets.map((a) => [a.id, a.kind]));
+	const clips = project.clips.map((clip) => ({
+		clip,
+		kind: kindOf.get(clip.assetId) ?? "video"
+	}));
+	return {
+		assets: payloadAssets,
+		timeline: {
+			width: settings.width,
+			height: settings.height,
+			projectWidth: project.width,
+			projectHeight: project.height,
+			fps: settings.fps,
+			bitrate: settings.bitrate,
+			includeAudio: settings.includeAudio,
+			bgColor: "#000000",
+			maxTimeUs,
+			tracks: project.tracks.map((t) => ({
+				id: t.id,
+				kind: t.kind,
+				hidden: t.hidden,
+				muted: t.muted
+			})),
+			clips
+		},
+		missing
+	};
+}
+/**
+* 主线程回退导出：为每个 clip 从 registry 建实例后交给 core exporter。
+*
+* 注意：实例用 `export:<clipId>` 作为临时 key 注册进 registry，导出结束后统一销毁，
+* 避免污染预览用的实例（两者不可共用，因为共享 tick 状态）。
+*/
+async function exportOnMainThread(options, onProgress, shouldCancel) {
+	const { registry, project, settings, mimeType = "video/mp4", filename } = options;
+	const trackMap = new Map(project.tracks.map((t) => [t.id, t]));
+	const inputs = [];
+	const skipped = [];
+	const tempIds = [];
+	try {
+		for (const clip of project.clips) {
+			if (shouldCancel()) throw new require_waveform.ExportCancelledError();
+			const track = trackMap.get(clip.trackId);
+			if (!track || track.hidden) continue;
+			const asset = registry.getAsset(clip.assetId);
+			if (!asset) {
+				skipped.push({
+					clipId: clip.id,
+					reason: "素材缺失"
+				});
+				continue;
+			}
+			const tempId = `export:${clip.id}`;
+			try {
+				const instance = await registry.createInstance({
+					timelineClipId: tempId,
+					assetId: clip.assetId,
+					inPointUs: clip.inPointUs,
+					durationUs: clip.durationUs * clip.playbackRate,
+					text: clip.text,
+					textStyle: clip.textStyle,
+					srt: clip.srt,
+					subtitleStyle: clip.subtitleStyle,
+					projectWidth: project.width,
+					projectHeight: project.height
+				});
+				tempIds.push(tempId);
+				inputs.push({
+					clip,
+					instance,
+					kind: asset.kind,
+					track
+				});
+			} catch (err) {
+				skipped.push({
+					clipId: clip.id,
+					reason: err instanceof Error ? err.message : String(err)
+				});
+			}
+		}
+		if (inputs.length === 0) throw new Error("时间轴为空，无法导出");
+		if (shouldCancel()) throw new require_waveform.ExportCancelledError();
+		const startedAt = performance.now();
+		const { buffer, skipped: buildSkipped } = await exportProject(inputs, {
+			width: settings.width,
+			height: settings.height,
+			fps: settings.fps,
+			bitrate: settings.bitrate,
+			includeAudio: settings.includeAudio,
+			projectWidth: project.width,
+			projectHeight: project.height
+		}, onProgress);
+		if (shouldCancel()) throw new require_waveform.ExportCancelledError();
+		return {
+			blob: new Blob([buffer], { type: mimeType }),
+			filename: filename ?? require_waveform.createExportFilename(),
+			mimeType,
+			durationUs: computeExportDuration(project, options.maxTimeUs),
+			width: settings.width,
+			height: settings.height,
+			fps: settings.fps,
+			bitrate: settings.bitrate,
+			elapsedMs: performance.now() - startedAt,
+			skipped: [...skipped, ...buildSkipped],
+			mode: "main"
+		};
+	} finally {
+		for (const id of tempIds) registry.destroyInstance(id);
+	}
+}
+async function exportViaWorker(options, worker, onProgress, shouldCancel) {
+	const { registry, project, assets, settings, maxTimeUs, mimeType = "video/mp4", filename } = options;
+	const { assets: payloadAssets, timeline, missing } = await buildWorkerPayload(registry, project, assets, settings, maxTimeUs);
+	if (shouldCancel()) throw new require_waveform.ExportCancelledError();
+	if (missing.length > 0) console.warn("[export] 以下素材缺少源文件，相关片段将被跳过：", missing.join("、"));
+	return new Promise((resolve, reject) => {
+		const startedAt = performance.now();
+		const cleanup = () => {
+			worker.onmessage = null;
+			worker.onerror = null;
+			worker.terminate();
+		};
+		worker.onmessage = (event) => {
+			const message = event.data;
+			if (message.type === "progress") {
+				if (shouldCancel()) return;
+				onProgress(message.progress);
+				return;
+			}
+			if (message.type === "done") {
+				cleanup();
+				if (shouldCancel()) {
+					reject(new require_waveform.ExportCancelledError());
+					return;
+				}
+				resolve({
+					blob: new Blob([message.buffer], { type: mimeType }),
+					filename: filename ?? require_waveform.createExportFilename(),
+					mimeType,
+					durationUs: computeExportDuration(project, maxTimeUs),
+					width: settings.width,
+					height: settings.height,
+					fps: settings.fps,
+					bitrate: settings.bitrate,
+					elapsedMs: performance.now() - startedAt,
+					skipped: message.skipped ?? [],
+					mode: "worker"
+				});
+				return;
+			}
+			if (message.type === "error") {
+				cleanup();
+				reject(message.message === CANCELLED || shouldCancel() ? new require_waveform.ExportCancelledError() : new Error(message.message));
+			}
+		};
+		worker.onerror = (event) => {
+			cleanup();
+			reject(new Error(event.message || "导出 Worker 异常"));
+		};
+		if (shouldCancel()) {
+			cleanup();
+			reject(new require_waveform.ExportCancelledError());
+			return;
+		}
+		worker.postMessage({
+			type: "export",
+			assets: payloadAssets,
+			timeline,
+			fixDuration: true
+		});
+	});
+}
+/**
+* 启动导出。
+*
+* 优先走 Worker（不阻塞 UI）；含文字片段或 Worker 不可用 / 失败时回退主线程。
+* `cancel()` 后 promise 以 `ExportCancelledError` reject。
+*/
+function startExport(options, onProgress = () => void 0) {
+	const { project, assets, settings } = options;
+	let cancelled = false;
+	let worker = null;
+	const cancel = () => {
+		cancelled = true;
+		if (worker != null) {
+			try {
+				worker.postMessage({ type: "cancel" });
+			} catch {}
+			worker.terminate();
+			worker = null;
+		}
+	};
+	return {
+		promise: (async () => {
+			if (!await checkExportSupport({
+				width: settings.width,
+				height: settings.height,
+				bitrate: settings.bitrate
+			})) throw new Error(`当前设备不支持编码 ${settings.width}×${settings.height} @ ${(settings.bitrate / 1e6).toFixed(1)}Mbps，请降低分辨率或码率`);
+			if (cancelled) throw new require_waveform.ExportCancelledError();
+			const makeWorker = () => {
+				const factory = options.createWorker ?? defaultWorkerFactory;
+				if (factory == null) return null;
+				try {
+					return factory();
+				} catch (err) {
+					console.warn("[export] 创建 Worker 失败，回退主线程", err);
+					return null;
+				}
+			};
+			if (!canUseWorker(project, assets)) return exportOnMainThread(options, onProgress, () => cancelled);
+			const created = makeWorker();
+			if (created == null) return exportOnMainThread(options, onProgress, () => cancelled);
+			worker = created;
+			try {
+				return await exportViaWorker(options, created, onProgress, () => cancelled);
+			} catch (err) {
+				if (cancelled || err instanceof require_waveform.ExportCancelledError) throw new require_waveform.ExportCancelledError();
+				console.warn("[export] Worker 导出失败，回退主线程", err);
+				return exportOnMainThread(options, onProgress, () => cancelled);
+			}
+		})(),
+		cancel
+	};
+}
+// src/engine/webav/sprite-sync.ts
+function zIndexOf(tracks, trackId, clip) {
+	const trackIndex = tracks.findIndex((t) => t.id === trackId);
+	return Math.max(0, trackIndex) * 1e3 + Math.round(clip.startUs / 1e6);
+}
+/**
+* 计算需要重建实例的 clip（入点 / 时长变了，旧 IClip 的数据窗口不再匹配）。
+*/
+function needsRebuild(previous, next) {
+	if (!previous) return true;
+	return previous.inPointUs !== next.inPointUs;
+}
+var SpriteSynchronizer = class {
+	/** 由创建方注入，保证一个预览画布只操作自己的 clip 实例 */
+	registry;
+	sprites = /* @__PURE__ */ new Map();
+	/** 记录上一次同步的数据，用于检测属性变化 */
+	lastClips = /* @__PURE__ */ new Map();
+	constructor(registry) {
+		this.registry = registry;
+	}
+	getSprite(clipId) {
+		return this.sprites.get(clipId);
+	}
+	listSprites() {
+		return Array.from(this.sprites.values());
+	}
+	/**
+	* 全量对齐：以 store 的 clips 为准增删 sprite。
+	*
+	* @param assets 素材表（用于判断类型）
+	* @returns 变更详情，调用方据此把 sprite 挂到 AVCanvas
+	*/
+	async sync(project, assets, handlers) {
+		const assetMap = new Map(assets.map((a) => [a.id, a]));
+		const nextIds = new Set(project.clips.map((c) => c.id));
+		const removed = [];
+		for (const [id, sprite] of Array.from(this.sprites)) {
+			if (nextIds.has(id)) continue;
+			handlers.onRemove(sprite);
+			this.sprites.delete(id);
+			this.lastClips.delete(id);
+			this.registry.destroyInstance(id);
+			removed.push(id);
+		}
+		const created = [];
+		const errors = [];
+		for (const clip of project.clips) {
+			const track = project.tracks.find((t) => t.id === clip.trackId);
+			if (!track) continue;
+			const asset = assetMap.get(clip.assetId);
+			if (!asset) {
+				errors.push({
+					clipId: clip.id,
+					message: "引用的素材已不存在，请重新导入"
+				});
+				continue;
+			}
+			if ((asset.kind === "video" || asset.kind === "audio" || asset.kind === "image") && this.registry.getFile(asset.id) == null) {
+				errors.push({
+					clipId: clip.id,
+					message: `素材文件未载入：${asset.name}`
+				});
+				continue;
+			}
+			const previous = this.lastClips.get(clip.id);
+			const existing = this.sprites.get(clip.id);
+			if (existing && !needsRebuild(previous, clip)) {
+				applyClipToSprite(existing, clip);
+				existing.zIndex = zIndexOf(project.tracks, clip.trackId, clip);
+				existing.visible = !track.hidden;
+				if (previous == null || previous.durationUs !== clip.durationUs || previous.fadeInUs !== clip.fadeInUs || previous.fadeOutUs !== clip.fadeOutUs || previous.opacity !== clip.opacity) applyOpacityFade(existing, clip);
+				this.lastClips.set(clip.id, clip);
+				continue;
+			}
+			if (existing) {
+				handlers.onRemove(existing);
+				this.sprites.delete(clip.id);
+				this.registry.destroyInstance(clip.id);
+			}
+			try {
+				const sprite = createVisibleSprite(await this.registry.createInstance({
+					timelineClipId: clip.id,
+					assetId: clip.assetId,
+					inPointUs: clip.inPointUs,
+					durationUs: clip.durationUs * clip.playbackRate,
+					text: clip.text,
+					textStyle: clip.textStyle,
+					srt: clip.srt,
+					subtitleStyle: clip.subtitleStyle,
+					projectWidth: project.width,
+					projectHeight: project.height
+				}), clip, { zIndex: zIndexOf(project.tracks, clip.trackId, clip) });
+				sprite.visible = !track.hidden;
+				applyOpacityFade(sprite, clip);
+				if (track.kind === "audio" && asset.kind === "audio") {
+					sprite.rect.w = 0;
+					sprite.rect.h = 0;
+				}
+				await handlers.onAdd(sprite);
+				this.sprites.set(clip.id, sprite);
+				this.lastClips.set(clip.id, clip);
+				created.push(clip.id);
+			} catch (err) {
+				errors.push({
+					clipId: clip.id,
+					message: err instanceof Error ? err.message : String(err)
+				});
+			}
+		}
+		return {
+			sprites: new Map(this.sprites),
+			removed,
+			created,
+			errors
+		};
+	}
+	/** 清空所有 sprite（销毁实例） */
+	clear(handlers) {
+		for (const [id, sprite] of this.sprites) {
+			handlers.onRemove(sprite);
+			this.registry.destroyInstance(id);
+		}
+		this.sprites.clear();
+		this.lastClips.clear();
+	}
+	stats() {
+		return this.sprites.size;
+	}
+};
+// src/engine/webav/preview-canvas.ts
+/**
+* AVCanvas 的封装层（feature 与 WebAV 之间的唯一桥梁）。
+*
+* 目的：把 WebAV 的实例管理、sprite 同步、事件订阅全部收拢到 core，
+* 使 features / hooks 不直接依赖 `@webav/*`（分层规则要求）。
+*
+* 关键设计：
+* - 本类 **不** 调用 `av.play()`。AVCanvas 自带 33ms 步进与自己的 AudioContext，
 *   与我们的 PlaybackClock 会打架；播放统一由外层 `previewFrame` 驱动。
 * - 播放时画面靠「每帧 preFrame + 重绘」推进；AVCanvas 的内部渲染循环在暂停态
 *   仍会按当前时间持续重绘，这正是我们要的（属性变化立刻反映）。
@@ -1572,253 +2505,6 @@ var PreviewCanvas = class {
 		} catch {}
 	}
 };
-// src/engine/webav/gain-clip.ts
-var GainClip = class GainClip {
-	ready;
-	inner;
-	opts;
-	destroyed = false;
-	constructor(inner, opts) {
-		this.inner = inner;
-		this.opts = opts;
-		this.ready = inner.ready;
-	}
-	get meta() {
-		return this.inner.meta;
-	}
-	async tick(time) {
-		if (this.destroyed) return { state: "done" };
-		const result = await this.inner.tick(time);
-		if (result.audio == null || result.audio.length === 0) return result;
-		const gain = this.gainAt(time);
-		if (gain === 1) return result;
-		return {
-			...result,
-			audio: result.audio.map((channel) => {
-				const out = new Float32Array(channel.length);
-				for (let i = 0; i < channel.length; i += 1) out[i] = (channel[i] ?? 0) * gain;
-				return out;
-			})
-		};
-	}
-	/** 计算某个时刻（源时间，微秒）的线性增益 */
-	gainAt(time) {
-		const { volume, fadeInUs, fadeOutUs, durationUs, playbackRate } = this.opts;
-		const base = Math.max(0, Math.min(1, volume));
-		const totalUs = Math.max(1, durationUs * (playbackRate > 0 ? playbackRate : 1));
-		const fadeIn = Math.min(fadeInUs * (playbackRate > 0 ? playbackRate : 1), totalUs / 2);
-		const fadeOut = Math.min(fadeOutUs * (playbackRate > 0 ? playbackRate : 1), totalUs / 2);
-		let gain = base;
-		if (fadeIn > 0 && time < fadeIn) gain *= Math.max(0, time / fadeIn);
-		if (fadeOut > 0 && time > totalUs - fadeOut) gain *= Math.max(0, (totalUs - time) / fadeOut);
-		return Math.max(0, Math.min(1, gain));
-	}
-	async clone() {
-		const copy = new GainClip(await this.inner.clone(), { ...this.opts });
-		await copy.ready;
-		return copy;
-	}
-	async split(time) {
-		if (time <= 0 || time >= this.opts.durationUs) throw new Error("\"time\" out of bounds");
-		const leftInner = await this.inner.clone();
-		const rightInner = await this.inner.clone();
-		const left = new GainClip(leftInner, {
-			...this.opts,
-			durationUs: time
-		});
-		const right = new GainClip(rightInner, {
-			...this.opts,
-			durationUs: this.opts.durationUs - time
-		});
-		await Promise.all([left.ready, right.ready]);
-		return [left, right];
-	}
-	destroy() {
-		if (this.destroyed) return;
-		this.destroyed = true;
-		this.inner.destroy();
-	}
-};
-// src/engine/webav/coordinate.ts
-/**
-* 把工程坐标下的 transform 等比映射到输出尺寸。
-*
-* 使用同一个缩放系数（分别算宽高再取较小值会改变构图，横竖比不同时更明显），
-* 并按输出画布居中，保证「预览里居中」在导出后依然居中。
-*
-* @param transform 工程坐标系下的变换
-* @param source 工程分辨率
-* @param target 输出分辨率
-*/
-function mapTransformToOutput(transform, source, target) {
-	const safeSourceW = Math.max(1, source.width);
-	const safeSourceH = Math.max(1, source.height);
-	const scaleX = target.width / safeSourceW;
-	const scaleY = target.height / safeSourceH;
-	const scale = Math.min(scaleX, scaleY);
-	const scaledW = transform.w * scale;
-	const scaledH = transform.h * scale;
-	const centerX = (transform.x + transform.w / 2) * scaleX;
-	const centerY = (transform.y + transform.h / 2) * scaleY;
-	const offsetX = (target.width - safeSourceW * scale) / 2;
-	const offsetY = (target.height - safeSourceH * scale) / 2;
-	return {
-		x: centerX + offsetX - scaledW / 2,
-		y: centerY + offsetY - scaledH / 2,
-		w: scaledW,
-		h: scaledH,
-		angle: transform.angle
-	};
-}
-/** 便捷版：直接返回换算后的 clip（浅拷贝，只替换 transform） */
-function mapClipToOutput(clip, source, target) {
-	return {
-		...clip,
-		transform: mapTransformToOutput(clip.transform, source, target)
-	};
-}
-// src/engine/webav/exporter.ts
-/**
-* 导出流水线：时间轴数据 → Combinator → MP4 二进制。
-*
-* 该模块不依赖 React；`buildCombinator` 同时被主线程与 Worker 复用。
-*
-* ⚠️ `Combinator.output()` 在当前线程同步步进渲染，会阻塞 UI。
-* 主线程路径（`exportProject`）只作为 Worker 不可用时的降级方案，必须配全屏遮罩。
-*/
-/**
-* 给 clip 套上音量包络。
-*
-* WebAV 的音频混音是直接相加，没有每轨音量；`MP4Clip` / `AudioClip` 的 volume
-* 只能在构造时指定，且 clone 会沿用（同一素材被多个 clip 复用时无法区分）。
-* 因此统一用 `GainClip` 包装：每个时间轴 clip 走自己的实例与包络。
-*
-* @param instance 该 clip 独占的 IClip
-* @param clip 时间轴数据（提供 volume / fadeIn / fadeOut）
-*/
-function withClipGain(instance, clip) {
-	if (!(clip.muted || clip.volume !== 1 || clip.fadeInUs > 0 || clip.fadeOutUs > 0)) return instance;
-	if (clip.muted) return instance;
-	return new GainClip(instance, {
-		volume: clip.volume,
-		fadeInUs: clip.fadeInUs,
-		fadeOutUs: clip.fadeOutUs,
-		durationUs: clip.durationUs,
-		playbackRate: clip.playbackRate
-	});
-}
-/**
-* 组装 Combinator。
-*
-* - 只加入未隐藏轨道的 clip；`includeAudio === false` 时跳过音频轨；
-* - 显式给 `output({ maxTime })`，因此不依赖 main sprite（静态素材不会导致
-*   "Unable to determine the end time"）；
-* - 音频 sprite 不参与画面，但仍需加入才能混合音轨。
-*/
-async function buildCombinator(inputs, opts) {
-	const combinator = new _webav_av_cliper.Combinator({
-		width: opts.width,
-		height: opts.height,
-		fps: opts.fps,
-		bitrate: opts.bitrate,
-		bgColor: opts.bgColor ?? "#000000",
-		audio: opts.includeAudio ? void 0 : false
-	});
-	const skipped = [];
-	const usable = inputs.filter((item) => !item.track.hidden);
-	if (usable.length === 0) throw new Error("时间轴为空，无法导出");
-	const ordered = [...usable].sort((a, b) => {
-		const aAudio = a.track.kind === "audio" ? 1 : 0;
-		const bAudio = b.track.kind === "audio" ? 1 : 0;
-		if (aAudio !== bAudio) return aAudio - bAudio;
-		if (a.clip.startUs !== b.clip.startUs) return a.clip.startUs - b.clip.startUs;
-		return a.clip.id.localeCompare(b.clip.id);
-	});
-	const sourceSize = {
-		width: opts.projectWidth ?? opts.width,
-		height: opts.projectHeight ?? opts.height
-	};
-	const targetSize = {
-		width: opts.width,
-		height: opts.height
-	};
-	let maxTimeUs = 0;
-	let zIndex = 0;
-	for (const item of ordered) {
-		const { instance, track } = item;
-		const clip = mapClipToOutput(item.clip, sourceSize, targetSize);
-		if (track.kind === "audio" && !opts.includeAudio) continue;
-		if (track.muted) continue;
-		if (clip.muted) continue;
-		const duration = require_canvas_size.clampStillDuration(clip.durationUs);
-		if (clip.durationUs <= 0) {
-			skipped.push({
-				clipId: clip.id,
-				reason: "时长为 0，已跳过"
-			});
-			continue;
-		}
-		const normalized = {
-			...clip,
-			durationUs: duration
-		};
-		const sprite = createOffscreenSprite(withClipGain(instance, normalized), normalized, { zIndex });
-		applyOpacityFade(sprite, normalized);
-		await combinator.addSprite(sprite, { main: false });
-		maxTimeUs = Math.max(maxTimeUs, clip.startUs + duration);
-		zIndex += 1;
-	}
-	if (!Number.isFinite(maxTimeUs) || maxTimeUs <= 0) throw new Error("无法确定导出时长：请确认时间轴上有有效片段");
-	return {
-		combinator,
-		maxTimeUs,
-		skipped
-	};
-}
-/**
-* 主线程导出（Worker 不可用时的降级路径）。
-*
-* @param inputs 已构建好的 clip 实例（调用方负责 destroy）
-* @param opts 输出配置
-* @param onProgress 0~1 进度回调
-*/
-async function exportProject(inputs, opts, onProgress) {
-	const startedAt = performance.now();
-	const { combinator, maxTimeUs, skipped } = await buildCombinator(inputs, opts);
-	const unsubscribe = onProgress ? combinator.on("OutputProgress", (p) => onProgress(p)) : () => void 0;
-	try {
-		const stream = combinator.output({ maxTime: maxTimeUs });
-		const raw = await new Response(stream).arrayBuffer();
-		if (opts.fixDuration) {
-			const fixed = await (0, _webav_av_cliper.fixFMP4Duration)(new Response(raw).body);
-			return {
-				buffer: await new Response(fixed).arrayBuffer(),
-				elapsedMs: performance.now() - startedAt,
-				skipped
-			};
-		}
-		return {
-			buffer: raw,
-			elapsedMs: performance.now() - startedAt,
-			skipped
-		};
-	} finally {
-		unsubscribe();
-		combinator.destroy();
-	}
-}
-/** 检查分辨率 / 帧率 / 码率组合是否可编码 */
-async function checkExportSupport(opts) {
-	return _webav_av_cliper.Combinator.isSupported({
-		width: opts.width,
-		height: opts.height,
-		bitrate: opts.bitrate
-	});
-}
-/** 时间轴结束时间（微秒） */
-function computeTimelineEnd(clips) {
-	return clips.reduce((max, c) => Math.max(max, c.startUs + c.durationUs), 0);
-}
 // src/engine/webav/fix-duration.ts
 /**
 * 修正 WebAV 输出的 fMP4 时长。
@@ -1931,6 +2617,16 @@ var cancelled = false;
 function toStream(blob) {
 	return blob.stream();
 }
+/** 轨道静音：音量置 0（画面不受影响） */
+function withSilence(clip) {
+	return new GainClip(clip, {
+		volume: 0,
+		fadeInUs: 0,
+		fadeOutUs: 0,
+		durationUs: Number.MAX_SAFE_INTEGER,
+		playbackRate: 1
+	});
+}
 /** 音量 / 淡入淡出包装（与主线程 exporter.withClipGain 保持一致的语义） */
 function withGain(clip, timeline) {
 	if (timeline.volume === 1 && timeline.fadeInUs === 0 && timeline.fadeOutUs === 0) return clip;
@@ -1993,6 +2689,7 @@ async function buildClipInWorker(asset) {
 */
 async function runExportInWorker(assets, timeline, onProgress, shouldCancel) {
 	const assetMap = new Map(assets.map((a) => [a.id, a]));
+	const trackMap = new Map((timeline.tracks ?? []).map((t) => [t.id, t]));
 	const combinator = new _webav_av_cliper.Combinator({
 		width: timeline.width,
 		height: timeline.height,
@@ -2001,7 +2698,8 @@ async function runExportInWorker(assets, timeline, onProgress, shouldCancel) {
 		bgColor: timeline.bgColor,
 		audio: timeline.includeAudio ? void 0 : false
 	});
-	const clipCache = /* @__PURE__ */ new Map();
+	const masterCache = /* @__PURE__ */ new Map();
+	const derived = [];
 	const skipped = [];
 	const sourceSize = {
 		width: timeline.projectWidth ?? timeline.width,
@@ -2033,11 +2731,14 @@ async function runExportInWorker(assets, timeline, onProgress, shouldCancel) {
 				});
 				continue;
 			}
+			const track = trackMap.get(item.clip.trackId);
+			if (track?.hidden === true) continue;
 			if (item.clip.muted) continue;
-			let clip = clipCache.get(asset.id);
-			if (clip == null) try {
-				clip = await buildClipInWorker(asset);
-				clipCache.set(asset.id, clip);
+			if (item.kind === "audio" && !timeline.includeAudio) continue;
+			let master = masterCache.get(asset.id);
+			if (master == null) try {
+				master = await buildClipInWorker(asset);
+				masterCache.set(asset.id, master);
 			} catch (err) {
 				const reason = err instanceof Error ? err.message : String(err);
 				console.warn("[export.worker] clip skipped:", item.clip.id, reason);
@@ -2048,7 +2749,24 @@ async function runExportInWorker(assets, timeline, onProgress, shouldCancel) {
 				continue;
 			}
 			const tc = item.clip;
-			const sprite = new _webav_av_cliper.OffscreenSprite(withGain(clip, tc));
+			let instance;
+			try {
+				instance = await master.clone();
+			} catch (err) {
+				const reason = err instanceof Error ? err.message : String(err);
+				skipped.push({
+					clipId: tc.id,
+					reason
+				});
+				continue;
+			}
+			if (tc.inPointUs > 0) instance = new OffsetClip(instance, {
+				inPointUs: tc.inPointUs,
+				durationUs: tc.durationUs * tc.playbackRate
+			});
+			derived.push(instance);
+			const gainInput = track?.muted === true ? withSilence(instance) : instance;
+			const sprite = new _webav_av_cliper.OffscreenSprite(withGain(gainInput, tc));
 			const mapped = mapTransformToOutput(tc.transform, sourceSize, targetSize);
 			sprite.rect.x = mapped.x;
 			sprite.rect.y = mapped.y;
@@ -2063,6 +2781,7 @@ async function runExportInWorker(assets, timeline, onProgress, shouldCancel) {
 				duration: tc.durationUs,
 				playbackRate: tc.playbackRate
 			};
+			applyOpacityFade(sprite, tc);
 			zIndex += 1;
 			maxTimeUs = Math.max(maxTimeUs, tc.startUs + tc.durationUs);
 			await combinator.addSprite(sprite, { main: false });
@@ -2084,10 +2803,14 @@ async function runExportInWorker(assets, timeline, onProgress, shouldCancel) {
 			skipped
 		};
 	} finally {
-		for (const clip of clipCache.values()) try {
+		for (const clip of derived) try {
+			clip.destroy();
+		} catch {}
+		derived.length = 0;
+		for (const clip of masterCache.values()) try {
 			clip.destroy();
 		} catch {}
-		clipCache.clear();
+		masterCache.clear();
 		try {
 			combinator.destroy();
 		} catch {}
@@ -2143,7 +2866,10 @@ exports.applyClipToSprite = applyClipToSprite;
 exports.applyOpacityFade = applyOpacityFade;
 exports.buildClipInWorker = buildClipInWorker;
 exports.buildCombinator = buildCombinator;
+exports.buildWorkerPayload = buildWorkerPayload;
+exports.canUseWorker = canUseWorker;
 exports.checkExportSupport = checkExportSupport;
+exports.computeExportDuration = computeExportDuration;
 exports.computeTimelineEnd = computeTimelineEnd;
 exports.createClipFromBuffer = createClipFromBuffer;
 exports.createClipFromFile = createClipFromFile;
@@ -2166,11 +2892,13 @@ exports.exportProject = exportProject;
 exports.fixFMP4DurationStream = fixFMP4DurationStream;
 exports.handleWorkerMessage = handleWorkerMessage;
 exports.importFile = importFile;
+exports.importFiles = importFiles;
 exports.isEnvironmentUsable = require_waveform.isEnvironmentUsable;
 exports.loadAudioClipForAsset = loadAudioClipForAsset;
 exports.loadPcmForAsset = loadPcmForAsset;
 exports.mapClipToOutput = mapClipToOutput;
 exports.mapTransformToOutput = mapTransformToOutput;
+exports.regenerateDerived = regenerateDerived;
 exports.runExportInWorker = runExportInWorker;
 exports.selectAssetById = require_waveform.selectAssetById;
 exports.selectAssets = require_waveform.selectAssets;
@@ -2181,6 +2909,8 @@ exports.selectProject = require_waveform.selectProject;
 exports.selectProjectDuration = require_waveform.selectProjectDuration;
 exports.selectSelectedClipIds = require_waveform.selectSelectedClipIds;
 exports.selectTracks = require_waveform.selectTracks;
+exports.setDefaultExportWorkerFactory = setDefaultExportWorkerFactory;
+exports.startExport = startExport;
 exports.summarizeCapabilities = require_waveform.summarizeCapabilities;
 exports.withClipGain = withClipGain;