arkanalyzer 1.0.90 → 1.0.91

package/lib/core/model/ArkModule.js

@@ -0,0 +1,250 @@
+"use strict";
+/*
+ * Copyright (c) 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.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArkModule = exports.ModuleType = exports.ModuleLoadState = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const json5parser_1 = require("../../utils/json5parser");
+/**
+ * Lifecycle state of an {@link ArkModule}. Stored in the low 3 bits of {@link ArkModule.tags}.
+ *
+ * The states form an incremental progression: each state is a superset of the previous one,
+ * matching the {@link ModuleDepthLevel} data depth levels.
+ */
+var ModuleLoadState;
+(function (ModuleLoadState) {
+    /** No data loaded yet. */
+    ModuleLoadState[ModuleLoadState["NOT_LOADED"] = 0] = "NOT_LOADED";
+    /** Module metadata + dependency topology + ArkFile path-only basic info. */
+    ModuleLoadState[ModuleLoadState["META"] = 1] = "META";
+    /** META + export/import info for all ArkFiles + intra-module file dependencies. */
+    ModuleLoadState[ModuleLoadState["IMPORTS"] = 2] = "IMPORTS";
+    /** IMPORTS + ArkFile content excluding method bodies (namespaces, classes, signatures). */
+    ModuleLoadState[ModuleLoadState["SIGNATURES"] = 3] = "SIGNATURES";
+    /** SIGNATURES + method bodies (ArkBody, CFG, Stmt/Expr). */
+    ModuleLoadState[ModuleLoadState["BODIES"] = 4] = "BODIES";
+})(ModuleLoadState = exports.ModuleLoadState || (exports.ModuleLoadState = {}));
+/**
+ * Category of an {@link ArkModule}. Stored in bits 3-4 of {@link ArkModule.tags}.
+ */
+var ModuleType;
+(function (ModuleType) {
+    /** In-project module (HAP/HSP/HAR) from build-profile.json5. */
+    ModuleType[ModuleType["PROJECT"] = 0] = "PROJECT";
+    /** SDK sub-module from the SDK directory (e.g. openharmony/ets/api, ets/kits). */
+    ModuleType[ModuleType["SDK"] = 1] = "SDK";
+    /** Third-party dependency module under oh_modules. */
+    ModuleType[ModuleType["OH_MODULES"] = 2] = "OH_MODULES";
+})(ModuleType = exports.ModuleType || (exports.ModuleType = {}));
+// Bit-field layout of `tags` (modeled after ArkBaseModel.tags):
+//   bits 0-2: ModuleLoadState (3 bits, mask 0b111, values 0-4)
+//   bits 3-4: ModuleType      (2 bits, mask 0b11 << 3, values 0-2)
+const MODULE_LOAD_STATE_MASK = 0b111;
+const MODULE_LOAD_STATE_SHIFT = 0;
+const MODULE_TYPE_MASK = 0b11 << 3;
+const MODULE_TYPE_SHIFT = 3;
+/**
+ * ArkModule is the new layer between {@link Scene} and {@link ArkFile}, corresponding to a single
+ * module (HAP/HSP/HAR) of an OpenHarmony application.
+ *
+ * `loadState` and `moduleType` share a single `number` bit-field (`tags`), read/written via
+ * {@link setTagValue}/{@link getTagValue}, following the pattern in `ArkBaseModel.tags`.
+ * The default `tags` value `0` means `ModuleLoadState.NOT_LOADED | ModuleType.PROJECT`.
+ *
+ * @category core/model
+ */
+class ArkModule {
+    constructor(scene) {
+        /** Absolute path of the module (primary identifier). */
+        this.modulePath = '';
+        /** Module name from oh-package.json5 (e.g. "@ohos/entry"); auxiliary field. */
+        this.moduleName = '';
+        /** key: {@link FileSignature.toMapKey} */
+        this.filesMap = new Map();
+        /**
+         * Alias-to-id mapping for dependencies, defined at the use site.
+         * key: alias in this module's oh-package.json5 dependencies (e.g. "@ohos/library").
+         * value: ModuleID of the depended-on module.
+         */
+        this.dependencyAliasToId = new Map();
+        /**
+         * Unresolved dependencies (not participating in inter-module topological sort).
+         * key: alias, value: version or path.
+         */
+        this.unresolvedDependencies = new Map();
+        /**
+         * Bit-field encoding loadState (bits 0-2) and moduleType (bits 3-4).
+         * Default 0 = ModuleLoadState.NOT_LOADED | ModuleType.PROJECT.
+         */
+        this.tags = 0;
+        this.scene = scene;
+    }
+    /** Returns the owning {@link Scene} of this module. */
+    getScene() {
+        return this.scene;
+    }
+    // --- Bit-field helpers (modeled after ArkBaseModel.setTagValue/getTagValue) ---
+    setTagValue(mask, shift, value) {
+        this.tags = (this.tags & ~mask) | ((value << shift) & mask);
+    }
+    getTagValue(mask, shift) {
+        return (this.tags & mask) >>> shift;
+    }
+    // --- getters/setters ---
+    getModulePath() {
+        return this.modulePath;
+    }
+    setModulePath(modulePath) {
+        this.modulePath = modulePath;
+    }
+    getModuleName() {
+        return this.moduleName;
+    }
+    setModuleName(moduleName) {
+        this.moduleName = moduleName;
+    }
+    getFilesMap() {
+        return this.filesMap;
+    }
+    getLoadState() {
+        return this.getTagValue(MODULE_LOAD_STATE_MASK, MODULE_LOAD_STATE_SHIFT);
+    }
+    setLoadState(state) {
+        this.setTagValue(MODULE_LOAD_STATE_MASK, MODULE_LOAD_STATE_SHIFT, state);
+    }
+    getModuleType() {
+        return this.getTagValue(MODULE_TYPE_MASK, MODULE_TYPE_SHIFT);
+    }
+    setModuleType(type) {
+        this.setTagValue(MODULE_TYPE_MASK, MODULE_TYPE_SHIFT, type);
+    }
+    // --- Dependency queries ---
+    /**
+     * Returns the list of modules this module directly depends on (successor dependencies).
+     * Reads from the module dependency graph maintained by the Scene.
+     * Returns an empty array when the dependency graph has not been built yet.
+     */
+    getDependencies() {
+        const depGraph = this.scene.getModuleDepGraph();
+        if (!depGraph) {
+            return [];
+        }
+        const moduleId = depGraph.tryGetNodeID(this);
+        if (moduleId === undefined) {
+            return [];
+        }
+        const succIds = depGraph.getSuccModuleIds(moduleId);
+        const result = [];
+        for (const succId of succIds) {
+            const mod = depGraph.tryGetNode(succId);
+            if (mod) {
+                result.push(mod);
+            }
+        }
+        return result;
+    }
+    /**
+     * Returns the list of modules that directly depend on this module (predecessor dependents).
+     * Reads from the module dependency graph maintained by the Scene.
+     * Returns an empty array when the dependency graph has not been built yet.
+     */
+    getDependents() {
+        const depGraph = this.scene.getModuleDepGraph();
+        if (!depGraph) {
+            return [];
+        }
+        const moduleId = depGraph.tryGetNodeID(this);
+        if (moduleId === undefined) {
+            return [];
+        }
+        const predIds = depGraph.getPredModuleIds(moduleId);
+        const result = [];
+        for (const predId of predIds) {
+            const mod = depGraph.tryGetNode(predId);
+            if (mod) {
+                result.push(mod);
+            }
+        }
+        return result;
+    }
+    // --- Dependency management ---
+    /**
+     * Record an alias for a depended-on module within this module.
+     * For example, given dependencies: { "@ohos/library": "file:../library" } in oh-package.json5,
+     * alias = "@ohos/library", depId = ModuleID of the library module.
+     */
+    addDependencyAlias(alias, depId) {
+        this.dependencyAliasToId.set(alias, depId);
+    }
+    /**
+     * Resolve the ModuleID of a depended-on module by its alias defined in this module.
+     */
+    resolveDependencyAlias(alias) {
+        return this.dependencyAliasToId.get(alias);
+    }
+    getDependencyAliasToId() {
+        return this.dependencyAliasToId;
+    }
+    // --- Unresolved dependencies ---
+    addUnresolvedDependency(alias, value) {
+        this.unresolvedDependencies.set(alias, value);
+    }
+    getUnresolvedDependencies() {
+        return this.unresolvedDependencies;
+    }
+    // --- File dependency analysis ---
+    /** The intra-module file dependency graph, or undefined before analysis. */
+    getFileDepGraph() {
+        return this.fileDepGraph;
+    }
+    setFileDepGraph(graph) {
+        this.fileDepGraph = graph;
+    }
+    /** Whether file dependency analysis has produced a topological order. */
+    hasFileTopoOrder() {
+        return this.fileDepGraph !== undefined && this.fileDepGraph.getTopoOrder().length > 0;
+    }
+    // --- File management ---
+    addFile(arkFile) {
+        this.filesMap.set(arkFile.getFileSignature().toMapKey(), arkFile);
+    }
+    clearFilesMap() {
+        this.filesMap.clear();
+    }
+    // --- oh-package.json5 reading ---
+    /**
+     * Returns the absolute path of this module's oh-package.json5.
+     * Derived from the module path, not stored persistently.
+     */
+    getOhPkgPath() {
+        return path_1.default.join(this.modulePath, 'oh-package.json5');
+    }
+    /**
+     * Reads and parses oh-package.json5 on demand (not stored persistently).
+     * Used only during the build phase. Returns `{}` if the file does not exist.
+     */
+    readOhPkgContent() {
+        const ohPkgPath = this.getOhPkgPath();
+        if (!fs_1.default.existsSync(ohPkgPath)) {
+            return {};
+        }
+        return (0, json5parser_1.fetchDependenciesFromFile)(ohPkgPath);
+    }
+}
+exports.ArkModule = ArkModule;

package/lib/core/model/ArkNamespace.d.ts

@@ -124,5 +124,6 @@ export declare class ArkNamespace extends ArkBaseModel implements ArkExport {
     removeArkClass(arkClass: ArkClass): boolean;
     removeNamespace(namespace: ArkNamespace): boolean;
     validate(): ArkError;
+    clearAllReferences(): void;
 }
 //# sourceMappingURL=ArkNamespace.d.ts.map

package/lib/core/model/ArkNamespace.d.ts.map

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

package/lib/core/model/ArkNamespace.js

@@ -306,5 +306,23 @@ class ArkNamespace extends ArkBaseModel_1.ArkBaseModel {
     validate() {
         return this.validateFields(['declaringArkFile', 'declaringInstance', 'namespaceSignature', 'defaultClass']);
     }
+    clearAllReferences() {
+        for (const cls of this.classes.values()) {
+            cls.clearAllReferences();
+        }
+        for (const ns of this.namespaces.values()) {
+            ns.clearAllReferences();
+        }
+        for (const exp of this.exportInfos.values()) {
+            exp.clearAllReferences();
+        }
+        this.classes.clear();
+        this.namespaces.clear();
+        this.exportInfos.clear();
+        this.defaultClass = undefined;
+        this.declaringArkFile = undefined;
+        this.declaringArkNamespace = null;
+        this.declaringInstance = undefined;
+    }
 }
 exports.ArkNamespace = ArkNamespace;

package/lib/core/model/builder/ArkFileBuilder.d.ts

@@ -7,4 +7,23 @@ export declare const notStmtOrExprKind: string[];
  * @returns
  */
 export declare function buildArkFileFromFile(absoluteFilePath: string, projectDir: string, arkFile: ArkFile, projectName: string): void;
+/**
+ * Lightweight entry of building ImportInfo/ExportInfo on ArkFile without building ArkClass/ArkMethod/ArkNamespace/ArkBody.
+ *
+ * @param arkFile
+ * @returns
+ */
+export declare function buildImportExportInfoFromFile(arkFile: ArkFile): void;
+/**
+ * Signatures-only upgrade entry: builds ArkClass/ArkMethod/ArkNamespace signatures on top of an
+ * ArkFile whose ImportInfo/ExportInfo were already populated (e.g. by {@link buildImportExportInfoFromFile}).
+ *
+ * Unlike {@link buildArkFileFromFile}, this function calls {@link buildArkFile} with
+ * `skipImportExport = true`, so existing import/export data is preserved and not re-parsed. This
+ * avoids duplicating `export *` re-export entries whose temp clause keys are process-level
+ * auto-increment values that cannot be overwritten by `Map.set`.
+ *
+ * @param arkFile - The ArkFile to upgrade. Must already have filePath set.
+ */
+export declare function buildArkFileSignaturesFromFile(arkFile: ArkFile): void;
 //# sourceMappingURL=ArkFileBuilder.d.ts.map

package/lib/core/model/builder/ArkFileBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ArkFileBuilder.d.ts","sourceRoot":"","sources":["../../../../src/core/model/builder/ArkFileBuilder.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAY,MAAM,YAAY,CAAC;AAyB/C,eAAO,MAAM,iBAAiB,UAiB7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA0B9H"}
+{"version":3,"file":"ArkFileBuilder.d.ts","sourceRoot":"","sources":["../../../../src/core/model/builder/ArkFileBuilder.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAY,MAAM,YAAY,CAAC;AAyB/C,eAAO,MAAM,iBAAiB,UAiB7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA0B9H;AAiHD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAWpE;AAgCD;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAcrE"}

package/lib/core/model/builder/ArkFileBuilder.js

@@ -40,7 +40,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildArkFileFromFile = exports.notStmtOrExprKind = void 0;
+exports.buildArkFileSignaturesFromFile = exports.buildImportExportInfoFromFile = exports.buildArkFileFromFile = exports.notStmtOrExprKind = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const ohos_typescript_1 = __importDefault(require("ohos-typescript"));
@@ -113,49 +113,144 @@ function buildArkFileFromFile(absoluteFilePath, projectDir, arkFile, projectName
 }
 exports.buildArkFileFromFile = buildArkFileFromFile;
 /**
- * Building ArkFile instance
+ * Building ArkFile instance.
  *
- * @param arkFile
- * @param astRoot
- * @returns
+ * @param arkFile - The ArkFile to populate.
+ * @param astRoot - The parsed TypeScript source file AST.
+ * @param skipImportExport - When true, skip the import/export statement branches so that
+ *   existing ImportInfo/ExportInfo (populated earlier at IMPORTS level) is preserved and only
+ *   class/method/namespace signatures are built on top. This avoids re-parsing import/export
+ *   which would duplicate `export *` entries (their temp keys are process-level auto-increment).
  */
-function buildArkFile(arkFile, astRoot) {
-    const statements = astRoot.statements;
+function buildArkFile(arkFile, astRoot, skipImportExport = false) {
     const namespaces = [];
-    statements.forEach(child => {
+    for (const child of astRoot.statements) {
         if (ohos_typescript_1.default.isModuleDeclaration(child)) {
-            let ns = new ArkNamespace_1.ArkNamespace();
-            ns.setDeclaringArkFile(arkFile);
-            (0, ArkNamespaceBuilder_1.buildArkNamespace)(child, arkFile, ns, astRoot);
-            namespaces.push(ns);
-            if (ns.isExported()) {
-                arkFile.addExportInfo((0, ArkExportBuilder_1.buildExportInfo)(ns, arkFile, Position_1.FullPosition.buildFromNode(child, astRoot)));
-            }
+            buildAndCollectNamespace(child, arkFile, astRoot, namespaces);
         }
         else if (ohos_typescript_1.default.isClassDeclaration(child) || ohos_typescript_1.default.isInterfaceDeclaration(child) || ohos_typescript_1.default.isEnumDeclaration(child) || ohos_typescript_1.default.isStructDeclaration(child)) {
-            let cls = new ArkClass_1.ArkClass();
-            (0, ArkClassBuilder_1.buildNormalArkClassFromArkFile)(child, arkFile, cls, astRoot);
-            if (cls.isExported()) {
-                arkFile.addExportInfo((0, ArkExportBuilder_1.buildExportInfo)(cls, arkFile, Position_1.FullPosition.buildFromNode(child, astRoot)));
-            }
+            buildAndExportClass(child, arkFile, astRoot);
+        }
+        else if (ohos_typescript_1.default.isMethodDeclaration(child) || ohos_typescript_1.default.isFunctionDeclaration(child)) {
+            buildAndExportMethod(child, arkFile, astRoot);
+        }
+        else if (!skipImportExport && tryBuildImportExport(child, arkFile, astRoot)) {
+            // import/export handled by tryBuildImportExport
         }
-        // TODO: Check
-        else if (ohos_typescript_1.default.isMethodDeclaration(child)) {
-            logger.trace('This is a MethodDeclaration in ArkFile.');
-            let mthd = new ArkMethod_1.ArkMethod();
-            (0, ArkMethodBuilder_1.buildArkMethodFromArkClass)(child, arkFile.getDefaultClass(), mthd, astRoot);
-            if (mthd.isExported()) {
-                arkFile.addExportInfo((0, ArkExportBuilder_1.buildExportInfo)(mthd, arkFile, Position_1.FullPosition.buildFromNode(child, astRoot)));
+        else if (ohos_typescript_1.default.isExpressionStatement(child) && ohos_typescript_1.default.isStringLiteral(child.expression)) {
+            if ((0, StringUtils_1.cloneText)(child.expression.text).trim() === Const_1.ARKTS_STATIC_MARK) {
+                arkFile.setLanguage(ArkFile_1.Language.ARKTS1_2);
             }
         }
-        else if (ohos_typescript_1.default.isFunctionDeclaration(child)) {
-            let mthd = new ArkMethod_1.ArkMethod();
-            (0, ArkMethodBuilder_1.buildArkMethodFromArkClass)(child, arkFile.getDefaultClass(), mthd, astRoot);
-            if (mthd.isExported()) {
-                arkFile.addExportInfo((0, ArkExportBuilder_1.buildExportInfo)(mthd, arkFile, Position_1.FullPosition.buildFromNode(child, astRoot)));
+        else {
+            logger.trace('Child joined default method of arkFile: ', ohos_typescript_1.default.SyntaxKind[child.kind]);
+        }
+    }
+    mergeAndAddNamespaces(namespaces, arkFile);
+}
+function buildAndCollectNamespace(child, arkFile, astRoot, namespaces) {
+    const ns = new ArkNamespace_1.ArkNamespace();
+    ns.setDeclaringArkFile(arkFile);
+    (0, ArkNamespaceBuilder_1.buildArkNamespace)(child, arkFile, ns, astRoot);
+    namespaces.push(ns);
+    if (ns.isExported()) {
+        arkFile.addExportInfo((0, ArkExportBuilder_1.buildExportInfo)(ns, arkFile, Position_1.FullPosition.buildFromNode(child, astRoot)));
+    }
+}
+function buildAndExportClass(child, arkFile, astRoot) {
+    const cls = new ArkClass_1.ArkClass();
+    (0, ArkClassBuilder_1.buildNormalArkClassFromArkFile)(child, arkFile, cls, astRoot);
+    if (cls.isExported()) {
+        arkFile.addExportInfo((0, ArkExportBuilder_1.buildExportInfo)(cls, arkFile, Position_1.FullPosition.buildFromNode(child, astRoot)));
+    }
+}
+function buildAndExportMethod(child, arkFile, astRoot) {
+    const mthd = new ArkMethod_1.ArkMethod();
+    (0, ArkMethodBuilder_1.buildArkMethodFromArkClass)(child, arkFile.getDefaultClass(), mthd, astRoot);
+    if (mthd.isExported()) {
+        arkFile.addExportInfo((0, ArkExportBuilder_1.buildExportInfo)(mthd, arkFile, Position_1.FullPosition.buildFromNode(child, astRoot)));
+    }
+}
+/**
+ * Attempt to build import/export info from a statement. Returns true if the statement was
+ * recognized and handled as an import/export declaration.
+ */
+function tryBuildImportExport(child, arkFile, astRoot) {
+    if (ohos_typescript_1.default.isImportEqualsDeclaration(child) || ohos_typescript_1.default.isImportDeclaration(child)) {
+        const importInfos = (0, ArkImportBuilder_1.buildImportInfo)(child, astRoot, arkFile);
+        importInfos === null || importInfos === void 0 ? void 0 : importInfos.forEach(element => {
+            element.setDeclaringArkFile(arkFile);
+            arkFile.addImportInfo(element);
+        });
+        return true;
+    }
+    if (ohos_typescript_1.default.isExportDeclaration(child)) {
+        (0, ArkExportBuilder_1.buildExportDeclaration)(child, astRoot, arkFile).forEach(item => arkFile.addExportInfo(item));
+        return true;
+    }
+    if (ohos_typescript_1.default.isExportAssignment(child)) {
+        (0, ArkExportBuilder_1.buildExportAssignment)(child, astRoot, arkFile).forEach(item => arkFile.addExportInfo(item));
+        return true;
+    }
+    if (ohos_typescript_1.default.isVariableStatement(child) && (0, ArkExportBuilder_1.isExported)(child.modifiers)) {
+        (0, ArkExportBuilder_1.buildExportVariableStatement)(child, astRoot, arkFile).forEach(item => arkFile.addExportInfo(item));
+        return true;
+    }
+    if (ohos_typescript_1.default.isTypeAliasDeclaration(child) && (0, ArkExportBuilder_1.isExported)(child.modifiers)) {
+        (0, ArkExportBuilder_1.buildExportTypeAliasDeclaration)(child, astRoot, arkFile).forEach(item => arkFile.addExportInfo(item));
+        return true;
+    }
+    return false;
+}
+function mergeAndAddNamespaces(namespaces, arkFile) {
+    const merged = (0, ArkNamespaceBuilder_1.mergeNameSpaces)(namespaces);
+    merged.forEach(ns => {
+        arkFile.addNamespace(ns);
+        if (ns.isExport()) {
+            const positions = ns.getOriginFullPositions();
+            if (positions.length > 0) {
+                arkFile.addExportInfo((0, ArkExportBuilder_1.buildExportInfo)(ns, arkFile, positions[0]));
             }
         }
-        else if (ohos_typescript_1.default.isImportEqualsDeclaration(child) || ohos_typescript_1.default.isImportDeclaration(child)) {
+    });
+}
+function genDefaultArkClass(arkFile, astRoot) {
+    let defaultClass = new ArkClass_1.ArkClass();
+    (0, ArkClassBuilder_1.buildDefaultArkClassFromArkFile)(arkFile, defaultClass, astRoot);
+    arkFile.setDefaultClass(defaultClass);
+    arkFile.addArkClass(defaultClass);
+}
+/**
+ * Lightweight entry of building ImportInfo/ExportInfo on ArkFile without building ArkClass/ArkMethod/ArkNamespace/ArkBody.
+ *
+ * @param arkFile
+ * @returns
+ */
+function buildImportExportInfoFromFile(arkFile) {
+    let sourceText;
+    try {
+        sourceText = fs_1.default.readFileSync(arkFile.getFilePath(), 'utf8');
+    }
+    catch (error) {
+        logger.error('Failed to read file: ${error}');
+        return;
+    }
+    arkFile.setCode(sourceText);
+    const sourceFile = ohos_typescript_1.default.createSourceFile(arkFile.getName(), sourceText, ohos_typescript_1.default.ScriptTarget.Latest, true, undefined, EtsConst_1.ETS_COMPILER_OPTIONS);
+    buildImportExportInfo(arkFile, sourceFile);
+}
+exports.buildImportExportInfoFromFile = buildImportExportInfoFromFile;
+/**
+ * Building ImportInfo/ExportInfo on ArkFile from AST, skipping class/interface/enum/struct/namespace declarations.
+ *
+ * @param arkFile
+ * @param astRoot
+ * @returns
+ */
+function buildImportExportInfo(arkFile, astRoot) {
+    const statements = astRoot.statements;
+    statements.forEach(child => {
+        if (ohos_typescript_1.default.isImportEqualsDeclaration(child) || ohos_typescript_1.default.isImportDeclaration(child)) {
             let importInfos = (0, ArkImportBuilder_1.buildImportInfo)(child, astRoot, arkFile);
             importInfos === null || importInfos === void 0 ? void 0 : importInfos.forEach(element => {
                 element.setDeclaringArkFile(arkFile);
@@ -177,24 +272,33 @@ function buildArkFile(arkFile, astRoot) {
         else if (ohos_typescript_1.default.isExpressionStatement(child) && ohos_typescript_1.default.isStringLiteral(child.expression)) {
             (0, StringUtils_1.cloneText)(child.expression.text).trim() === Const_1.ARKTS_STATIC_MARK && arkFile.setLanguage(ArkFile_1.Language.ARKTS1_2);
         }
-        else {
-            logger.trace('Child joined default method of arkFile: ', ohos_typescript_1.default.SyntaxKind[child.kind]);
-        }
-    });
-    const mergedNameSpaces = (0, ArkNamespaceBuilder_1.mergeNameSpaces)(namespaces);
-    mergedNameSpaces.forEach(mergedNameSpace => {
-        arkFile.addNamespace(mergedNameSpace);
-        if (mergedNameSpace.isExport()) {
-            const positions = mergedNameSpace.getOriginFullPositions();
-            if (positions.length > 0) {
-                arkFile.addExportInfo((0, ArkExportBuilder_1.buildExportInfo)(mergedNameSpace, arkFile, positions[0]));
-            }
-        }
     });
 }
-function genDefaultArkClass(arkFile, astRoot) {
-    let defaultClass = new ArkClass_1.ArkClass();
-    (0, ArkClassBuilder_1.buildDefaultArkClassFromArkFile)(arkFile, defaultClass, astRoot);
-    arkFile.setDefaultClass(defaultClass);
-    arkFile.addArkClass(defaultClass);
+/**
+ * Signatures-only upgrade entry: builds ArkClass/ArkMethod/ArkNamespace signatures on top of an
+ * ArkFile whose ImportInfo/ExportInfo were already populated (e.g. by {@link buildImportExportInfoFromFile}).
+ *
+ * Unlike {@link buildArkFileFromFile}, this function calls {@link buildArkFile} with
+ * `skipImportExport = true`, so existing import/export data is preserved and not re-parsed. This
+ * avoids duplicating `export *` re-export entries whose temp clause keys are process-level
+ * auto-increment values that cannot be overwritten by `Map.set`.
+ *
+ * @param arkFile - The ArkFile to upgrade. Must already have filePath set.
+ */
+function buildArkFileSignaturesFromFile(arkFile) {
+    let sourceText;
+    try {
+        sourceText = fs_1.default.readFileSync(arkFile.getFilePath(), 'utf8');
+    }
+    catch (error) {
+        logger.error('Failed to read file: ${error}');
+        return;
+    }
+    const sourceFile = ohos_typescript_1.default.createSourceFile(arkFile.getName(), sourceText, ohos_typescript_1.default.ScriptTarget.Latest, true, undefined, EtsConst_1.ETS_COMPILER_OPTIONS);
+    if (arkFile.getScene().getOptions().enableAST && arkFile.getScene().getProjectName() === arkFile.getProjectName()) {
+        arkFile.setAST(sourceFile);
+    }
+    genDefaultArkClass(arkFile, sourceFile);
+    buildArkFile(arkFile, sourceFile, true);
 }
+exports.buildArkFileSignaturesFromFile = buildArkFileSignaturesFromFile;