@cut-workbench/core 0.4.0 → 0.4.2

package/dist/engine/index.js

@@ -1,11 +1,303 @@
 import { t as __exportAll } from "../chunks/rolldown-runtime-D8jQpDG7.js";
-import { i as asUs } from "../chunks/time-C_gvkVl1.js";
-import { A as createEmptyProject, N as getProjectDuration, O as clampStillDuration, m as pointInTransform } from "../chunks/canvas-size-CM2oKApi.js";
-import { A as createMemoryStorage, D as createWebBridge, E as resolveExportSettings, M as deserializeProject, N as serializeProject, S as ExportCancelledError, T as createExportFilename, _ as detectDependencies, a as selectAssetById, b as isEnvironmentUsable, c as selectClips, d as selectProjectDuration, f as selectSelectedClipIds, g as ENGINE_DEPENDENCIES_INSTALL_COMMAND, h as createEventBus, i as createEditorStore, l as selectPlayheadUs, m as createHistoryStore, o as selectAssets, p as selectTracks, s as selectClipById, u as selectProject, v as detectEnvironment, x as summarizeCapabilities, y as detectOpfs } from "../chunks/waveform-DJkRtMct.js";
-import { r as detectFileType, t as UnsupportedFileError } from "../chunks/file-reader-OjeI7HTg.js";
-import { a as loadAudioClipForAsset, c as createClipFromBuffer, d as createTextClip, f as TextClip, h as DEFAULT_TEXT_STYLE, l as createClipFromFile, m as DEFAULT_SUBTITLE_STYLE, n as createTextAsset, o as loadPcmForAsset, p as cssFromStyle, r as importFile, s as releaseThumbnails, t as createSubtitleAsset, u as createSubtitleClip } from "../chunks/import-pipeline-DLIdgrIb.js";
-import { Combinator, EmbedSubtitlesClip, ImgClip, MP4Clip, OffscreenSprite, VisibleSprite, fixFMP4Duration } from "@webav/av-cliper";
+import { r as DEFAULT_STILL_DURATION_US, t as createId } from "../chunks/id-CJsdlGei.js";
+import { i as asUs } from "../chunks/time-ChF1GwCy.js";
+import { F as createEmptyProject, N as clampStillDuration, R as getProjectDuration, m as pointInTransform } from "../chunks/canvas-size-Dlnng74w.js";
+import { A as createMemoryStorage, D as createWebBridge, E as resolveExportSettings, M as deserializeProject, N as serializeProject, S as ExportCancelledError, T as createExportFilename, _ as detectDependencies, a as selectAssetById, b as isEnvironmentUsable, c as selectClips, d as selectProjectDuration, f as selectSelectedClipIds, g as ENGINE_DEPENDENCIES_INSTALL_COMMAND, h as createEventBus, i as createEditorStore, l as selectPlayheadUs, m as createHistoryStore, n as computeWaveform, o as selectAssets, p as selectTracks, s as selectClipById, u as selectProject, v as detectEnvironment, x as summarizeCapabilities, y as detectOpfs } from "../chunks/waveform-uyGNE01H.js";
+import { i as fileToStream, n as bufferToStream, r as detectFileType, t as UnsupportedFileError } from "../chunks/file-reader-OjeI7HTg.js";
+import { n as releaseThumbnails, t as generateThumbnails } from "../chunks/thumbnails-qH0dX_Zs.js";
+import { AudioClip, Combinator, EmbedSubtitlesClip, ImgClip, MP4Clip, OffscreenSprite, VisibleSprite, fixFMP4Duration, renderTxt2ImgBitmap } from "@webav/av-cliper";
 import { AVCanvas } from "@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 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 MP4Clip(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 AudioClip(fileToStream(file));
+			return {
+				clip,
+				meta: {
+					durationUs: (await clip.ready).duration,
+					width: 0,
+					height: 0,
+					hasAudio: true
+				}
+			};
+		}
+		case "image": {
+			const clip = new ImgClip(fileToStream(file));
+			const meta = await clip.ready;
+			return {
+				clip,
+				meta: {
+					durationUs: Number.isFinite(meta.duration) ? meta.duration : DEFAULT_STILL_DURATION_US,
+					width: meta.width,
+					height: meta.height,
+					hasAudio: false
+				}
+			};
+		}
+		case "subtitle": {
+			const text = await file.text();
+			const clip = new EmbedSubtitlesClip(text, {
+				videoWidth: 1280,
+				videoHeight: 720
+			});
+			const meta = await clip.ready;
+			return {
+				clip,
+				meta: {
+					durationUs: Number.isFinite(meta.duration) ? meta.duration : 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 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 MP4Clip(bufferToStream(buffer));
+		case "audio": return new AudioClip(bufferToStream(buffer));
+		case "image": return new ImgClip(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;
@@ -21,7 +313,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,
@@ -502,17 +797,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 createWebBridge();
 }
 var loadImportFiles = () => Promise.resolve().then(() => import_files_exports);
-var loadImportPipeline = () => import("../chunks/import-pipeline-DLIdgrIb.js").then((n) => n.i);
+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);
-}
 /**
 * 创建编辑器实例。
 *
@@ -545,7 +846,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;
@@ -564,11 +868,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
@@ -576,6 +889,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) {
@@ -584,11 +931,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;
@@ -694,8 +1041,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);
@@ -717,20 +1066,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;
@@ -740,7 +1076,7 @@ function createEditor(options = {}) {
 				storage: nextStorage,
 				namespace: nextNamespace
 			};
-			return editor.save();
+			return enqueueSave();
 		},
 		isDirty: () => store.getState().dirty,
 		isEmpty: () => store.getState().project.clips.length === 0,
@@ -782,8 +1118,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);
@@ -895,7 +1233,7 @@ function createEditor(options = {}) {
 					} catch (err) {
 						if (cancelled || err instanceof ExportCancelledError) throw err instanceof ExportCancelledError ? err : new ExportCancelledError();
 						bus.emit("export:error", {
-							message: errorMessage$1(err),
+							message: errorMessage(err),
 							error: err
 						});
 						throw err;
@@ -915,7 +1253,7 @@ function createEditor(options = {}) {
 			} catch (err) {
 				return {
 					ok: false,
-					error: errorMessage$1(err)
+					error: errorMessage(err)
 				};
 			}
 		},
@@ -926,18 +1264,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__ */ __exportAll({
+	UnsupportedFileError: () => 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 = detectFileType(file);
+	onProgress?.(.1);
+	const { clip, meta } = await createClipFromFile(file, detected.kind);
+	onProgress?.(.4);
+	const assetId = options.id ?? createId("asset");
+	const asset = {
+		id: assetId,
+		name: file.name,
+		kind: detected.kind,
+		mimeType: detected.mimeType,
+		size: file.size,
+		durationUs: asUs(meta.durationUs),
+		width: meta.width,
+		height: meta.height,
+		hasAudio: meta.hasAudio,
+		createdAt: Date.now()
+	};
+	if (detected.kind === "video") {
+		try {
+			asset.thumbnailUrls = (await 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 = 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 import("../chunks/thumbnails-qH0dX_Zs.js").then((n) => n.r);
+		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 = computeWaveform(pcm, WAVEFORM_BUCKETS);
+		}
+	} catch (err) {
+		console.warn("[regenerateDerived] 波形生成失败", asset.id, err);
+	}
+	return next;
+}
+/** 新建文字素材（非文件来源，无需二进制） */
+function createTextAsset(params) {
+	const assetId = params.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: 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 AudioClip(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 AudioClip(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 ?? 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: 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__ */ __exportAll({ importFiles: () => importFiles });
 /** 找出可以「重连」的素材 id（同名 + 同类型 + 当前确实缺少二进制） */
@@ -945,9 +1494,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);
-}
 /**
 * 批量导入素材。
 *
@@ -1189,11 +1735,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,
@@ -1241,7 +1788,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 = clampStillDuration(clip.durationUs);
 		if (clip.durationUs <= 0) {
@@ -1255,7 +1802,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);
@@ -1395,6 +1942,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
@@ -1669,6 +2222,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;
 			}
@@ -1678,7 +2232,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,
@@ -1689,9 +2243,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;
@@ -2062,6 +2616,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;
@@ -2124,6 +2688,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 Combinator({
 		width: timeline.width,
 		height: timeline.height,
@@ -2132,7 +2697,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,
@@ -2164,11 +2730,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);
@@ -2179,7 +2748,24 @@ async function runExportInWorker(assets, timeline, onProgress, shouldCancel) {
 				continue;
 			}
 			const tc = item.clip;
-			const sprite = new 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 OffscreenSprite(withGain(gainInput, tc));
 			const mapped = mapTransformToOutput(tc.transform, sourceSize, targetSize);
 			sprite.rect.x = mapped.x;
 			sprite.rect.y = mapped.y;
@@ -2194,6 +2780,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 });
@@ -2215,10 +2802,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 {}
@@ -2256,6 +2847,6 @@ function handleWorkerMessage(event) {
 		});
 	});
 }
-export { ClipRegistry, DEFAULT_SUBTITLE_STYLE, DEFAULT_TEXT_STYLE, ENGINE_DEPENDENCIES_INSTALL_COMMAND, GainClip, OffsetClip, PcmClip, PlaybackClock, PreviewAudioEngine, PreviewCanvas, SpriteSynchronizer, TextClip, UnsupportedFileError, WorkerUnsupportedClipError, applyClipToSprite, applyOpacityFade, buildClipInWorker, buildCombinator, buildWorkerPayload, canUseWorker, checkExportSupport, computeExportDuration, computeTimelineEnd, createClipFromBuffer, createClipFromFile, createEditor, createEditorRuntime, createEditorStore, createEventBus, createHistoryStore, createOffscreenSprite, createSubtitleAsset, createSubtitleClip, createTextAsset, createTextClip, createVisibleSprite, cssFromStyle, detectDependencies, detectEnvironment, detectOpfs, exportProject, fixFMP4DurationStream, handleWorkerMessage, importFile, importFiles, isEnvironmentUsable, loadAudioClipForAsset, loadPcmForAsset, mapClipToOutput, mapTransformToOutput, runExportInWorker, selectAssetById, selectAssets, selectClipById, selectClips, selectPlayheadUs, selectProject, selectProjectDuration, selectSelectedClipIds, selectTracks, setDefaultExportWorkerFactory, startExport, summarizeCapabilities, withClipGain };
+export { ClipRegistry, DEFAULT_SUBTITLE_STYLE, DEFAULT_TEXT_STYLE, ENGINE_DEPENDENCIES_INSTALL_COMMAND, GainClip, OffsetClip, PcmClip, PlaybackClock, PreviewAudioEngine, PreviewCanvas, SpriteSynchronizer, TextClip, UnsupportedFileError, WorkerUnsupportedClipError, applyClipToSprite, applyOpacityFade, buildClipInWorker, buildCombinator, buildWorkerPayload, canUseWorker, checkExportSupport, computeExportDuration, computeTimelineEnd, createClipFromBuffer, createClipFromFile, createEditor, createEditorRuntime, createEditorStore, createEventBus, createHistoryStore, createOffscreenSprite, createSubtitleAsset, createSubtitleClip, createTextAsset, createTextClip, createVisibleSprite, cssFromStyle, detectDependencies, detectEnvironment, detectOpfs, exportProject, fixFMP4DurationStream, handleWorkerMessage, importFile, importFiles, isEnvironmentUsable, loadAudioClipForAsset, loadPcmForAsset, mapClipToOutput, mapTransformToOutput, regenerateDerived, runExportInWorker, selectAssetById, selectAssets, selectClipById, selectClips, selectPlayheadUs, selectProject, selectProjectDuration, selectSelectedClipIds, selectTracks, setDefaultExportWorkerFactory, startExport, summarizeCapabilities, withClipGain };
 
 //# sourceMappingURL=index.js.map