arkanalyzer 1.0.93 → 2.0.0-beta1

package/lib/frontend/FrontendBuilder.js

@@ -43,7 +43,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FrontendBuilder = void 0;
 const path_1 = __importDefault(require("path"));
 const ArkFile_1 = require("../core/model/ArkFile");
-const Scene_1 = require("../Scene");
+const SceneBuildStage_1 = require("./SceneBuildStage");
 const ArktsFrontend_1 = require("./arktsFrontend/ArktsFrontend");
 const CppFrontend_1 = require("./cppFrontend/CppFrontend");
 const ArkFile_2 = require("../core/model/ArkFile");
@@ -64,49 +64,6 @@ const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER,
  * vs the C++ builder.
  */
 class FrontendBuilder {
-    static partitionFilePaths(scene, filePaths) {
-        const cppFiles = [];
-        const arktsFiles = [];
-        for (const filePath of filePaths) {
-            if (FileUtils_1.FileUtils.getFileLanguage(filePath, scene.getFileLanguages()) === ArkFile_1.Language.CXX) {
-                cppFiles.push(filePath);
-            }
-            else {
-                arktsFiles.push(filePath);
-            }
-        }
-        return { cppFiles, arktsFiles };
-    }
-    static collectFailedFilePaths(scene, failedFiles) {
-        for (const failed of failedFiles) {
-            logger.error('Error parsing file:', failed.filePath, failed.reason);
-            scene.addUnhandledFilePath(failed.filePath);
-        }
-    }
-    static buildFilesIntoArkFiles(scene, filePaths) {
-        const { cppFiles, arktsFiles } = this.partitionFilePaths(scene, filePaths);
-        const arktsFrontend = new ArktsFrontend_1.ArktsFrontend();
-        const cppFrontend = new CppFrontend_1.CppFrontend();
-        const arktsResult = arktsFrontend.buildProjectFiles(scene, arktsFiles);
-        const cppResult = cppFrontend.buildProjectFiles(scene, cppFiles);
-        arktsResult.arkFiles.forEach(file => scene.setFile(file));
-        cppResult.arkFiles.forEach(file => scene.setFile(file));
-        this.collectFailedFilePaths(scene, [...arktsResult.failedFiles, ...cppResult.failedFiles]);
-    }
-    static buildModuleFilesIntoArkFiles(moduleScene, filePaths) {
-        const scene = moduleScene.getProjectScene();
-        const { cppFiles, arktsFiles } = this.partitionFilePaths(scene, filePaths);
-        const arktsFrontend = new ArktsFrontend_1.ArktsFrontend();
-        const cppFrontend = new CppFrontend_1.CppFrontend();
-        const arktsResult = arktsFrontend.buildProjectFiles(scene, arktsFiles);
-        const cppResult = cppFrontend.buildProjectFiles(scene, cppFiles);
-        [...arktsResult.arkFiles, ...cppResult.arkFiles].forEach(file => {
-            file.setModuleScene(moduleScene);
-            moduleScene.addArkFile(file);
-            scene.setFile(file);
-        });
-        this.collectFailedFilePaths(scene, [...arktsResult.failedFiles, ...cppResult.failedFiles]);
-    }
     /**
      * Builds a single project file into a pre-allocated {@link ArkFile} (the former `if (CXX) … else …` in `Scene`).
      */
@@ -263,6 +220,23 @@ class FrontendBuilder {
             method.freeBodyBuilder();
         }
     }
+    /**
+     * Build the body of every class's default method (%dflt) in the file and free its builder.
+     * %dflt methods hold the file-level (or namespace-level) top-level statements and their
+     * builder is mounted on a node that a re-parse cannot address by position (the file or
+     * namespace node itself), so they are built while the signature round's AST is still mounted.
+     * All other method builders are untouched.
+     */
+    static buildDefaultMethodBodies(arkFile) {
+        for (const cls of ModelUtils_1.ModelUtils.getAllClassesInFile(arkFile)) {
+            const defaultMethod = cls.getDefaultArkMethod();
+            if (!defaultMethod) {
+                continue;
+            }
+            defaultMethod.buildBody();
+            defaultMethod.freeBodyBuilder();
+        }
+    }
     /**
      * Release the BodyBuilders mounted during signature building so the ArkFile retains only
      * signatures (no ArkBody/CFG) and does not retain AST/build context in memory. Mirrors the
@@ -304,7 +278,7 @@ class FrontendBuilder {
     static buildModuleMethodBody(module) {
         const scene = module.getScene();
         const prevStage = scene.getStage();
-        scene.setBuildStage(Scene_1.SceneBuildStage.CLASS_DONE);
+        scene.setBuildStage(SceneBuildStage_1.SceneBuildStage.CLASS_DONE);
         try {
             // Phase 2a: build method bodies for all methods in the module's files.
             const methods = [];

package/lib/frontend/ModuleScene.d.ts

@@ -0,0 +1,43 @@
+import { ArkFile } from '../core/model/ArkFile';
+import type { Scene } from '../Scene';
+/**
+ * Module-scoped view over a harmony project module (extracted from Scene.ts during the
+ * build-machinery migration into frontend; Scene.ts re-exports it for compatibility).
+ *
+ * Holds the module's name/path, its oh-package.json5 content, and its files
+ * (keyed by FileSigID). File building itself delegates to the project Scene's DFS
+ * ({@link Scene.getDependencyFilesDeeply}); the module association of each file is
+ * performed inside that DFS via addArkFile2ModuleScene — therefore a ModuleScene
+ * instance must be registered in the Scene's moduleScenesMap *before* its files
+ * are built.
+ */
+export declare class ModuleScene {
+    private projectScene;
+    private moduleName;
+    private modulePath;
+    private moduleFileMap;
+    private moduleOhPkgFilePath;
+    private ohPkgContent;
+    constructor(projectScene: Scene);
+    getProjectScene(): Scene;
+    ModuleSceneBuilder(moduleName: string, modulePath: string, supportFileExts: string[], recursively?: boolean): void;
+    ModuleScenePartiallyBuilder(moduleName: string, modulePath: string): void;
+    /**
+     * get oh-package.json5
+     */
+    private getModuleOhPkgFilePath;
+    /**
+     * get nodule name
+     * @returns return module name
+     */
+    getModuleName(): string;
+    getModulePath(): string;
+    getOhPkgFilePath(): string;
+    getOhPkgContent(): {
+        [p: string]: unknown;
+    };
+    getModuleFilesMap(): Map<number, ArkFile>;
+    addArkFile(arkFile: ArkFile): void;
+    private genArkFiles;
+}
+//# sourceMappingURL=ModuleScene.d.ts.map

package/lib/frontend/ModuleScene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleScene.d.ts","sourceRoot":"","sources":["../../src/frontend/ModuleScene.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAKhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAItC;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,aAAa,CAAmC;IAExD,OAAO,CAAC,mBAAmB,CAAc;IACzC,OAAO,CAAC,YAAY,CAAgC;gBAExC,YAAY,EAAE,KAAK;IAIxB,eAAe,IAAI,KAAK;IAIxB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,WAAW,GAAE,OAAe,GAAG,IAAI;IAczH,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAUhF;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;;OAGG;IACI,aAAa,IAAI,MAAM;IAIvB,aAAa,IAAI,MAAM;IAIvB,gBAAgB,IAAI,MAAM;IAI1B,eAAe,IAAI;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE;IAI3C,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAIzC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIzC,OAAO,CAAC,WAAW;CAetB"}

package/lib/frontend/ModuleScene.js

@@ -0,0 +1,143 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleScene = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const EtsConst_1 = require("../core/common/EtsConst");
+const json5parser_1 = require("../utils/json5parser");
+const getAllFiles_1 = require("../utils/getAllFiles");
+const logger_1 = __importStar(require("../utils/logger"));
+const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER, 'ModuleScene');
+/**
+ * Module-scoped view over a harmony project module (extracted from Scene.ts during the
+ * build-machinery migration into frontend; Scene.ts re-exports it for compatibility).
+ *
+ * Holds the module's name/path, its oh-package.json5 content, and its files
+ * (keyed by FileSigID). File building itself delegates to the project Scene's DFS
+ * ({@link Scene.getDependencyFilesDeeply}); the module association of each file is
+ * performed inside that DFS via addArkFile2ModuleScene — therefore a ModuleScene
+ * instance must be registered in the Scene's moduleScenesMap *before* its files
+ * are built.
+ */
+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);
+    }
+    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 oh-package.json5
+     */
+    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;
+        }
+    }
+    /**
+     * get nodule name
+     * @returns return module name
+     */
+    getModuleName() {
+        return this.moduleName;
+    }
+    getModulePath() {
+        return this.modulePath;
+    }
+    getOhPkgFilePath() {
+        return this.moduleOhPkgFilePath;
+    }
+    getOhPkgContent() {
+        return this.ohPkgContent;
+    }
+    getModuleFilesMap() {
+        return this.moduleFileMap;
+    }
+    addArkFile(arkFile) {
+        this.moduleFileMap.set(arkFile.getFileSigID(), arkFile);
+    }
+    genArkFiles(supportFileExts) {
+        const filePaths = (0, getAllFiles_1.getAllFiles)(this.modulePath, supportFileExts, this.projectScene.getOptions().ignoreFileNames);
+        // 统一走 projectScene 的构建期上下文（SceneBuilder DFS，反拓扑 ID 编号的
+        // 唯一排序执行方法）；本模块文件的归属由 DFS 内 addArkFile2ModuleScene 依据
+        // moduleScenesMap 完成，因此本 ModuleScene 实例必须已注册（见
+        // buildScene4HarmonyProject / buildModuleScene）。
+        const builder = this.projectScene.getActiveSceneBuilder();
+        if (!builder) {
+            logger.warn(`ModuleScene ${this.moduleName}: no active SceneBuilder (call buildBasicInfo first); skip ${filePaths.length} files`);
+            return;
+        }
+        for (const filePath of filePaths) {
+            builder.getDependencyFilesDeeply(filePath);
+        }
+    }
+}
+exports.ModuleScene = ModuleScene;

package/lib/frontend/SceneBuildStage.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Build stages of a {@link Scene}. Extracted from Scene.ts so the frontend layer can
+ * value-import it without pulling in the whole Scene module (avoids Scene ↔ frontend
+ * import cycles during the build-machinery migration into frontend).
+ *
+ * Scene.ts re-exports this enum for backward compatibility.
+ */
+export declare enum SceneBuildStage {
+    BUILD_INIT = 0,
+    SDK_INFERRED = 1,
+    CLASS_DONE = 2,
+    METHOD_DONE = 3,
+    TYPE_INFERRED = 4
+}
+//# sourceMappingURL=SceneBuildStage.d.ts.map

package/lib/frontend/SceneBuildStage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneBuildStage.d.ts","sourceRoot":"","sources":["../../src/frontend/SceneBuildStage.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,oBAAY,eAAe;IACvB,UAAU,IAAA;IACV,YAAY,IAAA;IACZ,UAAU,IAAA;IACV,WAAW,IAAA;IACX,aAAa,IAAA;CAChB"}

package/lib/frontend/SceneBuildStage.js

@@ -0,0 +1,32 @@
+"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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SceneBuildStage = void 0;
+/**
+ * Build stages of a {@link Scene}. Extracted from Scene.ts so the frontend layer can
+ * value-import it without pulling in the whole Scene module (avoids Scene ↔ frontend
+ * import cycles during the build-machinery migration into frontend).
+ *
+ * Scene.ts re-exports this enum for backward compatibility.
+ */
+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["TYPE_INFERRED"] = 4] = "TYPE_INFERRED";
+})(SceneBuildStage = exports.SceneBuildStage || (exports.SceneBuildStage = {}));

package/lib/frontend/SceneBuilder.d.ts

@@ -0,0 +1,153 @@
+import { SceneConfig } from '../Config';
+import { Scene } from '../Scene';
+/**
+ * 完整构建路径的一次性构建上下文（BuildContext）。
+ *
+ * 承接构建机械与构建期工作态：配置解析族（build-profile / oh-package / tsconfig）与 project 文件 DFS 族（getDependencyFilesDeeply 及全部
+ * 依赖发现辅助）。
+ *
+ * 生命周期：由 Scene 在构建入口创建并持有（scene.activeBuilder），构建结束由入口方法释放（置 undefined）——工作态随本实例被 GC 回收，不驻留
+ * Scene。Scene 仅保留构建产物（builtFileOrder / moduleScenesMap / overRides / 失败文件摘要等）与查询侧状态。
+ *
+ * 注意：本类不承载模块化增量路径（analyseByModule/loadModule 走 ModuleBuilder，其构建态常驻 Scene，不受本上下文生命周期影响）。
+ */
+export declare class SceneBuilder {
+    private readonly scene;
+    private readonly sceneConfig;
+    private readonly registry;
+    /** oh-package.json5 内容表（绝对路径 → 内容），依赖解析（parseFrom 族）的输入。 */
+    private ohPkgContentMap;
+    private ohPkgFilePath;
+    private ohPkgContent;
+    /** tsconfig paths 映射（import 名 → 候选路径），DFS 的 tsconfig 依赖发现输入。 */
+    private globalModule2PathMapping?;
+    private baseUrl?;
+    /**
+     * 构建失败/进行中文件集。直接复用 Scene 的集合引用（同一 Set）：
+     * DFS 期间作防环工作集（成功文件 delete、失败文件残留），构建结束后
+     * Scene.getUnhandledFilePaths() 恰好暴露失败文件摘要。
+     */
+    private readonly unhandledFilePaths;
+    /**
+     * from → 直接解析出的物理文件路径列表（性能缓存）。key 精确对齐
+     * {@link getOriginPath} 的解析语义：相对形式（`./`、`../`）带声明文件
+     * 所在目录前缀（`dirname + '\x00' + from`——同目录文件的相同相对 from 才允许共享）；模块名形式（`@ohos/xxx`、裸名）用 from 本身（解析只走
+     * ohPkgContentMap / projectDir / tsconfig 全局映射，与声明文件位置无关）。空数组也缓存（负缓存——避免失败 from 重复走全部分支）。
+     * **只缓存纯函数结果（from → paths），绝不缓存"文件要不要构建"的决策**——
+     * 后者依赖 filesMap/unhandledFilePaths 等可变状态，命中后必须逐个经
+     * {@link getDependencyFilesDeeply} 的三重防重入入口重新仲裁。
+     */
+    private fromResolutionCache;
+    /**
+     * 解析产出收集栈（嵌套隔离）：parseFrom 未命中时 push 新槽，嵌套递归构建
+     * 触发的 parseFrom 各归各的槽；pop 时整槽写入 fromResolutionCache——
+     * 条目只含该 from 的"直接"产出，不含递归依赖自身的解析结果。
+     */
+    private fromResolutionStack;
+    /**
+     * inner oh-package 内容缓存（兜底）：不同 from 首次解析触达同一 inner
+     * oh-package 的残余重复读盘。独立于 ohPkgContentMap——后者正被
+     * for...of 遍历，遍历中插入 key 会改变迭代行为（JS Map 迭代可见新增项）。
+     */
+    private resolvedOhPkgCache;
+    constructor(scene: Scene, sceneConfig: SceneConfig);
+    /**
+     * 解析项目配置：build-profile.json5（ES 版本 + 模块表）、oh-package.json5
+     * （含 overrides）、tsconfig（paths/baseUrl，extends 链递归）、模块 oh-package 表，
+     * 最后生成模块映射（ModuleUtils.generateModuleMap）。
+     */
+    parseProjectConfigs(): void;
+    /** @internal 供 Scene.buildBasicInfo 的 SDK 阶段读取（P3 迁移后内化）。 */
+    getOhPkgContentMap(): Map<string, {
+        [k: string]: unknown;
+    }>;
+    /** @internal 追加模块 oh-package 内容（Scene.buildModuleScene 的依赖解析输入，P3 迁移后内化）。 */
+    addOhPkgContent(ohPkgFilePath: string, content: {
+        [k: string]: unknown;
+    }): void;
+    /** @internal tsconfig baseUrl（构建期值；仅在活跃构建上下文中可查）。 */
+    getBaseUrl(): string | undefined;
+    private parseBuildProfile;
+    private parseOhPackage;
+    private findTsConfigInfoDeeply;
+    private addTsConfigInfo;
+    private buildOhPkgContentMap;
+    /**
+     * 对每个 projectFile 执行 {@link getDependencyFilesDeeply}（DFS）：
+     * 完整构建自己（intern FileSigID）→ 递归拉入 import/export 依赖 → 全部依赖
+     * 完成后 setFile。**setFile 后序 = 严格拓扑序**（被依赖者在前），由 Scene 的
+     * builtFileOrder 记录，推断期按其正序遍历即零排序。
+     */
+    buildProjectFiles(): void;
+    getDependencyFilesDeeply(projectFile: string): void;
+    private isRepeatBuildFile;
+    private addArkFile2ModuleScene;
+    private findDependencyFiles;
+    private parseFrom;
+    private findDependenciesByTsConfig;
+    private parseTsConfigParms;
+    private processFuzzyMapping;
+    private findDependenciesByRule;
+    private findFilesByPathArray;
+    private findFilesByExtNameArray;
+    private findRelativeDependenciesByOhPkg;
+    private findDependenciesByOhPkg;
+    private getDependenciesMapping;
+    private getOriginPath;
+    private addFileNode2DependencyGrap;
+    /**
+     * SDK 阶段：注册/构建全部 SDK 源、SDK 推断 + global API 合并、记录语言表、extendArkUI、标记 project/SDK ID 边界。
+     * 顺序语义：fileLanguages 在 SDK 构建之后才生效。
+     */
+    buildSdkStage(): void;
+    /**
+     * 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).
+     *
+     * When {@link createDefaultConstructor} is set, default constructors are ensured for every
+     * class registered by this SDK batch right here — before the SDK/project ID boundary is
+     * marked — so their method formal IDs stay on the SDK side of the (future class/method-level)
+     * boundary invariant. The built-in lib (var-side XxxConstructor pattern + interface-only
+     * classes) is excluded by the caller for that reason; library classes must NOT receive
+     * models after the boundary (the project-stage batch pass keeps the isLibraryClass guard).
+     */
+    private buildSdk;
+    private collectSdkFiles;
+    private parseAndRegisterSdkFile;
+    /**
+     * 方法体构建段（原 genArkFiles 尾段）：enableMethodBodyBuild 分支——
+     * 全量 buildBody + 默认构造器补全，或仅释放 builder。
+     */
+    buildAllMethodBodies(): void;
+    /**
+     * Update or add default constructors for all classes in the scene.
+     */
+    private updateOrAddDefaultConstructors;
+    /**
+     * 遍历全部 project 文件的 ArkMethod（不含 SDK 方法），逐个回调处理。
+     *
+     * 直接平面遍历 methodSigCanonicalizer（registry 为事实源），过滤规则：
+     * ① getModel(id) 为 undefined 跳过——declare-only 方法（无 model）及
+     *    BodyBuilder/JsonSerialization 重签名产生的无 model 条目；
+     * ② 非 project 文件跳过（SDK 文件，按 file 的 projectFile 标志判定）；
+     * ③ !enableOhModulesBody 时，oh_modules 文件仅保留 defaultArkMethod。
+     * 处理顺序为 methodSigID 升序（buildBody 逐方法独立、无序敏感）。
+     */
+    private forEachProjectMethod;
+    private static freeMethodBodyBuilder;
+    private buildAllMethodBody;
+    private freeAllBodyBuilders;
+    /**
+     * harmony 项目构建（原 buildScene4HarmonyProject 主体）：逐模块注册
+     * ModuleScene（先注册后构建，保证 DFS 归属正确）→ 模块文件 DFS → body 构建。
+     */
+    buildScene4HarmonyProject(): void;
+    /**
+     * 单模块构建（原 buildModuleScene 主体，增量式入口）：ohpkg 依赖递归 + 模块
+     * DFS + body 构建。可能被连续调用构建多个模块——不释放构建上下文（释放交给
+     * clear / 完整构建入口）。
+     */
+    buildModuleScene(moduleName: string, modulePath: string, supportFileExts: string[]): void;
+    private processModuleOhPkgContent;
+}
+//# sourceMappingURL=SceneBuilder.d.ts.map

package/lib/frontend/SceneBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/frontend/SceneBuilder.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,WAAW,EAAY,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AA4BjC;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAI1D,4DAA4D;IAC5D,OAAO,CAAC,eAAe,CAAoD;IAC3E,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,YAAY,CAAgC;IACpD,gEAAgE;IAChE,OAAO,CAAC,wBAAwB,CAAC,CAA4B;IAC7D,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAc;IACjD;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB,CAAoC;IAC/D;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAAkB;IAC7C;;;;OAIG;IACH,OAAO,CAAC,kBAAkB,CAAoD;gBAElE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW;IASlD;;;;OAIG;IACI,mBAAmB,IAAI,IAAI;IAmBlC,6DAA6D;IACtD,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAIlE,6EAA6E;IACtE,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI;IAItF,qDAAqD;IAC9C,UAAU,IAAI,MAAM,GAAG,SAAS;IAIvC,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,oBAAoB;IAY5B;;;;;OAKG;IACI,iBAAiB,IAAI,IAAI;IASzB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IA4D1D,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,sBAAsB;IAiB9B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,SAAS;IAwCjB,OAAO,CAAC,0BAA0B;IAOlC,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,+BAA+B;IAoBvC,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,sBAAsB;IAqB9B,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,0BAA0B;IAclC;;;OAGG;IACI,aAAa,IAAI,IAAI;IAsD5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,uBAAuB;IA+B/B;;;OAGG;IACI,oBAAoB,IAAI,IAAI;IAanC;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAmBtC;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IASpC,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,mBAAmB;IAQ3B;;;OAGG;IACI,yBAAyB,IAAI,IAAI;IAgBxC;;;;OAIG;IACI,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI;IAkChG,OAAO,CAAC,yBAAyB;CAmBpC"}