arkanalyzer 1.0.87 → 1.0.88

package/lib/frontend/cppFrontend/ast/astParser.d.ts

@@ -0,0 +1,25 @@
+import { CxxAstNode, CxxAstNodeLite } from './ArkCxxAstNode';
+export type GetParentFn = {
+    (isNeedInner: true): CxxAstNode;
+    (isNeedInner?: false): CxxAstNodeLite;
+};
+export declare class AstParser {
+    private static currentAccess;
+    private static deleteFileSync;
+    static parse(sourceFile: string, ccJsonPath: string | null, includeDirs: string[] | null, llvmPath: string, cppAstPath: string): CxxAstNode;
+    private static resolveProjectRoot;
+    private static getWorkingDir;
+    private static processAstFile;
+    private static createEmptyNode;
+    private static updateInner;
+    private static filter;
+    private static filterChildren;
+    private static makeGetParent;
+    private static fullInfo;
+    private static processAccess;
+    private static getCodeForExtractModifiers;
+    private static stripFucntionParams;
+    private static getAstOutputPath;
+    private static ensureOutputDir;
+}
+//# sourceMappingURL=astParser.d.ts.map

package/lib/frontend/cppFrontend/ast/astParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astParser.d.ts","sourceRoot":"","sources":["../../../../src/frontend/cppFrontend/ast/astParser.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAW,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMtE,MAAM,MAAM,WAAW,GAAG;IACtB,CAAC,WAAW,EAAE,IAAI,GAAG,UAAU,CAAC;IAChC,CAAC,WAAW,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC;CACzC,CAAC;AAEF,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAc;IAE1C,OAAO,CAAC,MAAM,CAAC,cAAc;WAQf,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU;IA4BlJ,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAoBjC,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B,OAAO,CAAC,MAAM,CAAC,cAAc;IAqB7B,OAAO,CAAC,MAAM,CAAC,eAAe;IAI9B,OAAO,CAAC,MAAM,CAAC,WAAW;IAY1B,OAAO,CAAC,MAAM,CAAC,MAAM;IAYrB,OAAO,CAAC,MAAM,CAAC,cAAc;IAO7B,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B,OAAO,CAAC,MAAM,CAAC,QAAQ;IA8BvB,OAAO,CAAC,MAAM,CAAC,aAAa;IAgB5B,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAUzC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAyBlC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAQ/B,OAAO,CAAC,MAAM,CAAC,eAAe;CAKjC"}

package/lib/frontend/cppFrontend/ast/astParser.js

@@ -0,0 +1,280 @@
+"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 __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AstParser = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = __importStar(require("../../../utils/logger"));
+const ArkCxxAstNode_1 = require("./ArkCxxAstNode");
+const napiApi_1 = require("./astJsonNapi/napiApi");
+const astUtils_1 = require("./astUtils");
+const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER, 'astParser');
+class AstParser {
+    static deleteFileSync(filePath) {
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch (_a) {
+            logger.warn('delete file failed:', filePath);
+        }
+    }
+    static parse(sourceFile, ccJsonPath, includeDirs, llvmPath, cppAstPath) {
+        logger.info(`[Debug] Parsing File: ${sourceFile}`);
+        if (!fs.existsSync(sourceFile)) {
+            logger.warn('parse file is not exists');
+            return this.createEmptyNode();
+        }
+        const rawAstPath = this.getAstOutputPath(sourceFile, cppAstPath);
+        const astPath = path.resolve(rawAstPath);
+        this.ensureOutputDir(path.dirname(astPath));
+        const workingDir = this.getWorkingDir(ccJsonPath);
+        const finalIncludeDirs = includeDirs ? [...includeDirs] : [];
+        const projectRoot = this.resolveProjectRoot(sourceFile);
+        if (projectRoot && !finalIncludeDirs.includes(projectRoot)) {
+            finalIncludeDirs.push(projectRoot);
+        }
+        const status = (0, napiApi_1.dumpAstJson)({
+            sourceFile,
+            outputFile: astPath,
+            ccJsonPath: ccJsonPath !== null && ccJsonPath !== void 0 ? ccJsonPath : undefined,
+            includeDirs: finalIncludeDirs,
+        }, workingDir, llvmPath);
+        return this.processAstFile(astPath, sourceFile, status);
+    }
+    static resolveProjectRoot(sourceFile) {
+        try {
+            let currentDir = path.dirname(sourceFile);
+            for (let i = 0; i < 10; i++) {
+                if (path.dirname(currentDir) === currentDir) {
+                    break;
+                }
+                if (path.basename(currentDir) === 'cpp' && path.basename(path.dirname(currentDir)) === 'main') {
+                    const absRoot = path.resolve(currentDir);
+                    logger.info(`[Debug] Found Source Root: ${absRoot}`);
+                    return absRoot;
+                }
+                currentDir = path.dirname(currentDir);
+            }
+        }
+        catch (e) {
+            logger.error('[Debug] Error finding source root:', e);
+        }
+        return null;
+    }
+    static getWorkingDir(ccJsonPath) {
+        let workingDir = process.cwd();
+        if (ccJsonPath && fs.existsSync(ccJsonPath)) {
+            const stats = fs.statSync(ccJsonPath);
+            if (stats.isFile()) {
+                workingDir = path.dirname(ccJsonPath);
+            }
+            else {
+                workingDir = ccJsonPath;
+            }
+        }
+        return workingDir;
+    }
+    static processAstFile(astPath, sourceFile, status) {
+        try {
+            if (!fs.existsSync(astPath)) {
+                logger.error(`[Debug] AST file missing at: ${astPath}`);
+                return this.createEmptyNode();
+            }
+            const content = fs.readFileSync(astPath, 'utf-8');
+            if (!content || content.trim() === '') {
+                return this.createEmptyNode();
+            }
+            let tu = JSON.parse(content);
+            tu = this.filter(sourceFile, tu);
+            return tu;
+        }
+        catch (e) {
+            logger.error('Failed to parse AST json:', e);
+            return this.createEmptyNode();
+        }
+        finally {
+            this.deleteFileSync(astPath);
+        }
+    }
+    static createEmptyNode() {
+        return { kind: '', name: '', code: '', type: { qualType: '' }, inner: [] };
+    }
+    static updateInner(sourceFile, entry, newInner) {
+        if (entry.isImplicit) {
+            return;
+        }
+        const loc = entry.loc;
+        if (!loc) {
+            logger.warn('Node skipped due to missing "locFile", kind of node: ', entry.kind);
+            return;
+        }
+        newInner.push(entry);
+    }
+    static filter(sourceFile, translationUnit) {
+        const newInner = [];
+        for (const entry of translationUnit.inner) {
+            this.updateInner(sourceFile, entry, newInner);
+        }
+        translationUnit.inner = newInner;
+        translationUnit.fileName = sourceFile;
+        translationUnit.projectName = path.dirname(sourceFile);
+        this.fullInfo(translationUnit);
+        return translationUnit;
+    }
+    static filterChildren(cursor) {
+        if (!cursor.inner) {
+            return [];
+        }
+        return cursor.inner.filter((item) => !item.isImplicit);
+    }
+    static makeGetParent(cursor) {
+        function getParent(isNeedInner) {
+            if (isNeedInner) {
+                return Object.assign({}, cursor);
+            }
+            const { inner } = cursor, rest = __rest(cursor, ["inner"]);
+            return rest;
+        }
+        return getParent;
+    }
+    static fullInfo(cursor) {
+        if (!cursor.inner) {
+            cursor.inner = [];
+        }
+        cursor.inner = this.filterChildren(cursor);
+        if (cursor.name === undefined) {
+            cursor.name = '';
+        }
+        if (cursor.kind === 'LambdaExpr') {
+            this.processAccess(cursor);
+        }
+        if (cursor.kind === ArkCxxAstNode_1.astKind.CXXRecordDecl && cursor.tagUsed === 'class') {
+            this.currentAccess = 'private';
+        }
+        else if (cursor.kind === ArkCxxAstNode_1.astKind.CXXRecordDecl && cursor.tagUsed === 'struct') {
+            this.currentAccess = 'public';
+        }
+        else {
+            this.currentAccess = '';
+        }
+        for (const currentCursor of cursor.inner) {
+            Object.assign(currentCursor, { getParent: this.makeGetParent(cursor) });
+            if (cursor.kind === ArkCxxAstNode_1.astKind.CXXRecordDecl || cursor.kind === ArkCxxAstNode_1.astKind.CXXMethodDecl || cursor.kind === ArkCxxAstNode_1.astKind.FunctionDecl) {
+                this.processAccess(currentCursor);
+            }
+            this.fullInfo(currentCursor);
+        }
+    }
+    static processAccess(cursor) {
+        var _a, _b;
+        cursor.modifiers = [];
+        if (cursor.kind === 'AccessSpecDecl') {
+            this.currentAccess = (_b = (_a = cursor.access) !== null && _a !== void 0 ? _a : (0, astUtils_1.extractAllCppModifiers)(cursor.code)[0]) !== null && _b !== void 0 ? _b : '';
+        }
+        else {
+            const extractedCode = this.getCodeForExtractModifiers(cursor);
+            const codeModifier = (0, astUtils_1.extractAllCppModifiers)(extractedCode);
+            if (this.currentAccess !== '') {
+                cursor.modifiers.push(this.currentAccess);
+            }
+            if (codeModifier !== null) {
+                cursor.modifiers.push(...codeModifier);
+            }
+        }
+    }
+    static getCodeForExtractModifiers(cursor) {
+        const extractedCode = cursor.code;
+        if (!['CXXConstructorDecl', 'CXXDestructorDecl', 'CXXMethodDecl', 'FriendDecl', 'FunctionDecl', 'FunctionTemplateDecl'].includes(cursor.kind)) {
+            return extractedCode;
+        }
+        const bodyNode = cursor.inner.filter((inner) => inner.kind === 'CompoundStmt');
+        const bodyCode = bodyNode.length === 0 ? '' : bodyNode[0].code;
+        return this.stripFucntionParams(extractedCode.replace(bodyCode, ''));
+    }
+    static stripFucntionParams(code) {
+        let depth = 0;
+        let start = -1;
+        let end = -1;
+        for (let i = 0; i < code.length; i++) {
+            const ch = code[i];
+            if (ch === '(') {
+                if (depth === 0) {
+                    start = i;
+                }
+                depth++;
+            }
+            else if (ch === ')') {
+                depth--;
+                if (depth === 0) {
+                    end = i;
+                    break;
+                }
+            }
+        }
+        if (start === -1 || end === -1) {
+            return code;
+        }
+        return code.slice(0, start).trimEnd() + ' ' + code.slice(end + 1).trimStart();
+    }
+    static getAstOutputPath(sourceFile, cppAstPath) {
+        const fileName = `${path.parse(path.basename(sourceFile)).name}_AST.json`;
+        if (cppAstPath !== '') {
+            return path.join(cppAstPath, fileName);
+        }
+        return path.join(astUtils_1.ClangPath.protectRoot, 'src', 'frontend', 'cppFrontend', 'ast', 'out', fileName);
+    }
+    static ensureOutputDir(dir) {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+}
+exports.AstParser = AstParser;
+AstParser.currentAccess = '';

package/lib/frontend/cppFrontend/ast/astUtils.d.ts

@@ -1,51 +1,18 @@
-import { CxxAstNode, CxxAstNodeLite } from './ArkCxxAstNode';
-export type GetParentFn = {
-    (isNeedInner: true): CxxAstNode;
-    (isNeedInner?: false): CxxAstNodeLite;
-};
-export declare class AstUtils {
-    private static currentAccess;
-    private static deleteFileSync;
-    static parse(sourceFile: string, ccJsonPath: string | null, includeDirs: string[] | null, llvmPath: string, cppAstPath: string): CxxAstNode;
-    /**
-     * Auxiliary method: Try to find and return the root directory of src/main/cpp
-     */
-    private static resolveProjectRoot;
-    /**
-     * Auxiliary method: Determine Work Catalog (CWD)
-     */
-    private static getWorkingDir;
-    /**
-     * Auxiliary method: Execute Clang process and print debugging logs
-     */
-    private static runClang;
-    /**
-     * Auxiliary method: Read and parse the generated AST JSON file
-     */
-    private static processAstFile;
-    private static createEmptyNode;
-    private static updateInner;
-    private static filter;
-    private static filterChildren;
-    private static makeGetParent;
-    private static fullInfo;
-    static extractAllCppModifiers(code: string): string[];
-    private static processAccess;
-    private static getCodeForExtractModifiers;
-    private static stripFucntionParams;
-    private static getAstOutputPath;
-    private static ensureOutputDir;
-    private static getPlatformClang;
+export declare function findProjectRoot(startDir?: string): string;
+/**
+ * Resolved path to the astJsonDumper N-API addon ({@code astJsonDumper.node} under dumper/ or lib/ast/).
+ */
+export declare function getAstJsonDumperNodePath(): string;
+/** True when {@link getAstJsonDumperNodePath} exists on disk. */
+export declare function isAstJsonDumperAvailable(): boolean;
+/** Project-root anchor for C++ AST output paths (legacy name: historically held Clang binary paths). */
+export declare class ClangPath {
+    static protectRoot: string;
 }
+export declare function extractAllCppModifiers(code: string): string[];
 /**
  * Find the absolute path of compile_commands.json starting from a file path.
- * Strict logic: Only traverses upward (ancestors) to find a ".cxx" directory.
- * Does NOT search sibling/uncle directories.
- * Caches the result based on the project root (the directory containing .cxx).
- * CxxTodo :Further confirmation can be made on whether there is a summary of the entire project's ccjson,
- * which only needs to be provided once in the scene build,(the directory containing ./.idea/.deveco/cxx/.cache)
- * * @param filePath Absolute path of the input file
- * @returns Absolute path of compile_commands.json if found, otherwise empty string
+ * Strict logic: only traverses upward (ancestors) to find a ".cxx" directory.
  */
 export declare function findCompileCommands(filePath: string): string;
 //# sourceMappingURL=astUtils.d.ts.map

package/lib/frontend/cppFrontend/ast/astUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"astUtils.d.ts","sourceRoot":"","sources":["../../../../src/frontend/cppFrontend/ast/astUtils.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAW,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMtE,MAAM,MAAM,WAAW,GAAG;IACtB,CAAC,WAAW,EAAE,IAAI,GAAG,UAAU,CAAC;IAChC,CAAC,WAAW,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC;CACzC,CAAC;AAEF,qBAAa,QAAQ;IACjB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAc;IAE1C,OAAO,CAAC,MAAM,CAAC,cAAc;WAQf,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU;IAuClJ;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAoBjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IAwBvB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAsB7B,OAAO,CAAC,MAAM,CAAC,eAAe;IAI9B,OAAO,CAAC,MAAM,CAAC,WAAW;IAc1B,OAAO,CAAC,MAAM,CAAC,MAAM;IAYrB,OAAO,CAAC,MAAM,CAAC,cAAc;IAU7B,OAAO,CAAC,MAAM,CAAC,aAAa;IAgB5B,OAAO,CAAC,MAAM,CAAC,QAAQ;IAkCvB,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAyBrD,OAAO,CAAC,MAAM,CAAC,aAAa;IAiB5B,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAUzC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAyBlC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAQ/B,OAAO,CAAC,MAAM,CAAC,eAAe;IAM9B,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAYlC;AAeD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+C5D"}
+{"version":3,"file":"astUtils.d.ts","sourceRoot":"","sources":["../../../../src/frontend/cppFrontend/ast/astUtils.ts"],"names":[],"mappings":"AAqBA,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAkB,GAAG,MAAM,CAYpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAOjD;AAED,iEAAiE;AACjE,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,wGAAwG;AACxG,qBAAa,SAAS;IAClB,OAAc,WAAW,SAA8B;CAC1D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB7D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA4B5D"}