@lokvis/runtime 0.2.2 → 0.4.2

package/dist/browser-detect.js

@@ -0,0 +1,160 @@
+/**
+ * 浏览器能力检测(W22.3)
+ *
+ * 提供 Safari / Firefox 等浏览器的特性降级路径所需的能力探测:
+ * - 存储类:OPFS / IndexedDB / navigator.storage.estimate
+ * - 编解码类:WebCodecs(ImageDecoder/VideoDecoder/AudioDecoder/VideoEncoder) /
+ *   OffscreenCanvas / createImageBitmap
+ * - 并发类:SharedArrayBuffer / crossOriginIsolated(WASM 线程所需)
+ * - 其他:WebWorker / ServiceWorker / WebAssembly
+ *
+ * 设计原则:
+ * 1. 优先 feature detection(typeof X !== 'undefined' / 'function'),
+ *    不依赖 UA 嗅探(UA 易伪装且不未来兼容)
+ * 2. UA 嗅探仅作辅助,用于已知 Safari/ Firefox 版本的特定 workaround
+ * 3. 所有检测在 SSR(Node)环境下安全返回 false / unknown
+ * 4. 探测结果可被 Runtime 初始化 + Playground UI 复用
+ *
+ * 现有降级链(已在其他模块实现,本模块仅提供能力探测供调用方决策):
+ * - AssetStore:OPFS → IndexedDB → Memory(createAssetStore 工厂,W2.8)
+ * - engine-image:纯 Canvas 2D API(无 WebCodecs 需要降级)
+ * - canvas-engine.decodeResized:Safari 16.4+ 支持 createImageBitmap resize
+ *   选项,不支持时回退到普通 decode + drawImage(已实现)
+ */
+import { isOpfsSupported } from './opfs-asset-store.js';
+import { isIdbSupported } from './idb-asset-store.js';
+/** 缓存能力探测结果(同一会话内不变,避免重复检测) */
+let cachedCapabilities;
+/** 缓存 UA 识别结果(同一会话内不变) */
+let cachedBrowserInfo;
+/**
+ * 探测当前环境(浏览器/Node)的能力。
+ *
+ * 在 SSR(Node)环境下,所有浏览器 API 检测返回 false。
+ *
+ * 结果在首次调用后缓存,同一会话内重复调用返回同一对象。
+ * 如需强制重新探测(测试场景),传 { force: true }。
+ */
+export function detectBrowserCapabilities(options = {}) {
+    if (cachedCapabilities && !options.force)
+        return cachedCapabilities;
+    const g = globalThis;
+    const nav = typeof navigator !== 'undefined' ? navigator : undefined;
+    cachedCapabilities = {
+        opfs: isOpfsSupported(),
+        indexedDB: isIdbSupported(),
+        storageEstimate: !!nav && typeof nav.storage?.estimate === 'function',
+        webCodecsImageDecoder: typeof g.ImageDecoder !== 'undefined',
+        webCodecsVideoDecoder: typeof g.VideoDecoder !== 'undefined',
+        webCodecsVideoEncoder: typeof g.VideoEncoder !== 'undefined',
+        webCodecsAudioDecoder: typeof g.AudioDecoder !== 'undefined',
+        offscreenCanvas: typeof g.OffscreenCanvas !== 'undefined',
+        createImageBitmap: typeof g.createImageBitmap === 'function',
+        sharedArrayBuffer: typeof g.SharedArrayBuffer !== 'undefined',
+        crossOriginIsolated: typeof g.crossOriginIsolated === 'boolean' ? g.crossOriginIsolated : false,
+        webAssembly: typeof g.WebAssembly !== 'undefined',
+        webWorker: typeof g.Worker !== 'undefined',
+        serviceWorker: !!nav && typeof nav.serviceWorker !== 'undefined',
+    };
+    return cachedCapabilities;
+}
+/** UA 嗅探正则(仅作辅助,优先用 detectBrowserCapabilities) */
+const SAFARI_REGEX = /Version\/(\d+)\.\d+.*Safari\/[\d.]+/;
+const FIREFOX_REGEX = /Firefox\/(\d+)\.\d+/;
+const EDGE_REGEX = /Edg\/(\d+)\.\d+/;
+const CHROME_REGEX = /Chrome\/(\d+)\.\d+/;
+const MOBILE_REGEX = /Mobi|Android|iPhone|iPad|iPod/i;
+/**
+ * 识别当前浏览器(基于 UA 嗅探)。
+ *
+ * 注意:UA 嗅探不可靠,浏览器可伪装 UA。优先用 detectBrowserCapabilities()
+ * 检测实际能力。本函数仅用于已知浏览器的特定 workaround(如 Safari 的
+ * createImageBitmap resize 选项兼容性)。
+ *
+ * 结果在首次调用后缓存,同一会话内重复调用返回同一对象。
+ * 如需强制重新识别(测试场景),传 { force: true }。
+ */
+export function detectBrowserInfo(options = {}) {
+    if (cachedBrowserInfo && !options.force)
+        return cachedBrowserInfo;
+    if (typeof navigator === 'undefined') {
+        cachedBrowserInfo = {
+            name: 'unknown', version: 0,
+            isSafari: false, isFirefox: false, isChrome: false, isEdge: false,
+            isMobile: false,
+        };
+        return cachedBrowserInfo;
+    }
+    const ua = navigator.userAgent;
+    // Edge 必须先检测(含 Chrome 字样)
+    const edgeMatch = ua.match(EDGE_REGEX);
+    if (edgeMatch && edgeMatch[1]) {
+        cachedBrowserInfo = {
+            name: 'edge', version: parseInt(edgeMatch[1], 10),
+            isSafari: false, isFirefox: false, isChrome: false, isEdge: true,
+            isMobile: MOBILE_REGEX.test(ua),
+        };
+        return cachedBrowserInfo;
+    }
+    // Safari 必须在 Chrome 之前检测(排除 Chrome:Chrome UA 含 Chrome/ 但不含 Version/X Safari/X)
+    const safariMatch = ua.match(SAFARI_REGEX);
+    if (safariMatch && safariMatch[1] && !ua.includes('Chrome/')) {
+        cachedBrowserInfo = {
+            name: 'safari', version: parseInt(safariMatch[1], 10),
+            isSafari: true, isFirefox: false, isChrome: false, isEdge: false,
+            isMobile: MOBILE_REGEX.test(ua),
+        };
+        return cachedBrowserInfo;
+    }
+    const firefoxMatch = ua.match(FIREFOX_REGEX);
+    if (firefoxMatch && firefoxMatch[1]) {
+        cachedBrowserInfo = {
+            name: 'firefox', version: parseInt(firefoxMatch[1], 10),
+            isSafari: false, isFirefox: true, isChrome: false, isEdge: false,
+            isMobile: MOBILE_REGEX.test(ua),
+        };
+        return cachedBrowserInfo;
+    }
+    const chromeMatch = ua.match(CHROME_REGEX);
+    if (chromeMatch && chromeMatch[1]) {
+        cachedBrowserInfo = {
+            name: 'chrome', version: parseInt(chromeMatch[1], 10),
+            isSafari: false, isFirefox: false, isChrome: true, isEdge: false,
+            isMobile: MOBILE_REGEX.test(ua),
+        };
+        return cachedBrowserInfo;
+    }
+    cachedBrowserInfo = {
+        name: 'unknown', version: 0,
+        isSafari: false, isFirefox: false, isChrome: false, isEdge: false,
+        isMobile: MOBILE_REGEX.test(ua),
+    };
+    return cachedBrowserInfo;
+}
+/**
+ * 判断当前浏览器是否为 Safari(基于 UA 嗅探)。
+ *
+ * 用于已知 Safari 版本的特定 workaround,如:
+ * - Safari 16.4 以下不支持 createImageBitmap resize 选项
+ * - Safari 的 OffscreenCanvas 在 Worker 中行为不一致
+ *
+ * 优先用 detectBrowserCapabilities().offscreenCanvas 等能力检测。
+ */
+export function isSafari() {
+    return detectBrowserInfo().isSafari;
+}
+/**
+ * 判断当前浏览器是否为 Firefox(基于 UA 嗅探)。
+ *
+ * 用于 Firefox 特定 workaround(如某些 CSS / API 差异)。
+ * 优先用 detectBrowserCapabilities() 检测实际能力。
+ */
+export function isFirefox() {
+    return detectBrowserInfo().isFirefox;
+}
+/** 测试专用:重置缓存(确保下次 detectBrowserXxx 重新探测) */
+export function _resetBrowserDetectCache() {
+    cachedCapabilities = undefined;
+    cachedBrowserInfo = undefined;
+}
+//# sourceMappingURL=browser-detect.js.map

package/dist/browser-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-detect.js","sourceRoot":"","sources":["../src/browser-detect.ts"],"names":[],"mappings":"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"}

package/dist/concurrency-controller.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ConcurrencyController - 批量作业并发槽位控制(W4.4 拆分)
+ *
+ * 职责:
+ * - 提供免费/Pro 默认并发上限常量
+ * - 按 MemoryGuard 压力动态收缩并发槽位
+ *
+ * 设计原则:
+ * - 无状态:仅依赖注入的 memoryGuard
+ * - 纯函数:current() 基于 baseConcurrency + 当前 pressure 计算
+ */
+import type { MemoryGuard, MemoryPressure } from './memory-guard.js';
+/** 默认并发槽位 */
+export declare const FREE_CONCURRENCY = 4;
+export declare const PRO_CONCURRENCY = 16;
+/** 按 MemoryPressure 收缩并发槽位 */
+export declare function shrinkConcurrencyByPressure(base: number, pressure: MemoryPressure): number;
+/**
+ * 并发控制器:基于 MemoryGuard 压力动态收缩槽位。
+ *
+ * 不持有 baseConcurrency(每 job 独立),current() 接收 base 并返回当前实际可用槽位。
+ */
+export declare class ConcurrencyController {
+    private readonly memoryGuard?;
+    constructor(opts: {
+        memoryGuard?: MemoryGuard;
+    });
+    /** 当前并发槽位(按内存压力动态收缩) */
+    current(baseConcurrency: number): number;
+}
+//# sourceMappingURL=concurrency-controller.d.ts.map

package/dist/concurrency-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency-controller.d.ts","sourceRoot":"","sources":["../src/concurrency-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErE,aAAa;AACb,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,8BAA8B;AAC9B,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,cAAc,GACvB,MAAM,CAWR;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;gBAE/B,IAAI,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE;IAI/C,wBAAwB;IACxB,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM;CAIzC"}

package/dist/concurrency-controller.js

@@ -0,0 +1,33 @@
+/** 默认并发槽位 */
+export const FREE_CONCURRENCY = 4;
+export const PRO_CONCURRENCY = 16;
+/** 按 MemoryPressure 收缩并发槽位 */
+export function shrinkConcurrencyByPressure(base, pressure) {
+    switch (pressure) {
+        case 'critical':
+            return 1;
+        case 'high':
+            return Math.max(1, Math.floor(base / 2));
+        case 'elevated':
+            return Math.max(2, Math.floor((base * 3) / 4));
+        default:
+            return base;
+    }
+}
+/**
+ * 并发控制器:基于 MemoryGuard 压力动态收缩槽位。
+ *
+ * 不持有 baseConcurrency(每 job 独立),current() 接收 base 并返回当前实际可用槽位。
+ */
+export class ConcurrencyController {
+    memoryGuard;
+    constructor(opts) {
+        this.memoryGuard = opts.memoryGuard;
+    }
+    /** 当前并发槽位(按内存压力动态收缩) */
+    current(baseConcurrency) {
+        const pressure = this.memoryGuard?.getPressure() ?? 'low';
+        return shrinkConcurrencyByPressure(baseConcurrency, pressure);
+    }
+}
+//# sourceMappingURL=concurrency-controller.js.map

package/dist/concurrency-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency-controller.js","sourceRoot":"","sources":["../src/concurrency-controller.ts"],"names":[],"mappings":"AAaA,aAAa;AACb,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,8BAA8B;AAC9B,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,QAAwB;IAExB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,CAAC,CAAC;QACX,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3C,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,qBAAqB;IACf,WAAW,CAAe;IAE3C,YAAY,IAAmC;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;IAED,wBAAwB;IACxB,OAAO,CAAC,eAAuB;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;QAC1D,OAAO,2BAA2B,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Runtime 类型化错误类(T10:消除 SDK message 模式匹配)
+ *
+ * 这些错误类供 runtime 各模块在对应场景抛出,替代原先的 `throw new Error(...)`。
+ * SDK 的 `fromLokvisError()` 通过 `instanceof` 检测这些类,包装为对应的 SDK
+ * 错误类(LokvisError 子类),无需再依赖 message 字符串模式匹配。
+ *
+ * 命名与 SDK 错误类对应(如 runtime `AssetNotFoundError` → SDK `AssetNotFoundError`),
+ * 但 runtime 侧继承 `Error`(不依赖 SDK 的 `LokvisError`),符合五层架构
+ * (Runtime 不依赖 SDK)。SDK import 时加 `Runtime` 前缀别名避免命名冲突
+ * (与 QuotaExceededError / Worker*Error 等现有模式一致)。
+ *
+ * super message 与原 `throw new Error(...)` 的 message 完全一致,保证:
+ * - 日志/堆栈输出不变
+ * - 依赖 message 文案的测试不破
+ */
+/** 资产未找到(assetStore.get 返回空) */
+export declare class AssetNotFoundError extends Error {
+    readonly assetId: string;
+    constructor(assetId: string);
+}
+/** 资产 Blob 未找到(getBlob 在 store 中找不到对应 blob) */
+export declare class AssetBlobNotFoundError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** 工作流结构校验失败(节点 ID 重复 / edge 引用未知节点 / 自环等) */
+export declare class WorkflowInvalidError extends Error {
+    constructor(message: string);
+}
+/** 工作流包含环(拓扑排序后 sorted.length !== nodes.length) */
+export declare class WorkflowCycleError extends Error {
+    constructor(message: string);
+}
+/** 工作流节点执行失败(transform 节点缺 capability 字段) */
+export declare class WorkflowNodeError extends Error {
+    readonly nodeId: string;
+    constructor(nodeId: string, message: string);
+}
+/** 能力未注册(capabilityRegistry.resolve 返回空且非 stub-only) */
+export declare class CapabilityNotRegisteredError extends Error {
+    readonly capability: string;
+    constructor(capability: string);
+}
+/** 能力仅有 stub 实现(需安装真实 engine 插件) */
+export declare class CapabilityStubOnlyError extends Error {
+    readonly capability: string;
+    constructor(capability: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,gCAAgC;AAChC,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM;CAK5B;AAED,+CAA+C;AAC/C,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED,8CAA8C;AAC9C,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,mDAAmD;AACnD,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,6CAA6C;AAC7C,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK5C;AAED,wDAAwD;AACxD,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAChB,UAAU,EAAE,MAAM;CAK/B;AAED,oCAAoC;AACpC,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAChB,UAAU,EAAE,MAAM;CAO/B"}

package/dist/errors.js

@@ -0,0 +1,74 @@
+/**
+ * Runtime 类型化错误类(T10:消除 SDK message 模式匹配)
+ *
+ * 这些错误类供 runtime 各模块在对应场景抛出,替代原先的 `throw new Error(...)`。
+ * SDK 的 `fromLokvisError()` 通过 `instanceof` 检测这些类,包装为对应的 SDK
+ * 错误类(LokvisError 子类),无需再依赖 message 字符串模式匹配。
+ *
+ * 命名与 SDK 错误类对应(如 runtime `AssetNotFoundError` → SDK `AssetNotFoundError`),
+ * 但 runtime 侧继承 `Error`(不依赖 SDK 的 `LokvisError`),符合五层架构
+ * (Runtime 不依赖 SDK)。SDK import 时加 `Runtime` 前缀别名避免命名冲突
+ * (与 QuotaExceededError / Worker*Error 等现有模式一致)。
+ *
+ * super message 与原 `throw new Error(...)` 的 message 完全一致,保证:
+ * - 日志/堆栈输出不变
+ * - 依赖 message 文案的测试不破
+ */
+/** 资产未找到(assetStore.get 返回空) */
+export class AssetNotFoundError extends Error {
+    assetId;
+    constructor(assetId) {
+        super(`Asset not found: ${assetId}`);
+        this.name = 'AssetNotFoundError';
+        this.assetId = assetId;
+    }
+}
+/** 资产 Blob 未找到(getBlob 在 store 中找不到对应 blob) */
+export class AssetBlobNotFoundError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'AssetBlobNotFoundError';
+    }
+}
+/** 工作流结构校验失败(节点 ID 重复 / edge 引用未知节点 / 自环等) */
+export class WorkflowInvalidError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WorkflowInvalidError';
+    }
+}
+/** 工作流包含环(拓扑排序后 sorted.length !== nodes.length) */
+export class WorkflowCycleError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WorkflowCycleError';
+    }
+}
+/** 工作流节点执行失败(transform 节点缺 capability 字段) */
+export class WorkflowNodeError extends Error {
+    nodeId;
+    constructor(nodeId, message) {
+        super(message);
+        this.name = 'WorkflowNodeError';
+        this.nodeId = nodeId;
+    }
+}
+/** 能力未注册(capabilityRegistry.resolve 返回空且非 stub-only) */
+export class CapabilityNotRegisteredError extends Error {
+    capability;
+    constructor(capability) {
+        super(`No implementation registered for capability "${capability}"`);
+        this.name = 'CapabilityNotRegisteredError';
+        this.capability = capability;
+    }
+}
+/** 能力仅有 stub 实现(需安装真实 engine 插件) */
+export class CapabilityStubOnlyError extends Error {
+    capability;
+    constructor(capability) {
+        super(`Capability "${capability}" is not yet available (only stub engine registered). Install a real engine plugin to use this capability.`);
+        this.name = 'CapabilityStubOnlyError';
+        this.capability = capability;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,gCAAgC;AAChC,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,OAAO,CAAS;IACzB,YAAY,OAAe;QACzB,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,+CAA+C;AAC/C,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,8CAA8C;AAC9C,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,6CAA6C;AAC7C,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,MAAM,CAAS;IACxB,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,UAAU,CAAS;IAC5B,YAAY,UAAkB;QAC5B,KAAK,CAAC,gDAAgD,UAAU,GAAG,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,oCAAoC;AACpC,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,UAAU,CAAS;IAC5B,YAAY,UAAkB;QAC5B,KAAK,CACH,eAAe,UAAU,4GAA4G,CACtI,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/executor.d.ts

@@ -26,6 +26,15 @@ export declare class WorkflowExecutor {
     execute(workflow: Workflow, inputs: AssetId[] | Asset[]): Promise<WorkflowResult>;
     /** 取消执行 */
     cancel(workflowId: string): Promise<void>;
+    /**
+     * 取消所有运行中的工作流(W21.6 runtime.dispose 用)。
+     *
+     * 遍历 running Map,对每个 state 执行 cancel 的同步部分
+     * (status = cancelled + abort + 唤醒 resume resolver + emit event)。
+     * 不等待 executor.execute 内部循环跳出 —— abort 后循环在下个 await
+     * 点自然抛 AbortError,资源随 Promise reject 释放。
+     */
+    cancelAll(): void;
     /** 暂停执行 */
     pause(workflowId: string): Promise<void>;
     /** 恢复执行 */

package/dist/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EAEP,QAAQ,EAGR,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAWnE,qBAAqB;AACrB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AA0GD,mBAAmB;AACnB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAsC;IACrD,4CAA4C;IAC5C,OAAO,CAAC,eAAe,CAAiC;gBAE5C,MAAM,EAAE,cAAc;IAIlC,YAAY;IACN,OAAO,CACX,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAC1B,OAAO,CAAC,cAAc,CAAC;IA+I1B,WAAW;IACL,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C,WAAW;IACL,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,WAAW;IACL,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAMrB,+BAA+B;IAC/B,OAAO,CAAC,aAAa;CAOtB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EAEP,QAAQ,EAGR,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAmBnE,qBAAqB;AACrB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AA0GD,mBAAmB;AACnB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAsC;IACrD,4CAA4C;IAC5C,OAAO,CAAC,eAAe,CAAiC;gBAE5C,MAAM,EAAE,cAAc;IAIlC,YAAY;IACN,OAAO,CACX,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAC1B,OAAO,CAAC,cAAc,CAAC;IA2L1B,WAAW;IACL,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C;;;;;;;OAOG;IACH,SAAS,IAAI,IAAI;IAOjB,WAAW;IACL,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,WAAW;IACL,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAMrB,+BAA+B;IAC/B,OAAO,CAAC,aAAa;CAOtB"}

package/dist/executor.js

@@ -4,6 +4,7 @@
  * 第一年只支持 Linear Workflow（线性链）。
  * 不支持：Branch / Loop / Condition / Parallel。
  */
+import { AssetNotFoundError, WorkflowInvalidError, WorkflowCycleError, WorkflowNodeError, CapabilityNotRegisteredError, CapabilityStubOnlyError, } from './errors.js';
 /** 创建执行上下文 */
 function createExecutionContext(workflowId, nodeId, signal, onProgress) {
     return {
@@ -38,7 +39,7 @@ function topologicalSort(nodes, edges) {
         const seen = new Set();
         for (const n of nodes) {
             if (seen.has(n.id)) {
-                throw new Error(`Workflow contains duplicate node id: ${n.id}`);
+                throw new WorkflowInvalidError(`Workflow contains duplicate node id: ${n.id}`);
             }
             seen.add(n.id);
         }
@@ -51,18 +52,18 @@ function topologicalSort(nodes, edges) {
     // 被静默吞掉，进而导致下游节点入度无法归零 → 误判为环）
     for (const edge of edges) {
         if (!nodeMap.has(edge.from)) {
-            throw new Error(`Workflow edge references unknown source node: "${edge.from}". ` +
+            throw new WorkflowInvalidError(`Workflow edge references unknown source node: "${edge.from}". ` +
                 `Edge endpoints must reference existing nodes; ` +
                 `reserved sentinel nodes (e.g. "__input__") are not supported ` +
                 `by the executor — input assets are injected into the first node ` +
                 `with in-degree 0.`);
         }
         if (!nodeMap.has(edge.to)) {
-            throw new Error(`Workflow edge references unknown target node: "${edge.to}". ` +
+            throw new WorkflowInvalidError(`Workflow edge references unknown target node: "${edge.to}". ` +
                 `Edge endpoints must reference existing nodes.`);
         }
         if (edge.from === edge.to) {
-            throw new Error(`Workflow contains self-loop on node: "${edge.from}". ` +
+            throw new WorkflowInvalidError(`Workflow contains self-loop on node: "${edge.from}". ` +
                 `Self-loops create cycles and are not allowed.`);
         }
         inDegree.set(edge.to, (inDegree.get(edge.to) ?? 0) + 1);
@@ -87,7 +88,7 @@ function topologicalSort(nodes, edges) {
         }
     }
     if (sorted.length !== nodes.length) {
-        throw new Error('Workflow contains a cycle, cannot execute');
+        throw new WorkflowCycleError('Workflow contains a cycle, cannot execute');
     }
     return sorted;
 }
@@ -113,7 +114,7 @@ export class WorkflowExecutor {
             currentAssets = await Promise.all(ids.map(async (id) => {
                 const asset = await this.config.assetStore.get(id);
                 if (!asset)
-                    throw new Error(`Asset not found: ${id}`);
+                    throw new AssetNotFoundError(id);
                 return asset;
             }));
         }
@@ -139,53 +140,92 @@ export class WorkflowExecutor {
             const sortedNodes = topologicalSort(workflow.nodes, workflow.edges);
             // 过滤掉 load 和 export 节点（load 由输入处理，export 由结果处理）
             const transformNodes = sortedNodes.filter((n) => n.type === 'transform');
-            // 依次执行每个 transform 节点
-            for (const node of transformNodes) {
-                // 暂停则挂起,等待 resume/cancel 唤醒(Promise resolver,无轮询)
-                if (state.status === 'paused') {
-                    await this.waitForResume(workflowId);
-                }
-                // 唤醒后或每轮起始,若已被取消立即跳出(避免执行多余节点)
-                if (state.status === 'cancelled') {
-                    break;
-                }
-                state.currentNodeId = node.id;
-                const nodeStart = Date.now();
-                this.config.eventBus.emit({
-                    type: 'node:started',
-                    workflowId,
-                    nodeId: node.id,
-                    inputs: currentAssets,
-                });
-                // 解析能力实现(transform 节点必须有 capability)
-                const capability = node.capability;
-                if (!capability) {
-                    throw new Error(`Transform node "${node.id}" has no capability`);
-                }
-                const impl = this.config.capabilityRegistry.resolve(capability);
-                if (!impl) {
-                    if (this.config.capabilityRegistry.isStubOnly(capability)) {
-                        throw new Error(`Capability "${capability}" is not yet available (only stub engine registered). Install a real engine plugin to use this capability.`);
+            // E1: 多 target 机制
+            // targets 存在且非空时,为每个 target 独立执行一次 transform 链,
+            // target.params 浅合并到每个节点的 params（target 优先）。
+            // 无 targets 时等价于单次执行（targetParams = undefined）。
+            const targets = workflow.outputs.targets;
+            const targetParamSets = targets && targets.length > 0
+                ? targets.map((t) => t.params)
+                : [undefined];
+            // 保存原始输入资产,每个 target 执行前重置
+            const inputAssets = [...currentAssets];
+            const allOutputs = [];
+            /**
+             * 各 transform 节点的输出 AssetId(按 node.id 索引)。
+             * 仅单 target 场景填充(多 target 同一节点会有多份输出,
+             * 索引歧义,留空让调用方走事件总线监听 node:finished)。
+             */
+            const stepOutputs = {};
+            const isSingleTarget = targetParamSets.length === 1;
+            for (const targetParams of targetParamSets) {
+                // 每个 target 开始前重置为原始输入
+                currentAssets = [...inputAssets];
+                // 依次执行每个 transform 节点
+                for (const node of transformNodes) {
+                    // 暂停则挂起,等待 resume/cancel 唤醒(Promise resolver,无轮询)
+                    if (state.status === 'paused') {
+                        await this.waitForResume(workflowId);
+                    }
+                    // 唤醒后或每轮起始,若已被取消立即跳出(避免执行多余节点)
+                    if (state.status === 'cancelled') {
+                        break;
+                    }
+                    state.currentNodeId = node.id;
+                    const nodeStart = Date.now();
+                    this.config.eventBus.emit({
+                        type: 'node:started',
+                        workflowId,
+                        nodeId: node.id,
+                        inputs: currentAssets,
+                    });
+                    // 解析能力实现(transform 节点必须有 capability)
+                    const capability = node.capability;
+                    if (!capability) {
+                        throw new WorkflowNodeError(node.id, `Transform node "${node.id}" has no capability`);
+                    }
+                    const impl = this.config.capabilityRegistry.resolve(capability);
+                    if (!impl) {
+                        if (this.config.capabilityRegistry.isStubOnly(capability)) {
+                            throw new CapabilityStubOnlyError(capability);
+                        }
+                        throw new CapabilityNotRegisteredError(capability);
                     }
-                    throw new Error(`No implementation registered for capability "${capability}"`);
+                    // E1: target params 覆盖 node params（浅合并,target 优先）
+                    // 注：展开 undefined 是 no-op,无需 ?? {} fallback（oxlint no-empty-fallback-in-spread）
+                    const mergedParams = targetParams
+                        ? { ...node.params, ...targetParams }
+                        : (node.params ?? {});
+                    // 执行能力
+                    const ctx = createExecutionContext(workflowId, node.id, abortController.signal);
+                    const outputs = await impl.execute(currentAssets, mergedParams, ctx);
+                    currentAssets = outputs;
+                    // 单 target 时记录该节点输出,供调用方读取中间结果
+                    // (多 target 场景跳过,避免 last-write-wins 语义歧义)
+                    if (isSingleTarget) {
+                        stepOutputs[node.id] = currentAssets.map((a) => a.id);
+                    }
+                    this.config.eventBus.emit({
+                        type: 'node:finished',
+                        workflowId,
+                        nodeId: node.id,
+                        capability,
+                        params: mergedParams,
+                        outputs: currentAssets,
+                        duration: Date.now() - nodeStart,
+                    });
                 }
-                // 执行能力
-                const ctx = createExecutionContext(workflowId, node.id, abortController.signal);
-                const outputs = await impl.execute(currentAssets, node.params ?? {}, ctx);
-                currentAssets = outputs;
-                this.config.eventBus.emit({
-                    type: 'node:finished',
-                    workflowId,
-                    nodeId: node.id,
-                    capability,
-                    params: node.params ?? {},
-                    outputs: currentAssets,
-                    duration: Date.now() - nodeStart,
-                });
+                // 收集当前 target 的输出（cancelled 时也保留已完成的节点输出）
+                allOutputs.push(...currentAssets);
+                if (state.status === 'cancelled')
+                    break;
             }
             const result = {
                 workflowId,
-                outputs: currentAssets.map((a) => a.id),
+                outputs: allOutputs.map((a) => a.id),
+                // 单 target 且非取消时暴露中间步骤输出;其他场景保持 undefined,
+                // 调用方需要中间结果时应改用 eventBus 监听 node:finished 事件
+                stepOutputs: isSingleTarget && state.status !== 'cancelled' ? stepOutputs : undefined,
                 duration: Date.now() - startTime,
                 status: state.status === 'cancelled' ? 'cancelled' : 'completed',
             };
@@ -233,6 +273,20 @@ export class WorkflowExecutor {
         this.resolveResume(workflowId);
         this.config.eventBus.emit({ type: 'workflow:cancelled', workflowId });
     }
+    /**
+     * 取消所有运行中的工作流(W21.6 runtime.dispose 用)。
+     *
+     * 遍历 running Map,对每个 state 执行 cancel 的同步部分
+     * (status = cancelled + abort + 唤醒 resume resolver + emit event)。
+     * 不等待 executor.execute 内部循环跳出 —— abort 后循环在下个 await
+     * 点自然抛 AbortError,资源随 Promise reject 释放。
+     */
+    cancelAll() {
+        // 复制一份避免 cancel 内 emit 触发的 listener 回调 mutate 原集合
+        for (const workflowId of [...this.running.keys()]) {
+            void this.cancel(workflowId);
+        }
+    }
     /** 暂停执行 */
     async pause(workflowId) {
         const state = this.running.get(workflowId);