projscan 1.6.1 → 1.7.0

package/dist/core/languages/cppManifests.js

@@ -0,0 +1,41 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const COMMON_CPP_ROOTS = ['include', 'src', 'lib', '.'];
+/**
+ * Detect C++ source roots. We don't parse CMakeLists / Make files; we
+ * survey .cpp/.cc/.cxx/.h/.hpp file paths and pick whichever conventional
+ * roots actually contain sources.
+ */
+export async function detectCppProject(rootPath, files) {
+    const cppFiles = files.filter((f) => isCppExtension(f.relativePath));
+    if (cppFiles.length === 0)
+        return null;
+    const hasCMake = await fileExists(path.join(rootPath, 'CMakeLists.txt'));
+    const hasMakefile = await fileExists(path.join(rootPath, 'Makefile'));
+    const includeRoots = [];
+    for (const candidate of COMMON_CPP_ROOTS) {
+        if (candidate === '.') {
+            if (cppFiles.some((f) => !f.relativePath.includes('/')))
+                includeRoots.push('.');
+        }
+        else if (cppFiles.some((f) => f.relativePath.startsWith(candidate + '/'))) {
+            includeRoots.push(candidate);
+        }
+    }
+    if (includeRoots.length === 0)
+        includeRoots.push('.');
+    return { includeRoots, hasCMake, hasMakefile };
+}
+async function fileExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isCppExtension(p) {
+    return /\.(cpp|cc|cxx|c\+\+|c|h|hpp|hxx|h\+\+)$/.test(p);
+}
+//# sourceMappingURL=cppManifests.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cppManifests.js","sourceRoot":"","sources":["../../../src/core/languages/cppManifests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAe7B,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,KAAkB;IAElB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IACrE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IACtE,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;QACzC,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClF,CAAC;aAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5E,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACjD,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,CAAS;IACjC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,yCAAyC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC"}

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

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

package/dist/core/languages/kotlinAdapter.js

@@ -0,0 +1,141 @@
+import path from 'node:path';
+import { createParserFor } from './treeSitterLoader.js';
+import { extractKotlinImports } from './kotlinImports.js';
+import { extractKotlinExports } from './kotlinExports.js';
+import { extractKotlinCyclomatic } from './kotlinCyclomatic.js';
+import { extractKotlinFunctions } from './kotlinFunctions.js';
+import { extractKotlinCallSites } from './kotlinCallSites.js';
+import { detectKotlinProject } from './kotlinManifests.js';
+const KOTLIN_EXTENSIONS = new Set(['.kt', '.kts']);
+const MAX_KOTLIN_FILE = 1024 * 1024;
+let parserPromise = null;
+async function getParser() {
+    if (!parserPromise)
+        parserPromise = createParserFor('tree-sitter-kotlin.wasm');
+    return parserPromise;
+}
+export const kotlinAdapter = {
+    id: 'kotlin',
+    extensions: KOTLIN_EXTENSIONS,
+    sourceExtensions: KOTLIN_EXTENSIONS,
+    // Kotlin has no "barrel-file" idiom; entry-points are .kt files with `fun main`.
+    barrelBasenames: new Set(),
+    maxFileSize: MAX_KOTLIN_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 = extractKotlinImports(root);
+            const exports = extractKotlinExports(root);
+            const cyclomaticComplexity = extractKotlinCyclomatic(root);
+            const callSites = extractKotlinCallSites(root);
+            const functions = extractKotlinFunctions(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: `kotlin 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 resolveKotlinImport(importingFile, source, graphFiles, context);
+    },
+    toPackageName(source) {
+        if (!source)
+            return null;
+        // Heuristic: a Kotlin import that begins with the project's own
+        // detected source-root directory shouldn't be a "package" — but at
+        // graph-build time we don't have project info here. Defer to
+        // resolveImport: anything that resolveImport can't pin to a local
+        // file falls through as external.
+        return source.split('.')[0] || null;
+    },
+    async preparePackageRoots(rootPath, files) {
+        const info = await detectKotlinProject(rootPath, files);
+        return {
+            packageRoots: info ? info.packageRoots.map((r) => path.relative(rootPath, path.join(rootPath, r)) || '.') : [],
+            meta: info ? { kotlinProject: info } : undefined,
+        };
+    },
+};
+/**
+ * Resolve a Kotlin `import com.foo.Bar` to a repo-local file. The path
+ * `com.foo.Bar` becomes `com/foo/Bar.kt` under each known package root.
+ * Wildcard imports (`com.foo.*`) resolve to `com/foo/<any>.kt` and we
+ * pick the first match if any. Non-local (stdlib, third-party) imports
+ * return null.
+ */
+function resolveKotlinImport(_importingFile, source, graphFiles, context) {
+    if (!source)
+        return null;
+    const project = context.meta?.kotlinProject;
+    const packageRoots = context.packageRoots ?? project?.packageRoots ?? [];
+    if (packageRoots.length === 0)
+        return null;
+    const isWildcard = source.endsWith('.*');
+    const cleanedSegments = (isWildcard ? source.slice(0, -2) : source).split('.').filter(Boolean);
+    if (cleanedSegments.length === 0)
+        return null;
+    for (const root of packageRoots) {
+        const rootSegs = root === '.' || root === '' ? [] : root.split('/').filter(Boolean);
+        if (isWildcard) {
+            const dirParts = [...rootSegs, ...cleanedSegments];
+            const prefix = dirParts.join('/') + '/';
+            // Pick any file under that package directory.
+            for (const key of graphFiles.keys()) {
+                if (key.startsWith(prefix) && (key.endsWith('.kt') || key.endsWith('.kts'))) {
+                    return key;
+                }
+            }
+            continue;
+        }
+        // Non-wildcard: try each segment count from full → 1, since the last segment
+        // could be a class name OR a file name. Try `com/foo/Bar.kt`, then if not
+        // found try `com/foo.kt` (top-level decl in Foo.kt).
+        for (let drop = 0; drop <= 1; drop++) {
+            const segs = cleanedSegments.slice(0, cleanedSegments.length - drop);
+            if (segs.length === 0)
+                break;
+            const baseSegs = [...rootSegs, ...segs.slice(0, -1)];
+            const fileName = segs[segs.length - 1];
+            const asKt = [...baseSegs, `${fileName}.kt`].join('/');
+            if (graphFiles.has(asKt))
+                return asKt;
+            const asKts = [...baseSegs, `${fileName}.kts`].join('/');
+            if (graphFiles.has(asKts))
+                return asKts;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=kotlinAdapter.js.map

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

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

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

@@ -0,0 +1,15 @@
+interface TsNode {
+    type: string;
+    text: string;
+    namedChildren: TsNode[];
+    childForFieldName?: (name: string) => TsNode | null;
+}
+/**
+ * Extract the called identifier from each `call_expression` in a
+ * tree-sitter-kotlin AST. Mirrors the existing adapter behaviour: we
+ * deduplicate names and strip qualification so that `foo.bar()` and `bar()`
+ * both produce `bar`. Constructor calls (`Foo()`) and infix-form calls are
+ * captured the same way.
+ */
+export declare function extractKotlinCallSites(root: TsNode): string[];
+export {};

package/dist/core/languages/kotlinCallSites.js

@@ -0,0 +1,62 @@
+/**
+ * Extract the called identifier from each `call_expression` in a
+ * tree-sitter-kotlin AST. Mirrors the existing adapter behaviour: we
+ * deduplicate names and strip qualification so that `foo.bar()` and `bar()`
+ * both produce `bar`. Constructor calls (`Foo()`) and infix-form calls are
+ * captured the same way.
+ */
+export function extractKotlinCallSites(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 'simple_identifier':
+        case 'identifier':
+        case 'type_identifier':
+            return node.text;
+        case 'navigation_expression': {
+            const last = node.namedChildren[node.namedChildren.length - 1];
+            return last ? bareName(last) : null;
+        }
+        case 'navigation_suffix': {
+            for (const c of node.namedChildren) {
+                const n = bareName(c);
+                if (n)
+                    return n;
+            }
+            return null;
+        }
+        case 'call_expression': {
+            // Foo()() — a chained invocation; recurse on the inner callee.
+            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=kotlinCallSites.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kotlinCallSites.js","sourceRoot":"","sources":["../../../src/core/languages/kotlinCallSites.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,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,mBAAmB,CAAC;QACzB,KAAK,YAAY,CAAC;QAClB,KAAK,iBAAiB;YACpB,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,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,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,CAAC;oBAAE,OAAO,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,+DAA+D;YAC/D,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/kotlinCyclomatic.d.ts

@@ -0,0 +1,24 @@
+interface TsNode {
+    type: string;
+    text: string;
+    namedChildren: TsNode[];
+}
+/**
+ * File-level McCabe cyclomatic complexity for a tree-sitter-kotlin AST.
+ *
+ * Decision points in Kotlin:
+ *   if_expression                +1 (the `if` itself; `else` does not count)
+ *   for_statement                +1
+ *   while_statement              +1
+ *   do_while_statement           +1
+ *   try_expression               +1 (success vs throw paths)
+ *   catch_block                  +1 (each catch is a separate handler)
+ *   when_entry (non-else)        +1 (each non-else `when` arm is a branch)
+ *   conjunction_expression       +1 (Kotlin's `&&`)
+ *   disjunction_expression       +1 (Kotlin's `||`)
+ *
+ * The Elvis operator `?:` and safe-call `?.` do NOT count as branches —
+ * matches the convention used elsewhere in projscan and most analyzers.
+ */
+export declare function extractKotlinCyclomatic(root: TsNode): number;
+export {};

package/dist/core/languages/kotlinCyclomatic.js

@@ -0,0 +1,54 @@
+/**
+ * File-level McCabe cyclomatic complexity for a tree-sitter-kotlin AST.
+ *
+ * Decision points in Kotlin:
+ *   if_expression                +1 (the `if` itself; `else` does not count)
+ *   for_statement                +1
+ *   while_statement              +1
+ *   do_while_statement           +1
+ *   try_expression               +1 (success vs throw paths)
+ *   catch_block                  +1 (each catch is a separate handler)
+ *   when_entry (non-else)        +1 (each non-else `when` arm is a branch)
+ *   conjunction_expression       +1 (Kotlin's `&&`)
+ *   disjunction_expression       +1 (Kotlin's `||`)
+ *
+ * The Elvis operator `?:` and safe-call `?.` do NOT count as branches —
+ * matches the convention used elsewhere in projscan and most analyzers.
+ */
+export function extractKotlinCyclomatic(root) {
+    let decisions = 0;
+    walk(root, (n) => {
+        if (isDecisionPoint(n))
+            decisions++;
+    });
+    return decisions + 1;
+}
+function isDecisionPoint(n) {
+    switch (n.type) {
+        case 'if_expression':
+        case 'for_statement':
+        case 'while_statement':
+        case 'do_while_statement':
+        case 'try_expression':
+        case 'catch_block':
+        case 'conjunction_expression':
+        case 'disjunction_expression':
+            return true;
+        case 'when_entry': {
+            // The `else` arm has no `when_condition` child — the `else` keyword is
+            // an anonymous token in tree-sitter-kotlin, so checking child text
+            // doesn't work reliably. Non-else arms always carry at least one
+            // `when_condition` (multi-value arms like `1, 2 ->` carry several).
+            const hasCondition = n.namedChildren.some((c) => c.type === 'when_condition');
+            return hasCondition;
+        }
+        default:
+            return false;
+    }
+}
+function walk(node, visit) {
+    visit(node);
+    for (const child of node.namedChildren)
+        walk(child, visit);
+}
+//# sourceMappingURL=kotlinCyclomatic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kotlinCyclomatic.js","sourceRoot":"","sources":["../../../src/core/languages/kotlinCyclomatic.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,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,eAAe,CAAC;QACrB,KAAK,eAAe,CAAC;QACrB,KAAK,iBAAiB,CAAC;QACvB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,gBAAgB,CAAC;QACtB,KAAK,aAAa,CAAC;QACnB,KAAK,wBAAwB,CAAC;QAC9B,KAAK,wBAAwB;YAC3B,OAAO,IAAI,CAAC;QACd,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,uEAAuE;YACvE,mEAAmE;YACnE,iEAAiE;YACjE,oEAAoE;YACpE,MAAM,YAAY,GAAG,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;YAC9E,OAAO,YAAY,CAAC;QACtB,CAAC;QACD;YACE,OAAO,KAAK,CAAC;IACjB,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/kotlinExports.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 extractKotlinExports(root: TsNode): AstExport[];
+export {};

package/dist/core/languages/kotlinExports.js

@@ -0,0 +1,103 @@
+/**
+ * Extract Kotlin top-level declarations as exports. Kotlin's default
+ * visibility is `public`; only declarations marked `private` or `internal`
+ * are excluded. `protected` only applies to class members and is treated
+ * as exported when on a top-level decl (which is unusual but valid in
+ * tree-sitter's grammar).
+ *
+ * Kinds:
+ *   fun foo()                  → function
+ *   class Foo                  → class
+ *   interface Foo              → interface
+ *   object Foo                 → class    (Kotlin singleton object, modeled as class)
+ *   enum class Color           → enum
+ *   typealias Bar = ...        → type
+ *   val/const x                → variable
+ */
+const EXPORT_NODE_TO_KIND = {
+    function_declaration: 'function',
+    class_declaration: 'class',
+    object_declaration: 'class',
+    type_alias: 'type',
+    property_declaration: 'variable',
+};
+export function extractKotlinExports(root) {
+    const exports = [];
+    // Top-level only: descend into the source_file/file_node body but not into
+    // nested classes (their members aren't top-level exports for graph purposes).
+    for (const child of root.namedChildren) {
+        visitTopLevel(child, exports);
+    }
+    return exports;
+}
+function visitTopLevel(node, out) {
+    // Some grammars wrap top-level decls in `package_header` / `import_list` /
+    // an explicit `top_level_object` node. We descend through wrappers.
+    if (node.type === 'package_header' ||
+        node.type === 'import_list' ||
+        node.type === 'file_annotation') {
+        return;
+    }
+    if (node.type === 'class_declaration') {
+        const isInterface = /\binterface\b/.test(headerText(node));
+        const isEnum = /\benum\s+class\b/.test(headerText(node));
+        const kind = isEnum ? 'enum' : isInterface ? 'interface' : 'class';
+        if (!isPrivate(node)) {
+            const name = nameOf(node);
+            if (name)
+                out.push({ name, kind, typeOnly: false, line: node.startPosition.row + 1 });
+        }
+        return;
+    }
+    const kind = EXPORT_NODE_TO_KIND[node.type];
+    if (!kind) {
+        // Walk container nodes (e.g., source_file already iterated, but defensively descend).
+        for (const c of node.namedChildren)
+            visitTopLevel(c, out);
+        return;
+    }
+    if (isPrivate(node))
+        return;
+    const name = nameOf(node);
+    if (!name)
+        return;
+    out.push({ name, kind, typeOnly: false, line: node.startPosition.row + 1 });
+}
+function headerText(node) {
+    // Just the first line — the `class`/`interface`/`enum class` keyword
+    // appears in the header before the body opens.
+    const idx = node.text.indexOf('{');
+    return idx >= 0 ? node.text.slice(0, idx) : node.text;
+}
+function isPrivate(node) {
+    for (const c of node.namedChildren) {
+        if (c.type === 'modifiers' || c.type === 'modifier_list') {
+            for (const m of c.namedChildren) {
+                if (m.type === 'visibility_modifier') {
+                    const t = m.text.trim();
+                    if (t === 'private' || t === 'internal')
+                        return true;
+                }
+            }
+        }
+    }
+    return false;
+}
+function nameOf(node) {
+    if (node.childForFieldName) {
+        const id = node.childForFieldName('name');
+        if (id && id.text)
+            return id.text;
+    }
+    for (const c of node.namedChildren) {
+        if (c.type === 'simple_identifier' || c.type === 'identifier' || c.type === 'type_identifier') {
+            return c.text;
+        }
+    }
+    // property_declaration: `val/var <name> = ...`
+    const m = /\b(val|var|const\s+val)\s+([A-Za-z_][A-Za-z0-9_]*)/.exec(node.text);
+    if (m)
+        return m[2];
+    return null;
+}
+//# sourceMappingURL=kotlinExports.js.map

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

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

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

@@ -0,0 +1,27 @@
+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 Kotlin. Walks `function_declaration` nodes
+ * (top-level functions and class methods). Methods inside `class Foo { fun m() }`
+ * are named `Foo.m`; top-level functions stay bare. Anonymous functions and
+ * lambdas are not extracted as separate entries; their decision points fold
+ * into the enclosing function (analogous to JS arrow/closure handling
+ * elsewhere in projscan).
+ *
+ * `when` expressions count one branch per non-else arm.
+ */
+export declare function extractKotlinFunctions(root: TsNode): FunctionInfo[];
+export {};