projscan 1.6.2 → 1.7.0

package/dist/core/languages/LanguageAdapter.d.ts

@@ -1,6 +1,6 @@
 import type { FileEntry } from '../../types.js';
 import type { AstResult } from '../ast.js';
-export type LanguageId = 'javascript' | 'python' | 'go' | 'java' | 'ruby' | 'rust' | 'php' | 'csharp';
+export type LanguageId = 'javascript' | 'python' | 'go' | 'java' | 'ruby' | 'rust' | 'php' | 'csharp' | 'kotlin' | 'cpp';
 export interface LanguageResolveContext {
     /** Language-specific root dirs used during import resolution. */
     packageRoots?: string[];

package/dist/core/languages/cppAdapter.d.ts

@@ -0,0 +1,2 @@
+import type { LanguageAdapter } from './LanguageAdapter.js';
+export declare const cppAdapter: LanguageAdapter;

package/dist/core/languages/cppAdapter.js

@@ -0,0 +1,145 @@
+import path from 'node:path';
+import { createParserFor } from './treeSitterLoader.js';
+import { extractCppImports } from './cppImports.js';
+import { extractCppExports } from './cppExports.js';
+import { extractCppCyclomatic } from './cppCyclomatic.js';
+import { extractCppFunctions } from './cppFunctions.js';
+import { extractCppCallSites } from './cppCallSites.js';
+import { detectCppProject } from './cppManifests.js';
+const CPP_EXTENSIONS = new Set(['.cpp', '.cc', '.cxx', '.c', '.h', '.hpp', '.hxx']);
+const SOURCE_EXTENSIONS = new Set(['.cpp', '.cc', '.cxx', '.c']);
+const MAX_CPP_FILE = 1024 * 1024;
+let parserPromise = null;
+async function getParser() {
+    if (!parserPromise)
+        parserPromise = createParserFor('tree-sitter-cpp.wasm');
+    return parserPromise;
+}
+export const cppAdapter = {
+    id: 'cpp',
+    extensions: CPP_EXTENSIONS,
+    // Only .cpp/.cc/.cxx/.c are "source" for dead-code purposes; headers
+    // hold the declarations they consume.
+    sourceExtensions: SOURCE_EXTENSIONS,
+    barrelBasenames: new Set(),
+    maxFileSize: MAX_CPP_FILE,
+    async parse(_filePath, content) {
+        try {
+            const parser = await getParser();
+            const tree = parser.parse(content);
+            if (!tree || !tree.rootNode) {
+                return {
+                    ok: false,
+                    reason: 'tree-sitter returned null tree',
+                    imports: [],
+                    exports: [],
+                    callSites: [],
+                    lineCount: content ? content.split('\n').length : 0,
+                    cyclomaticComplexity: 0,
+                    functions: [],
+                };
+            }
+            const root = tree.rootNode;
+            const imports = extractCppImports(root);
+            const exports = extractCppExports(root);
+            const cyclomaticComplexity = extractCppCyclomatic(root);
+            const callSites = extractCppCallSites(root);
+            const functions = extractCppFunctions(root);
+            return {
+                ok: true,
+                imports,
+                exports,
+                callSites,
+                lineCount: content ? content.split('\n').length : 0,
+                cyclomaticComplexity,
+                functions,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                ok: false,
+                reason: `cpp parse failure: ${msg.slice(0, 120)}`,
+                imports: [],
+                exports: [],
+                callSites: [],
+                lineCount: content ? content.split('\n').length : 0,
+                cyclomaticComplexity: 0,
+                functions: [],
+            };
+        }
+    },
+    resolveImport(importingFile, source, graphFiles, context) {
+        return resolveCppImport(importingFile, source, graphFiles, context);
+    },
+    toPackageName(source) {
+        if (!source)
+            return null;
+        // For #include, the "package" is the system header name (`vector`,
+        // `iostream`) when angle-bracketed. Quoted includes are project-local
+        // and should resolve via resolveImport — but we don't know quoting
+        // at this layer, so we conservatively return null for paths that
+        // look relative (`./`, `../`, contain `/`) and the bare leaf for
+        // angle-bracket-style names.
+        if (source.startsWith('./') || source.startsWith('../'))
+            return null;
+        if (source.includes('/'))
+            return source.split('/')[0];
+        return source;
+    },
+    async preparePackageRoots(rootPath, files) {
+        const info = await detectCppProject(rootPath, files);
+        return {
+            packageRoots: info ? info.includeRoots.map((r) => path.relative(rootPath, path.join(rootPath, r)) || '.') : [],
+            meta: info ? { cppProject: info } : undefined,
+        };
+    },
+};
+/**
+ * Resolve a C++ `#include` source to a repo-local file. We try, in order:
+ *
+ *   1. Relative to the importing file's directory (quoted-include semantics).
+ *   2. Each detected include root (e.g., `include/`, `src/`, `lib/`).
+ *
+ * We return the first hit. Standard-library / third-party headers (e.g.,
+ * `<vector>`, `<boost/optional.hpp>`) won't match anything in the graph
+ * and resolve to null, which is correct — they're external.
+ */
+function resolveCppImport(importingFile, source, graphFiles, context) {
+    if (!source)
+        return null;
+    const project = context.meta?.cppProject;
+    const includeRoots = context.packageRoots ?? project?.includeRoots ?? [];
+    // 1) Relative to the importing file. tree-sitter doesn't tell us whether
+    // the source was quoted or angle-bracketed, but the resolver works the
+    // same way for either: we try the importing file's directory first.
+    const importingDir = path.posix.dirname(importingFile);
+    const relative = normalizeRelative(importingDir, source);
+    if (relative && graphFiles.has(relative))
+        return relative;
+    // 2) Each include root.
+    for (const root of includeRoots) {
+        const rootSegs = root === '.' || root === '' ? [] : root.split('/').filter(Boolean);
+        const candidate = [...rootSegs, ...source.split('/').filter(Boolean)].join('/');
+        if (graphFiles.has(candidate))
+            return candidate;
+    }
+    return null;
+}
+function normalizeRelative(baseDir, source) {
+    // Strip any leading `./`. For `../foo`, walk up the baseDir.
+    let dir = baseDir === '.' ? '' : baseDir;
+    let rest = source;
+    while (rest.startsWith('./'))
+        rest = rest.slice(2);
+    while (rest.startsWith('../')) {
+        if (!dir)
+            return null;
+        dir = path.posix.dirname(dir);
+        if (dir === '.')
+            dir = '';
+        rest = rest.slice(3);
+    }
+    return dir ? `${dir}/${rest}` : rest;
+}
+//# sourceMappingURL=cppAdapter.js.map

package/dist/core/languages/cppAdapter.js.map

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

package/dist/core/languages/cppCallSites.d.ts

@@ -0,0 +1,13 @@
+interface TsNode {
+    type: string;
+    text: string;
+    namedChildren: TsNode[];
+    childForFieldName?: (name: string) => TsNode | null;
+}
+/**
+ * Extract called-name from each `call_expression` in a tree-sitter-cpp AST.
+ * Mirrors the existing adapter behaviour: dedupe names, strip qualification,
+ * so `obj.foo()`, `Foo::bar()`, and `bar()` all surface as just the leaf.
+ */
+export declare function extractCppCallSites(root: TsNode): string[];
+export {};

package/dist/core/languages/cppCallSites.js

@@ -0,0 +1,62 @@
+/**
+ * Extract called-name from each `call_expression` in a tree-sitter-cpp AST.
+ * Mirrors the existing adapter behaviour: dedupe names, strip qualification,
+ * so `obj.foo()`, `Foo::bar()`, and `bar()` all surface as just the leaf.
+ */
+export function extractCppCallSites(root) {
+    const seen = new Set();
+    walk(root, (n) => {
+        if (n.type !== 'call_expression')
+            return;
+        const fn = pickCallee(n);
+        if (!fn)
+            return;
+        const name = bareName(fn);
+        if (name)
+            seen.add(name);
+    });
+    return [...seen];
+}
+function pickCallee(node) {
+    if (node.childForFieldName) {
+        const f = node.childForFieldName('function');
+        if (f)
+            return f;
+    }
+    return node.namedChildren[0] ?? null;
+}
+function bareName(node) {
+    switch (node.type) {
+        case 'identifier':
+        case 'field_identifier':
+        case 'type_identifier':
+            return node.text;
+        case 'qualified_identifier': {
+            const last = node.namedChildren[node.namedChildren.length - 1];
+            return last ? bareName(last) : null;
+        }
+        case 'field_expression': {
+            const f = node.childForFieldName ? node.childForFieldName('field') : null;
+            if (f)
+                return bareName(f);
+            const last = node.namedChildren[node.namedChildren.length - 1];
+            return last ? bareName(last) : null;
+        }
+        case 'template_function': {
+            const f = node.childForFieldName ? node.childForFieldName('name') : null;
+            return f ? bareName(f) : null;
+        }
+        case 'call_expression': {
+            const inner = pickCallee(node);
+            return inner ? bareName(inner) : null;
+        }
+        default:
+            return null;
+    }
+}
+function walk(node, visit) {
+    visit(node);
+    for (const child of node.namedChildren)
+        walk(child, visit);
+}
+//# sourceMappingURL=cppCallSites.js.map

package/dist/core/languages/cppCallSites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cppCallSites.js","sourceRoot":"","sources":["../../../src/core/languages/cppCallSites.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE;QACf,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB;YAAE,OAAO;QACzC,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACvC,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,YAAY,CAAC;QAClB,KAAK,kBAAkB,CAAC;QACxB,KAAK,iBAAiB;YACpB,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtC,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1E,IAAI,CAAC;gBAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtC,CAAC;QACD,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACzE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChC,CAAC;QACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxC,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,IAAI,CAAC,IAAY,EAAE,KAA0B;IACpD,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa;QAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC7D,CAAC"}

package/dist/core/languages/cppCyclomatic.d.ts

@@ -0,0 +1,25 @@
+interface TsNode {
+    type: string;
+    text: string;
+    namedChildren: TsNode[];
+    childForFieldName?: (name: string) => TsNode | null;
+}
+/**
+ * File-level McCabe cyclomatic complexity for a tree-sitter-cpp AST.
+ *
+ * Decision points in C++:
+ *   if_statement                   +1
+ *   for_statement                  +1
+ *   for_range_loop                 +1
+ *   while_statement                +1
+ *   do_statement                   +1
+ *   try_statement                  +1
+ *   catch_clause                   +1 each
+ *   case_statement (non-default)   +1
+ *   conditional_expression (`?:`)  +1
+ *   binary_expression `&&` / `||`  +1 each
+ *
+ * `case 1:` and `case 2:` count individually; `default:` does not.
+ */
+export declare function extractCppCyclomatic(root: TsNode): number;
+export {};

package/dist/core/languages/cppCyclomatic.js

@@ -0,0 +1,82 @@
+/**
+ * File-level McCabe cyclomatic complexity for a tree-sitter-cpp AST.
+ *
+ * Decision points in C++:
+ *   if_statement                   +1
+ *   for_statement                  +1
+ *   for_range_loop                 +1
+ *   while_statement                +1
+ *   do_statement                   +1
+ *   try_statement                  +1
+ *   catch_clause                   +1 each
+ *   case_statement (non-default)   +1
+ *   conditional_expression (`?:`)  +1
+ *   binary_expression `&&` / `||`  +1 each
+ *
+ * `case 1:` and `case 2:` count individually; `default:` does not.
+ */
+export function extractCppCyclomatic(root) {
+    let decisions = 0;
+    walk(root, (n) => {
+        if (isDecisionPoint(n))
+            decisions++;
+    });
+    return decisions + 1;
+}
+function isDecisionPoint(n) {
+    switch (n.type) {
+        case 'if_statement':
+        case 'for_statement':
+        case 'for_range_loop':
+        case 'while_statement':
+        case 'do_statement':
+        case 'try_statement':
+        case 'catch_clause':
+        case 'conditional_expression':
+            return true;
+        case 'case_statement': {
+            // tree-sitter-cpp exposes a `value` field for `case X:` and leaves it
+            // null for `default:`. Field-based detection is more reliable than
+            // text inspection, which can misbehave when comments / whitespace
+            // sit between the keyword and the colon.
+            if (n.childForFieldName) {
+                const value = n.childForFieldName('value');
+                if (value)
+                    return true;
+            }
+            // Fallback for grammar versions without the `value` field: a regular
+            // `case` has its label value as the first named child (literal /
+            // identifier / expression). The `default` form's first named child
+            // is whatever statement follows the colon.
+            const first = n.namedChildren[0];
+            if (!first)
+                return false;
+            return !STATEMENT_NODES.has(first.type);
+        }
+        case 'binary_expression':
+            return /(\s|^)(\|\||&&)(\s|$)/.test(n.text);
+        default:
+            return false;
+    }
+}
+const STATEMENT_NODES = new Set([
+    'return_statement',
+    'break_statement',
+    'continue_statement',
+    'expression_statement',
+    'compound_statement',
+    'if_statement',
+    'for_statement',
+    'while_statement',
+    'do_statement',
+    'switch_statement',
+    'goto_statement',
+    'declaration',
+    'labeled_statement',
+]);
+function walk(node, visit) {
+    visit(node);
+    for (const child of node.namedChildren)
+        walk(child, visit);
+}
+//# sourceMappingURL=cppCyclomatic.js.map

package/dist/core/languages/cppCyclomatic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cppCyclomatic.js","sourceRoot":"","sources":["../../../src/core/languages/cppCyclomatic.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE;QACf,IAAI,eAAe,CAAC,CAAC,CAAC;YAAE,SAAS,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,eAAe,CAAC,CAAS;IAChC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,cAAc,CAAC;QACpB,KAAK,eAAe,CAAC;QACrB,KAAK,gBAAgB,CAAC;QACtB,KAAK,iBAAiB,CAAC;QACvB,KAAK,cAAc,CAAC;QACpB,KAAK,eAAe,CAAC;QACrB,KAAK,cAAc,CAAC;QACpB,KAAK,wBAAwB;YAC3B,OAAO,IAAI,CAAC;QACd,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,sEAAsE;YACtE,mEAAmE;YACnE,kEAAkE;YAClE,yCAAyC;YACzC,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;gBAC3C,IAAI,KAAK;oBAAE,OAAO,IAAI,CAAC;YACzB,CAAC;YACD,qEAAqE;YACrE,iEAAiE;YACjE,mEAAmE;YACnE,2CAA2C;YAC3C,MAAM,KAAK,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzB,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,mBAAmB;YACtB,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9C;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,kBAAkB;IAClB,iBAAiB;IACjB,oBAAoB;IACpB,sBAAsB;IACtB,oBAAoB;IACpB,cAAc;IACd,eAAe;IACf,iBAAiB;IACjB,cAAc;IACd,kBAAkB;IAClB,gBAAgB;IAChB,aAAa;IACb,mBAAmB;CACpB,CAAC,CAAC;AAEH,SAAS,IAAI,CAAC,IAAY,EAAE,KAA0B;IACpD,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa;QAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC7D,CAAC"}

package/dist/core/languages/cppExports.d.ts

@@ -0,0 +1,13 @@
+import type { AstExport } from '../ast.js';
+interface TsNode {
+    type: string;
+    text: string;
+    startPosition: {
+        row: number;
+        column: number;
+    };
+    namedChildren: TsNode[];
+    childForFieldName?: (name: string) => TsNode | null;
+}
+export declare function extractCppExports(root: TsNode): AstExport[];
+export {};

package/dist/core/languages/cppExports.js

@@ -0,0 +1,120 @@
+/**
+ * Extract top-level C++ declarations as exports.
+ *
+ * C++ has no first-class export model the way Rust / Kotlin do; "exports"
+ * for graph purposes are top-level declarations that are visible to other
+ * translation units. We surface:
+ *
+ *   function_definition       → function     (free functions and methods)
+ *   class_specifier           → class
+ *   struct_specifier          → class        (structs are classes with default-public)
+ *   union_specifier           → class
+ *   enum_specifier            → enum
+ *   alias_declaration         → type         (`using Foo = Bar;`)
+ *   type_definition           → type         (`typedef ... Foo;`)
+ *   declaration (var/const)   → variable     (top-level globals)
+ *
+ * `static` at file scope marks a translation-unit-internal symbol; we
+ * still surface it (the graph treats it as a local definition).
+ *
+ * Member declarations inside class bodies are NOT extracted (they're
+ * reachable via the class export). Anonymous namespaces are descended.
+ */
+const EXPORT_NODE_TO_KIND = {
+    function_definition: 'function',
+    class_specifier: 'class',
+    struct_specifier: 'class',
+    union_specifier: 'class',
+    enum_specifier: 'enum',
+    alias_declaration: 'type',
+    type_definition: 'type',
+};
+export function extractCppExports(root) {
+    const exports = [];
+    visitTopLevel(root, exports);
+    return exports;
+}
+function visitTopLevel(node, out) {
+    // Descend through namespace and linkage_specification (`extern "C" { ... }`)
+    // wrappers — top-level declarations inside them are still file-scope.
+    if (node.type === 'translation_unit' ||
+        node.type === 'namespace_definition' ||
+        node.type === 'linkage_specification' ||
+        node.type === 'declaration_list') {
+        for (const c of node.namedChildren)
+            visitTopLevel(c, out);
+        return;
+    }
+    const kind = EXPORT_NODE_TO_KIND[node.type];
+    if (kind) {
+        const name = nameOf(node);
+        if (name)
+            out.push({ name, kind, typeOnly: false, line: node.startPosition.row + 1 });
+        return;
+    }
+    // Top-level variable / constant declarations: tree-sitter-cpp uses
+    // `declaration` for these. A declaration at translation-unit scope with
+    // a single declarator is a variable export.
+    if (node.type === 'declaration') {
+        const declarators = collectDeclarators(node);
+        for (const d of declarators) {
+            out.push({ name: d.name, kind: 'variable', typeOnly: false, line: node.startPosition.row + 1 });
+        }
+        return;
+    }
+    // Don't recurse into anything else — class bodies and function bodies
+    // hold non-top-level declarations.
+}
+function collectDeclarators(declaration) {
+    const out = [];
+    for (const c of declaration.namedChildren) {
+        // function_declarator / init_declarator / array_declarator are wrappers
+        // around an identifier. Drill through them.
+        const id = innerIdentifier(c);
+        if (id)
+            out.push({ name: id });
+    }
+    return out;
+}
+function innerIdentifier(node) {
+    if (node.type === 'identifier' ||
+        node.type === 'field_identifier' ||
+        node.type === 'type_identifier') {
+        return node.text;
+    }
+    if (node.type === 'init_declarator' ||
+        node.type === 'array_declarator' ||
+        node.type === 'pointer_declarator' ||
+        node.type === 'reference_declarator' ||
+        node.type === 'parenthesized_declarator' ||
+        node.type === 'function_declarator') {
+        if (node.childForFieldName) {
+            const dec = node.childForFieldName('declarator');
+            if (dec)
+                return innerIdentifier(dec);
+        }
+        for (const c of node.namedChildren) {
+            const r = innerIdentifier(c);
+            if (r)
+                return r;
+        }
+    }
+    return null;
+}
+function nameOf(node) {
+    if (node.childForFieldName) {
+        const id = node.childForFieldName('name');
+        if (id && id.text)
+            return id.text;
+        const dec = node.childForFieldName('declarator');
+        if (dec)
+            return innerIdentifier(dec);
+    }
+    for (const c of node.namedChildren) {
+        if (c.type === 'identifier' || c.type === 'field_identifier' || c.type === 'type_identifier') {
+            return c.text;
+        }
+    }
+    return innerIdentifier(node);
+}
+//# sourceMappingURL=cppExports.js.map

package/dist/core/languages/cppExports.js.map

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

package/dist/core/languages/cppFunctions.d.ts

@@ -0,0 +1,30 @@
+import type { FunctionInfo } from '../ast.js';
+interface TsNode {
+    type: string;
+    text: string;
+    startPosition: {
+        row: number;
+        column: number;
+    };
+    endPosition: {
+        row: number;
+        column: number;
+    };
+    namedChildren: TsNode[];
+    childForFieldName?: (name: string) => TsNode | null;
+}
+/**
+ * Per-function McCabe CC for C++. Walks `function_definition` nodes
+ * (free functions, methods defined out-of-line, lambdas are NOT
+ * extracted as separate entries; their decisions fold into the
+ * enclosing function — matches the convention used elsewhere).
+ *
+ * Member functions defined inside a class body are named `Class.method`.
+ * Out-of-line definitions (`void Foo::bar() { ... }`) are also named
+ * `Foo.bar` based on the qualified declarator.
+ *
+ * `case` labels each contribute +1; `default:` does not. Ternaries (`?:`)
+ * count as +1. Logical `&&` and `||` each count.
+ */
+export declare function extractCppFunctions(root: TsNode): FunctionInfo[];
+export {};