projscan 0.9.2 → 0.10.0

package/dist/core/languages/javascriptAdapter.js

@@ -0,0 +1,68 @@
+import path from 'node:path';
+import { parseSource } from '../ast.js';
+const JS_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.mts', '.cts',
+]);
+const RESOLUTION_EXTS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.mts', '.cts'];
+const NODE_BUILTINS = new Set([
+    'assert', 'async_hooks', 'buffer', 'child_process', 'cluster', 'console', 'constants', 'crypto',
+    'dgram', 'dns', 'domain', 'events', 'fs', 'fs/promises', 'http', 'http2', 'https', 'inspector',
+    'module', 'net', 'os', 'path', 'perf_hooks', 'process', 'punycode', 'querystring', 'readline',
+    'repl', 'stream', 'string_decoder', 'sys', 'timers', 'tls', 'trace_events', 'tty', 'url', 'util',
+    'v8', 'vm', 'wasi', 'worker_threads', 'zlib',
+]);
+export const javascriptAdapter = {
+    id: 'javascript',
+    extensions: JS_EXTENSIONS,
+    sourceExtensions: JS_EXTENSIONS,
+    barrelBasenames: new Set(['index']),
+    parse(filePath, content) {
+        return parseSource(filePath, content);
+    },
+    resolveImport(importingFile, source, graphFiles) {
+        if (!(source.startsWith('.') || source.startsWith('/')))
+            return null;
+        const importingDir = path.posix.dirname(importingFile);
+        const base = path.posix.normalize(path.posix.join(importingDir, source));
+        if (graphFiles.has(base))
+            return base;
+        for (const ext of RESOLUTION_EXTS) {
+            if (graphFiles.has(base + ext))
+                return base + ext;
+        }
+        for (const ext of RESOLUTION_EXTS) {
+            const barrel = `${base}/index${ext}`;
+            if (graphFiles.has(barrel))
+                return barrel;
+        }
+        if (base.endsWith('.js')) {
+            const trimmed = base.slice(0, -3);
+            if (graphFiles.has(`${trimmed}.ts`))
+                return `${trimmed}.ts`;
+            if (graphFiles.has(`${trimmed}.tsx`))
+                return `${trimmed}.tsx`;
+        }
+        return null;
+    },
+    toPackageName(specifier) {
+        if (!specifier)
+            return null;
+        if (specifier.startsWith('.') || specifier.startsWith('/'))
+            return null;
+        if (specifier.startsWith('node:'))
+            return null;
+        if (NODE_BUILTINS.has(specifier))
+            return null;
+        if (specifier.startsWith('@')) {
+            const segments = specifier.split('/');
+            if (segments.length < 2)
+                return null;
+            return `${segments[0]}/${segments[1]}`;
+        }
+        return specifier.split('/')[0];
+    },
+    preparePackageRoots(_rootPath, _files) {
+        return {};
+    },
+};
+//# sourceMappingURL=javascriptAdapter.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { LanguageAdapter } from './LanguageAdapter.js';
+/**
+ * Python adapter skeleton. This bring-up stage only proves the parser loads
+ * and produces a tree. Imports/exports extraction follows in subsequent tasks.
+ */
+export declare const pythonAdapter: LanguageAdapter;

package/dist/core/languages/pythonAdapter.js

@@ -0,0 +1,142 @@
+import path from 'node:path';
+import { createParserFor } from './treeSitterLoader.js';
+import { extractPythonImports } from './pythonImports.js';
+import { extractPythonExports } from './pythonExports.js';
+import { detectPythonProject } from './pythonManifests.js';
+// Pinned grammar: tree-sitter-python 0.25.0. See treeSitterLoader.ts.
+const PY_EXTENSIONS = new Set(['.py', '.pyw', '.pyi']);
+const MAX_PY_FILE = 1024 * 1024;
+let parserPromise = null;
+async function getParser() {
+    if (!parserPromise)
+        parserPromise = createParserFor('tree-sitter-python.wasm');
+    return parserPromise;
+}
+/**
+ * Python adapter skeleton. This bring-up stage only proves the parser loads
+ * and produces a tree. Imports/exports extraction follows in subsequent tasks.
+ */
+export const pythonAdapter = {
+    id: 'python',
+    extensions: PY_EXTENSIONS,
+    sourceExtensions: new Set(['.py', '.pyw']),
+    barrelBasenames: new Set(['__init__']),
+    maxFileSize: MAX_PY_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,
+                };
+            }
+            const imports = extractPythonImports(tree.rootNode);
+            const exports = extractPythonExports(tree.rootNode);
+            return {
+                ok: true,
+                imports,
+                exports,
+                callSites: [],
+                lineCount: content ? content.split('\n').length : 0,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                ok: false,
+                reason: `python parse failure: ${msg.slice(0, 120)}`,
+                imports: [],
+                exports: [],
+                callSites: [],
+                lineCount: content ? content.split('\n').length : 0,
+            };
+        }
+    },
+    resolveImport(importingFile, source, graphFiles, context) {
+        return resolvePythonImport(importingFile, source, graphFiles, context);
+    },
+    toPackageName(source) {
+        if (!source)
+            return null;
+        if (source.startsWith('.'))
+            return null;
+        // Package name is the first dotted segment, normalized for comparison.
+        return source.split('.')[0].toLowerCase();
+    },
+    async preparePackageRoots(rootPath, files) {
+        const info = await detectPythonProject(rootPath, files);
+        return {
+            packageRoots: info?.packageRoots ?? [],
+            meta: info ? { pythonProject: info } : undefined,
+        };
+    },
+};
+/**
+ * Resolve a Python import to a repo-local file path, or null if it refers to
+ * a third-party package or otherwise cannot be resolved.
+ *
+ * Algorithm summary:
+ *   1. Absolute (`from pkg.mod.sub import x`): for each packageRoot, probe
+ *      `<root>/pkg/mod/sub.py` then `<root>/pkg/mod/sub/__init__.py`.
+ *   2. Relative (`from . import x` / `from .sibling import y`): count leading
+ *      dots, walk that many parents from the importing file's directory,
+ *      then append the remaining segments.
+ *   3. If nothing matches, return null (caller classifies as third-party).
+ */
+function resolvePythonImport(importingFile, source, graphFiles, context) {
+    const packageRoots = context.packageRoots ?? ['.'];
+    if (source.startsWith('.')) {
+        const m = /^(\.+)(.*)$/.exec(source);
+        if (!m)
+            return null;
+        const dotCount = m[1].length;
+        const remainder = m[2]; // may start with a `.` separator? No - the `.`s are already captured.
+        const importingDir = path.posix.dirname(importingFile);
+        // dotCount === 1 means "current package"; 2 means "one level up".
+        let dir = importingDir;
+        for (let i = 0; i < dotCount - 1; i++) {
+            dir = path.posix.dirname(dir);
+            if (dir === '.' || dir === '' || dir === '/') {
+                dir = '';
+                break;
+            }
+        }
+        const segments = remainder ? remainder.split('.').filter(Boolean) : [];
+        const base = segments.length > 0 ? [dir, ...segments].filter(Boolean).join('/') : dir;
+        return probeModuleOrPackage(base, graphFiles);
+    }
+    // Absolute import.
+    const segments = source.split('.').filter(Boolean);
+    if (segments.length === 0)
+        return null;
+    for (const root of packageRoots) {
+        const rootSegs = root === '.' || root === '' ? [] : root.split('/').filter(Boolean);
+        const base = [...rootSegs, ...segments].join('/');
+        const hit = probeModuleOrPackage(base, graphFiles);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+function probeModuleOrPackage(base, graphFiles) {
+    if (!base)
+        return null;
+    // Try `base.py` first (more specific), then `base/__init__.py`.
+    const asModule = `${base}.py`;
+    if (graphFiles.has(asModule))
+        return asModule;
+    const asInit = `${base}/__init__.py`;
+    if (graphFiles.has(asInit))
+        return asInit;
+    const asPyw = `${base}.pyw`;
+    if (graphFiles.has(asPyw))
+        return asPyw;
+    return null;
+}
+//# sourceMappingURL=pythonAdapter.js.map

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

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

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

@@ -0,0 +1,28 @@
+import type { AstExport } from '../ast.js';
+interface TsNode {
+    type: string;
+    text: string;
+    startPosition: {
+        row: number;
+    };
+    namedChildren: TsNode[];
+    firstNamedChild?: TsNode | null;
+    childForFieldName?(name: string): TsNode | null;
+}
+/**
+ * Extract "exports" from a tree-sitter-python AST.
+ *
+ * Python has no language-level export concept. projscan defines exports as
+ * the top-level public API of a module:
+ *   - top-level `def` / `async def` / `class`
+ *   - top-level assignments whose LHS is a plain identifier
+ *   - names brought in via `from .mod import foo` (re-exports)
+ *
+ * Filtered: single-underscore-prefixed names (`_private`), dunder names other
+ * than ones that appear in `__all__`. If `__all__` is declared at the top
+ * level as a list/tuple of string literals, it is authoritative: only names
+ * in `__all__` are exports (regardless of underscore), and names not in
+ * `__all__` are NOT exports.
+ */
+export declare function extractPythonExports(root: TsNode): AstExport[];
+export {};

package/dist/core/languages/pythonExports.js

@@ -0,0 +1,169 @@
+/**
+ * Extract "exports" from a tree-sitter-python AST.
+ *
+ * Python has no language-level export concept. projscan defines exports as
+ * the top-level public API of a module:
+ *   - top-level `def` / `async def` / `class`
+ *   - top-level assignments whose LHS is a plain identifier
+ *   - names brought in via `from .mod import foo` (re-exports)
+ *
+ * Filtered: single-underscore-prefixed names (`_private`), dunder names other
+ * than ones that appear in `__all__`. If `__all__` is declared at the top
+ * level as a list/tuple of string literals, it is authoritative: only names
+ * in `__all__` are exports (regardless of underscore), and names not in
+ * `__all__` are NOT exports.
+ */
+export function extractPythonExports(root) {
+    const allNames = readDunderAll(root);
+    const found = [];
+    for (const child of root.namedChildren) {
+        switch (child.type) {
+            case 'function_definition': {
+                const nameNode = nameOfFunctionOrClass(child);
+                if (nameNode) {
+                    found.push({
+                        name: nameNode.text,
+                        kind: 'function',
+                        typeOnly: false,
+                        line: child.startPosition.row + 1,
+                    });
+                }
+                break;
+            }
+            case 'class_definition': {
+                const nameNode = nameOfFunctionOrClass(child);
+                if (nameNode) {
+                    found.push({
+                        name: nameNode.text,
+                        kind: 'class',
+                        typeOnly: false,
+                        line: child.startPosition.row + 1,
+                    });
+                }
+                break;
+            }
+            case 'decorated_definition': {
+                // `@decorator\ndef foo(): ...` → the real def/class is a child.
+                const inner = child.namedChildren.find((c) => c.type === 'function_definition' || c.type === 'class_definition');
+                if (inner) {
+                    const nameNode = nameOfFunctionOrClass(inner);
+                    if (nameNode) {
+                        found.push({
+                            name: nameNode.text,
+                            kind: inner.type === 'class_definition' ? 'class' : 'function',
+                            typeOnly: false,
+                            line: child.startPosition.row + 1,
+                        });
+                    }
+                }
+                break;
+            }
+            case 'expression_statement': {
+                collectAssignmentTargets(child, found);
+                break;
+            }
+            case 'import_from_statement': {
+                // Re-exports: `from .mod import foo` makes `foo` accessible as a
+                // module-level name. Honor `__all__` gatekeeping below.
+                collectFromImportRebindings(child, found);
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    if (allNames) {
+        const set = new Set(allNames);
+        return found.filter((e) => set.has(e.name));
+    }
+    return found.filter((e) => !e.name.startsWith('_'));
+}
+function nameOfFunctionOrClass(node) {
+    const named = node.childForFieldName?.('name');
+    if (named)
+        return named;
+    // Fallback: first named identifier child.
+    return node.namedChildren.find((c) => c.type === 'identifier') ?? null;
+}
+function collectAssignmentTargets(exprStmt, out) {
+    const assignment = exprStmt.namedChildren.find((c) => c.type === 'assignment');
+    if (!assignment)
+        return;
+    const line = exprStmt.startPosition.row + 1;
+    const lhs = assignment.namedChildren[0];
+    if (!lhs)
+        return;
+    if (lhs.type === 'identifier') {
+        out.push({ name: lhs.text, kind: 'variable', typeOnly: false, line });
+    }
+    else if (lhs.type === 'pattern_list' || lhs.type === 'tuple_pattern') {
+        for (const part of lhs.namedChildren) {
+            if (part.type === 'identifier') {
+                out.push({ name: part.text, kind: 'variable', typeOnly: false, line });
+            }
+        }
+    }
+}
+function collectFromImportRebindings(node, out) {
+    const line = node.startPosition.row + 1;
+    const children = node.namedChildren;
+    if (children.length < 2)
+        return;
+    for (let i = 1; i < children.length; i++) {
+        const c = children[i];
+        if (c.type === 'dotted_name') {
+            out.push({ name: c.text.split('.').pop(), kind: 'unknown', typeOnly: false, line });
+        }
+        else if (c.type === 'aliased_import') {
+            const alias = c.namedChildren.find((g) => g.type === 'identifier');
+            if (alias)
+                out.push({ name: alias.text, kind: 'unknown', typeOnly: false, line });
+        }
+        // wildcard_import: `from x import *` does not produce known names.
+    }
+}
+/**
+ * Read `__all__ = [...]` or `__all__ = (...)` if declared at the top level.
+ * Returns the list of string-literal entries, or null if __all__ is absent
+ * or declared with a non-literal value (e.g. `__all__ = compute()`).
+ */
+function readDunderAll(root) {
+    for (const child of root.namedChildren) {
+        if (child.type !== 'expression_statement')
+            continue;
+        const assignment = child.namedChildren.find((c) => c.type === 'assignment');
+        if (!assignment)
+            continue;
+        const lhs = assignment.namedChildren[0];
+        if (!lhs || lhs.type !== 'identifier' || lhs.text !== '__all__')
+            continue;
+        const rhs = assignment.namedChildren[assignment.namedChildren.length - 1];
+        if (!rhs)
+            continue;
+        if (rhs.type !== 'list' && rhs.type !== 'tuple')
+            return null;
+        const names = [];
+        for (const item of rhs.namedChildren) {
+            if (item.type === 'string') {
+                const unwrapped = unwrapStringLiteral(item);
+                if (unwrapped !== null)
+                    names.push(unwrapped);
+            }
+        }
+        return names;
+    }
+    return null;
+}
+function unwrapStringLiteral(node) {
+    // `"foo"` → "foo". tree-sitter-python represents this as a `string` node
+    // whose content is `string_content` text; for our needs, trimming quotes is
+    // good enough - supports 'foo', "foo", '''foo''', """foo""" consistently.
+    const raw = node.text;
+    const m = /^[uUbBrRfF]?(["'])(?:\1\1)?((?:\\.|(?!\1\1\1|\1).)*?)(?:\1\1)?\1$/s.exec(raw);
+    if (m)
+        return m[2];
+    // Fallback: strip leading/trailing quote characters generically.
+    const stripped = raw.replace(/^[uUbBrRfF]?['"]+/, '').replace(/['"]+$/, '');
+    return stripped || null;
+}
+//# sourceMappingURL=pythonExports.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type { AstImport } from '../ast.js';
+/** Minimal tree-sitter node surface we depend on. */
+interface TsNode {
+    type: string;
+    text: string;
+    startPosition: {
+        row: number;
+    };
+    namedChildren: TsNode[];
+    firstNamedChild?: TsNode | null;
+    childForFieldName?(name: string): TsNode | null;
+}
+/**
+ * Extract import edges from a tree-sitter-python AST.
+ *
+ * Traversal: walk top-level statements in the `module` node, and descend into
+ * `try_statement` bodies so that conditional imports (e.g. `try: import x
+ * except ImportError: import y as x`) are captured. Function/class-scoped
+ * imports are intentionally ignored - they match JS/TS module-level semantics.
+ */
+export declare function extractPythonImports(root: TsNode): AstImport[];
+export {};

package/dist/core/languages/pythonImports.js

@@ -0,0 +1,104 @@
+/**
+ * Extract import edges from a tree-sitter-python AST.
+ *
+ * Traversal: walk top-level statements in the `module` node, and descend into
+ * `try_statement` bodies so that conditional imports (e.g. `try: import x
+ * except ImportError: import y as x`) are captured. Function/class-scoped
+ * imports are intentionally ignored - they match JS/TS module-level semantics.
+ */
+export function extractPythonImports(root) {
+    const imports = [];
+    visit(root, imports);
+    return imports;
+}
+// Types we descend through to find conditional top-level imports. Does NOT
+// include function/class bodies - imports scoped inside a function are local
+// variables, not module-level dependencies (mirrors JS/TS semantics).
+const DESCEND_TYPES = new Set([
+    'try_statement',
+    'if_statement',
+    'elif_clause',
+    'else_clause',
+    'except_clause',
+    'finally_clause',
+    'with_statement',
+    'with_clause',
+    'block',
+]);
+function visit(node, out) {
+    for (const child of node.namedChildren) {
+        switch (child.type) {
+            case 'import_statement':
+                handleImport(child, out);
+                break;
+            case 'import_from_statement':
+                handleImportFrom(child, out);
+                break;
+            case 'future_import_statement':
+                // Language pragma, not a real dependency.
+                break;
+            default:
+                if (DESCEND_TYPES.has(child.type))
+                    visit(child, out);
+                break;
+        }
+    }
+}
+function handleImport(node, out) {
+    // `import a` | `import a.b.c` | `import a as b` | `import a, b`
+    const line = node.startPosition.row + 1;
+    for (const child of node.namedChildren) {
+        if (child.type === 'dotted_name') {
+            out.push({ source: child.text, kind: 'static', specifiers: [], typeOnly: false, line });
+        }
+        else if (child.type === 'aliased_import') {
+            const inner = child.namedChildren.find((c) => c.type === 'dotted_name');
+            if (inner) {
+                out.push({ source: inner.text, kind: 'static', specifiers: [], typeOnly: false, line });
+            }
+        }
+    }
+}
+function handleImportFrom(node, out) {
+    const line = node.startPosition.row + 1;
+    const children = node.namedChildren;
+    if (children.length === 0)
+        return;
+    // First child is either dotted_name (absolute) or relative_import.
+    const head = children[0];
+    let source;
+    if (head.type === 'relative_import') {
+        source = head.text.trim();
+    }
+    else if (head.type === 'dotted_name') {
+        source = head.text;
+    }
+    else {
+        return;
+    }
+    const specifiers = [];
+    let sawWildcard = false;
+    for (let i = 1; i < children.length; i++) {
+        const c = children[i];
+        if (c.type === 'wildcard_import') {
+            sawWildcard = true;
+            break;
+        }
+        if (c.type === 'dotted_name') {
+            specifiers.push(c.text);
+        }
+        else if (c.type === 'aliased_import') {
+            const original = c.namedChildren.find((g) => g.type === 'dotted_name');
+            if (original)
+                specifiers.push(original.text);
+        }
+    }
+    out.push({
+        source,
+        kind: 'static',
+        specifiers: sawWildcard ? ['*'] : specifiers,
+        typeOnly: false,
+        line,
+    });
+}
+//# sourceMappingURL=pythonImports.js.map

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

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

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

@@ -0,0 +1,34 @@
+import type { FileEntry } from '../../types.js';
+/**
+ * Lightweight parsing of Python project manifests. We do NOT pull a TOML
+ * parser - regex-based extraction is good enough for the 80% case where
+ * projects use standard layouts. More sophisticated parsing is deferred.
+ */
+export interface PythonDeclaredDep {
+    name: string;
+    /** Raw version spec from the manifest (may be empty if unpinned). */
+    versionSpec: string;
+    /** Which file declared this dep. */
+    source: string;
+    /** 1-based line in the source file, or 0 if unknown. */
+    line: number;
+    /** main (runtime) vs dev (test/lint groups). */
+    scope: 'main' | 'dev';
+}
+export interface PythonProjectInfo {
+    /** Directories under which `from pkg import ...` should resolve. */
+    packageRoots: string[];
+    /** pyproject.toml / setup.py / setup.cfg path (relative to repo root), if any. */
+    manifestFiles: string[];
+    /** Declared dependencies across all manifests. */
+    declared: PythonDeclaredDep[];
+    /** Lockfiles present (any of poetry.lock, Pipfile.lock, pdm.lock, uv.lock, conda-lock.yml, requirements.txt with pins). */
+    hasLockfile: boolean;
+}
+export declare function detectPythonProject(rootPath: string, files: FileEntry[]): Promise<PythonProjectInfo | null>;
+export declare function parsePyproject(content: string): PythonDeclaredDep[];
+export declare function parseRequirements(content: string, sourceFile: string, scope: 'main' | 'dev'): PythonDeclaredDep[];
+export declare function splitPep508(spec: string): {
+    name: string;
+    versionSpec: string;
+};