arkanalyzer 1.0.88 → 1.0.90

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

@@ -61,11 +61,12 @@ const Ref_1 = require("../../base/Ref");
 const Local_1 = require("../../base/Local");
 const Position_1 = require("../../base/Position");
 const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER, 'builderUtils');
+const StringUtils_1 = require("../../common/StringUtils");
 function handleQualifiedName(node) {
-    let right = node.right.text;
+    let right = (0, StringUtils_1.cloneText)(node.right.text);
     let left = '';
     if (node.left.kind === ohos_typescript_1.default.SyntaxKind.Identifier) {
-        left = node.left.text;
+        left = (0, StringUtils_1.cloneText)(node.left.text);
     }
     else if (node.left.kind === ohos_typescript_1.default.SyntaxKind.QualifiedName) {
         left = handleQualifiedName(node.left);
@@ -75,13 +76,13 @@ function handleQualifiedName(node) {
 }
 exports.handleQualifiedName = handleQualifiedName;
 function handlePropertyAccessExpression(node) {
-    let right = node.name.text;
+    let right = (0, StringUtils_1.cloneText)(node.name.text);
     let left = '';
     if (ohos_typescript_1.default.SyntaxKind[node.expression.kind] === 'Identifier') {
-        left = node.expression.text;
+        left = (0, StringUtils_1.cloneText)(node.expression.text);
     }
     else if (ohos_typescript_1.default.isStringLiteral(node.expression)) {
-        left = node.expression.text;
+        left = (0, StringUtils_1.cloneText)(node.expression.text);
     }
     else if (ohos_typescript_1.default.isPropertyAccessExpression(node.expression)) {
         left = handlePropertyAccessExpression(node.expression);
@@ -95,7 +96,7 @@ function buildDecorators(node, sourceFile) {
     ohos_typescript_1.default.getAllDecorators(node).forEach(decoratorNode => {
         let decorator = parseDecorator(decoratorNode);
         if (decorator) {
-            decorator.setContent(decoratorNode.expression.getText(sourceFile));
+            decorator.setContent((0, StringUtils_1.cloneText)(decoratorNode.expression.getText(sourceFile)));
             decorators.add(decorator);
         }
     });
@@ -108,16 +109,16 @@ function parseDecorator(node) {
     }
     let expression = node.expression;
     if (ohos_typescript_1.default.isIdentifier(expression)) {
-        return new Decorator_1.Decorator(expression.text);
+        return new Decorator_1.Decorator((0, StringUtils_1.cloneText)(expression.text));
     }
     if (!ohos_typescript_1.default.isCallExpression(expression) || !ohos_typescript_1.default.isIdentifier(expression.expression)) {
         return undefined;
     }
-    let decorator = new Decorator_1.Decorator(expression.expression.text);
+    let decorator = new Decorator_1.Decorator((0, StringUtils_1.cloneText)(expression.expression.text));
     if (expression.arguments.length > 0) {
         const arg = expression.arguments[0];
         if (ohos_typescript_1.default.isArrowFunction(arg) && ohos_typescript_1.default.isIdentifier(arg.body)) {
-            decorator.setParam(arg.body.text);
+            decorator.setParam((0, StringUtils_1.cloneText)(arg.body.text));
         }
     }
     return decorator;
@@ -140,16 +141,16 @@ function buildHeritageClauses(heritageClauses) {
         heritageClause.types.forEach(type => {
             let heritageClauseName = '';
             if (type.typeArguments) {
-                heritageClauseName = type.getText();
+                heritageClauseName = (0, StringUtils_1.cloneText)(type.getText());
             }
             else if (ohos_typescript_1.default.isIdentifier(type.expression)) {
-                heritageClauseName = type.expression.text;
+                heritageClauseName = (0, StringUtils_1.cloneText)(type.expression.text);
             }
             else if (ohos_typescript_1.default.isPropertyAccessExpression(type.expression)) {
                 heritageClauseName = handlePropertyAccessExpression(type.expression);
             }
             else {
-                heritageClauseName = type.getText();
+                heritageClauseName = (0, StringUtils_1.cloneText)(type.getText());
             }
             heritageClausesMap.set(heritageClauseName, ohos_typescript_1.default.SyntaxKind[heritageClause.token]);
         });
@@ -190,7 +191,7 @@ function buildObjectBindingPatternParam(methodParameter, paramNameNode) {
         let paraElement = new ArkMethodBuilder_1.ObjectBindingPatternParameter();
         if (element.propertyName) {
             if (ohos_typescript_1.default.isIdentifier(element.propertyName)) {
-                paraElement.setPropertyName(element.propertyName.text);
+                paraElement.setPropertyName((0, StringUtils_1.cloneText)(element.propertyName.text));
             }
             else {
                 logger.warn('New propertyName of ObjectBindingPattern found, please contact developers to support this!');
@@ -198,7 +199,7 @@ function buildObjectBindingPatternParam(methodParameter, paramNameNode) {
         }
         if (element.name) {
             if (ohos_typescript_1.default.isIdentifier(element.name)) {
-                paraElement.setName(element.name.text);
+                paraElement.setName((0, StringUtils_1.cloneText)(element.name.text));
             }
             else {
                 logger.warn('New name of ObjectBindingPattern found, please contact developers to support this!');
@@ -217,7 +218,7 @@ function buildObjectBindingPatternParam(methodParameter, paramNameNode) {
 function buildBindingElementOfBindingPatternParam(element, paraElement) {
     if (element.propertyName) {
         if (ohos_typescript_1.default.isIdentifier(element.propertyName)) {
-            paraElement.setPropertyName(element.propertyName.text);
+            paraElement.setPropertyName((0, StringUtils_1.cloneText)(element.propertyName.text));
         }
         else {
             logger.warn('New propertyName of ArrayBindingPattern found, please contact developers to support this!');
@@ -225,7 +226,7 @@ function buildBindingElementOfBindingPatternParam(element, paraElement) {
     }
     if (element.name) {
         if (ohos_typescript_1.default.isIdentifier(element.name)) {
-            paraElement.setName(element.name.text);
+            paraElement.setName((0, StringUtils_1.cloneText)(element.name.text));
         }
         else {
             logger.warn('New name of ArrayBindingPattern found, please contact developers to support this!');
@@ -259,8 +260,8 @@ function buildParameters(params, arkInstance, sourceFile, paramsPosition) {
         let methodParameter = new ArkMethodBuilder_1.MethodParameter();
         // name
         if (ohos_typescript_1.default.isIdentifier(parameter.name)) {
-            methodParameter.setName(parameter.name.text);
-            paramsPosition.set(parameter.name.text, Position_1.FullPosition.buildFromNode(parameter.name, sourceFile));
+            methodParameter.setName((0, StringUtils_1.cloneText)(parameter.name.text));
+            paramsPosition.set((0, StringUtils_1.cloneText)(parameter.name.text), Position_1.FullPosition.buildFromNode(parameter.name, sourceFile));
         }
         else if (ohos_typescript_1.default.isObjectBindingPattern(parameter.name)) {
             buildObjectBindingPatternParam(methodParameter, parameter.name);
@@ -388,7 +389,7 @@ function tsNode2Type(typeNode, sourceFile, arkInstance) {
             return new Type_1.UnclearReferenceType(parameterTypeStr, genericTypes);
         }
         else {
-            let parameterTypeStr = referenceNodeName.text;
+            let parameterTypeStr = (0, StringUtils_1.cloneText)(referenceNodeName.text);
             if (parameterTypeStr === Builtin_1.Builtin.OBJECT) {
                 return Builtin_1.Builtin.OBJECT_CLASS_TYPE;
             }
@@ -448,7 +449,7 @@ function tsNode2Type(typeNode, sourceFile, arkInstance) {
         return new Type_1.FunctionType(mtd.getSignature());
     }
     else if (ohos_typescript_1.default.isTypeParameterDeclaration(typeNode)) {
-        const name = typeNode.name.text;
+        const name = (0, StringUtils_1.cloneText)(typeNode.name.text);
         let defaultType;
         if (typeNode.default) {
             defaultType = tsNode2Type(typeNode.default, sourceFile, arkInstance);
@@ -561,8 +562,8 @@ function buildTypeFromTypeQuery(typeQueryNode, sourceFile, arkInstance) {
     const exprNameNode = typeQueryNode.exprName;
     let opValue;
     if (ohos_typescript_1.default.isQualifiedName(exprNameNode)) {
-        if (exprNameNode.left.getText(sourceFile) === TSConst_1.THIS_NAME) {
-            const fieldName = exprNameNode.right.getText(sourceFile);
+        if ((0, StringUtils_1.cloneText)(exprNameNode.left.getText(sourceFile)) === TSConst_1.THIS_NAME) {
+            const fieldName = (0, StringUtils_1.cloneText)(exprNameNode.right.getText(sourceFile));
             if (arkInstance instanceof ArkMethod_1.ArkMethod) {
                 const fieldSignature = (_b = (_a = arkInstance.getDeclaringArkClass().getFieldWithName(fieldName)) === null || _a === void 0 ? void 0 : _a.getSignature()) !== null && _b !== void 0 ? _b : ArkSignatureBuilder_1.ArkSignatureBuilder.buildFieldSignatureFromFieldName(fieldName);
                 const baseLocal = (_d = (_c = arkInstance.getBody()) === null || _c === void 0 ? void 0 : _c.getLocals().get(TSConst_1.THIS_NAME)) !== null && _d !== void 0 ? _d : new Local_1.Local(TSConst_1.THIS_NAME, new Type_1.ClassType(arkInstance.getDeclaringArkClass().getSignature(), arkInstance.getDeclaringArkClass().getGenericsTypes()));
@@ -580,12 +581,12 @@ function buildTypeFromTypeQuery(typeQueryNode, sourceFile, arkInstance) {
             }
         }
         else {
-            const exprName = exprNameNode.getText(sourceFile);
+            const exprName = (0, StringUtils_1.cloneText)(exprNameNode.getText(sourceFile));
             opValue = new Local_1.Local(exprName, Type_1.UnknownType.getInstance());
         }
     }
     else {
-        const exprName = exprNameNode.escapedText.toString();
+        const exprName = (0, StringUtils_1.cloneText)(exprNameNode.escapedText.toString());
         opValue = new Local_1.Local(exprName, Type_1.UnknownType.getInstance());
     }
     let expr = new TypeExpr_1.TypeQueryExpr(opValue);

package/lib/frontend/FrontendBuilder.d.ts

@@ -0,0 +1,26 @@
+import { ModuleScene, Scene } from '../Scene';
+import { ArkFile } from '../core/model/ArkFile';
+export interface FrontendParseFailure {
+    filePath: string;
+    reason: unknown;
+}
+export interface FrontendParseResult {
+    arkFiles: ArkFile[];
+    failedFiles: FrontendParseFailure[];
+}
+/**
+ * Dispatches language front-ends and exposes a single build entry for {@link Scene} so the scene no longer
+ * branches on {@link Language} to pick {@link import('../core/model/builder/ArkFileBuilder').buildArkFileFromFile}
+ * vs the C++ builder.
+ */
+export declare class FrontendBuilder {
+    private static partitionFilePaths;
+    private static collectFailedFilePaths;
+    static buildFilesIntoArkFiles(scene: Scene, filePaths: string[]): void;
+    static buildModuleFilesIntoArkFiles(moduleScene: ModuleScene, filePaths: string[]): void;
+    /**
+     * Builds a single project file into a pre-allocated {@link ArkFile} (the former `if (CXX) … else …` in `Scene`).
+     */
+    static buildProjectFileIntoArkFile(scene: Scene, filePath: string, arkFile: ArkFile): void;
+}
+//# sourceMappingURL=FrontendBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FrontendBuilder.d.ts","sourceRoot":"","sources":["../../src/frontend/FrontendBuilder.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAMhD,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACvC;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAajC,OAAO,CAAC,MAAM,CAAC,sBAAsB;WAOvB,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;WAW/D,4BAA4B,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAe/F;;OAEG;WACW,2BAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;CAOpG"}

package/lib/frontend/FrontendBuilder.js

@@ -0,0 +1,108 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontendBuilder = void 0;
+const ArkFile_1 = require("../core/model/ArkFile");
+const ArktsFrontend_1 = require("./arktsFrontend/ArktsFrontend");
+const CppFrontend_1 = require("./cppFrontend/CppFrontend");
+const FileUtils_1 = require("../utils/FileUtils");
+const logger_1 = __importStar(require("../utils/logger"));
+const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER, 'FrontendBuilder');
+/**
+ * Dispatches language front-ends and exposes a single build entry for {@link Scene} so the scene no longer
+ * branches on {@link Language} to pick {@link import('../core/model/builder/ArkFileBuilder').buildArkFileFromFile}
+ * 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`).
+     */
+    static buildProjectFileIntoArkFile(scene, filePath, arkFile) {
+        if (arkFile.getLanguage() === ArkFile_1.Language.CXX) {
+            new CppFrontend_1.CppFrontend().buildProjectFile(scene, filePath, arkFile);
+        }
+        else {
+            new ArktsFrontend_1.ArktsFrontend().buildProjectFile(scene, filePath, arkFile);
+        }
+    }
+}
+exports.FrontendBuilder = FrontendBuilder;

package/lib/frontend/arktsFrontend/ArktsFrontend.d.ts

@@ -0,0 +1,16 @@
+import { Scene } from '../../Scene';
+import { ArkFile } from '../../core/model/ArkFile';
+import { FrontendParseResult } from '../FrontendBuilder';
+/**
+ * ArkTS/TS/JS: builds {@link ArkFile}s using the core TS/ArkTS pipeline (see {@link buildArkFileFromFile}).
+ */
+export declare class ArktsFrontend {
+    /** Fills a project {@link ArkFile} from a source file; delegates to {@link buildArkFileFromFile}. */
+    buildProjectFile(scene: Scene, filePath: string, arkFile: ArkFile): void;
+    /**
+     * Non-project SDK file load (e.g. OpenHarmony SDK sources); mirrors the former {@link Scene} path for SDK files.
+     */
+    static buildArkFileFromSdkPath(absoluteFilePath: string, sdkPath: string, arkFile: ArkFile, sdkName: string): void;
+    buildProjectFiles(scene: Scene, filePaths: string[]): FrontendParseResult;
+}
+//# sourceMappingURL=ArktsFrontend.d.ts.map

package/lib/frontend/arktsFrontend/ArktsFrontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArktsFrontend.d.ts","sourceRoot":"","sources":["../../../src/frontend/arktsFrontend/ArktsFrontend.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,OAAO,EAAwB,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI/E;;GAEG;AACH,qBAAa,aAAa;IAEtB,qGAAqG;IAC9F,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAI/E;;OAEG;WACW,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIlH,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,mBAAmB;CAenF"}

package/lib/frontend/arktsFrontend/ArktsFrontend.js

@@ -0,0 +1,52 @@
+"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.ArktsFrontend = void 0;
+const ArkFile_1 = require("../../core/model/ArkFile");
+const ArkFileBuilder_1 = require("../../core/model/builder/ArkFileBuilder");
+const FileUtils_1 = require("../../utils/FileUtils");
+/**
+ * ArkTS/TS/JS: builds {@link ArkFile}s using the core TS/ArkTS pipeline (see {@link buildArkFileFromFile}).
+ */
+class ArktsFrontend {
+    /** Fills a project {@link ArkFile} from a source file; delegates to {@link buildArkFileFromFile}. */
+    buildProjectFile(scene, filePath, arkFile) {
+        (0, ArkFileBuilder_1.buildArkFileFromFile)(filePath, scene.getRealProjectDir(), arkFile, scene.getProjectName());
+    }
+    /**
+     * Non-project SDK file load (e.g. OpenHarmony SDK sources); mirrors the former {@link Scene} path for SDK files.
+     */
+    static buildArkFileFromSdkPath(absoluteFilePath, sdkPath, arkFile, sdkName) {
+        (0, ArkFileBuilder_1.buildArkFileFromFile)(absoluteFilePath, sdkPath, arkFile, sdkName);
+    }
+    buildProjectFiles(scene, filePaths) {
+        const arkFiles = [];
+        const failedFiles = [];
+        for (const filePath of filePaths) {
+            try {
+                const arkFile = new ArkFile_1.ArkFile(FileUtils_1.FileUtils.getFileLanguage(filePath, scene.getFileLanguages()));
+                arkFile.setScene(scene);
+                this.buildProjectFile(scene, filePath, arkFile);
+                arkFiles.push(arkFile);
+            }
+            catch (error) {
+                failedFiles.push({ filePath, reason: error });
+            }
+        }
+        return { arkFiles, failedFiles };
+    }
+}
+exports.ArktsFrontend = ArktsFrontend;

package/lib/frontend/cppFrontend/CppFrontend.d.ts

@@ -0,0 +1,18 @@
+import { Scene } from '../../Scene';
+import { ArkFile } from '../../core/model/ArkFile';
+import { FrontendParseResult } from '../FrontendBuilder';
+/**
+ * C++ language frontend. Matches the former {@link Scene} branches for {@link Language#CXX}.
+ */
+export declare class CppFrontend {
+    private static readonly AUTO_MAX_PARALLEL_PROCESSES;
+    private static readonly AUTO_MAX_PENDING_AST_RESULTS;
+    buildProjectFile(scene: Scene, filePath: string, arkFile: ArkFile): void;
+    buildProjectFiles(scene: Scene, filePaths: string[]): FrontendParseResult;
+    /** Returns true if astJsonDumper and cxx-ast-parser are available; otherwise logs a warning. */
+    private requireAstJsonDumper;
+    private resolveMaxParallelProcesses;
+    private resolveMaxPendingAstResults;
+    private resolveLogAstInfo;
+}
+//# sourceMappingURL=CppFrontend.d.ts.map

package/lib/frontend/cppFrontend/CppFrontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CppFrontend.d.ts","sourceRoot":"","sources":["../../../src/frontend/cppFrontend/CppFrontend.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAGnD,OAAO,EAAwB,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAM/E;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,CAAM;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAAM;IAEnD,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAOxE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,mBAAmB;IAYhF,gGAAgG;IAChG,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,2BAA2B;IAsBnC,OAAO,CAAC,2BAA2B;IAoBnC,OAAO,CAAC,iBAAiB;CAG5B"}

package/lib/frontend/cppFrontend/CppFrontend.js

@@ -0,0 +1,131 @@
+"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.CppFrontend = void 0;
+const logger_1 = __importStar(require("../../utils/logger"));
+const ArkFileBuilder_1 = require("./model/builder/ArkFileBuilder");
+const cxxAstParserTypes_1 = require("./utils/cxxAstParserTypes");
+const os_1 = __importDefault(require("os"));
+const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER, 'CppFrontend');
+/**
+ * C++ language frontend. Matches the former {@link Scene} branches for {@link Language#CXX}.
+ */
+class CppFrontend {
+    buildProjectFile(scene, filePath, arkFile) {
+        if (!this.requireAstJsonDumper()) {
+            return;
+        }
+        (0, ArkFileBuilder_1.prepareArkFile)(scene, filePath, arkFile, this.resolveLogAstInfo(scene));
+    }
+    buildProjectFiles(scene, filePaths) {
+        if (!this.requireAstJsonDumper()) {
+            return { arkFiles: [], failedFiles: [] };
+        }
+        const maxParallelProcesses = this.resolveMaxParallelProcesses(scene);
+        const maxPendingAstResults = this.resolveMaxPendingAstResults(scene, maxParallelProcesses);
+        const logAstInfo = this.resolveLogAstInfo(scene);
+        const result = (0, ArkFileBuilder_1.prepareArkFiles)(scene, filePaths, maxParallelProcesses, maxPendingAstResults, logAstInfo);
+        const failedFiles = result.failedFiles;
+        return { arkFiles: result.arkFiles, failedFiles };
+    }
+    /** Returns true if astJsonDumper and cxx-ast-parser are available; otherwise logs a warning. */
+    requireAstJsonDumper() {
+        try {
+            const runtime = (0, cxxAstParserTypes_1.requireCxxAstParser)();
+            if (!runtime.isCppEnvironmentReady()) {
+                logger.warn('C++ environment is not ready (astJsonDumper.node or @arkanalyzer/cxx-ast-parser); skip C++ frontend build. Run: npm run build:cpp');
+                return false;
+            }
+            return true;
+        }
+        catch (_a) {
+            logger.warn('@arkanalyzer/cxx-ast-parser is not installed; skip C++ frontend build. Run: npm run build:cpp');
+            return false;
+        }
+    }
+    resolveMaxParallelProcesses(scene) {
+        var _a, _b, _c, _d;
+        const configured = (_b = (_a = scene.getOptions().languages) === null || _a === void 0 ? void 0 : _a.cpp) === null || _b === void 0 ? void 0 : _b.maxParallelProcesses;
+        if (configured === CppFrontend.AUTO_MAX_PARALLEL_PROCESSES) {
+            try {
+                const cpuCount = (_d = (_c = os_1.default.cpus()) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0;
+                return Math.max(1, cpuCount - 1);
+            }
+            catch (_e) {
+                return 1;
+            }
+        }
+        if (configured !== undefined && !Number.isInteger(configured)) {
+            logger.warn(`languages.cpp.maxParallelProcesses must be a positive integer or ` +
+                `${CppFrontend.AUTO_MAX_PARALLEL_PROCESSES} for auto; got ${JSON.stringify(configured)}, using 1.`);
+        }
+        if (Number.isInteger(configured) && configured !== undefined && configured > 0) {
+            return configured;
+        }
+        return 1;
+    }
+    resolveMaxPendingAstResults(scene, maxParallelProcesses) {
+        var _a, _b;
+        const configured = (_b = (_a = scene.getOptions().languages) === null || _a === void 0 ? void 0 : _a.cpp) === null || _b === void 0 ? void 0 : _b.maxPendingAstResults;
+        const fallback = Math.max(1, maxParallelProcesses * 2);
+        if (configured === CppFrontend.AUTO_MAX_PENDING_AST_RESULTS || configured === undefined) {
+            return fallback;
+        }
+        if (!Number.isInteger(configured)) {
+            logger.warn(`languages.cpp.maxPendingAstResults must be a positive integer or ` +
+                `${CppFrontend.AUTO_MAX_PENDING_AST_RESULTS} for auto; got ${JSON.stringify(configured)}, using ` +
+                `${fallback}.`);
+            return fallback;
+        }
+        if (configured > 0) {
+            return configured;
+        }
+        return fallback;
+    }
+    resolveLogAstInfo(scene) {
+        var _a, _b;
+        return ((_b = (_a = scene.getOptions().languages) === null || _a === void 0 ? void 0 : _a.cpp) === null || _b === void 0 ? void 0 : _b.logAstInfo) === true;
+    }
+}
+exports.CppFrontend = CppFrontend;
+CppFrontend.AUTO_MAX_PARALLEL_PROCESSES = -1;
+CppFrontend.AUTO_MAX_PENDING_AST_RESULTS = -1;

package/lib/frontend/cppFrontend/common/ArkIRTransformer.d.ts

@@ -7,7 +7,7 @@ import { AliasType } from '../../../core/base/Type';
 import { ArkMethod } from '../../../core/model/ArkMethod';
 import { FullPosition } from '../../../core/base/Position';
 import { ArkIRTransformer } from '../../../core/common/ArkIRTransformer';
-import { CxxAstNode, CxxTranslationUnit } from '../ast';
+import { CxxAstNode, CxxTranslationUnit } from '../utils/ArkCxxAstNode';
 export type ValueAndStmts = {
     value: Value;
     valueOriginalPositions: FullPosition[];

package/lib/frontend/cppFrontend/common/ArkIRTransformer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ArkIRTransformer.d.ts","sourceRoot":"","sources":["../../../../src/frontend/cppFrontend/common/ArkIRTransformer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ArkIRTransformer.d.ts","sourceRoot":"","sources":["../../../../src/frontend/cppFrontend/common/ArkIRTransformer.ts"],"names":[],"mappings":"AAeA,OAAO,EAYH,aAAa,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAMH,SAAS,EACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EACH,sBAAsB,EAOtB,IAAI,EACP,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,SAAS,EASZ,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAW3D,OAAO,EAAE,gBAAgB,EAAa,MAAM,uCAAuC,CAAC;AAMpF,OAAO,EAAsB,UAAU,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAQ5F,MAAM,MAAM,aAAa,GAAG;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,sBAAsB,EAAE,YAAY,EAAE,CAAC;IACvC,KAAK,EAAE,IAAI,EAAE,CAAC;CACjB,CAAC;AAUF,qBAAa,mBAAoB,SAAQ,gBAAgB;IACrD,gBAAuB,4BAA4B,YAAY;IAC/D,gBAAuB,qBAAqB,WAAW;IACvD,gBAAuB,2BAA2B,YAAY;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,iBAAiB,CAAe;gBAE5B,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,SAAS;IAM/D,SAAS,IAAI,GAAG,CAAC,KAAK,CAAC;IAIvB,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;IAI3C,YAAY,IAAI,KAAK;IAIrB,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;IAInE,aAAa,IAAI,IAAI,EAAE;IAe9B,OAAO,CAAC,gCAAgC;IAiBxC,8DAA8D;IACvD,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE;IAwF/C,OAAO,CAAC,0BAA0B;IAWlC,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAiBpC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,wBAAwB;IAmEhC,OAAO,CAAC,sBAAsB;IA2B9B,OAAO,CAAC,uBAAuB;IAsC/B,OAAO,CAAC,qBAAqB;IA2B7B,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,qBAAqB;IA2B7B,sEAAsE;IAC/D,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa;IAI9D,OAAO,CAAC,yBAAyB;IAgCjC,OAAO,CAAC,6BAA6B;IAerC,OAAO,CAAC,iBAAiB;IA4BzB,qDAAqD;IAC9C,iCAAiC,CAAC,eAAe,EAAE,UAAU,GAAG,aAAa,EAAE;IAqDtF;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;IAkC9B,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,2BAA2B;IA4CnC,OAAO,CAAC,iBAAiB;IAsDzB,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,iCAAiC;IAIlC,qBAAqB,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,GAAE,MAAU,EAAE,OAAO,CAAC,EAAE;QAC/E,aAAa,EAAE,KAAK,GAAG,SAAS,CAAA;KACnC,GAAG,IAAI,EAAE;IAgCV,OAAO,CAAC,wBAAwB;IAiBzB,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAQjE;;;;;OAKG;WACW,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAiBnE,0BAA0B,CAAC,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,GAAG,aAAa;IAwBtG,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,wBAAwB;IAgBzB,2BAA2B,CAAC,wBAAwB,EAAE,OAAO,GAAG,IAAI;CAE9E"}