agent-ide 0.8.1 → 0.9.0

package/dist/core/change-signature/signature-validator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Signature Validator
+ * 負責簽名變更的驗證邏輯
+ */
+import type { FunctionSignature, SignatureChange, ChangeSignatureValidationError } from './types.js';
+/**
+ * Signature Validator
+ * 驗證簽名變更的合法性
+ */
+export declare class SignatureValidator {
+    /**
+     * 驗證變更
+     */
+    validateChanges(signature: FunctionSignature, changes: readonly SignatureChange[]): ChangeSignatureValidationError[];
+    /**
+     * 驗證可選參數順序
+     * TypeScript 規則：可選參數必須在所有必選參數之後
+     * 例外：有預設值的參數視為可選，rest 參數必須在最後
+     */
+    validateOptionalParameterOrder(signature: FunctionSignature, newOrder: readonly (string | number)[]): ChangeSignatureValidationError | null;
+    /**
+     * 解析參數名稱
+     */
+    resolveParameterName(signature: FunctionSignature, nameOrIndex: string | number): string | undefined;
+}
+/**
+ * 建立 SignatureValidator 實例
+ */
+export declare function createSignatureValidator(): SignatureValidator;
+//# sourceMappingURL=signature-validator.d.ts.map

package/dist/core/change-signature/signature-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature-validator.d.ts","sourceRoot":"","sources":["../../../src/core/change-signature/signature-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAEjB,eAAe,EACf,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAapB;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,8BAA8B,EAAE;IA4FpH;;;;OAIG;IACH,8BAA8B,CAC5B,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACrC,8BAA8B,GAAG,IAAI;IAoCxC;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;CAMrG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}

package/dist/core/change-signature/signature-validator.js

@@ -0,0 +1,152 @@
+/**
+ * Signature Validator
+ * 負責簽名變更的驗證邏輯
+ */
+import { ChangeSignatureErrorCode, isAddParameterChange, isRemoveParameterChange, isReorderParametersChange, isChangeParameterTypeChange, isRenameParameterChange, isChangeDefaultValueChange, isToggleOptionalChange } from './types.js';
+import { resolveParameterIndex } from './utils.js';
+/**
+ * Signature Validator
+ * 驗證簽名變更的合法性
+ */
+export class SignatureValidator {
+    /**
+     * 驗證變更
+     */
+    validateChanges(signature, changes) {
+        const errors = [];
+        const parameterNames = new Set(signature.parameters.map(p => p.name));
+        const newParameterNames = new Set(parameterNames);
+        for (const change of changes) {
+            if (isAddParameterChange(change)) {
+                if (newParameterNames.has(change.name)) {
+                    errors.push({
+                        code: ChangeSignatureErrorCode.DuplicateParameterName,
+                        message: `參數名稱重複: ${change.name}`,
+                        parameterName: change.name
+                    });
+                }
+                else {
+                    newParameterNames.add(change.name);
+                }
+                // 驗證新增參數必須有預設值
+                if (!change.callSiteValue && !change.defaultValue) {
+                    errors.push({
+                        code: ChangeSignatureErrorCode.MissingDefaultValue,
+                        message: `參數 ${change.name} 缺少預設值，請使用 --default-value 或 --call-site-value 指定`,
+                        parameterName: change.name
+                    });
+                }
+            }
+            if (isRemoveParameterChange(change)) {
+                const targetName = this.resolveParameterName(signature, change.parameterNameOrIndex);
+                if (!targetName || !parameterNames.has(targetName)) {
+                    errors.push({
+                        code: ChangeSignatureErrorCode.ParameterNotFound,
+                        message: `找不到參數: ${change.parameterNameOrIndex}`,
+                        parameterName: String(change.parameterNameOrIndex)
+                    });
+                }
+                else {
+                    newParameterNames.delete(targetName);
+                }
+            }
+            if (isReorderParametersChange(change)) {
+                for (const nameOrIndex of change.newOrder) {
+                    const targetName = this.resolveParameterName(signature, nameOrIndex);
+                    if (!targetName || !parameterNames.has(targetName)) {
+                        errors.push({
+                            code: ChangeSignatureErrorCode.ParameterNotFound,
+                            message: `找不到參數: ${nameOrIndex}`,
+                            parameterName: String(nameOrIndex)
+                        });
+                    }
+                }
+                if (change.newOrder.length !== signature.parameters.length) {
+                    errors.push({
+                        code: ChangeSignatureErrorCode.InvalidParameterOrder,
+                        message: '重新排序必須包含所有參數'
+                    });
+                }
+                // 驗證可選參數順序：可選參數必須在必選參數之後
+                const optionalOrderError = this.validateOptionalParameterOrder(signature, change.newOrder);
+                if (optionalOrderError) {
+                    errors.push(optionalOrderError);
+                }
+            }
+            if (isChangeParameterTypeChange(change) || isRenameParameterChange(change) ||
+                isChangeDefaultValueChange(change) || isToggleOptionalChange(change)) {
+                const targetName = this.resolveParameterName(signature, change.parameterNameOrIndex);
+                if (!targetName || !parameterNames.has(targetName)) {
+                    errors.push({
+                        code: ChangeSignatureErrorCode.ParameterNotFound,
+                        message: `找不到參數: ${change.parameterNameOrIndex}`,
+                        parameterName: String(change.parameterNameOrIndex)
+                    });
+                }
+            }
+            if (isRenameParameterChange(change)) {
+                if (newParameterNames.has(change.newName) && change.newName !== this.resolveParameterName(signature, change.parameterNameOrIndex)) {
+                    errors.push({
+                        code: ChangeSignatureErrorCode.DuplicateParameterName,
+                        message: `參數名稱重複: ${change.newName}`,
+                        parameterName: change.newName
+                    });
+                }
+            }
+        }
+        return errors;
+    }
+    /**
+     * 驗證可選參數順序
+     * TypeScript 規則：可選參數必須在所有必選參數之後
+     * 例外：有預設值的參數視為可選，rest 參數必須在最後
+     */
+    validateOptionalParameterOrder(signature, newOrder) {
+        // 根據新順序建立參數列表
+        const reorderedParams = [];
+        for (const nameOrIndex of newOrder) {
+            const index = resolveParameterIndex(signature.parameters, nameOrIndex);
+            if (index >= 0) {
+                reorderedParams.push(signature.parameters[index]);
+            }
+        }
+        // 檢查可選參數是否在必選參數之前
+        let foundOptional = false;
+        let firstOptionalParam = null;
+        for (const param of reorderedParams) {
+            const isOptional = param.optional || param.defaultValue !== undefined;
+            const isRest = param.rest;
+            if (isOptional && !isRest) {
+                foundOptional = true;
+                if (!firstOptionalParam) {
+                    firstOptionalParam = param;
+                }
+            }
+            else if (!isOptional && !isRest && foundOptional) {
+                // 找到必選參數在可選參數之後
+                return {
+                    code: ChangeSignatureErrorCode.OptionalBeforeRequired,
+                    message: `可選參數 '${firstOptionalParam.name}' 不能位於必選參數 '${param.name}' 之前`,
+                    parameterName: param.name
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * 解析參數名稱
+     */
+    resolveParameterName(signature, nameOrIndex) {
+        if (typeof nameOrIndex === 'number') {
+            return signature.parameters[nameOrIndex]?.name;
+        }
+        return signature.parameters.find(p => p.name === nameOrIndex)?.name;
+    }
+}
+/**
+ * 建立 SignatureValidator 實例
+ */
+export function createSignatureValidator() {
+    return new SignatureValidator();
+}
+//# sourceMappingURL=signature-validator.js.map

package/dist/core/change-signature/signature-validator.js.map

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

package/dist/core/change-signature/utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Change Signature 共用工具函式
+ */
+import type { ParameterDefinition } from './types.js';
+/**
+ * 標記省略的可選參數
+ * 用於在參數映射過程中標記被省略的可選參數位置
+ */
+export declare const OMITTED_PARAMETER_MARKER = "\0OMITTED\0";
+/**
+ * 解析參數索引
+ * 根據名稱或索引找到參數在列表中的位置
+ *
+ * @param parameters - 參數定義列表
+ * @param nameOrIndex - 參數名稱或索引
+ * @returns 參數索引，找不到時返回 -1
+ */
+export declare function resolveParameterIndex(parameters: readonly Pick<ParameterDefinition, 'name'>[], nameOrIndex: string | number): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/change-signature/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/change-signature/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,gBAAgB,CAAC;AAEtD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,EAAE,EACxD,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,MAAM,CAKR"}

package/dist/core/change-signature/utils.js

@@ -0,0 +1,23 @@
+/**
+ * Change Signature 共用工具函式
+ */
+/**
+ * 標記省略的可選參數
+ * 用於在參數映射過程中標記被省略的可選參數位置
+ */
+export const OMITTED_PARAMETER_MARKER = '\0OMITTED\0';
+/**
+ * 解析參數索引
+ * 根據名稱或索引找到參數在列表中的位置
+ *
+ * @param parameters - 參數定義列表
+ * @param nameOrIndex - 參數名稱或索引
+ * @returns 參數索引，找不到時返回 -1
+ */
+export function resolveParameterIndex(parameters, nameOrIndex) {
+    if (typeof nameOrIndex === 'number') {
+        return nameOrIndex >= 0 && nameOrIndex < parameters.length ? nameOrIndex : -1;
+    }
+    return parameters.findIndex(p => p.name === nameOrIndex);
+}
+//# sourceMappingURL=utils.js.map

package/dist/core/change-signature/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/change-signature/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAwD,EACxD,WAA4B;IAE5B,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;AAC3D,CAAC"}

package/dist/core/cycles/cycle-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cycle-detector.d.ts","sourceRoot":"","sources":["../../../src/core/cycles/cycle-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAYpB;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,YAAY,CACV,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,kBAAkB,EAAE;IA+CvB;;;;OAIG;IACH,+BAA+B,CAAC,KAAK,EAAE,eAAe,GAAG,0BAA0B,EAAE;IAoErF;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IA4C7B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAyBhC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IAK1C;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe;IAgC3D;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,EAAE;CAgCzE"}
+{"version":3,"file":"cycle-detector.d.ts","sourceRoot":"","sources":["../../../src/core/cycles/cycle-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAYpB;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,YAAY,CACV,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,kBAAkB,EAAE;IA+CvB;;;;OAIG;IACH,+BAA+B,CAAC,KAAK,EAAE,eAAe,GAAG,0BAA0B,EAAE;IAoErF;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IA4C7B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAyBhC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IAK1C;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe;IA2C3D;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,EAAE;CAgCzE"}

package/dist/core/cycles/cycle-detector.js

@@ -2,7 +2,7 @@
  * 循環依賴檢測器
  * 使用 Tarjan 算法檢測強連通分量和循環依賴
  */
-import { calculateCycleSeverity } from './types.js';
+import { CycleSeverity, CyclePriority, calculateCycleSeverity } from './types.js';
 /**
  * 循環依賴檢測器類別
  */
@@ -246,7 +246,11 @@ export class CycleDetector {
                 totalCycles: 0,
                 averageCycleLength: 0,
                 maxCycleLength: 0,
-                cyclesBySeverity: { low: 0, medium: 0, high: 0 }
+                cyclesBySeverity: {
+                    [CycleSeverity.LOW]: 0,
+                    [CycleSeverity.MEDIUM]: 0,
+                    [CycleSeverity.HIGH]: 0
+                }
             };
         }
         const totalLength = cycles.reduce((sum, cycle) => sum + cycle.length, 0);
@@ -254,7 +258,11 @@ export class CycleDetector {
         const severityCount = cycles.reduce((acc, cycle) => {
             acc[cycle.severity]++;
             return acc;
-        }, { low: 0, medium: 0, high: 0 });
+        }, {
+            [CycleSeverity.LOW]: 0,
+            [CycleSeverity.MEDIUM]: 0,
+            [CycleSeverity.HIGH]: 0
+        });
         return {
             totalCycles: cycles.length,
             averageCycleLength: totalLength / cycles.length,
@@ -271,26 +279,26 @@ export class CycleDetector {
         return cycles.map(cycle => {
             let strategy = '';
             let description = '';
-            let priority = 'low';
+            let priority = CyclePriority.LOW;
             if (cycle.length === 1) {
                 strategy = 'remove_self_reference';
                 description = '移除自我引用，檢查是否真的需要';
-                priority = 'low';
+                priority = CyclePriority.LOW;
             }
             else if (cycle.length === 2) {
                 strategy = 'extract_common_dependency';
                 description = '提取共同依賴到第三個模組';
-                priority = cycle.severity === 'high' ? 'high' : 'medium';
+                priority = cycle.severity === CycleSeverity.HIGH ? CyclePriority.HIGH : CyclePriority.MEDIUM;
             }
             else if (cycle.length <= 5) {
                 strategy = 'dependency_inversion';
                 description = '使用依賴倒置原則，引入介面或抽象層';
-                priority = cycle.severity === 'high' ? 'high' : 'medium';
+                priority = cycle.severity === CycleSeverity.HIGH ? CyclePriority.HIGH : CyclePriority.MEDIUM;
             }
             else {
                 strategy = 'architectural_refactoring';
                 description = '需要重新設計架構，考慮拆分模組';
-                priority = 'high';
+                priority = CyclePriority.HIGH;
             }
             return {
                 cycle: [...cycle.cycle],

package/dist/core/cycles/cycle-detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"cycle-detector.js","sourceRoot":"","sources":["../../../src/core/cycles/cycle-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAWpD;;GAEG;AACH,MAAM,OAAO,aAAa;IACxB;;;;;OAKG;IACH,YAAY,CACV,KAAsB,EACtB,OAA+B;QAE/B,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE7C,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,2BAA2B,GAAG,IAAI,CAAC,+BAA+B,CAAC,KAAK,CAAC,CAAC;QAChF,MAAM,MAAM,GAAyB,EAAE,CAAC;QAExC,KAAK,MAAM,GAAG,IAAI,2BAA2B,EAAE,CAAC;YAC9C,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACnB,QAAQ;gBACR,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC1B,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;oBACpC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;wBAC1B,MAAM,CAAC,IAAI,CAAC;4BACV,KAAK,EAAE,CAAC,IAAI,CAAC;4BACb,MAAM,EAAE,CAAC;4BACT,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC;yBACpC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC3D,kBAAkB;gBAClB,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEnE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;oBACnC,IAAI,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;wBAC5C,MAAM,CAAC,IAAI,CAAC;4BACV,KAAK,EAAE,SAAS;4BAChB,MAAM,EAAE,SAAS,CAAC,MAAM;4BACxB,QAAQ,EAAE,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC;yBACnD,CAAC,CAAC;wBAEH,uBAAuB;wBACvB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;4BAC1B,MAAM;wBACR,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,+BAA+B,CAAC,KAAsB;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAsB,CAAC;QACjD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAiC,EAAE,CAAC;QAC9C,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE;YACrC,mBAAmB;YACnB,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;gBACnB,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,KAAK,EAAE,CAAC;YACR,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEjB,SAAS;YACT,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAErC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,eAAe;oBACf,aAAa,CAAC,GAAG,CAAC,CAAC;oBACnB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;oBACxC,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;oBAC3C,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;gBACzE,CAAC;qBAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;oBAC5B,sBAAsB;oBACtB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;oBACxC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;YAED,gBAAgB;YAChB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;YACxC,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;gBAC1C,MAAM,QAAQ,GAAa,EAAE,CAAC;gBAC9B,IAAI,WAAmB,CAAC;gBAExB,GAAG,CAAC;oBACF,WAAW,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;oBAC3B,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC;oBAClD,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;oBAC7B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC7B,CAAC,QAAQ,WAAW,KAAK,IAAI,EAAE;gBAE/B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC,IAAI,CAAC;wBACR,KAAK,EAAE,QAAQ;wBACf,IAAI,EAAE,QAAQ,CAAC,MAAM;wBACrB,eAAe,EAAE,IAAI,CAAC,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC;qBAChE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,wBAAwB;QACxB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,aAAa,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACK,mBAAmB,CAAC,KAAsB,EAAE,QAAkB;QACpE,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAElC,gBAAgB;QAChB,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;YACjC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrE,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,mBAAmB;gBACnB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACK,qBAAqB,CAC3B,KAAsB,EACtB,SAAiB,EACjB,QAAkB;QAElB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,KAAK,GAA4C,CAAC;gBACtD,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,CAAC,SAAS,CAAC;aAClB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAElC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM;YACR,CAAC;YACD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;YAE5B,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC5C,SAAS;YACX,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAElB,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAEhF,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;gBAC/B,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzC,OAAO;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,GAAG;wBACT,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC;qBACrB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACK,wBAAwB,CAAC,KAAsB,EAAE,UAAoB;QAC3E,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QAErC,cAAc;QACd,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACnE,UAAU,IAAI,YAAY,CAAC,MAAM,CAAC;QACpC,CAAC;QAED,SAAS;QACT,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3E,UAAU,IAAI,kBAAkB,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW;QAC5D,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CAAC,OAA+B;QACvD,OAAO;YACL,cAAc,EAAE,EAAE;YAClB,eAAe,EAAE,KAAK;YACtB,eAAe,EAAE,IAAI;YACrB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,KAAsB;QAC9B,MAAM,iBAAiB,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;QAClD,OAAO,iBAAiB,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,KAAsB;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE;YACtC,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,GAAG;YACnB,eAAe,EAAE,KAAK;SACvB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;gBACL,WAAW,EAAE,CAAC;gBACd,kBAAkB,EAAE,CAAC;gBACrB,cAAc,EAAE,CAAC;gBACjB,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;aACjD,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAEjE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACjD,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAEnC,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,kBAAkB,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM;YAC/C,cAAc,EAAE,SAAS;YACzB,gBAAgB,EAAE,aAAa;SAChC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAAC,MAA4B;QAC/C,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACxB,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,IAAI,WAAW,GAAG,EAAE,CAAC;YACrB,IAAI,QAAQ,GAA8B,KAAK,CAAC;YAEhD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,QAAQ,GAAG,uBAAuB,CAAC;gBACnC,WAAW,GAAG,iBAAiB,CAAC;gBAChC,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,QAAQ,GAAG,2BAA2B,CAAC;gBACvC,WAAW,GAAG,cAAc,CAAC;gBAC7B,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC3D,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBAC7B,QAAQ,GAAG,sBAAsB,CAAC;gBAClC,WAAW,GAAG,mBAAmB,CAAC;gBAClC,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,2BAA2B,CAAC;gBACvC,WAAW,GAAG,iBAAiB,CAAC;gBAChC,QAAQ,GAAG,MAAM,CAAC;YACpB,CAAC;YAED,OAAO;gBACL,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;gBACvB,QAAQ;gBACR,WAAW;gBACX,QAAQ;aACT,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"cycle-detector.js","sourceRoot":"","sources":["../../../src/core/cycles/cycle-detector.ts"],"names":[],"mappings":"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"}

package/dist/core/cycles/index.d.ts

@@ -4,7 +4,7 @@
 import { CycleDetector } from './cycle-detector.js';
 export { CycleDetector };
 export type { CircularDependency, StronglyConnectedComponent, CycleDetectionOptions, CycleDetectionResult, CycleStatistics, CycleFixSuggestion } from './types.js';
-export { createDefaultCycleDetectionOptions, calculateCycleSeverity, isCircularDependency } from './types.js';
+export { CycleSeverity, CyclePriority, createDefaultCycleDetectionOptions, calculateCycleSeverity, isCircularDependency } from './types.js';
 /**
  * 建立循環檢測器的便利函式
  * @returns 循環檢測器實例

package/dist/core/cycles/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/cycles/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,YAAY,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/cycles/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,YAAY,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,aAAa,EACb,kCAAkC,EAClC,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/core/cycles/index.js

@@ -3,7 +3,7 @@
  */
 import { CycleDetector } from './cycle-detector.js';
 export { CycleDetector };
-export { createDefaultCycleDetectionOptions, calculateCycleSeverity, isCircularDependency } from './types.js';
+export { CycleSeverity, CyclePriority, createDefaultCycleDetectionOptions, calculateCycleSeverity, isCircularDependency } from './types.js';
 /**
  * 建立循環檢測器的便利函式
  * @returns 循環檢測器實例

package/dist/core/cycles/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/cycles/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,CAAC;AAWzB,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/cycles/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,CAAC;AAWzB,OAAO,EACL,aAAa,EACb,aAAa,EACb,kCAAkC,EAClC,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC"}

package/dist/core/cycles/types.d.ts

@@ -1,13 +1,29 @@
 /**
  * 循環依賴檢測相關型別定義
  */
+/**
+ * 循環依賴嚴重程度
+ */
+export declare enum CycleSeverity {
+    LOW = "low",
+    MEDIUM = "medium",
+    HIGH = "high"
+}
+/**
+ * 循環修復優先級
+ */
+export declare enum CyclePriority {
+    HIGH = "high",
+    MEDIUM = "medium",
+    LOW = "low"
+}
 /**
  * 循環依賴資訊
  */
 export interface CircularDependency {
     readonly cycle: readonly string[];
     readonly length: number;
-    readonly severity: 'low' | 'medium' | 'high';
+    readonly severity: CycleSeverity;
 }
 /**
  * 強連通分量
@@ -41,7 +57,7 @@ export interface CycleStatistics {
     readonly totalCycles: number;
     readonly averageCycleLength: number;
     readonly maxCycleLength: number;
-    readonly cyclesBySeverity: Record<string, number>;
+    readonly cyclesBySeverity: Record<CycleSeverity, number>;
 }
 /**
  * 循環修復建議
@@ -50,7 +66,7 @@ export interface CycleFixSuggestion {
     readonly cycle: readonly string[];
     readonly strategy: string;
     readonly description: string;
-    readonly priority: 'high' | 'medium' | 'low';
+    readonly priority: CyclePriority;
 }
 /**
  * 建立預設循環檢測選項
@@ -59,7 +75,7 @@ export declare function createDefaultCycleDetectionOptions(): CycleDetectionOpti
 /**
  * 計算循環依賴嚴重程度
  */
-export declare function calculateCycleSeverity(cycleLength: number): 'low' | 'medium' | 'high';
+export declare function calculateCycleSeverity(cycleLength: number): CycleSeverity;
 /**
  * CircularDependency 型別守衛
  */

package/dist/core/cycles/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/cycles/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,QAAQ,CAAC,2BAA2B,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC5E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,kCAAkC,IAAI,qBAAqB,CAM1E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAQrF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAgBhF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/cycles/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,QAAQ,CAAC,2BAA2B,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC5E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,kCAAkC,IAAI,qBAAqB,CAM1E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAQzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAgBhF"}

package/dist/core/cycles/types.js

@@ -1,6 +1,24 @@
 /**
  * 循環依賴檢測相關型別定義
  */
+/**
+ * 循環依賴嚴重程度
+ */
+export var CycleSeverity;
+(function (CycleSeverity) {
+    CycleSeverity["LOW"] = "low";
+    CycleSeverity["MEDIUM"] = "medium";
+    CycleSeverity["HIGH"] = "high";
+})(CycleSeverity || (CycleSeverity = {}));
+/**
+ * 循環修復優先級
+ */
+export var CyclePriority;
+(function (CyclePriority) {
+    CyclePriority["HIGH"] = "high";
+    CyclePriority["MEDIUM"] = "medium";
+    CyclePriority["LOW"] = "low";
+})(CyclePriority || (CyclePriority = {}));
 /**
  * 建立預設循環檢測選項
  */
@@ -16,12 +34,12 @@ export function createDefaultCycleDetectionOptions() {
  */
 export function calculateCycleSeverity(cycleLength) {
     if (cycleLength <= 3) {
-        return 'low';
+        return CycleSeverity.LOW;
     }
     if (cycleLength <= 6) {
-        return 'medium';
+        return CycleSeverity.MEDIUM;
     }
-    return 'high';
+    return CycleSeverity.HIGH;
 }
 /**
  * CircularDependency 型別守衛
@@ -31,7 +49,7 @@ export function isCircularDependency(value) {
         return false;
     }
     const obj = value;
-    const validSeverities = ['low', 'medium', 'high'];
+    const validSeverities = Object.values(CycleSeverity);
     return (Array.isArray(obj.cycle) &&
         obj.cycle.length >= 1 &&
         obj.cycle.every((item) => typeof item === 'string') &&

package/dist/core/cycles/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/cycles/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2DH;;GAEG;AACH,MAAM,UAAU,kCAAkC;IAChD,OAAO;QACL,cAAc,EAAE,EAAE;QAClB,eAAe,EAAE,KAAK;QACtB,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAElD,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QACxB,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC;QACrB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QAC5D,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,GAAG,CAAC,MAAM,IAAI,CAAC;QACf,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAkB,CAAC,CACjD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/cycles/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,kCAAiB,CAAA;IACjB,8BAAa,CAAA;AACf,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,4BAAW,CAAA;AACb,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AA2DD;;GAEG;AACH,MAAM,UAAU,kCAAkC;IAChD,OAAO;QACL,cAAc,EAAE,EAAE;QAClB,eAAe,EAAE,KAAK;QACtB,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,aAAa,CAAC,GAAG,CAAC;IAC3B,CAAC;IACD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,aAAa,CAAC,MAAM,CAAC;IAC9B,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAa,CAAC;IAEjE,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QACxB,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC;QACrB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QAC5D,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,GAAG,CAAC,MAAM,IAAI,CAAC;QACf,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAkB,CAAC,CACjD,CAAC;AACJ,CAAC"}

package/dist/core/deadcode/dead-code-detector.d.ts

@@ -20,13 +20,21 @@ export declare class DeadCodeDetector {
      */
     detect(): Promise<DeadCodeDetectionResult>;
     /**
-       * 收集所有符號
+       * 收集所有符號（優先使用 IndexEngine 快取）
        */
     private collectAllSymbols;
     /**
      * 判斷是否應排除
      */
     private shouldExclude;
+    /**
+     * 判斷符號是否為函式內部的變數或參數
+     * 函式參數、arrow function 回呼參數、for 迴圈變數等不應被 deadcode 檢測
+     *
+     * 注意：此方法遍歷 scope 鏈確認變數是否在 function scope 內，
+     * 避免誤過濾模組層級的 block scope 變數（如 if 區塊內的變數）
+     */
+    private isFunctionLocalVariable;
     /**
      * 判斷符號是否為 interface 或 type 的屬性
      * Interface/Type 的屬性是型別定義的一部分，不應被獨立檢測為 dead code
@@ -65,6 +73,19 @@ export declare class DeadCodeDetector {
      * 檢查 class 是否有任何成員被使用
      */
     private hasAnyUsedMember;
+    /**
+     * 判斷符號是否為 class member（方法或屬性）
+     * - 方法：scope.parent.type === 'class'
+     * - 屬性：scope.type === 'class' && symbol.type !== 'class'
+     *
+     * 注意：class 本身不算 "class member"，只有 method/property 才算
+     */
+    private isClassMember;
+    /**
+     * 取得 class member 的父 class 名稱
+     * @returns 父 class 名稱，若不是 class member 則返回 null
+     */
+    private getParentClassName;
 }
 /**
  * 建立 DeadCodeDetector 實例

package/dist/core/deadcode/dead-code-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dead-code-detector.d.ts","sourceRoot":"","sources":["../../../src/core/deadcode/dead-code-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAEV,uBAAuB,EACvB,uBAAuB,EAExB,MAAM,YAAY,CAAC;AAgBpB;;GAEG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;gBAGzC,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,WAAW,EACxC,OAAO,CAAC,EAAE,uBAAuB;IAKnC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,uBAAuB,CAAC;IA4IlD;;SAEK;YACW,iBAAiB;IA2B/B;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAMjC;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;YACW,QAAQ;IAStB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA6B5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAazB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,WAAW,EACvB,OAAO,CAAC,EAAE,uBAAuB,GAChC,gBAAgB,CAElB"}
+{"version":3,"file":"dead-code-detector.d.ts","sourceRoot":"","sources":["../../../src/core/deadcode/dead-code-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAOlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAEV,uBAAuB,EACvB,uBAAuB,EAExB,MAAM,YAAY,CAAC;AAmCpB;;GAEG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;gBAGzC,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,WAAW,EACxC,OAAO,CAAC,EAAE,uBAAuB;IAKnC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAsIlD;;SAEK;YACW,iBAAiB;IA2D/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAoCrB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAMjC;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;YACW,QAAQ;IAStB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAOrB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAS3B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,WAAW,EACvB,OAAO,CAAC,EAAE,uBAAuB,GAChC,gBAAgB,CAElB"}