codesift-mcp 0.3.0 → 0.4.0

package/dist/utils/nextjs.d.ts

@@ -0,0 +1,42 @@
+/** Maximum bytes to read when scanning for a directive. */
+export declare const DIRECTIVE_WINDOW = 512;
+/**
+ * Scan a file's first 512 bytes for a `"use client"` or `"use server"` directive.
+ * Returns the directive string or `null` if not found.
+ */
+export declare function scanDirective(filePath: string): Promise<"use client" | "use server" | null>;
+/**
+ * Derive a URL path from a file path relative to the repo root.
+ * Handles App Router route groups, dynamic segments, and Pages Router conventions.
+ */
+export declare function deriveUrlPath(filePath: string, router: "app" | "pages"): string;
+/**
+ * Discover Next.js workspaces in a monorepo by finding `next.config.*` files.
+ * Returns empty array for single-app projects (config at root only) or no config.
+ */
+export declare function discoverWorkspaces(repoRoot: string): Promise<{
+    root: string;
+    configFile: string;
+}[]>;
+/**
+ * Walk up from `filePath` through ancestor directories collecting layout files.
+ * Returns relative paths from root to leaf order. Stops at the `app/` boundary.
+ * If `filePath` is itself a layout, it is excluded from the chain.
+ */
+export declare function computeLayoutChain(filePath: string, repoRoot: string): Promise<string[]>;
+export interface MiddlewareTraceResult {
+    file: string;
+    matchers: string[];
+    applies: boolean;
+}
+/**
+ * Find and analyze middleware.ts for the given repo root.
+ * Returns null if no middleware file exists.
+ * Uses tree-sitter AST to extract matcher config.
+ */
+export declare function traceMiddleware(repoRoot: string, urlPath: string): Promise<MiddlewareTraceResult | null>;
+export { parseMetadataExport, extractFetchCalls } from "./nextjs-metadata-readers.js";
+export type { MetadataFields, FetchCall, FetchCallee } from "./nextjs-metadata-readers.js";
+export { extractZodSchema, extractLinkHrefs } from "./nextjs-ast-readers.js";
+export type { ZodShape, ZodFieldType, LinkRef, LinkRefKind } from "./nextjs-ast-readers.js";
+//# sourceMappingURL=nextjs.d.ts.map

package/dist/utils/nextjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.d.ts","sourceRoot":"","sources":["../../src/utils/nextjs.ts"],"names":[],"mappings":"AAKA,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAmCpC;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,YAAY,GAAG,IAAI,CAAC,CAU7C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CA0B/E;AAKD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAgCjD;AAID;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCnB;AA2BD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAsFvC;AAGD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtF,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/utils/nextjs.js

@@ -0,0 +1,284 @@
+import { readFile, readdir, access } from "node:fs/promises";
+import { join, dirname, relative, basename } from "node:path";
+import picomatch from "picomatch";
+import { parseFile } from "../parser/parser-manager.js";
+/** Maximum bytes to read when scanning for a directive. */
+export const DIRECTIVE_WINDOW = 512;
+/**
+ * Strip BOM, shebangs, single-line comments, and block comments
+ * from the beginning of source text.
+ */
+function stripBomAndComments(text) {
+    let s = text;
+    // Strip BOM
+    if (s.charCodeAt(0) === 0xfeff)
+        s = s.slice(1);
+    // Strip shebang
+    if (s.startsWith("#!")) {
+        const nl = s.indexOf("\n");
+        s = nl >= 0 ? s.slice(nl + 1) : "";
+    }
+    // Iteratively strip leading comments
+    let changed = true;
+    while (changed) {
+        changed = false;
+        s = s.trimStart();
+        if (s.startsWith("//")) {
+            const nl = s.indexOf("\n");
+            s = nl >= 0 ? s.slice(nl + 1) : "";
+            changed = true;
+        }
+        else if (s.startsWith("/*")) {
+            const end = s.indexOf("*/");
+            if (end >= 0) {
+                s = s.slice(end + 2);
+                changed = true;
+            }
+        }
+    }
+    return s;
+}
+/**
+ * Scan a file's first 512 bytes for a `"use client"` or `"use server"` directive.
+ * Returns the directive string or `null` if not found.
+ */
+export async function scanDirective(filePath) {
+    try {
+        const buf = await readFile(filePath, { encoding: "utf8", flag: "r" });
+        const head = buf.slice(0, DIRECTIVE_WINDOW);
+        const stripped = stripBomAndComments(head);
+        const match = stripped.match(/^\s*["'`](use (?:client|server))["'`]\s*;?/);
+        return match ? match[1] : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Derive a URL path from a file path relative to the repo root.
+ * Handles App Router route groups, dynamic segments, and Pages Router conventions.
+ */
+export function deriveUrlPath(filePath, router) {
+    let p = filePath;
+    // Strip leading src/ if present
+    if (p.startsWith("src/"))
+        p = p.slice(4);
+    if (router === "app") {
+        // Strip app/ prefix
+        p = p.replace(/^app\//, "");
+        // Strip convention file at end (page.tsx, layout.tsx, route.ts, etc.)
+        p = p.replace(/\/?(page|layout|route|loading|error|not-found|global-error|default|template)\.[jt]sx?$/, "");
+        // Strip route groups like (auth)
+        p = p.replace(/\([^)]+\)\/?/g, "");
+        // Clean up trailing slash
+        p = p.replace(/\/+$/, "");
+    }
+    else {
+        // Pages Router: strip pages/ prefix and file extension
+        p = p.replace(/^pages\//, "");
+        p = p.replace(/\.[jt]sx?$/, "");
+        // Strip index at end
+        if (p === "index" || p.endsWith("/index")) {
+            p = p.replace(/\/?index$/, "");
+        }
+    }
+    return p ? `/${p}` : "/";
+}
+const NEXT_CONFIG_RE = /^next\.config\.(js|mjs|cjs|ts)$/;
+const SKIP_DIRS = new Set(["node_modules", ".git", "dist", ".next", "build"]);
+/**
+ * Discover Next.js workspaces in a monorepo by finding `next.config.*` files.
+ * Returns empty array for single-app projects (config at root only) or no config.
+ */
+export async function discoverWorkspaces(repoRoot) {
+    const results = [];
+    async function scan(dir, depth) {
+        if (depth > 3)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (SKIP_DIRS.has(entry.name) || entry.name.startsWith("."))
+                    continue;
+                await scan(join(dir, entry.name), depth + 1);
+            }
+            else if (entry.isFile() && NEXT_CONFIG_RE.test(entry.name)) {
+                results.push({
+                    root: dir,
+                    configFile: join(dir, entry.name),
+                });
+            }
+        }
+    }
+    await scan(repoRoot, 0);
+    // Single config at root = not a monorepo
+    if (results.length === 1 && results[0].root === repoRoot) {
+        return [];
+    }
+    return results;
+}
+const LAYOUT_EXTENSIONS = ["tsx", "jsx", "ts", "js"];
+/**
+ * Walk up from `filePath` through ancestor directories collecting layout files.
+ * Returns relative paths from root to leaf order. Stops at the `app/` boundary.
+ * If `filePath` is itself a layout, it is excluded from the chain.
+ */
+export async function computeLayoutChain(filePath, repoRoot) {
+    const chain = [];
+    const rel = filePath.startsWith("/") ? relative(repoRoot, filePath) : filePath;
+    const segments = rel.split("/");
+    // Find the app/ boundary index
+    const appIdx = segments.indexOf("app");
+    if (appIdx < 0)
+        return [];
+    // Walk from app/ directory down to the parent of the target file
+    // Skip the file's own directory if the file itself is a layout
+    const targetBasename = basename(rel);
+    const isLayout = /^layout\.[jt]sx?$/.test(targetBasename);
+    const targetDir = dirname(rel);
+    // Build paths from app/ to target's parent directory
+    for (let i = appIdx; i < segments.length - 1; i++) {
+        const dirPath = segments.slice(0, i + 1).join("/");
+        // If the target is a layout, skip its own directory
+        if (isLayout && dirPath === targetDir)
+            continue;
+        for (const ext of LAYOUT_EXTENSIONS) {
+            const layoutPath = join(dirPath, `layout.${ext}`);
+            const absPath = join(repoRoot, layoutPath);
+            try {
+                await access(absPath);
+                chain.push(layoutPath);
+                break; // Found a layout in this directory, move to next
+            }
+            catch {
+                // No layout with this extension
+            }
+        }
+    }
+    return chain;
+}
+/** Candidate middleware file paths relative to repo root. */
+const MIDDLEWARE_CANDIDATES = [
+    "middleware.ts", "middleware.js",
+    "src/middleware.ts", "src/middleware.js",
+];
+/**
+ * Convert a Next.js matcher pattern to a picomatch-compatible glob.
+ * Next.js uses `:path*` syntax; picomatch uses `**`.
+ */
+function matcherToGlob(pattern) {
+    return pattern.replace(/:[\w]+\*/g, "**").replace(/:[\w]+/g, "*");
+}
+/**
+ * Check if a URL path matches any of the provided Next.js matcher patterns.
+ */
+function matchesMatcher(patterns, urlPath) {
+    if (patterns.length === 0)
+        return true; // No matcher = match all
+    return patterns.some((p) => {
+        const glob = matcherToGlob(p);
+        return picomatch.isMatch(urlPath, glob);
+    });
+}
+/**
+ * Find and analyze middleware.ts for the given repo root.
+ * Returns null if no middleware file exists.
+ * Uses tree-sitter AST to extract matcher config.
+ */
+export async function traceMiddleware(repoRoot, urlPath) {
+    // Find middleware file
+    let mwFile = null;
+    let mwRelPath = null;
+    for (const candidate of MIDDLEWARE_CANDIDATES) {
+        const absPath = join(repoRoot, candidate);
+        try {
+            await access(absPath);
+            mwFile = absPath;
+            mwRelPath = candidate;
+            break;
+        }
+        catch {
+            // Not found
+        }
+    }
+    if (!mwFile || !mwRelPath)
+        return null;
+    // Parse the middleware file with tree-sitter
+    let source;
+    try {
+        source = await readFile(mwFile, "utf8");
+    }
+    catch {
+        return { file: mwRelPath, matchers: [], applies: true };
+    }
+    const tree = await parseFile(mwFile, source);
+    if (!tree) {
+        return { file: mwRelPath, matchers: [], applies: true };
+    }
+    // Find `export const config = { matcher: ... }`
+    const exportStatements = tree.rootNode.descendantsOfType("export_statement");
+    let matchers = [];
+    let foundConfig = false;
+    for (const exportNode of exportStatements) {
+        const decl = exportNode.descendantsOfType("variable_declarator");
+        for (const d of decl) {
+            const nameNode = d.childForFieldName("name");
+            if (nameNode?.text !== "config")
+                continue;
+            foundConfig = true;
+            const init = d.childForFieldName("value");
+            if (!init)
+                continue;
+            // Find the `matcher` property inside the object
+            const pairs = init.descendantsOfType("pair");
+            for (const pair of pairs) {
+                const key = pair.childForFieldName("key");
+                if (key?.text !== "matcher")
+                    continue;
+                const value = pair.childForFieldName("value");
+                if (!value)
+                    continue;
+                if (value.type === "string") {
+                    // Single string matcher
+                    const text = value.text.slice(1, -1); // Remove quotes
+                    matchers = [text];
+                }
+                else if (value.type === "array") {
+                    // Array of matchers
+                    const elements = value.namedChildren;
+                    for (const el of elements) {
+                        if (el.type === "string") {
+                            matchers.push(el.text.slice(1, -1));
+                        }
+                        else {
+                            // Non-literal element — fail-open
+                            matchers = ["<computed>"];
+                            return { file: mwRelPath, matchers, applies: true };
+                        }
+                    }
+                }
+                else {
+                    // Computed matcher (identifier, call expression, etc.)
+                    matchers = ["<computed>"];
+                    return { file: mwRelPath, matchers, applies: true };
+                }
+            }
+        }
+    }
+    if (!foundConfig) {
+        // No config export → match all routes (Next.js default)
+        return { file: mwRelPath, matchers: [], applies: true };
+    }
+    const applies = matchesMatcher(matchers, urlPath);
+    return { file: mwRelPath, matchers, applies };
+}
+// Re-export AST readers for backward compatibility
+export { parseMetadataExport, extractFetchCalls } from "./nextjs-metadata-readers.js";
+export { extractZodSchema, extractLinkHrefs } from "./nextjs-ast-readers.js";
+//# sourceMappingURL=nextjs.js.map

package/dist/utils/nextjs.js.map

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

package/dist/utils/python-import-resolver.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Python import resolution — pure functions, no I/O.
+ *
+ * Handles:
+ *   - Relative imports (`from . import X`, `from ..pkg import Y`) via dot
+ *     counting and package-root walking
+ *   - Absolute imports (`import X`, `from X.Y import Z`) via index lookup
+ *     with automatic `src/` layout detection
+ *   - `.py` and `__init__.py` resolution
+ */
+/**
+ * Walk upward from a file to find the innermost package root.
+ * A "package" is a directory containing `__init__.py`. The package root is
+ * the innermost ancestor directory (including the file's own directory) that
+ * contains `__init__.py`.
+ *
+ * If no ancestor has `__init__.py`, returns the file's directory.
+ * If the file is at repo root, returns "".
+ */
+export declare function findPackageRoot(filePath: string, indexedFiles: Set<string>): string;
+/**
+ * Detect if the project uses a `src/` layout (e.g., `src/myapp/__init__.py`).
+ * Returns the layout root name (`"src"`) or `null` if no src layout detected.
+ */
+export declare function detectSrcLayout(indexedFiles: string[]): string | null;
+/**
+ * Resolve a Python import to a file path in the indexed tree.
+ *
+ * Algorithm:
+ *   - If `level > 0` (relative import): walk up `level - 1` dirs from the
+ *     importing file's package root, then resolve the remaining dotted path
+ *   - If `level === 0` (absolute import): try each search root + dotted path,
+ *     resolving to `.py` first, then `/__init__.py`, then null
+ *
+ * Returns the resolved file path (relative to repo root) or `null` if the
+ * import cannot be resolved to an indexed file (stdlib, third-party, etc.).
+ */
+export declare function resolvePythonImport(imp: {
+    module: string;
+    level: number;
+}, importerFile: string, indexedFiles: string[] | Set<string>, srcLayout?: string | null): string | null;
+//# sourceMappingURL=python-import-resolver.d.ts.map

package/dist/utils/python-import-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-import-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/python-import-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,MAAM,CAcR;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAMrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACtC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,EACpC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,GAAG,IAAI,CAgCf"}

package/dist/utils/python-import-resolver.js

@@ -0,0 +1,101 @@
+/**
+ * Python import resolution — pure functions, no I/O.
+ *
+ * Handles:
+ *   - Relative imports (`from . import X`, `from ..pkg import Y`) via dot
+ *     counting and package-root walking
+ *   - Absolute imports (`import X`, `from X.Y import Z`) via index lookup
+ *     with automatic `src/` layout detection
+ *   - `.py` and `__init__.py` resolution
+ */
+/**
+ * Walk upward from a file to find the innermost package root.
+ * A "package" is a directory containing `__init__.py`. The package root is
+ * the innermost ancestor directory (including the file's own directory) that
+ * contains `__init__.py`.
+ *
+ * If no ancestor has `__init__.py`, returns the file's directory.
+ * If the file is at repo root, returns "".
+ */
+export function findPackageRoot(filePath, indexedFiles) {
+    const segments = filePath.split("/");
+    segments.pop(); // remove filename
+    // Walk from deepest dir upward; return first dir with __init__.py
+    for (let i = segments.length; i >= 1; i--) {
+        const dir = segments.slice(0, i).join("/");
+        if (indexedFiles.has(`${dir}/__init__.py`)) {
+            return dir;
+        }
+    }
+    // No package found — return file's directory (or "" for repo root)
+    return segments.join("/");
+}
+/**
+ * Detect if the project uses a `src/` layout (e.g., `src/myapp/__init__.py`).
+ * Returns the layout root name (`"src"`) or `null` if no src layout detected.
+ */
+export function detectSrcLayout(indexedFiles) {
+    for (const f of indexedFiles) {
+        const match = f.match(/^src\/([^/]+)\/__init__\.py$/);
+        if (match)
+            return "src";
+    }
+    return null;
+}
+/**
+ * Resolve a Python import to a file path in the indexed tree.
+ *
+ * Algorithm:
+ *   - If `level > 0` (relative import): walk up `level - 1` dirs from the
+ *     importing file's package root, then resolve the remaining dotted path
+ *   - If `level === 0` (absolute import): try each search root + dotted path,
+ *     resolving to `.py` first, then `/__init__.py`, then null
+ *
+ * Returns the resolved file path (relative to repo root) or `null` if the
+ * import cannot be resolved to an indexed file (stdlib, third-party, etc.).
+ */
+export function resolvePythonImport(imp, importerFile, indexedFiles, srcLayout) {
+    const fileSet = indexedFiles instanceof Set ? indexedFiles : new Set(indexedFiles);
+    const { module, level } = imp;
+    if (level > 0) {
+        // Relative import
+        const packageRoot = findPackageRoot(importerFile, fileSet);
+        const packageSegments = packageRoot === "" ? [] : packageRoot.split("/");
+        // Walk up (level - 1) directories from package root
+        if (level - 1 > packageSegments.length)
+            return null;
+        const baseSegments = packageSegments.slice(0, packageSegments.length - (level - 1));
+        const moduleSegments = module === "" ? [] : module.split(".");
+        const fullPath = [...baseSegments, ...moduleSegments].join("/");
+        return tryResolve(fullPath, fileSet);
+    }
+    // Absolute import — try repo root first, then src/ layout
+    const moduleSegments = module.split(".");
+    const resolvedSrcLayout = srcLayout !== undefined ? srcLayout : detectSrcLayout([...fileSet]);
+    const searchRoots = ["", resolvedSrcLayout].filter((r) => r !== null);
+    for (const root of searchRoots) {
+        const base = root === "" ? moduleSegments.join("/") : `${root}/${moduleSegments.join("/")}`;
+        const resolved = tryResolve(base, fileSet);
+        if (resolved)
+            return resolved;
+    }
+    return null;
+}
+/**
+ * Try to resolve a path to an indexed file.
+ * Tries `.py` first, then `/__init__.py`.
+ */
+function tryResolve(basePath, fileSet) {
+    if (basePath === "")
+        return null;
+    // Try direct .py file
+    const asPyFile = `${basePath}.py`;
+    if (fileSet.has(asPyFile))
+        return asPyFile;
+    // Try as package __init__.py
+    const asInit = `${basePath}/__init__.py`;
+    if (fileSet.has(asInit))
+        return asInit;
+    return null;
+}
+//# sourceMappingURL=python-import-resolver.js.map

package/dist/utils/python-import-resolver.js.map

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

package/dist/utils/python-imports.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Python import extraction via tree-sitter AST.
+ *
+ * Walks `import_statement`, `import_from_statement`, and `if TYPE_CHECKING`
+ * blocks to produce a flat list of raw import descriptors. Resolution to
+ * file paths is the resolver's job (see python-import-resolver.ts).
+ *
+ * Because this uses the AST (not regex), string literals and comments
+ * cannot produce false positives.
+ */
+import type Parser from "web-tree-sitter";
+export interface PythonImportRef {
+    /** Dotted module path (empty string for `from . import X`) */
+    module: string;
+    /** Number of leading dots on relative imports (0 = absolute) */
+    level: number;
+    /** True if inside `if TYPE_CHECKING:` block */
+    is_type_only: boolean;
+    /** True for `from X import *` */
+    is_star: boolean;
+    /** Original source text for debugging */
+    raw: string;
+}
+/**
+ * Extract all Python imports from a parsed tree-sitter tree.
+ */
+export declare function extractPythonImports(tree: Parser.Tree): PythonImportRef[];
+//# sourceMappingURL=python-imports.d.ts.map

package/dist/utils/python-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-imports.d.ts","sourceRoot":"","sources":["../../src/utils/python-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAC;IACtB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,IAAI,GAChB,eAAe,EAAE,CAoGnB"}

package/dist/utils/python-imports.js

@@ -0,0 +1,117 @@
+/**
+ * Extract all Python imports from a parsed tree-sitter tree.
+ */
+export function extractPythonImports(tree) {
+    const imports = [];
+    function walk(node, inTypeChecking) {
+        switch (node.type) {
+            case "if_statement": {
+                // Detect `if TYPE_CHECKING:` or `if typing.TYPE_CHECKING:`
+                const condition = node.childForFieldName("condition");
+                const conditionText = condition?.text ?? "";
+                const isTypeCheck = /\bTYPE_CHECKING\b/.test(conditionText);
+                // Walk the consequence with type_only flag if this is a TYPE_CHECKING block
+                const consequence = node.childForFieldName("consequence");
+                if (consequence) {
+                    walk(consequence, inTypeChecking || isTypeCheck);
+                }
+                // Walk elif / else clauses (named "alternative") without type_only.
+                // Compare by start index since node refs from childForFieldName are
+                // distinct JS objects from the namedChildren array.
+                const conditionStart = condition?.startIndex;
+                const consequenceStart = consequence?.startIndex;
+                for (const child of node.namedChildren) {
+                    if (child.startIndex === conditionStart)
+                        continue;
+                    if (child.startIndex === consequenceStart)
+                        continue;
+                    walk(child, inTypeChecking);
+                }
+                return;
+            }
+            case "import_statement": {
+                // `import a`, `import a.b`, `import a, b, c`
+                // Children are `dotted_name` or `aliased_import` nodes
+                for (const child of node.namedChildren) {
+                    let moduleName = null;
+                    if (child.type === "dotted_name") {
+                        moduleName = child.text;
+                    }
+                    else if (child.type === "aliased_import") {
+                        const name = child.childForFieldName("name");
+                        moduleName = name?.text ?? null;
+                    }
+                    if (moduleName) {
+                        imports.push({
+                            module: moduleName,
+                            level: 0,
+                            is_type_only: inTypeChecking,
+                            is_star: false,
+                            raw: node.text,
+                        });
+                    }
+                }
+                return;
+            }
+            case "import_from_statement": {
+                // `from X import Y`, `from . import Y`, `from ..X import Y`, `from X import *`
+                const moduleNameNode = node.childForFieldName("module_name");
+                let level = 0;
+                let module = "";
+                if (moduleNameNode) {
+                    if (moduleNameNode.type === "relative_import") {
+                        // Count leading dots and find optional dotted_name
+                        level = countRelativeDots(moduleNameNode);
+                        const dottedName = moduleNameNode.namedChildren.find((c) => c.type === "dotted_name");
+                        module = dottedName?.text ?? "";
+                    }
+                    else if (moduleNameNode.type === "dotted_name") {
+                        module = moduleNameNode.text;
+                    }
+                }
+                // Detect wildcard_import `import *`
+                const is_star = node.namedChildren.some((c) => c.type === "wildcard_import");
+                imports.push({
+                    module,
+                    level,
+                    is_type_only: inTypeChecking,
+                    is_star,
+                    raw: node.text,
+                });
+                return;
+            }
+            default: {
+                for (const child of node.namedChildren) {
+                    walk(child, inTypeChecking);
+                }
+                return;
+            }
+        }
+    }
+    walk(tree.rootNode, false);
+    return imports;
+}
+/**
+ * Count the leading dots in a `relative_import` node.
+ * The dots appear as unnamed `import_prefix` child node or as separate
+ * "." tokens depending on grammar version.
+ */
+function countRelativeDots(relImport) {
+    // Walk all children (named + unnamed); each "." token represents one level
+    let dots = 0;
+    for (let i = 0; i < relImport.childCount; i++) {
+        const child = relImport.child(i);
+        if (!child)
+            continue;
+        if (child.type === "import_prefix") {
+            // Some grammar versions expose dots as an import_prefix node;
+            // count dots in its text
+            dots += (child.text.match(/\./g) ?? []).length;
+        }
+        else if (child.type === ".") {
+            dots += 1;
+        }
+    }
+    return dots;
+}
+//# sourceMappingURL=python-imports.js.map

package/dist/utils/python-imports.js.map

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