arkanalyzer 1.0.94 → 2.0.0-beta1

package/lib/Scene.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.ModuleScene = exports.Scene = exports.SceneBuildStage = void 0;
+exports.Scene = exports.ModuleScene = exports.SceneBuildStage = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const ModelUtils_1 = require("./core/common/ModelUtils");
@@ -48,53 +48,74 @@ const TypeInference_1 = require("./core/common/TypeInference");
 const VisibleValue_1 = require("./core/common/VisibleValue");
 const ArkFile_1 = require("./core/model/ArkFile");
 const ArkNamespace_1 = require("./core/model/ArkNamespace");
-const ArkSignature_1 = require("./core/model/ArkSignature");
 const ModuleAnalysisConfig_1 = require("./frontend/common/ModuleAnalysisConfig");
 const ModuleBuilder_1 = require("./frontend/common/ModuleBuilder");
 const logger_1 = __importStar(require("./utils/logger"));
-const json5parser_1 = require("./utils/json5parser");
-const getAllFiles_1 = require("./utils/getAllFiles");
-const FileUtils_1 = require("./utils/FileUtils");
 const ArkExport_1 = require("./core/model/ArkExport");
-const ArkMethodBuilder_1 = require("./core/model/builder/ArkMethodBuilder");
-const ArkMethodBuilder_2 = require("./frontend/cppFrontend/model/builder/ArkMethodBuilder");
 const builderUtils_1 = require("./frontend/cppFrontend/model/builder/builderUtils");
+const ArkFileBuilder_1 = require("./frontend/cppFrontend/model/builder/ArkFileBuilder");
 const Const_1 = require("./core/common/Const");
 const CallGraph_1 = require("./callgraph/model/CallGraph");
 const CallGraphBuilder_1 = require("./callgraph/model/builder/CallGraphBuilder");
 const IRInference_1 = require("./frontend/cppFrontend/common/IRInference");
-const ArktsFrontend_1 = require("./frontend/arktsFrontend/ArktsFrontend");
-const FrontendBuilder_1 = require("./frontend/FrontendBuilder");
-const TSConst_1 = require("./core/common/TSConst");
-const EtsConst_1 = require("./core/common/EtsConst");
+const SceneBuilder_1 = require("./frontend/SceneBuilder");
 const SdkUtils_1 = require("./core/common/SdkUtils");
 const PointerAnalysisConfig_1 = require("./callgraph/pointerAnalysis/PointerAnalysisConfig");
 const ValueUtil_1 = require("./core/common/ValueUtil");
 const Inference_1 = require("./core/inference/Inference");
 const IRInference_2 = require("./core/common/IRInference");
 const ModuleUtils_1 = require("./utils/ModuleUtils");
-const DependenciesSort_1 = require("./utils/DependenciesSort");
 const Canonicalizer_1 = require("./utils/Canonicalizer");
 const ModuleDepGraph_1 = require("./core/graph/ModuleDepGraph");
+const SignatureCanonicalizerRegistry_1 = require("./core/common/SignatureCanonicalizerRegistry");
+const CanonicalizerValidator_1 = require("./core/common/CanonicalizerValidator");
+const ArkSignatureBuilder_1 = require("./core/model/builder/ArkSignatureBuilder");
+const StageStatistics_1 = require("./statistics/StageStatistics");
+const StageStatisticsReporter_1 = require("./statistics/StageStatisticsReporter");
 const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER, 'Scene');
-var SceneBuildStage;
-(function (SceneBuildStage) {
-    SceneBuildStage[SceneBuildStage["BUILD_INIT"] = 0] = "BUILD_INIT";
-    SceneBuildStage[SceneBuildStage["SDK_INFERRED"] = 1] = "SDK_INFERRED";
-    SceneBuildStage[SceneBuildStage["CLASS_DONE"] = 2] = "CLASS_DONE";
-    SceneBuildStage[SceneBuildStage["METHOD_DONE"] = 3] = "METHOD_DONE";
-    SceneBuildStage[SceneBuildStage["CLASS_COLLECTED"] = 4] = "CLASS_COLLECTED";
-    SceneBuildStage[SceneBuildStage["METHOD_COLLECTED"] = 5] = "METHOD_COLLECTED";
-    SceneBuildStage[SceneBuildStage["TYPE_INFERRED"] = 6] = "TYPE_INFERRED";
-})(SceneBuildStage = exports.SceneBuildStage || (exports.SceneBuildStage = {}));
+// 枚举与 ModuleScene 已拆至 frontend 独立文件（解 Scene↔frontend 值导入循环），
+// 此处 re-export 保持对外兼容。
+var SceneBuildStage_1 = require("./frontend/SceneBuildStage");
+Object.defineProperty(exports, "SceneBuildStage", { enumerable: true, get: function () { return SceneBuildStage_1.SceneBuildStage; } });
+var ModuleScene_1 = require("./frontend/ModuleScene");
+Object.defineProperty(exports, "ModuleScene", { enumerable: true, get: function () { return ModuleScene_1.ModuleScene; } });
+const SceneBuildStage_2 = require("./frontend/SceneBuildStage");
 /**
  * The Scene class includes everything in the analyzed project.
  * We should be able to re-generate the project's code based on this class.
  */
 class Scene {
+    // --- Canonicalizers moved to SignatureCanonicalizerRegistry (global singleton) ---
+    /** @internal Get the Registry singleton. */
+    get registry() {
+        return SignatureCanonicalizerRegistry_1.SignatureCanonicalizerRegistry.getInstance();
+    }
+    // --- 构建期上下文（SceneBuilder）生命周期 ---
+    /** @internal 惰性创建/复用构建期上下文（幂等：同一构建流程内共享工作态）。 */
+    getOrCreateSceneBuilder(sceneConfig) {
+        if (!this.activeBuilder) {
+            const config = sceneConfig !== null && sceneConfig !== void 0 ? sceneConfig : this.sceneConfig;
+            if (!config) {
+                throw new Error('SceneBuilder requires a SceneConfig (call buildBasicInfo first).');
+            }
+            this.activeBuilder = new SceneBuilder_1.SceneBuilder(this, config);
+        }
+        return this.activeBuilder;
+    }
+    /** @internal 释放构建期上下文：在构建机械全部完成后调用，工作态随上下文被 GC 回收。*/
+    releaseSceneBuilder() {
+        this.activeBuilder = undefined;
+    }
+    /** @internal 当前活跃构建上下文（无则 undefined）。ModuleScene 等构建通道使用。 */
+    getActiveSceneBuilder() {
+        return this.activeBuilder;
+    }
+    /** @internal 模块路径 → 模块名映射（构建产物；SceneBuilder.parseBuildProfile 写入）。 */
+    getModulePath2NameMap() {
+        return this.modulePath2NameMap;
+    }
     constructor() {
         this.projectName = '';
-        this.projectFiles = [];
         this.realProjectDir = '';
         this.includeDirs = []; // Include directories that the C++ project depends on.
         this.ccjsonPath = '';
@@ -105,42 +126,78 @@ class Scene {
         this.projectSdkMap = new Map();
         // values that are visible in curr scope
         this.visibleValue = new VisibleValue_1.VisibleValue();
-        // signature string to model
-        this.filesMap = new Map();
-        this.namespacesMap = new Map();
-        this.classesMap = new Map();
-        this.methodsMap = new Map();
-        /** Custom @Component name → ClassSignature; written at ArkClass build, kept after module unload for ViewTree stubs. */
-        this.customComponentMap = new Map();
-        // TODO: type of key should be signature object
-        this.sdkArkFilesMap = new Map();
-        this.sdkGlobalMap = new Map();
-        this.ohPkgContentMap = new Map();
-        this.ohPkgFilePath = '';
-        this.ohPkgContent = {};
         this.overRides = new Map();
         this.overRideDependencyMap = new Map();
-        this.buildStage = SceneBuildStage.BUILD_INIT;
+        this.buildStage = SceneBuildStage_2.SceneBuildStage.BUILD_INIT;
         this.fileLanguages = new Map();
         /** Maps ArkModule objects to dense integer ModuleIDs via the objectIdentity strategy. */
         this.moduleCanonicalizer = new Canonicalizer_1.Canonicalizer();
         /** Whether module preparation has completed (prepareModules + analyzeModuleDependencies, idempotent). */
         this.modulesRegistered = false;
+        /** Prevents duplicate report output (set by manual API or exit hook). */
+        this.statsReportWritten = false;
         this.unhandledFilePaths = new Set();
         this.unhandledSdkFilePaths = [];
+        /**
+         * project 文件的构建完成序（setFile 时记录的 FileSigID 序列）。
+         *
+         * 构建走 {@link getDependencyFilesDeeply}（DFS）：每个文件在自己的全部 import/export 依赖构建完成之后才 setFile（后序）——因此本序列是严格的拓扑序（被依赖者在前）。
+         * 这是推断期零排序遍历的事实源（见 {@link inferTypes}）。注意 FileSigID 本身的前序 intern 序不具拓扑性质（多入口/菱形场景依赖方可能晚于被依赖方 intern），不可用于排序。
+         */
+        this.builtFileOrder = [];
+        /** 根 oh-package.json5 内容快照（SceneBuilder.parseOhPackage 结束回填）。 */
+        this.ohPkgContentSnapshot = {};
+        SignatureCanonicalizerRegistry_1.SignatureCanonicalizerRegistry.dispose();
     }
     /*
      * Set all static field to be null, then all related objects could be freed by GC.
      * This method could be called before drop Scene.
      */
     dispose() {
+        var _a;
         PointerAnalysisConfig_1.PointerAnalysisConfig.dispose();
         SdkUtils_1.SdkUtils.dispose();
         ValueUtil_1.ValueUtil.dispose();
         ModelUtils_1.ModelUtils.dispose();
         (0, builderUtils_1.clearCxxTypeStringCache)();
+        (0, ArkFileBuilder_1.disposeClassMap)();
         this.moduleCache = undefined;
         this.memoryMonitor = undefined;
+        this.releaseSceneBuilder();
+        this.builtFileOrder = [];
+        this.moduleScenesMap.clear();
+        this.modulePath2NameMap.clear();
+        this.moduleSdkMap.clear();
+        this.projectSdkMap.clear();
+        if (this.statsExitHandler) {
+            process.removeListener('exit', this.statsExitHandler);
+            this.statsExitHandler = undefined;
+        }
+        (_a = this.stageStatistics) === null || _a === void 0 ? void 0 : _a.finish();
+        this.stageStatistics = undefined;
+        SignatureCanonicalizerRegistry_1.SignatureCanonicalizerRegistry.dispose();
+        // 组件名 stub 缓存随 Registry 同点清理（缓存实例的 temp symbol 属旧空间）。
+        ArkSignatureBuilder_1.ArkSignatureBuilder.clearComponentStubCache();
+    }
+    /** @internal Get the formal FileSignature canonicalizer. */
+    getFileSigCanonicalizer() {
+        return this.registry.fileSigCanonicalizer;
+    }
+    /** @internal Get the formal ClassSignature canonicalizer. */
+    getClassSigCanonicalizer() {
+        return this.registry.classSigCanonicalizer;
+    }
+    /** @internal Get the formal MethodSignature canonicalizer. */
+    getMethodSigCanonicalizer() {
+        return this.registry.methodSigCanonicalizer;
+    }
+    /** @internal Get the formal NamespaceSignature canonicalizer. */
+    getNamespaceSigCanonicalizer() {
+        return this.registry.namespaceSigCanonicalizer;
+    }
+    /** @internal Get the formal FieldSignature canonicalizer. */
+    getFieldSigCanonicalizer() {
+        return this.registry.fieldSigCanonicalizer;
     }
     getOptions() {
         return this.options;
@@ -154,23 +211,9 @@ class Scene {
     getOverRideDependencyMap() {
         return this.overRideDependencyMap;
     }
+    /** @deprecated Use {@link dispose} instead. */
     clear() {
-        var _a;
-        this.projectFiles = [];
-        this.moduleScenesMap.clear();
-        this.modulePath2NameMap.clear();
-        this.moduleSdkMap.clear();
-        this.projectSdkMap.clear();
-        this.filesMap.clear();
-        this.namespacesMap.clear();
-        this.classesMap.clear();
-        this.methodsMap.clear();
-        this.customComponentMap.clear();
-        this.sdkArkFilesMap.clear();
-        this.sdkGlobalMap.clear();
-        this.ohPkgContentMap.clear();
-        this.ohPkgContent = {};
-        (_a = this.moduleCache) === null || _a === void 0 ? void 0 : _a.clear();
+        this.dispose();
     }
     getStage() {
         return this.buildStage;
@@ -204,12 +247,30 @@ class Scene {
      ```
      */
     buildSceneFromProjectDir(sceneConfig) {
+        var _a, _b, _c, _d;
+        this.config(sceneConfig);
+        (_a = this.stageStatistics) === null || _a === void 0 ? void 0 : _a.start();
+        (_b = this.stageStatistics) === null || _b === void 0 ? void 0 : _b.startStage(StageStatistics_1.StageName.Builder);
         this.buildBasicInfo(sceneConfig);
         this.genArkFiles();
+        // 完整构建结束：释放构建期上下文（工作态随 GC 回收）。
+        this.releaseSceneBuilder();
+        (_c = this.stageStatistics) === null || _c === void 0 ? void 0 : _c.endStage(StageStatistics_1.StageName.Builder);
+        // 签名空间快照（时点 1）：构建完成后的 formal/temp 数据进报告。
+        (_d = this.stageStatistics) === null || _d === void 0 ? void 0 : _d.recordSignatureStats('post-build');
     }
     buildSceneFromFiles(sceneConfig) {
+        var _a, _b, _c, _d;
+        this.config(sceneConfig);
+        (_a = this.stageStatistics) === null || _a === void 0 ? void 0 : _a.start();
+        (_b = this.stageStatistics) === null || _b === void 0 ? void 0 : _b.startStage(StageStatistics_1.StageName.Builder);
         this.buildBasicInfo(sceneConfig);
-        this.getFilesOrderByDependency();
+        this.genArkFiles();
+        // 完整构建结束：释放构建期上下文（工作态随 GC 回收）。
+        this.releaseSceneBuilder();
+        (_c = this.stageStatistics) === null || _c === void 0 ? void 0 : _c.endStage(StageStatistics_1.StageName.Builder);
+        // 签名空间快照（时点 1）：构建完成后的 formal/temp 数据进报告。
+        (_d = this.stageStatistics) === null || _d === void 0 ? void 0 : _d.recordSignatureStats('post-build');
     }
     /**
      * Set the basic information of the scene using a config,
@@ -217,529 +278,21 @@ class Scene {
      * @param sceneConfig - the config used to set the basic information of scene.
      */
     buildBasicInfo(sceneConfig) {
-        var _a;
         this.sceneConfig = sceneConfig;
         this.options = sceneConfig.getOptions();
         this.projectName = sceneConfig.getTargetProjectName();
         this.realProjectDir = fs_1.default.realpathSync(sceneConfig.getTargetProjectDirectory());
-        this.projectFiles = sceneConfig.getProjectFiles();
         this.includeDirs = sceneConfig.getIncludeDirs();
         this.ccjsonPath = sceneConfig.getCcjsonPath();
         this.cppAstPath = sceneConfig.getCppAstPath();
-        this.parseBuildProfile();
-        this.parseOhPackage();
-        let tsConfigFilePath;
-        if (this.options.tsconfig) {
-            tsConfigFilePath = path_1.default.join(sceneConfig.getTargetProjectDirectory(), this.options.tsconfig);
-        }
-        else {
-            tsConfigFilePath = path_1.default.join(sceneConfig.getTargetProjectDirectory(), TSConst_1.TSCONFIG_JSON);
-        }
-        if (fs_1.default.existsSync(tsConfigFilePath)) {
-            const tsConfigObj = (0, json5parser_1.fetchDependenciesFromFile)(tsConfigFilePath);
-            this.findTsConfigInfoDeeply(tsConfigObj, tsConfigFilePath);
-        }
-        else {
-            logger.warn('This project has no tsconfig.json!');
-        }
-        this.buildOhPkgContentMap();
-        ModuleUtils_1.ModuleUtils.generateModuleMap(this.ohPkgContentMap);
-        // handle sdks
-        if (this.options.enableBuiltIn && !sceneConfig.getSdksObj().find(sdk => sdk.name === SdkUtils_1.SdkUtils.BUILT_IN_NAME)) {
-            sceneConfig.getSdksObj().unshift(SdkUtils_1.SdkUtils.getBuiltInSdk());
-        }
-        (_a = sceneConfig.getSdksObj()) === null || _a === void 0 ? void 0 : _a.forEach(sdk => {
-            if (!sdk.moduleName) {
-                this.buildSdk(sdk.name, path_1.default.normalize(sdk.path));
-                this.projectSdkMap.set(sdk.name, sdk);
-            }
-            else {
-                let moduleSdks = this.moduleSdkMap.get(sdk.moduleName);
-                if (moduleSdks) {
-                    moduleSdks.push(sdk);
-                }
-                else {
-                    this.moduleSdkMap.set(sdk.moduleName, [sdk]);
-                }
-            }
-        });
-        if (this.buildStage < SceneBuildStage.SDK_INFERRED) {
-            this.sdkArkFilesMap.forEach(file => {
-                // CXXTodo: C++ does not handle SDK files.
-                if (file.getLanguage() === ArkFile_1.Language.CXX) {
-                    return;
-                }
-                Inference_1.InferenceManager.getInstance().getInference(file.getLanguage()).doInfer(file);
-                SdkUtils_1.SdkUtils.mergeGlobalAPI(file, this.sdkGlobalMap);
-            });
-            this.sdkArkFilesMap.forEach(file => {
-                SdkUtils_1.SdkUtils.postInferredSdk(file, this.sdkGlobalMap);
-            });
-            this.buildStage = SceneBuildStage.SDK_INFERRED;
-        }
-        this.fileLanguages = sceneConfig.getFileLanguages();
-        SdkUtils_1.SdkUtils.extendArkUI(this);
-    }
-    parseBuildProfile() {
-        const buildProfile = path_1.default.join(this.realProjectDir, EtsConst_1.BUILD_PROFILE_JSON5);
-        if (fs_1.default.existsSync(buildProfile)) {
-            let configurationsText;
-            try {
-                configurationsText = fs_1.default.readFileSync(buildProfile, 'utf-8');
-            }
-            catch (error) {
-                logger.error(`Error reading file: ${error}`);
-                return;
-            }
-            const buildProfileJson = (0, json5parser_1.parseJsonText)(configurationsText);
-            SdkUtils_1.SdkUtils.setEsVersion(buildProfileJson);
-            const modules = buildProfileJson.modules;
-            if (modules instanceof Array) {
-                modules.forEach(module => {
-                    this.modulePath2NameMap.set(path_1.default.resolve(this.realProjectDir, path_1.default.join(module.srcPath)), module.name);
-                });
-            }
-        }
-        else {
-            logger.warn('There is no build-profile.json5 for this project.');
-        }
-    }
-    parseOhPackage() {
-        const OhPkgFilePath = path_1.default.join(this.realProjectDir, EtsConst_1.OH_PACKAGE_JSON5);
-        if (fs_1.default.existsSync(OhPkgFilePath)) {
-            this.ohPkgFilePath = OhPkgFilePath;
-            this.ohPkgContent = (0, json5parser_1.fetchDependenciesFromFile)(this.ohPkgFilePath);
-            this.ohPkgContentMap.set(OhPkgFilePath, this.ohPkgContent);
-            if (this.ohPkgContent.overrides) {
-                let overRides = this.ohPkgContent.overrides;
-                for (const [key, value] of Object.entries(overRides)) {
-                    this.overRides.set(key, value);
-                }
-            }
-            if (this.ohPkgContent.overrideDependencyMap) {
-                let globalOverRideDependencyMap = this.ohPkgContent.overrideDependencyMap;
-                for (const [key, value] of Object.entries(globalOverRideDependencyMap)) {
-                    let globalDependency = (0, json5parser_1.fetchDependenciesFromFile)(value);
-                    this.overRideDependencyMap.set(key, globalDependency);
-                }
-            }
-        }
-        else {
-            logger.warn('This project has no oh-package.json5!');
-        }
-    }
-    findTsConfigInfoDeeply(tsConfigObj, tsConfigFilePath) {
-        if (tsConfigObj.extends) {
-            const extTsConfigFilePath = path_1.default.join(path_1.default.dirname(tsConfigFilePath), tsConfigObj.extends);
-            const extTsConfigObj = (0, json5parser_1.fetchDependenciesFromFile)(extTsConfigFilePath);
-            this.findTsConfigInfoDeeply(extTsConfigObj, extTsConfigFilePath);
-            if (!this.baseUrl && !this.globalModule2PathMapping) {
-                this.addTsConfigInfo(extTsConfigObj);
-            }
-        }
-        if (!this.baseUrl && !this.globalModule2PathMapping) {
-            this.addTsConfigInfo(tsConfigObj);
-        }
-    }
-    addTsConfigInfo(tsConfigObj) {
-        if (tsConfigObj.compilerOptions && tsConfigObj.compilerOptions.paths) {
-            const paths = tsConfigObj.compilerOptions.paths;
-            if (paths) {
-                this.globalModule2PathMapping = paths;
-            }
-        }
-        if (tsConfigObj.compilerOptions && tsConfigObj.compilerOptions.baseUrl) {
-            this.baseUrl = tsConfigObj.compilerOptions.baseUrl;
-        }
-    }
-    /**
-     * Update or add default constructors for all classes in the scene.
-     *
-     * This function iterates through all files and classes in the scene,
-     * builds default constructors for each class, and processes existing constructors
-     * by replacing super constructor calls and adding initialization logic.
-     *
-     * @returns {void}
-     */
-    updateOrAddDefaultConstructors() {
-        for (const file of this.getFiles()) {
-            // CXXTodo: Select the appropriate initialization function based on file type
-            const initInConstructorFn = file.getLanguage() === ArkFile_1.Language.CXX ? ArkMethodBuilder_2.addInitInConstructor : ArkMethodBuilder_1.addInitInConstructor;
-            for (const cls of ModelUtils_1.ModelUtils.getAllClassesInFile(file)) {
-                (0, ArkMethodBuilder_1.buildDefaultConstructor)(cls);
-                // CXXTodo: Use the interface 'getAllMethodsWithName' for obtaining all methods with the same name.
-                const constructors = cls.getAllMethodsWithName(TSConst_1.CONSTRUCTOR_NAME);
-                if (cls.isDefaultArkClass()) {
-                    continue;
-                }
-                constructors.forEach(constructor => {
-                    (0, ArkMethodBuilder_1.replaceSuper2Constructor)(constructor);
-                    initInConstructorFn(constructor);
-                });
-            }
-        }
-    }
-    collectAllMethods() {
-        const methods = [];
-        for (const file of this.getFiles()) {
-            if (!this.options.enableOhModulesBody && file.getName().includes(EtsConst_1.OH_MODULES)) {
-                const defaultArkMethod = file.getDefaultClass().getDefaultArkMethod();
-                if (defaultArkMethod) {
-                    methods.push(defaultArkMethod);
-                }
-                continue;
-            }
-            for (const cls of file.getClasses()) {
-                for (const method of cls.getMethods(true)) {
-                    methods.push(method);
-                }
-            }
-        }
-        for (const namespace of this.getNamespacesMap().values()) {
-            if (!this.options.enableOhModulesBody && namespace.getDeclaringArkFile().getName().includes(EtsConst_1.OH_MODULES)) {
-                const defaultArkMethod = namespace.getDefaultClass().getDefaultArkMethod();
-                if (defaultArkMethod) {
-                    methods.push(defaultArkMethod);
-                }
-                continue;
-            }
-            for (const cls of namespace.getClasses()) {
-                for (const method of cls.getMethods(true)) {
-                    methods.push(method);
-                }
-            }
-        }
-        return methods;
-    }
-    static freeMethodBodyBuilder(method) {
-        var _a;
-        const isCxxFile = ((_a = method.getDeclaringArkFile()) === null || _a === void 0 ? void 0 : _a.getLanguage()) === ArkFile_1.Language.CXX;
-        if (isCxxFile) {
-            method.freeCxxBodyBuilder();
-        }
-        else {
-            method.freeBodyBuilder();
-        }
-    }
-    buildAllMethodBody() {
-        this.buildStage = SceneBuildStage.CLASS_DONE;
-        const methods = this.collectAllMethods();
-        for (const method of methods) {
-            try {
-                method.buildBody();
-            }
-            catch (error) {
-                logger.error('Error building body:', method.getSignature(), error);
-            }
-            finally {
-                Scene.freeMethodBodyBuilder(method);
-            }
-        }
-        ModelUtils_1.ModelUtils.dispose();
-        this.buildStage = SceneBuildStage.METHOD_DONE;
-    }
-    freeAllBodyBuilders() {
-        const methods = this.collectAllMethods();
-        for (const method of methods) {
-            Scene.freeMethodBodyBuilder(method);
-        }
+        const builder = this.getOrCreateSceneBuilder(sceneConfig);
+        builder.parseProjectConfigs();
+        builder.buildSdkStage();
     }
     genArkFiles() {
-        var _a;
-        FrontendBuilder_1.FrontendBuilder.buildFilesIntoArkFiles(this, this.projectFiles);
-        if ((_a = this.options.enableMethodBodyBuild) !== null && _a !== void 0 ? _a : true) {
-            this.buildAllMethodBody();
-            this.updateOrAddDefaultConstructors();
-        }
-        else {
-            this.freeAllBodyBuilders();
-            ModelUtils_1.ModelUtils.dispose();
-            this.buildStage = SceneBuildStage.METHOD_DONE;
-        }
-    }
-    getFilesOrderByDependency() {
-        var _a;
-        for (const projectFile of this.projectFiles) {
-            this.getDependencyFilesDeeply(projectFile);
-        }
-        if ((_a = this.options.enableMethodBodyBuild) !== null && _a !== void 0 ? _a : true) {
-            this.buildAllMethodBody();
-            this.updateOrAddDefaultConstructors();
-        }
-        else {
-            this.freeAllBodyBuilders();
-            ModelUtils_1.ModelUtils.dispose();
-            this.buildStage = SceneBuildStage.METHOD_DONE;
-        }
-    }
-    getDependencyFilesDeeply(projectFile) {
-        if (!this.options.supportFileExts.includes(path_1.default.extname(projectFile))) {
-            return;
-        }
-        const fileSignature = new ArkSignature_1.FileSignature(this.getProjectName(), path_1.default.relative(this.getRealProjectDir(), projectFile));
-        if (this.filesMap.has(fileSignature.toMapKey()) || this.isRepeatBuildFile(projectFile) || this.unhandledFilePaths.has(projectFile)) {
-            return;
-        }
-        // Here use unhandledFilePaths to temporarily store current file until add it to fileMaps to avoid recursively import issue.
-        this.unhandledFilePaths.add(projectFile);
-        try {
-            const arkFile = new ArkFile_1.ArkFile(FileUtils_1.FileUtils.getFileLanguage(projectFile, this.fileLanguages));
-            arkFile.setScene(this);
-            FrontendBuilder_1.FrontendBuilder.buildProjectFileIntoArkFile(this, projectFile, arkFile);
-            for (const [modulePath, moduleName] of this.modulePath2NameMap) {
-                if (arkFile.getFilePath().startsWith(modulePath)) {
-                    this.addArkFile2ModuleScene(modulePath, moduleName, arkFile);
-                    break;
-                }
-            }
-            const importInfos = arkFile.getImportInfos();
-            const repeatFroms = [];
-            this.findDependencyFiles(importInfos, arkFile, repeatFroms);
-            const exportInfos = arkFile.getExportInfos();
-            this.findDependencyFiles(exportInfos, arkFile, repeatFroms);
-            // add currently file to files map after adding all its dependencies, and remove it from unhandledFilePaths
-            this.setFile(arkFile);
-            this.unhandledFilePaths.delete(projectFile);
-        }
-        catch (error) {
-            logger.error('Error parsing file:', projectFile, error);
-            return;
-        }
-    }
-    isRepeatBuildFile(projectFile) {
-        const relativePath = path_1.default.relative(this.getRealProjectDir(), projectFile);
-        if (!relativePath.startsWith('..') && !path_1.default.isAbsolute(relativePath)) {
-            const mapKey = (0, FileUtils_1.getFileSignatureMapKey)(this.getProjectName(), relativePath);
-            return this.filesMap.has(mapKey);
-        }
-        return false;
-    }
-    addArkFile2ModuleScene(modulePath, moduleName, arkFile) {
-        if (this.moduleScenesMap.has(moduleName)) {
-            let curModuleScene = this.moduleScenesMap.get(moduleName);
-            if (curModuleScene) {
-                curModuleScene.addArkFile(arkFile);
-                arkFile.setModuleScene(curModuleScene);
-            }
-        }
-        else {
-            let moduleScene = new ModuleScene(this);
-            moduleScene.ModuleScenePartiallyBuilder(moduleName, modulePath);
-            moduleScene.addArkFile(arkFile);
-            this.moduleScenesMap.set(moduleName, moduleScene);
-            arkFile.setModuleScene(moduleScene);
-        }
-    }
-    findDependencyFiles(importOrExportInfos, arkFile, repeatFroms) {
-        for (const importOrExportInfo of importOrExportInfos) {
-            const from = importOrExportInfo.getFrom();
-            if (from && !repeatFroms.includes(from)) {
-                this.parseFrom(from, arkFile);
-                repeatFroms.push(from);
-            }
-        }
-    }
-    parseFrom(from, arkFile) {
-        if (/^@[a-z|\-]+?\/?/.test(from) || /^[a-z][a-z0-9._-]*[a-z0-9]$/.test(from)) {
-            // TODO: if there are more than one modules with the same name e.g. @lib1, here may got the wrong dependency
-            // It is better to loop all oh pkg with priority rather than the map key order. But it should be very complicated.
-            // Currently it is ok because it's with low probability and order error only affects type accuracy but has no other impact.
-            for (const [ohPkgContentPath, ohPkgContent] of this.ohPkgContentMap) {
-                this.findDependenciesByOhPkg(ohPkgContentPath, ohPkgContent, from);
-            }
-        }
-        else if (/^([^@]*\/)([^\/]*)$/.test(from) || /^[\.\./|\.\.]+$/.test(from)) {
-            this.findRelativeDependenciesByOhPkg(from, arkFile);
-        }
-        else if (/^[@a-zA-Z0-9]+(\/[a-zA-Z0-9]+)*$/.test(from)) {
-            this.findDependenciesByTsConfig(from);
-        }
-    }
-    findDependenciesByTsConfig(from) {
-        if (this.globalModule2PathMapping) {
-            const paths = this.globalModule2PathMapping;
-            Object.keys(paths).forEach(key => this.parseTsConfigParms(paths, key, from));
-        }
-    }
-    parseTsConfigParms(paths, key, from) {
-        const module2pathMapping = paths[key];
-        if (key.includes(TSConst_1.ALL)) {
-            this.processFuzzyMapping(key, from, module2pathMapping);
-        }
-        else if (from.startsWith(key)) {
-            let tail = from.substring(key.length, from.length);
-            module2pathMapping.forEach(pathMapping => {
-                let originPath = path_1.default.join(this.getRealProjectDir(), pathMapping, tail);
-                if (this.baseUrl) {
-                    originPath = path_1.default.resolve(this.baseUrl, originPath);
-                }
-                this.findDependenciesByRule(originPath);
-            });
-        }
-    }
-    processFuzzyMapping(key, from, module2pathMapping) {
-        key = key.substring(0, key.indexOf(TSConst_1.ALL) - 1);
-        if (from.substring(0, key.indexOf(TSConst_1.ALL) - 1) === key) {
-            let tail = from.substring(key.indexOf(TSConst_1.ALL) - 1, from.length);
-            module2pathMapping.forEach(pathMapping => {
-                pathMapping = pathMapping.substring(0, pathMapping.indexOf(TSConst_1.ALL) - 1);
-                let originPath = path_1.default.join(this.getRealProjectDir(), pathMapping, tail);
-                if (this.baseUrl) {
-                    originPath = path_1.default.join(this.baseUrl, originPath);
-                }
-                this.findDependenciesByRule(originPath);
-            });
-        }
-    }
-    findDependenciesByRule(originPath) {
-        if (!this.findFilesByPathArray(originPath) && !this.findFilesByExtNameArray(originPath, this.options.supportFileExts)) {
-            logger.trace(originPath + 'module mapperInfo is not found!');
-        }
-    }
-    findFilesByPathArray(originPath) {
-        if (!fs_1.default.existsSync(originPath)) {
-            return false;
-        }
-        const dirname = path_1.default.dirname(originPath);
-        const indexFileName = FileUtils_1.FileUtils.getIndexFileName(dirname);
-        if (indexFileName === '') {
-            return false;
-        }
-        const curPath = path_1.default.join(dirname, indexFileName);
-        if (!this.isRepeatBuildFile(curPath)) {
-            this.addFileNode2DependencyGrap(curPath);
-            return true;
-        }
-        return false;
-    }
-    findFilesByExtNameArray(originPath, pathArray) {
-        for (const pathInfo of pathArray) {
-            const curPath = originPath + pathInfo;
-            if (fs_1.default.existsSync(curPath) && !this.isRepeatBuildFile(curPath)) {
-                this.addFileNode2DependencyGrap(curPath);
-                return true;
-            }
-        }
-        return false;
-    }
-    findRelativeDependenciesByOhPkg(from, arkFile) {
-        //relative path ../from  ./from
-        //order
-        //1. ../from/oh-package.json5 -> [[name]] -> overRides/overRideDependencyMap? ->
-        //[[main]] -> file path ->dependencies(priority)+devDependencies? dynamicDependencies(not support) ->
-        //key overRides/overRideDependencyMap?
-        //2. ../from/index.ets(ts)
-        //3. ../from/index.d.ets(ts)
-        //4. ../from.ets(ts)
-        //5. ../from.d.ets(ts)
-        //2.3.4.5 random order
-        let originPath = this.getOriginPath(from, arkFile);
-        if (fs_1.default.existsSync(path_1.default.join(originPath, EtsConst_1.OH_PACKAGE_JSON5))) {
-            for (const [ohPkgContentPath, ohPkgContent] of this.ohPkgContentMap) {
-                this.findDependenciesByOhPkg(ohPkgContentPath, ohPkgContent, from);
-            }
-        }
-        this.findDependenciesByRule(originPath);
-    }
-    findDependenciesByOhPkg(ohPkgContentPath, ohPkgContentInfo, from) {
-        //module name @ohos/from
-        const ohPkgContent = ohPkgContentInfo;
-        //module main name is must be
-        if (ohPkgContent && ohPkgContent.name && from.startsWith(ohPkgContent.name.toString())) {
-            let originPath = ohPkgContentPath.toString().replace(EtsConst_1.OH_PACKAGE_JSON5, '');
-            if (ohPkgContent.main) {
-                originPath = path_1.default.join(ohPkgContentPath.toString().replace(EtsConst_1.OH_PACKAGE_JSON5, ''), ohPkgContent.main.toString());
-                if (ohPkgContent.dependencies) {
-                    this.getDependenciesMapping(ohPkgContent.dependencies, ohPkgContentPath, from);
-                }
-                else if (ohPkgContent.devDependencies) {
-                    this.getDependenciesMapping(ohPkgContent.devDependencies, ohPkgContentPath, from);
-                }
-                else if (ohPkgContent.dynamicDependencies) {
-                    // dynamicDependencies not support
-                }
-                this.addFileNode2DependencyGrap(originPath);
-            }
-            if (!this.findFilesByPathArray(originPath)) {
-                logger.trace(originPath + 'module mapperInfo is not found!');
-            }
-        }
-    }
-    getDependenciesMapping(dependencies, ohPkgContentPath, from) {
-        for (let [moduleName, modulePath] of Object.entries(dependencies)) {
-            logger.debug('dependencies:' + moduleName);
-            if (modulePath.startsWith('file:')) {
-                modulePath = modulePath.replace(/^file:/, '');
-            }
-            const innerOhpackagePath = path_1.default.join(ohPkgContentPath.replace(EtsConst_1.OH_PACKAGE_JSON5, ''), modulePath.toString(), EtsConst_1.OH_PACKAGE_JSON5);
-            if (!this.ohPkgContentMap.has(innerOhpackagePath)) {
-                const innerModuleOhPkgContent = (0, json5parser_1.fetchDependenciesFromFile)(innerOhpackagePath);
-                this.findDependenciesByOhPkg(innerOhpackagePath, innerModuleOhPkgContent, from);
-            }
-        }
-    }
-    getOriginPath(from, arkFile) {
-        const parentPath = /^\.{1,2}\//.test(from) ? path_1.default.dirname(arkFile.getFilePath()) : arkFile.getProjectDir();
-        return path_1.default.resolve(parentPath, from);
-    }
-    addFileNode2DependencyGrap(filePath) {
-        this.getDependencyFilesDeeply(filePath);
-    }
-    /**
-     * Loads SDK sources into the scene. C++ SDK files are intentionally skipped: they are not parsed or registered
-     * here (only non-C++ SDK sources are processed).
-     */
-    buildSdk(sdkName, sdkPath) {
-        const allFiles = this.collectSdkFiles(sdkName, sdkPath);
-        allFiles.forEach(file => {
-            if (FileUtils_1.FileUtils.getFileLanguage(file, this.fileLanguages) === ArkFile_1.Language.CXX) {
-                return;
-            }
-            this.parseAndRegisterSdkFile(file, sdkPath, sdkName);
-        });
-    }
-    collectSdkFiles(sdkName, sdkPath) {
-        var _a;
-        if (sdkName === SdkUtils_1.SdkUtils.BUILT_IN_NAME) {
-            const builtInFiles = SdkUtils_1.SdkUtils.fetchBuiltInFiles(sdkPath);
-            if (builtInFiles.length > 0) {
-                (_a = this.getOptions().sdkGlobalFolders) === null || _a === void 0 ? void 0 : _a.push(sdkPath);
-            }
-            return builtInFiles;
-        }
-        SdkUtils_1.SdkUtils.loadSystemComponentsFromSdk(sdkPath);
-        return (0, getAllFiles_1.getAllFiles)(sdkPath, this.options.supportFileExts, this.options.ignoreFileNames);
-    }
-    parseAndRegisterSdkFile(file, sdkPath, sdkName) {
-        logger.trace('=== parse sdk file:', file);
-        try {
-            const arkFile = new ArkFile_1.ArkFile(FileUtils_1.FileUtils.getFileLanguage(file, this.fileLanguages));
-            arkFile.setScene(this);
-            ArktsFrontend_1.ArktsFrontend.buildArkFileFromSdkPath(file, sdkPath, arkFile, sdkName);
-            ModelUtils_1.ModelUtils.getAllClassesInFile(arkFile).forEach(cls => {
-                var _a, _b;
-                (_a = cls.getDefaultArkMethod()) === null || _a === void 0 ? void 0 : _a.buildBody();
-                (_b = cls.getDefaultArkMethod()) === null || _b === void 0 ? void 0 : _b.freeBodyBuilder();
-            });
-            // Release all method builders in SDK file to avoid retaining AST/build context in memory.
-            ModelUtils_1.ModelUtils.getAllMethodsInFile(arkFile).forEach(method => {
-                var _a;
-                if (((_a = method.getDeclaringArkFile()) === null || _a === void 0 ? void 0 : _a.getLanguage()) === ArkFile_1.Language.CXX) {
-                    method.freeCxxBodyBuilder();
-                }
-                else {
-                    method.freeBodyBuilder();
-                }
-            });
-            const fileSig = arkFile.getFileSignature().toMapKey();
-            this.sdkArkFilesMap.set(fileSig, arkFile);
-            SdkUtils_1.SdkUtils.buildSdkImportMap(arkFile);
-            SdkUtils_1.SdkUtils.loadGlobalAPI(arkFile, this.sdkGlobalMap);
-        }
-        catch (error) {
-            logger.error('Error parsing file:', file, error);
-            this.unhandledSdkFilePaths.push(file);
-        }
+        const builder = this.getOrCreateSceneBuilder();
+        builder.buildProjectFiles();
+        builder.buildAllMethodBodies();
     }
     /**
      * Build the scene for harmony project. It resolves the file path of the project first, and then fetches
@@ -747,83 +300,14 @@ class Scene {
      * it build bodies of all methods, generate extended classes, and add DefaultConstructors.
      */
     buildScene4HarmonyProject() {
-        var _a;
-        this.modulePath2NameMap.forEach((value, key) => {
-            let moduleScene = new ModuleScene(this);
-            moduleScene.ModuleSceneBuilder(value, key, this.options.supportFileExts);
-            this.moduleScenesMap.set(value, moduleScene);
-        });
-        if ((_a = this.options.enableMethodBodyBuild) !== null && _a !== void 0 ? _a : true) {
-            this.buildAllMethodBody();
-            this.updateOrAddDefaultConstructors();
-        }
-        else {
-            this.freeAllBodyBuilders();
-            ModelUtils_1.ModelUtils.dispose();
-            this.buildStage = SceneBuildStage.METHOD_DONE;
-        }
-    }
-    buildOhPkgContentMap() {
-        this.modulePath2NameMap.forEach((value, key) => {
-            const moduleOhPkgFilePath = path_1.default.resolve(key, EtsConst_1.OH_PACKAGE_JSON5);
-            if (fs_1.default.existsSync(moduleOhPkgFilePath)) {
-                const moduleOhPkgContent = (0, json5parser_1.fetchDependenciesFromFile)(moduleOhPkgFilePath);
-                this.ohPkgContentMap.set(moduleOhPkgFilePath, moduleOhPkgContent);
-            }
-        });
+        this.getOrCreateSceneBuilder().buildScene4HarmonyProject();
+        this.releaseSceneBuilder();
     }
+    /**
+     * 单模块构建（增量式入口，可连续调用构建多个模块）：ohpkg 依赖递归 + 模块 DFS + body 构建，全部经构建期上下文。此处不释放上下文（连续构建共享工作态）。
+     */
     buildModuleScene(moduleName, modulePath, supportFileExts) {
-        var _a;
-        if (this.moduleScenesMap.get(moduleName)) {
-            return;
-        }
-        // get oh-package.json5
-        const moduleOhPkgFilePath = path_1.default.resolve(this.realProjectDir, path_1.default.join(modulePath, EtsConst_1.OH_PACKAGE_JSON5));
-        if (fs_1.default.existsSync(moduleOhPkgFilePath)) {
-            const moduleOhPkgContent = (0, json5parser_1.fetchDependenciesFromFile)(moduleOhPkgFilePath);
-            this.ohPkgContentMap.set(moduleOhPkgFilePath, moduleOhPkgContent);
-        }
-        else {
-            logger.warn('Module: ', moduleName, 'has no oh-package.json5.');
-        }
-        // parse moduleOhPkgContent, get dependencies and build dependent module
-        const moduleOhPkgContent = this.ohPkgContentMap.get(moduleOhPkgFilePath);
-        if (moduleOhPkgContent) {
-            if (moduleOhPkgContent.dependencies instanceof Object) {
-                this.processModuleOhPkgContent(moduleOhPkgContent.dependencies, moduleOhPkgFilePath, supportFileExts);
-            }
-        }
-        let moduleScene = new ModuleScene(this);
-        moduleScene.ModuleSceneBuilder(moduleName, modulePath, supportFileExts);
-        this.moduleScenesMap.set(moduleName, moduleScene);
-        if ((_a = this.options.enableMethodBodyBuild) !== null && _a !== void 0 ? _a : true) {
-            this.buildAllMethodBody();
-        }
-        else {
-            this.freeAllBodyBuilders();
-            ModelUtils_1.ModelUtils.dispose();
-            this.buildStage = SceneBuildStage.METHOD_DONE;
-        }
-    }
-    processModuleOhPkgContent(dependencies, moduleOhPkgFilePath, supportFileExts) {
-        Object.entries(dependencies).forEach(([k, v]) => {
-            const pattern = new RegExp('^(\\.\\.\\/\|\\.\\/)');
-            if (typeof v === 'string') {
-                let dependencyModulePath = '';
-                if (pattern.test(v)) {
-                    dependencyModulePath = path_1.default.join(moduleOhPkgFilePath, v);
-                }
-                else if (v.startsWith('file:')) {
-                    const dependencyFilePath = path_1.default.join(moduleOhPkgFilePath, v.replace(/^file:/, ''));
-                    const dependencyOhPkgPath = (0, FileUtils_1.getFileRecursively)(path_1.default.dirname(dependencyFilePath), EtsConst_1.OH_PACKAGE_JSON5);
-                    dependencyModulePath = path_1.default.dirname(dependencyOhPkgPath);
-                }
-                const dependencyModuleName = this.modulePath2NameMap.get(dependencyModulePath);
-                if (dependencyModuleName) {
-                    this.buildModuleScene(dependencyModuleName, dependencyModulePath, supportFileExts);
-                }
-            }
-        });
+        this.getOrCreateSceneBuilder().buildModuleScene(moduleName, modulePath, supportFileExts);
     }
     /**
      * Get the absolute path of current project.
@@ -859,6 +343,14 @@ class Scene {
             this.realProjectDir = fs_1.default.realpathSync(dir);
         }
         this.fileLanguages = sceneConfig.getFileLanguages();
+        if (this.options.enableStatistics && !this.stageStatistics) {
+            this.stageStatistics = new StageStatistics_1.StageStatistics(true);
+            this.registerStatsExitHook();
+        }
+    }
+    /** @internal 供构建期上下文（SceneBuilder）打点使用：返回统计收集器，未启用统计时为 undefined（各打点调用自动 no-op）。 */
+    getStageStatisticsCollector() {
+        return this.stageStatistics;
     }
     /**
      * Returns all registered {@link ArkModule} objects.
@@ -922,9 +414,9 @@ class Scene {
      * Perform module-level analysis by iterating modules in topological order and invoking
      * the callback for each module.
      *
-     * Flow: prepareModules → analyzeModuleDependencies → buildSdkModules (SDK files parsed +
-     * inferred first) → resolveTargetModuleIds → computeModuleClosureByIds → iterate topoOrder
-     * → loadModule → callback.
+     * Flow: prepareModules → analyzeModuleDependencies → buildSdkModules (SDK loaded
+     * inferred first) → resolveTargetModuleIds → computeModuleClosureByIds →
+     * getFilteredTopoOrder → loadModule → callback.
      * Each step is idempotent; repeated calls do not repeat preprocessing.
      *
      * - SDK modules are registered and built in one fused step by {@link ModuleBuilder.buildSdkModules}
@@ -947,7 +439,7 @@ class Scene {
             builder.analyzeModuleDependencies();
             this.setModulesRegistered(true);
         }
-        // 2. Build SDK modules — fused registration + building (idempotent). SDK loaded FIRST so
+        // 2. Build SDK modules → fused registration + building (idempotent). SDK loaded FIRST so
         //    that global APIs are available when project/oh_modules modules are loaded.
         builder.buildSdkModules();
         // 3. Resolve target modules and compute closure (unified flow, no branching)
@@ -983,7 +475,7 @@ class Scene {
             }
             callback(module, this);
         }
-        // 7. No unload, no dispose — modules persist in cache for cross-call reuse
+        // 7. No unload, no dispose → modules persist in cache for cross-call reuse
     }
     /**
      * Returns the **string** name of the project.
@@ -992,41 +484,20 @@ class Scene {
     getProjectName() {
         return this.projectName;
     }
-    getProjectFiles() {
-        return this.projectFiles;
-    }
+    /** @deprecated Compatibility delegate only — no longer used internally. Use {@link SdkUtils.getSdkGlobal} instead. */
     getSdkGlobal(globalName) {
-        return this.sdkGlobalMap.get(globalName) || null;
+        return SdkUtils_1.SdkUtils.getSdkGlobal(globalName);
     }
+    /** @deprecated Compatibility delegate only — no longer used internally. Use `SignatureCanonicalizerRegistry.getInstance().sdkGlobalMap` instead. */
     getSdkGlobalMap() {
-        return this.sdkGlobalMap;
+        return SignatureCanonicalizerRegistry_1.SignatureCanonicalizerRegistry.getInstance().sdkGlobalMap;
     }
-    /**
-     * Returns the file based on its signature.
-     * If no file can be found according to the input signature, **null** will be returned.
-     * A typical {@link ArkFile} contains: file's name (i.e., its relative path), project's name,
-     * project's dir, file's signature etc.
-     * @param fileSignature - the signature of file.
-     * @returns a file defined by ArkAnalyzer. **null** will be returned if no file could be found.
-     * @example
-     * 1. get ArkFile based on file signature.
-
-     ```typescript
-     if (...) {
-     const fromSignature = new FileSignature();
-     fromSignature.setProjectName(im.getDeclaringArkFile().getProjectName());
-     fromSignature.setFileName(fileName);
-     return scene.getFile(fromSignature);
-     }
-     ```
-     */
-    getFile(fileSignature) {
-        if (this.projectName === fileSignature.getProjectName()) {
-            return this.filesMap.get(fileSignature.toMapKey()) || null;
-        }
-        else {
-            return this.sdkArkFilesMap.get(fileSignature.toMapKey()) || null;
+    getFile(fileSigOrId) {
+        var _a, _b;
+        if (typeof fileSigOrId === 'number') {
+            return (_a = this.registry.fileSigCanonicalizer.getModel(fileSigOrId)) !== null && _a !== void 0 ? _a : null;
         }
+        return (_b = this.registry.fileSigCanonicalizer.getModel(this.registry.fileSigCanonicalizer.getExistingId(fileSigOrId))) !== null && _b !== void 0 ? _b : null;
     }
     /*
      * Returns the absolute file paths that cannot be handled currently.
@@ -1034,8 +505,9 @@ class Scene {
     getUnhandledFilePaths() {
         return Array.from(this.unhandledFilePaths);
     }
-    addUnhandledFilePath(filePath) {
-        this.unhandledFilePaths.add(filePath);
+    /** @internal 原始引用（Set）：构建期上下文作防环工作集复用（成功 delete、失败残留）。 */
+    getUnhandledFileSet() {
+        return this.unhandledFilePaths;
     }
     /*
      * Returns the absolute sdk file paths that cannot be handled currently.
@@ -1043,55 +515,75 @@ class Scene {
     getUnhandledSdkFilePaths() {
         return this.unhandledSdkFilePaths;
     }
+    /** @internal 非用户 API。*/
     setFile(file) {
-        this.filesMap.set(file.getFileSignature().toMapKey(), file);
+        file.setScene(this);
+        file.setProjectFile(true);
+        // 记录构建完成序（后序 = 拓扑序），见字段注释与 inferTypes。
+        this.builtFileOrder.push(file.getFileSigID());
     }
-    /**
-     * Add an SDK ArkFile to the scene's `sdkArkFilesMap`, keyed by its file signature.
-     * Used by {@link ModuleBuilder.parseAndRegisterSdkFile} during SDK file registration.
-     */
+    /** @internal project 文件的构建完成序（拓扑序：被依赖者在前）。推断期遍历事实源。 */
+    getBuiltFileOrder() {
+        return this.builtFileOrder;
+    }
+    /** @internal 非用户 API。*/
     addSdkArkFile(arkFile) {
-        this.sdkArkFilesMap.set(arkFile.getFileSignature().toMapKey(), arkFile);
+        // 防御断言：边界已设置后不应再注册 SDK 文件（构建时序破坏，理论不可达）。
+        if (this.registry.getFirstProjectFileSigID() !== -1) {
+            logger.warn(`SDK file registered after the project/SDK ID boundary was marked: ${arkFile.getName()}`);
+        }
+        arkFile.setScene(this);
+        arkFile.setProjectFile(false);
     }
-    hasSdkFile(fileSignature) {
-        return this.sdkArkFilesMap.has(fileSignature.toMapKey());
+    hasSdkFile(fileSigOrId) {
+        let file;
+        if (typeof fileSigOrId === 'number') {
+            file = this.registry.fileSigCanonicalizer.getModel(fileSigOrId);
+        }
+        else {
+            file = this.registry.fileSigCanonicalizer.getModel(this.registry.fileSigCanonicalizer.getExistingId(fileSigOrId));
+        }
+        return file !== undefined && !file.isProjectFile();
     }
     /**
-     * Get files of a {@link Scene}. Generally, a project includes several ets/ts files that define the different
-     * class. We need to generate {@link ArkFile} objects from these ets/ts files.
-     * @returns The array of {@link ArkFile} from `scene.filesMap.values()`.
-     * @example
-     * 1. In inferSimpleTypes() to check arkClass and arkMethod.
-     * ```typescript
-     * public inferSimpleTypes(): void {
-     *   for (let arkFile of this.getFiles()) {
-     *       for (let arkClass of arkFile.getClasses()) {
-     *           for (let arkMethod of arkClass.getMethods()) {
-     *           // ... ...;
-     *           }
-     *       }
-     *   }
-     * }
-     * ```
-     * 2. To iterate each method
-     * ```typescript
-     * for (const file of this.getFiles()) {
-     *     for (const cls of file.getClasses()) {
-     *         for (const method of cls.getMethods()) {
-     *             // ... ...
-     *         }
-     *     }
-     * }
-     *```
+     * 获取全部 project 文件（不含 SDK 文件）。
      */
     getFiles() {
-        return Array.from(this.filesMap.values());
+        const first = this.registry.getFirstProjectFileSigID();
+        if (first === -1) {
+            return [];
+        }
+        const size = this.registry.fileSigCanonicalizer.size();
+        const result = [];
+        for (let id = first; id < size; id++) {
+            const model = this.registry.fileSigCanonicalizer.getModel(id);
+            if (model !== undefined) {
+                result.push(model);
+            }
+        }
+        return result;
     }
     getFileLanguages() {
         return this.fileLanguages;
     }
+    /** @internal 构建期上下文在 SDK 阶段末尾回填语言表（保持与迁移前一致的赋值时序）。 */
+    setFileLanguages(fileLanguages) {
+        this.fileLanguages = fileLanguages;
+    }
+    /** 获取全部 SDK 文件。 */
     getSdkArkFiles() {
-        return Array.from(this.sdkArkFilesMap.values());
+        const first = this.registry.getFirstProjectFileSigID();
+        if (first === -1) {
+            return [];
+        }
+        const result = [];
+        for (let id = 1; id < first; id++) {
+            const model = this.registry.fileSigCanonicalizer.getModel(id);
+            if (model !== undefined) {
+                result.push(model);
+            }
+        }
+        return result;
     }
     getModuleSdkMap() {
         return this.moduleSdkMap;
@@ -1099,159 +591,83 @@ class Scene {
     getProjectSdkMap() {
         return this.projectSdkMap;
     }
+    /**
+     * Returns the namespace according to the input namespace signature.
+     * @param namespaceSignature - signature of the namespace to be obtained.
+     * @returns A namespace, or null when the signature was never interned.
+     */
     getNamespace(namespaceSignature) {
-        const isProject = this.projectName === namespaceSignature.getDeclaringFileSignature().getProjectName();
-        let namespace;
-        if (isProject) {
-            namespace = this.namespacesMap.get(namespaceSignature.toMapKey());
-        }
-        if (namespace) {
-            return namespace;
-        }
-        namespace = this.getNamespaceBySignature(namespaceSignature);
-        if (isProject && namespace) {
-            this.namespacesMap.set(namespaceSignature.toMapKey(), namespace);
-        }
-        return namespace || null;
-    }
-    getNamespaceBySignature(signature) {
-        const parentSignature = signature.getDeclaringNamespaceSignature();
-        if (parentSignature) {
-            const parentNamespace = this.getNamespaceBySignature(parentSignature);
-            return (parentNamespace === null || parentNamespace === void 0 ? void 0 : parentNamespace.getNamespace(signature)) || null;
-        }
-        else {
-            const arkFile = this.getFile(signature.getDeclaringFileSignature());
-            return (arkFile === null || arkFile === void 0 ? void 0 : arkFile.getNamespace(signature)) || null;
+        var _a;
+        const id = this.registry.namespaceSigCanonicalizer.getExistingId(namespaceSignature);
+        if (id === -1) {
+            return null;
         }
+        return (_a = this.registry.namespaceSigCanonicalizer.getModel(id)) !== null && _a !== void 0 ? _a : null;
     }
-    getNamespacesMap() {
-        if (this.buildStage === SceneBuildStage.CLASS_DONE) {
-            for (const file of this.getFiles()) {
-                ModelUtils_1.ModelUtils.getAllNamespacesInFile(file).forEach(namespace => {
-                    this.namespacesMap.set(namespace.getNamespaceSignature().toMapKey(), namespace);
-                });
+    /** 获取全部 project 文件的 ArkNamespace（不含 SDK，含嵌套层级摊平）。*/
+    getNamespaces() {
+        const reg = this.registry;
+        const size = reg.namespaceSigCanonicalizer.size();
+        const result = [];
+        for (let id = 1; id < size; id++) {
+            const ns = reg.namespaceSigCanonicalizer.getModel(id);
+            if (ns === undefined) {
+                continue;
+            }
+            if (!ns.getDeclaringArkFile().isProjectFile()) {
+                continue;
             }
+            result.push(ns);
         }
-        return this.namespacesMap;
-    }
-    getNamespaces() {
-        return Array.from(this.getNamespacesMap().values());
+        return result;
     }
     /**
      * Returns the class according to the input class signature.
      * @param classSignature - signature of the class to be obtained.
-     * @returns A class.
+     * @returns A class, or null when the signature was never interned.
      */
     getClass(classSignature) {
         var _a;
-        const isProject = this.projectName === classSignature.getDeclaringFileSignature().getProjectName();
-        let arkClass;
-        if (isProject) {
-            arkClass = this.classesMap.get(classSignature.toMapKey());
-        }
-        if (arkClass) {
-            return arkClass;
-        }
-        const namespaceSignature = classSignature.getDeclaringNamespaceSignature();
-        if (namespaceSignature) {
-            arkClass = ((_a = this.getNamespaceBySignature(namespaceSignature)) === null || _a === void 0 ? void 0 : _a.getClass(classSignature)) || null;
-        }
-        else {
-            const arkFile = this.getFile(classSignature.getDeclaringFileSignature());
-            arkClass = arkFile === null || arkFile === void 0 ? void 0 : arkFile.getClass(classSignature);
-        }
-        if (isProject && arkClass) {
-            this.classesMap.set(classSignature.toMapKey(), arkClass);
-        }
-        return arkClass || null;
-    }
-    /**
-     * Register a custom {@code @Component} into {@link customComponentMap}.
-     * Called from ArkClass builders (full Scene build and module load share the same path).
-     * Entries intentionally survive module unload so ViewTree can still resolve signatures.
-     */
-    registerCustomComponent(cls) {
-        if (!cls.hasComponentDecorator()) {
-            return;
-        }
-        const name = cls.getName();
-        if (!name || name.startsWith('%')) {
-            return;
-        }
-        this.customComponentMap.set(name, cls.getSignature());
-    }
-    /**
-     * Remove a custom component entry. Not called on module unload — the map must outlive IR.
-     * Used when an ArkClass is explicitly removed from a live Scene, or via {@link clear}.
-     */
-    unregisterCustomComponent(cls) {
-        const name = cls.getName();
-        if (!name || !cls.hasComponentDecorator()) {
-            return;
-        }
-        const existing = this.customComponentMap.get(name);
-        if (existing && existing.toMapKey() === cls.getSignature().toMapKey()) {
-            this.customComponentMap.delete(name);
+        const id = this.registry.classSigCanonicalizer.getExistingId(classSignature);
+        if (id === -1) {
+            return null;
         }
+        return (_a = this.registry.classSigCanonicalizer.getModel(id)) !== null && _a !== void 0 ? _a : null;
     }
     getCustomComponent(name) {
-        return name ? this.customComponentMap.get(name) : undefined;
+        return name ? this.registry.customComponentMap.get(name) : undefined;
     }
     getCustomComponentMap() {
-        return this.customComponentMap;
-    }
-    getClassesMap(refresh) {
-        if (refresh || this.buildStage === SceneBuildStage.METHOD_DONE) {
-            this.classesMap.clear();
-            for (const file of this.getFiles()) {
-                for (const cls of file.getClasses()) {
-                    this.classesMap.set(cls.getSignature().toMapKey(), cls);
-                }
-            }
-            for (const namespace of this.getNamespacesMap().values()) {
-                for (const cls of namespace.getClasses()) {
-                    this.classesMap.set(cls.getSignature().toMapKey(), cls);
-                }
+        return this.registry.customComponentMap;
+    }
+    /** 获取全部 project 文件的 ArkClass（不含 SDK 类）。*/
+    getClasses() {
+        const reg = this.registry;
+        const size = reg.classSigCanonicalizer.size();
+        const result = [];
+        for (let id = 1; id < size; id++) {
+            const cls = reg.classSigCanonicalizer.getModel(id);
+            if (cls === undefined) {
+                continue;
             }
-            if (this.buildStage < SceneBuildStage.CLASS_COLLECTED) {
-                this.buildStage = SceneBuildStage.CLASS_COLLECTED;
+            if (!cls.getDeclaringArkFile().isProjectFile()) {
+                continue;
             }
+            result.push(cls);
         }
-        return this.classesMap;
-    }
-    getClasses() {
-        return Array.from(this.getClassesMap().values());
+        return result;
     }
-    getMethod(methodSignature, refresh) {
-        var _a;
-        const isProject = this.projectName === methodSignature.getDeclaringClassSignature().getDeclaringFileSignature().getProjectName();
-        let arkMethod;
-        if (isProject) {
-            arkMethod = this.methodsMap.get(methodSignature.toMapKey());
-        }
-        if (arkMethod) {
+    getMethod(methodSignature, _refresh) {
+        var _a, _b;
+        // Fast path: O(1) model lookup (read-only, never interns the signature).
+        const arkMethod = this.registry.getMethodBySig(methodSignature);
+        if (arkMethod !== undefined) {
             return arkMethod;
         }
-        arkMethod = (_a = this.getClass(methodSignature.getDeclaringClassSignature())) === null || _a === void 0 ? void 0 : _a.getMethod(methodSignature);
-        if (isProject && arkMethod) {
-            this.methodsMap.set(methodSignature.toMapKey(), arkMethod);
-        }
-        return arkMethod || null;
-    }
-    getMethodsMap(refresh) {
-        if (refresh || (this.buildStage >= SceneBuildStage.METHOD_DONE && this.buildStage < SceneBuildStage.METHOD_COLLECTED)) {
-            this.methodsMap.clear();
-            for (const cls of this.getClassesMap(refresh).values()) {
-                for (const method of cls.getMethods(true)) {
-                    this.methodsMap.set(method.getSignature().toMapKey(), method);
-                }
-            }
-            if (this.buildStage < SceneBuildStage.METHOD_COLLECTED) {
-                this.buildStage = SceneBuildStage.METHOD_COLLECTED;
-            }
-        }
-        return this.methodsMap;
+        // Fallback: closure-rebuilt signatures may not be registered as models yet —
+        // resolve via the declaring class's local traversal (isMatch-based). Read-only:
+        // no interning and no model back-fill (query paths must not write).
+        return (_b = (_a = this.getClass(methodSignature.getDeclaringClassSignature())) === null || _a === void 0 ? void 0 : _a.getMethod(methodSignature)) !== null && _b !== void 0 ? _b : null;
     }
     /**
      * Returns the method associated with the method signature.
@@ -1265,7 +681,6 @@ class Scene {
      * - View tree: the view tree of the method.
      * - ...
      *
-     * @param methodSignature - the signature of method.
      * @returns The method associated with the method signature.
      * @example
      * 1. get method from getMethod.
@@ -1279,29 +694,19 @@ class Scene {
      ```
      */
     getMethods() {
-        return Array.from(this.getMethodsMap().values());
-    }
-    addToMethodsMap(method) {
-        this.methodsMap.set(method.getSignature().toMapKey(), method);
-    }
-    removeMethod(method) {
-        return this.methodsMap.delete(method.getSignature().toMapKey());
-    }
-    removeClass(arkClass) {
-        this.unregisterCustomComponent(arkClass);
-        return this.classesMap.delete(arkClass.getSignature().toMapKey());
-    }
-    removeNamespace(namespace) {
-        return this.namespacesMap.delete(namespace.getSignature().toMapKey());
-    }
-    removeFile(file) {
-        return this.filesMap.delete(file.getFileSignature().toMapKey());
+        const methods = [];
+        for (const cls of this.getClasses()) {
+            for (const method of cls.getMethods(true)) {
+                methods.push(method);
+            }
+        }
+        return methods;
     }
     /**
      * Dispose a module's data from all global indices.
      *
      * Removes the module's ArkFiles, ArkClasses, ArkMethods, and ArkNamespaces from the Scene's
-     * global maps (filesMap, sdkArkFilesMap, classesMap, methodsMap, namespacesMap) and clears
+     * global canonicalizers and clears
      * the oh-package.json5 content cache. After this call, the module's heavy data is no longer
      * reachable via Scene's global indices and can be garbage-collected.
      *
@@ -1311,33 +716,37 @@ class Scene {
      * @param module - The module whose data should be removed from global indices.
      */
     disposeModule(module) {
+        var _a;
         for (const arkFile of module.getFilesMap().values()) {
-            const key = arkFile.getFileSignature().toMapKey();
-            this.filesMap.delete(key);
-            this.sdkArkFilesMap.delete(key);
-            for (const ns of ModelUtils_1.ModelUtils.getAllNamespacesInFile(arkFile)) {
-                this.namespacesMap.delete(ns.getNamespaceSignature().toMapKey());
+            this.registry.removeFile(arkFile);
+            for (const ns of arkFile.getAllNamespacesUnderThisFile()) {
+                this.registry.removeNamespace(ns);
             }
             for (const cls of ModelUtils_1.ModelUtils.getAllClassesInFile(arkFile)) {
-                this.classesMap.delete(cls.getSignature().toMapKey());
-                for (const mtd of cls.getMethods()) {
-                    this.methodsMap.delete(mtd.getSignature().toMapKey());
-                    // Release heavy per-method IR (ArkBody/CFG/Stmt/Locals + ViewTree) so it can
-                    // be GC'd on eviction, even if the ArkMethod/ArkFile skeleton is still referenced
+                this.registry.removeClassModel(cls);
+                for (const fld of cls.getFields()) {
+                    this.registry.removeField(fld);
+                }
+                for (const mtd of cls.getMethods(true)) {
+                    this.registry.removeMethod(mtd);
+                    // Release heavy per-method IR (ArkBody/CFG/Stmt/Locals + ViewTree) so it can be
+                    // GC'd on eviction, even if the ArkMethod/ArkFile skeleton is still referenced
                     // by residual back-edges. Bodies/viewTrees are rebuilt on reload.
                     mtd.clearBodyAndSupplementary();
                 }
-                // Sever back-references: remove this class from its base classes' extendedClasses,
+                // Sever back-references: remove this class from its base classes' extended classes,
                 // otherwise base classes (e.g. SDK) keep evicted project classes alive (memory leak).
                 for (const base of cls.getAllHeritageClasses()) {
-                    base.getExtendedClasses().delete(cls.getName());
+                    base.removeExtendedClass(cls);
                 }
             }
             // Release the TS AST (SourceFile) and cached source text; getCode() re-reads from disk.
             arkFile.setAST(null);
             arkFile.clearSourceCode();
         }
-        this.ohPkgContentMap.delete(module.getOhPkgPath());
+        // 驱逐模块的 oh-package 表项清理：经活跃构建上下文 best-effort（增量路径
+        // 上下文通常已释放，此时无 DFS 消费该表，跳过安全）。
+        (_a = this.getActiveSceneBuilder()) === null || _a === void 0 ? void 0 : _a.getOhPkgContentMap().delete(module.getOhPkgPath());
     }
     hasMainMethod() {
         return false;
@@ -1350,15 +759,6 @@ class Scene {
     getVisibleValue() {
         return this.visibleValue;
     }
-    getOhPkgContent() {
-        return this.ohPkgContent;
-    }
-    getOhPkgContentMap() {
-        return this.ohPkgContentMap;
-    }
-    getOhPkgFilePath() {
-        return this.ohPkgFilePath;
-    }
     makeCallGraphCHA(entryPoints) {
         let callGraph = new CallGraph_1.CallGraph(this);
         let callGraphBuilder = new CallGraphBuilder_1.CallGraphBuilder(callGraph, this);
@@ -1397,27 +797,53 @@ class Scene {
      ```
      */
     inferTypes(times = 1) {
+        var _a, _b, _c, _d, _e, _f;
         if (times < 1) {
             return;
         }
         else if (times > 5) {
             times = 5;
         }
-        const sortedFiles = (0, DependenciesSort_1.sortByDependency)(this.filesMap, this.projectName);
         while (times > 0) {
-            for (const file of sortedFiles) {
+            (_a = this.stageStatistics) === null || _a === void 0 ? void 0 : _a.startStage(StageStatistics_1.StageName.InferTypes);
+            for (const fileSigID of this.builtFileOrder) {
+                const file = this.registry.fileSigCanonicalizer.getModel(fileSigID);
+                if (file === undefined) {
+                    continue;
+                }
                 Inference_1.InferenceManager.getInstance().getInference(file.getLanguage()).doInfer(file);
+                (_b = this.stageStatistics) === null || _b === void 0 ? void 0 : _b.recordMemoryCheckpoint();
             }
+            (_c = this.stageStatistics) === null || _c === void 0 ? void 0 : _c.endStage(StageStatistics_1.StageName.InferTypes);
             times--;
         }
-        if (this.buildStage < SceneBuildStage.TYPE_INFERRED) {
-            this.getMethodsMap(true);
-            this.buildStage = SceneBuildStage.TYPE_INFERRED;
+        (_d = this.stageStatistics) === null || _d === void 0 ? void 0 : _d.startStage(StageStatistics_1.StageName.InferTypesFinalize);
+        if (this.buildStage < SceneBuildStage_2.SceneBuildStage.TYPE_INFERRED) {
+            this.buildStage = SceneBuildStage_2.SceneBuildStage.TYPE_INFERRED;
+        }
+        this.checkTempSignatureCompleteness();
+        if (this.getOptions().validateCanonicalizers === true) {
+            CanonicalizerValidator_1.CanonicalizerValidator.validateAll();
         }
         SdkUtils_1.SdkUtils.dispose();
         ModuleUtils_1.ModuleUtils.dispose();
         ValueUtil_1.ValueUtil.dispose();
         (0, builderUtils_1.clearCxxTypeStringCache)();
+        (_e = this.stageStatistics) === null || _e === void 0 ? void 0 : _e.endStage(StageStatistics_1.StageName.InferTypesFinalize);
+        // 签名空间快照（时点 2）：推导完成后的 formal/temp 数据进报告。
+        (_f = this.stageStatistics) === null || _f === void 0 ? void 0 : _f.recordSignatureStats('post-infer');
+    }
+    checkTempSignatureCompleteness() {
+        const stats = this.registry.getTempSpacesStats();
+        const liveTotal = stats.class.liveCount + stats.method.liveCount + stats.field.liveCount;
+        if (liveTotal > 0) {
+            const brief = {
+                class: { live: stats.class.liveCount, retired: stats.class.retiredCount },
+                method: { live: stats.method.liveCount, retired: stats.method.retiredCount },
+                field: { live: stats.field.liveCount, retired: stats.field.retiredCount },
+            };
+            logger.warn(`Unresolved signatures still alive after type inference (index-table exact stats): ${JSON.stringify(brief)}`);
+        }
     }
     /**
      * @deprecated This method is deprecated and will be removed in the next major release.
@@ -1428,7 +854,7 @@ class Scene {
     inferTypesOld() {
         // CXXTodo: Building the mapping between declarations and implementations of C++ functions in cross-file scenarios.
         IRInference_1.IRInference.mapCxxDeclAndImpl(this);
-        this.filesMap.forEach(file => {
+        this.getFiles().forEach(file => {
             try {
                 // CXXTodo: Distinguish between C++ and TS/ArkTS.
                 file.getLanguage() === ArkFile_1.Language.CXX ? IRInference_1.IRInference.inferFile(file) : IRInference_2.IRInference.inferFile(file);
@@ -1437,26 +863,12 @@ class Scene {
                 logger.error('Error inferring types of project file:', file.getFileSignature(), error);
             }
         });
-        if (this.buildStage < SceneBuildStage.TYPE_INFERRED) {
-            this.getMethodsMap(true);
-            this.buildStage = SceneBuildStage.TYPE_INFERRED;
+        if (this.buildStage < SceneBuildStage_2.SceneBuildStage.TYPE_INFERRED) {
+            this.buildStage = SceneBuildStage_2.SceneBuildStage.TYPE_INFERRED;
         }
         SdkUtils_1.SdkUtils.dispose();
     }
-    /**
-     * Iterate all assignment statements in methods,
-     * and set the type of left operand based on the type of right operand
-     * if the left operand is a local variable as well as an unknown.
-     * @Deprecated
-     * @example
-     * 1. Infer simple type when scene building.
-
-     ```typescript
-     let scene = new Scene();
-     scene.buildSceneFromProjectDir(config);
-     scene.inferSimpleTypes();
-     ```
-     */
+    /** @deprecated 请改用 {@link inferTypes}（完整类型推断含 simple type 推断能力）。 */
     inferSimpleTypes() {
         for (let arkFile of this.getFiles()) {
             for (let arkClass of arkFile.getClasses()) {
@@ -1556,6 +968,7 @@ class Scene {
             }
         }
     }
+    /** @deprecated 如需全部 project 类请使用 {@link getClasses}。*/
     getClassMap() {
         const classMap = new Map();
         for (const file of this.getFiles()) {
@@ -1689,6 +1102,7 @@ class Scene {
             }
         }
     }
+    /** @deprecated 依赖 file→ns→class 结构骨架遍历，与 registry 事实源化的方向不一致。*/
     getGlobalVariableMap() {
         var _a, _b;
         const globalVariableMap = new Map();
@@ -1720,15 +1134,17 @@ class Scene {
     }
     getStaticInitMethods() {
         const staticInitMethods = [];
-        for (const method of Array.from(this.getMethodsMap(true).values())) {
-            if (method.getName() === Const_1.STATIC_INIT_METHOD_NAME) {
-                staticInitMethods.push(method);
+        for (const cls of this.getClasses()) {
+            for (const method of cls.getMethods(true)) {
+                if (method.getName() === Const_1.STATIC_INIT_METHOD_NAME) {
+                    staticInitMethods.push(method);
+                }
             }
         }
         return staticInitMethods;
     }
     buildClassDone() {
-        return this.buildStage >= SceneBuildStage.CLASS_DONE;
+        return this.buildStage >= SceneBuildStage_2.SceneBuildStage.CLASS_DONE;
     }
     getModuleScene(moduleName) {
         return this.moduleScenesMap.get(moduleName);
@@ -1736,82 +1152,102 @@ class Scene {
     getModuleSceneMap() {
         return this.moduleScenesMap;
     }
+    /** @internal 构建期上下文回填配置产物快照（构建后 getGlobalModule2PathMapping/getbaseUrl 可查）。 */
+    setTsConfigSnapshot(paths, baseUrl) {
+        this.tsConfigPathsSnapshot = paths;
+        this.baseUrlSnapshot = baseUrl;
+    }
     getGlobalModule2PathMapping() {
-        return this.globalModule2PathMapping;
+        return this.tsConfigPathsSnapshot;
     }
     getbaseUrl() {
-        return this.baseUrl;
+        return this.baseUrlSnapshot;
     }
-}
-exports.Scene = Scene;
-class ModuleScene {
-    constructor(projectScene) {
-        this.moduleName = '';
-        this.modulePath = '';
-        this.moduleFileMap = new Map();
-        this.moduleOhPkgFilePath = '';
-        this.ohPkgContent = {};
-        this.projectScene = projectScene;
-    }
-    getProjectScene() {
-        return this.projectScene;
-    }
-    ModuleSceneBuilder(moduleName, modulePath, supportFileExts, recursively = false) {
-        this.moduleName = moduleName;
-        this.modulePath = modulePath;
-        this.getModuleOhPkgFilePath();
-        if (this.moduleOhPkgFilePath) {
-            this.ohPkgContent = (0, json5parser_1.fetchDependenciesFromFile)(this.moduleOhPkgFilePath);
-        }
-        else {
-            logger.warn('This module has no oh-package.json5!');
-        }
-        this.genArkFiles(supportFileExts);
+    /** @internal 构建期上下文回填根 oh-package 内容快照（构建后 getOhPkgContent 可查）。 */
+    setOhPkgContentSnapshot(content) {
+        this.ohPkgContentSnapshot = content;
     }
-    ModuleScenePartiallyBuilder(moduleName, modulePath) {
-        this.moduleName = moduleName;
-        this.modulePath = modulePath;
-        if (this.moduleOhPkgFilePath) {
-            this.ohPkgContent = (0, json5parser_1.fetchDependenciesFromFile)(this.moduleOhPkgFilePath);
-        }
-        else {
-            logger.warn('This module has no oh-package.json5!');
-        }
+    /**
+     * Get the parsed content of the project's root `oh-package.json5`.
+     * Returns an empty object when the project has no oh-package.json5 or before the
+     * scene is built.
+     * @returns The oh-package.json5 content.
+     */
+    getOhPkgContent() {
+        return this.ohPkgContentSnapshot;
     }
     /**
-     * get oh-package.json5
+     * Get the collected stage statistics data, or undefined if statistics is disabled.
+     * Auto-finalizes the collector if still running.
      */
-    getModuleOhPkgFilePath() {
-        const moduleOhPkgFilePath = path_1.default.resolve(this.projectScene.getRealProjectDir(), path_1.default.join(this.modulePath, EtsConst_1.OH_PACKAGE_JSON5));
-        if (fs_1.default.existsSync(moduleOhPkgFilePath)) {
-            this.moduleOhPkgFilePath = moduleOhPkgFilePath;
+    getStageStatistics() {
+        if (!this.stageStatistics) {
+            return undefined;
         }
+        return this.stageStatistics.getStatistics();
     }
     /**
-     * get nodule name
-     * @returns return module name
+     * Print stage statistics to the logger.
      */
-    getModuleName() {
-        return this.moduleName;
-    }
-    getModulePath() {
-        return this.modulePath;
-    }
-    getOhPkgFilePath() {
-        return this.moduleOhPkgFilePath;
-    }
-    getOhPkgContent() {
-        return this.ohPkgContent;
+    printStageStatistics() {
+        if (!this.stageStatistics) {
+            return;
+        }
+        const data = this.stageStatistics.getStatistics();
+        const report = StageStatisticsReporter_1.StageStatisticsReporter.generateReport(data);
+        logger.info(StageStatisticsReporter_1.StageStatisticsReporter.exportToText(report));
+        this.statsReportWritten = true;
     }
-    getModuleFilesMap() {
-        return this.moduleFileMap;
+    /**
+     * Export stage statistics as a text report to the given file path.
+     * @returns true if the report was written, false if statistics is disabled.
+     */
+    exportStageStatisticsReport(filePath) {
+        if (!this.stageStatistics) {
+            return false;
+        }
+        const data = this.stageStatistics.getStatistics();
+        const report = StageStatisticsReporter_1.StageStatisticsReporter.generateReport(data);
+        StageStatisticsReporter_1.StageStatisticsReporter.saveReportToFile(report, filePath);
+        this.statsReportWritten = true;
+        return true;
     }
-    addArkFile(arkFile) {
-        this.moduleFileMap.set(arkFile.getFileSignature().toMapKey(), arkFile);
+    /**
+     * Register a process 'exit' hook that auto-writes the statistics report
+     * when the process terminates, so users only need `enableStatistics: true`
+     * without calling any output API manually.
+     */
+    registerStatsExitHook() {
+        if (this.statsExitHandler) {
+            return;
+        }
+        this.statsExitHandler = () => {
+            if (!this.stageStatistics || this.statsReportWritten) {
+                return;
+            }
+            this.statsReportWritten = true;
+            this.stageStatistics.finish();
+            const data = this.stageStatistics.getStatistics();
+            const report = StageStatisticsReporter_1.StageStatisticsReporter.generateReport(data);
+            const reportPath = this.getStatisticsReportPath();
+            StageStatisticsReporter_1.StageStatisticsReporter.saveReportToFile(report, reportPath);
+            process.stdout.write(`Statistics report auto-saved to: ${reportPath}\n`);
+        };
+        process.on('exit', this.statsExitHandler);
     }
-    genArkFiles(supportFileExts) {
-        const filePaths = (0, getAllFiles_1.getAllFiles)(this.modulePath, supportFileExts, this.projectScene.getOptions().ignoreFileNames);
-        FrontendBuilder_1.FrontendBuilder.buildModuleFilesIntoArkFiles(this, filePaths);
+    /**
+     * Resolve the default statistics report file path.
+     * Uses `SceneOptions.statisticsOutputPath` if provided, otherwise
+     * defaults to `out/<projectName>_statistics.txt` under the current working directory.
+     */
+    getStatisticsReportPath() {
+        var _a;
+        const custom = (_a = this.options) === null || _a === void 0 ? void 0 : _a.statisticsOutputPath;
+        if (custom) {
+            return custom;
+        }
+        const dir = path_1.default.join(process.cwd(), 'out');
+        return path_1.default.join(dir, `${this.projectName || 'arkanalyzer'}_statistics.txt`);
     }
 }
-exports.ModuleScene = ModuleScene;
+exports.Scene = Scene;