@lokvis/ui-react 0.1.1-beta.0 → 0.2.0

package/dist/hooks/useShareLink.js

@@ -0,0 +1,120 @@
+/**
+ * useShareLink - 分享链接生成与解析(W11.5)
+ *
+ * 把当前工作流节点序列编码为 base64 URL 参数,生成可分享的链接。
+ * 接收方打开链接即可还原工作流(本地 base64,无需 cloud 短链)。
+ *
+ * 编码格式:
+ *   `<origin><pathname>?workflow=<base64url-encoded-json>`
+ *
+ * 其中 JSON 结构为 `{ v: 1, nodes: [{c, p}] }`(v=版本号,向前兼容)。
+ * 使用 base64url 编码(URL 安全,无 +/= 字符)。
+ *
+ * 注意:
+ *   - base64 编码会膨胀约 33%,长工作流可能超过 URL 长度限制(浏览器 ~2KB 安全,~8KB 极限)
+ *   - 5 步工作流通常远小于限制
+ *   - 不包含 asset 引用(asset 是本地文件,无法跨设备分享)
+ *
+ * @module useShareLink
+ */
+import { useCallback } from 'react';
+import { useWorkspaceStore } from '../store/index.js';
+/** 标准 base64 → base64url(URL 安全: + → -, / → _, 去除 = 填充) */
+function toBase64Url(b64) {
+    return b64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+/** base64url → 标准 base64 */
+function fromBase64Url(b64url) {
+    let b64 = b64url.replace(/-/g, '+').replace(/_/g, '/');
+    // 补齐 padding
+    const pad = b64.length % 4;
+    if (pad)
+        b64 += '='.repeat(4 - pad);
+    return b64;
+}
+/** UTF-8 安全的 base64 编码(处理非 ASCII 字符如中文水印) */
+function encodeUtf8Base64Url(str) {
+    const bytes = new TextEncoder().encode(str);
+    let binary = '';
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return toBase64Url(btoa(binary));
+}
+/** UTF-8 安全的 base64url 解码 */
+function decodeUtf8Base64Url(b64url) {
+    const b64 = fromBase64Url(b64url);
+    const binary = atob(b64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return new TextDecoder().decode(bytes);
+}
+/**
+ * 编码工作流节点为 base64url 字符串(用于分享链接)。
+ * 导出供测试与外部直接使用。
+ */
+export function encodeWorkflowForShare(nodes) {
+    const data = {
+        v: 1,
+        nodes: nodes.map((n) => ({ c: n.capability, p: n.params })),
+    };
+    return encodeUtf8Base64Url(JSON.stringify(data));
+}
+/**
+ * 解码 base64url 字符串为工作流节点。
+ * @returns 节点数组;解析失败返回 null。
+ */
+export function decodeWorkflowFromShare(encoded) {
+    try {
+        const json = decodeUtf8Base64Url(encoded);
+        const data = JSON.parse(json);
+        if (!data || typeof data !== 'object' || data.v !== 1 || !Array.isArray(data.nodes)) {
+            return null;
+        }
+        return data.nodes.map((n) => ({
+            capability: String(n.c),
+            params: (n.p && typeof n.p === 'object' ? n.p : {}),
+        }));
+    }
+    catch {
+        return null;
+    }
+}
+export function useShareLink() {
+    const nodes = useWorkspaceStore((s) => s.nodes);
+    const loadWorkflowTemplate = useWorkspaceStore((s) => s.loadWorkflowTemplate);
+    const generateShareUrl = useCallback(() => {
+        if (nodes.length === 0)
+            return null;
+        const encoded = encodeWorkflowForShare(nodes);
+        if (typeof window === 'undefined')
+            return null;
+        const { origin, pathname } = window.location;
+        return `${origin}${pathname}?workflow=${encoded}`;
+    }, [nodes]);
+    const parseShareUrl = useCallback((url) => {
+        const searchPart = url.includes('?') ? url.slice(url.indexOf('?') + 1) : '';
+        const params = new URLSearchParams(searchPart);
+        const encoded = params.get('workflow');
+        if (!encoded)
+            return null;
+        return decodeWorkflowFromShare(encoded);
+    }, []);
+    const loadFromCurrentUrl = useCallback(() => {
+        if (typeof window === 'undefined')
+            return false;
+        const parsed = parseShareUrl(window.location.href);
+        if (!parsed || parsed.length === 0)
+            return false;
+        loadWorkflowTemplate(parsed);
+        return true;
+    }, [parseShareUrl, loadWorkflowTemplate]);
+    return {
+        generateShareUrl,
+        parseShareUrl,
+        loadFromCurrentUrl,
+    };
+}
+//# sourceMappingURL=useShareLink.js.map

package/dist/hooks/useShareLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShareLink.js","sourceRoot":"","sources":["../../src/hooks/useShareLink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAUtD,2DAA2D;AAC3D,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,4BAA4B;AAC5B,SAAS,aAAa,CAAC,MAAc;IACnC,IAAI,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvD,aAAa;IACb,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,IAAI,GAAG;QAAE,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6CAA6C;AAC7C,SAAS,mBAAmB,CAAC,GAAW;IACtC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,6BAA6B;AAC7B,SAAS,mBAAmB,CAAC,MAAc;IACzC,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA6E;IAE7E,MAAM,IAAI,GAAsB;QAC9B,CAAC,EAAE,CAAC;QACJ,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;KAC5D,CAAC;IACF,OAAO,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC;QACnD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAA4B;SAC/E,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAqBD,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,oBAAoB,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAE9E,MAAM,gBAAgB,GAAG,WAAW,CAAC,GAAkB,EAAE;QACvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC7C,OAAO,GAAG,MAAM,GAAG,QAAQ,aAAa,OAAO,EAAE,CAAC;IACpD,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,GAAW,EAAyE,EAAE;QACrF,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC,EACD,EAAE,CACH,CAAC;IAEF,MAAM,kBAAkB,GAAG,WAAW,CAAC,GAAY,EAAE;QACnD,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC;QAChD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACjD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAE1C,OAAO;QACL,gBAAgB;QAChB,aAAa;QACb,kBAAkB;KACnB,CAAC;AACJ,CAAC"}

package/dist/hooks/useTheme.d.ts

@@ -0,0 +1,30 @@
+/**
+ * useTheme - 暗色模式切换 + 持久化(W9.7)
+ *
+ * 监听并切换 `<html>` 的 `.dark` / `.light` 类,与 `tokens.css` 双触发机制对齐:
+ *   - 显式设置:`document.documentElement.classList` 添加 `dark` 或 `light`
+ *   - 系统兜底:未显式设置时,`@media prefers-color-scheme` 自动生效
+ *
+ * 持久化:`localStorage.theme = 'dark' | 'light'`,刷新后恢复。
+ * 跨 tab 同步:监听 `storage` 事件,一个 tab 切换,其他 tab 同步生效。
+ *
+ * 系统偏好变化:未显式设置主题时,跟随 `matchMedia('(prefers-color-scheme: dark)')`。
+ *
+ * @example
+ * ```tsx
+ * const { theme, resolvedTheme, toggleTheme, setTheme } = useTheme();
+ * ```
+ */
+export type ThemeMode = 'light' | 'dark';
+export interface UseThemeResult {
+    /** 用户显式选择的主题(未设置时为 null,跟随系统) */
+    theme: ThemeMode | null;
+    /** 实际生效的主题(显式选择或系统偏好) */
+    resolvedTheme: ThemeMode;
+    /** 设置指定主题(传 null 表示跟随系统) */
+    setTheme(theme: ThemeMode | null): void;
+    /** 在 light / dark 之间切换(无显式主题时基于 resolvedTheme 决定下一态) */
+    toggleTheme(): void;
+}
+export declare function useTheme(): UseThemeResult;
+//# sourceMappingURL=useTheme.d.ts.map

package/dist/hooks/useTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AA8BzC,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,yBAAyB;IACzB,aAAa,EAAE,SAAS,CAAC;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,wDAAwD;IACxD,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,wBAAgB,QAAQ,IAAI,cAAc,CAsDzC"}

package/dist/hooks/useTheme.js

@@ -0,0 +1,105 @@
+/**
+ * useTheme - 暗色模式切换 + 持久化(W9.7)
+ *
+ * 监听并切换 `<html>` 的 `.dark` / `.light` 类,与 `tokens.css` 双触发机制对齐:
+ *   - 显式设置:`document.documentElement.classList` 添加 `dark` 或 `light`
+ *   - 系统兜底:未显式设置时,`@media prefers-color-scheme` 自动生效
+ *
+ * 持久化:`localStorage.theme = 'dark' | 'light'`,刷新后恢复。
+ * 跨 tab 同步:监听 `storage` 事件,一个 tab 切换,其他 tab 同步生效。
+ *
+ * 系统偏好变化:未显式设置主题时,跟随 `matchMedia('(prefers-color-scheme: dark)')`。
+ *
+ * @example
+ * ```tsx
+ * const { theme, resolvedTheme, toggleTheme, setTheme } = useTheme();
+ * ```
+ */
+import { useCallback, useEffect, useState } from 'react';
+const STORAGE_KEY = 'lokvis-theme';
+function readStoredTheme() {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        const v = window.localStorage.getItem(STORAGE_KEY);
+        if (v === 'light' || v === 'dark')
+            return v;
+    }
+    catch {
+        // localStorage 不可用(隐私模式 / iframe 沙箱)— 退回系统偏好
+    }
+    return null;
+}
+function readSystemTheme() {
+    if (typeof window === 'undefined' || !window.matchMedia)
+        return 'light';
+    return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+}
+/** 把显式主题应用到 <html>(null 表示清空,回退到系统偏好) */
+function applyTheme(theme) {
+    if (typeof document === 'undefined')
+        return;
+    const root = document.documentElement;
+    root.classList.remove('dark', 'light');
+    if (theme === 'dark')
+        root.classList.add('dark');
+    else if (theme === 'light')
+        root.classList.add('light');
+    // theme === null: 两个类都不加 → 由 @media prefers-color-scheme 接管
+}
+export function useTheme() {
+    const [theme, setThemeState] = useState(() => readStoredTheme());
+    const [systemTheme, setSystemTheme] = useState(() => readSystemTheme());
+    // 监听系统偏好变化(仅在用户未显式选择时影响 resolvedTheme)
+    useEffect(() => {
+        if (typeof window === 'undefined' || !window.matchMedia)
+            return;
+        const mq = window.matchMedia('(prefers-color-scheme: dark)');
+        const onChange = () => setSystemTheme(mq.matches ? 'dark' : 'light');
+        mq.addEventListener('change', onChange);
+        return () => mq.removeEventListener('change', onChange);
+    }, []);
+    // 应用主题到 <html>
+    useEffect(() => {
+        applyTheme(theme);
+    }, [theme]);
+    // 跨 tab 同步:监听 storage 事件
+    useEffect(() => {
+        if (typeof window === 'undefined')
+            return;
+        const onStorage = (e) => {
+            if (e.key !== STORAGE_KEY)
+                return;
+            setThemeState(readStoredTheme());
+        };
+        window.addEventListener('storage', onStorage);
+        return () => window.removeEventListener('storage', onStorage);
+    }, []);
+    const setTheme = useCallback((next) => {
+        setThemeState(next);
+        try {
+            if (typeof window === 'undefined')
+                return;
+            if (next === null) {
+                window.localStorage.removeItem(STORAGE_KEY);
+            }
+            else {
+                window.localStorage.setItem(STORAGE_KEY, next);
+            }
+        }
+        catch {
+            // 写入失败(隐私模式 / quota)— 不影响运行时切换,只是无法持久化
+        }
+    }, []);
+    const toggleTheme = useCallback(() => {
+        const resolved = theme ?? systemTheme;
+        setTheme(resolved === 'dark' ? 'light' : 'dark');
+    }, [theme, systemTheme, setTheme]);
+    return {
+        theme,
+        resolvedTheme: theme ?? systemTheme,
+        setTheme,
+        toggleTheme,
+    };
+}
+//# sourceMappingURL=useTheme.js.map

package/dist/hooks/useTheme.js.map

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

package/dist/hooks/useWorkflowProgress.d.ts

@@ -0,0 +1,28 @@
+/**
+ * useWorkflowProgress - 工作流执行进度(W11.6,review 抽取)
+ *
+ * 单一来源计算节点执行进度,供 ProgressBar / StatusBar 共用,
+ * 避免两组件各自从 nodes 重复计算 done/total/pct。
+ *
+ * 计算口径:
+ *   - done: 已结束节点(success + failed + cancelled)
+ *   - failedCount: 失败节点数(用于红色高亮)
+ *   - pct: 完成百分比(0-100),total=0 时为 0
+ *
+ * @module useWorkflowProgress
+ */
+export interface WorkflowProgress {
+    /** 节点总数 */
+    total: number;
+    /** 已结束节点数(success + failed + cancelled) */
+    done: number;
+    /** 失败节点数 */
+    failedCount: number;
+    /** 完成百分比(0-100) */
+    pct: number;
+    /** 是否有失败节点 */
+    hasFailure: boolean;
+}
+/** 计算工作流执行进度(单一来源,供 ProgressBar / StatusBar 共用) */
+export declare function useWorkflowProgress(): WorkflowProgress;
+//# sourceMappingURL=useWorkflowProgress.d.ts.map

package/dist/hooks/useWorkflowProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowProgress.d.ts","sourceRoot":"","sources":["../../src/hooks/useWorkflowProgress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,mDAAmD;AACnD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAUtD"}

package/dist/hooks/useWorkflowProgress.js

@@ -0,0 +1,25 @@
+/**
+ * useWorkflowProgress - 工作流执行进度(W11.6,review 抽取)
+ *
+ * 单一来源计算节点执行进度,供 ProgressBar / StatusBar 共用,
+ * 避免两组件各自从 nodes 重复计算 done/total/pct。
+ *
+ * 计算口径:
+ *   - done: 已结束节点(success + failed + cancelled)
+ *   - failedCount: 失败节点数(用于红色高亮)
+ *   - pct: 完成百分比(0-100),total=0 时为 0
+ *
+ * @module useWorkflowProgress
+ */
+import { useWorkspaceStore } from '../store/index.js';
+/** 计算工作流执行进度(单一来源,供 ProgressBar / StatusBar 共用) */
+export function useWorkflowProgress() {
+    const nodes = useWorkspaceStore((s) => s.nodes);
+    const total = nodes.length;
+    const done = nodes.filter((n) => n.status === 'success' || n.status === 'failed' || n.status === 'cancelled').length;
+    const failedCount = nodes.filter((n) => n.status === 'failed').length;
+    const pct = total > 0 ? Math.round((done / total) * 100) : 0;
+    const hasFailure = failedCount > 0;
+    return { total, done, failedCount, pct, hasFailure };
+}
+//# sourceMappingURL=useWorkflowProgress.js.map

package/dist/hooks/useWorkflowProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowProgress.js","sourceRoot":"","sources":["../../src/hooks/useWorkflowProgress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAetD,mDAAmD;AACnD,MAAM,UAAU,mBAAmB;IACjC,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CACnF,CAAC,MAAM,CAAC;IACT,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;IACtE,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,WAAW,GAAG,CAAC,CAAC;IACnC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;AACvD,CAAC"}

package/dist/hooks/useWorkflows.d.ts

@@ -0,0 +1,86 @@
+/**
+ * useWorkflows - 工作流槽位持久化 hook(W10.6 + W10.7)
+ *
+ * 提供 5 个工作流槽位的本地保存能力(免费 5 / Pro 无限),以及 JSON 导入/导出。
+ * 数据存储在 localStorage 的 `lokvis.workflows` key,JSON 数组形式。
+ *
+ * 与 useCustomPresets 的区别:
+ *   - 自定义预设是尺寸配置(width/height/fit)
+ *   - 工作流槽位是完整 Workflow 定义(含 nodes/edges/inputs/outputs)
+ *
+ * 序列化策略:
+ *   - 保存时用 workflowSchema.safeParse() 防御损坏数据(数据完整性)
+ *   - 加载时用 workflowSchema.safeParse() 过滤无效条目(向前兼容)
+ *   - JSON 导出:Workflow JSON + $schema 字段
+ *   - JSON 导入:validateWorkflow() 完整校验(含 capability 兼容性若提供回调)
+ *
+ * 多 tab / 多实例同步:
+ *   - 原生 storage 事件:跨 tab 同步
+ *   - 自定义 SYNC_EVENT:同 tab 多实例同步
+ *
+ * @module useWorkflows
+ */
+import type { Workflow } from '@lokvis/schema';
+import { type ValidateWorkflowOptions } from '@lokvis/schema';
+/** 免费用户工作流槽位上限 */
+export declare const FREE_WORKFLOW_LIMIT = 5;
+/** Pro 用户无上限 */
+export declare const PRO_WORKFLOW_LIMIT: number;
+/** 工作流槽位存储格式 */
+export interface WorkflowSlot {
+    /** 唯一 ID */
+    id: string;
+    /** 用户自定义名称(默认取 workflow.name) */
+    name: string;
+    /** 完整 Workflow 定义 */
+    workflow: Workflow;
+    /** 创建时间戳 */
+    createdAt: number;
+    /** 最后更新时间戳 */
+    updatedAt: number;
+}
+/** 保存工作流时的输入 */
+export interface SaveWorkflowInput {
+    /** 工作流名称(可选,默认取 workflow.name) */
+    name?: string;
+    /** 完整 Workflow 定义 */
+    workflow: Workflow;
+    /** 若指定则更新该 id 的槽位,否则新增 */
+    id?: string;
+}
+export interface UseWorkflowsResult {
+    /** 当前所有工作流槽位(按 updatedAt 降序) */
+    slots: WorkflowSlot[];
+    /** 保存或更新工作流;超限时抛 Error */
+    save(input: SaveWorkflowInput): WorkflowSlot;
+    /** 按 id 删除槽位 */
+    remove(id: string): void;
+    /** 按 id 加载工作流到 store(返回 Workflow) */
+    load(id: string): Workflow | null;
+    /** 当前上限(免费 5 / Pro 无限) */
+    limit: number;
+    /** 是否还能再保存 */
+    canSaveMore: boolean;
+    /** 还能再保存多少个 */
+    remaining: number;
+    /** 导出工作流为 JSON 字符串(可直接下载) */
+    exportToJson(id: string): string | null;
+    /** 导出所有工作流为 JSON 数组字符串 */
+    exportAllToJson(): string;
+    /** 从 JSON 字符导入工作流(单个或数组);返回导入结果(含跳过原因) */
+    importFromJson(json: string, options?: {
+        resolveCapability?: ValidateWorkflowOptions['resolveCapability'];
+        maxSteps?: number;
+    }): {
+        imported: number;
+        skipped: Array<{
+            reason: string;
+        }>;
+    };
+}
+/**
+ * @param isPro 是否为 Pro 模式。父组件从 runtime.isPro 传入。
+ * 影响 limit:免费 5 / Pro 无上限。
+ */
+export declare function useWorkflows(isPro?: boolean): UseWorkflowsResult;
+//# sourceMappingURL=useWorkflows.d.ts.map

package/dist/hooks/useWorkflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflows.d.ts","sourceRoot":"","sources":["../../src/hooks/useWorkflows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAoC,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAMhG,kBAAkB;AAClB,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,QAAW,CAAC;AAE3C,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,0BAA0B;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,0BAA0B;IAC1B,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAAC;IAC7C,gBAAgB;IAChB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qCAAqC;IACrC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAClC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,0BAA0B;IAC1B,eAAe,IAAI,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,uBAAuB,CAAC,mBAAmB,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAChG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAC7D;AA4DD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,UAAQ,GAAG,kBAAkB,CAiL9D"}