@cut-workbench/core 0.3.1 → 0.4.1

package/dist/chunks/time-CYEd91qN.cjs

@@ -0,0 +1,196 @@
+// src/timeline/time.ts
+var US_PER_SECOND = 1e6;
+var US_PER_MS = 1e3;
+/** 秒 → 微秒 */
+function secToUs(sec) {
+	return Math.round(sec * US_PER_SECOND);
+}
+/** 微秒 → 秒 */
+function usToSec(us) {
+	return us / US_PER_SECOND;
+}
+/** 毫秒 → 微秒 */
+function msToUs(ms) {
+	return Math.round(ms * US_PER_MS);
+}
+/** 微秒 → 毫秒 */
+function usToMs(us) {
+	return Math.round(us / US_PER_MS);
+}
+/** 数字 → 微秒（用于从 DOM/WebAV 回调拿到的裸数字） */
+function asUs(n) {
+	return Math.round(n);
+}
+/** 数字 → 像素 */
+function asPx(n) {
+	return n;
+}
+/**
+* 微秒 → 像素。
+* @param us 时间（微秒）
+* @param pxPerSecond 每秒对应多少像素
+*/
+function usToPx(us, pxPerSecond) {
+	return us / US_PER_SECOND * pxPerSecond;
+}
+/**
+* 像素 → 微秒。
+* @param px 像素
+* @param pxPerSecond 每秒对应多少像素
+*/
+function pxToUs(px, pxPerSecond) {
+	return Math.round(px / pxPerSecond * US_PER_SECOND);
+}
+/** 微秒 → `HH:MM:SS.mmm` */
+function formatTimecode(us, showMs = true) {
+	const totalMs = Math.floor(Math.max(0, us) / 1e3);
+	const ms = totalMs % 1e3;
+	const totalSec = Math.floor(totalMs / 1e3);
+	const sec = totalSec % 60;
+	const min = Math.floor(totalSec / 60) % 60;
+	const hour = Math.floor(totalSec / 3600);
+	const pad = (n, len = 2) => String(n).padStart(len, "0");
+	const base = `${pad(hour)}:${pad(min)}:${pad(sec)}`;
+	return showMs ? `${base}.${pad(ms, 3)}` : base;
+}
+/** 微秒 → `MM:SS` 或 `HH:MM:SS`，列表展示用 */
+function formatDuration(us) {
+	if (!Number.isFinite(us)) return "∞";
+	const totalSec = Math.max(0, Math.round(us / US_PER_SECOND));
+	const sec = totalSec % 60;
+	const min = Math.floor(totalSec / 60) % 60;
+	const hour = Math.floor(totalSec / 3600);
+	const pad = (n) => String(n).padStart(2, "0");
+	return hour > 0 ? `${hour}:${pad(min)}:${pad(sec)}` : `${pad(min)}:${pad(sec)}`;
+}
+var TICK_STEPS_US = [
+	1e5,
+	2e5,
+	5e5,
+	1e6,
+	2e6,
+	5e6,
+	1e7,
+	15e6,
+	3e7,
+	6e7,
+	12e7,
+	3e8,
+	6e8
+];
+/**
+* 根据缩放级别生成刻度尺。
+*
+* @param pxPerSecond 每秒像素
+* @param viewportWidthPx 可视宽度（像素）
+* @param scrollLeftPx 横向滚动偏移（像素）
+* @returns 主刻度（带文字）与次刻度
+*/
+function buildTicks(pxPerSecond, viewportWidthPx, scrollLeftPx = 0) {
+	const startUs = pxToUs(scrollLeftPx, pxPerSecond);
+	const endUs = pxToUs(scrollLeftPx + viewportWidthPx, pxPerSecond);
+	const minLabelSpacingPx = 72;
+	const step = TICK_STEPS_US.find((s) => usToPx(s, pxPerSecond) >= minLabelSpacingPx) ?? TICK_STEPS_US[TICK_STEPS_US.length - 1];
+	const minorStep = step / 5;
+	const first = Math.floor(startUs / step) * step;
+	const ticks = [];
+	for (let us = first; us <= endUs + step; us += minorStep) {
+		if (us < 0) continue;
+		ticks.push({
+			us,
+			px: usToPx(us, pxPerSecond),
+			major: us % step === 0
+		});
+	}
+	return ticks;
+}
+/** 保证值落在 [min, max] */
+function clamp(value, min, max) {
+	return Math.min(max, Math.max(min, value));
+}
+Object.defineProperty(exports, "US_PER_MS", {
+	enumerable: true,
+	get: function() {
+		return US_PER_MS;
+	}
+});
+Object.defineProperty(exports, "US_PER_SECOND", {
+	enumerable: true,
+	get: function() {
+		return US_PER_SECOND;
+	}
+});
+Object.defineProperty(exports, "asPx", {
+	enumerable: true,
+	get: function() {
+		return asPx;
+	}
+});
+Object.defineProperty(exports, "asUs", {
+	enumerable: true,
+	get: function() {
+		return asUs;
+	}
+});
+Object.defineProperty(exports, "buildTicks", {
+	enumerable: true,
+	get: function() {
+		return buildTicks;
+	}
+});
+Object.defineProperty(exports, "clamp", {
+	enumerable: true,
+	get: function() {
+		return clamp;
+	}
+});
+Object.defineProperty(exports, "formatDuration", {
+	enumerable: true,
+	get: function() {
+		return formatDuration;
+	}
+});
+Object.defineProperty(exports, "formatTimecode", {
+	enumerable: true,
+	get: function() {
+		return formatTimecode;
+	}
+});
+Object.defineProperty(exports, "msToUs", {
+	enumerable: true,
+	get: function() {
+		return msToUs;
+	}
+});
+Object.defineProperty(exports, "pxToUs", {
+	enumerable: true,
+	get: function() {
+		return pxToUs;
+	}
+});
+Object.defineProperty(exports, "secToUs", {
+	enumerable: true,
+	get: function() {
+		return secToUs;
+	}
+});
+Object.defineProperty(exports, "usToMs", {
+	enumerable: true,
+	get: function() {
+		return usToMs;
+	}
+});
+Object.defineProperty(exports, "usToPx", {
+	enumerable: true,
+	get: function() {
+		return usToPx;
+	}
+});
+Object.defineProperty(exports, "usToSec", {
+	enumerable: true,
+	get: function() {
+		return usToSec;
+	}
+});
+
+//# sourceMappingURL=time-CYEd91qN.cjs.map

package/dist/chunks/time-CYEd91qN.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-CYEd91qN.cjs","names":[],"sources":["../../src/timeline/time.ts"],"sourcesContent":["/**\n * 时间与像素的单位换算。\n *\n * 内部统一使用微秒（µs）。为避免中途混用毫秒/秒，这里定义 branded type：\n * - `Us` 微秒\n * - `Ms` 毫秒\n * - `Px` 像素\n *\n * 只在函数边界处做 cast，业务代码不允许出现裸 number 参与时间计算。\n */\n\ndeclare const usBrand: unique symbol\ndeclare const msBrand: unique symbol\ndeclare const pxBrand: unique symbol\n\nexport type Us = number & { readonly [usBrand]: true }\nexport type Ms = number & { readonly [msBrand]: true }\nexport type Px = number & { readonly [pxBrand]: true }\n\nexport const US_PER_SECOND = 1_000_000\nexport const US_PER_MS = 1_000\n\n/** 秒 → 微秒 */\nexport function secToUs(sec: number): Us {\n  return Math.round(sec * US_PER_SECOND) as Us\n}\n\n/** 微秒 → 秒 */\nexport function usToSec(us: number): number {\n  return us / US_PER_SECOND\n}\n\n/** 毫秒 → 微秒 */\nexport function msToUs(ms: number): Us {\n  return Math.round(ms * US_PER_MS) as Us\n}\n\n/** 微秒 → 毫秒 */\nexport function usToMs(us: number): Ms {\n  return Math.round(us / US_PER_MS) as Ms\n}\n\n/** 数字 → 微秒（用于从 DOM/WebAV 回调拿到的裸数字） */\nexport function asUs(n: number): Us {\n  return Math.round(n) as Us\n}\n\n/** 数字 → 像素 */\nexport function asPx(n: number): Px {\n  return n as Px\n}\n\n/**\n * 微秒 → 像素。\n * @param us 时间（微秒）\n * @param pxPerSecond 每秒对应多少像素\n */\nexport function usToPx(us: number, pxPerSecond: number): Px {\n  return ((us / US_PER_SECOND) * pxPerSecond) as Px\n}\n\n/**\n * 像素 → 微秒。\n * @param px 像素\n * @param pxPerSecond 每秒对应多少像素\n */\nexport function pxToUs(px: number, pxPerSecond: number): Us {\n  return Math.round((px / pxPerSecond) * US_PER_SECOND) as Us\n}\n\n/** 微秒 → `HH:MM:SS.mmm` */\nexport function formatTimecode(us: number, showMs = true): string {\n  const safe = Math.max(0, us)\n  const totalMs = Math.floor(safe / 1000)\n  const ms = totalMs % 1000\n  const totalSec = Math.floor(totalMs / 1000)\n  const sec = totalSec % 60\n  const min = Math.floor(totalSec / 60) % 60\n  const hour = Math.floor(totalSec / 3600)\n  const pad = (n: number, len = 2) => String(n).padStart(len, '0')\n  const base = `${pad(hour)}:${pad(min)}:${pad(sec)}`\n  return showMs ? `${base}.${pad(ms, 3)}` : base\n}\n\n/** 微秒 → `MM:SS` 或 `HH:MM:SS`，列表展示用 */\nexport function formatDuration(us: number): string {\n  if (!Number.isFinite(us)) return '∞'\n  const totalSec = Math.max(0, Math.round(us / US_PER_SECOND))\n  const sec = totalSec % 60\n  const min = Math.floor(totalSec / 60) % 60\n  const hour = Math.floor(totalSec / 3600)\n  const pad = (n: number) => String(n).padStart(2, '0')\n  return hour > 0 ? `${hour}:${pad(min)}:${pad(sec)}` : `${pad(min)}:${pad(sec)}`\n}\n\nexport interface RulerTick {\n  us: Us\n  px: Px\n  major: boolean\n}\n\nconst TICK_STEPS_US = [\n  100_000, 200_000, 500_000, 1_000_000, 2_000_000, 5_000_000, 10_000_000, 15_000_000,\n  30_000_000, 60_000_000, 120_000_000, 300_000_000, 600_000_000,\n]\n\n/**\n * 根据缩放级别生成刻度尺。\n *\n * @param pxPerSecond 每秒像素\n * @param viewportWidthPx 可视宽度（像素）\n * @param scrollLeftPx 横向滚动偏移（像素）\n * @returns 主刻度（带文字）与次刻度\n */\nexport function buildTicks(\n  pxPerSecond: number,\n  viewportWidthPx: number,\n  scrollLeftPx = 0,\n): RulerTick[] {\n  const startUs = pxToUs(scrollLeftPx, pxPerSecond)\n  const endUs = pxToUs(scrollLeftPx + viewportWidthPx, pxPerSecond)\n  const minLabelSpacingPx = 72\n  const step =\n    TICK_STEPS_US.find((s) => usToPx(s, pxPerSecond) >= minLabelSpacingPx) ??\n    TICK_STEPS_US[TICK_STEPS_US.length - 1]\n  const minorStep = step / 5\n  const first = Math.floor(startUs / step) * step\n  const ticks: RulerTick[] = []\n  for (let us = first; us <= endUs + step; us += minorStep) {\n    if (us < 0) continue\n    ticks.push({\n      us: us as Us,\n      px: usToPx(us, pxPerSecond),\n      major: us % step === 0,\n    })\n  }\n  return ticks\n}\n\n/** 保证值落在 [min, max] */\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value))\n}\n"],"mappings":";AAmBA,IAAa,gBAAgB;AAC7B,IAAa,YAAY;;AAGzB,SAAgB,QAAQ,KAAiB;CACvC,OAAO,KAAK,MAAM,MAAM,aAAa;AACvC;;AAGA,SAAgB,QAAQ,IAAoB;CAC1C,OAAO,KAAK;AACd;;AAGA,SAAgB,OAAO,IAAgB;CACrC,OAAO,KAAK,MAAM,KAAK,SAAS;AAClC;;AAGA,SAAgB,OAAO,IAAgB;CACrC,OAAO,KAAK,MAAM,KAAK,SAAS;AAClC;;AAGA,SAAgB,KAAK,GAAe;CAClC,OAAO,KAAK,MAAM,CAAC;AACrB;;AAGA,SAAgB,KAAK,GAAe;CAClC,OAAO;AACT;;;;;;AAOA,SAAgB,OAAO,IAAY,aAAyB;CAC1D,OAAS,KAAK,gBAAiB;AACjC;;;;;;AAOA,SAAgB,OAAO,IAAY,aAAyB;CAC1D,OAAO,KAAK,MAAO,KAAK,cAAe,aAAa;AACtD;;AAGA,SAAgB,eAAe,IAAY,SAAS,MAAc;CAEhE,MAAM,UAAU,KAAK,MADR,KAAK,IAAI,GAAG,EACE,IAAO,GAAI;CACtC,MAAM,KAAK,UAAU;CACrB,MAAM,WAAW,KAAK,MAAM,UAAU,GAAI;CAC1C,MAAM,MAAM,WAAW;CACvB,MAAM,MAAM,KAAK,MAAM,WAAW,EAAE,IAAI;CACxC,MAAM,OAAO,KAAK,MAAM,WAAW,IAAI;CACvC,MAAM,OAAO,GAAW,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG;CAC/D,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG;CAChD,OAAO,SAAS,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM;AAC5C;;AAGA,SAAgB,eAAe,IAAoB;CACjD,IAAI,CAAC,OAAO,SAAS,EAAE,GAAG,OAAO;CACjC,MAAM,WAAW,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,aAAa,CAAC;CAC3D,MAAM,MAAM,WAAW;CACvB,MAAM,MAAM,KAAK,MAAM,WAAW,EAAE,IAAI;CACxC,MAAM,OAAO,KAAK,MAAM,WAAW,IAAI;CACvC,MAAM,OAAO,MAAc,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;CACpD,OAAO,OAAO,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG;AAC9E;AAQA,IAAM,gBAAgB;CACpB;CAAS;CAAS;CAAS;CAAW;CAAW;CAAW;CAAY;CACxE;CAAY;CAAY;CAAa;CAAa;AACpD;;;;;;;;;AAUA,SAAgB,WACd,aACA,iBACA,eAAe,GACF;CACb,MAAM,UAAU,OAAO,cAAc,WAAW;CAChD,MAAM,QAAQ,OAAO,eAAe,iBAAiB,WAAW;CAChE,MAAM,oBAAoB;CAC1B,MAAM,OACJ,cAAc,MAAM,MAAM,OAAO,GAAG,WAAW,KAAK,iBAAiB,KACrE,cAAc,cAAc,SAAS;CACvC,MAAM,YAAY,OAAO;CACzB,MAAM,QAAQ,KAAK,MAAM,UAAU,IAAI,IAAI;CAC3C,MAAM,QAAqB,CAAC;CAC5B,KAAK,IAAI,KAAK,OAAO,MAAM,QAAQ,MAAM,MAAM,WAAW;EACxD,IAAI,KAAK,GAAG;EACZ,MAAM,KAAK;GACL;GACJ,IAAI,OAAO,IAAI,WAAW;GAC1B,OAAO,KAAK,SAAS;EACvB,CAAC;CACH;CACA,OAAO;AACT;;AAGA,SAAgB,MAAM,OAAe,KAAa,KAAqB;CACrE,OAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;AAC3C"}

package/dist/chunks/time-ChF1GwCy.js

@@ -0,0 +1,113 @@
+// src/timeline/time.ts
+var US_PER_SECOND = 1e6;
+var US_PER_MS = 1e3;
+/** 秒 → 微秒 */
+function secToUs(sec) {
+	return Math.round(sec * US_PER_SECOND);
+}
+/** 微秒 → 秒 */
+function usToSec(us) {
+	return us / US_PER_SECOND;
+}
+/** 毫秒 → 微秒 */
+function msToUs(ms) {
+	return Math.round(ms * US_PER_MS);
+}
+/** 微秒 → 毫秒 */
+function usToMs(us) {
+	return Math.round(us / US_PER_MS);
+}
+/** 数字 → 微秒（用于从 DOM/WebAV 回调拿到的裸数字） */
+function asUs(n) {
+	return Math.round(n);
+}
+/** 数字 → 像素 */
+function asPx(n) {
+	return n;
+}
+/**
+* 微秒 → 像素。
+* @param us 时间（微秒）
+* @param pxPerSecond 每秒对应多少像素
+*/
+function usToPx(us, pxPerSecond) {
+	return us / US_PER_SECOND * pxPerSecond;
+}
+/**
+* 像素 → 微秒。
+* @param px 像素
+* @param pxPerSecond 每秒对应多少像素
+*/
+function pxToUs(px, pxPerSecond) {
+	return Math.round(px / pxPerSecond * US_PER_SECOND);
+}
+/** 微秒 → `HH:MM:SS.mmm` */
+function formatTimecode(us, showMs = true) {
+	const totalMs = Math.floor(Math.max(0, us) / 1e3);
+	const ms = totalMs % 1e3;
+	const totalSec = Math.floor(totalMs / 1e3);
+	const sec = totalSec % 60;
+	const min = Math.floor(totalSec / 60) % 60;
+	const hour = Math.floor(totalSec / 3600);
+	const pad = (n, len = 2) => String(n).padStart(len, "0");
+	const base = `${pad(hour)}:${pad(min)}:${pad(sec)}`;
+	return showMs ? `${base}.${pad(ms, 3)}` : base;
+}
+/** 微秒 → `MM:SS` 或 `HH:MM:SS`，列表展示用 */
+function formatDuration(us) {
+	if (!Number.isFinite(us)) return "∞";
+	const totalSec = Math.max(0, Math.round(us / US_PER_SECOND));
+	const sec = totalSec % 60;
+	const min = Math.floor(totalSec / 60) % 60;
+	const hour = Math.floor(totalSec / 3600);
+	const pad = (n) => String(n).padStart(2, "0");
+	return hour > 0 ? `${hour}:${pad(min)}:${pad(sec)}` : `${pad(min)}:${pad(sec)}`;
+}
+var TICK_STEPS_US = [
+	1e5,
+	2e5,
+	5e5,
+	1e6,
+	2e6,
+	5e6,
+	1e7,
+	15e6,
+	3e7,
+	6e7,
+	12e7,
+	3e8,
+	6e8
+];
+/**
+* 根据缩放级别生成刻度尺。
+*
+* @param pxPerSecond 每秒像素
+* @param viewportWidthPx 可视宽度（像素）
+* @param scrollLeftPx 横向滚动偏移（像素）
+* @returns 主刻度（带文字）与次刻度
+*/
+function buildTicks(pxPerSecond, viewportWidthPx, scrollLeftPx = 0) {
+	const startUs = pxToUs(scrollLeftPx, pxPerSecond);
+	const endUs = pxToUs(scrollLeftPx + viewportWidthPx, pxPerSecond);
+	const minLabelSpacingPx = 72;
+	const step = TICK_STEPS_US.find((s) => usToPx(s, pxPerSecond) >= minLabelSpacingPx) ?? TICK_STEPS_US[TICK_STEPS_US.length - 1];
+	const minorStep = step / 5;
+	const first = Math.floor(startUs / step) * step;
+	const ticks = [];
+	for (let us = first; us <= endUs + step; us += minorStep) {
+		if (us < 0) continue;
+		ticks.push({
+			us,
+			px: usToPx(us, pxPerSecond),
+			major: us % step === 0
+		});
+	}
+	return ticks;
+}
+/** 保证值落在 [min, max] */
+function clamp(value, min, max) {
+	return Math.min(max, Math.max(min, value));
+}
+export { buildTicks as a, formatTimecode as c, secToUs as d, usToMs as f, asUs as i, msToUs as l, usToSec as m, US_PER_SECOND as n, clamp as o, usToPx as p, asPx as r, formatDuration as s, US_PER_MS as t, pxToUs as u };
+
+//# sourceMappingURL=time-ChF1GwCy.js.map

package/dist/chunks/time-ChF1GwCy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-ChF1GwCy.js","names":[],"sources":["../../src/timeline/time.ts"],"sourcesContent":["/**\n * 时间与像素的单位换算。\n *\n * 内部统一使用微秒（µs）。为避免中途混用毫秒/秒，这里定义 branded type：\n * - `Us` 微秒\n * - `Ms` 毫秒\n * - `Px` 像素\n *\n * 只在函数边界处做 cast，业务代码不允许出现裸 number 参与时间计算。\n */\n\ndeclare const usBrand: unique symbol\ndeclare const msBrand: unique symbol\ndeclare const pxBrand: unique symbol\n\nexport type Us = number & { readonly [usBrand]: true }\nexport type Ms = number & { readonly [msBrand]: true }\nexport type Px = number & { readonly [pxBrand]: true }\n\nexport const US_PER_SECOND = 1_000_000\nexport const US_PER_MS = 1_000\n\n/** 秒 → 微秒 */\nexport function secToUs(sec: number): Us {\n  return Math.round(sec * US_PER_SECOND) as Us\n}\n\n/** 微秒 → 秒 */\nexport function usToSec(us: number): number {\n  return us / US_PER_SECOND\n}\n\n/** 毫秒 → 微秒 */\nexport function msToUs(ms: number): Us {\n  return Math.round(ms * US_PER_MS) as Us\n}\n\n/** 微秒 → 毫秒 */\nexport function usToMs(us: number): Ms {\n  return Math.round(us / US_PER_MS) as Ms\n}\n\n/** 数字 → 微秒（用于从 DOM/WebAV 回调拿到的裸数字） */\nexport function asUs(n: number): Us {\n  return Math.round(n) as Us\n}\n\n/** 数字 → 像素 */\nexport function asPx(n: number): Px {\n  return n as Px\n}\n\n/**\n * 微秒 → 像素。\n * @param us 时间（微秒）\n * @param pxPerSecond 每秒对应多少像素\n */\nexport function usToPx(us: number, pxPerSecond: number): Px {\n  return ((us / US_PER_SECOND) * pxPerSecond) as Px\n}\n\n/**\n * 像素 → 微秒。\n * @param px 像素\n * @param pxPerSecond 每秒对应多少像素\n */\nexport function pxToUs(px: number, pxPerSecond: number): Us {\n  return Math.round((px / pxPerSecond) * US_PER_SECOND) as Us\n}\n\n/** 微秒 → `HH:MM:SS.mmm` */\nexport function formatTimecode(us: number, showMs = true): string {\n  const safe = Math.max(0, us)\n  const totalMs = Math.floor(safe / 1000)\n  const ms = totalMs % 1000\n  const totalSec = Math.floor(totalMs / 1000)\n  const sec = totalSec % 60\n  const min = Math.floor(totalSec / 60) % 60\n  const hour = Math.floor(totalSec / 3600)\n  const pad = (n: number, len = 2) => String(n).padStart(len, '0')\n  const base = `${pad(hour)}:${pad(min)}:${pad(sec)}`\n  return showMs ? `${base}.${pad(ms, 3)}` : base\n}\n\n/** 微秒 → `MM:SS` 或 `HH:MM:SS`，列表展示用 */\nexport function formatDuration(us: number): string {\n  if (!Number.isFinite(us)) return '∞'\n  const totalSec = Math.max(0, Math.round(us / US_PER_SECOND))\n  const sec = totalSec % 60\n  const min = Math.floor(totalSec / 60) % 60\n  const hour = Math.floor(totalSec / 3600)\n  const pad = (n: number) => String(n).padStart(2, '0')\n  return hour > 0 ? `${hour}:${pad(min)}:${pad(sec)}` : `${pad(min)}:${pad(sec)}`\n}\n\nexport interface RulerTick {\n  us: Us\n  px: Px\n  major: boolean\n}\n\nconst TICK_STEPS_US = [\n  100_000, 200_000, 500_000, 1_000_000, 2_000_000, 5_000_000, 10_000_000, 15_000_000,\n  30_000_000, 60_000_000, 120_000_000, 300_000_000, 600_000_000,\n]\n\n/**\n * 根据缩放级别生成刻度尺。\n *\n * @param pxPerSecond 每秒像素\n * @param viewportWidthPx 可视宽度（像素）\n * @param scrollLeftPx 横向滚动偏移（像素）\n * @returns 主刻度（带文字）与次刻度\n */\nexport function buildTicks(\n  pxPerSecond: number,\n  viewportWidthPx: number,\n  scrollLeftPx = 0,\n): RulerTick[] {\n  const startUs = pxToUs(scrollLeftPx, pxPerSecond)\n  const endUs = pxToUs(scrollLeftPx + viewportWidthPx, pxPerSecond)\n  const minLabelSpacingPx = 72\n  const step =\n    TICK_STEPS_US.find((s) => usToPx(s, pxPerSecond) >= minLabelSpacingPx) ??\n    TICK_STEPS_US[TICK_STEPS_US.length - 1]\n  const minorStep = step / 5\n  const first = Math.floor(startUs / step) * step\n  const ticks: RulerTick[] = []\n  for (let us = first; us <= endUs + step; us += minorStep) {\n    if (us < 0) continue\n    ticks.push({\n      us: us as Us,\n      px: usToPx(us, pxPerSecond),\n      major: us % step === 0,\n    })\n  }\n  return ticks\n}\n\n/** 保证值落在 [min, max] */\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value))\n}\n"],"mappings":";AAmBA,IAAa,gBAAgB;AAC7B,IAAa,YAAY;;AAGzB,SAAgB,QAAQ,KAAiB;CACvC,OAAO,KAAK,MAAM,MAAM,aAAa;AACvC;;AAGA,SAAgB,QAAQ,IAAoB;CAC1C,OAAO,KAAK;AACd;;AAGA,SAAgB,OAAO,IAAgB;CACrC,OAAO,KAAK,MAAM,KAAK,SAAS;AAClC;;AAGA,SAAgB,OAAO,IAAgB;CACrC,OAAO,KAAK,MAAM,KAAK,SAAS;AAClC;;AAGA,SAAgB,KAAK,GAAe;CAClC,OAAO,KAAK,MAAM,CAAC;AACrB;;AAGA,SAAgB,KAAK,GAAe;CAClC,OAAO;AACT;;;;;;AAOA,SAAgB,OAAO,IAAY,aAAyB;CAC1D,OAAS,KAAK,gBAAiB;AACjC;;;;;;AAOA,SAAgB,OAAO,IAAY,aAAyB;CAC1D,OAAO,KAAK,MAAO,KAAK,cAAe,aAAa;AACtD;;AAGA,SAAgB,eAAe,IAAY,SAAS,MAAc;CAEhE,MAAM,UAAU,KAAK,MADR,KAAK,IAAI,GAAG,EACE,IAAO,GAAI;CACtC,MAAM,KAAK,UAAU;CACrB,MAAM,WAAW,KAAK,MAAM,UAAU,GAAI;CAC1C,MAAM,MAAM,WAAW;CACvB,MAAM,MAAM,KAAK,MAAM,WAAW,EAAE,IAAI;CACxC,MAAM,OAAO,KAAK,MAAM,WAAW,IAAI;CACvC,MAAM,OAAO,GAAW,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG;CAC/D,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG;CAChD,OAAO,SAAS,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM;AAC5C;;AAGA,SAAgB,eAAe,IAAoB;CACjD,IAAI,CAAC,OAAO,SAAS,EAAE,GAAG,OAAO;CACjC,MAAM,WAAW,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,aAAa,CAAC;CAC3D,MAAM,MAAM,WAAW;CACvB,MAAM,MAAM,KAAK,MAAM,WAAW,EAAE,IAAI;CACxC,MAAM,OAAO,KAAK,MAAM,WAAW,IAAI;CACvC,MAAM,OAAO,MAAc,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;CACpD,OAAO,OAAO,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG;AAC9E;AAQA,IAAM,gBAAgB;CACpB;CAAS;CAAS;CAAS;CAAW;CAAW;CAAW;CAAY;CACxE;CAAY;CAAY;CAAa;CAAa;AACpD;;;;;;;;;AAUA,SAAgB,WACd,aACA,iBACA,eAAe,GACF;CACb,MAAM,UAAU,OAAO,cAAc,WAAW;CAChD,MAAM,QAAQ,OAAO,eAAe,iBAAiB,WAAW;CAChE,MAAM,oBAAoB;CAC1B,MAAM,OACJ,cAAc,MAAM,MAAM,OAAO,GAAG,WAAW,KAAK,iBAAiB,KACrE,cAAc,cAAc,SAAS;CACvC,MAAM,YAAY,OAAO;CACzB,MAAM,QAAQ,KAAK,MAAM,UAAU,IAAI,IAAI;CAC3C,MAAM,QAAqB,CAAC;CAC5B,KAAK,IAAI,KAAK,OAAO,MAAM,QAAQ,MAAM,MAAM,WAAW;EACxD,IAAI,KAAK,GAAG;EACZ,MAAM,KAAK;GACL;GACJ,IAAI,OAAO,IAAI,WAAW;GAC1B,OAAO,KAAK,SAAS;EACvB,CAAC;CACH;CACA,OAAO;AACT;;AAGA,SAAgB,MAAM,OAAe,KAAa,KAAqB;CACrE,OAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;AAC3C"}

package/dist/chunks/{waveform-Bhvv2t7-.cjs → waveform-BYwDdKpC.cjs}

@@ -1,19 +1,37 @@
-const require_canvas_size = require("./canvas-size-IzoEg2cq.cjs");
+const require_id = require("./id-DaCxD4-5.cjs");
+const require_time = require("./time-CYEd91qN.cjs");
+const require_canvas_size = require("./canvas-size-DIABzEW2.cjs");
 let zustand_vanilla = require("zustand/vanilla");
 let immer = require("immer");
 // src/project/schema.ts
+/**
+* 生成可落盘的工程快照。
+*
+* ⚠️ 必须是**深拷贝**：返回值会交给宿主（写入本地 JSON / 走 IPC）。
+* 若直接返回 store 里的对象引用，宿主对这些字段的任何改动都会反向污染编辑器状态，
+* 异步写盘期间发生编辑也会让「存下去的内容」与「保存时刻的状态」不一致。
+*/
 function serializeProject(project, assets) {
 	return {
 		schemaVersion: 1,
 		savedAt: Date.now(),
-		project,
-		assets: assets.map(stripRuntimeFields)
+		project: structuredClone(project),
+		assets: assets.map((asset) => stripRuntimeFields(asset))
 	};
 }
-/** 去掉不可持久化 / 无意义的运行时字段 */
+/**
+* 去掉不可持久化 / 无意义的运行时字段。
+*
+* - `thumbnailUrls`：会话内的 `blob:` URL，刷新后必然失效 —— 存下来只会让
+*   恢复后的卡片显示破图，不如不存（恢复时重抽）；
+* - `waveform`：纯派生数据，400 个浮点数 ≈ 4KB。一个 20 条素材的工程光波形
+*   就多占 80KB，而找回源文件后重算一次即可。
+*
+* 其余字段（含宿主写入的 `sourcePath`）原样保留。
+*/
 function stripRuntimeFields(asset) {
-	const { thumbnailUrls: _thumbnailUrls, ...rest } = asset;
-	return { ...rest };
+	const { thumbnailUrls: _thumbnailUrls, waveform: _waveform, ...rest } = asset;
+	return structuredClone(rest);
 }
 var ProjectSchemaError = class extends Error {
 	constructor(message) {
@@ -26,16 +44,18 @@ function deserializeProject(raw) {
 	const data = raw;
 	if (typeof data.schemaVersion !== "number") throw new ProjectSchemaError("工程缺少 schemaVersion，无法判断版本");
 	if (data.schemaVersion > 1) throw new ProjectSchemaError(`工程版本 ${data.schemaVersion} 高于当前应用支持的 1，请升级应用`);
-	const project = migrate(data.schemaVersion, data.project);
-	if (project == null) throw new ProjectSchemaError("工程主体缺失");
-	const assets = Array.isArray(data.assets) ? data.assets : [];
+	const migrated = migrate(data.schemaVersion, data.project);
+	if (migrated == null) throw new ProjectSchemaError("工程主体缺失");
+	const project = require_canvas_size.normalizeProject(migrated);
+	if (project == null) throw new ProjectSchemaError("工程结构无法识别");
+	const assets = (Array.isArray(data.assets) ? data.assets : []).map((asset) => require_canvas_size.normalizeAsset(asset)).filter((asset) => asset != null);
 	const assetIds = new Set(assets.map((a) => a.id));
-	const fileBacked = new Set(assets.filter((a) => a.kind === "video" || a.kind === "audio" || a.kind === "image").map((a) => a.id));
 	const referenced = new Set(project.clips.map((c) => c.assetId));
+	const fileBacked = assets.filter((a) => (a.kind === "video" || a.kind === "audio" || a.kind === "image") && referenced.has(a.id));
 	return {
 		project,
 		assets,
-		missingAssetIds: Array.from(/* @__PURE__ */ new Set([...project.clips.map((c) => c.assetId).filter((id) => !assetIds.has(id)), ...Array.from(fileBacked).filter((id) => referenced.has(id))]))
+		missingAssetIds: Array.from(/* @__PURE__ */ new Set([...project.clips.map((c) => c.assetId).filter((id) => !assetIds.has(id)), ...fileBacked.map((a) => a.id)]))
 	};
 }
 function migrate(version, project) {
@@ -188,6 +208,69 @@ function createWebBridge(options = {}) {
 		}
 	};
 }
+// src/export/types.ts
+/** 导出默认值：1080p / 30fps / 8Mbps / 含音轨 */
+var DEFAULT_EXPORT_SETTINGS = {
+	preset: "1080p",
+	width: 1920,
+	height: 1080,
+	fps: 30,
+	bitrate: 8e6,
+	includeAudio: true
+};
+function even(n) {
+	return Math.max(2, Math.round(n / 2) * 2);
+}
+/**
+* 把宿主传入的局部设置补全为完整设置。
+*
+* 只给了 `preset` 时按预设推导尺寸（`source` 取工程尺寸并向下对齐到偶数），
+* 显式给了 `width` / `height` 则以显式值为准。
+*/
+function resolveExportSettings(project, partial) {
+	const preset = partial?.preset ?? DEFAULT_EXPORT_SETTINGS.preset;
+	const presetSize = preset === "720p" ? {
+		width: 1280,
+		height: 720
+	} : preset === "1080p" ? {
+		width: 1920,
+		height: 1080
+	} : {
+		width: even(project.width),
+		height: even(project.height)
+	};
+	return {
+		preset,
+		width: partial?.width ?? presetSize.width,
+		height: partial?.height ?? presetSize.height,
+		fps: partial?.fps ?? DEFAULT_EXPORT_SETTINGS.fps,
+		bitrate: partial?.bitrate ?? DEFAULT_EXPORT_SETTINGS.bitrate,
+		includeAudio: partial?.includeAudio ?? DEFAULT_EXPORT_SETTINGS.includeAudio
+	};
+}
+/** 默认文件名（与编辑器无关，宿主可覆盖） */
+function createExportFilename(date = /* @__PURE__ */ new Date()) {
+	const pad = (n) => String(n).padStart(2, "0");
+	return `cut-test-${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}-${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}.mp4`;
+}
+// src/errors.ts
+/**
+* 对外错误类型。
+*
+* 放在根入口（不依赖 WebAV / React），宿主可以 `instanceof` 判断后决定
+* 是否弹错误框 —— 用户主动取消导出不是错误，不该被当成失败提示。
+*/
+/** 导出被 `cancel()` 取消。 */
+var ExportCancelledError = class extends Error {
+	constructor(message = "导出已取消") {
+		super(message);
+		this.name = "ExportCancelledError";
+	}
+};
+/** 判断任意异常是否是「用户取消导出」。 */
+function isExportCancelled(error) {
+	return error instanceof ExportCancelledError;
+}
 // src/capability.ts
 /**
 * 运行环境能力探测。
@@ -493,23 +576,17 @@ var immer$1 = immerImpl;
 function createEditorStore(options) {
 	const history = options.history;
 	return (0, zustand_vanilla.createStore)()(immer$1((set, get) => {
-		/**
-		* 在结构性变更前压栈（必须在 set 之前调用，拿到的是「变更前」的完整快照）。
-		*
-		* @param label 变更描述
-		* @param mergeKey 合并键：连续同质操作（如拖动同一个滑块）在时间窗口内合并为一步撤销。
-		*                 `record()` 内部只保留第一次的快照，因此一次拖动 = 一步 Ctrl+Z。
-		*/
+		/** 在结构性变更前压栈（必须在 set 之前调用，拿到的是「变更前」的完整快照） */
 		function recordHistory(label, mergeKey) {
 			const { project, assets } = get();
 			history.getState().record({
 				project: structuredClone(project),
 				assets: structuredClone(assets),
 				label
-			}, {
+			}, mergeKey != null ? {
 				label,
 				mergeKey
-			});
+			} : { label });
 		}
 		return {
 			project: options.project ?? require_canvas_size.createEmptyProject(),
@@ -548,6 +625,18 @@ function createEditorStore(options) {
 					draft.dirty = true;
 				});
 			},
+			setProjectId: (id) => {
+				if (id === get().project.id) return;
+				recordHistory("修改工程 ID");
+				set((draft) => {
+					draft.project.id = id;
+					draft.project.updatedAt = Date.now();
+					draft.dirty = true;
+				});
+			},
+			setMissingAssetIds: (ids) => set((draft) => {
+				draft.missingAssetIds = [...ids];
+			}),
 			/**
 			* 修改画布尺寸（比例）。
 			*
@@ -666,7 +755,7 @@ function createEditorStore(options) {
 					const clip = draft.project.clips.find((c) => c.id === clipId);
 					if (!clip) return;
 					clip.trackId = trackId;
-					clip.startUs = require_canvas_size.asUs(Math.max(0, startUs));
+					clip.startUs = require_time.asUs(Math.max(0, startUs));
 					draft.project.updatedAt = Date.now();
 					draft.dirty = true;
 				});
@@ -692,16 +781,16 @@ function createEditorStore(options) {
 					const sourceOffset = Math.round(leftDuration * clip.playbackRate);
 					const right = {
 						...structuredClone(clip),
-						id: require_canvas_size.createId("clip"),
-						startUs: require_canvas_size.asUs(atUs),
-						durationUs: require_canvas_size.asUs(rightDuration),
-						inPointUs: require_canvas_size.asUs(clip.inPointUs + sourceOffset),
-						fadeInUs: require_canvas_size.asUs(Math.min(clip.fadeInUs, rightDuration))
+						id: require_id.createId("clip"),
+						startUs: require_time.asUs(atUs),
+						durationUs: require_time.asUs(rightDuration),
+						inPointUs: require_time.asUs(clip.inPointUs + sourceOffset),
+						fadeInUs: require_time.asUs(Math.min(clip.fadeInUs, rightDuration))
 					};
 					return {
 						leftId: clip.id,
-						leftDuration: require_canvas_size.asUs(leftDuration),
-						leftFadeOut: require_canvas_size.asUs(Math.min(clip.fadeOutUs, leftDuration)),
+						leftDuration: require_time.asUs(leftDuration),
+						leftFadeOut: require_time.asUs(Math.min(clip.fadeOutUs, leftDuration)),
 						right
 					};
 				});
@@ -727,7 +816,7 @@ function createEditorStore(options) {
 				const ids = state.selectedClipIds;
 				const created = [];
 				if (ids.length === 0) return created;
-				const pairs = require_canvas_size.duplicateClipsData(structuredClone(state.project.clips), ids, offsetUs, () => require_canvas_size.createId("clip"));
+				const pairs = require_canvas_size.duplicateClipsData(structuredClone(state.project.clips), ids, offsetUs, () => require_id.createId("clip"));
 				recordHistory("复制片段");
 				set((draft) => {
 					for (const { sourceId, clip } of pairs) {
@@ -788,7 +877,7 @@ function createEditorStore(options) {
 				draft.selectedAssetId = id;
 			}),
 			setPlayhead: (us) => set((draft) => {
-				draft.playheadUs = require_canvas_size.asUs(Math.max(0, us));
+				draft.playheadUs = require_time.asUs(Math.max(0, us));
 			}),
 			setPlaying: (playing) => set((draft) => {
 				draft.playing = playing;
@@ -894,12 +983,24 @@ function normalizeWaveform(peaks, length) {
 	}
 	return out;
 }
+Object.defineProperty(exports, "DEFAULT_EXPORT_SETTINGS", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_EXPORT_SETTINGS;
+	}
+});
 Object.defineProperty(exports, "ENGINE_DEPENDENCIES_INSTALL_COMMAND", {
 	enumerable: true,
 	get: function() {
 		return ENGINE_DEPENDENCIES_INSTALL_COMMAND;
 	}
 });
+Object.defineProperty(exports, "ExportCancelledError", {
+	enumerable: true,
+	get: function() {
+		return ExportCancelledError;
+	}
+});
 Object.defineProperty(exports, "ProjectSchemaError", {
 	enumerable: true,
 	get: function() {
@@ -930,6 +1031,12 @@ Object.defineProperty(exports, "createEventBus", {
 		return createEventBus;
 	}
 });
+Object.defineProperty(exports, "createExportFilename", {
+	enumerable: true,
+	get: function() {
+		return createExportFilename;
+	}
+});
 Object.defineProperty(exports, "createHistoryStore", {
 	enumerable: true,
 	get: function() {
@@ -990,12 +1097,24 @@ Object.defineProperty(exports, "isEnvironmentUsable", {
 		return isEnvironmentUsable;
 	}
 });
+Object.defineProperty(exports, "isExportCancelled", {
+	enumerable: true,
+	get: function() {
+		return isExportCancelled;
+	}
+});
 Object.defineProperty(exports, "normalizeWaveform", {
 	enumerable: true,
 	get: function() {
 		return normalizeWaveform;
 	}
 });
+Object.defineProperty(exports, "resolveExportSettings", {
+	enumerable: true,
+	get: function() {
+		return resolveExportSettings;
+	}
+});
 Object.defineProperty(exports, "selectAssetById", {
 	enumerable: true,
 	get: function() {
@@ -1063,4 +1182,4 @@ Object.defineProperty(exports, "summarizeCapabilities", {
 	}
 });
 
-//# sourceMappingURL=waveform-Bhvv2t7-.cjs.map
+//# sourceMappingURL=waveform-BYwDdKpC.cjs.map