mcp-code-context 2.1.3

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

@@ -0,0 +1,355 @@
+/**
+ * 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
+ */
+// ─── Replace Symbol ─────────────────────────────────────────────────
+/**
+ * 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 function replacePySymbol(content, symbolName, newContent, className) {
+    const lines = content.split("\n");
+    const range = findSymbolRange(lines, symbolName, className);
+    if (!range) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: className
+                ? `Symbol "${symbolName}" not found in class "${className}" in Python file`
+                : `Symbol "${symbolName}" not found in Python file`,
+        };
+    }
+    const { start, end } = range;
+    // Detect indentation of original
+    const originalIndent = getIndent(lines[start]);
+    const reindented = reindentPython(newContent.trim(), originalIndent);
+    // Splice
+    const before = lines.slice(0, start);
+    const after = lines.slice(end + 1);
+    const result = [...before, reindented, ...after].join("\n");
+    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 insertPyCode(content, code, anchorSymbol, position, className) {
+    const lines = content.split("\n");
+    if (!anchorSymbol) {
+        // No anchor — append at end of file
+        lines.push("", "", code.trim(), "");
+        return {
+            success: true,
+            newContent: lines.join("\n"),
+            symbolsAffected: [],
+        };
+    }
+    const range = findSymbolRange(lines, anchorSymbol, className);
+    if (!range) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: className
+                ? `Anchor symbol "${anchorSymbol}" not found in class "${className}"`
+                : `Anchor symbol "${anchorSymbol}" not found`,
+        };
+    }
+    const { start, end } = range;
+    const indent = getIndent(lines[start]);
+    switch (position) {
+        case "before": {
+            const reindented = reindentPython(code.trim(), indent);
+            // Add proper spacing (PEP 8: two blank lines before top-level, one inside class)
+            const spacing = indent === "" ? "\n\n" : "\n";
+            lines.splice(start, 0, reindented + spacing);
+            break;
+        }
+        case "after": {
+            const reindented = reindentPython(code.trim(), indent);
+            const spacing = indent === "" ? "\n\n" : "\n";
+            lines.splice(end + 1, 0, spacing + reindented);
+            break;
+        }
+        case "inside_start": {
+            // Find the colon line (class Foo:) and insert after it
+            const colonLine = findColonLine(lines, start);
+            if (colonLine === -1) {
+                return {
+                    success: false,
+                    newContent: content,
+                    symbolsAffected: [],
+                    error: `Cannot find class body start for "${anchorSymbol}"`,
+                };
+            }
+            // Check if there's a docstring, insert after it
+            const insertAt = skipDocstring(lines, colonLine + 1);
+            const innerIndent = indent + "    "; // Python convention: 4-space indent
+            const innerCode = reindentPython(code.trim(), innerIndent);
+            lines.splice(insertAt, 0, innerCode, "");
+            break;
+        }
+        case "inside_end": {
+            const innerIndent = indent + "    ";
+            const innerCode = reindentPython(code.trim(), innerIndent);
+            lines.splice(end + 1, 0, "", innerCode);
+            break;
+        }
+    }
+    return {
+        success: true,
+        newContent: lines.join("\n"),
+        symbolsAffected: [anchorSymbol],
+    };
+}
+// ─── Rename Symbol ──────────────────────────────────────────────────
+/**
+ * Rename all occurrences of a symbol within a Python file.
+ */
+export function renamePySymbol(content, oldName, newName) {
+    const lines = content.split("\n");
+    const range = findSymbolRange(lines, oldName);
+    if (!range) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: `Symbol "${oldName}" not found for renaming`,
+        };
+    }
+    // Whole-word replacement
+    const escaped = oldName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const regex = new RegExp(`\\b${escaped}\\b`, "g");
+    const result = content.replace(regex, newName);
+    return {
+        success: true,
+        newContent: result,
+        symbolsAffected: [oldName],
+    };
+}
+// ─── Remove Symbol ──────────────────────────────────────────────────
+/**
+ * Remove a named symbol from a Python file.
+ * When className is provided, scopes the search to within that class only.
+ */
+export function removePySymbol(content, symbolName, className) {
+    const lines = content.split("\n");
+    const range = findSymbolRange(lines, symbolName, className);
+    if (!range) {
+        return {
+            success: false,
+            newContent: content,
+            symbolsAffected: [],
+            error: className
+                ? `Symbol "${symbolName}" not found in class "${className}" for removal`
+                : `Symbol "${symbolName}" not found for removal`,
+        };
+    }
+    // Also remove leading decorators
+    let actualStart = range.start;
+    while (actualStart > 0 && lines[actualStart - 1].trim().startsWith("@")) {
+        actualStart--;
+    }
+    lines.splice(actualStart, range.end - actualStart + 1);
+    let result = lines.join("\n");
+    result = result.replace(/\n{3,}/g, "\n\n");
+    return {
+        success: true,
+        newContent: result,
+        symbolsAffected: [symbolName],
+    };
+}
+/**
+ * Find the start and end line indices of a named symbol in a Python file.
+ * Uses indentation to detect block boundaries (Python's significant whitespace).
+ * When className is provided, scopes the search to within that class only.
+ */
+function findSymbolRange(lines, symbolName, className) {
+    const escaped = symbolName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    // If className is provided, find the class first, then search within it
+    if (className) {
+        const escapedClass = className.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        for (let i = 0; i < lines.length; i++) {
+            const trimmed = lines[i].trim();
+            if (!new RegExp(`^class\\s+${escapedClass}[\\s(:]`).test(trimmed))
+                continue;
+            // Found the class — search for the method within it
+            const classIndent = measureIndent(lines[i]);
+            let j = i + 1;
+            while (j < lines.length) {
+                const bodyLine = lines[j];
+                if (bodyLine.trim() === "") {
+                    j++;
+                    continue;
+                }
+                if (measureIndent(bodyLine) <= classIndent && bodyLine.trim() !== "")
+                    break;
+                const bodyTrimmed = bodyLine.trim();
+                const isFunc = new RegExp(`^(?:async\\s+)?def\\s+${escaped}\\s*\\(`).test(bodyTrimmed);
+                if (isFunc) {
+                    const startLine = j;
+                    const baseIndent = measureIndent(bodyLine);
+                    // Check for decorators above
+                    let decoratorStart = startLine;
+                    while (decoratorStart > 0 &&
+                        lines[decoratorStart - 1].trim().startsWith("@")) {
+                        decoratorStart--;
+                    }
+                    // Find end of block
+                    let endLine = startLine;
+                    let k = startLine + 1;
+                    while (k < lines.length) {
+                        const innerLine = lines[k];
+                        if (innerLine.trim() === "") {
+                            k++;
+                            continue;
+                        }
+                        if (measureIndent(innerLine) > baseIndent) {
+                            endLine = k;
+                            k++;
+                        }
+                        else
+                            break;
+                    }
+                    while (endLine > startLine && lines[endLine].trim() === "") {
+                        endLine--;
+                    }
+                    return { start: decoratorStart, end: endLine };
+                }
+                j++;
+            }
+            return null; // Method not found within class
+        }
+        return null; // Class not found
+    }
+    // Original behavior when no className is provided
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        const isClass = new RegExp(`^class\\s+${escaped}[\\s(:]`).test(trimmed);
+        const isFunc = new RegExp(`^(?:async\\s+)?def\\s+${escaped}\\s*\\(`).test(trimmed);
+        if (!isClass && !isFunc)
+            continue;
+        const startLine = i;
+        const baseIndent = measureIndent(line);
+        // Also check for decorators above
+        let decoratorStart = startLine;
+        while (decoratorStart > 0 &&
+            lines[decoratorStart - 1].trim().startsWith("@")) {
+            decoratorStart--;
+        }
+        // Find the end of the block
+        let endLine = startLine;
+        let j = startLine + 1;
+        while (j < lines.length) {
+            const bodyLine = lines[j];
+            if (bodyLine.trim() === "") {
+                j++;
+                continue;
+            }
+            if (measureIndent(bodyLine) > baseIndent) {
+                endLine = j;
+                j++;
+            }
+            else {
+                break;
+            }
+        }
+        // Trim trailing blank lines from the block
+        while (endLine > startLine && lines[endLine].trim() === "") {
+            endLine--;
+        }
+        return { start: decoratorStart, end: endLine };
+    }
+    return null;
+}
+// ─── Utility Functions ──────────────────────────────────────────────
+function measureIndent(line) {
+    const match = line.match(/^(\s*)/);
+    return match ? match[1].length : 0;
+}
+function getIndent(line) {
+    const match = line.match(/^(\s*)/);
+    return match ? match[1] : "";
+}
+/**
+ * Re-indent a block of Python code to match a target indentation level.
+ * Preserves relative indentation within the block.
+ */
+function reindentPython(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 = measureIndent(line);
+        if (indent < minIndent)
+            minIndent = indent;
+    }
+    if (minIndent === Infinity)
+        minIndent = 0;
+    return lines
+        .map((line) => {
+        if (line.trim() === "")
+            return "";
+        return targetIndent + line.slice(minIndent);
+    })
+        .join("\n");
+}
+/**
+ * Find the line containing the colon that starts a class/function body.
+ */
+function findColonLine(lines, startIdx) {
+    for (let i = startIdx; i < lines.length; i++) {
+        if (lines[i].includes(":"))
+            return i;
+    }
+    return -1;
+}
+/**
+ * Skip past a docstring (if present) to find the first line of actual code.
+ */
+function skipDocstring(lines, startIdx) {
+    let i = startIdx;
+    // Skip blank lines
+    while (i < lines.length && lines[i].trim() === "")
+        i++;
+    if (i >= lines.length)
+        return startIdx;
+    const trimmed = lines[i].trim();
+    // Look for triple-quoted docstring
+    if (trimmed.startsWith('"""') ||
+        trimmed.startsWith("'''")) {
+        const quote = trimmed.slice(0, 3);
+        // Single-line docstring
+        if (trimmed.endsWith(quote) && trimmed.length > 3) {
+            return i + 1;
+        }
+        // Multi-line docstring
+        i++;
+        while (i < lines.length) {
+            if (lines[i].trim().endsWith(quote)) {
+                return i + 1;
+            }
+            i++;
+        }
+    }
+    return startIdx;
+}
+//# sourceMappingURL=pyWriter.js.map

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * symbolWriter.ts — Central Dispatcher for Surgical Write Operations
+ *
+ * Routes write operations to the correct language-specific writer based
+ * on file extension. This is the "write" counterpart to semanticCompressor.ts.
+ *
+ * Supports:
+ *   - TypeScript/JavaScript (.ts, .tsx, .js, .jsx, .mts, .mjs, .cts, .cjs)
+ *   - PHP (.php, .phtml)
+ *   - Dart (.dart)
+ *   - Python (.py, .pyi)
+ */
+import { type WriteResult, type InsertPosition } from "./tsWriter.js";
+export type { WriteResult, InsertPosition };
+/** All extensions supported for surgical writing */
+export declare const WRITABLE_EXTENSIONS: Set<string>;
+/**
+ * Replace the full source code of a named symbol in a file.
+ * Dispatches to the correct language-specific writer.
+ *
+ * @param filePath   - Used to detect language via extension
+ * @param content    - Current file content
+ * @param symbolName - Name of the symbol to replace
+ * @param newContent - Complete replacement code (signature + body)
+ * @param className  - Optional. Scopes search to within a specific class
+ */
+export declare function replaceSymbol(filePath: string, content: string, symbolName: string, newContent: string, className?: string): WriteResult;
+/**
+ * Insert new code at a precise location relative to an anchor symbol.
+ *
+ * @param filePath     - Used to detect language via extension
+ * @param content      - Current file content
+ * @param code         - The code to insert
+ * @param anchorSymbol - Symbol to position relative to (null = end of file)
+ * @param position     - Where to insert: before, after, inside_start, inside_end
+ * @param className    - Optional. Scopes anchor search to within a specific class
+ */
+export declare function insertCode(filePath: string, content: string, code: string, anchorSymbol: string | null, position: InsertPosition, className?: string): WriteResult;
+/**
+ * Rename all occurrences of a symbol within a single file.
+ *
+ * @param filePath - Used to detect language via extension
+ * @param content  - Current file content
+ * @param oldName  - Current symbol name
+ * @param newName  - New symbol name
+ */
+export declare function renameInFile(filePath: string, content: string, oldName: string, newName: string): WriteResult;
+/**
+ * Renames all whole-word occurrences of a symbol in a file.
+ * UNLIKE renameInFile, this does NOT check for the symbol definition.
+ * Used for updating references in dependent files.
+ */
+export declare function renameReferencesInFile(filePath: string, content: string, oldName: string, newName: string): WriteResult;
+/**
+ * Remove a named symbol from a file.
+ *
+ * @param filePath   - Used to detect language via extension
+ * @param content    - Current file content
+ * @param symbolName - Name of the symbol to remove
+ * @param className  - Optional. Scopes search to within a specific class
+ */
+export declare function removeSymbolFromFile(filePath: string, content: string, symbolName: string, className?: string): WriteResult;

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

@@ -0,0 +1,179 @@
+/**
+ * symbolWriter.ts — Central Dispatcher for Surgical Write Operations
+ *
+ * Routes write operations to the correct language-specific writer based
+ * on file extension. This is the "write" counterpart to semanticCompressor.ts.
+ *
+ * Supports:
+ *   - TypeScript/JavaScript (.ts, .tsx, .js, .jsx, .mts, .mjs, .cts, .cjs)
+ *   - PHP (.php, .phtml)
+ *   - Dart (.dart)
+ *   - Python (.py, .pyi)
+ */
+import * as path from "node:path";
+import { replaceTSSymbol, insertTSCode, renameTSSymbol, removeTSSymbol, } from "./tsWriter.js";
+import { replacePHPSymbol, insertPHPCode, renamePHPSymbol, removePHPSymbol, } from "./phpWriter.js";
+import { replaceDartSymbol, insertDartCode, renameDartSymbol, removeDartSymbol, } from "./dartWriter.js";
+import { replacePySymbol, insertPyCode, renamePySymbol, removePySymbol, } from "./pyWriter.js";
+// ─── Extension Sets ─────────────────────────────────────────────────
+const TS_EXTENSIONS = new Set([
+    ".ts", ".tsx", ".js", ".jsx", ".mts", ".mjs", ".cts", ".cjs",
+]);
+const PHP_EXTENSIONS = new Set([".php", ".phtml"]);
+const DART_EXTENSIONS = new Set([".dart"]);
+const PY_EXTENSIONS = new Set([".py", ".pyi"]);
+/** All extensions supported for surgical writing */
+export const WRITABLE_EXTENSIONS = new Set([
+    ...TS_EXTENSIONS,
+    ...PHP_EXTENSIONS,
+    ...DART_EXTENSIONS,
+    ...PY_EXTENSIONS,
+]);
+// ─── Replace Symbol ─────────────────────────────────────────────────
+/**
+ * Replace the full source code of a named symbol in a file.
+ * Dispatches to the correct language-specific writer.
+ *
+ * @param filePath   - Used to detect language via extension
+ * @param content    - Current file content
+ * @param symbolName - Name of the symbol to replace
+ * @param newContent - Complete replacement code (signature + body)
+ * @param className  - Optional. Scopes search to within a specific class
+ */
+export function replaceSymbol(filePath, content, symbolName, newContent, className) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (TS_EXTENSIONS.has(ext)) {
+        return replaceTSSymbol(content, symbolName, newContent, filePath, className);
+    }
+    if (PHP_EXTENSIONS.has(ext)) {
+        return replacePHPSymbol(content, symbolName, newContent, className);
+    }
+    if (DART_EXTENSIONS.has(ext)) {
+        return replaceDartSymbol(content, symbolName, newContent, className);
+    }
+    if (PY_EXTENSIONS.has(ext)) {
+        return replacePySymbol(content, symbolName, newContent, className);
+    }
+    return {
+        success: false,
+        newContent: content,
+        symbolsAffected: [],
+        error: `Unsupported file type "${ext}" for surgical writing. Supported: TypeScript, JavaScript, PHP, Dart, Python.`,
+    };
+}
+// ─── Insert Code ────────────────────────────────────────────────────
+/**
+ * Insert new code at a precise location relative to an anchor symbol.
+ *
+ * @param filePath     - Used to detect language via extension
+ * @param content      - Current file content
+ * @param code         - The code to insert
+ * @param anchorSymbol - Symbol to position relative to (null = end of file)
+ * @param position     - Where to insert: before, after, inside_start, inside_end
+ * @param className    - Optional. Scopes anchor search to within a specific class
+ */
+export function insertCode(filePath, content, code, anchorSymbol, position, className) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (TS_EXTENSIONS.has(ext)) {
+        return insertTSCode(content, code, anchorSymbol, position, filePath, className);
+    }
+    if (PHP_EXTENSIONS.has(ext)) {
+        return insertPHPCode(content, code, anchorSymbol, position, className);
+    }
+    if (DART_EXTENSIONS.has(ext)) {
+        return insertDartCode(content, code, anchorSymbol, position, className);
+    }
+    if (PY_EXTENSIONS.has(ext)) {
+        return insertPyCode(content, code, anchorSymbol, position, className);
+    }
+    return {
+        success: false,
+        newContent: content,
+        symbolsAffected: [],
+        error: `Unsupported file type "${ext}" for code insertion.`,
+    };
+}
+// ─── Rename Symbol ──────────────────────────────────────────────────
+/**
+ * Rename all occurrences of a symbol within a single file.
+ *
+ * @param filePath - Used to detect language via extension
+ * @param content  - Current file content
+ * @param oldName  - Current symbol name
+ * @param newName  - New symbol name
+ */
+export function renameInFile(filePath, content, oldName, newName) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (TS_EXTENSIONS.has(ext)) {
+        return renameTSSymbol(content, oldName, newName, filePath);
+    }
+    if (PHP_EXTENSIONS.has(ext)) {
+        return renamePHPSymbol(content, oldName, newName);
+    }
+    if (DART_EXTENSIONS.has(ext)) {
+        return renameDartSymbol(content, oldName, newName);
+    }
+    if (PY_EXTENSIONS.has(ext)) {
+        return renamePySymbol(content, oldName, newName);
+    }
+    return {
+        success: false,
+        newContent: content,
+        symbolsAffected: [],
+        error: `Unsupported file type "${ext}" for symbol renaming.`,
+    };
+}
+/**
+ * Renames all whole-word occurrences of a symbol in a file.
+ * UNLIKE renameInFile, this does NOT check for the symbol definition.
+ * Used for updating references in dependent files.
+ */
+export function renameReferencesInFile(filePath, content, oldName, newName) {
+    const ext = path.extname(filePath).toLowerCase();
+    // Simple whole-word replacement is generally safe for cross-file reference updates
+    // where we ALREADY know via import analysis that the file depends on this symbol.
+    // Scape regex special chars
+    const escaped = oldName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    // Use a regex that respects common identifier boundaries across JS/PHP/Dart/Python
+    const regex = new RegExp(`(?<=^|[^a-zA-Z0-9_$])(${escaped})(?=[^a-zA-Z0-9_$]|$)`, "g");
+    if (!regex.test(content)) {
+        return { success: true, newContent: content, symbolsAffected: [] };
+    }
+    const result = content.replace(regex, newName);
+    return {
+        success: true,
+        newContent: result,
+        symbolsAffected: [oldName],
+    };
+}
+// ─── Remove Symbol ──────────────────────────────────────────────────
+/**
+ * Remove a named symbol from a file.
+ *
+ * @param filePath   - Used to detect language via extension
+ * @param content    - Current file content
+ * @param symbolName - Name of the symbol to remove
+ * @param className  - Optional. Scopes search to within a specific class
+ */
+export function removeSymbolFromFile(filePath, content, symbolName, className) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (TS_EXTENSIONS.has(ext)) {
+        return removeTSSymbol(content, symbolName, filePath, className);
+    }
+    if (PHP_EXTENSIONS.has(ext)) {
+        return removePHPSymbol(content, symbolName, className);
+    }
+    if (DART_EXTENSIONS.has(ext)) {
+        return removeDartSymbol(content, symbolName, className);
+    }
+    if (PY_EXTENSIONS.has(ext)) {
+        return removePySymbol(content, symbolName, className);
+    }
+    return {
+        success: false,
+        newContent: content,
+        symbolsAffected: [],
+        error: `Unsupported file type "${ext}" for symbol removal.`,
+    };
+}
+//# sourceMappingURL=symbolWriter.js.map

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

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

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

@@ -0,0 +1,38 @@
+/**
+ * tsWriter.ts — TypeScript / JavaScript Surgical Writer
+ *
+ * Uses ts-morph to perform AST-aware code modifications on TypeScript
+ * and JavaScript files. This is the most robust writer because ts-morph
+ * provides a full read-write AST with source manipulation capabilities.
+ *
+ * Supports: .ts, .tsx, .js, .jsx, .mts, .mjs, .cts, .cjs
+ */
+export interface WriteResult {
+    success: boolean;
+    newContent: string;
+    symbolsAffected: string[];
+    error?: string;
+}
+/**
+ * Replace the full text of a named symbol in a TypeScript/JavaScript file.
+ * The newContent should be the complete replacement (signature + body).
+ * When className is provided, scopes the search to within that class only.
+ */
+export declare function replaceTSSymbol(content: string, symbolName: string, newContent: string, filePath: string, className?: string): WriteResult;
+export type InsertPosition = "before" | "after" | "inside_start" | "inside_end";
+/**
+ * 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 insertTSCode(content: string, code: string, anchorSymbol: string | null, position: InsertPosition, filePath: string, className?: string): WriteResult;
+/**
+ * Rename all occurrences of a symbol within a single TypeScript/JavaScript file.
+ * This performs a smart rename that understands scoping.
+ */
+export declare function renameTSSymbol(content: string, oldName: string, newName: string, filePath: string): WriteResult;
+/**
+ * Remove a named symbol from a TypeScript/JavaScript file.
+ * Returns the file content without the symbol.
+ * When className is provided, scopes the search to within that class only.
+ */
+export declare function removeTSSymbol(content: string, symbolName: string, filePath: string, className?: string): WriteResult;