@lokvis/runtime 0.2.0-beta.0 → 0.2.1

package/dist/workflow-builder.js

@@ -0,0 +1,240 @@
+/**
+ * WorkflowBuilder - 线性工作流链式构造器(W10.1)
+ *
+ * 提供链式 API 构造线性 Workflow(第一年不支持 Branch/Loop/Condition/Parallel)。
+ *
+ * 限制:
+ *   - 最多 5 步(M1 MVP 约束,免费用户定位,避免复杂度过高)
+ *   - 节点必须为 transform 类型(load/export 由执行器隐式处理)
+ *   - 自动生成线性 edges:node[i] → node[i+1]
+ *
+ * 使用示例:
+ * ```typescript
+ * const workflow = new WorkflowBuilder('my-workflow', 'Web 优化')
+ *   .setInput({ type: 'image', multiple: true })
+ *   .setOutput({ type: 'image', format: 'webp' })
+ *   .add('image.resize', { width: 1920, fit: 'inside' })
+ *   .add('image.compress', { format: 'webp', quality: 80 })
+ *   .add('image.watermark', { text: '@lokvis' })
+ *   .build();
+ * ```
+ *
+ * 与 workflow-slice 的 buildLinearWorkflow 区别:
+ *   - buildLinearWorkflow 是内部工具函数,从 WorkspaceNode[] 构造无校验
+ *   - WorkflowBuilder 是公开 API,链式调用 + 5 步上限校验 + 元数据完善
+ *
+ * @module workflow-builder
+ */
+/** 工作流最大节点数(M1 MVP 约束) */
+export const MAX_WORKFLOW_STEPS = 5;
+/**
+ * WorkflowBuilder - 链式构造线性 Workflow。
+ *
+ * 抛错时机:
+ *   - add() 超过 maxSteps 时立即抛错(避免构造完才发现步数超限)
+ *   - build() 在节点为空 / 输入输出未设置时抛错
+ *   - remove()/move() 在节点 id 不存在时静默(链式 API 容错)
+ */
+export class WorkflowBuilder {
+    options;
+    maxSteps;
+    nodes = [];
+    input = null;
+    output = null;
+    nodeCounter = 0;
+    constructor(options) {
+        if (!options.id)
+            throw new Error('WorkflowBuilder: id is required');
+        if (!options.name)
+            throw new Error('WorkflowBuilder: name is required');
+        this.options = options;
+        this.maxSteps = options.maxSteps ?? MAX_WORKFLOW_STEPS;
+    }
+    /** 设置工作流输入定义 */
+    setInput(input) {
+        this.input = input;
+        return this;
+    }
+    /** 设置工作流输出定义 */
+    setOutput(output) {
+        this.output = output;
+        return this;
+    }
+    /**
+     * 添加一个节点到链尾。
+     *
+     * @param capability 能力名,如 `image.resize`
+     * @param params 能力参数(可选,默认空对象)
+     * @param label 节点标签(可选,UI 显示用)
+     * @throws Error 当节点数达到 maxSteps 时
+     */
+    add(capability, params = {}, label) {
+        if (!capability)
+            throw new Error('WorkflowBuilder.add: capability is required');
+        if (this.nodes.length >= this.maxSteps) {
+            throw new Error(`WorkflowBuilder.add: max steps (${this.maxSteps}) reached; ` +
+                `cannot add more nodes. Adjust maxSteps option if needed.`);
+        }
+        this.nodeCounter += 1;
+        this.nodes.push({
+            id: `${this.options.id}-node-${this.nodeCounter}`,
+            capability,
+            params,
+            label,
+        });
+        return this;
+    }
+    /**
+     * 按 capability 或节点 id 移除节点。
+     * 若有多个同 capability 节点,只移除第一个。
+     * 若不存在则静默(链式 API 容错)。
+     *
+     * @param capabilityOrId 能力名或节点 id
+     */
+    remove(capabilityOrId) {
+        const idx = this.nodes.findIndex((n) => n.id === capabilityOrId || n.capability === capabilityOrId);
+        if (idx >= 0) {
+            this.nodes.splice(idx, 1);
+        }
+        return this;
+    }
+    /**
+     * 移动节点到新位置(线性链中重排)。
+     *
+     * @param from 源位置(0-based 索引)
+     * @param to 目标位置(0-based 索引,移动后该节点的新位置)
+     * @throws Error 当索引越界
+     */
+    move(from, to) {
+        if (from < 0 || from >= this.nodes.length) {
+            throw new Error(`WorkflowBuilder.move: from index ${from} out of range`);
+        }
+        if (to < 0 || to >= this.nodes.length) {
+            throw new Error(`WorkflowBuilder.move: to index ${to} out of range`);
+        }
+        if (from === to)
+            return this;
+        const [node] = this.nodes.splice(from, 1);
+        // splice(from, 1) 在已校验的 in-range 索引上必返回 1 元素;
+        // 此处显式检查以满足 noUncheckedIndexedAccess,并在不变量被打破时报错
+        if (!node) {
+            throw new Error(`WorkflowBuilder.move: source node at index ${from} missing`);
+        }
+        this.nodes.splice(to, 0, node);
+        return this;
+    }
+    /** 交换两个节点位置 */
+    swap(i, j) {
+        if (i < 0 || i >= this.nodes.length || j < 0 || j >= this.nodes.length) {
+            throw new Error('WorkflowBuilder.swap: index out of range');
+        }
+        if (i === j)
+            return this;
+        const a = this.nodes[i];
+        const b = this.nodes[j];
+        // 上方范围校验保证 i / j 在界内;显式检查以满足 noUncheckedIndexedAccess
+        if (!a || !b) {
+            throw new Error('WorkflowBuilder.swap: node missing (invariant violated)');
+        }
+        this.nodes[i] = b;
+        this.nodes[j] = a;
+        return this;
+    }
+    /** 更新指定节点的参数 */
+    updateParams(nodeId, params) {
+        const node = this.nodes.find((n) => n.id === nodeId);
+        if (node) {
+            node.params = { ...node.params, ...params };
+        }
+        return this;
+    }
+    /** 当前节点数 */
+    get size() {
+        return this.nodes.length;
+    }
+    /** 是否已达最大节点数 */
+    get isFull() {
+        return this.nodes.length >= this.maxSteps;
+    }
+    /** 获取节点的只读副本(用于 UI 预览) */
+    getNodes() {
+        return this.nodes.map((n) => ({ ...n }));
+    }
+    /**
+     * 构造 Workflow 实例。
+     *
+     * @throws Error 当节点为空 / 输入未设置 / 输出未设置
+     */
+    build() {
+        if (this.nodes.length === 0) {
+            throw new Error('WorkflowBuilder.build: no nodes added');
+        }
+        if (!this.input) {
+            throw new Error('WorkflowBuilder.build: input not set (call setInput first)');
+        }
+        if (!this.output) {
+            throw new Error('WorkflowBuilder.build: output not set (call setOutput first)');
+        }
+        const workflowNodes = this.nodes.map((n) => ({
+            id: n.id,
+            type: 'transform',
+            capability: n.capability,
+            params: n.params,
+            label: n.label,
+        }));
+        const edges = [];
+        for (let i = 0; i < workflowNodes.length - 1; i++) {
+            const fromNode = workflowNodes[i];
+            const toNode = workflowNodes[i + 1];
+            // 循环边界 i < length - 1 保证 i 与 i+1 均在界内;显式检查以满足 noUncheckedIndexedAccess
+            if (!fromNode || !toNode) {
+                throw new Error('WorkflowBuilder.build: edge node missing (invariant violated)');
+            }
+            edges.push({
+                from: fromNode.id,
+                to: toNode.id,
+            });
+        }
+        const now = Date.now();
+        return {
+            $schema: `https://lokvis.dev/schemas/workflow.json`,
+            id: this.options.id,
+            version: '1.0.0',
+            name: this.options.name,
+            description: this.options.description ?? '',
+            author: this.options.author ?? { id: 'local', name: 'Local User' },
+            category: this.options.category ?? 'image',
+            tags: this.options.tags ?? [],
+            nodes: workflowNodes,
+            edges,
+            inputs: this.input,
+            outputs: this.output,
+            official: this.options.official ?? false,
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+}
+/** 从 Workflow 反向构造 Builder(用于编辑已有工作流) */
+export function workflowToBuilder(workflow, maxSteps) {
+    const builder = new WorkflowBuilder({
+        id: workflow.id,
+        name: workflow.name,
+        description: workflow.description,
+        author: workflow.author,
+        category: workflow.category,
+        tags: workflow.tags,
+        official: workflow.official,
+        maxSteps,
+    });
+    builder.setInput(workflow.inputs);
+    builder.setOutput(workflow.outputs);
+    // 按拓扑顺序添加节点(线性链 nodes 数组即顺序)
+    for (const node of workflow.nodes) {
+        if (node.type === 'transform' && node.capability) {
+            builder.add(node.capability, node.params ?? {}, node.label);
+        }
+    }
+    return builder;
+}
+//# sourceMappingURL=workflow-builder.js.map

package/dist/workflow-builder.js.map

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

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@lokvis/runtime",
-  "version": "0.2.0-beta.0",
+  "version": "0.2.1",
   "description": "Lokvis Runtime - Browser-local workflow execution engine",
   "license": "MIT",
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -25,7 +26,7 @@
   "dependencies": {
     "dexie": "^4.0.10",
     "mitt": "^3.0.1",
-    "@lokvis/schema": "0.2.0-beta.0"
+    "@lokvis/schema": "0.2.1"
   },
   "devDependencies": {
     "fake-indexeddb": "^6.0.0",

package/src/asset-store.ts

@@ -78,21 +78,121 @@ export interface PreparedImport {
   type: Asset['type'];
 }
 
+/** 富元数据提取结果(基础 metadata 之外的可选字段) */
+interface RichMetadata {
+  dimensions?: { width: number; height: number };
+  duration?: number;
+  pages?: number;
+}
+
+/**
+ * 从 Blob 提取富元数据(dimensions/duration/pages)。
+ *
+ * 提取策略:
+ * - image: createImageBitmap → width/height
+ * - video/audio: HTMLMediaElement + loadedmetadata → duration
+ * - pdf: 暂不提取(需 pdf.js,Phase 2 补全)
+ * - 其余: 返回空
+ *
+ * 所有提取均 try/catch:失败时返回空对象,不阻断 import。
+ * Node.js / 测试环境可能无 createImageBitmap / document,自然降级为空。
+ */
+async function extractRichMetadata(
+  blob: Blob,
+  type: Asset['type']
+): Promise<RichMetadata> {
+  try {
+    switch (type) {
+      case 'image':
+        return await extractImageDimensions(blob);
+      case 'video':
+      case 'audio':
+        return await extractMediaDuration(blob, type);
+      default:
+        return {};
+    }
+  } catch {
+    return {};
+  }
+}
+
+/** 用 createImageBitmap 提取图片尺寸(浏览器原生 API,失败返回空) */
+async function extractImageDimensions(blob: Blob): Promise<RichMetadata> {
+  if (typeof createImageBitmap !== 'function') return {};
+  const bitmap = await createImageBitmap(blob);
+  try {
+    return { dimensions: { width: bitmap.width, height: bitmap.height } };
+  } finally {
+    // 释放 ImageBitmap 资源,避免内存泄漏(浏览器 GC 不保证立即回收)
+    if (typeof bitmap.close === 'function') bitmap.close();
+  }
+}
+
+/** 用 HTMLMediaElement 提取视频/音频时长(浏览器环境,失败返回空) */
+async function extractMediaDuration(
+  blob: Blob,
+  type: 'video' | 'audio'
+): Promise<RichMetadata> {
+  if (typeof document === 'undefined') return {};
+  const url = URL.createObjectURL(blob);
+  try {
+    const el = document.createElement(type === 'video' ? 'video' : 'audio');
+    el.preload = 'metadata';
+    el.src = url;
+    return await new Promise<RichMetadata>((resolve) => {
+      let settled = false;
+      const finish = (result: RichMetadata) => {
+        if (settled) return;
+        settled = true;
+        el.onloadedmetadata = null;
+        el.onerror = null;
+        el.removeAttribute('src');
+        clearTimeout(timer);
+        resolve(result);
+      };
+      el.onloadedmetadata = () => {
+        const duration = el.duration;
+        finish(Number.isFinite(duration) ? { duration } : {});
+      };
+      el.onerror = () => finish({});
+      // M2 修复:超时兜底,防止坏文件既不触发 loadedmetadata 也不触发 onerror
+      // 导致 Promise 永久挂起 + 外层 finally 的 revokeObjectURL 永不执行(泄漏)
+      const timer = setTimeout(() => finish({}), MEDIA_DURATION_TIMEOUT_MS);
+    });
+  } finally {
+    URL.revokeObjectURL(url);
+  }
+}
+
+/** 媒体时长提取超时(5s,足够解码大多数媒体头) */
+const MEDIA_DURATION_TIMEOUT_MS = 5000;
+
 /**
  * 从 AssetSource 准备导入数据(共享逻辑,供 Memory/OPFS/IDB store 复用):
- * 提取 blob + MIME、生成 id、推断 type、构造 metadata。
+ * 提取 blob + MIME、生成 id、推断 type、构造 metadata(含富元数据)。
  * 各 store 只需负责"写入 blob + 存元数据"。
+ *
+ * W6.4:异步提取 dimensions(image)/ duration(video/audio)/ pages(pdf,暂 stub)。
+ * 富元数据提取失败时静默降级为 undefined,不阻断 import。
  */
-export function prepareImport(source: AssetSource): PreparedImport {
+export async function prepareImport(source: AssetSource): Promise<PreparedImport> {
   const { blob, mimeType: rawMime } = extractBlobFromSource(source);
   const id = generateId();
   const mimeType = rawMime || 'application/octet-stream';
   const type = inferAssetType(mimeType);
+
   const metadata: AssetMetadata = {
     mimeType,
     size: blob.size,
     format: getFormatFromMime(mimeType),
   };
+
+  // 富元数据(异步,失败静默降级)
+  const rich = await extractRichMetadata(blob, type);
+  if (rich.dimensions) metadata.dimensions = rich.dimensions;
+  if (rich.duration !== undefined) metadata.duration = rich.duration;
+  if (rich.pages !== undefined) metadata.pages = rich.pages;
+
   return { id, blob, metadata, type };
 }
 
@@ -140,7 +240,7 @@ export function createMemoryAssetStore(): AssetStore {
 
   return {
     async import(source) {
-      const { id, blob, metadata, type } = prepareImport(source);
+      const { id, blob, metadata, type } = await prepareImport(source);
       blobs.set(id, blob);
       const asset = buildAsset(id, blob, metadata, type, MEMORY_PATH_PREFIX);
       assets.set(id, asset);