@cut-workbench/core 0.3.0 → 0.4.0

package/dist/engine/webav/export-runner.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 导出编排（core 版本）。
+ *
+ * 分层：本模块允许 import `@webav/*`（位于 engine/webav 下），但**不**依赖 React，
+ * 也不做任何 UI。上层（`editor.export()` 与 `<CutWorkbench>` 的导出对话框）
+ * 都消费同一套逻辑，避免「UI 里能导出、命令式 API 不能导出」的分裂。
+ *
+ * 两条路径：
+ * - 默认走 Worker（不阻塞 UI）；
+ * - 含文字片段（依赖 DOM）或 Worker 不可用时回退主线程；
+ * - 含音频 / 视频音轨时，主线程会先解码 PCM 再传给 Worker
+ *   （Worker 内没有 AudioContext，AudioClip 无法自行解码）。
+ */
+import type { MediaAsset, Project } from '../../types';
+import type { ExportSettings } from '../../types';
+import type { ExportResult } from '../../export/types';
+import type { ClipRegistry } from './clip-registry';
+import type { WorkerAssetPayload, WorkerTimelinePayload } from './types';
+export interface ExportPlanOptions {
+    registry: ClipRegistry;
+    /**
+     * Worker 工厂；返回 null 表示不可用，直接走主线程。
+     * 不传时使用 `setDefaultExportWorkerFactory` 注册的默认实现（若有）。
+     */
+    createWorker?: () => Worker | null;
+    project: Project;
+    assets: MediaAsset[];
+    settings: ExportSettings;
+    /** 导出上限（微秒），默认全片 */
+    maxTimeUs?: number;
+    /** 输出 Blob 的 MIME，默认 video/mp4 */
+    mimeType?: string;
+    filename?: string;
+}
+export interface CoreExportHandle {
+    promise: Promise<ExportResult>;
+    cancel: () => void;
+}
+export declare function setDefaultExportWorkerFactory(factory: (() => Worker | null) | null): void;
+/** 判断是否可以用 Worker 导出（文字素材依赖 DOM） */
+export declare function canUseWorker(project: Project, assets: MediaAsset[]): boolean;
+/** 参与导出的片段最大结束时间（跳过隐藏轨道） */
+export declare function computeExportDuration(project: Project, maxTimeUs?: number): number;
+/**
+ * 构建 Worker 载荷。
+ *
+ * 音频素材需要主线程预解码 PCM（Worker 无 AudioContext）。为避免无谓解码，
+ * 只有「音频轨素材」或「含音轨且会被播放的视频」才解码。
+ */
+export declare function buildWorkerPayload(registry: ClipRegistry, project: Project, assets: MediaAsset[], settings: ExportSettings, maxTimeUs?: number): Promise<{
+    assets: WorkerAssetPayload[];
+    timeline: WorkerTimelinePayload;
+    missing: string[];
+}>;
+/**
+ * 启动导出。
+ *
+ * 优先走 Worker（不阻塞 UI）；含文字片段或 Worker 不可用 / 失败时回退主线程。
+ * `cancel()` 后 promise 以 `ExportCancelledError` reject。
+ */
+export declare function startExport(options: ExportPlanOptions, onProgress?: (progress: number) => void): CoreExportHandle;

package/dist/engine/webav/import-files.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 批量导入素材（core 的唯一实现）。
+ *
+ * 为什么放在 core：导入语义（重连缺失素材、id 注入、失败汇总、串行解码）
+ * 被三处调用 —— `<CutWorkbench>` 的 `useMediaImport`、`initCutWorkbench().addFiles`、
+ * 以及 `editor.addFiles`。过去 workbench 里另有一份实现，行为与 init 那份不一致
+ * （init 不重连、不报进度），宿主换个入口就得到不同结果。
+ *
+ * 本文件位于 `engine/webav` 下，因此允许 import `@webav/*`（经 importFile 间接）。
+ * 编辑器句柄会**动态**加载它，宿主不需要自己写动态 import。
+ */
+import type { StoreApi } from 'zustand/vanilla';
+import type { MediaAsset } from '../../types';
+import type { EditorState } from '../../editor/editor-store';
+import type { ClipRegistry } from './clip-registry';
+export interface ImportFilesOptions {
+    /** 导入成功后选中第一个素材；默认 true */
+    select?: boolean;
+    /** 逐文件进度：index 为入参数组下标，progress 为 0~1 */
+    onProgress?: (index: number, progress: number) => void;
+    /** 由宿主指定素材 id；返回 falsy 则回退到库生成的 `asset_xxx` */
+    idFor?: (file: File, index: number) => string | null | undefined;
+    /** 与缺失源文件的素材同名同类型时重连而非新增；默认 true */
+    reconnect?: boolean;
+}
+export interface ImportFilesResult {
+    imported: MediaAsset[];
+    failures: Array<{
+        name: string;
+        error: string;
+    }>;
+    /** 其中走重连的数量 */
+    reconnected: number;
+}
+/**
+ * 批量导入素材。
+ *
+ * - 串行处理，避免同时开辟多个解码器把内存打爆；
+ * - 单个文件失败只影响自身，最后汇总返回；
+ * - 进度由调用方通过 `onProgress` 展示（不写 store，避免高频全局重渲染）；
+ * - 与「缺失源文件」的素材同名同类型时重连，复用原 assetId。
+ */
+export declare function importFiles(registry: ClipRegistry, store: StoreApi<EditorState>, files: File[], options?: ImportFilesOptions): Promise<ImportFilesResult>;

package/dist/engine/webav/import-pipeline.d.ts

@@ -16,13 +16,21 @@ export interface ImportedAsset {
     /** 母版 clip（重连素材时用于替换旧的母版） */
     master?: IClip;
 }
+export interface ImportFileOptions {
+    /**
+     * 指定素材 id（宿主把自己的素材记录 id 作为 `MediaAsset.id`）。
+     *
+     * 传了就必须保证会话内唯一：重复注册会覆盖 registry 里的旧素材。
+     */
+    id?: string;
+}
 /**
  * 导入单个文件，生成素材记录。
  *
  * @param onProgress 0~1 进度（用于卡片骨架/进度条）
  * @throws UnsupportedFileError 类型不支持时
  */
-export declare function importFile(registry: ClipRegistry, file: File, onProgress?: (progress: number) => void): Promise<ImportedAsset>;
+export declare function importFile(registry: ClipRegistry, file: File, onProgress?: (progress: number) => void, options?: ImportFileOptions): Promise<ImportedAsset>;
 /** 新建文字素材（非文件来源，无需二进制） */
 export declare function createTextAsset(params: {
     registry: ClipRegistry;
@@ -31,6 +39,8 @@ export declare function createTextAsset(params: {
     width: number;
     height: number;
     durationUs?: number;
+    /** 指定素材 id；不传则生成 `asset_xxx` */
+    id?: string;
 }): ImportedAsset;
 /**
  * 解码素材的完整 PCM（48kHz 双声道），供 Worker 导出使用。
@@ -52,5 +62,7 @@ export declare function createSubtitleAsset(params: {
     height: number;
     durationUs?: number;
     style?: Partial<import('../../types').SubtitleStyle>;
+    /** 指定素材 id；不传则生成 `asset_xxx` */
+    id?: string;
 }): ImportedAsset;
 export { UnsupportedFileError };

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 对外错误类型。
+ *
+ * 放在根入口（不依赖 WebAV / React），宿主可以 `instanceof` 判断后决定
+ * 是否弹错误框 —— 用户主动取消导出不是错误，不该被当成失败提示。
+ */
+/** 导出被 `cancel()` 取消。 */
+export declare class ExportCancelledError extends Error {
+    constructor(message?: string);
+}
+/** 判断任意异常是否是「用户取消导出」。 */
+export declare function isExportCancelled(error: unknown): error is ExportCancelledError;

package/dist/export/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 导出能力的公开契约（纯类型 + 纯函数，不依赖 WebAV / React）。
+ *
+ * 放在根入口可达的位置，宿主可以只依赖 `@cut-workbench/core` 就能标注
+ * 导出请求与结果，不必为了类型去加载引擎子入口。
+ */
+import type { ExportSettings, Project } from '../types';
+export interface ExportRequest {
+    /** 输出参数；缺省为 1080p / 30fps / 8Mbps */
+    settings?: Partial<ExportSettings>;
+    /** 输出 blob 的 MIME，默认 `video/mp4` */
+    mimeType?: string;
+    /** 输出文件名（不含路径），默认按时间生成 */
+    filename?: string;
+}
+export interface ExportResult {
+    blob: Blob;
+    filename: string;
+    mimeType: string;
+    /** 成片时长（微秒）。宿主入库需要 */
+    durationUs: number;
+    width: number;
+    height: number;
+    fps: number;
+    bitrate: number;
+    elapsedMs: number;
+    /** 实际执行路径：Worker 或主线程回退（诊断用，宿主可忽略） */
+    mode: 'worker' | 'main';
+    /** 被跳过的片段（缺源文件 / 类型不支持） */
+    skipped: Array<{
+        clipId: string;
+        reason: string;
+    }>;
+}
+export interface ExportHandle {
+    promise: Promise<ExportResult>;
+    cancel(): void;
+}
+/** 导出默认值：1080p / 30fps / 8Mbps / 含音轨 */
+export declare const DEFAULT_EXPORT_SETTINGS: ExportSettings;
+/**
+ * 把宿主传入的局部设置补全为完整设置。
+ *
+ * 只给了 `preset` 时按预设推导尺寸（`source` 取工程尺寸并向下对齐到偶数），
+ * 显式给了 `width` / `height` 则以显式值为准。
+ */
+export declare function resolveExportSettings(project: Project, partial?: Partial<ExportSettings>): ExportSettings;
+/** 默认文件名（与编辑器无关，宿主可覆盖） */
+export declare function createExportFilename(date?: Date): string;

package/dist/index.cjs

@@ -1,49 +1,52 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_canvas_size = require("./chunks/canvas-size-IzoEg2cq.cjs");
-const require_snap = require("./chunks/snap-CeYuTN6d.cjs");
-const require_waveform = require("./chunks/waveform-Bhvv2t7-.cjs");
+const require_time = require("./chunks/time-CnMfSVYX.cjs");
+const require_canvas_size = require("./chunks/canvas-size-Ct61OYjW.cjs");
+const require_snap = require("./chunks/snap-DyIuO2hU.cjs");
+const require_waveform = require("./chunks/waveform-Ie-G5Lle.cjs");
+const require_srt = require("./chunks/srt-DaL36mXN.cjs");
 const require_file_reader = require("./chunks/file-reader-DfMEluGr.cjs");
-// src/media/srt.ts
-var TIME_RE = /(\d{2}):(\d{2}):(\d{2})[,.](\d{3})/g;
-function toMs(h, m, s, ms) {
-	return Number(h) * 36e5 + Number(m) * 6e4 + Number(s) * 1e3 + Number(ms);
+// src/project/file-storage.ts
+var JSON_EXT = ".json";
+/** namespace → 安全文件名（不含扩展名） */
+function toStorageFileName(namespace) {
+	const safe = namespace.replace(/[\\/:*?"<>|\u0000-\u001f]/g, "_").replace(/^\.+/, "_").trim();
+	return (safe.length > 0 ? safe : "default") + JSON_EXT;
 }
-/** 解析 SRT 文本为 cue 列表；格式错误时返回空数组（调用方给出友好提示） */
-function parseSrt(content) {
-	const blocks = content.replace(/\r\n/g, "\n").split(/\n{2,}/);
-	const cues = [];
-	for (const block of blocks) {
-		const lines = block.split("\n").map((l) => l.trim()).filter(Boolean);
-		if (lines.length === 0) continue;
-		const timeLineIndex = lines.findIndex((l) => l.includes("-->"));
-		if (timeLineIndex < 0) continue;
-		const timeLine = lines[timeLineIndex] ?? "";
-		TIME_RE.lastIndex = 0;
-		const matches = Array.from(timeLine.matchAll(TIME_RE));
-		if (matches.length < 2) continue;
-		const [startMatch, endMatch] = matches;
-		if (startMatch == null || endMatch == null) continue;
-		const startMs = toMs(startMatch[1] ?? "0", startMatch[2] ?? "0", startMatch[3] ?? "0", startMatch[4] ?? "0");
-		const endMs = toMs(endMatch[1] ?? "0", endMatch[2] ?? "0", endMatch[3] ?? "0", endMatch[4] ?? "0");
-		if (endMs <= startMs) continue;
-		cues.push({
-			index: cues.length + 1,
-			startMs,
-			endMs,
-			text: lines.slice(timeLineIndex + 1).join("\n")
-		});
-	}
-	return cues;
-}
-/** 字幕总时长（微秒）。用于给字幕素材一个有限的 deration */
-function parseSrtDurationUs(content) {
-	const cues = parseSrt(content);
-	const last = cues[cues.length - 1];
-	return last == null ? 0 : Math.round(last.endMs * 1e3);
+function joinPath(dir, name) {
+	const separator = dir.includes("\\") && !dir.includes("/") ? "\\" : "/";
+	return dir.endsWith("/") || dir.endsWith("\\") ? `${dir}${name}` : `${dir}${separator}${name}`;
 }
-/** 简单校验：至少一条 cue */
-function isValidSrt(content) {
-	return parseSrt(content).length > 0;
+function createFileStorage(dir, io) {
+	const pathFor = (namespace) => joinPath(dir, toStorageFileName(namespace));
+	return {
+		async load(namespace) {
+			const text = await io.readText(pathFor(namespace));
+			if (text == null || text.trim().length === 0) return null;
+			return JSON.parse(text);
+		},
+		async save(namespace, data) {
+			const path = pathFor(namespace);
+			try {
+				await io.writeText(path, JSON.stringify(data, null, 2));
+				return {
+					ok: true,
+					path
+				};
+			} catch (err) {
+				return {
+					ok: false,
+					path,
+					error: err instanceof Error ? err.message : String(err)
+				};
+			}
+		},
+		async remove(namespace) {
+			await io.remove(pathFor(namespace));
+		},
+		async list() {
+			return (await io.list(dir)).filter((name) => name.toLowerCase().endsWith(JSON_EXT)).map((name) => name.slice(0, -5)).sort();
+		}
+	};
 }
 // src/media/opfs.ts
 /**
@@ -115,25 +118,27 @@ async function estimateQuota() {
 	}
 }
 exports.ASPECT_PRESETS = require_canvas_size.ASPECT_PRESETS;
-exports.DEFAULT_CLIP_VOLUME = require_canvas_size.DEFAULT_CLIP_VOLUME;
-exports.DEFAULT_STILL_DURATION_US = require_canvas_size.DEFAULT_STILL_DURATION_US;
+exports.DEFAULT_CLIP_VOLUME = require_time.DEFAULT_CLIP_VOLUME;
+exports.DEFAULT_EXPORT_SETTINGS = require_waveform.DEFAULT_EXPORT_SETTINGS;
+exports.DEFAULT_STILL_DURATION_US = require_time.DEFAULT_STILL_DURATION_US;
 exports.EMPTY_SNAP = require_snap.EMPTY_SNAP;
 exports.ENGINE_DEPENDENCIES_INSTALL_COMMAND = require_waveform.ENGINE_DEPENDENCIES_INSTALL_COMMAND;
-exports.HISTORY_MERGE_WINDOW_MS = require_canvas_size.HISTORY_MERGE_WINDOW_MS;
-exports.MAX_HISTORY_STEPS = require_canvas_size.MAX_HISTORY_STEPS;
+exports.ExportCancelledError = require_waveform.ExportCancelledError;
+exports.HISTORY_MERGE_WINDOW_MS = require_time.HISTORY_MERGE_WINDOW_MS;
+exports.MAX_HISTORY_STEPS = require_time.MAX_HISTORY_STEPS;
 exports.MIN_TRANSFORM_SIZE = require_canvas_size.MIN_TRANSFORM_SIZE;
-exports.PROJECT_SCHEMA_VERSION = require_canvas_size.PROJECT_SCHEMA_VERSION;
+exports.PROJECT_SCHEMA_VERSION = require_time.PROJECT_SCHEMA_VERSION;
 exports.ProjectSchemaError = require_waveform.ProjectSchemaError;
 exports.RESIZE_HANDLES = require_canvas_size.RESIZE_HANDLES;
-exports.US_PER_MS = require_canvas_size.US_PER_MS;
-exports.US_PER_SECOND = require_canvas_size.US_PER_SECOND;
+exports.US_PER_MS = require_time.US_PER_MS;
+exports.US_PER_SECOND = require_time.US_PER_SECOND;
 exports.UnsupportedFileError = require_file_reader.UnsupportedFileError;
-exports.asPx = require_canvas_size.asPx;
-exports.asUs = require_canvas_size.asUs;
+exports.asPx = require_time.asPx;
+exports.asUs = require_time.asUs;
 exports.bufferToStream = require_file_reader.bufferToStream;
-exports.buildTicks = require_canvas_size.buildTicks;
+exports.buildTicks = require_time.buildTicks;
 exports.buildWaveformPath = require_waveform.buildWaveformPath;
-exports.clamp = require_canvas_size.clamp;
+exports.clamp = require_time.clamp;
 exports.clampStillDuration = require_canvas_size.clampStillDuration;
 exports.clearTempFiles = clearTempFiles;
 exports.compactTrackData = require_canvas_size.compactTrackData;
@@ -144,8 +149,10 @@ exports.createClip = require_canvas_size.createClip;
 exports.createEditorStore = require_waveform.createEditorStore;
 exports.createEmptyProject = require_canvas_size.createEmptyProject;
 exports.createEventBus = require_waveform.createEventBus;
+exports.createExportFilename = require_waveform.createExportFilename;
+exports.createFileStorage = createFileStorage;
 exports.createHistoryStore = require_waveform.createHistoryStore;
-exports.createId = require_canvas_size.createId;
+exports.createId = require_time.createId;
 exports.createIndexedDbStorage = require_waveform.createIndexedDbStorage;
 exports.createMemoryStorage = require_waveform.createMemoryStorage;
 exports.createTrack = require_canvas_size.createTrack;
@@ -161,8 +168,8 @@ exports.duplicateClipsData = require_canvas_size.duplicateClipsData;
 exports.estimateQuota = estimateQuota;
 exports.fileToStream = require_file_reader.fileToStream;
 exports.findOverlaps = require_canvas_size.findOverlaps;
-exports.formatDuration = require_canvas_size.formatDuration;
-exports.formatTimecode = require_canvas_size.formatTimecode;
+exports.formatDuration = require_time.formatDuration;
+exports.formatTimecode = require_time.formatTimecode;
 exports.fromLocalPoint = require_canvas_size.fromLocalPoint;
 exports.getClipEnd = require_canvas_size.getClipEnd;
 exports.getProjectDuration = require_canvas_size.getProjectDuration;
@@ -174,19 +181,20 @@ exports.handleCursor = require_canvas_size.handleCursor;
 exports.handleLocalOffset = require_canvas_size.handleLocalOffset;
 exports.isCustomSize = require_canvas_size.isCustomSize;
 exports.isEnvironmentUsable = require_waveform.isEnvironmentUsable;
+exports.isExportCancelled = require_waveform.isExportCancelled;
 exports.isTrackAudible = require_canvas_size.isTrackAudible;
-exports.isValidSrt = isValidSrt;
+exports.isValidSrt = require_srt.isValidSrt;
 exports.moveClipData = require_canvas_size.moveClipData;
-exports.msToUs = require_canvas_size.msToUs;
+exports.msToUs = require_time.msToUs;
 exports.nearestSorted = require_snap.nearestSorted;
 exports.normalizeAngle = require_canvas_size.normalizeAngle;
 exports.normalizeSize = require_canvas_size.normalizeSize;
 exports.normalizeWaveform = require_waveform.normalizeWaveform;
-exports.parseSrt = parseSrt;
-exports.parseSrtDurationUs = parseSrtDurationUs;
+exports.parseSrt = require_srt.parseSrt;
+exports.parseSrtDurationUs = require_srt.parseSrtDurationUs;
 exports.pointInTransform = require_canvas_size.pointInTransform;
 exports.probeOpfs = probeOpfs;
-exports.pxToUs = require_canvas_size.pxToUs;
+exports.pxToUs = require_time.pxToUs;
 exports.rangesOverlap = require_canvas_size.rangesOverlap;
 exports.ratioLabel = require_canvas_size.ratioLabel;
 exports.readTempFile = readTempFile;
@@ -198,8 +206,9 @@ exports.removeClipsData = require_canvas_size.removeClipsData;
 exports.removeTempFile = removeTempFile;
 exports.reorderTracksData = require_canvas_size.reorderTracksData;
 exports.resizeTransform = require_canvas_size.resizeTransform;
+exports.resolveExportSettings = require_waveform.resolveExportSettings;
 exports.sameTransform = require_canvas_size.sameTransform;
-exports.secToUs = require_canvas_size.secToUs;
+exports.secToUs = require_time.secToUs;
 exports.selectAssetById = require_waveform.selectAssetById;
 exports.selectAssets = require_waveform.selectAssets;
 exports.selectClipById = require_waveform.selectClipById;
@@ -213,10 +222,11 @@ exports.serializeProject = require_waveform.serializeProject;
 exports.splitClipData = require_canvas_size.splitClipData;
 exports.summarizeCapabilities = require_waveform.summarizeCapabilities;
 exports.toLocalPoint = require_canvas_size.toLocalPoint;
+exports.toStorageFileName = toStorageFileName;
 exports.trimClipData = require_canvas_size.trimClipData;
-exports.usToMs = require_canvas_size.usToMs;
-exports.usToPx = require_canvas_size.usToPx;
-exports.usToSec = require_canvas_size.usToSec;
+exports.usToMs = require_time.usToMs;
+exports.usToPx = require_time.usToPx;
+exports.usToSec = require_time.usToSec;
 exports.writeTempFile = writeTempFile;
 
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/media/srt.ts","../src/media/opfs.ts"],"sourcesContent":["/**\n * SRT 解析工具（仅用于估算字幕素材时长、校验格式）。\n *\n * 真正的字幕渲染交给 EmbedSubtitlesClip，这里只做纯文本解析，\n * 从而让 UI 能在创建素材时立刻知道时长。\n */\n\nexport interface SrtCue {\n  index: number\n  startMs: number\n  endMs: number\n  text: string\n}\n\nconst TIME_RE = /(\\d{2}):(\\d{2}):(\\d{2})[,.](\\d{3})/g\n\nfunction toMs(h: string, m: string, s: string, ms: string): number {\n  return Number(h) * 3_600_000 + Number(m) * 60_000 + Number(s) * 1_000 + Number(ms)\n}\n\n/** 解析 SRT 文本为 cue 列表；格式错误时返回空数组（调用方给出友好提示） */\nexport function parseSrt(content: string): SrtCue[] {\n  const blocks = content.replace(/\\r\\n/g, '\\n').split(/\\n{2,}/)\n  const cues: SrtCue[] = []\n  for (const block of blocks) {\n    const lines = block.split('\\n').map((l) => l.trim()).filter(Boolean)\n    if (lines.length === 0) continue\n    const timeLineIndex = lines.findIndex((l) => l.includes('-->'))\n    if (timeLineIndex < 0) continue\n    const timeLine = lines[timeLineIndex] ?? ''\n    TIME_RE.lastIndex = 0\n    const matches = Array.from(timeLine.matchAll(TIME_RE))\n    if (matches.length < 2) continue\n    const [startMatch, endMatch] = matches\n    if (startMatch == null || endMatch == null) continue\n    const startMs = toMs(startMatch[1] ?? '0', startMatch[2] ?? '0', startMatch[3] ?? '0', startMatch[4] ?? '0')\n    const endMs = toMs(endMatch[1] ?? '0', endMatch[2] ?? '0', endMatch[3] ?? '0', endMatch[4] ?? '0')\n    if (endMs <= startMs) continue\n    cues.push({\n      index: cues.length + 1,\n      startMs,\n      endMs,\n      text: lines.slice(timeLineIndex + 1).join('\\n'),\n    })\n  }\n  return cues\n}\n\n/** 字幕总时长（微秒）。用于给字幕素材一个有限的 deration */\nexport function parseSrtDurationUs(content: string): number {\n  const cues = parseSrt(content)\n  const last = cues[cues.length - 1]\n  return last == null ? 0 : Math.round(last.endMs * 1000)\n}\n\n/** 简单校验：至少一条 cue */\nexport function isValidSrt(content: string): boolean {\n  return parseSrt(content).length > 0\n}\n","/**\n * OPFS 可用性探测与临时文件辅助。\n *\n * WebAV 内部（opfs-tools）在模块加载期就会访问 `navigator.storage.getDirectory()`，\n * 因此这里只使用原生 File System Access API，不 import opfs-tools，避免重复副作用。\n *\n * 使用策略：小文件直接 `file.stream()` 喂给 MP4Clip；只有需要随机读取的大文件\n * 才落盘到 OPFS 临时目录（WebAV 自身也会在内部做同样的事，这里只提供探测与清理）。\n */\n\nconst TEMP_DIR = 'cut-test-tmp'\n\nexport interface OpfsProbeResult {\n  available: boolean\n  reason?: string\n}\n\nlet probeCache: OpfsProbeResult | null = null\n\nexport async function probeOpfs(force = false): Promise<OpfsProbeResult> {\n  if (probeCache && !force) return probeCache\n  try {\n    if (typeof navigator === 'undefined' || navigator.storage?.getDirectory == null) {\n      probeCache = { available: false, reason: '浏览器未实现 File System Access API。' }\n      return probeCache\n    }\n    await navigator.storage.getDirectory()\n    probeCache = { available: true }\n  } catch (err) {\n    probeCache = {\n      available: false,\n      reason: err instanceof Error ? err.message : String(err),\n    }\n  }\n  return probeCache\n}\n\nasync function getTempDir(): Promise<FileSystemDirectoryHandle> {\n  const root = await navigator.storage.getDirectory()\n  return root.getDirectoryHandle(TEMP_DIR, { create: true })\n}\n\n/** 写入临时文件，返回文件名；调用方负责后续清理 */\nexport async function writeTempFile(name: string, data: Blob | ArrayBuffer): Promise<string> {\n  const dir = await getTempDir()\n  const handle = await dir.getFileHandle(name, { create: true })\n  const writable = await handle.createWritable()\n  await writable.write(data)\n  await writable.close()\n  return name\n}\n\n/** 读取临时文件 */\nexport async function readTempFile(name: string): Promise<File> {\n  const dir = await getTempDir()\n  const handle = await dir.getFileHandle(name)\n  return handle.getFile()\n}\n\nexport async function removeTempFile(name: string): Promise<void> {\n  try {\n    const dir = await getTempDir()\n    await dir.removeEntry(name)\n  } catch {\n    // 文件不存在时静默忽略：清理流程不应打断主流程\n  }\n}\n\n/** 清空整个临时目录 */\nexport async function clearTempFiles(): Promise<void> {\n  try {\n    const root = await navigator.storage.getDirectory()\n    await root.removeEntry(TEMP_DIR, { recursive: true })\n  } catch {\n    // 目录不存在时忽略\n  }\n}\n\n/** 估算可用配额（用于导出前的提示） */\nexport async function estimateQuota(): Promise<{ usage: number; quota: number } | null> {\n  try {\n    const estimate = await navigator.storage.estimate()\n    return { usage: estimate.usage ?? 0, quota: estimate.quota ?? 0 }\n  } catch {\n    return null\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/project/file-storage.ts","../src/media/opfs.ts"],"sourcesContent":["/**\n * 文件式存储适配器。\n *\n * 宿主要把工程存成本地 JSON（Electron 主进程写盘）时，只需要提供四个文本\n * 操作，不必理解 `SerializedProject` 的字段。\n *\n * 映射规则：`<dir>/<namespace>.json`。namespace 做一次文件系统安全化：\n * 路径分隔符、Windows 保留字符与控制字符替换为 `_`，避免宿主传入\n * `projects/p_1` 这类含层级的值时写到目录之外。\n */\n\nimport type { SerializedProject } from './schema'\nimport type { StoragePort } from './storage'\n\nexport interface FileIoAdapter {\n  /** 文件不存在时返回 null（不要抛错） */\n  readText(path: string): Promise<string | null>\n  writeText(path: string, content: string): Promise<void>\n  /** 文件不存在时静默成功 */\n  remove(path: string): Promise<void>\n  /** 目录不存在时返回空数组 */\n  list(dir: string): Promise<string[]>\n}\n\nconst JSON_EXT = '.json'\n\n/** namespace → 安全文件名（不含扩展名） */\nexport function toStorageFileName(namespace: string): string {\n  const safe = namespace\n    // eslint-disable-next-line no-control-regex -- 需要把控制字符也替换掉\n    .replace(/[\\\\/:*?\"<>|\\u0000-\\u001f]/g, '_')\n    .replace(/^\\.+/, '_')\n    .trim()\n  return (safe.length > 0 ? safe : 'default') + JSON_EXT\n}\n\nfunction joinPath(dir: string, name: string): string {\n  const separator = dir.includes('\\\\') && !dir.includes('/') ? '\\\\' : '/'\n  return dir.endsWith('/') || dir.endsWith('\\\\') ? `${dir}${name}` : `${dir}${separator}${name}`\n}\n\nexport function createFileStorage(dir: string, io: FileIoAdapter): StoragePort {\n  const pathFor = (namespace: string) => joinPath(dir, toStorageFileName(namespace))\n\n  return {\n    async load(namespace) {\n      const text = await io.readText(pathFor(namespace))\n      if (text == null || text.trim().length === 0) return null\n      return JSON.parse(text) as SerializedProject\n    },\n\n    async save(namespace, data) {\n      const path = pathFor(namespace)\n      try {\n        await io.writeText(path, JSON.stringify(data, null, 2))\n        return { ok: true, path }\n      } catch (err) {\n        return { ok: false, path, error: err instanceof Error ? err.message : String(err) }\n      }\n    },\n\n    async remove(namespace) {\n      await io.remove(pathFor(namespace))\n    },\n\n    async list() {\n      const names = await io.list(dir)\n      return names\n        .filter((name) => name.toLowerCase().endsWith(JSON_EXT))\n        .map((name) => name.slice(0, -JSON_EXT.length))\n        .sort()\n    },\n  }\n}\n","/**\n * OPFS 可用性探测与临时文件辅助。\n *\n * WebAV 内部（opfs-tools）在模块加载期就会访问 `navigator.storage.getDirectory()`，\n * 因此这里只使用原生 File System Access API，不 import opfs-tools，避免重复副作用。\n *\n * 使用策略：小文件直接 `file.stream()` 喂给 MP4Clip；只有需要随机读取的大文件\n * 才落盘到 OPFS 临时目录（WebAV 自身也会在内部做同样的事，这里只提供探测与清理）。\n */\n\nconst TEMP_DIR = 'cut-test-tmp'\n\nexport interface OpfsProbeResult {\n  available: boolean\n  reason?: string\n}\n\nlet probeCache: OpfsProbeResult | null = null\n\nexport async function probeOpfs(force = false): Promise<OpfsProbeResult> {\n  if (probeCache && !force) return probeCache\n  try {\n    if (typeof navigator === 'undefined' || navigator.storage?.getDirectory == null) {\n      probeCache = { available: false, reason: '浏览器未实现 File System Access API。' }\n      return probeCache\n    }\n    await navigator.storage.getDirectory()\n    probeCache = { available: true }\n  } catch (err) {\n    probeCache = {\n      available: false,\n      reason: err instanceof Error ? err.message : String(err),\n    }\n  }\n  return probeCache\n}\n\nasync function getTempDir(): Promise<FileSystemDirectoryHandle> {\n  const root = await navigator.storage.getDirectory()\n  return root.getDirectoryHandle(TEMP_DIR, { create: true })\n}\n\n/** 写入临时文件，返回文件名；调用方负责后续清理 */\nexport async function writeTempFile(name: string, data: Blob | ArrayBuffer): Promise<string> {\n  const dir = await getTempDir()\n  const handle = await dir.getFileHandle(name, { create: true })\n  const writable = await handle.createWritable()\n  await writable.write(data)\n  await writable.close()\n  return name\n}\n\n/** 读取临时文件 */\nexport async function readTempFile(name: string): Promise<File> {\n  const dir = await getTempDir()\n  const handle = await dir.getFileHandle(name)\n  return handle.getFile()\n}\n\nexport async function removeTempFile(name: string): Promise<void> {\n  try {\n    const dir = await getTempDir()\n    await dir.removeEntry(name)\n  } catch {\n    // 文件不存在时静默忽略：清理流程不应打断主流程\n  }\n}\n\n/** 清空整个临时目录 */\nexport async function clearTempFiles(): Promise<void> {\n  try {\n    const root = await navigator.storage.getDirectory()\n    await root.removeEntry(TEMP_DIR, { recursive: true })\n  } catch {\n    // 目录不存在时忽略\n  }\n}\n\n/** 估算可用配额（用于导出前的提示） */\nexport async function estimateQuota(): Promise<{ usage: number; quota: number } | null> {\n  try {\n    const estimate = await navigator.storage.estimate()\n    return { usage: estimate.usage ?? 0, quota: estimate.quota ?? 0 }\n  } catch {\n    return null\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -24,10 +24,15 @@ export * from './timeline/canvas-size';
 export * from './project/schema';
 export type { StoragePort, SaveResult } from './project/storage';
 export { createIndexedDbStorage, createMemoryStorage } from './project/indexeddb-storage';
+export { createFileStorage, toStorageFileName } from './project/file-storage';
+export type { FileIoAdapter } from './project/file-storage';
 export type { HostBridge, HostPlatform, FilesPort, SaveFileResult, PickFilesOptions, PickFilesResult, } from './ports/host-bridge';
 export { createWebBridge, downloadBlob } from './ports/web-bridge';
+export * from './export/types';
+export { ExportCancelledError, isExportCancelled } from './errors';
 export * from './capability';
 export * from './editor/index';
+export type * from './editor/handle-types';
 export * from './media/srt';
 export * from './media/waveform';
 export { UnsupportedFileError, detectFileType, fileToStream, bufferToStream, readTextFile, } from './media/file-reader';

package/dist/index.js

@@ -1,48 +1,51 @@
-import { $ as createId, A as createEmptyProject, B as US_PER_SECOND, C as rangesOverlap, D as trimClipData, E as splitClipData, F as getTrack, G as formatDuration, H as asUs, I as getTrackClips, J as pxToUs, K as formatTimecode, L as getTrackEnd, M as getClipEnd, N as getProjectDuration, O as clampStillDuration, P as getSourceSpanUs, Q as usToSec, R as isTrackAudible, S as moveClipData, T as reorderTracksData, U as buildTicks, V as asPx, W as clamp, X as usToMs, Y as secToUs, Z as usToPx, _ as sameTransform, a as remapClipsForSize, b as duplicateClipsData, c as RESIZE_HANDLES, d as handleCursor, et as DEFAULT_CLIP_VOLUME, f as handleLocalOffset, g as resizeTransform, h as rectCenter, i as ratioLabel, it as PROJECT_SCHEMA_VERSION, j as createTrack, k as createClip, l as degToRad, m as pointInTransform, n as isCustomSize, nt as HISTORY_MERGE_WINDOW_MS, o as remapTransform, p as normalizeAngle, q as msToUs, r as normalizeSize, rt as MAX_HISTORY_STEPS, s as MIN_TRANSFORM_SIZE, t as ASPECT_PRESETS, tt as DEFAULT_STILL_DURATION_US, u as fromLocalPoint, v as toLocalPoint, w as removeClipsData, x as findOverlaps, y as compactTrackData, z as US_PER_MS } from "./chunks/canvas-size-iWL8zZPl.js";
-import { i as nearestSorted, n as computeSnap, r as computeSnapWithHysteresis, t as EMPTY_SNAP } from "./chunks/snap-Dc022smD.js";
-import { C as downloadBlob, D as deserializeProject, E as ProjectSchemaError, O as serializeProject, S as createWebBridge, T as createMemoryStorage, _ 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, r as normalizeWaveform, s as selectClipById, t as buildWaveformPath, u as selectProject, v as detectEnvironment, w as createIndexedDbStorage, x as summarizeCapabilities, y as detectOpfs } from "./chunks/waveform-CWU8Fa-n.js";
+import { _ as DEFAULT_STILL_DURATION_US, a as buildTicks, b as PROJECT_SCHEMA_VERSION, c as formatTimecode, d as secToUs, f as usToMs, g as DEFAULT_CLIP_VOLUME, h as createId, i as asUs, l as msToUs, m as usToSec, n as US_PER_SECOND, o as clamp, p as usToPx, r as asPx, s as formatDuration, t as US_PER_MS, u as pxToUs, v as HISTORY_MERGE_WINDOW_MS, y as MAX_HISTORY_STEPS } from "./chunks/time-C_gvkVl1.js";
+import { A as createEmptyProject, C as rangesOverlap, D as trimClipData, E as splitClipData, F as getTrack, I as getTrackClips, L as getTrackEnd, M as getClipEnd, N as getProjectDuration, O as clampStillDuration, P as getSourceSpanUs, R as isTrackAudible, S as moveClipData, T as reorderTracksData, _ as sameTransform, a as remapClipsForSize, b as duplicateClipsData, c as RESIZE_HANDLES, d as handleCursor, f as handleLocalOffset, g as resizeTransform, h as rectCenter, i as ratioLabel, j as createTrack, k as createClip, l as degToRad, m as pointInTransform, n as isCustomSize, o as remapTransform, p as normalizeAngle, r as normalizeSize, s as MIN_TRANSFORM_SIZE, t as ASPECT_PRESETS, u as fromLocalPoint, v as toLocalPoint, w as removeClipsData, x as findOverlaps, y as compactTrackData } from "./chunks/canvas-size-CM2oKApi.js";
+import { i as nearestSorted, n as computeSnap, r as computeSnapWithHysteresis, t as EMPTY_SNAP } from "./chunks/snap-CBV9G4xq.js";
+import { A as createMemoryStorage, C as isExportCancelled, D as createWebBridge, E as resolveExportSettings, M as deserializeProject, N as serializeProject, O as downloadBlob, 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, j as ProjectSchemaError, k as createIndexedDbStorage, l as selectPlayheadUs, m as createHistoryStore, n as computeWaveform, o as selectAssets, p as selectTracks, r as normalizeWaveform, s as selectClipById, t as buildWaveformPath, u as selectProject, v as detectEnvironment, w as DEFAULT_EXPORT_SETTINGS, x as summarizeCapabilities, y as detectOpfs } from "./chunks/waveform-DJkRtMct.js";
+import { n as parseSrt, r as parseSrtDurationUs, t as isValidSrt } from "./chunks/srt-D539yJ-n.js";
 import { a as readTextFile, i as fileToStream, n as bufferToStream, r as detectFileType, t as UnsupportedFileError } from "./chunks/file-reader-OjeI7HTg.js";
-// src/media/srt.ts
-var TIME_RE = /(\d{2}):(\d{2}):(\d{2})[,.](\d{3})/g;
-function toMs(h, m, s, ms) {
-	return Number(h) * 36e5 + Number(m) * 6e4 + Number(s) * 1e3 + Number(ms);
+// src/project/file-storage.ts
+var JSON_EXT = ".json";
+/** namespace → 安全文件名（不含扩展名） */
+function toStorageFileName(namespace) {
+	const safe = namespace.replace(/[\\/:*?"<>|\u0000-\u001f]/g, "_").replace(/^\.+/, "_").trim();
+	return (safe.length > 0 ? safe : "default") + JSON_EXT;
 }
-/** 解析 SRT 文本为 cue 列表；格式错误时返回空数组（调用方给出友好提示） */
-function parseSrt(content) {
-	const blocks = content.replace(/\r\n/g, "\n").split(/\n{2,}/);
-	const cues = [];
-	for (const block of blocks) {
-		const lines = block.split("\n").map((l) => l.trim()).filter(Boolean);
-		if (lines.length === 0) continue;
-		const timeLineIndex = lines.findIndex((l) => l.includes("-->"));
-		if (timeLineIndex < 0) continue;
-		const timeLine = lines[timeLineIndex] ?? "";
-		TIME_RE.lastIndex = 0;
-		const matches = Array.from(timeLine.matchAll(TIME_RE));
-		if (matches.length < 2) continue;
-		const [startMatch, endMatch] = matches;
-		if (startMatch == null || endMatch == null) continue;
-		const startMs = toMs(startMatch[1] ?? "0", startMatch[2] ?? "0", startMatch[3] ?? "0", startMatch[4] ?? "0");
-		const endMs = toMs(endMatch[1] ?? "0", endMatch[2] ?? "0", endMatch[3] ?? "0", endMatch[4] ?? "0");
-		if (endMs <= startMs) continue;
-		cues.push({
-			index: cues.length + 1,
-			startMs,
-			endMs,
-			text: lines.slice(timeLineIndex + 1).join("\n")
-		});
-	}
-	return cues;
-}
-/** 字幕总时长（微秒）。用于给字幕素材一个有限的 deration */
-function parseSrtDurationUs(content) {
-	const cues = parseSrt(content);
-	const last = cues[cues.length - 1];
-	return last == null ? 0 : Math.round(last.endMs * 1e3);
+function joinPath(dir, name) {
+	const separator = dir.includes("\\") && !dir.includes("/") ? "\\" : "/";
+	return dir.endsWith("/") || dir.endsWith("\\") ? `${dir}${name}` : `${dir}${separator}${name}`;
 }
-/** 简单校验：至少一条 cue */
-function isValidSrt(content) {
-	return parseSrt(content).length > 0;
+function createFileStorage(dir, io) {
+	const pathFor = (namespace) => joinPath(dir, toStorageFileName(namespace));
+	return {
+		async load(namespace) {
+			const text = await io.readText(pathFor(namespace));
+			if (text == null || text.trim().length === 0) return null;
+			return JSON.parse(text);
+		},
+		async save(namespace, data) {
+			const path = pathFor(namespace);
+			try {
+				await io.writeText(path, JSON.stringify(data, null, 2));
+				return {
+					ok: true,
+					path
+				};
+			} catch (err) {
+				return {
+					ok: false,
+					path,
+					error: err instanceof Error ? err.message : String(err)
+				};
+			}
+		},
+		async remove(namespace) {
+			await io.remove(pathFor(namespace));
+		},
+		async list() {
+			return (await io.list(dir)).filter((name) => name.toLowerCase().endsWith(JSON_EXT)).map((name) => name.slice(0, -5)).sort();
+		}
+	};
 }
 // src/media/opfs.ts
 /**
@@ -113,6 +116,6 @@ async function estimateQuota() {
 		return null;
 	}
 }
-export { ASPECT_PRESETS, DEFAULT_CLIP_VOLUME, DEFAULT_STILL_DURATION_US, EMPTY_SNAP, ENGINE_DEPENDENCIES_INSTALL_COMMAND, HISTORY_MERGE_WINDOW_MS, MAX_HISTORY_STEPS, MIN_TRANSFORM_SIZE, PROJECT_SCHEMA_VERSION, ProjectSchemaError, RESIZE_HANDLES, US_PER_MS, US_PER_SECOND, UnsupportedFileError, asPx, asUs, bufferToStream, buildTicks, buildWaveformPath, clamp, clampStillDuration, clearTempFiles, compactTrackData, computeSnap, computeSnapWithHysteresis, computeWaveform, createClip, createEditorStore, createEmptyProject, createEventBus, createHistoryStore, createId, createIndexedDbStorage, createMemoryStorage, createTrack, createWebBridge, degToRad, deserializeProject, detectDependencies, detectEnvironment, detectFileType, detectOpfs, downloadBlob, duplicateClipsData, estimateQuota, fileToStream, findOverlaps, formatDuration, formatTimecode, fromLocalPoint, getClipEnd, getProjectDuration, getSourceSpanUs, getTrack, getTrackClips, getTrackEnd, handleCursor, handleLocalOffset, isCustomSize, isEnvironmentUsable, isTrackAudible, isValidSrt, moveClipData, msToUs, nearestSorted, normalizeAngle, normalizeSize, normalizeWaveform, parseSrt, parseSrtDurationUs, pointInTransform, probeOpfs, pxToUs, rangesOverlap, ratioLabel, readTempFile, readTextFile, rectCenter, remapClipsForSize, remapTransform, removeClipsData, removeTempFile, reorderTracksData, resizeTransform, sameTransform, secToUs, selectAssetById, selectAssets, selectClipById, selectClips, selectPlayheadUs, selectProject, selectProjectDuration, selectSelectedClipIds, selectTracks, serializeProject, splitClipData, summarizeCapabilities, toLocalPoint, trimClipData, usToMs, usToPx, usToSec, writeTempFile };
+export { ASPECT_PRESETS, DEFAULT_CLIP_VOLUME, DEFAULT_EXPORT_SETTINGS, DEFAULT_STILL_DURATION_US, EMPTY_SNAP, ENGINE_DEPENDENCIES_INSTALL_COMMAND, ExportCancelledError, HISTORY_MERGE_WINDOW_MS, MAX_HISTORY_STEPS, MIN_TRANSFORM_SIZE, PROJECT_SCHEMA_VERSION, ProjectSchemaError, RESIZE_HANDLES, US_PER_MS, US_PER_SECOND, UnsupportedFileError, asPx, asUs, bufferToStream, buildTicks, buildWaveformPath, clamp, clampStillDuration, clearTempFiles, compactTrackData, computeSnap, computeSnapWithHysteresis, computeWaveform, createClip, createEditorStore, createEmptyProject, createEventBus, createExportFilename, createFileStorage, createHistoryStore, createId, createIndexedDbStorage, createMemoryStorage, createTrack, createWebBridge, degToRad, deserializeProject, detectDependencies, detectEnvironment, detectFileType, detectOpfs, downloadBlob, duplicateClipsData, estimateQuota, fileToStream, findOverlaps, formatDuration, formatTimecode, fromLocalPoint, getClipEnd, getProjectDuration, getSourceSpanUs, getTrack, getTrackClips, getTrackEnd, handleCursor, handleLocalOffset, isCustomSize, isEnvironmentUsable, isExportCancelled, isTrackAudible, isValidSrt, moveClipData, msToUs, nearestSorted, normalizeAngle, normalizeSize, normalizeWaveform, parseSrt, parseSrtDurationUs, pointInTransform, probeOpfs, pxToUs, rangesOverlap, ratioLabel, readTempFile, readTextFile, rectCenter, remapClipsForSize, remapTransform, removeClipsData, removeTempFile, reorderTracksData, resizeTransform, resolveExportSettings, sameTransform, secToUs, selectAssetById, selectAssets, selectClipById, selectClips, selectPlayheadUs, selectProject, selectProjectDuration, selectSelectedClipIds, selectTracks, serializeProject, splitClipData, summarizeCapabilities, toLocalPoint, toStorageFileName, trimClipData, usToMs, usToPx, usToSec, writeTempFile };
 
 //# sourceMappingURL=index.js.map