kirograph 0.16.1 → 0.19.0

package/dist/extraction/languages.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/extraction/languages.ts"],
-  "sourcesContent": ["/**\n * Language detection and tree-sitter grammar mapping\n */\n\nimport type { Language } from '../types';\n\nexport const EXTENSION_MAP: Record<string, Language> = {\n  '.ts': 'typescript',\n  '.tsx': 'tsx',\n  '.js': 'javascript',\n  '.jsx': 'jsx',\n  '.mjs': 'javascript',\n  '.cjs': 'javascript',\n  '.py': 'python',\n  '.pyw': 'python',\n  '.go': 'go',\n  '.rs': 'rust',\n  '.java': 'java',\n  '.c': 'c',\n  '.h': 'c',\n  '.cpp': 'cpp',\n  '.cc': 'cpp',\n  '.cxx': 'cpp',\n  '.hxx': 'cpp',\n  '.hpp': 'cpp',\n  '.cs': 'csharp',\n  '.php': 'php',\n  '.rb': 'ruby',\n  '.rake': 'ruby',\n  '.swift': 'swift',\n  '.kt': 'kotlin',\n  '.kts': 'kotlin',\n  '.dart': 'dart',\n  '.svelte': 'svelte',\n  '.pas': 'pascal',\n  '.dpr': 'pascal',\n  '.dpk': 'pascal',\n  '.lpr': 'pascal',\n  '.dfm': 'pascal',\n  '.fmx': 'pascal',\n  '.liquid': 'liquid',\n  '.ex': 'elixir',\n  '.exs': 'elixir',\n  '.scala': 'scala',\n  '.sc': 'scala',\n  '.sbt': 'scala',\n  '.lua': 'lua',\n  '.zig': 'zig',\n  '.zon': 'zig',\n  '.sh': 'bash',\n  '.bash': 'bash',\n  '.zsh': 'bash',\n  '.ml': 'ocaml',\n  '.mli': 'ocaml',\n  '.elm': 'elm',\n  '.sol': 'solidity',\n  '.vue': 'vue',\n  '.m': 'objc',\n  '.yaml': 'yaml',\n  '.yml': 'yaml',\n  '.tf': 'hcl',\n  '.tfvars': 'hcl',\n  '.css': 'css',\n  '.scss': 'scss',\n  '.sass': 'scss',\n  '.html': 'html',\n  '.htm': 'html',\n};\n\nexport const GRAMMAR_MAP: Record<Language, string> = {\n  typescript: 'tree-sitter-typescript',\n  tsx: 'tree-sitter-tsx',\n  javascript: 'tree-sitter-javascript',\n  jsx: 'tree-sitter-javascript',\n  python: 'tree-sitter-python',\n  go: 'tree-sitter-go',\n  rust: 'tree-sitter-rust',\n  java: 'tree-sitter-java',\n  c: 'tree-sitter-c',\n  cpp: 'tree-sitter-cpp',\n  csharp: 'tree-sitter-c-sharp',\n  php: 'tree-sitter-php',\n  ruby: 'tree-sitter-ruby',\n  swift: 'tree-sitter-swift',\n  kotlin: 'tree-sitter-kotlin',\n  dart: 'tree-sitter-dart',\n  svelte: 'tree-sitter-svelte',\n  elixir: 'tree-sitter-elixir',\n  scala: 'tree-sitter-scala',\n  lua: 'tree-sitter-lua',\n  zig: 'tree-sitter-zig',\n  bash: 'tree-sitter-bash',\n  ocaml: 'tree-sitter-ocaml',\n  elm: 'tree-sitter-elm',\n  solidity: 'tree-sitter-solidity',\n  vue: 'tree-sitter-vue',\n  objc: 'tree-sitter-objc',\n  yaml: 'tree-sitter-yaml',\n  hcl: 'tree-sitter-hcl',\n  css: 'tree-sitter-css',\n  scss: 'tree-sitter-scss',\n  html: 'tree-sitter-html',\n  // Pascal and Liquid require custom WASM not bundled in tree-sitter-wasms\n  pascal: '',\n  liquid: '',\n  unknown: '',\n};\n\nexport function detectLanguage(filePath: string): Language {\n  const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();\n  return EXTENSION_MAP[ext] ?? 'unknown';\n}\n\nexport function isSupportedLanguage(lang: Language): boolean {\n  // All known languages are \"supported\" for indexing purposes.\n  // Pascal and Liquid don't have a grammar WASM, so they'll be indexed\n  // with empty symbol lists (file tracked but no AST extraction).\n  return lang !== 'unknown';\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,MAAM,gBAA0C;AAAA,EACrD,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,SAAS;AAAA,EACT,UAAU;AAAA,EACV,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AACV;AAEO,MAAM,cAAwC;AAAA,EACnD,YAAY;AAAA,EACZ,KAAK;AAAA,EACL,YAAY;AAAA,EACZ,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,MAAM;AAAA,EACN,GAAG;AAAA,EACH,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,MAAM;AAAA,EACN,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,KAAK;AAAA,EACL,KAAK;AAAA,EACL,MAAM;AAAA,EACN,OAAO;AAAA,EACP,KAAK;AAAA,EACL,UAAU;AAAA,EACV,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA,EACN,KAAK;AAAA,EACL,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA;AAAA,EAEN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AACX;AAEO,SAAS,eAAe,UAA4B;AACzD,QAAM,MAAM,SAAS,MAAM,SAAS,YAAY,GAAG,CAAC,EAAE,YAAY;AAClE,SAAO,cAAc,GAAG,KAAK;AAC/B;AAEO,SAAS,oBAAoB,MAAyB;AAI3D,SAAO,SAAS;AAClB;",
+  "sourcesContent": ["/**\n * Language detection and tree-sitter grammar mapping\n */\n\nimport type { Language } from '../types';\n\nexport const EXTENSION_MAP: Record<string, Language> = {\n  '.ts': 'typescript',\n  '.tsx': 'tsx',\n  '.js': 'javascript',\n  '.jsx': 'jsx',\n  '.mjs': 'javascript',\n  '.cjs': 'javascript',\n  '.py': 'python',\n  '.pyw': 'python',\n  '.go': 'go',\n  '.rs': 'rust',\n  '.java': 'java',\n  '.c': 'c',\n  '.h': 'c',\n  '.cpp': 'cpp',\n  '.cc': 'cpp',\n  '.cxx': 'cpp',\n  '.hxx': 'cpp',\n  '.hpp': 'cpp',\n  '.cs': 'csharp',\n  '.php': 'php',\n  '.rb': 'ruby',\n  '.rake': 'ruby',\n  '.swift': 'swift',\n  '.kt': 'kotlin',\n  '.kts': 'kotlin',\n  '.dart': 'dart',\n  '.svelte': 'svelte',\n  '.pas': 'pascal',\n  '.dpr': 'pascal',\n  '.dpk': 'pascal',\n  '.lpr': 'pascal',\n  '.dfm': 'pascal',\n  '.fmx': 'pascal',\n  '.liquid': 'liquid',\n  '.ex': 'elixir',\n  '.exs': 'elixir',\n  '.scala': 'scala',\n  '.sc': 'scala',\n  '.sbt': 'scala',\n  '.lua': 'lua',\n  '.zig': 'zig',\n  '.zon': 'zig',\n  '.sh': 'bash',\n  '.bash': 'bash',\n  '.zsh': 'bash',\n  '.ml': 'ocaml',\n  '.mli': 'ocaml',\n  '.elm': 'elm',\n  '.sol': 'solidity',\n  '.vue': 'vue',\n  '.m': 'objc',\n  '.yaml': 'yaml',\n  '.yml': 'yaml',\n  '.tf': 'hcl',\n  '.tfvars': 'hcl',\n  '.css': 'css',\n  '.scss': 'scss',\n  '.sass': 'scss',\n  '.html': 'html',\n  '.htm': 'html',\n  '.ipynb': 'jupyter',\n  // ReScript\n  '.res': 'rescript',\n  '.resi': 'rescript',\n  // SQL\n  '.sql': 'sql',\n  // R\n  '.r': 'r',\n  '.R': 'r',\n  // Julia\n  '.jl': 'julia',\n  // PowerShell\n  '.ps1': 'powershell',\n  '.psm1': 'powershell',\n  '.psd1': 'powershell',\n  // Perl\n  '.pl': 'perl',\n  '.pm': 'perl',\n  // Astro\n  '.astro': 'astro',\n  // GDScript (Godot)\n  '.gd': 'gdscript',\n  // Nix\n  '.nix': 'nix',\n  // Verilog / SystemVerilog (.v is Verilog, not Vim script)\n  '.v': 'verilog',\n  '.sv': 'verilog',\n  '.svh': 'verilog',\n};\n\nexport const GRAMMAR_MAP: Record<Language, string> = {\n  typescript: 'tree-sitter-typescript',\n  tsx: 'tree-sitter-tsx',\n  javascript: 'tree-sitter-javascript',\n  jsx: 'tree-sitter-javascript',\n  python: 'tree-sitter-python',\n  go: 'tree-sitter-go',\n  rust: 'tree-sitter-rust',\n  java: 'tree-sitter-java',\n  c: 'tree-sitter-c',\n  cpp: 'tree-sitter-cpp',\n  csharp: 'tree-sitter-c-sharp',\n  php: 'tree-sitter-php',\n  ruby: 'tree-sitter-ruby',\n  swift: 'tree-sitter-swift',\n  kotlin: 'tree-sitter-kotlin',\n  dart: 'tree-sitter-dart',\n  svelte: 'tree-sitter-svelte',\n  elixir: 'tree-sitter-elixir',\n  scala: 'tree-sitter-scala',\n  lua: 'tree-sitter-lua',\n  zig: 'tree-sitter-zig',\n  bash: 'tree-sitter-bash',\n  ocaml: 'tree-sitter-ocaml',\n  elm: 'tree-sitter-elm',\n  solidity: 'tree-sitter-solidity',\n  vue: 'tree-sitter-vue',\n  objc: 'tree-sitter-objc',\n  yaml: 'tree-sitter-yaml',\n  hcl: 'tree-sitter-hcl',\n  css: 'tree-sitter-css',\n  scss: 'tree-sitter-scss',\n  html: 'tree-sitter-html',\n  // Pascal and Liquid require custom WASM not bundled in tree-sitter-wasms\n  pascal: '',\n  liquid: '',\n  // Jupyter notebooks are parsed via the notebook extractor (Python grammar on extracted code cells)\n  jupyter: '',\n  // ReScript: WASM available in tree-sitter-wasms\n  rescript: 'tree-sitter-rescript',\n  // Languages with WASMs TBD \u2014 files tracked, symbol extraction pending WASM compilation\n  sql: 'tree-sitter-sql',\n  r: 'tree-sitter-r',\n  julia: 'tree-sitter-julia',\n  powershell: 'tree-sitter-powershell',\n  perl: 'tree-sitter-perl',\n  astro: 'tree-sitter-astro',\n  gdscript: 'tree-sitter-gdscript',\n  nix: 'tree-sitter-nix',\n  verilog: 'tree-sitter-verilog',\n  unknown: '',\n};\n\nexport function detectLanguage(filePath: string): Language {\n  const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();\n  return EXTENSION_MAP[ext] ?? 'unknown';\n}\n\nexport function isSupportedLanguage(lang: Language): boolean {\n  // All known languages are \"supported\" for indexing purposes.\n  // Pascal and Liquid don't have a grammar WASM, so they'll be indexed\n  // with empty symbol lists (file tracked but no AST extraction).\n  return lang !== 'unknown';\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/extraction/notebook.js

@@ -0,0 +1,300 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var notebook_exports = {};
+__export(notebook_exports, {
+  extractNotebook: () => extractNotebook
+});
+module.exports = __toCommonJS(notebook_exports);
+var path = __toESM(require("path"));
+var fs = __toESM(require("fs"));
+var crypto = __toESM(require("crypto"));
+var import_extractor = require("./extractor");
+var import_grammars = require("./grammars");
+async function extractNotebook(filePath, projectRoot, content) {
+  let raw;
+  try {
+    if (content !== void 0) {
+      raw = typeof content === "string" ? content : content.toString("utf8");
+    } else {
+      raw = fs.readFileSync(filePath, "utf8");
+    }
+  } catch {
+    return null;
+  }
+  const contentHash = crypto.createHash("sha256").update(raw).digest("hex");
+  const fileSize = Buffer.byteLength(raw, "utf8");
+  const relPath = path.relative(projectRoot, filePath).replace(/\\/g, "/");
+  let notebook;
+  try {
+    notebook = JSON.parse(raw);
+  } catch {
+    return { filePath: relPath, language: "jupyter", contentHash, fileSize, nodes: [], edges: [], unresolvedRefs: [] };
+  }
+  const cells = notebook.cells ?? [];
+  const codeCells = cells.filter((c) => c.cell_type === "code");
+  if (codeCells.length === 0) {
+    return { filePath: relPath, language: "jupyter", contentHash, fileSize, nodes: [], edges: [], unresolvedRefs: [] };
+  }
+  const cellOffsets = [];
+  const codeChunks = [];
+  let currentLine = 1;
+  for (let i = 0; i < codeCells.length; i++) {
+    const cell = codeCells[i];
+    const cellSource = (cell.source ?? []).join("");
+    const cellCode = cellSource.endsWith("\n") ? cellSource : cellSource + "\n";
+    cellOffsets.push({ startLine: currentLine });
+    codeChunks.push(cellCode);
+    const cellLineCount = cellCode.split("\n").length - 1;
+    currentLine += cellLineCount + (i < codeCells.length - 1 ? 1 : 0);
+  }
+  const concatenated = codeChunks.join("\n");
+  await (0, import_grammars.initGrammars)();
+  const parser = await (0, import_grammars.getParser)("python");
+  if (!parser) {
+    return { filePath: relPath, language: "jupyter", contentHash, fileSize, nodes: [], edges: [], unresolvedRefs: [] };
+  }
+  const tree = parser.parse(concatenated);
+  const nodes = [];
+  const edges = [];
+  const unresolvedRefs = [];
+  const now = Date.now();
+  walkPythonTree(tree.rootNode, concatenated, relPath, nodes, edges, unresolvedRefs, now, cellOffsets, codeChunks);
+  return { filePath: relPath, language: "jupyter", contentHash, fileSize, nodes, edges, unresolvedRefs };
+}
+const TRANSPARENT_TYPES = /* @__PURE__ */ new Set([
+  "export_statement",
+  "program",
+  "source_file",
+  "module",
+  "translation_unit"
+]);
+const PYTHON_IMPORT_TYPES = /* @__PURE__ */ new Set([
+  "import_statement",
+  "import_from_statement"
+]);
+const PYTHON_KIND_MAP = {
+  function_definition: "function",
+  class_definition: "class",
+  assignment: "variable"
+};
+const CALL_NODE_TYPES = /* @__PURE__ */ new Set(["call"]);
+function remapLine(lineInConcat, cellOffsets, codeChunks) {
+  let cellIdx = 0;
+  for (let i = cellOffsets.length - 1; i >= 0; i--) {
+    if (lineInConcat >= cellOffsets[i].startLine) {
+      cellIdx = i;
+      break;
+    }
+  }
+  const posInCell = lineInConcat - cellOffsets[cellIdx].startLine;
+  return cellOffsets[cellIdx].startLine + posInCell;
+}
+function walkPythonTree(node, source, filePath, nodes, edges, unresolvedRefs, now, cellOffsets, codeChunks, parentId) {
+  if (TRANSPARENT_TYPES.has(node.type)) {
+    for (let i = 0; i < node.childCount; i++) {
+      walkPythonTree(node.child(i), source, filePath, nodes, edges, unresolvedRefs, now, cellOffsets, codeChunks, parentId);
+    }
+    return;
+  }
+  if (PYTHON_IMPORT_TYPES.has(node.type)) {
+    const modulePath = extractPythonImportSource(node, source);
+    if (modulePath) {
+      const rawLine = node.startPosition.row + 1;
+      const line = remapLine(rawLine, cellOffsets, codeChunks);
+      const id = (0, import_extractor.makeNodeId)(filePath, "import", modulePath, line);
+      nodes.push({
+        id,
+        kind: "import",
+        name: modulePath,
+        qualifiedName: `${filePath}::import:${modulePath}`,
+        filePath,
+        language: "jupyter",
+        startLine: line,
+        endLine: remapLine(node.endPosition.row + 1, cellOffsets, codeChunks),
+        startColumn: node.startPosition.column,
+        endColumn: node.endPosition.column,
+        updatedAt: now
+      });
+      unresolvedRefs.push({ sourceId: id, refName: modulePath, refKind: "import", line, column: node.startPosition.column });
+    }
+    return;
+  }
+  let kind = PYTHON_KIND_MAP[node.type] ?? null;
+  if (kind) {
+    const name = extractPythonName(node, source, kind);
+    if (name) {
+      const rawStartLine = node.startPosition.row + 1;
+      const rawEndLine = node.endPosition.row + 1;
+      const startLine = remapLine(rawStartLine, cellOffsets, codeChunks);
+      const endLine = remapLine(rawEndLine, cellOffsets, codeChunks);
+      const id = (0, import_extractor.makeNodeId)(filePath, kind, name, startLine);
+      const visibility = extractPythonVisibility(name);
+      const graphNode = {
+        id,
+        kind,
+        name,
+        qualifiedName: `${filePath}::${name}`,
+        filePath,
+        language: "jupyter",
+        startLine,
+        endLine,
+        startColumn: node.startPosition.column,
+        endColumn: node.endPosition.column,
+        docstring: extractPythonDocstring(node, source),
+        signature: extractPythonSignature(node, source, kind),
+        visibility,
+        isExported: false,
+        updatedAt: now
+      };
+      nodes.push(graphNode);
+      if (parentId) {
+        edges.push({ source: parentId, target: id, kind: "contains" });
+      }
+      collectPythonCallRefs(node, source, id, unresolvedRefs, cellOffsets, codeChunks);
+      for (let i = 0; i < node.childCount; i++) {
+        walkPythonTree(node.child(i), source, filePath, nodes, edges, unresolvedRefs, now, cellOffsets, codeChunks, id);
+      }
+      return;
+    }
+  }
+  for (let i = 0; i < node.childCount; i++) {
+    walkPythonTree(node.child(i), source, filePath, nodes, edges, unresolvedRefs, now, cellOffsets, codeChunks, parentId);
+  }
+}
+function extractPythonImportSource(node, source) {
+  if (node.type === "import_from_statement") {
+    for (let i = 0; i < node.childCount; i++) {
+      const child = node.child(i);
+      if (child.type === "dotted_name" || child.type === "relative_import") {
+        return source.slice(child.startIndex, child.endIndex);
+      }
+    }
+  }
+  if (node.type === "import_statement") {
+    for (let i = 0; i < node.childCount; i++) {
+      const child = node.child(i);
+      if (child.type === "dotted_name") {
+        return source.slice(child.startIndex, child.endIndex);
+      }
+    }
+  }
+  return null;
+}
+function extractPythonName(node, source, kind) {
+  if (kind === "variable" && node.type === "assignment") {
+    const left = node.child(0);
+    if (left && left.type === "identifier") {
+      return source.slice(left.startIndex, left.endIndex);
+    }
+    return null;
+  }
+  for (let i = 0; i < node.childCount; i++) {
+    const child = node.child(i);
+    if (child.type === "identifier") {
+      return source.slice(child.startIndex, child.endIndex);
+    }
+  }
+  return null;
+}
+function extractPythonVisibility(name) {
+  if (name.startsWith("__")) return "private";
+  if (name.startsWith("_")) return "protected";
+  return "public";
+}
+function extractPythonDocstring(node, source) {
+  const commentTypes = /* @__PURE__ */ new Set(["comment"]);
+  const commentLines = [];
+  let sibling = node.previousNamedSibling;
+  while (sibling && commentTypes.has(sibling.type)) {
+    commentLines.unshift(source.slice(sibling.startIndex, sibling.endIndex));
+    sibling = sibling.previousNamedSibling;
+  }
+  if (commentLines.length === 0) return void 0;
+  const cleaned = commentLines.join("\n").replace(/^#\s?/gm, "").trim();
+  return cleaned.length > 0 ? cleaned : void 0;
+}
+function extractPythonSignature(node, source, kind) {
+  if (kind === "function" || kind === "method") {
+    const text2 = source.slice(node.startIndex, node.endIndex);
+    const bodyStart = text2.search(/\s*:\s*\n/);
+    const header = bodyStart > 0 ? text2.slice(0, bodyStart).trim() : text2.split("\n")[0].trim();
+    return header.length > 150 ? header.slice(0, 150) + "\u2026" : header || void 0;
+  }
+  const text = source.slice(node.startIndex, node.endIndex);
+  const firstLine = text.split("\n")[0].trim();
+  return firstLine.length > 120 ? firstLine.slice(0, 120) + "\u2026" : firstLine || void 0;
+}
+function collectPythonCallRefs(node, source, sourceId, unresolvedRefs, cellOffsets, codeChunks) {
+  walkForPythonCalls(node, source, sourceId, unresolvedRefs, cellOffsets, codeChunks);
+}
+function walkForPythonCalls(node, source, sourceId, unresolvedRefs, cellOffsets, codeChunks) {
+  if (CALL_NODE_TYPES.has(node.type)) {
+    const calleeName = extractPythonCallName(node, source);
+    if (calleeName) {
+      const rawLine = node.startPosition.row + 1;
+      const line = remapLine(rawLine, cellOffsets, codeChunks);
+      unresolvedRefs.push({
+        sourceId,
+        refName: calleeName,
+        refKind: "function",
+        line,
+        column: node.startPosition.column
+      });
+    }
+  }
+  for (let i = 0; i < node.childCount; i++) {
+    walkForPythonCalls(node.child(i), source, sourceId, unresolvedRefs, cellOffsets, codeChunks);
+  }
+}
+function extractPythonCallName(node, source) {
+  for (const field of ["function", "method"]) {
+    const f = node.childForFieldName?.(field);
+    if (f) {
+      const t = f.type;
+      if (t === "identifier" || t === "name") {
+        const text = source.slice(f.startIndex, f.endIndex).trim();
+        if (text && /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(text)) return text;
+      }
+    }
+  }
+  const funcNode = node.child(0);
+  if (funcNode) {
+    const rawName = source.slice(funcNode.startIndex, funcNode.endIndex).split("(")[0].trim();
+    if (rawName && rawName.length < 100) {
+      const calleeName = rawName.split(".").pop().trim();
+      if (calleeName && /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(calleeName)) return calleeName;
+    }
+  }
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  extractNotebook
+});
+//# sourceMappingURL=notebook.js.map

package/dist/extraction/notebook.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/extraction/notebook.ts"],
+  "sourcesContent": ["/**\n * Notebook extractor for Jupyter (.ipynb) files.\n * Parses the JSON notebook format, extracts code cells, concatenates them,\n * runs the Python tree-sitter parser, and adjusts line numbers so they\n * reflect the position of each cell within the notebook.\n */\n\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport * as crypto from 'crypto';\nimport type { Node, Edge } from '../types';\nimport type { ExtractedFile, UnresolvedRef } from './extractor';\nimport { makeNodeId } from './extractor';\nimport { initGrammars, getParser } from './grammars';\n\ninterface NotebookCell {\n  cell_type: string;\n  source: string[];\n}\n\ninterface NotebookMetadata {\n  kernelspec?: { language?: string };\n  language_info?: { name?: string };\n}\n\ninterface NotebookJson {\n  metadata?: NotebookMetadata;\n  cells?: NotebookCell[];\n}\n\n/** Each code cell mapped to its starting line in the concatenated source */\ninterface CellOffset {\n  /** 1-based starting line of this cell in the concatenated code string */\n  startLine: number;\n}\n\n/**\n * Extract symbols from a Jupyter notebook file.\n * Concatenates all code cells, parses with the Python grammar,\n * and adjusts node line numbers to match cell positions.\n */\nexport async function extractNotebook(\n  filePath: string,\n  projectRoot: string,\n  content?: Buffer | string\n): Promise<ExtractedFile | null> {\n  let raw: string;\n  try {\n    if (content !== undefined) {\n      raw = typeof content === 'string' ? content : content.toString('utf8');\n    } else {\n      raw = fs.readFileSync(filePath, 'utf8');\n    }\n  } catch {\n    return null;\n  }\n\n  const contentHash = crypto.createHash('sha256').update(raw).digest('hex');\n  const fileSize = Buffer.byteLength(raw, 'utf8');\n  const relPath = path.relative(projectRoot, filePath).replace(/\\\\/g, '/');\n\n  let notebook: NotebookJson;\n  try {\n    notebook = JSON.parse(raw);\n  } catch {\n    // Not valid JSON \u2014 return file tracked with no symbols\n    return { filePath: relPath, language: 'jupyter', contentHash, fileSize, nodes: [], edges: [], unresolvedRefs: [] };\n  }\n\n  const cells: NotebookCell[] = notebook.cells ?? [];\n  const codeCells = cells.filter((c) => c.cell_type === 'code');\n\n  if (codeCells.length === 0) {\n    return { filePath: relPath, language: 'jupyter', contentHash, fileSize, nodes: [], edges: [], unresolvedRefs: [] };\n  }\n\n  // Build concatenated source and track the starting line of each cell\n  const cellOffsets: CellOffset[] = [];\n  const codeChunks: string[] = [];\n  let currentLine = 1; // 1-based\n\n  for (let i = 0; i < codeCells.length; i++) {\n    const cell = codeCells[i];\n    const cellSource = (cell.source ?? []).join('');\n    // Ensure each cell ends with a newline so cells don't bleed into each other\n    const cellCode = cellSource.endsWith('\\n') ? cellSource : cellSource + '\\n';\n    cellOffsets.push({ startLine: currentLine });\n    codeChunks.push(cellCode);\n    // Number of lines contributed by this cell's code\n    const cellLineCount = cellCode.split('\\n').length - 1; // trailing \\n creates empty last entry\n    // Advance by cell lines; join('\\n') adds one extra separator line between cells\n    currentLine += cellLineCount + (i < codeCells.length - 1 ? 1 : 0);\n  }\n\n  const concatenated = codeChunks.join('\\n');\n\n  // Load Python parser and parse concatenated source\n  await initGrammars();\n  const parser = await getParser('python');\n  if (!parser) {\n    // Python grammar unavailable \u2014 return file node with no symbols\n    return { filePath: relPath, language: 'jupyter', contentHash, fileSize, nodes: [], edges: [], unresolvedRefs: [] };\n  }\n\n  const tree = parser.parse(concatenated);\n\n  const nodes: Node[] = [];\n  const edges: Edge[] = [];\n  const unresolvedRefs: UnresolvedRef[] = [];\n  const now = Date.now();\n\n  // We reuse the same AST walking logic from extractor.ts but with 'python' language.\n  // Import walkTree-equivalent logic inline to avoid circular imports by using the\n  // exported makeNodeId and reimporting the walk from extractor indirectly.\n  // Instead, we call extractFile on the concatenated source as a virtual Python file\n  // and then remap file paths and languages back.\n  //\n  // To avoid code duplication we use a direct re-export path: import the internal\n  // walkTree equivalent by parsing via a private helper below.\n\n  walkPythonTree(tree.rootNode, concatenated, relPath, nodes, edges, unresolvedRefs, now, cellOffsets, codeChunks);\n\n  return { filePath: relPath, language: 'jupyter', contentHash, fileSize, nodes, edges, unresolvedRefs };\n}\n\n// \u2500\u2500 Transparent node types (same as extractor.ts) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst TRANSPARENT_TYPES = new Set([\n  'export_statement', 'program', 'source_file', 'module', 'translation_unit',\n]);\n\n// \u2500\u2500 Import node types relevant to Python \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst PYTHON_IMPORT_TYPES = new Set([\n  'import_statement',\n  'import_from_statement',\n]);\n\n// \u2500\u2500 KIND_MAP subset for Python \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\ntype NodeKindLocal = Node['kind'];\n\nconst PYTHON_KIND_MAP: Record<string, NodeKindLocal> = {\n  function_definition: 'function',\n  class_definition: 'class',\n  assignment: 'variable',\n};\n\n// \u2500\u2500 CALL_NODE_TYPES for Python \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst CALL_NODE_TYPES = new Set(['call']);\n\n// \u2500\u2500 Line offset helper \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Given a 1-based line number within the concatenated source, return the\n * corrected 1-based line number relative to the notebook.\n *\n * The concatenated source is built as:\n *   cell[0]\\n cell[1]\\n cell[2]\\n ...\n * where cell[i] starts at cellOffsets[i].startLine (1-based) within the concatenation.\n *\n * Each cell chunk in codeChunks already ends with \\n; cells are separated by an\n * extra \\n (the join('\\n') adds one extra newline between chunks).\n *\n * We build a lookup of the absolute start lines in the concatenated string by\n * re-counting: cell 0 starts at line 1; cell 1 starts at line (lines-in-cell-0 + 1 + 1),\n * etc. (The +1 accounts for the join separator).\n *\n * For simplicity we use the pre-computed cellOffsets directly \u2014 they track the\n * cumulative line position in the concatenated string at each cell boundary.\n */\nfunction remapLine(lineInConcat: number, cellOffsets: CellOffset[], codeChunks: string[]): number {\n  // cellOffsets[i].startLine is the 1-based line of cell i in the concatenated string\n  // (built with join('\\n') which adds +1 separator line between cells).\n  // We need to find which cell this line belongs to.\n  //\n  // Rebuild absolute offsets accounting for the '\\n' separator added by join:\n  // cell 0: lines [offset0, offset0 + cellLines0 - 1]\n  // separator line: offset0 + cellLines0\n  // cell 1: offset0 + cellLines0 + 1\n  // etc.\n  //\n  // cellOffsets already accounts for this (built with currentLine += cellLines + 1\n  // because codeChunks.join('\\n') adds a newline between chunks).\n\n  let cellIdx = 0;\n  for (let i = cellOffsets.length - 1; i >= 0; i--) {\n    if (lineInConcat >= cellOffsets[i].startLine) {\n      cellIdx = i;\n      break;\n    }\n  }\n  // Position within the cell (0-based)\n  const posInCell = lineInConcat - cellOffsets[cellIdx].startLine;\n  // Return 1-based position within notebook (cell starts at cellOffsets[cellIdx].startLine\n  // which IS the 1-based line in the notebook for cell 0 = line 1)\n  return cellOffsets[cellIdx].startLine + posInCell;\n}\n\n// \u2500\u2500 Python-specific AST walker \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction walkPythonTree(\n  node: any,\n  source: string,\n  filePath: string,\n  nodes: Node[],\n  edges: Edge[],\n  unresolvedRefs: UnresolvedRef[],\n  now: number,\n  cellOffsets: CellOffset[],\n  codeChunks: string[],\n  parentId?: string\n): void {\n  if (TRANSPARENT_TYPES.has(node.type)) {\n    for (let i = 0; i < node.childCount; i++) {\n      walkPythonTree(node.child(i), source, filePath, nodes, edges, unresolvedRefs, now, cellOffsets, codeChunks, parentId);\n    }\n    return;\n  }\n\n  if (PYTHON_IMPORT_TYPES.has(node.type)) {\n    const modulePath = extractPythonImportSource(node, source);\n    if (modulePath) {\n      const rawLine = node.startPosition.row + 1;\n      const line = remapLine(rawLine, cellOffsets, codeChunks);\n      const id = makeNodeId(filePath, 'import', modulePath, line);\n      nodes.push({\n        id,\n        kind: 'import',\n        name: modulePath,\n        qualifiedName: `${filePath}::import:${modulePath}`,\n        filePath,\n        language: 'jupyter',\n        startLine: line,\n        endLine: remapLine(node.endPosition.row + 1, cellOffsets, codeChunks),\n        startColumn: node.startPosition.column,\n        endColumn: node.endPosition.column,\n        updatedAt: now,\n      });\n      unresolvedRefs.push({ sourceId: id, refName: modulePath, refKind: 'import', line, column: node.startPosition.column });\n    }\n    return;\n  }\n\n  let kind: NodeKindLocal | null = PYTHON_KIND_MAP[node.type] ?? null;\n\n  if (kind) {\n    const name = extractPythonName(node, source, kind);\n    if (name) {\n      const rawStartLine = node.startPosition.row + 1;\n      const rawEndLine = node.endPosition.row + 1;\n      const startLine = remapLine(rawStartLine, cellOffsets, codeChunks);\n      const endLine = remapLine(rawEndLine, cellOffsets, codeChunks);\n      const id = makeNodeId(filePath, kind, name, startLine);\n      const visibility = extractPythonVisibility(name);\n\n      const graphNode: Node = {\n        id,\n        kind,\n        name,\n        qualifiedName: `${filePath}::${name}`,\n        filePath,\n        language: 'jupyter',\n        startLine,\n        endLine,\n        startColumn: node.startPosition.column,\n        endColumn: node.endPosition.column,\n        docstring: extractPythonDocstring(node, source),\n        signature: extractPythonSignature(node, source, kind),\n        visibility,\n        isExported: false,\n        updatedAt: now,\n      };\n      nodes.push(graphNode);\n\n      if (parentId) {\n        edges.push({ source: parentId, target: id, kind: 'contains' });\n      }\n\n      collectPythonCallRefs(node, source, id, unresolvedRefs, cellOffsets, codeChunks);\n\n      for (let i = 0; i < node.childCount; i++) {\n        walkPythonTree(node.child(i), source, filePath, nodes, edges, unresolvedRefs, now, cellOffsets, codeChunks, id);\n      }\n      return;\n    }\n  }\n\n  for (let i = 0; i < node.childCount; i++) {\n    walkPythonTree(node.child(i), source, filePath, nodes, edges, unresolvedRefs, now, cellOffsets, codeChunks, parentId);\n  }\n}\n\n// \u2500\u2500 Python helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction extractPythonImportSource(node: any, source: string): string | null {\n  if (node.type === 'import_from_statement') {\n    for (let i = 0; i < node.childCount; i++) {\n      const child = node.child(i);\n      if (child.type === 'dotted_name' || child.type === 'relative_import') {\n        return source.slice(child.startIndex, child.endIndex);\n      }\n    }\n  }\n  if (node.type === 'import_statement') {\n    for (let i = 0; i < node.childCount; i++) {\n      const child = node.child(i);\n      if (child.type === 'dotted_name') {\n        return source.slice(child.startIndex, child.endIndex);\n      }\n    }\n  }\n  return null;\n}\n\nfunction extractPythonName(node: any, source: string, kind: NodeKindLocal): string | null {\n  if (kind === 'variable' && node.type === 'assignment') {\n    const left = node.child(0);\n    if (left && left.type === 'identifier') {\n      return source.slice(left.startIndex, left.endIndex);\n    }\n    return null;\n  }\n  for (let i = 0; i < node.childCount; i++) {\n    const child = node.child(i);\n    if (child.type === 'identifier') {\n      return source.slice(child.startIndex, child.endIndex);\n    }\n  }\n  return null;\n}\n\nfunction extractPythonVisibility(name: string): Node['visibility'] {\n  if (name.startsWith('__')) return 'private';\n  if (name.startsWith('_')) return 'protected';\n  return 'public';\n}\n\nfunction extractPythonDocstring(node: any, source: string): string | undefined {\n  const commentTypes = new Set(['comment']);\n  const commentLines: string[] = [];\n  let sibling = node.previousNamedSibling;\n  while (sibling && commentTypes.has(sibling.type)) {\n    commentLines.unshift(source.slice(sibling.startIndex, sibling.endIndex));\n    sibling = sibling.previousNamedSibling;\n  }\n  if (commentLines.length === 0) return undefined;\n  const cleaned = commentLines.join('\\n').replace(/^#\\s?/gm, '').trim();\n  return cleaned.length > 0 ? cleaned : undefined;\n}\n\nfunction extractPythonSignature(node: any, source: string, kind: NodeKindLocal): string | undefined {\n  if (kind === 'function' || kind === 'method') {\n    const text = source.slice(node.startIndex, node.endIndex);\n    const bodyStart = text.search(/\\s*:\\s*\\n/);\n    const header = bodyStart > 0 ? text.slice(0, bodyStart).trim() : text.split('\\n')[0].trim();\n    return header.length > 150 ? header.slice(0, 150) + '\u2026' : header || undefined;\n  }\n  const text = source.slice(node.startIndex, node.endIndex);\n  const firstLine = text.split('\\n')[0].trim();\n  return firstLine.length > 120 ? firstLine.slice(0, 120) + '\u2026' : firstLine || undefined;\n}\n\nfunction collectPythonCallRefs(\n  node: any,\n  source: string,\n  sourceId: string,\n  unresolvedRefs: UnresolvedRef[],\n  cellOffsets: CellOffset[],\n  codeChunks: string[]\n): void {\n  walkForPythonCalls(node, source, sourceId, unresolvedRefs, cellOffsets, codeChunks);\n}\n\nfunction walkForPythonCalls(\n  node: any,\n  source: string,\n  sourceId: string,\n  unresolvedRefs: UnresolvedRef[],\n  cellOffsets: CellOffset[],\n  codeChunks: string[]\n): void {\n  if (CALL_NODE_TYPES.has(node.type)) {\n    const calleeName = extractPythonCallName(node, source);\n    if (calleeName) {\n      const rawLine = node.startPosition.row + 1;\n      const line = remapLine(rawLine, cellOffsets, codeChunks);\n      unresolvedRefs.push({\n        sourceId,\n        refName: calleeName,\n        refKind: 'function',\n        line,\n        column: node.startPosition.column,\n      });\n    }\n  }\n  for (let i = 0; i < node.childCount; i++) {\n    walkForPythonCalls(node.child(i), source, sourceId, unresolvedRefs, cellOffsets, codeChunks);\n  }\n}\n\nfunction extractPythonCallName(node: any, source: string): string | null {\n  for (const field of ['function', 'method']) {\n    const f = node.childForFieldName?.(field);\n    if (f) {\n      const t = f.type;\n      if (t === 'identifier' || t === 'name') {\n        const text = source.slice(f.startIndex, f.endIndex).trim();\n        if (text && /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(text)) return text;\n      }\n    }\n  }\n  const funcNode = node.child(0);\n  if (funcNode) {\n    const rawName = source.slice(funcNode.startIndex, funcNode.endIndex).split('(')[0].trim();\n    if (rawName && rawName.length < 100) {\n      const calleeName = rawName.split('.').pop()!.trim();\n      if (calleeName && /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(calleeName)) return calleeName;\n    }\n  }\n  return null;\n}\n"],
+  "mappings": "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",
+  "names": ["text"]
+}

package/dist/frameworks/flutter.js

@@ -0,0 +1,130 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var flutter_exports = {};
+__export(flutter_exports, {
+  flutterResolver: () => flutterResolver
+});
+module.exports = __toCommonJS(flutter_exports);
+const flutterResolver = {
+  name: "flutter",
+  detect(context) {
+    const pubspec = context.readFile("pubspec.yaml");
+    if (pubspec) {
+      if (pubspec.includes("flutter:") || pubspec.includes("flutter_hooks:") || pubspec.includes("flutter_riverpod:")) {
+        return true;
+      }
+    }
+    for (const file of context.getAllFiles()) {
+      if (file.startsWith("lib/") && file.endsWith(".dart")) return true;
+    }
+    return false;
+  },
+  resolve(ref, context) {
+    if (/(?:Page|Screen|View|Widget)$/.test(ref.referenceName) && /^[A-Z]/.test(ref.referenceName)) {
+      for (const file of context.getAllFiles()) {
+        if (!file.endsWith(".dart")) continue;
+        const node = context.getNodesInFile(file).find(
+          (n) => n.name === ref.referenceName && (n.kind === "component" || n.kind === "class")
+        );
+        if (node) return { original: ref, targetNodeId: node.id, confidence: 0.8, resolvedBy: "framework" };
+      }
+    }
+    return null;
+  },
+  extractNodes(filePath, content) {
+    if (!filePath.endsWith(".dart")) return [];
+    const nodes = [];
+    const now = Date.now();
+    const materialRoutesPattern = /routes\s*:\s*\{([^}]+)\}/gs;
+    let routesBlock;
+    while ((routesBlock = materialRoutesPattern.exec(content)) !== null) {
+      const block = routesBlock[1];
+      const entryPattern = /['"]([^'"]+)['"]\s*:/g;
+      let entry;
+      while ((entry = entryPattern.exec(block)) !== null) {
+        const routePath = entry[1];
+        const line = content.slice(0, routesBlock.index).split("\n").length;
+        nodes.push({
+          id: `route:${filePath}:${routePath}:${line}`,
+          kind: "route",
+          name: routePath,
+          qualifiedName: `${filePath}::route:${routePath}`,
+          filePath,
+          startLine: line,
+          endLine: line,
+          startColumn: 0,
+          endColumn: entry[0].length,
+          language: "dart",
+          updatedAt: now
+        });
+      }
+    }
+    const goRoutePattern = /GoRoute\s*\([^)]*path\s*:\s*['"]([^'"]+)['"]/g;
+    let goMatch;
+    while ((goMatch = goRoutePattern.exec(content)) !== null) {
+      const routePath = goMatch[1];
+      const line = content.slice(0, goMatch.index).split("\n").length;
+      const id = `route:${filePath}:${routePath}:${line}`;
+      if (!nodes.some((n) => n.id === id)) {
+        nodes.push({
+          id,
+          kind: "route",
+          name: routePath,
+          qualifiedName: `${filePath}::route:${routePath}`,
+          filePath,
+          startLine: line,
+          endLine: line,
+          startColumn: 0,
+          endColumn: goMatch[0].length,
+          language: "dart",
+          updatedAt: now
+        });
+      }
+    }
+    const autoRoutePattern = /@RoutePage\(\s*\)\s*\n(?:\s*\n)*\s*class\s+(\w+)/g;
+    let autoMatch;
+    while ((autoMatch = autoRoutePattern.exec(content)) !== null) {
+      const widgetName = autoMatch[1];
+      const line = content.slice(0, autoMatch.index).split("\n").length;
+      const routePath = "/" + widgetName.replace(/(?:Page|Screen|View)$/, "").replace(/([A-Z])/g, (_, c, i) => (i > 0 ? "-" : "") + c.toLowerCase());
+      const id = `route:${filePath}:${routePath}:${line}`;
+      if (!nodes.some((n) => n.id === id)) {
+        nodes.push({
+          id,
+          kind: "route",
+          name: routePath,
+          qualifiedName: `${filePath}::route:${routePath}`,
+          filePath,
+          startLine: line,
+          endLine: line,
+          startColumn: 0,
+          endColumn: autoMatch[0].length,
+          language: "dart",
+          updatedAt: now
+        });
+      }
+    }
+    return nodes;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  flutterResolver
+});
+//# sourceMappingURL=flutter.js.map

package/dist/frameworks/flutter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/frameworks/flutter.ts"],
+  "sourcesContent": ["/**\n * Flutter Framework Resolver\n *\n * Detects Flutter projects and extracts route nodes from:\n *   - MaterialApp(routes: {'/path': (ctx) => MyPage()})\n *   - MaterialApp.router(routerConfig: GoRouter(...))\n *   - GoRouter(routes: [GoRoute(path: '/path', builder: ...)])\n *   - AutoRoute annotations: @RoutePage() on widget classes\n */\n\nimport type { Node } from '../types';\nimport type { FrameworkResolver, UnresolvedRef, ResolvedRef, ResolutionContext } from './types';\n\nexport const flutterResolver: FrameworkResolver = {\n  name: 'flutter',\n\n  detect(context: ResolutionContext): boolean {\n    // Primary signal: pubspec.yaml with a flutter dependency/section\n    const pubspec = context.readFile('pubspec.yaml');\n    if (pubspec) {\n      if (pubspec.includes('flutter:') || pubspec.includes('flutter_hooks:') || pubspec.includes('flutter_riverpod:')) {\n        return true;\n      }\n    }\n    // Secondary signal: lib/ directory contains .dart files\n    for (const file of context.getAllFiles()) {\n      if (file.startsWith('lib/') && file.endsWith('.dart')) return true;\n    }\n    return false;\n  },\n\n  resolve(ref: UnresolvedRef, context: ResolutionContext): ResolvedRef | null {\n    // Resolve widget references (names ending with Page, Screen, View, Widget)\n    if (/(?:Page|Screen|View|Widget)$/.test(ref.referenceName) && /^[A-Z]/.test(ref.referenceName)) {\n      for (const file of context.getAllFiles()) {\n        if (!file.endsWith('.dart')) continue;\n        const node = context.getNodesInFile(file).find(\n          n => n.name === ref.referenceName && (n.kind === 'component' || n.kind === 'class')\n        );\n        if (node) return { original: ref, targetNodeId: node.id, confidence: 0.8, resolvedBy: 'framework' };\n      }\n    }\n    return null;\n  },\n\n  extractNodes(filePath: string, content: string): Node[] {\n    if (!filePath.endsWith('.dart')) return [];\n    const nodes: Node[] = [];\n    const now = Date.now();\n\n    // 1. MaterialApp static routes map: '/path': (ctx) => WidgetName()\n    const materialRoutesPattern = /routes\\s*:\\s*\\{([^}]+)\\}/gs;\n    let routesBlock: RegExpExecArray | null;\n    while ((routesBlock = materialRoutesPattern.exec(content)) !== null) {\n      const block = routesBlock[1]!;\n      const entryPattern = /['\"]([^'\"]+)['\"]\\s*:/g;\n      let entry: RegExpExecArray | null;\n      while ((entry = entryPattern.exec(block)) !== null) {\n        const routePath = entry[1]!;\n        const line = content.slice(0, routesBlock.index).split('\\n').length;\n        nodes.push({\n          id: `route:${filePath}:${routePath}:${line}`,\n          kind: 'route',\n          name: routePath,\n          qualifiedName: `${filePath}::route:${routePath}`,\n          filePath,\n          startLine: line,\n          endLine: line,\n          startColumn: 0,\n          endColumn: entry[0].length,\n          language: 'dart',\n          updatedAt: now,\n        });\n      }\n    }\n\n    // 2. GoRouter GoRoute(path: '/path', ...) declarations\n    const goRoutePattern = /GoRoute\\s*\\([^)]*path\\s*:\\s*['\"]([^'\"]+)['\"]/g;\n    let goMatch: RegExpExecArray | null;\n    while ((goMatch = goRoutePattern.exec(content)) !== null) {\n      const routePath = goMatch[1]!;\n      const line = content.slice(0, goMatch.index).split('\\n').length;\n      // Avoid duplicates from the routes:{} pass above\n      const id = `route:${filePath}:${routePath}:${line}`;\n      if (!nodes.some(n => n.id === id)) {\n        nodes.push({\n          id,\n          kind: 'route',\n          name: routePath,\n          qualifiedName: `${filePath}::route:${routePath}`,\n          filePath,\n          startLine: line,\n          endLine: line,\n          startColumn: 0,\n          endColumn: goMatch[0].length,\n          language: 'dart',\n          updatedAt: now,\n        });\n      }\n    }\n\n    // 3. AutoRoute @RoutePage() annotation \u2014 mark the annotated class as a routed page\n    const autoRoutePattern = /@RoutePage\\(\\s*\\)\\s*\\n(?:\\s*\\n)*\\s*class\\s+(\\w+)/g;\n    let autoMatch: RegExpExecArray | null;\n    while ((autoMatch = autoRoutePattern.exec(content)) !== null) {\n      const widgetName = autoMatch[1]!;\n      const line = content.slice(0, autoMatch.index).split('\\n').length;\n      // Derive a conventional route path from the class name (e.g. LoginPage \u2192 /login)\n      const routePath = '/' + widgetName.replace(/(?:Page|Screen|View)$/, '').replace(/([A-Z])/g, (_, c, i) => (i > 0 ? '-' : '') + c.toLowerCase());\n      const id = `route:${filePath}:${routePath}:${line}`;\n      if (!nodes.some(n => n.id === id)) {\n        nodes.push({\n          id,\n          kind: 'route',\n          name: routePath,\n          qualifiedName: `${filePath}::route:${routePath}`,\n          filePath,\n          startLine: line,\n          endLine: line,\n          startColumn: 0,\n          endColumn: autoMatch[0].length,\n          language: 'dart',\n          updatedAt: now,\n        });\n      }\n    }\n\n    return nodes;\n  },\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/frameworks/index.js

@@ -41,6 +41,7 @@ __export(frameworks_exports, {
   expressResolver: () => import_express.expressResolver,
   fastapiResolver: () => import_python.fastapiResolver,
   flaskResolver: () => import_python.flaskResolver,
+  flutterResolver: () => import_flutter.flutterResolver,
   getAllFrameworkResolvers: () => getAllFrameworkResolvers,
   getFrameworkResolver: () => getFrameworkResolver,
   goResolver: () => import_go.goResolver,
@@ -95,6 +96,7 @@ var import_docker = require("./docker");
 var import_ansible = require("./ansible");
 var import_angular = require("./angular");
 var import_amplify = require("./amplify");
+var import_flutter = require("./flutter");
 var import_react2 = require("./react");
 var import_svelte2 = require("./svelte");
 var import_express2 = require("./express");
@@ -119,6 +121,7 @@ var import_docker2 = require("./docker");
 var import_ansible2 = require("./ansible");
 var import_angular2 = require("./angular");
 var import_amplify2 = require("./amplify");
+var import_flutter2 = require("./flutter");
 const FRAMEWORK_RESOLVERS = [
   // PHP
   import_laravel2.laravelResolver,
@@ -167,7 +170,9 @@ const FRAMEWORK_RESOLVERS = [
   import_kubernetes2.kubernetesResolver,
   import_docker2.dockerComposeResolver,
   // Configuration Management
-  import_ansible2.ansibleResolver
+  import_ansible2.ansibleResolver,
+  // Dart / Flutter
+  import_flutter2.flutterResolver
 ];
 function getAllFrameworkResolvers() {
   return FRAMEWORK_RESOLVERS;
@@ -293,6 +298,7 @@ async function detectFromPackageJson(projectRoot) {
   expressResolver,
   fastapiResolver,
   flaskResolver,
+  flutterResolver,
   getAllFrameworkResolvers,
   getFrameworkResolver,
   goResolver,