tidewave 0.1.0

package/dist/mcp.js

@@ -0,0 +1,1151 @@
+// src/resolution/index.ts
+import ts5 from "typescript";
+
+// node:path
+var L = Object.create;
+var h = Object.defineProperty;
+var D = Object.getOwnPropertyDescriptor;
+var T = Object.getOwnPropertyNames;
+var _ = Object.getPrototypeOf;
+var E = Object.prototype.hasOwnProperty;
+var R = (s, e) => () => (e || s((e = { exports: {} }).exports, e), e.exports);
+var N = (s, e, r, t) => {
+  if (e && typeof e == "object" || typeof e == "function")
+    for (let i of T(e))
+      !E.call(s, i) && i !== r && h(s, i, { get: () => e[i], enumerable: !(t = D(e, i)) || t.enumerable });
+  return s;
+};
+var j = (s, e, r) => (r = s != null ? L(_(s)) : {}, N(e || !s || !s.__esModule ? h(r, "default", { value: s, enumerable: true }) : r, s));
+var k = R((W, w) => {
+  function v(s) {
+    if (typeof s != "string")
+      throw new TypeError("Path must be a string. Received " + JSON.stringify(s));
+  }
+  function C(s, e) {
+    for (var r = "", t = 0, i = -1, a = 0, n, l = 0;l <= s.length; ++l) {
+      if (l < s.length)
+        n = s.charCodeAt(l);
+      else {
+        if (n === 47)
+          break;
+        n = 47;
+      }
+      if (n === 47) {
+        if (!(i === l - 1 || a === 1))
+          if (i !== l - 1 && a === 2) {
+            if (r.length < 2 || t !== 2 || r.charCodeAt(r.length - 1) !== 46 || r.charCodeAt(r.length - 2) !== 46) {
+              if (r.length > 2) {
+                var f = r.lastIndexOf("/");
+                if (f !== r.length - 1) {
+                  f === -1 ? (r = "", t = 0) : (r = r.slice(0, f), t = r.length - 1 - r.lastIndexOf("/")), i = l, a = 0;
+                  continue;
+                }
+              } else if (r.length === 2 || r.length === 1) {
+                r = "", t = 0, i = l, a = 0;
+                continue;
+              }
+            }
+            e && (r.length > 0 ? r += "/.." : r = "..", t = 2);
+          } else
+            r.length > 0 ? r += "/" + s.slice(i + 1, l) : r = s.slice(i + 1, l), t = l - i - 1;
+        i = l, a = 0;
+      } else
+        n === 46 && a !== -1 ? ++a : a = -1;
+    }
+    return r;
+  }
+  function F(s, e) {
+    var r = e.dir || e.root, t = e.base || (e.name || "") + (e.ext || "");
+    return r ? r === e.root ? r + t : r + s + t : t;
+  }
+  var m = { resolve: function() {
+    for (var e = "", r = false, t, i = arguments.length - 1;i >= -1 && !r; i--) {
+      var a;
+      i >= 0 ? a = arguments[i] : (t === undefined && (t = process.cwd()), a = t), v(a), a.length !== 0 && (e = a + "/" + e, r = a.charCodeAt(0) === 47);
+    }
+    return e = C(e, !r), r ? e.length > 0 ? "/" + e : "/" : e.length > 0 ? e : ".";
+  }, normalize: function(e) {
+    if (v(e), e.length === 0)
+      return ".";
+    var r = e.charCodeAt(0) === 47, t = e.charCodeAt(e.length - 1) === 47;
+    return e = C(e, !r), e.length === 0 && !r && (e = "."), e.length > 0 && t && (e += "/"), r ? "/" + e : e;
+  }, isAbsolute: function(e) {
+    return v(e), e.length > 0 && e.charCodeAt(0) === 47;
+  }, join: function() {
+    if (arguments.length === 0)
+      return ".";
+    for (var e, r = 0;r < arguments.length; ++r) {
+      var t = arguments[r];
+      v(t), t.length > 0 && (e === undefined ? e = t : e += "/" + t);
+    }
+    return e === undefined ? "." : m.normalize(e);
+  }, relative: function(e, r) {
+    if (v(e), v(r), e === r || (e = m.resolve(e), r = m.resolve(r), e === r))
+      return "";
+    for (var t = 1;t < e.length && e.charCodeAt(t) === 47; ++t)
+      ;
+    for (var i = e.length, a = i - t, n = 1;n < r.length && r.charCodeAt(n) === 47; ++n)
+      ;
+    for (var l = r.length, f = l - n, c = a < f ? a : f, d = -1, o = 0;o <= c; ++o) {
+      if (o === c) {
+        if (f > c) {
+          if (r.charCodeAt(n + o) === 47)
+            return r.slice(n + o + 1);
+          if (o === 0)
+            return r.slice(n + o);
+        } else
+          a > c && (e.charCodeAt(t + o) === 47 ? d = o : o === 0 && (d = 0));
+        break;
+      }
+      var A = e.charCodeAt(t + o), z = r.charCodeAt(n + o);
+      if (A !== z)
+        break;
+      A === 47 && (d = o);
+    }
+    var b = "";
+    for (o = t + d + 1;o <= i; ++o)
+      (o === i || e.charCodeAt(o) === 47) && (b.length === 0 ? b += ".." : b += "/..");
+    return b.length > 0 ? b + r.slice(n + d) : (n += d, r.charCodeAt(n) === 47 && ++n, r.slice(n));
+  }, _makeLong: function(e) {
+    return e;
+  }, dirname: function(e) {
+    if (v(e), e.length === 0)
+      return ".";
+    for (var r = e.charCodeAt(0), t = r === 47, i = -1, a = true, n = e.length - 1;n >= 1; --n)
+      if (r = e.charCodeAt(n), r === 47) {
+        if (!a) {
+          i = n;
+          break;
+        }
+      } else
+        a = false;
+    return i === -1 ? t ? "/" : "." : t && i === 1 ? "//" : e.slice(0, i);
+  }, basename: function(e, r) {
+    if (r !== undefined && typeof r != "string")
+      throw new TypeError('"ext" argument must be a string');
+    v(e);
+    var t = 0, i = -1, a = true, n;
+    if (r !== undefined && r.length > 0 && r.length <= e.length) {
+      if (r.length === e.length && r === e)
+        return "";
+      var l = r.length - 1, f = -1;
+      for (n = e.length - 1;n >= 0; --n) {
+        var c = e.charCodeAt(n);
+        if (c === 47) {
+          if (!a) {
+            t = n + 1;
+            break;
+          }
+        } else
+          f === -1 && (a = false, f = n + 1), l >= 0 && (c === r.charCodeAt(l) ? --l === -1 && (i = n) : (l = -1, i = f));
+      }
+      return t === i ? i = f : i === -1 && (i = e.length), e.slice(t, i);
+    } else {
+      for (n = e.length - 1;n >= 0; --n)
+        if (e.charCodeAt(n) === 47) {
+          if (!a) {
+            t = n + 1;
+            break;
+          }
+        } else
+          i === -1 && (a = false, i = n + 1);
+      return i === -1 ? "" : e.slice(t, i);
+    }
+  }, extname: function(e) {
+    v(e);
+    for (var r = -1, t = 0, i = -1, a = true, n = 0, l = e.length - 1;l >= 0; --l) {
+      var f = e.charCodeAt(l);
+      if (f === 47) {
+        if (!a) {
+          t = l + 1;
+          break;
+        }
+        continue;
+      }
+      i === -1 && (a = false, i = l + 1), f === 46 ? r === -1 ? r = l : n !== 1 && (n = 1) : r !== -1 && (n = -1);
+    }
+    return r === -1 || i === -1 || n === 0 || n === 1 && r === i - 1 && r === t + 1 ? "" : e.slice(r, i);
+  }, format: function(e) {
+    if (e === null || typeof e != "object")
+      throw new TypeError('The "pathObject" argument must be of type Object. Received type ' + typeof e);
+    return F("/", e);
+  }, parse: function(e) {
+    v(e);
+    var r = { root: "", dir: "", base: "", ext: "", name: "" };
+    if (e.length === 0)
+      return r;
+    var t = e.charCodeAt(0), i = t === 47, a;
+    i ? (r.root = "/", a = 1) : a = 0;
+    for (var n = -1, l = 0, f = -1, c = true, d = e.length - 1, o = 0;d >= a; --d) {
+      if (t = e.charCodeAt(d), t === 47) {
+        if (!c) {
+          l = d + 1;
+          break;
+        }
+        continue;
+      }
+      f === -1 && (c = false, f = d + 1), t === 46 ? n === -1 ? n = d : o !== 1 && (o = 1) : n !== -1 && (o = -1);
+    }
+    return n === -1 || f === -1 || o === 0 || o === 1 && n === f - 1 && n === l + 1 ? f !== -1 && (l === 0 && i ? r.base = r.name = e.slice(1, f) : r.base = r.name = e.slice(l, f)) : (l === 0 && i ? (r.name = e.slice(1, n), r.base = e.slice(1, f)) : (r.name = e.slice(l, n), r.base = e.slice(l, f)), r.ext = e.slice(n, f)), l > 0 ? r.dir = e.slice(0, l - 1) : i && (r.dir = "/"), r;
+  }, sep: "/", delimiter: ":", win32: null, posix: null };
+  m.posix = m;
+  w.exports = m;
+});
+var x = j(k());
+var u = x;
+var J = x;
+var P = function(s) {
+  return s;
+};
+var S = function() {
+  throw new Error("Not implemented");
+};
+u.parse ??= S;
+J.parse ??= S;
+var g = { resolve: u.resolve.bind(u), normalize: u.normalize.bind(u), isAbsolute: u.isAbsolute.bind(u), join: u.join.bind(u), relative: u.relative.bind(u), toNamespacedPath: P, dirname: u.dirname.bind(u), basename: u.basename.bind(u), extname: u.extname.bind(u), format: u.format.bind(u), parse: u.parse.bind(u), sep: "/", delimiter: ":", win32: undefined, posix: undefined, _makeLong: P };
+var y = { sep: "\\", delimiter: ";", win32: undefined, ...g, posix: g };
+g.win32 = y.win32 = y;
+g.posix = g;
+var q = g;
+
+// src/core.ts
+function isError(result) {
+  return result != null && "success" in result && result.success === false;
+}
+function isResolveError(result) {
+  return result != null && "success" in result && result.success === false;
+}
+function isExtractError(result) {
+  return result != null && "error" in result;
+}
+function resolveError(specifier, source) {
+  return {
+    success: false,
+    error: {
+      code: "MODULE_NOT_FOUND",
+      message: `Cannot resolve module '${specifier}' from '${source}'`
+    }
+  };
+}
+function createExtractError(code, message, details) {
+  return {
+    error: {
+      code,
+      message,
+      details
+    }
+  };
+}
+
+// src/resolution/module-resolver.ts
+import ts from "typescript";
+function loadTsConfig(prefix) {
+  const projectPath = prefix || process.cwd();
+  const configPath = ts.findConfigFile(projectPath, ts.sys.fileExists, "tsconfig.json");
+  let compilerOptions = {
+    target: ts.ScriptTarget.ES2020,
+    module: ts.ModuleKind.CommonJS,
+    moduleResolution: ts.ModuleResolutionKind.Bundler,
+    esModuleInterop: true,
+    allowSyntheticDefaultImports: true,
+    skipLibCheck: true,
+    allowJs: true,
+    declaration: true,
+    typeRoots: ["./node_modules/@types"],
+    baseUrl: "."
+  };
+  let rootNames = [];
+  if (configPath) {
+    const configFile = ts.readConfigFile(configPath, ts.sys.readFile);
+    if (configFile.config) {
+      const parsedConfig = ts.parseJsonConfigFileContent(configFile.config, ts.sys, q.dirname(configPath));
+      compilerOptions = { ...compilerOptions, ...parsedConfig.options };
+      rootNames = parsedConfig.fileNames;
+    }
+  }
+  return {
+    fileNames: rootNames,
+    options: compilerOptions
+  };
+}
+function resolveModule(moduleName, compilerOptions) {
+  if (moduleName.startsWith("./") || moduleName.startsWith("../") || moduleName.includes(".") && !moduleName.includes("/")) {
+    const absolutePath = q.resolve(moduleName);
+    if (ts.sys.fileExists(absolutePath)) {
+      const dedicatedProgram = ts.createProgram([absolutePath], compilerOptions);
+      const sourceFile = dedicatedProgram.getSourceFile(absolutePath);
+      if (sourceFile) {
+        return { sourceFile, program: dedicatedProgram };
+      }
+    }
+  }
+  const moduleResolver = ts.resolveModuleName(moduleName, q.resolve("./index.ts"), compilerOptions, ts.sys);
+  if (moduleResolver.resolvedModule) {
+    const { resolvedFileName } = moduleResolver.resolvedModule;
+    const dedicatedProgram = ts.createProgram([resolvedFileName], compilerOptions);
+    const sourceFile = dedicatedProgram.getSourceFile(resolvedFileName);
+    if (sourceFile) {
+      return { sourceFile, program: dedicatedProgram };
+    }
+  }
+  return resolveError(moduleName, process.cwd());
+}
+function resolveNodeBuiltin(moduleName, compilerOptions) {
+  if (!moduleName.startsWith("node:")) {
+    return resolveError(moduleName, process.cwd());
+  }
+  const symbolName = moduleName.slice(5);
+  const globalBuiltins = [
+    "Math",
+    "Date",
+    "JSON",
+    "Object",
+    "Array",
+    "String",
+    "Number",
+    "Boolean",
+    "RegExp",
+    "Function",
+    "Promise",
+    "Map",
+    "Set",
+    "WeakMap",
+    "WeakSet",
+    "Symbol",
+    "Error",
+    "console",
+    "process",
+    "Buffer",
+    "global",
+    "__dirname",
+    "__filename"
+  ];
+  if (globalBuiltins.includes(symbolName)) {
+    const syntheticContent = `declare const ${symbolName}: typeof globalThis.${symbolName};`;
+    const syntheticFileName = `synthetic-global-${symbolName}.d.ts`;
+    const host = ts.createCompilerHost(compilerOptions);
+    const originalGetSourceFile = host.getSourceFile;
+    host.getSourceFile = (fileName, languageVersion, onError, shouldCreateNewSourceFile) => {
+      if (fileName === syntheticFileName) {
+        return ts.createSourceFile(fileName, syntheticContent, ts.ScriptTarget.Latest, true);
+      }
+      return originalGetSourceFile(fileName, languageVersion, onError, shouldCreateNewSourceFile);
+    };
+    const dedicatedProgram = ts.createProgram([syntheticFileName], compilerOptions, host);
+    const sourceFile = dedicatedProgram.getSourceFile(syntheticFileName);
+    if (sourceFile) {
+      return { sourceFile, program: dedicatedProgram };
+    }
+  }
+  return resolveError(moduleName, process.cwd());
+}
+
+// src/resolution/symbol-finder.ts
+import ts4 from "typescript";
+
+// src/resolution/utils.ts
+import ts2 from "typescript";
+function getLocation(symbol) {
+  if (symbol.valueDeclaration) {
+    const sourceFile = symbol.valueDeclaration.getSourceFile();
+    const { line, character } = sourceFile.getLineAndCharacterOfPosition(symbol.valueDeclaration.getStart());
+    let { fileName } = sourceFile;
+    const cwd = process.cwd();
+    if (fileName.startsWith(cwd)) {
+      fileName = q.relative(cwd, fileName);
+    }
+    return `${fileName}:${line + 1}:${character + 1}`;
+  }
+  if (symbol.declarations && symbol.declarations.length > 0) {
+    const [firstDeclaration] = symbol.declarations;
+    const sourceFile = firstDeclaration?.getSourceFile();
+    if (sourceFile === undefined || firstDeclaration === undefined)
+      return "unknown";
+    const { line, character } = sourceFile.getLineAndCharacterOfPosition(firstDeclaration.getStart());
+    let fileName = sourceFile?.fileName;
+    const cwd = process.cwd();
+    if (fileName?.startsWith(cwd)) {
+      fileName = q.relative(cwd, fileName);
+    }
+    return `${fileName}:${line + 1}:${character + 1}`;
+  }
+  return "unknown";
+}
+function getDocumentation(checker, symbol) {
+  return ts2.displayPartsToString(symbol.getDocumentationComment(checker));
+}
+function getJSDoc(checker, symbol) {
+  const jsDocTags = symbol.getJsDocTags(checker);
+  return jsDocTags.map((tag) => {
+    const tagName = tag.name;
+    const tagText = tag.text ? ts2.displayPartsToString(tag.text) : "";
+    return `@${tagName}${tagText ? " " + tagText : ""}`;
+  }).join(`
+`);
+}
+function getSymbolKind(symbol) {
+  const flags = symbol.getFlags();
+  if (flags & ts2.SymbolFlags.Function)
+    return "function";
+  if (flags & ts2.SymbolFlags.Class)
+    return "class";
+  if (flags & ts2.SymbolFlags.Interface)
+    return "interface";
+  if (flags & ts2.SymbolFlags.TypeAlias)
+    return "type";
+  if (flags & ts2.SymbolFlags.Variable)
+    return "variable";
+  if (flags & ts2.SymbolFlags.Property)
+    return "property";
+  if (flags & ts2.SymbolFlags.Method)
+    return "method";
+  if (flags & ts2.SymbolFlags.Enum)
+    return "enum";
+  if (flags & ts2.SymbolFlags.Module)
+    return "module";
+  if (symbol.valueDeclaration) {
+    if (ts2.isFunctionDeclaration(symbol.valueDeclaration)) {
+      return "function";
+    }
+    if (ts2.isClassDeclaration(symbol.valueDeclaration)) {
+      return "class";
+    }
+    if (ts2.isVariableDeclaration(symbol.valueDeclaration)) {
+      return "variable";
+    }
+    if (ts2.isMethodDeclaration(symbol.valueDeclaration)) {
+      return "method";
+    }
+  }
+  return "unknown";
+}
+
+// src/resolution/formatters.ts
+import ts3 from "typescript";
+function getSignature(checker, symbol, type) {
+  const signatures = checker.getSignaturesOfType(type, ts3.SignatureKind.Call);
+  if (signatures.length > 0) {
+    return signatures.map((sig) => {
+      const sigString = checker.signatureToString(sig);
+      return `${symbol.getName()}${sigString}`;
+    }).join(`
+`);
+  }
+  const constructSignatures = checker.getSignaturesOfType(type, ts3.SignatureKind.Construct);
+  if (constructSignatures.length > 0) {
+    return constructSignatures.map((sig) => "new " + checker.signatureToString(sig)).join(`
+`);
+  }
+  if (symbol.valueDeclaration || symbol.declarations && symbol.declarations.length > 0) {
+    const declaration = symbol.valueDeclaration || symbol.declarations[0];
+    if (!declaration)
+      return checker.typeToString(type);
+    const sourceFile = declaration.getSourceFile();
+    if (ts3.isFunctionDeclaration(declaration) && declaration.name) {
+      const functionType = checker.getTypeOfSymbolAtLocation(symbol, declaration);
+      const functionSignatures = checker.getSignaturesOfType(functionType, ts3.SignatureKind.Call);
+      if (functionSignatures.length > 0) {
+        return functionSignatures.map((sig) => checker.signatureToString(sig)).join(`
+`);
+      }
+    }
+    if (ts3.isInterfaceDeclaration(declaration) || ts3.isTypeAliasDeclaration(declaration)) {
+      const start2 = declaration.getStart();
+      const end2 = declaration.getEnd();
+      const text2 = sourceFile.text.substring(start2, end2);
+      const lines = text2.split(`
+`).map((line) => line.trim()).filter((line) => line.length > 0);
+      if (ts3.isInterfaceDeclaration(declaration)) {
+        const bodyStart = text2.indexOf("{");
+        const bodyEnd = text2.lastIndexOf("}");
+        if (bodyStart !== -1 && bodyEnd !== -1) {
+          const body = text2.substring(bodyStart, bodyEnd + 1);
+          const interfaceName = `interface ${declaration.name.text}`;
+          const compactBody = body.replace(/\s*\n\s*/g, " ").replace(/\s+/g, " ");
+          return `${interfaceName} ${compactBody}`;
+        }
+      }
+      return lines.join(" ").replace(/\s+/g, " ");
+    }
+    if (ts3.isClassDeclaration(declaration)) {
+      const classType = checker.getTypeOfSymbolAtLocation(symbol, declaration);
+      const classConstructSignatures = checker.getSignaturesOfType(classType, ts3.SignatureKind.Construct);
+      if (classConstructSignatures.length > 0) {
+        return classConstructSignatures.map((sig) => "new " + checker.signatureToString(sig)).join(`
+`);
+      } else {
+        const start2 = declaration.getStart();
+        const end2 = Math.min(declaration.getStart() + 100, declaration.getEnd());
+        const text2 = sourceFile.text.substring(start2, end2);
+        return text2.split(`
+`)[0]?.trim() + (text2.includes(`
+`) ? "..." : "") || "";
+      }
+    }
+    const start = declaration.getStart();
+    const end = Math.min(declaration.getStart() + 100, declaration.getEnd());
+    const text = sourceFile.text.substring(start, end);
+    return text.split(`
+`)[0]?.trim() + (text.includes(`
+`) ? "..." : "") || "";
+  }
+  return checker.typeToString(type);
+}
+function getTypeString(checker, symbol, type) {
+  if (symbol.flags & (ts3.SymbolFlags.Interface | ts3.SymbolFlags.TypeAlias)) {
+    const declaration = symbol.valueDeclaration || symbol.declarations && symbol.declarations[0];
+    if (declaration && ts3.isInterfaceDeclaration(declaration)) {
+      const properties = type.getProperties();
+      if (properties.length > 0) {
+        const propertyStrings = properties.map((prop) => {
+          const propDeclaration = prop.valueDeclaration || prop.declarations && prop.declarations[0];
+          const propType = propDeclaration ? checker.getTypeOfSymbolAtLocation(prop, propDeclaration) : checker.getTypeAtLocation(prop.declarations[0]);
+          const propTypeString = checker.typeToString(propType);
+          const isOptional = prop.flags & ts3.SymbolFlags.Optional;
+          return `${prop.getName()}${isOptional ? "?" : ""}: ${propTypeString}`;
+        });
+        return `{ ${propertyStrings.join("; ")} }`;
+      }
+    }
+  }
+  const defaultTypeString = checker.typeToString(type);
+  if (defaultTypeString === "any" && symbol.flags & ts3.SymbolFlags.Interface) {
+    return `interface ${symbol.getName()}`;
+  }
+  return defaultTypeString;
+}
+function formatOutput(info) {
+  const output = [];
+  output.push(`
+${info.name}`);
+  output.push(`Kind: ${info.kind}`);
+  output.push(`Location: ${info.location}`);
+  output.push("");
+  if (info.signature) {
+    output.push("Signature:");
+    output.push(info.signature);
+    output.push("");
+  }
+  if (info.documentation) {
+    output.push("Documentation:");
+    output.push(info.documentation);
+    output.push("");
+  }
+  if (info.jsDoc) {
+    output.push("JSDoc Tags:");
+    output.push(info.jsDoc);
+    output.push("");
+  }
+  output.push("Type:");
+  output.push(info.type);
+  return output.join(`
+`);
+}
+
+// src/resolution/symbol-finder.ts
+function findSymbolInJavaScriptFile(sourceFile, checker, symbolName) {
+  for (const statement of sourceFile.statements) {
+    if (ts4.isFunctionDeclaration(statement) && statement.name?.text === symbolName) {
+      return checker.getSymbolAtLocation(statement.name);
+    }
+    if (ts4.isClassDeclaration(statement) && statement.name?.text === symbolName) {
+      return checker.getSymbolAtLocation(statement.name);
+    }
+    if (ts4.isVariableStatement(statement)) {
+      for (const declaration of statement.declarationList.declarations) {
+        if (ts4.isIdentifier(declaration.name) && declaration.name.text === symbolName) {
+          return checker.getSymbolAtLocation(declaration.name);
+        }
+      }
+    }
+    if (ts4.isExpressionStatement(statement)) {
+      const { expression } = statement;
+      if (ts4.isBinaryExpression(expression) && expression.operatorToken.kind === ts4.SyntaxKind.EqualsToken) {
+        const { left, right } = expression;
+        if (ts4.isPropertyAccessExpression(left) && ts4.isIdentifier(left.expression) && left.expression.text === "module" && ts4.isIdentifier(left.name) && left.name.text === "exports" && ts4.isObjectLiteralExpression(right)) {
+          for (const prop of right.properties) {
+            if (ts4.isPropertyAssignment(prop) || ts4.isShorthandPropertyAssignment(prop)) {
+              const propName = ts4.isIdentifier(prop.name) ? prop.name.text : undefined;
+              if (propName === symbolName) {
+                let targetIdentifier;
+                if (ts4.isShorthandPropertyAssignment(prop)) {
+                  targetIdentifier = prop.name;
+                } else if (ts4.isPropertyAssignment(prop) && ts4.isIdentifier(prop.initializer)) {
+                  targetIdentifier = prop.initializer;
+                }
+                if (targetIdentifier) {
+                  for (const statement2 of sourceFile.statements) {
+                    if (ts4.isFunctionDeclaration(statement2) && statement2.name?.text === targetIdentifier.text) {
+                      const originalSymbol = checker.getSymbolAtLocation(statement2.name);
+                      if (originalSymbol) {
+                        return originalSymbol;
+                      }
+                    }
+                    if (ts4.isClassDeclaration(statement2) && statement2.name?.text === targetIdentifier.text) {
+                      const originalSymbol = checker.getSymbolAtLocation(statement2.name);
+                      if (originalSymbol) {
+                        return originalSymbol;
+                      }
+                    }
+                    if (ts4.isVariableStatement(statement2)) {
+                      for (const declaration of statement2.declarationList.declarations) {
+                        if (ts4.isIdentifier(declaration.name) && declaration.name.text === targetIdentifier.text) {
+                          const originalSymbol = checker.getSymbolAtLocation(declaration.name);
+                          if (originalSymbol) {
+                            return originalSymbol;
+                          }
+                        }
+                      }
+                    }
+                  }
+                  const exportSymbol = checker.getSymbolAtLocation(targetIdentifier);
+                  return exportSymbol;
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+  return;
+}
+function getSymbolInfo(checker, symbol, member, isStatic) {
+  const declaration = symbol.valueDeclaration || symbol.declarations && symbol.declarations[0];
+  if (!declaration && (!symbol.declarations || symbol.declarations.length === 0)) {
+    return createExtractError("TYPE_ERROR", `Symbol '${symbol.getName()}' has no declarations`);
+  }
+  const targetDeclaration = declaration || symbol.declarations[0];
+  const type = checker.getTypeOfSymbolAtLocation(symbol, targetDeclaration);
+  const symbolName = symbol.getName();
+  let targetSymbol = symbol;
+  let targetType = type;
+  let name = symbolName;
+  if (member) {
+    if (isStatic) {
+      const staticMembers = checker.getPropertiesOfType(type);
+      const staticMember = staticMembers.find((s) => s.getName() === member);
+      if (staticMember) {
+        targetSymbol = staticMember;
+        targetType = checker.getTypeOfSymbolAtLocation(staticMember, staticMember.valueDeclaration);
+        name = `${symbolName}.${member}`;
+      } else {
+        return createExtractError("MEMBER_NOT_FOUND", `Static member '${member}' not found on '${symbolName}'`);
+      }
+    } else {
+      let instanceType;
+      if (symbol.flags & ts4.SymbolFlags.Class) {
+        instanceType = checker.getTypeOfSymbolAtLocation(symbol, symbol.valueDeclaration);
+        const constructSignatures = instanceType.getConstructSignatures();
+        if (constructSignatures.length > 0) {
+          const [constructSignature] = constructSignatures;
+          if (constructSignature) {
+            const instanceTypeFromConstruct = checker.getReturnTypeOfSignature(constructSignature);
+            const instanceMembers = checker.getPropertiesOfType(instanceTypeFromConstruct);
+            const instanceMember = instanceMembers.find((s) => s.getName() === member);
+            if (instanceMember) {
+              targetSymbol = instanceMember;
+              targetType = checker.getTypeOfSymbolAtLocation(instanceMember, instanceMember.valueDeclaration);
+              name = `${symbolName}#${member}`;
+            } else {
+              return createExtractError("MEMBER_NOT_FOUND", `Instance member '${member}' not found on '${symbolName}'. Available: ${instanceMembers.map((m) => m.getName()).join(", ")}`);
+            }
+          }
+        } else {
+          const instanceMembers = checker.getPropertiesOfType(instanceType);
+          const instanceMember = instanceMembers.find((s) => s.getName() === member);
+          if (instanceMember) {
+            targetSymbol = instanceMember;
+            targetType = checker.getTypeOfSymbolAtLocation(instanceMember, instanceMember.valueDeclaration);
+            name = `${symbolName}#${member}`;
+          } else {
+            return createExtractError("MEMBER_NOT_FOUND", `Instance member '${member}' not found on '${symbolName}'. Available: ${instanceMembers.map((m) => m.getName()).join(", ")}`);
+          }
+        }
+      } else {
+        const callSignatures = type.getCallSignatures();
+        const constructSignatures = type.getConstructSignatures();
+        if (constructSignatures.length > 0) {
+          const [constructSignature] = constructSignatures;
+          if (constructSignature) {
+            instanceType = checker.getReturnTypeOfSignature(constructSignature);
+          }
+        } else if (callSignatures.length > 0) {
+          const [callSignature] = callSignatures;
+          if (callSignature) {
+            instanceType = checker.getReturnTypeOfSignature(callSignature);
+          }
+        }
+        if (instanceType) {
+          const instanceMembers = checker.getPropertiesOfType(instanceType);
+          const instanceMember = instanceMembers.find((s) => s.getName() === member);
+          if (instanceMember) {
+            targetSymbol = instanceMember;
+            targetType = checker.getTypeOfSymbolAtLocation(instanceMember, instanceMember.valueDeclaration);
+            name = `${symbolName}#${member}`;
+          } else {
+            return createExtractError("MEMBER_NOT_FOUND", `Instance member '${member}' not found on '${symbolName}'`);
+          }
+        } else {
+          return createExtractError("TYPE_ERROR", `'${symbolName}' is not a constructor or class`);
+        }
+      }
+    }
+  }
+  const typeString = getTypeString(checker, targetSymbol, targetType);
+  const signature = getSignature(checker, targetSymbol, targetType);
+  const documentation = getDocumentation(checker, targetSymbol);
+  const jsDoc = getJSDoc(checker, targetSymbol);
+  const kind = getSymbolKind(targetSymbol);
+  const location = getLocation(targetSymbol);
+  return {
+    name,
+    kind,
+    type: typeString,
+    documentation,
+    jsDoc,
+    signature,
+    location
+  };
+}
+
+// src/resolution/index.ts
+function parseModulePath(modulePath) {
+  let module;
+  let symbolPath;
+  if (modulePath.startsWith("node:")) {
+    const nodeSymbol = modulePath.slice(5);
+    const [baseSymbol] = nodeSymbol.split(".");
+    module = `node:${baseSymbol}`;
+    symbolPath = nodeSymbol;
+  } else {
+    const [mod, symPath] = modulePath.split(":");
+    if (!mod || !symPath) {
+      return createExtractError("INVALID_REQUEST", `Invalid format. Expected 'module:symbol', got '${modulePath}'`);
+    }
+    module = mod;
+    symbolPath = symPath;
+  }
+  if (symbolPath.includes("#")) {
+    const [symbol, member] = symbolPath.split("#");
+    if (!symbol || !member) {
+      return createExtractError("INVALID_REQUEST", `Invalid format. Expected 'symbol#instance-member', got '${symbolPath}'`);
+    }
+    return { module, symbol, member, isStatic: false };
+  }
+  if (symbolPath.includes(".")) {
+    const [symbol, member] = symbolPath.split(".");
+    if (!symbol || !member) {
+      return createExtractError("INVALID_REQUEST", `Invalid format. Expected 'symbol.static-member', got '${symbolPath}'`);
+    }
+    return { module, symbol, member, isStatic: true };
+  }
+  return { module, symbol: symbolPath, member: undefined, isStatic: false };
+}
+async function extractDocs(modulePath) {
+  const options = { prefix: process.cwd() };
+  const parseResult = parseModulePath(modulePath);
+  if ("error" in parseResult) {
+    return parseResult;
+  }
+  const { module, symbol, member, isStatic } = parseResult;
+  const config = loadTsConfig(options.prefix);
+  let resolvedModule = resolveModule(module, config.options);
+  let isGlobalModule = false;
+  if (isResolveError(resolvedModule)) {
+    const nodeBuiltinResolution = resolveNodeBuiltin(module, config.options);
+    if (!isResolveError(nodeBuiltinResolution)) {
+      resolvedModule = nodeBuiltinResolution;
+      isGlobalModule = true;
+    }
+  }
+  if (isResolveError(resolvedModule)) {
+    return createExtractError("MODULE_NOT_FOUND", `Module '${module}' not found`);
+  }
+  const { sourceFile, program } = resolvedModule;
+  const checker = program.getTypeChecker();
+  let targetSymbol;
+  if (isGlobalModule) {
+    const actualSymbolName = module.startsWith("node:") ? module.slice(5) : module;
+    const globalSymbols = checker.getSymbolsInScope(sourceFile, ts5.SymbolFlags.Value);
+    targetSymbol = globalSymbols.find((s) => s.getName() === actualSymbolName);
+    if (!targetSymbol) {
+      const [identifierNode] = sourceFile.statements;
+      if (identifierNode && ts5.isVariableStatement(identifierNode)) {
+        const [declaration] = identifierNode.declarationList.declarations;
+        if (declaration && ts5.isVariableDeclaration(declaration) && declaration.initializer) {
+          targetSymbol = checker.getSymbolAtLocation(declaration.initializer);
+        }
+      }
+    }
+  } else {
+    const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
+    if (moduleSymbol) {
+      const exports = checker.getExportsOfModule(moduleSymbol);
+      const exportSymbol = exports.find((exp) => exp.getName() === symbol);
+      if (exportSymbol) {
+        if (exportSymbol.valueDeclaration && (ts5.isFunctionDeclaration(exportSymbol.valueDeclaration) || ts5.isClassDeclaration(exportSymbol.valueDeclaration) || ts5.isVariableDeclaration(exportSymbol.valueDeclaration))) {
+          targetSymbol = exportSymbol;
+        } else if (exportSymbol.flags & (ts5.SymbolFlags.Interface | ts5.SymbolFlags.TypeAlias)) {
+          targetSymbol = exportSymbol;
+        } else {
+          targetSymbol = findSymbolInJavaScriptFile(sourceFile, checker, symbol);
+        }
+      } else {
+        return createExtractError("SYMBOL_NOT_FOUND", `Symbol '${symbol}' not found in module '${module}'. Available exports: ${exports.map((e) => e.getName()).join(", ")}`);
+      }
+    } else {
+      targetSymbol = findSymbolInJavaScriptFile(sourceFile, checker, symbol);
+      if (!targetSymbol) {
+        return createExtractError("SYMBOL_NOT_FOUND", `Symbol '${symbol}' not found in JavaScript module '${module}'`);
+      }
+    }
+  }
+  if (!targetSymbol) {
+    let symbolToShow;
+    if (isGlobalModule) {
+      symbolToShow = module.startsWith("node:") ? module.slice(5) : module;
+    } else {
+      symbolToShow = symbol;
+    }
+    return createExtractError("SYMBOL_NOT_FOUND", `Symbol '${symbolToShow}' not found`);
+  }
+  const result = getSymbolInfo(checker, targetSymbol, member, isStatic);
+  return result;
+}
+async function getSourceLocation(reference) {
+  const options = { prefix: process.cwd() };
+  if (reference.includes(":")) {
+    const parseResult = parseModulePath(reference);
+    if ("error" in parseResult) {
+      return {
+        success: false,
+        error: {
+          code: "MODULE_NOT_FOUND",
+          message: parseResult.error.message
+        }
+      };
+    }
+    const { module, symbol, member, isStatic } = parseResult;
+    const config2 = loadTsConfig(options.prefix);
+    let resolvedModule = resolveModule(module, config2.options);
+    let isGlobalModule = false;
+    if (isResolveError(resolvedModule)) {
+      const nodeBuiltinResolution = resolveNodeBuiltin(module, config2.options);
+      if (!isResolveError(nodeBuiltinResolution)) {
+        resolvedModule = nodeBuiltinResolution;
+        isGlobalModule = true;
+      }
+    }
+    if (isResolveError(resolvedModule)) {
+      return {
+        success: false,
+        error: {
+          code: "MODULE_NOT_FOUND",
+          message: `Module '${module}' not found`
+        }
+      };
+    }
+    const { sourceFile, program } = resolvedModule;
+    const checker = program.getTypeChecker();
+    let targetSymbol;
+    if (isGlobalModule) {
+      const actualSymbolName = module.startsWith("node:") ? module.slice(5) : module;
+      const globalSymbols = checker.getSymbolsInScope(sourceFile, ts5.SymbolFlags.Value);
+      targetSymbol = globalSymbols.find((s) => s.getName() === actualSymbolName);
+      if (!targetSymbol) {
+        const [identifierNode] = sourceFile.statements;
+        if (identifierNode && ts5.isVariableStatement(identifierNode)) {
+          const [declaration] = identifierNode.declarationList.declarations;
+          if (declaration && ts5.isVariableDeclaration(declaration) && declaration.initializer) {
+            targetSymbol = checker.getSymbolAtLocation(declaration.initializer);
+          }
+        }
+      }
+    } else {
+      const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
+      if (moduleSymbol) {
+        const exports = checker.getExportsOfModule(moduleSymbol);
+        const exportSymbol = exports.find((exp) => exp.getName() === symbol);
+        if (exportSymbol) {
+          targetSymbol = exportSymbol;
+        } else {
+          return {
+            success: false,
+            error: {
+              code: "MODULE_NOT_FOUND",
+              message: `Symbol '${symbol}' not found in module '${module}'`
+            }
+          };
+        }
+      } else {
+        targetSymbol = findSymbolInJavaScriptFile(sourceFile, checker, symbol);
+        if (!targetSymbol) {
+          return {
+            success: false,
+            error: {
+              code: "MODULE_NOT_FOUND",
+              message: `Symbol '${symbol}' not found in JavaScript module '${module}'`
+            }
+          };
+        }
+      }
+    }
+    if (!targetSymbol) {
+      return {
+        success: false,
+        error: {
+          code: "MODULE_NOT_FOUND",
+          message: `Symbol '${symbol}' not found`
+        }
+      };
+    }
+    const symbolInfo = getSymbolInfo(checker, targetSymbol, member, isStatic);
+    if (isExtractError(symbolInfo)) {
+      return {
+        success: false,
+        error: {
+          code: "MODULE_NOT_FOUND",
+          message: symbolInfo.error.message
+        }
+      };
+    }
+    return { path: symbolInfo.location, format: "typescript" };
+  }
+  const moduleName = reference;
+  if (moduleName.startsWith("./") || moduleName.startsWith("../")) {
+    const absolutePath = q.resolve(moduleName);
+    if (ts5.sys.fileExists(absolutePath)) {
+      const cwd = process.cwd();
+      let finalPath;
+      if (absolutePath.startsWith(cwd)) {
+        const relativePath = q.relative(cwd, absolutePath);
+        finalPath = relativePath.startsWith("..") ? absolutePath : relativePath;
+      } else {
+        finalPath = absolutePath;
+      }
+      return { path: finalPath, format: "typescript" };
+    }
+  }
+  const config = loadTsConfig(options.prefix);
+  const moduleResolver = ts5.resolveModuleName(moduleName, q.resolve("./index.ts"), config.options, ts5.sys);
+  if (moduleResolver.resolvedModule) {
+    const { resolvedFileName } = moduleResolver.resolvedModule;
+    const cwd = process.cwd();
+    let finalPath;
+    if (resolvedFileName.startsWith(cwd)) {
+      const relativePath = q.relative(cwd, resolvedFileName);
+      finalPath = relativePath.startsWith("..") ? resolvedFileName : relativePath;
+    } else {
+      finalPath = resolvedFileName;
+    }
+    return { path: finalPath, format: "typescript" };
+  }
+  return resolveError(moduleName, process.cwd());
+}
+async function extractSymbol(request, options = {}) {
+  try {
+    if (!request.symbol) {
+      return {
+        error: {
+          code: "INVALID_REQUEST",
+          message: "Symbol name is required"
+        }
+      };
+    }
+    const config = loadTsConfig(options.prefix);
+    const resolvedModule = resolveModule(request.module, config.options);
+    if (isResolveError(resolvedModule)) {
+      return {
+        error: {
+          code: "MODULE_NOT_FOUND",
+          message: `Module '${request.module}' not found`
+        }
+      };
+    }
+    const { sourceFile, program } = resolvedModule;
+    const checker = program.getTypeChecker();
+    const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
+    let targetSymbol;
+    if (moduleSymbol) {
+      const exports = checker.getExportsOfModule(moduleSymbol);
+      targetSymbol = exports.find((exp) => exp.getName() === request.symbol);
+      if (!targetSymbol) {
+        return {
+          error: {
+            code: "SYMBOL_NOT_FOUND",
+            message: `Symbol '${request.symbol}' not found in module '${request.module}'. Available exports: ${exports.map((e) => e.getName()).join(", ")}`
+          }
+        };
+      }
+    } else {
+      targetSymbol = findSymbolInJavaScriptFile(sourceFile, checker, request.symbol);
+      if (!targetSymbol) {
+        return {
+          error: {
+            code: "SYMBOL_NOT_FOUND",
+            message: `Symbol '${request.symbol}' not found in JavaScript module '${request.module}'`
+          }
+        };
+      }
+    }
+    const result = getSymbolInfo(checker, targetSymbol, request.member, request.isStatic);
+    return result;
+  } catch (error) {
+    return {
+      error: {
+        code: "PARSE_ERROR",
+        message: `Extraction failed: ${error instanceof Error ? error.message : String(error)}`
+      }
+    };
+  }
+}
+// src/index.ts
+var TidewaveExtractor = {
+  extractDocs,
+  getSourceLocation,
+  formatOutput
+};
+
+// src/mcp.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// src/tools.ts
+import { z } from "zod";
+var referenceDescription = `Module path in format 'module:symbol[#method|.method]'. Supports local files, dependencies, and Node.js builtins.
+
+        Module reference format:
+        - module:symbol         - Extract a top-level symbol
+        - module:Class#method   - Extract an instance method
+        - module:Class.method   - Extract a static method
+        - node:Class#method     - Extract a global/builtin instance method
+        - node:Class.method     - Extract a global/builtin static method
+
+        Examples:
+        - src/types.ts:SymbolInfo (local file symbol)
+        - lodash:isEmpty (dependency function)  
+        - react:Component#render (instance method)
+        - node:Math.max (builtin static method)`;
+var docsInputSchema = z.object({
+  reference: z.string().describe(referenceDescription)
+});
+var sourceInputSchema = z.object({
+  reference: z.string().describe(referenceDescription)
+});
+var tools = {
+  docs: {
+    mcp: {
+      name: "get_docs",
+      description: "Extract TypeScript/JavaScript documentation and type information for symbols, classes, functions, and methods. This works for modules in the current project, as well as dependencies, and builtin node modules",
+      inputSchema: docsInputSchema
+    },
+    cli: {
+      command: "docs",
+      description: "Extract documentation for a symbol",
+      argument: "<module-path>",
+      argumentDescription: referenceDescription,
+      options: {
+        prefix: {
+          flag: "-p, --prefix <path>",
+          desc: "Path to a custom project path (which contains tsconfig.json/package.json)"
+        },
+        json: {
+          flag: "-j, --json",
+          desc: "If the output should be in JSON format or not"
+        }
+      }
+    }
+  },
+  source: {
+    mcp: {
+      name: "get_source_location",
+      description: "Extract TypeScript/JavaScript source location for the given reference. This works for modules in the current project, as well as dependencies, and builtin node modules",
+      inputSchema: sourceInputSchema
+    },
+    cli: {
+      command: "source",
+      description: "Get the source file path for a module",
+      argument: "<module>",
+      argumentDescription: referenceDescription,
+      options: {
+        prefix: {
+          flag: "-p, --prefix <path>",
+          desc: "Path to a custom project path (which contains tsconfig.json/package.json)"
+        }
+      }
+    }
+  }
+};
+
+// package.json
+var name = "tidewave";
+var version = "0.1.0";
+
+// src/mcp.ts
+var {
+  docs: { mcp: docsMcp },
+  source: { mcp: sourceMcp }
+} = tools;
+async function handleGetDocs({ reference }) {
+  const docs = await TidewaveExtractor.extractDocs(reference);
+  if (isExtractError(docs)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Documentation not found for ${reference}, got an error: ${JSON.stringify(docs)}`
+        }
+      ],
+      isError: true
+    };
+  }
+  if (!docs.documentation) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Documentation not avaialble for ${reference}, reference did not include it`
+        }
+      ],
+      isError: true
+    };
+  }
+  return {
+    content: [{ type: "text", text: TidewaveExtractor.formatOutput(docs) }],
+    isError: false
+  };
+}
+async function handleGetSourcePath({ reference }) {
+  const sourceResult = await TidewaveExtractor.getSourceLocation(reference);
+  if (isResolveError(sourceResult)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Failed to get source location for ${reference}: ${JSON.stringify(sourceResult)}`
+        }
+      ],
+      isError: true
+    };
+  }
+  const { path, format } = sourceResult;
+  return {
+    content: [{ type: "text", text: `${path}(${format})` }],
+    isError: false
+  };
+}
+async function serveMcp(transport) {
+  const server = new McpServer({ name, version });
+  server.registerTool(docsMcp.name, {
+    description: docsMcp.description,
+    inputSchema: docsMcp.inputSchema.shape
+  }, handleGetDocs);
+  server.registerTool(sourceMcp.name, {
+    description: sourceMcp.description,
+    inputSchema: sourceMcp.inputSchema.shape
+  }, handleGetSourcePath);
+  await server.connect(transport);
+}
+export {
+  serveMcp
+};