agent-ide 0.1.0

package/dist/shared/types/symbol.js

@@ -0,0 +1,197 @@
+/**
+ * Symbol 相關型別定義
+ * 包含 SymbolType、Symbol、Reference、Dependency 等型別
+ */
+/**
+ * Symbol 類型列舉
+ */
+export var SymbolType;
+(function (SymbolType) {
+    SymbolType["Class"] = "class";
+    SymbolType["Interface"] = "interface";
+    SymbolType["Function"] = "function";
+    SymbolType["Variable"] = "variable";
+    SymbolType["Constant"] = "constant";
+    SymbolType["Type"] = "type";
+    SymbolType["Enum"] = "enum";
+    SymbolType["Module"] = "module";
+    SymbolType["Namespace"] = "namespace";
+})(SymbolType || (SymbolType = {}));
+/**
+ * Reference 類型列舉
+ */
+export var ReferenceType;
+(function (ReferenceType) {
+    ReferenceType["Definition"] = "definition";
+    ReferenceType["Usage"] = "usage";
+    ReferenceType["Declaration"] = "declaration";
+})(ReferenceType || (ReferenceType = {}));
+/**
+ * Dependency 類型列舉
+ */
+export var DependencyType;
+(function (DependencyType) {
+    DependencyType["Import"] = "import";
+    DependencyType["Require"] = "require";
+    DependencyType["Include"] = "include";
+})(DependencyType || (DependencyType = {}));
+/**
+ * 建立 Scope 的工廠函式
+ */
+export function createScope(type, name, parent) {
+    const validTypes = ['global', 'module', 'namespace', 'class', 'function', 'block'];
+    if (!validTypes.includes(type)) {
+        throw new Error('無效的 scope 類型');
+    }
+    return {
+        type,
+        name: name || undefined,
+        parent: parent || undefined
+    };
+}
+/**
+ * 建立 Symbol 的工廠函式
+ */
+export function createSymbol(name, type, location, scope, modifiers = []) {
+    if (!name.trim()) {
+        throw new Error('Symbol 名稱不能為空');
+    }
+    // 檢查 modifiers 是否有重複
+    const uniqueModifiers = new Set(modifiers);
+    if (uniqueModifiers.size !== modifiers.length) {
+        throw new Error('Modifiers 不能重複');
+    }
+    return {
+        name,
+        type,
+        location,
+        scope: scope || undefined,
+        modifiers: [...modifiers]
+    };
+}
+/**
+ * 建立 Reference 的工廠函式
+ */
+export function createReference(symbol, location, type) {
+    return {
+        symbol,
+        location,
+        type
+    };
+}
+/**
+ * 建立 Dependency 的工廠函式
+ */
+export function createDependency(path, type, isRelative, importedSymbols = []) {
+    if (!path.trim()) {
+        throw new Error('Dependency 路徑不能為空');
+    }
+    // 檢查 importedSymbols 是否有重複
+    const uniqueSymbols = new Set(importedSymbols);
+    if (uniqueSymbols.size !== importedSymbols.length) {
+        throw new Error('ImportedSymbols 不能重複');
+    }
+    return {
+        path,
+        type,
+        isRelative,
+        importedSymbols: [...importedSymbols]
+    };
+}
+/**
+ * Scope 型別守衛
+ */
+export function isScope(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    const validTypes = ['global', 'module', 'namespace', 'class', 'function', 'block'];
+    return (typeof obj.type === 'string' &&
+        validTypes.includes(obj.type) &&
+        (obj.name === undefined || typeof obj.name === 'string') &&
+        (obj.parent === undefined || isScope(obj.parent)));
+}
+/**
+ * Symbol 型別守衛
+ */
+export function isSymbol(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.name === 'string' &&
+        obj.name.trim().length > 0 &&
+        Object.values(SymbolType).includes(obj.type) &&
+        obj.location && typeof obj.location === 'object' &&
+        (obj.scope === undefined || isScope(obj.scope)) &&
+        Array.isArray(obj.modifiers));
+}
+/**
+ * Reference 型別守衛
+ */
+export function isReference(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (isSymbol(obj.symbol) &&
+        obj.location && typeof obj.location === 'object' &&
+        Object.values(ReferenceType).includes(obj.type));
+}
+/**
+ * Dependency 型別守衛
+ */
+export function isDependency(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.path === 'string' &&
+        obj.path.trim().length > 0 &&
+        Object.values(DependencyType).includes(obj.type) &&
+        typeof obj.isRelative === 'boolean' &&
+        Array.isArray(obj.importedSymbols));
+}
+/**
+ * 計算 Scope 的深度
+ */
+export function getScopeDepth(scope) {
+    let depth = 0;
+    let currentScope = scope;
+    while (currentScope?.parent) {
+        depth++;
+        currentScope = currentScope.parent;
+    }
+    return depth;
+}
+/**
+ * 檢查兩個 Symbol 是否在同一 Scope
+ */
+export function isSameScope(symbol1, symbol2) {
+    if (!symbol1.scope && !symbol2.scope) {
+        return true; // 都沒有 scope，視為相同
+    }
+    if (!symbol1.scope || !symbol2.scope) {
+        return false; // 一個有 scope，一個沒有，不相同
+    }
+    return symbol1.scope === symbol2.scope;
+}
+/**
+ * 取得 Scope 的完整路徑
+ */
+export function getScopePath(scope) {
+    const path = [];
+    let currentScope = scope;
+    while (currentScope) {
+        if (currentScope.name) {
+            path.unshift(currentScope.name);
+        }
+        else {
+            path.unshift(currentScope.type);
+        }
+        currentScope = currentScope.parent;
+    }
+    return path;
+}
+//# sourceMappingURL=symbol.js.map

package/dist/shared/types/symbol.js.map

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

package/dist/shared/utils/array.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 將陣列分割成指定大小的塊
+ * @param array 待分割的陣列
+ * @param size 每個塊的大小
+ * @returns 分割後的陣列
+ */
+export declare function chunk<T>(array: T[], size: number): T[][];
+/**
+ * 扁平化陣列，支援多層巢狀
+ * @param array 待扁平化的陣列
+ * @returns 扁平化後的陣列
+ */
+export declare function flatten<T = any>(array: any[]): T[];
+/**
+ * 移除陣列中的重複元素
+ * @param array 待去重的陣列
+ * @param keyFn 可選的鍵值提取函式
+ * @returns 去重後的陣列
+ */
+export declare function unique<T, K = T>(array: T[], keyFn?: (item: T) => K): T[];
+/**
+ * 計算兩個陣列的差集
+ * @param array1 第一個陣列
+ * @param array2 第二個陣列
+ * @returns array1 中不在 array2 中的元素
+ */
+export declare function difference<T>(array1: T[], array2: T[]): T[];
+/**
+ * 計算兩個陣列的交集
+ * @param array1 第一個陣列
+ * @param array2 第二個陣列
+ * @returns 兩個陣列共同的元素
+ */
+export declare function intersection<T>(array1: T[], array2: T[]): T[];
+/**
+ * 根據條件將陣列分為兩部分
+ * @param array 待分區的陣列
+ * @param predicate 判斷條件
+ * @returns [符合條件的元素, 不符合條件的元素]
+ */
+export declare function partition<T>(array: T[], predicate: (item: T) => boolean): [T[], T[]];
+/**
+ * 根據鍵值函式對陣列進行分組
+ * @param array 待分組的陣列
+ * @param keyFn 鍵值提取函式
+ * @returns 分組後的物件
+ */
+export declare function groupBy<T, K extends string | number | symbol>(array: T[], keyFn: (item: T) => K): Record<K, T[]>;
+/**
+ * 根據回調函式的返回值對陣列進行排序
+ * @param array 待排序的陣列
+ * @param keyFn 排序鍵值提取函式
+ * @returns 排序後的新陣列
+ */
+export declare function sortBy<T, K>(array: T[], keyFn: (item: T) => K): T[];
+/**
+ * 洗牌陣列（Fisher-Yates shuffle）
+ * @param array 待洗牌的陣列
+ * @returns 洗牌後的新陣列
+ */
+export declare function shuffle<T>(array: T[]): T[];
+/**
+ * 移除陣列中的假值（false、null、0、""、undefined、NaN）
+ * @param array 待處理的陣列
+ * @returns 移除假值後的陣列
+ */
+export declare function compact<T>(array: T[]): NonNullable<T>[];
+//# sourceMappingURL=array.d.ts.map

package/dist/shared/utils/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/array.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAYlD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAmBxE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAM3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAK7D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAapF;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAC3D,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GACpB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAYhB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CASnE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAS1C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAIvD"}

package/dist/shared/utils/array.js

@@ -0,0 +1,165 @@
+/**
+ * 將陣列分割成指定大小的塊
+ * @param array 待分割的陣列
+ * @param size 每個塊的大小
+ * @returns 分割後的陣列
+ */
+export function chunk(array, size) {
+    if (!array.length || size <= 0) {
+        return [];
+    }
+    const result = [];
+    for (let i = 0; i < array.length; i += size) {
+        result.push(array.slice(i, i + size));
+    }
+    return result;
+}
+/**
+ * 扁平化陣列，支援多層巢狀
+ * @param array 待扁平化的陣列
+ * @returns 扁平化後的陣列
+ */
+export function flatten(array) {
+    const result = [];
+    for (const item of array) {
+        if (Array.isArray(item)) {
+            result.push(...flatten(item));
+        }
+        else {
+            result.push(item);
+        }
+    }
+    return result;
+}
+/**
+ * 移除陣列中的重複元素
+ * @param array 待去重的陣列
+ * @param keyFn 可選的鍵值提取函式
+ * @returns 去重後的陣列
+ */
+export function unique(array, keyFn) {
+    if (!array.length) {
+        return [];
+    }
+    if (!keyFn) {
+        return Array.from(new Set(array));
+    }
+    const seen = new Set();
+    const result = [];
+    for (const item of array) {
+        const key = keyFn(item);
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(item);
+        }
+    }
+    return result;
+}
+/**
+ * 計算兩個陣列的差集
+ * @param array1 第一個陣列
+ * @param array2 第二個陣列
+ * @returns array1 中不在 array2 中的元素
+ */
+export function difference(array1, array2) {
+    if (!array1.length) {
+        return [];
+    }
+    if (!array2.length) {
+        return [...array1];
+    }
+    const set2 = new Set(array2);
+    return array1.filter(item => !set2.has(item));
+}
+/**
+ * 計算兩個陣列的交集
+ * @param array1 第一個陣列
+ * @param array2 第二個陣列
+ * @returns 兩個陣列共同的元素
+ */
+export function intersection(array1, array2) {
+    if (!array1.length || !array2.length) {
+        return [];
+    }
+    const set2 = new Set(array2);
+    return array1.filter(item => set2.has(item));
+}
+/**
+ * 根據條件將陣列分為兩部分
+ * @param array 待分區的陣列
+ * @param predicate 判斷條件
+ * @returns [符合條件的元素, 不符合條件的元素]
+ */
+export function partition(array, predicate) {
+    const truthy = [];
+    const falsy = [];
+    for (const item of array) {
+        if (predicate(item)) {
+            truthy.push(item);
+        }
+        else {
+            falsy.push(item);
+        }
+    }
+    return [truthy, falsy];
+}
+/**
+ * 根據鍵值函式對陣列進行分組
+ * @param array 待分組的陣列
+ * @param keyFn 鍵值提取函式
+ * @returns 分組後的物件
+ */
+export function groupBy(array, keyFn) {
+    const result = {};
+    for (const item of array) {
+        const key = keyFn(item);
+        if (!result[key]) {
+            result[key] = [];
+        }
+        result[key].push(item);
+    }
+    return result;
+}
+/**
+ * 根據回調函式的返回值對陣列進行排序
+ * @param array 待排序的陣列
+ * @param keyFn 排序鍵值提取函式
+ * @returns 排序後的新陣列
+ */
+export function sortBy(array, keyFn) {
+    return [...array].sort((a, b) => {
+        const keyA = keyFn(a);
+        const keyB = keyFn(b);
+        if (keyA < keyB) {
+            return -1;
+        }
+        if (keyA > keyB) {
+            return 1;
+        }
+        return 0;
+    });
+}
+/**
+ * 洗牌陣列（Fisher-Yates shuffle）
+ * @param array 待洗牌的陣列
+ * @returns 洗牌後的新陣列
+ */
+export function shuffle(array) {
+    const result = [...array];
+    for (let i = result.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [result[i], result[j]] = [result[j], result[i]];
+    }
+    return result;
+}
+/**
+ * 移除陣列中的假值（false、null、0、""、undefined、NaN）
+ * @param array 待處理的陣列
+ * @returns 移除假值後的陣列
+ */
+export function compact(array) {
+    return array.filter((item) => {
+        return Boolean(item) && !Number.isNaN(item);
+    });
+}
+//# sourceMappingURL=array.js.map

package/dist/shared/utils/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../../src/shared/utils/array.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAI,KAAU,EAAE,IAAY;IAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QAAA,OAAO,EAAE,CAAC;IAAA,CAAC;IAE5C,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAU,KAAY;IAC3C,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAI,IAAI,CAAC,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAW,KAAU,EAAE,KAAsB;IACjE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAAA,OAAO,EAAE,CAAC;IAAA,CAAC;IAE/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAK,CAAC;IAC1B,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAI,MAAW,EAAE,MAAW;IACpD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAAA,OAAO,EAAE,CAAC;IAAA,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAAA,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IAAA,CAAC;IAEzC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAI,MAAW,EAAE,MAAW;IACtD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAAA,OAAO,EAAE,CAAC;IAAA,CAAC;IAElD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAI,KAAU,EAAE,SAA+B;IACtE,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,MAAM,KAAK,GAAQ,EAAE,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,KAAU,EACV,KAAqB;IAErB,MAAM,MAAM,GAAG,EAAoB,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAO,KAAU,EAAE,KAAqB;IAC5D,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAAA,OAAO,CAAC,CAAC,CAAC;QAAA,CAAC;QAC7B,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAAA,OAAO,CAAC,CAAC;QAAA,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAI,KAAU;IACnC,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAE1B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAI,KAAU;IACnC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAA0B,EAAE;QACnD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/utils/async.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 延遲執行指定毫秒數
+ * @param ms 延遲時間（毫秒）
+ * @returns Promise
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * 重試選項介面
+ */
+interface RetryOptions {
+    maxAttempts: number;
+    delay?: number;
+    exponentialBackoff?: boolean;
+    shouldRetry?: (error: any) => boolean;
+}
+/**
+ * 重試執行異步函式
+ * @param fn 要重試的函式
+ * @param options 重試選項
+ * @returns 函式執行結果
+ */
+export declare function retry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+/**
+ * 為 Promise 添加超時控制
+ * @param promise 要控制的 Promise
+ * @param ms 超時時間（毫秒）
+ * @param errorMessage 超時錯誤訊息
+ * @returns 帶超時控制的 Promise
+ */
+export declare function timeout<T>(promise: Promise<T>, ms: number, errorMessage?: string): Promise<T>;
+/**
+ * 防抖函式
+ * @param fn 要防抖的函式
+ * @param delay 延遲時間（毫秒）
+ * @param immediate 是否立即執行
+ * @returns 防抖後的函式
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, delay: number, immediate?: boolean): (...args: Parameters<T>) => void;
+/**
+ * 節流函式
+ * @param fn 要節流的函式
+ * @param delay 節流間隔（毫秒）
+ * @returns 節流後的函式
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * 並行執行多個異步任務
+ * @param tasks 任務陣列
+ * @returns 所有任務的結果
+ */
+export declare function parallel<T>(tasks: (() => Promise<T>)[]): Promise<T[]>;
+/**
+ * 順序執行多個異步任務
+ * @param tasks 任務陣列
+ * @returns 所有任務的結果
+ */
+export declare function sequential<T>(tasks: (() => Promise<T>)[]): Promise<T[]>;
+/**
+ * 競速執行多個異步任務，返回最先完成的結果
+ * @param tasks 任務陣列
+ * @returns 最先完成的任務結果
+ */
+export declare function race<T>(tasks: (() => Promise<T>)[]): Promise<T | undefined>;
+/**
+ * 限制並行數量的佇列執行
+ * @param tasks 任務陣列
+ * @param concurrency 最大並行數量
+ * @returns 所有任務的結果
+ */
+export declare function queue<T>(tasks: (() => Promise<T>)[], concurrency?: number): Promise<T[]>;
+/**
+ * 批次處理選項
+ */
+interface BatchOptions {
+    batchSize: number;
+    concurrency?: number;
+}
+/**
+ * 分批處理陣列項目
+ * @param items 要處理的項目陣列
+ * @param processor 批次處理函式
+ * @param options 批次處理選項
+ * @returns 處理後的結果陣列
+ */
+export declare function batch<T, R>(items: T[], processor: (batch: T[]) => Promise<R[]>, options: BatchOptions): Promise<R[]>;
+export {};
+//# sourceMappingURL=async.d.ts.map

package/dist/shared/utils/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/async.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;CACvC;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CA4BZ;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,EACb,SAAS,UAAQ,GAChB,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAwBlC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAWlC;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAK3E;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAS7E;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAKjF;AASD;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC3B,WAAW,SAAI,GACd,OAAO,CAAC,CAAC,EAAE,CAAC,CAsBd;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAAE,CAAC,EAC9B,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,EACvC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,EAAE,CAAC,CAmBd"}