mcp-code-context 2.1.3

package/dist/src/ast/writers/phpWriter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * phpWriter.ts — PHP Surgical Writer
+ *
+ * Uses php-parser to parse the AST for symbol location data,
+ * then performs line-splice operations on the raw source text.
+ * php-parser doesn't have a write API like ts-morph, so we locate
+ * symbols via AST → get line numbers → splice in the replacement.
+ *
+ * Supports: .php, .phtml
+ */
+export interface WriteResult {
+    success: boolean;
+    newContent: string;
+    symbolsAffected: string[];
+    error?: string;
+}
+export type InsertPosition = "before" | "after" | "inside_start" | "inside_end";
+/**
+ * Replace the full text of a named symbol in a PHP file.
+ * When className is provided, scopes the search to within that class only.
+ */
+export declare function replacePHPSymbol(content: string, symbolName: string, newContent: string, className?: string): WriteResult;
+/**
+ * Insert new code at a precise location relative to an anchor symbol.
+ * When className is provided, scopes the anchor search to within that class only.
+ */
+export declare function insertPHPCode(content: string, code: string, anchorSymbol: string | null, position: InsertPosition, className?: string): WriteResult;
+/**
+ * Rename all occurrences of a symbol within a PHP file.
+ * Performs whole-word replacement respecting PHP identifier boundaries.
+ */
+export declare function renamePHPSymbol(content: string, oldName: string, newName: string): WriteResult;
+/**
+ * Remove a named symbol from a PHP file.
+ * When className is provided, scopes the search to within that class only.
+ */
+export declare function removePHPSymbol(content: string, symbolName: string, className?: string): WriteResult;

package/dist/src/ast/writers/phpWriter.js

@@ -0,0 +1,411 @@
+/**
+ * phpWriter.ts — PHP Surgical Writer
+ *
+ * Uses php-parser to parse the AST for symbol location data,
+ * then performs line-splice operations on the raw source text.
+ * php-parser doesn't have a write API like ts-morph, so we locate
+ * symbols via AST → get line numbers → splice in the replacement.
+ *
+ * Supports: .php, .phtml
+ */
+import { createRequire } from "node:module";
+// ─── Parser ─────────────────────────────────────────────────────────
+let _parser = null;
+function getParser() {
+    if (!_parser) {
+        const require = createRequire(import.meta.url);
+        const phpParser = require("php-parser");
+        _parser = new phpParser.Engine({
+            parser: {
+                extractDoc: true,
+                php7: true,
+                locations: true,
+                suppressErrors: true,
+            },
+            ast: { withPositions: true },
+        });
+    }
+    return _parser;
+}
+function parsePhp(content) {
+    try {
+        return getParser().parseCode(content, "file.php");
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Replace Symbol ─────────────────────────────────────────────────
+/**
+ * Replace the full text of a named symbol in a PHP file.
+ * When className is provided, scopes the search to within that class only.
+ */
+export function replacePHPSymbol(content, symbolName, newContent, className) {
+    const ast = parsePhp(content);
+    if (!ast) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: "Failed to parse PHP file",
+        };
+    }
+    const node = findSymbolNode(ast, symbolName, className);
+    if (!node || !node.loc) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: className
+                ? `Symbol "${symbolName}" not found in class "${className}" in PHP file`
+                : `Symbol "${symbolName}" not found in PHP file`,
+        };
+    }
+    const lines = content.split("\n");
+    // Find the actual start including doc comments
+    const startLine = findActualStart(lines, node);
+    const endLine = node.loc.end.line; // 1-indexed, inclusive
+    // Detect the indentation of the original symbol
+    const originalIndent = getIndent(lines[startLine - 1] || "");
+    // Re-indent the new content to match
+    const reindented = reindentCode(newContent.trim(), originalIndent);
+    // Splice in the replacement
+    const before = lines.slice(0, startLine - 1);
+    const after = lines.slice(endLine);
+    const result = [...before, reindented, ...after].join("\n");
+    // Validate: try to parse the result
+    const validationAst = parsePhp(result);
+    if (!validationAst) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: `Replacement produced invalid PHP syntax. Aborting.`,
+        };
+    }
+    return {
+        success: true,
+        newContent: result,
+        symbolsAffected: [symbolName],
+    };
+}
+// ─── Insert Code ────────────────────────────────────────────────────
+/**
+ * Insert new code at a precise location relative to an anchor symbol.
+ * When className is provided, scopes the anchor search to within that class only.
+ */
+export function insertPHPCode(content, code, anchorSymbol, position, className) {
+    const lines = content.split("\n");
+    if (!anchorSymbol) {
+        // No anchor — insert before the final closing tag or at end
+        const lastClosingBrace = findLastClosingBrace(lines);
+        if (lastClosingBrace !== -1) {
+            // Insert before the last } (likely end of namespace or class)
+            lines.splice(lastClosingBrace, 0, "", code.trim(), "");
+        }
+        else {
+            lines.push("", code.trim());
+        }
+        return {
+            success: true,
+            newContent: lines.join("\n"),
+            symbolsAffected: [],
+        };
+    }
+    const ast = parsePhp(content);
+    if (!ast) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: "Failed to parse PHP file",
+        };
+    }
+    const node = findSymbolNode(ast, anchorSymbol, className);
+    if (!node || !node.loc) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: className
+                ? `Anchor symbol "${anchorSymbol}" not found in class "${className}"`
+                : `Anchor symbol "${anchorSymbol}" not found`,
+        };
+    }
+    const startLine = findActualStart(lines, node);
+    const endLine = node.loc.end.line;
+    const indent = getIndent(lines[startLine - 1] || "");
+    const reindented = reindentCode(code.trim(), indent);
+    switch (position) {
+        case "before":
+            lines.splice(startLine - 1, 0, reindented, "");
+            break;
+        case "after":
+            lines.splice(endLine, 0, "", reindented);
+            break;
+        case "inside_start": {
+            // Find the opening brace of the class/interface
+            const braceIdx = findOpeningBrace(lines, startLine - 1);
+            if (braceIdx === -1) {
+                return {
+                    success: false,
+                    newContent: content,
+                    symbolsAffected: [],
+                    error: `Cannot find opening brace for "${anchorSymbol}"`,
+                };
+            }
+            const innerIndent = indent + "    ";
+            const innerCode = reindentCode(code.trim(), innerIndent);
+            lines.splice(braceIdx + 1, 0, innerCode, "");
+            break;
+        }
+        case "inside_end": {
+            // Insert before the closing brace
+            const innerIndent = indent + "    ";
+            const innerCode = reindentCode(code.trim(), innerIndent);
+            lines.splice(endLine - 1, 0, "", innerCode);
+            break;
+        }
+    }
+    return {
+        success: true,
+        newContent: lines.join("\n"),
+        symbolsAffected: [anchorSymbol],
+    };
+}
+// ─── Rename Symbol ──────────────────────────────────────────────────
+/**
+ * Rename all occurrences of a symbol within a PHP file.
+ * Performs whole-word replacement respecting PHP identifier boundaries.
+ */
+export function renamePHPSymbol(content, oldName, newName) {
+    const ast = parsePhp(content);
+    if (!ast) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: "Failed to parse PHP file",
+        };
+    }
+    // Verify the symbol exists
+    const node = findSymbolNode(ast, oldName);
+    if (!node) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: `Symbol "${oldName}" not found for renaming`,
+        };
+    }
+    // Perform whole-word replacement
+    const escaped = oldName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const regex = new RegExp(`\\b${escaped}\\b`, "g");
+    const result = content.replace(regex, newName);
+    // Validate
+    const validationAst = parsePhp(result);
+    if (!validationAst) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: `Rename produced invalid PHP syntax`,
+        };
+    }
+    return {
+        success: true,
+        newContent: result,
+        symbolsAffected: [oldName],
+    };
+}
+// ─── Remove Symbol ──────────────────────────────────────────────────
+/**
+ * Remove a named symbol from a PHP file.
+ * When className is provided, scopes the search to within that class only.
+ */
+export function removePHPSymbol(content, symbolName, className) {
+    const ast = parsePhp(content);
+    if (!ast) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: "Failed to parse PHP file",
+        };
+    }
+    const node = findSymbolNode(ast, symbolName, className);
+    if (!node || !node.loc) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: className
+                ? `Symbol "${symbolName}" not found in class "${className}" for removal`
+                : `Symbol "${symbolName}" not found for removal`,
+        };
+    }
+    const lines = content.split("\n");
+    const startLine = findActualStart(lines, node);
+    const endLine = node.loc.end.line;
+    // Remove the lines
+    lines.splice(startLine - 1, endLine - startLine + 1);
+    // Clean up consecutive blank lines
+    let result = lines.join("\n");
+    result = result.replace(/\n{3,}/g, "\n\n");
+    return {
+        success: true,
+        newContent: result,
+        symbolsAffected: [symbolName],
+    };
+}
+// ─── Internal Helpers ───────────────────────────────────────────────
+function getNodeName(node) {
+    if (!node || !node.name)
+        return "";
+    if (typeof node.name === "string")
+        return node.name;
+    if (typeof node.name === "object" && "name" in node.name)
+        return node.name.name;
+    return "";
+}
+/**
+ * Find a class/interface/trait/enum node by name in the AST tree.
+ * Used to scope symbol searches to a specific container.
+ */
+function findClassNodePhp(node, className) {
+    if (!node)
+        return null;
+    if (["class", "interface", "trait", "enum"].includes(node.kind) &&
+        getNodeName(node) === className) {
+        return node;
+    }
+    const allChildren = [
+        ...(node.children || []),
+        ...(Array.isArray(node.body) ? node.body : []),
+    ];
+    for (const child of allChildren) {
+        const found = findClassNodePhp(child, className);
+        if (found)
+            return found;
+    }
+    return null;
+}
+function findSymbolNode(node, symbolName, className) {
+    if (!node)
+        return null;
+    // If className is provided, first find the class, then search within it
+    if (className) {
+        const classNode = findClassNodePhp(node, className);
+        if (!classNode)
+            return null;
+        // Search only within this class's body
+        const body = Array.isArray(classNode.body) ? classNode.body : [];
+        for (const member of body) {
+            if (member.kind === "method" && getNodeName(member) === symbolName) {
+                return member;
+            }
+        }
+        return null;
+    }
+    const nodeName = getNodeName(node);
+    // Direct match on class, interface, trait, enum, function
+    if (["class", "interface", "trait", "enum", "function"].includes(node.kind) &&
+        nodeName === symbolName) {
+        return node;
+    }
+    // Search methods inside classes/interfaces/traits/enums
+    if (["class", "interface", "trait", "enum"].includes(node.kind)) {
+        const body = Array.isArray(node.body) ? node.body : [];
+        for (const member of body) {
+            if (member.kind === "method" && getNodeName(member) === symbolName) {
+                return member;
+            }
+        }
+    }
+    // Recursive search through children
+    const allChildren = [
+        ...(node.children || []),
+        ...(Array.isArray(node.body) ? node.body : []),
+    ];
+    for (const child of allChildren) {
+        const found = findSymbolNode(child, symbolName);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/**
+ * Walk backward from a symbol's start to capture leading doc comments.
+ * Returns the 1-indexed line number of the actual start.
+ */
+function findActualStart(lines, node) {
+    if (!node.loc)
+        return 1;
+    let startLine = node.loc.start.line; // 1-indexed
+    if (node.leadingComments && node.leadingComments.length > 0) {
+        for (let i = startLine - 2; i >= 0; i--) {
+            const trimmed = lines[i].trim();
+            if (trimmed.startsWith("/**") ||
+                trimmed.startsWith("*") ||
+                trimmed.startsWith("*/") ||
+                trimmed.startsWith("//") ||
+                trimmed.startsWith("#[")) {
+                startLine = i + 1; // Convert back to 1-indexed
+            }
+            else if (trimmed === "") {
+                continue;
+            }
+            else {
+                break;
+            }
+        }
+    }
+    return startLine;
+}
+function getIndent(line) {
+    const match = line.match(/^(\s*)/);
+    return match ? match[1] : "";
+}
+/**
+ * Re-indent a block of code to match a target indentation level.
+ * Detects the minimum indentation of the input and replaces it with target.
+ */
+function reindentCode(code, targetIndent) {
+    const lines = code.split("\n");
+    if (lines.length === 0)
+        return code;
+    // Find minimum non-empty indentation
+    let minIndent = Infinity;
+    for (const line of lines) {
+        if (line.trim() === "")
+            continue;
+        const indent = line.match(/^(\s*)/)?.[1]?.length ?? 0;
+        if (indent < minIndent)
+            minIndent = indent;
+    }
+    if (minIndent === Infinity)
+        minIndent = 0;
+    // Re-indent each line
+    return lines
+        .map((line) => {
+        if (line.trim() === "")
+            return "";
+        return targetIndent + line.slice(minIndent);
+    })
+        .join("\n");
+}
+function findOpeningBrace(lines, startIdx) {
+    for (let i = startIdx; i < lines.length; i++) {
+        if (lines[i].includes("{"))
+            return i;
+    }
+    return -1;
+}
+function findLastClosingBrace(lines) {
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (lines[i].trim() === "}")
+            return i;
+    }
+    return -1;
+}
+//# sourceMappingURL=phpWriter.js.map

package/dist/src/ast/writers/phpWriter.js.map

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

package/dist/src/ast/writers/pyWriter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * pyWriter.ts — Python Surgical Writer
+ *
+ * Uses indentation-based block detection to locate symbol boundaries
+ * in Python files. Python's significant whitespace makes this different
+ * from brace-delimited languages — we detect block ends by watching
+ * for dedentation back to the original level.
+ *
+ * Supports: .py, .pyi
+ */
+export interface WriteResult {
+    success: boolean;
+    newContent: string;
+    symbolsAffected: string[];
+    error?: string;
+}
+export type InsertPosition = "before" | "after" | "inside_start" | "inside_end";
+/**
+ * Replace the full text of a named symbol in a Python file.
+ * The newContent should include the def/class signature and body.
+ * When className is provided, scopes the search to within that class only.
+ */
+export declare function replacePySymbol(content: string, symbolName: string, newContent: string, className?: string): WriteResult;
+/**
+ * Insert new code at a precise location relative to an anchor symbol.
+ * When className is provided, scopes the anchor search to within that class only.
+ */
+export declare function insertPyCode(content: string, code: string, anchorSymbol: string | null, position: InsertPosition, className?: string): WriteResult;
+/**
+ * Rename all occurrences of a symbol within a Python file.
+ */
+export declare function renamePySymbol(content: string, oldName: string, newName: string): WriteResult;
+/**
+ * Remove a named symbol from a Python file.
+ * When className is provided, scopes the search to within that class only.
+ */
+export declare function removePySymbol(content: string, symbolName: string, className?: string): WriteResult;