distill-mcp 0.6.0-beta

package/dist/ast/php/utils.js

@@ -0,0 +1,246 @@
+/**
+ * PHP Parser Utilities
+ *
+ * Helper functions for converting Tree-sitter nodes to CodeElements
+ * and extracting PHP-specific constructs.
+ */
+/**
+ * Get line number from a Tree-sitter node (1-indexed)
+ */
+export function getLineNumber(node) {
+    return node.startPosition.row + 1;
+}
+/**
+ * Get end line number from a Tree-sitter node (1-indexed)
+ */
+export function getEndLineNumber(node) {
+    return node.endPosition.row + 1;
+}
+/**
+ * Extract PHPDoc comment from above a declaration
+ * PHP uses block doc comments starting with /**
+ */
+export function extractPhpDoc(node, lines) {
+    const startLine = node.startPosition.row;
+    const comments = [];
+    // Look for PHPDoc comments above the node
+    for (let i = startLine - 1; i >= 0; i--) {
+        const line = lines[i]?.trim();
+        if (!line) {
+            // Empty line - continue looking
+            continue;
+        }
+        else if (line.startsWith("*/")) {
+            // End of block comment - look for the start
+            for (let j = i; j >= 0; j--) {
+                const commentLine = lines[j]?.trim();
+                if (commentLine?.startsWith("/**")) {
+                    // Found start of PHPDoc
+                    for (let k = j; k <= i; k++) {
+                        let cl = lines[k]?.trim() ?? "";
+                        // Clean up comment markers
+                        if (cl.startsWith("/**"))
+                            cl = cl.slice(3).trim();
+                        if (cl.endsWith("*/"))
+                            cl = cl.slice(0, -2).trim();
+                        if (cl.startsWith("*"))
+                            cl = cl.slice(1).trim();
+                        if (cl)
+                            comments.push(cl);
+                    }
+                    break;
+                }
+            }
+            break;
+        }
+        else if (line.startsWith("*")) {
+            // Middle of block comment
+            continue;
+        }
+        else if (line.startsWith("//")) {
+            // Single line comment - skip
+            continue;
+        }
+        else {
+            // Something else (code) - stop
+            break;
+        }
+    }
+    return comments.length > 0 ? comments.join("\n") : undefined;
+}
+/**
+ * Get visibility from a node (public, private, protected)
+ */
+export function getVisibility(node) {
+    for (const child of node.children) {
+        if (child.type === "visibility_modifier") {
+            return child.text;
+        }
+    }
+    return undefined;
+}
+/**
+ * Check if a node has public visibility (explicit or default)
+ */
+export function isPublic(node) {
+    const visibility = getVisibility(node);
+    return visibility === "public" || visibility === undefined;
+}
+/**
+ * Check if a function/method has static modifier
+ */
+export function isStatic(node) {
+    for (const child of node.children) {
+        if (child.type === "static_modifier") {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Get function signature from a function_definition node
+ */
+export function getFunctionSignature(node) {
+    const nameNode = node.childForFieldName("name");
+    const paramsNode = node.childForFieldName("parameters");
+    const returnTypeNode = node.childForFieldName("return_type");
+    const name = nameNode?.text ?? "unknown";
+    const params = paramsNode?.text ?? "()";
+    const returnType = returnTypeNode ? `: ${returnTypeNode.text}` : "";
+    return `function ${name}${params}${returnType}`;
+}
+/**
+ * Get method signature from a method_declaration node
+ */
+export function getMethodSignature(node) {
+    const visibility = getVisibility(node) ?? "public";
+    const staticMod = isStatic(node) ? "static " : "";
+    const nameNode = node.childForFieldName("name");
+    const paramsNode = node.childForFieldName("parameters");
+    const returnTypeNode = node.childForFieldName("return_type");
+    const name = nameNode?.text ?? "unknown";
+    const params = paramsNode?.text ?? "()";
+    const returnType = returnTypeNode ? `: ${returnTypeNode.text}` : "";
+    return `${visibility} ${staticMod}function ${name}${params}${returnType}`;
+}
+/**
+ * Get class signature
+ */
+export function getClassSignature(node) {
+    const nameNode = node.childForFieldName("name");
+    const name = nameNode?.text ?? "unknown";
+    // Check for abstract/final modifiers
+    let prefix = "class";
+    for (const child of node.children) {
+        if (child.type === "abstract_modifier") {
+            prefix = "abstract class";
+            break;
+        }
+        if (child.type === "final_modifier") {
+            prefix = "final class";
+            break;
+        }
+    }
+    return `${prefix} ${name}`;
+}
+/**
+ * Get interface signature
+ */
+export function getInterfaceSignature(node) {
+    const nameNode = node.childForFieldName("name");
+    const name = nameNode?.text ?? "unknown";
+    return `interface ${name}`;
+}
+/**
+ * Get trait signature
+ */
+export function getTraitSignature(node) {
+    const nameNode = node.childForFieldName("name");
+    const name = nameNode?.text ?? "unknown";
+    return `trait ${name}`;
+}
+/**
+ * Extract the use path from a namespace_use_declaration
+ */
+export function getUsePath(node) {
+    // Get the full text and clean it up
+    const text = node.text.trim();
+    // Remove "use " prefix and trailing ";"
+    let path = text;
+    if (path.startsWith("use ")) {
+        path = path.slice(4);
+    }
+    if (path.endsWith(";")) {
+        path = path.slice(0, -1);
+    }
+    return path.trim();
+}
+/**
+ * Get the short name from a use path
+ * e.g., "App\\Models\\User" -> "User"
+ */
+export function getUseShortName(usePath) {
+    // Handle "as Alias" syntax
+    const asMatch = usePath.match(/\s+as\s+(\w+)\s*$/i);
+    if (asMatch) {
+        return asMatch[1];
+    }
+    // Handle grouped use: use App\{A, B}
+    const braceMatch = usePath.match(/\{(.+)\}\s*$/);
+    if (braceMatch) {
+        const items = braceMatch[1].split(",").map((s) => s.trim());
+        if (items.length === 1) {
+            return items[0];
+        }
+        return `{${items.join(", ")}}`;
+    }
+    // Simple path: App\Models\User
+    const parts = usePath.split("\\");
+    return parts[parts.length - 1] ?? usePath;
+}
+/**
+ * Get const declaration info
+ */
+export function getConstSignature(node) {
+    const visibility = getVisibility(node);
+    const text = node.text.trim();
+    // Extract const name from the declaration
+    const match = text.match(/const\s+(\w+)/);
+    const name = match?.[1] ?? "unknown";
+    if (visibility) {
+        return `${visibility} const ${name}`;
+    }
+    return `const ${name}`;
+}
+/**
+ * Get const name from declaration
+ */
+export function getConstName(node) {
+    // Look for const_element children
+    for (const child of node.namedChildren) {
+        if (child.type === "const_element") {
+            const nameNode = child.childForFieldName("name");
+            if (nameNode)
+                return nameNode.text;
+        }
+    }
+    // Fallback: try to extract from text
+    const match = node.text.match(/const\s+(\w+)/);
+    return match?.[1] ?? "unknown";
+}
+/**
+ * Create a CodeElement from a Tree-sitter node
+ */
+export function createCodeElement(type, name, node, options) {
+    return {
+        type,
+        name,
+        startLine: getLineNumber(node),
+        endLine: getEndLineNumber(node),
+        signature: options?.signature,
+        documentation: options?.documentation,
+        isAsync: options?.isAsync,
+        isExported: options?.isExported,
+        parent: options?.parent,
+    };
+}

package/dist/ast/python/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Python AST Parser Module
+ *
+ * Exports the Tree-sitter based Python parser.
+ */
+export { pythonTreeSitterParser, parsePython, parsePythonAsync, extractPythonElement, searchPythonElements, initPythonParser, } from "./parser.js";
+export { QUERIES } from "./queries.js";
+export { getLineNumber, getEndLineNumber, extractDocstring, getFunctionSignature, getClassSignature, createCodeElement, } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ast/python/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ast/python/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/ast/python/index.js

@@ -0,0 +1,8 @@
+/**
+ * Python AST Parser Module
+ *
+ * Exports the Tree-sitter based Python parser.
+ */
+export { pythonTreeSitterParser, parsePython, parsePythonAsync, extractPythonElement, searchPythonElements, initPythonParser, } from "./parser.js";
+export { QUERIES } from "./queries.js";
+export { getLineNumber, getEndLineNumber, extractDocstring, getFunctionSignature, getClassSignature, createCodeElement, } from "./utils.js";

package/dist/ast/python/parser.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Python Tree-sitter Parser
+ *
+ * AST parser for Python using Tree-sitter for accurate code analysis.
+ */
+import type { CodeElement, FileStructure, ExtractedContent, ExtractionTarget, ExtractionOptions, ParseOptions, LanguageParser } from "../types.js";
+/**
+ * Parse Python content and extract structure
+ * @param options ParseOptions - set detailed: true for signature/documentation
+ */
+export declare function parsePython(content: string, options?: ParseOptions): FileStructure;
+/**
+ * Async version of parsePython for initial calls
+ */
+export declare function parsePythonAsync(content: string, options?: ParseOptions): Promise<FileStructure>;
+/**
+ * Extract a specific element from Python code
+ */
+export declare function extractPythonElement(content: string, target: ExtractionTarget, options: ExtractionOptions): Promise<ExtractedContent | null>;
+/**
+ * Search for elements matching a query
+ */
+export declare function searchPythonElements(content: string, query: string): Promise<CodeElement[]>;
+/**
+ * LanguageParser implementation for Python
+ */
+export declare const pythonTreeSitterParser: LanguageParser;
+/**
+ * Initialize the parser (call this at server startup)
+ */
+export declare function initPythonParser(): Promise<void>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/ast/python/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/ast/python/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACf,MAAM,aAAa,CAAC;AA4GrB;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,aAAa,CAsBtF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAa1G;AA4HD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA+DlC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAkBjG;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAiHpC,CAAC;AAEF;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtD"}