@lokvis/runtime 0.1.0

package/dist/executor.js

@@ -0,0 +1,237 @@
+/**
+ * Lokvis Workflow Executor
+ *
+ * 第一年只支持 Linear Workflow（线性链）。
+ * 不支持：Branch / Loop / Condition / Parallel。
+ */
+/** 创建执行上下文 */
+function createExecutionContext(workflowId, nodeId, signal, onProgress) {
+    return {
+        workflowId,
+        nodeId,
+        signal,
+        onProgress,
+        log: (level, message) => {
+            // 日志输出，可被 Analytics 监听
+            if (level === 'error') {
+                console.error(`[lokvis:${workflowId}:${nodeId}] ${message}`);
+            }
+            else if (level === 'warn') {
+                console.warn(`[lokvis:${workflowId}:${nodeId}] ${message}`);
+            }
+        },
+    };
+}
+/** 拓扑排序：将 edges 转换为线性节点序列 */
+function topologicalSort(nodes, edges) {
+    const nodeMap = new Map(nodes.map((n) => [n.id, n]));
+    const inDegree = new Map();
+    const adjacency = new Map();
+    for (const node of nodes) {
+        inDegree.set(node.id, 0);
+        adjacency.set(node.id, []);
+    }
+    for (const edge of edges) {
+        inDegree.set(edge.to, (inDegree.get(edge.to) ?? 0) + 1);
+        adjacency.get(edge.from)?.push(edge.to);
+    }
+    const queue = [];
+    for (const [id, deg] of inDegree) {
+        if (deg === 0)
+            queue.push(id);
+    }
+    const sorted = [];
+    while (queue.length > 0) {
+        const id = queue.shift();
+        const node = nodeMap.get(id);
+        if (node)
+            sorted.push(node);
+        for (const next of adjacency.get(id) ?? []) {
+            const newDeg = (inDegree.get(next) ?? 0) - 1;
+            inDegree.set(next, newDeg);
+            if (newDeg === 0)
+                queue.push(next);
+        }
+    }
+    if (sorted.length !== nodes.length) {
+        throw new Error('Workflow contains a cycle, cannot execute');
+    }
+    return sorted;
+}
+/** Workflow 执行器 */
+export class WorkflowExecutor {
+    config;
+    running = new Map();
+    /** 暂停时挂起的 resolve:resume/cancel 唤醒之,避免轮询 */
+    resumeResolvers = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /** 执行工作流 */
+    async execute(workflow, inputs) {
+        const workflowId = workflow.id;
+        const abortController = new AbortController();
+        const startTime = Date.now();
+        // 解析输入 Asset
+        let currentAssets;
+        if (inputs.length === 0 || typeof inputs[0] === 'string') {
+            // AssetId[] - 从 store 加载
+            const ids = inputs;
+            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}`);
+                return asset;
+            }));
+        }
+        else {
+            // Asset[]
+            currentAssets = inputs;
+        }
+        // 注册运行状态
+        const state = {
+            id: workflowId,
+            workflow,
+            status: 'running',
+            abortController,
+        };
+        this.running.set(workflowId, state);
+        this.config.eventBus.emit({
+            type: 'workflow:started',
+            workflowId,
+            workflow,
+        });
+        try {
+            // 拓扑排序节点
+            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) {
+                    throw new Error(`No implementation registered for capability "${capability}"`);
+                }
+                // 执行能力
+                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,
+                });
+            }
+            const result = {
+                workflowId,
+                outputs: currentAssets.map((a) => a.id),
+                duration: Date.now() - startTime,
+                status: state.status === 'cancelled' ? 'cancelled' : 'completed',
+            };
+            this.config.eventBus.emit({
+                type: 'workflow:completed',
+                workflowId,
+                result,
+            });
+            return result;
+        }
+        catch (error) {
+            const result = {
+                workflowId,
+                outputs: [],
+                duration: Date.now() - startTime,
+                status: 'failed',
+                error: error instanceof Error ? error.message : String(error),
+            };
+            this.config.eventBus.emit({
+                type: 'node:failed',
+                workflowId,
+                nodeId: state.currentNodeId ?? 'unknown',
+                error: error instanceof Error ? error : new Error(String(error)),
+            });
+            this.config.eventBus.emit({
+                type: 'workflow:completed',
+                workflowId,
+                result,
+            });
+            return result;
+        }
+        finally {
+            this.running.delete(workflowId);
+            this.resumeResolvers.delete(workflowId);
+        }
+    }
+    /** 取消执行 */
+    async cancel(workflowId) {
+        const state = this.running.get(workflowId);
+        if (!state)
+            return;
+        state.status = 'cancelled';
+        state.abortController.abort();
+        // 唤醒可能暂停中的执行循环,使其跳出
+        this.resolveResume(workflowId);
+        this.config.eventBus.emit({ type: 'workflow:cancelled', workflowId });
+    }
+    /** 暂停执行 */
+    async pause(workflowId) {
+        const state = this.running.get(workflowId);
+        if (!state || state.status !== 'running')
+            return;
+        state.status = 'paused';
+        this.config.eventBus.emit({ type: 'workflow:paused', workflowId });
+    }
+    /** 恢复执行 */
+    async resume(workflowId) {
+        const state = this.running.get(workflowId);
+        if (!state || state.status !== 'paused')
+            return;
+        state.status = 'running';
+        // 唤醒挂起的 waitForResume,无需轮询
+        this.resolveResume(workflowId);
+        this.config.eventBus.emit({ type: 'workflow:resumed', workflowId });
+    }
+    /**
+     * 挂起当前执行直到 resume/cancel 唤醒(Promise resolver 模式)。
+     * 相比轮询(setTimeout)无延迟、无 CPU 占用;resume/cancel 通过
+     * resolveResume 触发 resolver。
+     */
+    waitForResume(workflowId) {
+        return new Promise((resolve) => {
+            this.resumeResolvers.set(workflowId, resolve);
+        });
+    }
+    /** 唤醒挂起的 waitForResume(若存在) */
+    resolveResume(workflowId) {
+        const resolve = this.resumeResolvers.get(workflowId);
+        if (resolve) {
+            this.resumeResolvers.delete(workflowId);
+            resolve();
+        }
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Lokvis History Stack
+ *
+ * 每个工作流拥有独立的 HistoryStack,记录每一步 transform 的 HistoryEntry。
+ * undo/redo 通过 cursor(游标)实现:
+ *   - cursor 指向最后一条已应用的 entry
+ *   - append 新操作时截断 cursor 之后的 redo 分支
+ *   - 超出上限(默认 10 步)时 LRU 淘汰最旧条目并回调 onEvict 通知清理
+ *
+ * 每次变更通过回调通知调用方(由 Runtime 转发为 eventBus 的 history:changed)。
+ *
+ * 对应 PROJECT_PLAN W2 任务 2.1 / 2.2 / 2.4。
+ */
+import type { HistoryEntry } from '@lokvis/schema';
+/** HistoryStack 配置 */
+export interface HistoryStackConfig {
+    /** 历史记录上限(默认 10 步) */
+    maxEntries: number;
+    /** 淘汰条目时的回调,用于清理 OPFS 资产 */
+    onEvict?: (entry: HistoryEntry) => void;
+    /** 历史变更时的回调,用于转发为 eventBus 事件 */
+    onChanged?: (workflowId: string, entries: HistoryEntry[]) => void;
+}
+/** HistoryStack 状态(供序列化/恢复使用) */
+export interface HistoryStackSnapshot {
+    entries: HistoryEntry[];
+    cursor: number;
+}
+export declare class HistoryStack {
+    private readonly workflowId;
+    private entries;
+    /** 游标:指向最后一条已应用的 entry;-1 表示尚未应用任何条目 */
+    private cursor;
+    private readonly config;
+    constructor(workflowId: string, config?: Partial<HistoryStackConfig>);
+    /** 当前可应用的条目数(cursor 之后已截断) */
+    get length(): number;
+    /** cursor 位置(指向最后已应用条目,-1 表示空) */
+    get currentIndex(): number;
+    /** 是否可以 undo */
+    get canUndo(): boolean;
+    /** 是否可以 redo */
+    get canRedo(): boolean;
+    /** 所有历史条目(只读视图) */
+    list(): HistoryEntry[];
+    /** 仅返回已应用的条目(cursor 及之前) */
+    applied(): HistoryEntry[];
+    /** 仅返回 redo 分支中尚未应用的条目 */
+    redoBranch(): HistoryEntry[];
+    /**
+     * 追加一条历史记录。
+     * 若当前存在 redo 分支(cursor 之后的条目),则截断之,
+     *   并对被丢弃的条目触发 onEvict(清理其 outputs 资产,避免 OPFS/IDB 泄漏)。
+     * 若超过上限,从最旧端 LRU 淘汰,并触发 onEvict 回调。
+     */
+    append(entry: HistoryEntry): void;
+    /**
+     * 撤销一步:cursor 前移,返回当前应应用的 entry(即 undo 后的"当前"输出)。
+     * 返回值含义:
+     *   - 如果 undo 后 cursor >= 0:返回该 entry(调用方应将其 outputs 作为当前状态)
+     *   - 如果 undo 后 cursor < 0(回到初始):返回 null(调用方应恢复初始 inputs)
+     * 如果不能 undo(cursor < 0),返回 undefined 表示无操作。
+     */
+    undo(): HistoryEntry | null | undefined;
+    /**
+     * 重做一步:cursor 后移,返回重做后应应用的 entry。
+     * 如果不能 redo,返回 undefined 表示无操作。
+     */
+    redo(): HistoryEntry | undefined;
+    /** 跳转到指定条目(按 timestamp 顺序的索引) */
+    jumpTo(index: number): HistoryEntry | null | undefined;
+    /** 清空所有历史(不触发 onEvict,用于工作流销毁) */
+    clear(): void;
+    /**
+     * 重置历史:清空所有条目并对每条触发 onEvict(清理其 outputs 资产)。
+     * 用于工作流重新执行(run)时丢弃上一次(可能失败的)历史,避免资产泄漏。
+     * 与 clear() 的区别:clear() 仅重置内存状态,reset() 同时回收资产。
+     */
+    reset(): void;
+    /** 导出快照(用于持久化到 IndexedDB) */
+    snapshot(): HistoryStackSnapshot;
+    /** 从快照恢复 */
+    restore(snapshot: HistoryStackSnapshot): void;
+    /** 对一批被丢弃的条目触发 onEvict(忽略回调抛错) */
+    private notifyEvict;
+    /** 超过 maxEntries 时从最旧端淘汰,并触发 onEvict 回调 */
+    private evictIfNeeded;
+    private notifyChanged;
+}
+/** 工厂:创建 HistoryStack */
+export declare function createHistoryStack(workflowId: string, config?: Partial<HistoryStackConfig>): HistoryStack;
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,sBAAsB;AACtB,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,iCAAiC;IACjC,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;CACnE;AAED,iCAAiC;AACjC,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IAQrB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAP7B,OAAO,CAAC,OAAO,CAAsB;IACrC,wCAAwC;IACxC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAC6B;gBAGjC,UAAU,EAAE,MAAM,EACnC,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAS1C,8BAA8B;IAC9B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,kCAAkC;IAClC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,gBAAgB;IAChB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,gBAAgB;IAChB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,mBAAmB;IACnB,IAAI,IAAI,YAAY,EAAE;IAItB,4BAA4B;IAC5B,OAAO,IAAI,YAAY,EAAE;IAIzB,0BAA0B;IAC1B,UAAU,IAAI,YAAY,EAAE;IAI5B;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAuBjC;;;;;;OAMG;IACH,IAAI,IAAI,YAAY,GAAG,IAAI,GAAG,SAAS;IAOvC;;;OAGG;IACH,IAAI,IAAI,YAAY,GAAG,SAAS;IAOhC,iCAAiC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,GAAG,SAAS;IAOtD,kCAAkC;IAClC,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,KAAK,IAAI,IAAI;IASb,6BAA6B;IAC7B,QAAQ,IAAI,oBAAoB;IAOhC,YAAY;IACZ,OAAO,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAQ7C,kCAAkC;IAClC,OAAO,CAAC,WAAW;IAYnB,2CAA2C;IAC3C,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,aAAa;CAGtB;AAED,yBAAyB;AACzB,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,YAAY,CAEd"}

package/dist/history.js

@@ -0,0 +1,171 @@
+export class HistoryStack {
+    workflowId;
+    entries = [];
+    /** 游标:指向最后一条已应用的 entry;-1 表示尚未应用任何条目 */
+    cursor = -1;
+    config;
+    constructor(workflowId, config = {}) {
+        this.workflowId = workflowId;
+        this.config = {
+            maxEntries: config.maxEntries ?? 10,
+            onEvict: config.onEvict,
+            onChanged: config.onChanged,
+        };
+    }
+    /** 当前可应用的条目数(cursor 之后已截断) */
+    get length() {
+        return this.entries.length;
+    }
+    /** cursor 位置(指向最后已应用条目,-1 表示空) */
+    get currentIndex() {
+        return this.cursor;
+    }
+    /** 是否可以 undo */
+    get canUndo() {
+        return this.cursor >= 0;
+    }
+    /** 是否可以 redo */
+    get canRedo() {
+        return this.cursor < this.entries.length - 1;
+    }
+    /** 所有历史条目(只读视图) */
+    list() {
+        return [...this.entries];
+    }
+    /** 仅返回已应用的条目(cursor 及之前) */
+    applied() {
+        return this.entries.slice(0, this.cursor + 1);
+    }
+    /** 仅返回 redo 分支中尚未应用的条目 */
+    redoBranch() {
+        return this.entries.slice(this.cursor + 1);
+    }
+    /**
+     * 追加一条历史记录。
+     * 若当前存在 redo 分支(cursor 之后的条目),则截断之,
+     *   并对被丢弃的条目触发 onEvict(清理其 outputs 资产,避免 OPFS/IDB 泄漏)。
+     * 若超过上限,从最旧端 LRU 淘汰,并触发 onEvict 回调。
+     */
+    append(entry) {
+        if (entry.workflowId !== this.workflowId) {
+            throw new Error(`HistoryEntry.workflowId mismatch: expected "${this.workflowId}", got "${entry.workflowId}"`);
+        }
+        // 截断 redo 分支:cursor 之后的条目全部丢弃,并通知清理其 outputs 资产
+        if (this.cursor < this.entries.length - 1) {
+            const dropped = this.entries.slice(this.cursor + 1);
+            this.entries = this.entries.slice(0, this.cursor + 1);
+            this.notifyEvict(dropped);
+        }
+        this.entries.push(entry);
+        this.cursor = this.entries.length - 1;
+        // LRU 淘汰最旧条目
+        this.evictIfNeeded();
+        this.notifyChanged();
+    }
+    /**
+     * 撤销一步:cursor 前移,返回当前应应用的 entry(即 undo 后的"当前"输出)。
+     * 返回值含义:
+     *   - 如果 undo 后 cursor >= 0:返回该 entry(调用方应将其 outputs 作为当前状态)
+     *   - 如果 undo 后 cursor < 0(回到初始):返回 null(调用方应恢复初始 inputs)
+     * 如果不能 undo(cursor < 0),返回 undefined 表示无操作。
+     */
+    undo() {
+        if (!this.canUndo)
+            return undefined;
+        this.cursor -= 1;
+        this.notifyChanged();
+        return this.cursor >= 0 ? this.entries[this.cursor] : null;
+    }
+    /**
+     * 重做一步:cursor 后移,返回重做后应应用的 entry。
+     * 如果不能 redo,返回 undefined 表示无操作。
+     */
+    redo() {
+        if (!this.canRedo)
+            return undefined;
+        this.cursor += 1;
+        this.notifyChanged();
+        return this.entries[this.cursor];
+    }
+    /** 跳转到指定条目(按 timestamp 顺序的索引) */
+    jumpTo(index) {
+        if (index < -1 || index >= this.entries.length)
+            return undefined;
+        this.cursor = index;
+        this.notifyChanged();
+        return this.cursor >= 0 ? this.entries[this.cursor] : null;
+    }
+    /** 清空所有历史(不触发 onEvict,用于工作流销毁) */
+    clear() {
+        this.entries = [];
+        this.cursor = -1;
+        this.notifyChanged();
+    }
+    /**
+     * 重置历史:清空所有条目并对每条触发 onEvict(清理其 outputs 资产)。
+     * 用于工作流重新执行(run)时丢弃上一次(可能失败的)历史,避免资产泄漏。
+     * 与 clear() 的区别:clear() 仅重置内存状态,reset() 同时回收资产。
+     */
+    reset() {
+        if (this.entries.length > 0) {
+            this.notifyEvict(this.entries);
+        }
+        this.entries = [];
+        this.cursor = -1;
+        this.notifyChanged();
+    }
+    /** 导出快照(用于持久化到 IndexedDB) */
+    snapshot() {
+        return {
+            entries: [...this.entries],
+            cursor: this.cursor,
+        };
+    }
+    /** 从快照恢复 */
+    restore(snapshot) {
+        this.entries = [...snapshot.entries];
+        this.cursor = Math.max(-1, Math.min(snapshot.cursor, this.entries.length - 1));
+        this.notifyChanged();
+    }
+    // ─── 内部方法 ──────────────────────────────────────
+    /** 对一批被丢弃的条目触发 onEvict(忽略回调抛错) */
+    notifyEvict(entries) {
+        const onEvict = this.config.onEvict;
+        if (!onEvict || entries.length === 0)
+            return;
+        for (const entry of entries) {
+            try {
+                onEvict(entry);
+            }
+            catch {
+                // onEvict 失败不应阻断历史操作,由调用方日志记录
+            }
+        }
+    }
+    /** 超过 maxEntries 时从最旧端淘汰,并触发 onEvict 回调 */
+    evictIfNeeded() {
+        // 无 onEvict 回调时仍需维护上限(静默丢弃,调用方无法清理 OPFS,但内存不爆)
+        if (!this.config.onEvict) {
+            while (this.entries.length > this.config.maxEntries) {
+                this.entries.shift();
+                // cursor 跟随左移,但不低于 -1
+                this.cursor = Math.max(-1, this.cursor - 1);
+            }
+            return;
+        }
+        const evicted = [];
+        while (this.entries.length > this.config.maxEntries) {
+            evicted.push(this.entries.shift());
+            this.cursor = Math.max(-1, this.cursor - 1);
+        }
+        this.notifyEvict(evicted);
+    }
+    notifyChanged() {
+        this.config.onChanged?.(this.workflowId, this.list());
+    }
+}
+/** 工厂:创建 HistoryStack */
+export function createHistoryStack(workflowId, config) {
+    return new HistoryStack(workflowId, config);
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/idb-asset-store.d.ts

@@ -0,0 +1,46 @@
+/**
+ * IndexedDB Asset Store
+ *
+ * 元数据 + Blob 全部存 IndexedDB(通过 Dexie)。
+ * 当 OPFS 不可用时作为降级方案,数据持久化且支持跨刷新恢复。
+ *
+ * 降级链(W2.8 工厂):OPFS → IndexedDB(本实现) → Memory
+ */
+import Dexie, { type Table } from 'dexie';
+import type { Asset, AssetId } from '@lokvis/schema';
+import type { AssetStore } from './asset-store.js';
+/** IndexedDB 不可用时抛出 */
+export declare class IdbUnavailableError extends Error {
+    constructor(message: string);
+}
+/** IDB 文件存储路径前缀(出现在 BlobHandle.path 中) */
+export declare const IDB_PATH_PREFIX = "idb";
+/** IDB AssetStore 配置 */
+export interface IdbAssetStoreOptions {
+    /** 数据库名(默认 'lokvis-assets') */
+    dbName?: string;
+    /**
+     * 测试注入:自定义 Dexie 实例。
+     * 默认创建新实例。
+     */
+    dbInstance?: AssetDatabase;
+}
+/** IndexedDB 中的资产记录(Asset 元数据 + Blob 数据) */
+export interface AssetRecord {
+    /** 主键 = Asset.id */
+    id: AssetId;
+    /** 资产元数据 */
+    asset: Asset;
+    /** 原始 Blob 数据(结构化克隆存储) */
+    blob: Blob;
+}
+/** Dexie 数据库封装 */
+export declare class AssetDatabase extends Dexie {
+    assets: Table<AssetRecord, string>;
+    constructor(name?: string);
+}
+/** 检测当前环境是否支持 IndexedDB */
+export declare function isIdbSupported(): boolean;
+/** 创建 IndexedDB 版 AssetStore */
+export declare function createIdbAssetStore(options?: IdbAssetStoreOptions): Promise<AssetStore>;
+//# sourceMappingURL=idb-asset-store.d.ts.map

package/dist/idb-asset-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-asset-store.d.ts","sourceRoot":"","sources":["../src/idb-asset-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,EAAE,KAAK,KAAK,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,uBAAuB;AACvB,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,0CAA0C;AAC1C,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,wBAAwB;AACxB,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,kBAAkB;AAClB,qBAAa,aAAc,SAAQ,KAAK;IACtC,MAAM,EAAG,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;gBAExB,IAAI,SAAkB;CAOnC;AAED,2BAA2B;AAC3B,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED,gCAAgC;AAChC,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,UAAU,CAAC,CA+CrB"}

package/dist/idb-asset-store.js

@@ -0,0 +1,76 @@
+/**
+ * IndexedDB Asset Store
+ *
+ * 元数据 + Blob 全部存 IndexedDB(通过 Dexie)。
+ * 当 OPFS 不可用时作为降级方案,数据持久化且支持跨刷新恢复。
+ *
+ * 降级链(W2.8 工厂):OPFS → IndexedDB(本实现) → Memory
+ */
+import Dexie, {} from 'dexie';
+import { buildAsset, generateId, parseBlobPath, prepareImport, } from './asset-store.js';
+/** IndexedDB 不可用时抛出 */
+export class IdbUnavailableError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'IdbUnavailableError';
+    }
+}
+/** IDB 文件存储路径前缀(出现在 BlobHandle.path 中) */
+export const IDB_PATH_PREFIX = 'idb';
+/** Dexie 数据库封装 */
+export class AssetDatabase extends Dexie {
+    assets;
+    constructor(name = 'lokvis-assets') {
+        super(name);
+        this.version(1).stores({
+            // 仅主键 id;按 type 查询由上层过滤 list() 实现,无需二级索引
+            assets: 'id',
+        });
+    }
+}
+/** 检测当前环境是否支持 IndexedDB */
+export function isIdbSupported() {
+    // Dexie 始终可 import,但实际使用需要全局 indexedDB
+    return typeof indexedDB !== 'undefined';
+}
+/** 创建 IndexedDB 版 AssetStore */
+export async function createIdbAssetStore(options = {}) {
+    if (!isIdbSupported() && !options.dbInstance) {
+        throw new IdbUnavailableError('IndexedDB is not available in this environment');
+    }
+    const db = options.dbInstance ?? new AssetDatabase(options.dbName);
+    return {
+        async import(source) {
+            const { id, blob, metadata, type } = prepareImport(source);
+            const asset = buildAsset(id, blob, metadata, type, IDB_PATH_PREFIX);
+            await db.assets.put({ id, asset, blob });
+            return asset;
+        },
+        async get(id) {
+            const record = await db.assets.get(id);
+            return record?.asset;
+        },
+        async getBlob(handle) {
+            const id = parseBlobPath(handle.path, IDB_PATH_PREFIX);
+            const record = await db.assets.get(id);
+            if (!record) {
+                throw new Error(`Blob not found in IndexedDB for path: ${handle.path}`);
+            }
+            return record.blob;
+        },
+        async remove(id) {
+            await db.assets.delete(id);
+        },
+        async list() {
+            const records = await db.assets.toArray();
+            return records.map((r) => r.asset);
+        },
+        async create(blob, metadata, type) {
+            const id = generateId();
+            const asset = buildAsset(id, blob, metadata, type, IDB_PATH_PREFIX);
+            await db.assets.put({ id, asset, blob });
+            return asset;
+        },
+    };
+}
+//# sourceMappingURL=idb-asset-store.js.map

package/dist/idb-asset-store.js.map

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