arkanalyzer 1.0.86 → 1.0.88

package/lib/utils/CxxSceneUtils.js

@@ -0,0 +1,178 @@
+"use strict";
+/*
+ * Copyright (c) 2024-2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CxxSceneUtils = void 0;
+const path_1 = __importDefault(require("path"));
+const ArkSignature_1 = require("../core/model/ArkSignature");
+const ModelUtils_1 = require("../core/common/ModelUtils");
+const Stmt_1 = require("../core/base/Stmt");
+const ArkMethod_1 = require("../core/model/ArkMethod");
+const Constant_1 = require("../core/base/Constant");
+const Local_1 = require("../core/base/Local");
+const Ref_1 = require("../core/base/Ref");
+const ArkField_1 = require("../core/model/ArkField");
+const Type_1 = require("../core/base/Type");
+const TSConst_1 = require("../core/common/TSConst");
+const logger_1 = __importStar(require("./logger"));
+const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER, 'ArkValueTransformer');
+class CxxSceneUtils {
+    static puncture(cxxModulePath, tsFile) {
+        var _a;
+        const fileName = path_1.default.relative(tsFile.getProjectDir(), path_1.default.join(cxxModulePath, '../../napi_init.cpp'));
+        const initFile = tsFile.getScene().getFile(new ArkSignature_1.FileSignature(tsFile.getProjectName(), fileName));
+        if (!initFile) {
+            return;
+        }
+        const ts2cxxFuncMap = initFile.getDefaultClass().getTs2cxxFuncMap();
+        const methods = ModelUtils_1.ModelUtils.getAllMethodsInFile(initFile);
+        for (const method of methods) {
+            const stmts = (_a = method.getCfg()) === null || _a === void 0 ? void 0 : _a.getStmts();
+            if (!stmts) {
+                continue;
+            }
+            for (const stmt of stmts) {
+                if (stmt instanceof Stmt_1.ArkInvokeStmt) {
+                    this.processApiDefine(stmt, tsFile, ts2cxxFuncMap);
+                }
+            }
+        }
+    }
+    static processApiDefine(stmt, tsFile, ts2cxxFuncMap) {
+        const invokeExpr = stmt.getInvokeExpr();
+        const methodName = invokeExpr.getMethodSignature().getMethodSubSignature().getMethodName();
+        const clsConstant = invokeExpr.getArg(1);
+        if (methodName === 'napi_define_class' && clsConstant instanceof Constant_1.Constant) {
+            const tsClass = tsFile.getClassWithName(clsConstant.getValue());
+            if (!tsClass) {
+                return;
+            }
+            const props = invokeExpr.getArg(6);
+            this.findPropDesc(props, ts2cxxFuncMap, tsClass);
+            const arkMethods = ts2cxxFuncMap.get(clsConstant.getValue());
+            if ((arkMethods === null || arkMethods === void 0 ? void 0 : arkMethods.length) === 1) {
+                this.mergeMethod(TSConst_1.CONSTRUCTOR_NAME, tsClass, arkMethods[0]);
+            }
+        }
+        else if (methodName === 'napi_define_properties') {
+            const tsClass = tsFile.getDefaultClass();
+            const props = invokeExpr.getArg(3);
+            this.findPropDesc(props, ts2cxxFuncMap, tsClass);
+        }
+    }
+    static findPropDesc(props, ts2cxxFuncMap, tsClass) {
+        var _a, _b;
+        (_b = this.getUsedStmts((_a = this.getDeclaredAssignStmt(props)) === null || _a === void 0 ? void 0 : _a.getRightOp())) === null || _b === void 0 ? void 0 : _b.forEach(x => {
+            var _a;
+            if (x instanceof Stmt_1.ArkAssignStmt && x.getLeftOp() instanceof Ref_1.ArkArrayRef) {
+                (_a = this.getUsedStmts(x.getRightOp())) === null || _a === void 0 ? void 0 : _a.forEach(s => {
+                    this.processPropDesc(s, ts2cxxFuncMap, tsClass);
+                });
+            }
+        });
+    }
+    static processPropDesc(s, ts2cxxFuncMap, tsClass) {
+        let constant;
+        if (s instanceof Stmt_1.ArkInvokeStmt) {
+            // This scenario corresponds to the registration of class objects
+            constant = s.getInvokeExpr().getArg(0);
+        }
+        else if (s instanceof Stmt_1.ArkAssignStmt && s.getLeftOp() instanceof Ref_1.ArkArrayRef) {
+            // The registration scenario is a structure aggregation scenario, where the syntax tree does not contain a construct,
+            // and each unit is expressed using an aggregation expression
+            let rightOp = s.getRightOp();
+            if (rightOp.getName().startsWith('%')) {
+                const declaringStmt = rightOp.getDeclaringStmt();
+                if (declaringStmt instanceof Stmt_1.ArkAssignStmt) {
+                    rightOp = declaringStmt.getRightOp();
+                }
+            }
+            try {
+                // Due to the order of type definitions, type judgment cannot be performed here,
+                // so try+assertion is used to avoid runtime errors
+                constant = rightOp.getElements()[0];
+            }
+            catch (e) {
+                logger.info('This is Unknow scene');
+            }
+        }
+        if (constant instanceof Constant_1.Constant) {
+            const tsMtdName = constant.getValue();
+            const arkMethods = ts2cxxFuncMap.get(tsMtdName);
+            if ((arkMethods === null || arkMethods === void 0 ? void 0 : arkMethods.length) === 1) {
+                this.mergeMethod(tsMtdName, tsClass, arkMethods[0]);
+            }
+            else if ((arkMethods === null || arkMethods === void 0 ? void 0 : arkMethods.length) === 2) {
+                this.mergeMethod('Get-' + tsMtdName, tsClass, arkMethods[0]);
+                this.mergeMethod('Set-' + tsMtdName, tsClass, arkMethods[1]);
+            }
+        }
+    }
+    static getDeclaredAssignStmt(value) {
+        if (value instanceof Local_1.Local) {
+            const declaringStmt = value.getDeclaringStmt();
+            if (declaringStmt instanceof Stmt_1.ArkAssignStmt) {
+                return declaringStmt;
+            }
+        }
+        return undefined;
+    }
+    static getUsedStmts(value) {
+        if (value instanceof Local_1.Local) {
+            return value.getUsedStmts();
+        }
+        return undefined;
+    }
+    static mergeMethod(tsMtdName, tsClass, cppMtd) {
+        let tsMtd = ModelUtils_1.ModelUtils.findArkModel(tsMtdName, tsClass);
+        if (tsMtd instanceof Local_1.Local || tsMtd instanceof ArkField_1.ArkField) {
+            const type = tsMtd.getType();
+            if (type instanceof Type_1.FunctionType) {
+                tsMtd = tsClass.getDeclaringArkFile().getScene().getMethod(type.getMethodSignature());
+            }
+        }
+        if (tsMtd instanceof ArkMethod_1.ArkMethod && cppMtd.getBody()) {
+            tsMtd.setImplementationSignature(cppMtd.getSignature());
+            tsMtd.setBody(cppMtd.getBody());
+        }
+    }
+}
+exports.CxxSceneUtils = CxxSceneUtils;

package/lib/utils/FileUtils.d.ts

@@ -7,15 +7,15 @@ export declare class FileUtils {
     static getIndexFileName(srcPath: string): string;
     static isDirectory(srcPath: string): boolean;
     static isAbsolutePath(path: string): boolean;
-    static generateModuleMap(ohPkgContentMap: Map<string, {
-        [k: string]: unknown;
-    }>): Map<string, ModulePath>;
     static getFileLanguage(file: string, fileTags?: Map<string, Language>): Language;
 }
-export declare class ModulePath {
-    path: string;
-    main: string;
-    constructor(path: string, main: string);
-}
 export declare function getFileRecursively(srcDir: string, fileName: string, visited?: Set<string>): string;
+/**
+ * Try to combine each source path in the array with the relative path, returning the first absolute path that exists.
+ * @param srcPathList Source path array (absolute or relative paths)
+ * @param relativePath The relative path to concatenate
+ * @returns The first concatenated absolute path that exists; otherwise returns an empty string
+ */
+export declare function getFileAbsPath(srcPathList: string[], relativePath: string): string;
+export declare function getFileSignatureMapKey(projectName: string, fileName: string): string;
 //# sourceMappingURL=FileUtils.d.ts.map

package/lib/utils/FileUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileUtils.d.ts","sourceRoot":"","sources":["../../src/utils/FileUtils.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIjD,qBAAa,SAAS;IAClB,gBAAuB,WAAW;;;MAGhC;WAEY,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;WASzC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;WAUrC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;WAIrC,iBAAiB,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;WAkClG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,QAAQ;CAgB1F;AAED,qBAAa,UAAU;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;gBAED,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAIzC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,GAAG,CAAC,MAAM,CAAqB,GAAG,MAAM,CA2BrH"}
+{"version":3,"file":"FileUtils.d.ts","sourceRoot":"","sources":["../../src/utils/FileUtils.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AASjD,qBAAa,SAAS;IAClB,gBAAuB,WAAW;;;MAGhC;WAEY,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;WASzC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;WAUrC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;WAIrC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,QAAQ;CAmB1F;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,GAAG,CAAC,MAAM,CAAqB,GAAG,MAAM,CA2BrH;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAclF;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIpF"}

package/lib/utils/FileUtils.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright (c) 2024-2025 Huawei Device Co., Ltd.
+ * Copyright (c) 2024-2026 Huawei Device Co., Ltd.
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
@@ -40,14 +40,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFileRecursively = exports.ModulePath = exports.FileUtils = void 0;
+exports.getFileSignatureMapKey = exports.getFileAbsPath = exports.getFileRecursively = exports.FileUtils = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const logger_1 = __importStar(require("./logger"));
-const pathTransfer_1 = require("./pathTransfer");
-const EtsConst_1 = require("../core/common/EtsConst");
 const ArkFile_1 = require("../core/model/ArkFile");
+const ast_1 = require("../frontend/cppFrontend/ast");
+const crypto_utils_1 = require("./crypto_utils");
+const pathTransfer_1 = require("./pathTransfer");
 const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER, 'FileUtils');
+const CXX_EXTENSION_SET = (0, ast_1.getCxxSourceFileExtensionSet)();
 class FileUtils {
     static getIndexFileName(srcPath) {
         for (const fileInDir of fs_1.default.readdirSync(srcPath, { withFileTypes: true })) {
@@ -70,40 +72,6 @@ class FileUtils {
     static isAbsolutePath(path) {
         return /^(\/|\\|[A-Z]:\\)/.test(path);
     }
-    static generateModuleMap(ohPkgContentMap) {
-        const moduleMap = new Map();
-        ohPkgContentMap.forEach((content, filePath) => {
-            const moduleName = content.name;
-            if (moduleName && moduleName.startsWith('@')) {
-                const modulePath = path_1.default.dirname(filePath);
-                moduleMap.set(moduleName, new ModulePath(modulePath, content.main ? path_1.default.resolve(modulePath, content.main) : ''));
-            }
-        });
-        ohPkgContentMap.forEach((content, filePath) => {
-            if (!content.dependencies) {
-                return;
-            }
-            Object.entries(content.dependencies).forEach(([name, value]) => {
-                if (moduleMap.get(name)) {
-                    return;
-                }
-                const dir = path_1.default.dirname(filePath);
-                let modulePath = path_1.default.resolve(dir, value.replace('file:', ''));
-                let main = '';
-                if (this.isDirectory(modulePath)) {
-                    const target = ohPkgContentMap.get(path_1.default.resolve(modulePath, EtsConst_1.OH_PACKAGE_JSON5));
-                    if (target === null || target === void 0 ? void 0 : target.main) {
-                        main = path_1.default.resolve(modulePath, target.main);
-                    }
-                }
-                else {
-                    modulePath = path_1.default.resolve(dir, 'oh_modules', name);
-                }
-                moduleMap.set(name, new ModulePath(modulePath, main));
-            });
-        });
-        return moduleMap;
-    }
     static getFileLanguage(file, fileTags) {
         if (fileTags && fileTags.has(file)) {
             return fileTags.get(file);
@@ -117,6 +85,9 @@ class FileUtils {
             case '.js':
                 return ArkFile_1.Language.JAVASCRIPT;
             default:
+                if (CXX_EXTENSION_SET.has(extension)) {
+                    return ArkFile_1.Language.CXX;
+                }
                 return ArkFile_1.Language.UNKNOWN;
         }
     }
@@ -126,13 +97,6 @@ FileUtils.FILE_FILTER = {
     ignores: ['.git', '.preview', '.hvigor', '.idea', 'test', 'ohosTest'],
     include: /(?<!\.d)\.(ets|ts|json5)$/,
 };
-class ModulePath {
-    constructor(path, main) {
-        this.path = (0, pathTransfer_1.transfer2UnixPath)(path);
-        this.main = main ? (0, pathTransfer_1.transfer2UnixPath)(main) : main;
-    }
-}
-exports.ModulePath = ModulePath;
 function getFileRecursively(srcDir, fileName, visited = new Set()) {
     let res = '';
     if (!FileUtils.isDirectory(srcDir)) {
@@ -160,3 +124,29 @@ function getFileRecursively(srcDir, fileName, visited = new Set()) {
     return res;
 }
 exports.getFileRecursively = getFileRecursively;
+/**
+ * Try to combine each source path in the array with the relative path, returning the first absolute path that exists.
+ * @param srcPathList Source path array (absolute or relative paths)
+ * @param relativePath The relative path to concatenate
+ * @returns The first concatenated absolute path that exists; otherwise returns an empty string
+ */
+function getFileAbsPath(srcPathList, relativePath) {
+    if (!srcPathList || srcPathList.length === 0 || !relativePath) {
+        return '';
+    }
+    for (const srcPath of srcPathList) {
+        const srcDir = path_1.default.dirname(path_1.default.resolve(srcPath));
+        const absPath = path_1.default.resolve(srcDir, relativePath);
+        if (fs_1.default.existsSync(absPath)) {
+            return absPath;
+        }
+    }
+    return '';
+}
+exports.getFileAbsPath = getFileAbsPath;
+function getFileSignatureMapKey(projectName, fileName) {
+    const normalizedFileName = (0, pathTransfer_1.transfer2UnixPath)(fileName);
+    const hashcode = crypto_utils_1.CryptoUtils.hashcode(`@${projectName}/${normalizedFileName}: `);
+    return `${hashcode}${path_1.default.basename(normalizedFileName)}`;
+}
+exports.getFileSignatureMapKey = getFileSignatureMapKey;

package/lib/utils/LRUCacheDecorator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A function that generates a cache key from method arguments.
+ */
+export type KeyGenerator = (...args: any[]) => string;
+/**
+ * LRU (Least Recently Used) cache decorator for methods.
+ * Caches return values based on method arguments, evicting the oldest entry
+ * when the cache reaches maxSize.
+ *
+ * @param maxSize - Maximum number of entries to keep in the cache.
+ * @param keyGenerator - Optional custom function to generate cache keys from method arguments.
+ */
+export declare function LRUCache(maxSize?: number, keyGenerator?: KeyGenerator): (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) => void;
+/**
+ * Clear the LRU cache associated with a decorated method.
+ * @param target - The class (for static methods) or instance (for instance methods).
+ * @param propertyKey - The method name.
+ */
+export declare function clearLRUCache(target: any, propertyKey: string): void;
+//# sourceMappingURL=LRUCacheDecorator.d.ts.map

package/lib/utils/LRUCacheDecorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LRUCacheDecorator.d.ts","sourceRoot":"","sources":["../../src/utils/LRUCacheDecorator.ts"],"names":[],"mappings":"AA0CA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;AAItD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,MAAa,EAAE,YAAY,CAAC,EAAE,YAAY,aAG9C,GAAG,gBAAgB,MAAM,cAAc,kBAAkB,UAuBtF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAGpE"}

package/lib/utils/LRUCacheDecorator.js

@@ -0,0 +1,89 @@
+"use strict";
+/*
+ * Copyright (c) 2024-2026 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearLRUCache = exports.LRUCache = void 0;
+/**
+ * LRU Cache Decorator — method-level caching with Least Recently Used eviction.
+ *
+ * Usage:
+ *   import { LRUCache, clearLRUCache } from './LRUCacheDecorator';
+ *
+ *   class Foo {
+ *       // Basic: cache up to 4096 entries (default)
+ *       @LRUCache()
+ *       static resolve(path: string): string { ... }
+ *
+ *       // Custom capacity
+ *       @LRUCache(1024)
+ *       static lookup(id: number): string { ... }
+ *
+ *       // Custom key generator — useful when you want case-insensitive keys,
+ *       // partial-argument keys, or any custom serialization.
+ *       @LRUCache(4096, (srcPath) => srcPath.toLowerCase())
+ *       static getFileRealPath(srcPath: string): string { ... }
+ *   }
+ *
+ *   // Clear the cache of a decorated method (e.g. on dispose)
+ *   clearLRUCache(Foo, 'resolve');
+ */
+const LRU_CACHE_SYMBOL = Symbol('LRUCache');
+const defaultKeyGenerator = (...args) => args.join();
+/**
+ * LRU (Least Recently Used) cache decorator for methods.
+ * Caches return values based on method arguments, evicting the oldest entry
+ * when the cache reaches maxSize.
+ *
+ * @param maxSize - Maximum number of entries to keep in the cache.
+ * @param keyGenerator - Optional custom function to generate cache keys from method arguments.
+ */
+function LRUCache(maxSize = 4096, keyGenerator) {
+    const resolveKey = keyGenerator !== null && keyGenerator !== void 0 ? keyGenerator : defaultKeyGenerator;
+    const cache = new Map();
+    return function (_target, _propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = function (...args) {
+            const key = resolveKey(...args);
+            if (cache.has(key)) {
+                const value = cache.get(key);
+                cache.delete(key);
+                cache.set(key, value);
+                return value;
+            }
+            const result = originalMethod.apply(this, args);
+            if (cache.size >= maxSize) {
+                const firstKey = cache.keys().next().value;
+                if (firstKey) {
+                    cache.delete(firstKey);
+                }
+            }
+            cache.set(key, result);
+            return result;
+        };
+        descriptor.value[LRU_CACHE_SYMBOL] = cache;
+    };
+}
+exports.LRUCache = LRUCache;
+/**
+ * Clear the LRU cache associated with a decorated method.
+ * @param target - The class (for static methods) or instance (for instance methods).
+ * @param propertyKey - The method name.
+ */
+function clearLRUCache(target, propertyKey) {
+    var _a;
+    const cache = (_a = target[propertyKey]) === null || _a === void 0 ? void 0 : _a[LRU_CACHE_SYMBOL];
+    cache === null || cache === void 0 ? void 0 : cache.clear();
+}
+exports.clearLRUCache = clearLRUCache;

package/lib/utils/ModuleUtils.d.ts

@@ -0,0 +1,39 @@
+export declare class ModulePath {
+    path: string;
+    main: string;
+    /**
+     * Create a new ModulePath instance.
+     * @param path - The module path.
+     * @param main - The main entry file path of the module.
+     */
+    constructor(path: string, main: string);
+}
+export declare class ModuleUtils {
+    private static readonly FILE_EXT;
+    private static readonly OH_PACKAGE_DEPENDENCY_KEYS;
+    static MODULES: Map<string, ModulePath>;
+    static dispose(): void;
+    /**
+     * Get the real file path for a given source path, resolving file extensions and checking existence.
+     * Results are cached via LRU for performance.
+     * @param srcPath - The source path to resolve, e.g.: /projectA/src/foo
+     * @returns The resolved real file path, or empty string if not found.
+     */
+    static getFileRealPath(srcPath: string): string;
+    /**
+     * Generate a module map from oh-package.json5 content.
+     * @param ohPkgContentMap - A map of oh-package.json5 file paths to their parsed content.
+     * @returns A map of module names to their module paths.
+     */
+    static generateModuleMap(ohPkgContentMap: Map<string, {
+        [k: string]: unknown;
+    }>): Map<string, ModulePath>;
+    private static addDependModule;
+    private static processDependency;
+    /**
+     * Handle "foo_test": "@module:Foo" dependency.
+     */
+    private static handleModuleRefDependency;
+    private static findModulePathInOHPM;
+}
+//# sourceMappingURL=ModuleUtils.d.ts.map

package/lib/utils/ModuleUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleUtils.d.ts","sourceRoot":"","sources":["../../src/utils/ModuleUtils.ts"],"names":[],"mappings":"AA2BA,qBAAa,UAAU;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;gBACS,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAIzC;AAGD,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA+F;IAC/H,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAA8D;IAChH,OAAc,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAa;WAM7C,OAAO,IAAI,IAAI;IAK7B;;;;;OAKG;WAEW,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IA6CtD;;;;OAIG;WACW,iBAAiB,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IA2BhH,OAAO,CAAC,MAAM,CAAC,eAAe;IA6B9B,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA8BhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAaxC,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAyBtC"}