@cut-workbench/core 0.4.0 → 0.4.1

package/dist/engine/index.cjs

@@ -1,12 +1,304 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../chunks/rolldown-runtime-B2SfzNBj.cjs");
-const require_time = require("../chunks/time-CnMfSVYX.cjs");
-const require_canvas_size = require("../chunks/canvas-size-Ct61OYjW.cjs");
-const require_waveform = require("../chunks/waveform-Ie-G5Lle.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_import_pipeline = require("../chunks/import-pipeline-A8KkqtZT.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
+var DEFAULT_TEXT_STYLE = {
+	fontSize: 64,
+	color: "#ffffff",
+	fontFamily: "sans-serif",
+	fontWeight: 600,
+	fontStyle: "normal",
+	strokeColor: "#000000",
+	strokeWidth: 0,
+	shadowColor: "rgba(0,0,0,0.6)",
+	shadowBlur: 8,
+	align: "center",
+	background: "transparent"
+};
+/**
+* 字幕默认字体。
+*
+* ⚠️ 不要写 'Noto Sans SC' —— 大多数系统并未安装该字体，`EmbedSubtitlesClip` 会把
+* `ctx.font` 设为 `30px Noto Sans SC`，此时浏览器回退到默认字体，中文可能显示为方框。
+* 使用系统字体栈（sans-serif）由浏览器挑选可用的中文字体，最稳。
+*/
+var DEFAULT_SUBTITLE_STYLE = {
+	color: "#ffffff",
+	textBgColor: null,
+	fontFamily: "sans-serif",
+	fontSize: 30,
+	strokeStyle: "#000000",
+	lineWidth: null,
+	bottomOffset: 30
+};
+// src/engine/webav/text-clip.ts
+function cssFromStyle(style) {
+	const shadow = style.shadowBlur > 0 ? `text-shadow: 0 2px ${style.shadowBlur}px ${style.shadowColor};` : "";
+	const stroke = style.strokeWidth > 0 ? `-webkit-text-stroke: ${style.strokeWidth}px ${style.strokeColor};` : "";
+	return [
+		`font-size:${style.fontSize}px`,
+		`color:${style.color}`,
+		`font-family:${style.fontFamily}`,
+		`font-weight:${style.fontWeight}`,
+		`font-style:${style.fontStyle}`,
+		`text-align:${style.align}`,
+		`background:${style.background}`,
+		"line-height:1.25",
+		"padding:8px 16px",
+		"white-space:pre-wrap",
+		"max-width:80%",
+		stroke,
+		shadow
+	].filter(Boolean).join(";");
+}
+/**
+* 文字素材。内部缓存最近一次渲染的 ImageBitmap，按「文本 + 样式」做键避免重复渲染。
+*/
+var TextClip = class TextClip {
+	ready;
+	opts;
+	metaValue;
+	cacheKey = "";
+	cachedBitmap = null;
+	destroyed = false;
+	constructor(options) {
+		this.opts = {
+			...options,
+			style: {
+				...DEFAULT_TEXT_STYLE,
+				...options.style
+			},
+			animation: options.animation ?? "none",
+			charsPerSecond: options.charsPerSecond ?? 12,
+			animOffsetUs: options.animOffsetUs ?? 0
+		};
+		this.metaValue = {
+			width: options.width,
+			height: options.height,
+			duration: Math.max(1, options.durationUs)
+		};
+		this.ready = Promise.resolve(this.metaValue);
+	}
+	get meta() {
+		return this.metaValue;
+	}
+	visibleTextAt(timeUs) {
+		const { text, animation, charsPerSecond } = this.opts;
+		if (animation === "none") return text;
+		const phaseUs = timeUs + this.opts.animOffsetUs;
+		if (animation === "typewriter") {
+			const visible = Math.floor(phaseUs / 1e6 * charsPerSecond);
+			if (visible <= 0) return null;
+			return text.slice(0, visible);
+		}
+		return Math.floor(phaseUs / 1e6 * 2) % 2 === 0 ? text : null;
+	}
+	async tick(time) {
+		if (this.destroyed) return { state: "done" };
+		if (time >= this.opts.durationUs) return { state: "done" };
+		const visible = this.visibleTextAt(time);
+		if (visible == null || visible.length === 0) return {
+			video: await this.renderEmpty(),
+			state: "success"
+		};
+		const key = `${visible}|${JSON.stringify(this.opts.style)}`;
+		if (key !== this.cacheKey || this.cachedBitmap == null) {
+			this.cachedBitmap?.close();
+			this.cachedBitmap = await this.renderTextToFrame(visible);
+			this.cacheKey = key;
+		}
+		return {
+			video: await createImageBitmap(this.cachedBitmap),
+			state: "success"
+		};
+	}
+	/**
+	* 把文字渲染成「整帧」位图（工程分辨率）。
+	*
+	* 为什么不能直接把 renderTxt2ImgBitmap 的结果当帧用：
+	* 它返回的是文字自身尺寸的小图（几十到几百像素宽），Sprite 会把它拉伸到 rect 的
+	* 1280×720 —— 文字被放大后严重模糊，且居中位置由 Sprite 决定而非文字块决定。
+	* 因此这里先渲染文字小图，再按比例居中合成到工程尺寸的画布上。
+	*/
+	async renderTextToFrame(text) {
+		const { width, height } = this.opts;
+		const canvas = new OffscreenCanvas(width, height);
+		const ctx = canvas.getContext("2d");
+		if (ctx == null) throw new Error("无法创建文字渲染上下文");
+		const layer = await (0, _webav_av_cliper.renderTxt2ImgBitmap)(text, cssFromStyle(this.opts.style));
+		const align = this.opts.style.align;
+		const margin = Math.round(width * .05);
+		const maxWidth = width - margin * 2;
+		const scale = layer.width > maxWidth ? maxWidth / layer.width : 1;
+		const drawW = Math.round(layer.width * scale);
+		const drawH = Math.round(layer.height * scale);
+		const x = align === "left" ? margin : align === "right" ? width - margin - drawW : (width - drawW) / 2;
+		const y = Math.round((height - drawH) / 2);
+		ctx.drawImage(layer, x, y, drawW, drawH);
+		layer.close();
+		return canvas.transferToImageBitmap();
+	}
+	emptyBitmap = null;
+	async renderEmpty() {
+		if (this.emptyBitmap != null) return this.emptyBitmap;
+		const canvas = new OffscreenCanvas(this.opts.width, this.opts.height);
+		this.emptyBitmap = canvas.transferToImageBitmap();
+		return this.emptyBitmap;
+	}
+	async split(time) {
+		if (time <= 0 || time >= this.opts.durationUs) throw new Error("\"time\" out of bounds");
+		const left = new TextClip({
+			...this.opts,
+			durationUs: time
+		});
+		const right = new TextClip({
+			...this.opts,
+			durationUs: this.opts.durationUs - time,
+			animOffsetUs: this.opts.animOffsetUs + time
+		});
+		await Promise.all([left.ready, right.ready]);
+		return [left, right];
+	}
+	async clone() {
+		const copy = new TextClip({ ...this.opts });
+		await copy.ready;
+		return copy;
+	}
+	destroy() {
+		this.destroyed = true;
+		this.cachedBitmap?.close();
+		this.cachedBitmap = null;
+		this.emptyBitmap?.close();
+		this.emptyBitmap = null;
+	}
+};
+// src/engine/webav/clip-factory.ts
+/**
+* File → IClip 的分派工厂。
+*
+* ⚠️ 本文件是 `@webav/*` 的合法引用点之一（另一个是 core/webav 下的其他模块）。
+* 不要在 features / store / components 中直接 import WebAV。
+*
+* 所有 clip 实例的生命周期由 `ClipRegistry` 统一管理，这里只负责创建。
+*/
+/**
+* 创建素材的「母版」clip 并读取 meta。
+*
+* 对静态图/文字/字幕，`meta.duration` 可能是 Infinity，这里会归一成有限值：
+* 真正的时长由时间轴 clip 决定，母版只用于 clone 与抽帧。
+*/
+async function createClipFromFile(file, kind) {
+	switch (kind) {
+		case "video": {
+			const clip = new _webav_av_cliper.MP4Clip(require_file_reader.fileToStream(file));
+			const meta = await clip.ready;
+			return {
+				clip,
+				meta: {
+					durationUs: meta.duration,
+					width: meta.width,
+					height: meta.height,
+					hasAudio: meta.audioChanCount > 0
+				}
+			};
+		}
+		case "audio": {
+			const clip = new _webav_av_cliper.AudioClip(require_file_reader.fileToStream(file));
+			return {
+				clip,
+				meta: {
+					durationUs: (await clip.ready).duration,
+					width: 0,
+					height: 0,
+					hasAudio: true
+				}
+			};
+		}
+		case "image": {
+			const clip = new _webav_av_cliper.ImgClip(require_file_reader.fileToStream(file));
+			const meta = await clip.ready;
+			return {
+				clip,
+				meta: {
+					durationUs: Number.isFinite(meta.duration) ? meta.duration : require_id.DEFAULT_STILL_DURATION_US,
+					width: meta.width,
+					height: meta.height,
+					hasAudio: false
+				}
+			};
+		}
+		case "subtitle": {
+			const text = await file.text();
+			const clip = new _webav_av_cliper.EmbedSubtitlesClip(text, {
+				videoWidth: 1280,
+				videoHeight: 720
+			});
+			const meta = await clip.ready;
+			return {
+				clip,
+				meta: {
+					durationUs: Number.isFinite(meta.duration) ? meta.duration : require_id.DEFAULT_STILL_DURATION_US,
+					width: meta.width,
+					height: meta.height,
+					hasAudio: false
+				}
+			};
+		}
+		default: throw new Error(`Unsupported asset kind: ${kind}`);
+	}
+}
+/** 文字素材：不走文件，直接由 TextClip 生成 */
+function createTextClip(init) {
+	return new TextClip({
+		text: init.text,
+		style: init.style,
+		width: init.width,
+		height: init.height,
+		durationUs: init.durationUs
+	});
+}
+function createSubtitleClip(init) {
+	return new _webav_av_cliper.EmbedSubtitlesClip(init.srt, {
+		videoWidth: init.width,
+		videoHeight: init.height,
+		color: init.style.color,
+		textBgColor: init.style.textBgColor,
+		fontFamily: init.style.fontFamily,
+		fontSize: init.style.fontSize,
+		strokeStyle: init.style.strokeStyle,
+		lineWidth: init.style.lineWidth,
+		bottomOffset: init.style.bottomOffset
+	});
+}
+/** Worker 内重建 clip：只支持可序列化的素材类型 */
+function createClipFromBuffer(buffer, kind, opts) {
+	switch (kind) {
+		case "video": return new _webav_av_cliper.MP4Clip(require_file_reader.bufferToStream(buffer));
+		case "audio": return new _webav_av_cliper.AudioClip(require_file_reader.bufferToStream(buffer));
+		case "image": return new _webav_av_cliper.ImgClip(require_file_reader.bufferToStream(buffer));
+		case "subtitle": return createSubtitleClip({
+			srt: opts?.srt ?? "",
+			style: opts?.subtitleStyle ?? DEFAULT_SUBTITLE_STYLE,
+			width: opts?.width ?? 1280,
+			height: opts?.height ?? 720
+		});
+		case "text": return createTextClip({
+			text: opts?.text ?? "",
+			style: opts?.textStyle ?? DEFAULT_TEXT_STYLE,
+			width: opts?.width ?? 1280,
+			height: opts?.height ?? 720,
+			durationUs: opts?.durationUs ?? 5e6
+		});
+		default: throw new Error(`Worker 内不支持重建素材类型：${kind}`);
+	}
+}
 // src/engine/webav/offset-clip.ts
 var OffsetClip = class OffsetClip {
 	ready;
@@ -22,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,
@@ -96,10 +391,10 @@ var ClipRegistry = class {
 	* 这两个类型无法 clone（clone 会带走旧的 duration / 内容），必须每次新建。
 	*/
 	buildProceduralClip(params, asset) {
-		if (asset.kind === "text") return require_import_pipeline.createTextClip({
+		if (asset.kind === "text") return createTextClip({
 			text: params.text ?? asset.text ?? "文本",
 			style: {
-				...require_import_pipeline.DEFAULT_TEXT_STYLE,
+				...DEFAULT_TEXT_STYLE,
 				...asset.textStyle ?? {},
 				...params.textStyle ?? {}
 			},
@@ -107,10 +402,10 @@ var ClipRegistry = class {
 			height: params.projectHeight,
 			durationUs: params.durationUs
 		});
-		return require_import_pipeline.createSubtitleClip({
+		return createSubtitleClip({
 			srt: params.srt ?? asset.srt ?? "",
 			style: {
-				...require_import_pipeline.DEFAULT_SUBTITLE_STYLE,
+				...DEFAULT_SUBTITLE_STYLE,
 				...asset.subtitleStyle ?? {},
 				...params.subtitleStyle ?? {}
 			},
@@ -131,7 +426,7 @@ var ClipRegistry = class {
 		let clip;
 		if (asset.kind === "text" || asset.kind === "subtitle") clip = this.buildProceduralClip(params, asset);
 		else if (runtime.master) clip = await runtime.master.clone();
-		else if (runtime.file) clip = (await require_import_pipeline.createClipFromFile(runtime.file, asset.kind)).clip;
+		else if (runtime.file) clip = (await createClipFromFile(runtime.file, asset.kind)).clip;
 		else throw new Error(`素材缺少可用的数据源：${asset.name}`);
 		const wrapped = params.inPointUs > 0 ? new OffsetClip(clip, {
 			inPointUs: params.inPointUs,
@@ -177,7 +472,7 @@ var ClipRegistry = class {
 			runtime?.master?.destroy();
 		} catch {}
 		this.assets.delete(assetId);
-		require_import_pipeline.releaseThumbnails(assetId);
+		require_thumbnails.releaseThumbnails(assetId);
 	}
 	destroyAllInstances() {
 		for (const [id] of this.derived) this.destroyInstance(id);
@@ -189,7 +484,7 @@ var ClipRegistry = class {
 			try {
 				runtime.master?.destroy();
 			} catch {}
-			require_import_pipeline.releaseThumbnails(assetId);
+			require_thumbnails.releaseThumbnails(assetId);
 		}
 		this.assets.clear();
 	}
@@ -503,17 +798,23 @@ 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(() => require("../chunks/import-pipeline-A8KkqtZT.cjs")).then((n) => n.import_pipeline_exports);
+var loadImportPipeline = () => Promise.resolve().then(() => import_pipeline_exports);
 var loadExportRunner = () => Promise.resolve().then(() => export_runner_exports);
-function errorMessage$1(err) {
-	return err instanceof Error ? err.message : String(err);
-}
 /**
 * 创建编辑器实例。
 *
@@ -546,7 +847,10 @@ function createEditor(options = {}) {
 	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;
@@ -565,11 +869,20 @@ function createEditor(options = {}) {
 			ns: namespace
 		};
 	}
+	/**
+	* 自动保存调度（防抖）。
+	*
+	* 语义是「最后一次结构性变更后静置 intervalMs 才写盘」，而不是
+	* 「第一次变更后固定 intervalMs 写盘」：
+	* 后者在持续编辑（拖滑块、连续裁剪）时会中途写一次，既浪费 I/O，
+	* 又会在宿主展示「保存中」时产生无意义的闪烁。每次新变更都重置计时器。
+	*/
 	function scheduleAutoSave() {
-		if (autoSave == null || disposed || autoSaveTimer != null) return;
+		if (autoSave == null || disposed) return;
+		if (autoSaveTimer != null) clearTimeout(autoSaveTimer);
 		autoSaveTimer = setTimeout(() => {
 			autoSaveTimer = null;
-			editor.save().catch((err) => {
+			enqueueSave().catch((err) => {
 				bus.emit("error", {
 					scope: "auto-save",
 					error: err
@@ -577,6 +890,40 @@ function createEditor(options = {}) {
 			});
 		}, 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) {
@@ -585,11 +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.dirty && autoSave != null) scheduleAutoSave();
 		}
 		if (state.assets !== prevAssets) {
 			prevAssets = state.assets;
@@ -695,8 +1042,10 @@ function createEditor(options = {}) {
 					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, {
-							...result.asset,
+							...withDerived,
 							id: asset.id
 						});
 						stillMissing.delete(asset.id);
@@ -718,20 +1067,7 @@ function createEditor(options = {}) {
 			return { missingAssetIds: remaining };
 		},
 		async save() {
-			const { port, ns } = saveTarget();
-			const result = await port.save(ns, editor.serialize());
-			if (result.ok) {
-				store.getState().markSaved();
-				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;
+			return enqueueSave();
 		},
 		async saveAs(nextStorage, nextNamespace) {
 			storage = nextStorage;
@@ -741,7 +1077,7 @@ function createEditor(options = {}) {
 				storage: nextStorage,
 				namespace: nextNamespace
 			};
-			return editor.save();
+			return enqueueSave();
 		},
 		isDirty: () => store.getState().dirty,
 		isEmpty: () => store.getState().project.clips.length === 0,
@@ -783,8 +1119,10 @@ function createEditor(options = {}) {
 			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, {
-				...result.asset,
+				...withDerived,
 				id: assetId
 			});
 			store.getState().clearMissing(assetId);
@@ -896,7 +1234,7 @@ function createEditor(options = {}) {
 					} 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$1(err),
+							message: errorMessage(err),
 							error: err
 						});
 						throw err;
@@ -916,7 +1254,7 @@ function createEditor(options = {}) {
 			} catch (err) {
 				return {
 					ok: false,
-					error: errorMessage$1(err)
+					error: errorMessage(err)
 				};
 			}
 		},
@@ -927,18 +1265,229 @@ function createEditor(options = {}) {
 		async dispose() {
 			if (disposed) return;
 			disposed = true;
-			if (autoSaveTimer != null) {
-				clearTimeout(autoSaveTimer);
-				autoSaveTimer = null;
-			}
+			const pending = flushAutoSave();
 			unsubscribeStore();
 			bus.emit("dispose", {});
 			await runtime.dispose();
+			try {
+				await pending;
+			} catch {}
 			bus.clear();
 		}
 	};
 	return editor;
 }
+// src/engine/webav/import-pipeline.ts
+/**
+* 素材导入流水线（供 feature 与 Lab 共用）。
+*
+* 步骤：校验类型 → 创建母版 IClip → 读 meta → 抽缩略图 / 波形 → 写入 registry 与 store。
+*
+* ⚠️ 所有 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;
+/**
+* 导入单个文件，生成素材记录。
+*
+* @param onProgress 0~1 进度（用于卡片骨架/进度条）
+* @throws UnsupportedFileError 类型不支持时
+*/
+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 = options.id ?? require_id.createId("asset");
+	const asset = {
+		id: assetId,
+		name: file.name,
+		kind: detected.kind,
+		mimeType: detected.mimeType,
+		size: file.size,
+		durationUs: require_time.asUs(meta.durationUs),
+		width: meta.width,
+		height: meta.height,
+		hasAudio: meta.hasAudio,
+		createdAt: Date.now()
+	};
+	if (detected.kind === "video") {
+		try {
+			asset.thumbnailUrls = (await require_thumbnails.generateThumbnails(clip, assetId, THUMBNAIL_COUNT, meta.durationUs, THUMBNAIL_WIDTH)).map((f) => f.url);
+		} catch (err) {
+			console.warn("[importFile] 缩略图生成失败", err);
+		}
+		onProgress?.(.7);
+	}
+	if (detected.kind === "audio" || detected.kind === "video" && meta.hasAudio) {
+		try {
+			if (detected.kind === "audio") {
+				const pcm = clip.getPCMData();
+				asset.waveform = require_waveform.computeWaveform(pcm, WAVEFORM_BUCKETS);
+			}
+		} catch (err) {
+			console.warn("[importFile] 波形生成失败", err);
+		}
+		onProgress?.(.85);
+	}
+	registry.registerAsset(asset, file, clip);
+	onProgress?.(1);
+	return {
+		asset,
+		clipId: assetId,
+		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 = params.id ?? require_id.createId("asset");
+	const style = {
+		...DEFAULT_TEXT_STYLE,
+		...params.style
+	};
+	const durationUs = params.durationUs ?? 5e6;
+	const master = createTextClip({
+		text: params.text,
+		style,
+		width: params.width,
+		height: params.height,
+		durationUs
+	});
+	const asset = {
+		id: assetId,
+		name: params.text.slice(0, 24) || "文字",
+		kind: "text",
+		mimeType: "text/x-title",
+		size: 0,
+		durationUs: require_time.asUs(durationUs),
+		width: params.width,
+		height: params.height,
+		hasAudio: false,
+		createdAt: Date.now(),
+		text: params.text,
+		textStyle: style
+	};
+	params.registry.registerAsset(asset, null, master);
+	return {
+		asset,
+		clipId: assetId
+	};
+}
+/**
+* 解码素材的完整 PCM（48kHz 双声道），供 Worker 导出使用。
+*
+* ⚠️ 实测：Worker 内没有 AudioContext / OfflineAudioContext，
+* `new AudioClip(stream)` 会在 `decodeAudioData` 处抛错，因此必须在主线程解码后
+* 把 Float32Array 传过去（`new AudioClip(Float32Array[])` 走纯归一化分支）。
+*
+* @returns 声道数组；失败或素材无音轨时返回 undefined
+*/
+async function loadPcmForAsset(registry, assetId) {
+	if (registry.getAsset(assetId) == null) return void 0;
+	const file = registry.getFile(assetId);
+	if (file == null) return void 0;
+	try {
+		const clip = new _webav_av_cliper.AudioClip(require_file_reader.fileToStream(file));
+		await clip.ready;
+		const pcm = clip.getPCMData().map((channel) => new Float32Array(channel));
+		clip.destroy();
+		return pcm;
+	} catch (err) {
+		console.warn("[loadPcmForAsset] 音频解码失败", err);
+		return;
+	}
+}
+/** 解析素材的音频 PCM（供预览音频引擎注册） */
+async function loadAudioClipForAsset(registry, assetId) {
+	const file = registry.getFile(assetId);
+	if (file == null) return null;
+	const asset = registry.getAsset(assetId);
+	if (asset == null) return null;
+	if (asset.kind !== "audio" && asset.kind !== "video") return null;
+	const clip = new _webav_av_cliper.AudioClip(require_file_reader.fileToStream(file));
+	await clip.ready;
+	return clip;
+}
+/** 用第一条字幕文本给素材命名（无内容时回退为「字幕」） */
+function subtitleName(srt) {
+	const base = (srt.split(/\r?\n/).map((line) => line.trim()).find((line) => line.length > 0 && !line.includes("-->") && !/^\d+$/.test(line)) ?? "") || "字幕";
+	return base.length > 20 ? `${base.slice(0, 20)}…` : base;
+}
+/** 新建字幕素材（内容来自粘贴的 SRT，无源文件） */
+function createSubtitleAsset(params) {
+	const assetId = params.id ?? require_id.createId("asset");
+	const style = {
+		...DEFAULT_SUBTITLE_STYLE,
+		...params.style
+	};
+	const durationUs = params.durationUs ?? 5e6;
+	const master = createSubtitleClip({
+		srt: params.srt,
+		style,
+		width: params.width,
+		height: params.height
+	});
+	const asset = {
+		id: assetId,
+		name: subtitleName(params.srt),
+		kind: "subtitle",
+		mimeType: "text/plain",
+		size: params.srt.length,
+		durationUs: require_time.asUs(durationUs),
+		width: params.width,
+		height: params.height,
+		hasAudio: false,
+		createdAt: Date.now(),
+		srt: params.srt,
+		subtitleStyle: style
+	};
+	params.registry.registerAsset(asset, null, master);
+	return {
+		asset,
+		clipId: assetId
+	};
+}
 // src/engine/webav/import-files.ts
 var import_files_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ importFiles: () => importFiles });
 /** 找出可以「重连」的素材 id（同名 + 同类型 + 当前确实缺少二进制） */
@@ -946,9 +1495,6 @@ 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;
 }
-function errorMessage(err) {
-	return err instanceof Error ? err.message : String(err);
-}
 /**
 * 批量导入素材。
 *
@@ -971,7 +1517,7 @@ async function importFiles(registry, store, files, options = {}) {
 			const requestedId = reconnectId ?? idFor?.(file, index) ?? null;
 			const assetId = requestedId != null && requestedId !== "" ? requestedId : void 0;
 			if (reconnectId != null) registry.removeAsset(reconnectId);
-			const result = await require_import_pipeline.importFile(registry, file, (progress) => onProgress?.(index, progress), assetId != null ? { id: assetId } : void 0);
+			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);
@@ -1190,11 +1736,12 @@ function mapClipToOutput(clip, source, target) {
 * @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;
+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: clip.volume,
+		volume,
 		fadeInUs: clip.fadeInUs,
 		fadeOutUs: clip.fadeOutUs,
 		durationUs: clip.durationUs,
@@ -1242,7 +1789,7 @@ async function buildCombinator(inputs, opts) {
 		const { instance, track } = item;
 		const clip = mapClipToOutput(item.clip, sourceSize, targetSize);
 		if (track.kind === "audio" && !opts.includeAudio) continue;
-		if (track.muted) continue;
+		const trackMuted = track.muted;
 		if (clip.muted) continue;
 		const duration = require_canvas_size.clampStillDuration(clip.durationUs);
 		if (clip.durationUs <= 0) {
@@ -1256,7 +1803,7 @@ async function buildCombinator(inputs, opts) {
 			...clip,
 			durationUs: duration
 		};
-		const sprite = createOffscreenSprite(withClipGain(instance, normalized), normalized, { zIndex });
+		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);
@@ -1363,7 +1910,7 @@ async function buildWorkerPayload(registry, project, assets, settings, maxTimeUs
 			continue;
 		}
 		let pcm;
-		if (settings.includeAudio && (asset.kind === "audio" || asset.kind === "video" && asset.hasAudio)) pcm = await require_import_pipeline.loadPcmForAsset(registry, asset.id);
+		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,
@@ -1396,6 +1943,12 @@ async function buildWorkerPayload(registry, project, assets, settings, maxTimeUs
 			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
@@ -1670,6 +2223,7 @@ var SpriteSynchronizer = class {
 				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;
 			}
@@ -1679,7 +2233,7 @@ var SpriteSynchronizer = class {
 				this.registry.destroyInstance(clip.id);
 			}
 			try {
-				const instance = await this.registry.createInstance({
+				const sprite = createVisibleSprite(await this.registry.createInstance({
 					timelineClipId: clip.id,
 					assetId: clip.assetId,
 					inPointUs: clip.inPointUs,
@@ -1690,9 +2244,9 @@ var SpriteSynchronizer = class {
 					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) });
+				}), 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;
@@ -2063,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;
@@ -2125,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,
@@ -2133,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,
@@ -2165,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);
@@ -2180,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;
@@ -2195,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 });
@@ -2216,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 {}
@@ -2258,8 +2849,8 @@ function handleWorkerMessage(event) {
 	});
 }
 exports.ClipRegistry = ClipRegistry;
-exports.DEFAULT_SUBTITLE_STYLE = require_import_pipeline.DEFAULT_SUBTITLE_STYLE;
-exports.DEFAULT_TEXT_STYLE = require_import_pipeline.DEFAULT_TEXT_STYLE;
+exports.DEFAULT_SUBTITLE_STYLE = DEFAULT_SUBTITLE_STYLE;
+exports.DEFAULT_TEXT_STYLE = DEFAULT_TEXT_STYLE;
 exports.ENGINE_DEPENDENCIES_INSTALL_COMMAND = require_waveform.ENGINE_DEPENDENCIES_INSTALL_COMMAND;
 exports.GainClip = GainClip;
 exports.OffsetClip = OffsetClip;
@@ -2268,7 +2859,7 @@ exports.PlaybackClock = PlaybackClock;
 exports.PreviewAudioEngine = PreviewAudioEngine;
 exports.PreviewCanvas = PreviewCanvas;
 exports.SpriteSynchronizer = SpriteSynchronizer;
-exports.TextClip = require_import_pipeline.TextClip;
+exports.TextClip = TextClip;
 exports.UnsupportedFileError = require_file_reader.UnsupportedFileError;
 exports.WorkerUnsupportedClipError = WorkerUnsupportedClipError;
 exports.applyClipToSprite = applyClipToSprite;
@@ -2280,33 +2871,34 @@ exports.canUseWorker = canUseWorker;
 exports.checkExportSupport = checkExportSupport;
 exports.computeExportDuration = computeExportDuration;
 exports.computeTimelineEnd = computeTimelineEnd;
-exports.createClipFromBuffer = require_import_pipeline.createClipFromBuffer;
-exports.createClipFromFile = require_import_pipeline.createClipFromFile;
+exports.createClipFromBuffer = createClipFromBuffer;
+exports.createClipFromFile = createClipFromFile;
 exports.createEditor = createEditor;
 exports.createEditorRuntime = createEditorRuntime;
 exports.createEditorStore = require_waveform.createEditorStore;
 exports.createEventBus = require_waveform.createEventBus;
 exports.createHistoryStore = require_waveform.createHistoryStore;
 exports.createOffscreenSprite = createOffscreenSprite;
-exports.createSubtitleAsset = require_import_pipeline.createSubtitleAsset;
-exports.createSubtitleClip = require_import_pipeline.createSubtitleClip;
-exports.createTextAsset = require_import_pipeline.createTextAsset;
-exports.createTextClip = require_import_pipeline.createTextClip;
+exports.createSubtitleAsset = createSubtitleAsset;
+exports.createSubtitleClip = createSubtitleClip;
+exports.createTextAsset = createTextAsset;
+exports.createTextClip = createTextClip;
 exports.createVisibleSprite = createVisibleSprite;
-exports.cssFromStyle = require_import_pipeline.cssFromStyle;
+exports.cssFromStyle = cssFromStyle;
 exports.detectDependencies = require_waveform.detectDependencies;
 exports.detectEnvironment = require_waveform.detectEnvironment;
 exports.detectOpfs = require_waveform.detectOpfs;
 exports.exportProject = exportProject;
 exports.fixFMP4DurationStream = fixFMP4DurationStream;
 exports.handleWorkerMessage = handleWorkerMessage;
-exports.importFile = require_import_pipeline.importFile;
+exports.importFile = importFile;
 exports.importFiles = importFiles;
 exports.isEnvironmentUsable = require_waveform.isEnvironmentUsable;
-exports.loadAudioClipForAsset = require_import_pipeline.loadAudioClipForAsset;
-exports.loadPcmForAsset = require_import_pipeline.loadPcmForAsset;
+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;