mcp-code-context 2.1.3

package/dist/tests/writers/test-write-smoke.js

@@ -0,0 +1,346 @@
+/**
+ * test-write-smoke.ts — Smoke Tests for Surgical Writing Tools
+ *
+ * Tests all 4 write operations (replace, insert, rename, remove)
+ * across all 4 supported languages (TypeScript, PHP, Dart, Python).
+ *
+ * Run: npm run build && node dist/tests/writers/test-write-smoke.js
+ */
+import { replaceSymbol, insertCode, renameInFile, removeSymbolFromFile, } from "../../src/ast/writers/symbolWriter.js";
+import { generateDiff } from "../../src/utils/diffEngine.js";
+// ─── Test Harness ───────────────────────────────────────────────────
+let passed = 0;
+let failed = 0;
+function assert(condition, label, detail) {
+    if (condition) {
+        passed++;
+        console.log(`  ✅ ${label}`);
+    }
+    else {
+        failed++;
+        console.error(`  ❌ ${label}`);
+        if (detail)
+            console.error(`     ${detail}`);
+    }
+}
+function section(title) {
+    console.log(`\n━━━ ${title} ━━━`);
+}
+// ─── Test Fixtures ──────────────────────────────────────────────────
+const TS_FIXTURE = `
+import { Something } from "./something.js";
+
+const API_URL = "https://example.com";
+
+export interface UserConfig {
+  name: string;
+  email: string;
+}
+
+export class UserService {
+  private users: Map<string, UserConfig> = new Map();
+
+  getUser(id: string): UserConfig | undefined {
+    return this.users.get(id);
+  }
+
+  addUser(id: string, config: UserConfig): void {
+    this.users.set(id, config);
+  }
+
+  deleteUser(id: string): boolean {
+    return this.users.delete(id);
+  }
+}
+
+export function formatUser(user: UserConfig): string {
+  return \`\${user.name} <\${user.email}>\`;
+}
+`.trim();
+const PHP_FIXTURE = `<?php
+
+namespace App\\Services;
+
+use App\\Models\\User;
+use App\\Contracts\\UserRepositoryInterface;
+
+/**
+ * Manages user operations.
+ */
+class UserService
+{
+    private UserRepositoryInterface $repository;
+
+    public function __construct(UserRepositoryInterface $repository)
+    {
+        $this->repository = $repository;
+    }
+
+    /**
+     * Find a user by ID.
+     */
+    public function findUser(int $id): ?User
+    {
+        return $this->repository->find($id);
+    }
+
+    /**
+     * Create a new user.
+     */
+    public function createUser(array $data): User
+    {
+        return $this->repository->create($data);
+    }
+
+    public function deleteUser(int $id): bool
+    {
+        return $this->repository->delete($id);
+    }
+}
+
+function helperFunction(): string
+{
+    return 'hello';
+}
+`;
+const DART_FIXTURE = `
+import 'package:flutter/material.dart';
+
+/// A service for managing user data.
+class UserService {
+  final Map<String, dynamic> _cache = {};
+
+  /// Gets a user by ID.
+  Future<Map<String, dynamic>?> getUser(String id) async {
+    if (_cache.containsKey(id)) {
+      return _cache[id];
+    }
+    return null;
+  }
+
+  /// Adds a user to the cache.
+  void addUser(String id, Map<String, dynamic> data) {
+    _cache[id] = data;
+  }
+
+  /// Removes a user from the cache.
+  bool removeUser(String id) {
+    return _cache.remove(id) != null;
+  }
+}
+
+/// Formats a user name for display.
+String formatUserName(String first, String last) {
+  return '\$first \$last';
+}
+`.trim();
+const PY_FIXTURE = `
+from typing import Optional, Dict
+
+class UserService:
+    """Manages user operations."""
+
+    def __init__(self):
+        self._users: Dict[str, dict] = {}
+
+    def get_user(self, user_id: str) -> Optional[dict]:
+        """Get a user by ID."""
+        return self._users.get(user_id)
+
+    def add_user(self, user_id: str, data: dict) -> None:
+        """Add a user."""
+        self._users[user_id] = data
+
+    def delete_user(self, user_id: str) -> bool:
+        """Delete a user."""
+        if user_id in self._users:
+            del self._users[user_id]
+            return True
+        return False
+
+
+def format_user(user: dict) -> str:
+    """Format a user for display."""
+    return f"{user['name']} <{user['email']}>"
+`.trim();
+// ─── TypeScript Tests ───────────────────────────────────────────────
+function testTypeScript() {
+    section("TypeScript / JavaScript");
+    // Replace
+    const replaceResult = replaceSymbol("test.ts", TS_FIXTURE, "formatUser", `export function formatUser(user: UserConfig): string {\n  return \`User: \${user.name} (\${user.email})\`;\n}`);
+    assert(replaceResult.success, "Replace: formatUser");
+    assert(replaceResult.newContent.includes("User: ${user.name}"), "Replace: new content is present");
+    assert(replaceResult.newContent.includes("class UserService"), "Replace: other symbols preserved");
+    // Insert
+    const insertResult = insertCode("test.ts", TS_FIXTURE, `export function greetUser(user: UserConfig): string {\n  return \`Hello, \${user.name}!\`;\n}`, "formatUser", "after");
+    assert(insertResult.success, "Insert: after formatUser");
+    assert(insertResult.newContent.includes("greetUser"), "Insert: new function is present");
+    // Insert inside class
+    const insertClassResult = insertCode("test.ts", TS_FIXTURE, `getUserCount(): number {\n  return this.users.size;\n}`, "UserService", "inside_end");
+    assert(insertClassResult.success, "Insert: inside_end of UserService");
+    assert(insertClassResult.newContent.includes("getUserCount"), "Insert: method added to class");
+    // Rename
+    const renameResult = renameInFile("test.ts", TS_FIXTURE, "UserService", "AccountService");
+    assert(renameResult.success, "Rename: UserService → AccountService");
+    assert(renameResult.newContent.includes("class AccountService"), "Rename: class declaration updated");
+    assert(!renameResult.newContent.includes("class UserService"), "Rename: old name removed");
+    // Remove
+    const removeResult = removeSymbolFromFile("test.ts", TS_FIXTURE, "formatUser");
+    assert(removeResult.success, "Remove: formatUser");
+    assert(!removeResult.newContent.includes("function formatUser"), "Remove: function is gone");
+    assert(removeResult.newContent.includes("class UserService"), "Remove: other symbols still exist");
+    // Remove interface
+    const removeIfaceResult = removeSymbolFromFile("test.ts", TS_FIXTURE, "UserConfig");
+    assert(removeIfaceResult.success, "Remove: UserConfig interface");
+    assert(!removeIfaceResult.newContent.includes("interface UserConfig"), "Remove: interface is gone");
+}
+// ─── PHP Tests ──────────────────────────────────────────────────────
+function testPHP() {
+    section("PHP");
+    // Replace
+    const replaceResult = replaceSymbol("test.php", PHP_FIXTURE, "findUser", `    public function findUser(int $id): ?User\n    {\n        $cached = $this->cache->get($id);\n        return $cached ?? $this->repository->find($id);\n    }`);
+    assert(replaceResult.success, "Replace: findUser method");
+    assert(replaceResult.newContent.includes("$cached"), "Replace: new content present");
+    // Insert
+    const insertResult = insertCode("test.php", PHP_FIXTURE, `    public function updateUser(int $id, array $data): User\n    {\n        return $this->repository->update($id, $data);\n    }`, "createUser", "after");
+    assert(insertResult.success, "Insert: after createUser");
+    assert(insertResult.newContent.includes("updateUser"), "Insert: method present");
+    // Rename
+    const renameResult = renameInFile("test.php", PHP_FIXTURE, "UserService", "AccountService");
+    assert(renameResult.success, "Rename: UserService → AccountService");
+    assert(renameResult.newContent.includes("class AccountService"), "Rename: class updated");
+    // Remove
+    const removeResult = removeSymbolFromFile("test.php", PHP_FIXTURE, "helperFunction");
+    assert(removeResult.success, "Remove: helperFunction");
+    assert(!removeResult.newContent.includes("function helperFunction"), "Remove: function gone");
+    assert(removeResult.newContent.includes("class UserService"), "Remove: class preserved");
+}
+// ─── Dart Tests ─────────────────────────────────────────────────────
+function testDart() {
+    section("Dart");
+    // Replace
+    const replaceResult = replaceSymbol("test.dart", DART_FIXTURE, "formatUserName", `String formatUserName(String first, String last) {\n  return '\${last.toUpperCase()}, \$first';\n}`);
+    assert(replaceResult.success, "Replace: formatUserName");
+    assert(replaceResult.newContent.includes("toUpperCase"), "Replace: new content present");
+    // Insert
+    const insertResult = insertCode("test.dart", DART_FIXTURE, `/// Checks if a user exists.\nbool userExists(String id) {\n  return false;\n}`, "formatUserName", "after");
+    assert(insertResult.success, "Insert: after formatUserName");
+    assert(insertResult.newContent.includes("userExists"), "Insert: function present");
+    // Insert inside class
+    const insertClassResult = insertCode("test.dart", DART_FIXTURE, `  /// Clears the entire cache.\n  void clearCache() {\n    _cache.clear();\n  }`, "UserService", "inside_end");
+    assert(insertClassResult.success, "Insert: inside_end of UserService");
+    assert(insertClassResult.newContent.includes("clearCache"), "Insert: method in class");
+    // Rename
+    const renameResult = renameInFile("test.dart", DART_FIXTURE, "UserService", "ProfileService");
+    assert(renameResult.success, "Rename: UserService → ProfileService");
+    assert(renameResult.newContent.includes("class ProfileService"), "Rename: class updated");
+    // Remove
+    const removeResult = removeSymbolFromFile("test.dart", DART_FIXTURE, "formatUserName");
+    assert(removeResult.success, "Remove: formatUserName");
+    assert(!removeResult.newContent.includes("formatUserName"), "Remove: function gone");
+    assert(removeResult.newContent.includes("class UserService"), "Remove: class preserved");
+}
+// ─── Python Tests ───────────────────────────────────────────────────
+function testPython() {
+    section("Python");
+    // Replace
+    const replaceResult = replaceSymbol("test.py", PY_FIXTURE, "format_user", `def format_user(user: dict) -> str:\n    """Format a user for display with title."""\n    name = user['name'].title()\n    return f"{name} <{user['email']}>"`);
+    assert(replaceResult.success, "Replace: format_user");
+    assert(replaceResult.newContent.includes(".title()"), "Replace: new content present");
+    // Insert
+    const insertResult = insertCode("test.py", PY_FIXTURE, `def validate_email(email: str) -> bool:\n    """Check if email is valid."""\n    return "@" in email and "." in email`, "format_user", "after");
+    assert(insertResult.success, "Insert: after format_user");
+    assert(insertResult.newContent.includes("validate_email"), "Insert: function present");
+    // Rename
+    const renameResult = renameInFile("test.py", PY_FIXTURE, "UserService", "AccountService");
+    assert(renameResult.success, "Rename: UserService → AccountService");
+    assert(renameResult.newContent.includes("class AccountService"), "Rename: class updated");
+    // Remove
+    const removeResult = removeSymbolFromFile("test.py", PY_FIXTURE, "format_user");
+    assert(removeResult.success, "Remove: format_user");
+    assert(!removeResult.newContent.includes("def format_user"), "Remove: function gone");
+    assert(removeResult.newContent.includes("class UserService"), "Remove: class preserved");
+}
+// ─── Class Name Filtering Tests ───────────────────────────────────────
+function testClassName() {
+    section("ClassName Disambiguation");
+    const DART_MULTI_CLASS = `
+class ClassA {
+  void build() {
+    print('A');
+  }
+}
+
+class ClassB {
+  void build() {
+    print('B');
+  }
+}
+  `;
+    // Try to remove "build" from ClassB
+    const removeResult = removeSymbolFromFile("test_multi.dart", DART_MULTI_CLASS, "build", "ClassB");
+    assert(removeResult.success, "ClassName Remove: build from ClassB");
+    assert(removeResult.newContent.includes("print('A');"), "ClassName Remove: ClassA build preserved");
+    assert(!removeResult.newContent.includes("print('B');"), "ClassName Remove: ClassB build removed");
+    const PY_MULTI_CLASS = `
+class ClassA:
+    def execute(self):
+        return 'A'
+
+class ClassB:
+    def execute(self):
+        return 'B'
+  `;
+    const replaceResult = replaceSymbol("test_multi.py", PY_MULTI_CLASS, "execute", "    def execute(self):\n        return 'C'", "ClassB");
+    assert(replaceResult.success, "ClassName Replace: execute in ClassB");
+    assert(replaceResult.newContent.includes("return 'A'"), "ClassName Replace: ClassA execute preserved");
+    assert(replaceResult.newContent.includes("return 'C'"), "ClassName Replace: ClassB execute updated");
+    assert(!replaceResult.newContent.includes("return 'B'"), "ClassName Replace: ClassB execute old content removed");
+}
+// ─── Diff Engine Tests ──────────────────────────────────────────────
+function testDiffEngine() {
+    section("Diff Engine");
+    const oldContent = "line1\nline2\nline3\nline4\nline5";
+    const newContent = "line1\nline2_modified\nline3\nline4\nline5\nline6_added";
+    const diff = generateDiff(oldContent, newContent, "test.txt");
+    assert(diff.includes("---"), "Diff: has header");
+    assert(diff.includes("+++"), "Diff: has header (new)");
+    assert(diff.includes("-line2"), "Diff: shows removal");
+    assert(diff.includes("+line2_modified"), "Diff: shows addition");
+    assert(diff.includes("+line6_added"), "Diff: shows appended line");
+    // No-change diff
+    const noDiff = generateDiff("same", "same", "noop.txt");
+    assert(noDiff.includes("no changes"), "Diff: no-change case handled");
+}
+// ─── Unsupported Language Tests ─────────────────────────────────────
+function testUnsupported() {
+    section("Unsupported Languages (Graceful Failures)");
+    const result = replaceSymbol("test.rs", "fn main() {}", "main", "fn main() { println!(\"hi\"); }");
+    assert(!result.success, "Unsupported: Rust returns failure");
+    assert(result.error?.includes("Unsupported") ?? false, "Unsupported: error message is descriptive");
+}
+// ─── Run All ────────────────────────────────────────────────────────
+async function main() {
+    console.log("🔬 Surgical Writing Tools — Smoke Tests\n");
+    testTypeScript();
+    testPHP();
+    testDart();
+    testPython();
+    testClassName();
+    testDiffEngine();
+    testUnsupported();
+    console.log(`\n${"═".repeat(50)}`);
+    console.log(`📊 Results: ${passed} passed, ${failed} failed (${passed + failed} total)`);
+    if (failed > 0) {
+        console.error(`\n❌ ${failed} test(s) FAILED`);
+        process.exit(1);
+    }
+    else {
+        console.log(`\n✅ All tests passed!`);
+    }
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=test-write-smoke.js.map

package/dist/tests/writers/test-write-smoke.js.map

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

package/llms.txt

@@ -0,0 +1,164 @@
+# mcp-code-context
+
+> A Model Context Protocol (MCP) server that compresses any code repository into LLM-ready semantic context and provides surgical code editing tools.
+
+## What This Tool Does
+
+This MCP server solves two problems:
+1. **Token bloat on reads**: When an LLM needs to understand a large codebase, sending raw source files wastes most of the context window. This server extracts only structural signatures.
+2. **Imprecise writes**: When an LLM needs to edit code, rewriting entire files is error-prone and expensive. This server enables symbol-level surgical edits.
+
+## Available Tools
+
+### Read Tools
+
+#### 1. `get_semantic_repo_map`
+**Purpose:** Generate a compressed architectural map of an entire repository.
+
+**Input:**
+- `directoryPath` (required): Absolute path to the repository root.
+- `format` (optional): `"xml"` (default) or `"markdown"`.
+
+**What it does:**
+- Walks the directory tree respecting `.gitignore` and `.repomixignore` rules.
+- Always excludes `node_modules`, `dist`, `build`, `vendor`, `.git`.
+- For TypeScript/JavaScript: Uses AST parsing (ts-morph) to extract only function signatures, class structures, interfaces, types, and enums.
+- For PHP: Uses AST parsing (php-parser) to extract namespaces, classes, interfaces, traits, enums, methods, properties, and docblocks.
+- For Dart: Uses brace-counting + regex engine to extract classes, mixins, extensions, enums, methods, and fields.
+- For Python: Uses regex-based extraction to capture class/function signatures and docstrings.
+- For other files: Returns content as-is if small, or a truncated preview if large.
+
+**Best used when:** You need to understand the architecture of a project before diving into specific files.
+
+#### 2. `read_file_surgical`
+**Purpose:** Read a full file or extract only a specific named symbol.
+
+**Input:**
+- `filePath` (required): Absolute path to the source file.
+- `symbolName` (optional): Name of a function, class, interface, method, or type to extract.
+
+**What it does:**
+- With `symbolName`: Parses the AST and returns only the full source code block for that symbol. Saves tokens when you only need one function from a large file.
+- If missing: Returns structured JSON with `available_symbols` and `suggestions` (e.g., suggesting a `className` scope).
+
+**Best used when:** You identified a symbol from the repo map and need to see its full implementation.
+
+#### 3. `analyze_impact`
+**Purpose:** Find all files that depend on a given file.
+
+**Input:**
+- `filePath` (required): Absolute path to the file being modified.
+- `rootDir` (optional): Repository root. Auto-detected if omitted.
+
+**What it does:**
+- Scans all source files for `import`, `require()`, Python `from/import`, PHP `use`/`require_once`/`include`, and Dart `import` statements.
+- Resolves relative paths to determine if they point to the target file.
+- Returns a structured report listing every dependent file and the specific import statement.
+
+**Best used when:** You're about to modify a file and need to understand the blast radius.
+
+#### 4. `rollback_file`
+**Purpose:** Restores a file to a previous state from the automated backup system.
+**Input:**
+- `filePath` (required): Absolute path.
+- `steps` (optional): Number of versions to go back (1-5, default: 1).
+**What it does:** Reverts the file to the state it was in before the last 1-5 modifications.
+
+### Write Tools (v2.1.3 Mandatory Workflow)
+
+All write tools follow a **Two-Phase Workflow**:
+1. **Phase 1 (Preview)**: Call without a token to get a unified `diff` and a `confirmationToken`.
+2. **Phase 2 (Apply)**: Call with `confirmationToken` and `confirm: true` to apply the changes.
+
+**Important Notes (v2.1.3):**
+- ✅ **Windows CRLF Support**: Fully resolved. All operations work correctly on Windows files with CRLF line endings.
+- ✅ **Parameter Brace Handling**: Methods with braces in parameters (e.g., `{int? cart}`) are now handled correctly.
+
+#### 5. `write_file_surgical`
+**Purpose:** Replace the full source code of a named symbol in a file.
+
+**Input:**
+- `filePath` (required): Absolute path to the file to modify.
+- `symbolName` (required): Name of the symbol to replace.
+- `newContent` (required): Complete replacement code (signature + body).
+- `confirmationToken` (optional): Token from Phase 1.
+- `confirm` (optional): Set to `true` to apply.
+- `className` (optional): Scope the symbol to a specific class.
+
+**What it does:**
+- Locates the symbol via AST parsing (ts-morph, php-parser, brace-counting, or indentation detection).
+- Replaces only that symbol's code, preserving all other file contents.
+- Returns a unified diff showing exactly what changed.
+- Validates the result is syntactically valid before writing.
+
+**Best used when:** You need to modify a specific function or method without touching the rest of the file.
+
+#### 5. `insert_symbol`
+**Purpose:** Insert new code at a precise location relative to an existing symbol.
+
+**Input:**
+- `filePath` (required): Absolute path to the file.
+- `code` (required): The new code to insert.
+- `anchorSymbol` (optional): Symbol name to position relative to. If omitted, inserts at end of file.
+- `position` (optional): `"before"`, `"after"`, `"inside_start"`, `"inside_end"`. Defaults to `"after"`.
+- `confirmationToken`, `confirm` (optional): Standard Phase 2 parameters.
+
+**What it does:**
+- Finds the anchor symbol and inserts new code at the specified position.
+- Automatically matches the surrounding indentation style.
+- `inside_start` and `inside_end` insert as members inside a class or interface.
+
+**Best used when:** Adding new methods to a class or new functions to a module.
+
+#### 6. `rename_symbol`
+**Purpose:** Rename a symbol across an entire repository.
+
+**Input:**
+- `filePath` (required): File where the symbol is defined.
+- `oldName` (required): Current name.
+- `newName` (required): New name.
+- `rootDir` (optional): Repository root. Auto-detected if omitted.
+- `confirmationToken`, `confirm` (optional): Standard Phase 2 parameters.
+
+**What it does:**
+- Renames the symbol definition in the source file.
+- Finds all dependent files using import analysis.
+- Renames all references in dependent files using whole-word replacement.
+- Returns a multi-file diff showing all changes.
+- Rolls back all changes if any file write fails.
+
+**Best used when:** Refactoring a class, function, or method name that is used across multiple files.
+
+#### 7. `remove_symbol`
+**Purpose:** Safely remove a symbol from a file.
+
+**Input:**
+- `filePath` (required): Absolute path.
+- `symbolName` (required): Symbol to remove.
+- `force` (optional): If true, skip dependency check. Defaults to false.
+- `confirmationToken`, `confirm` (optional): Standard Phase 2 parameters.
+
+**What it does:**
+- Checks if other files reference the symbol (unless `force: true`).
+- If dependents exist, refuses to remove and reports which files use it.
+- If safe, removes the symbol's code and cleans up whitespace.
+
+**Best used when:** Cleaning up deprecated functions or unused code.
+
+## Recommended Workflow
+
+1. **Start with `get_semantic_repo_map`** to understand the project structure.
+2. **Use `read_file_surgical`** with a symbol name. Use suggestions if the symbol is missing.
+3. **Before modifying, run `analyze_impact`** to know the blast radius.
+4. **Phase 1: Preview Edit** → Call write tools to get a `diff` and `confirmationToken`.
+5. **Phase 2: Apply Edit** → Verify the diff, then call with the token and `confirm: true`.
+6. **Recovery** → Use `rollback_file` if needed.
+
+## Technical Details
+
+- **Transport:** stdio (JSON-RPC over stdin/stdout)
+- **Runtime:** Node.js >= 18
+- **AST Engines:** ts-morph (TypeScript/JS), php-parser (PHP), brace-counting/regex (Dart, Python)
+- **Ignore Engine:** `ignore` npm package (full .gitignore spec support)
+- **Supported languages:** TypeScript, JavaScript (all variants), PHP, Dart, Python
+- **Safety features:** Mandatory two-phase confirmation, rolling 5-version backups (`.mcp-backups/`), fuzzy symbol suggestions, dependency tracking, surgical restoration.

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "mcp-code-context",
+  "version": "2.1.3",
+  "description": "Powerful MCP server for LLM-ready semantic code context and surgical AST-aware editing. Supports TypeScript, JavaScript, PHP, Dart, and Python.",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "bin": {
+    "mcp-code-context": "dist/src/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/src/index.js",
+    "dev": "tsc && node dist/src/index.js",
+    "test": "npm run build && node dist/tests/test-dart.js && node dist/tests/test-php.js && node dist/tests/writers/test-write-smoke.js",
+    "clean": "rimraf dist",
+    "rebuild": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "semantic-compression",
+    "llm",
+    "code-analysis",
+    "ast",
+    "repository-map",
+    "claude",
+    "cursor",
+    "windsurf",
+    "copilot",
+    "amazon-q",
+    "code-context",
+    "typescript",
+    "php",
+    "dart",
+    "python"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/achatainga/mcp-code-context.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "ignore": "^6.0.2",
+    "php-parser": "^3.5.1",
+    "ts-morph": "^24.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}