universal-ast-mapper 1.27.0 → 2.0.0

package/dist/diskcache.js

@@ -1,97 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import crypto from "node:crypto";
-// ─── Persistent (on-disk) parse cache ─────────────────────────────────────────
-// Content-hash keyed: the key embeds schemaVersion + grammar source + detail +
-// the file's raw bytes, so entries never go stale — a changed file simply maps
-// to a new key. Stored as sharded JSON files under <root>/.ast-map/cache.
-// Enabled by calling initDiskCache() once at startup (CLI / MCP server / worker).
-let cacheDir = null;
-/** Enable (or disable with null) the disk cache for this process. */
-export function initDiskCache(dir) {
-    cacheDir = dir;
-}
-/** The currently active cache directory, or null when disabled. */
-export function diskCacheDir() {
-    return cacheDir;
-}
-/** Conventional cache location for a project root. */
-export function defaultCacheDir(root) {
-    return path.join(root, ".ast-map", "cache");
-}
-/** Stable cache key for a (source, detail, schema, grammar) tuple. */
-export function diskCacheKey(source, detail, schemaVersion, grammarSource) {
-    return crypto
-        .createHash("sha1")
-        .update(`${schemaVersion}\0${grammarSource}\0${detail}\0`)
-        .update(source)
-        .digest("hex");
-}
-function shardPath(dir, key) {
-    return path.join(dir, key.slice(0, 2), key.slice(2) + ".json");
-}
-/** Read a cached skeleton, or null on miss / disabled / corrupt entry. */
-export function diskCacheGet(key) {
-    if (!cacheDir)
-        return null;
-    try {
-        const raw = fs.readFileSync(shardPath(cacheDir, key), "utf8");
-        const parsed = JSON.parse(raw);
-        return parsed.skel ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-/** Persist a skeleton under the given key (best-effort, never throws). */
-export function diskCachePut(key, skel) {
-    if (!cacheDir)
-        return;
-    try {
-        const file = shardPath(cacheDir, key);
-        fs.mkdirSync(path.dirname(file), { recursive: true });
-        const tmp = file + "." + process.pid + ".tmp";
-        fs.writeFileSync(tmp, JSON.stringify({ skel }));
-        fs.renameSync(tmp, file);
-    }
-    catch {
-        /* cache write failures are non-fatal */
-    }
-}
-/** Count entries + total size of a cache directory. */
-export function diskCacheStats(dir) {
-    let entries = 0;
-    let bytes = 0;
-    const walk = (d) => {
-        let names = [];
-        try {
-            names = fs.readdirSync(d, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        for (const e of names) {
-            const p = path.join(d, e.name);
-            if (e.isDirectory())
-                walk(p);
-            else if (e.name.endsWith(".json")) {
-                entries++;
-                try {
-                    bytes += fs.statSync(p).size;
-                }
-                catch { /* skip */ }
-            }
-        }
-    };
-    walk(dir);
-    return { dir, entries, bytes };
-}
-/** Remove every entry in a cache directory. Returns how many were removed. */
-export function clearDiskCache(dir) {
-    const { entries } = diskCacheStats(dir);
-    try {
-        fs.rmSync(dir, { recursive: true, force: true });
-    }
-    catch { /* best-effort */ }
-    return entries;
-}

package/dist/explorer.js

@@ -1,123 +0,0 @@
-/** Derive a file-level dependency graph (nodes = files, edges = imports). */
-function deriveFileGraph(graph) {
-    const nodeMap = new Map(graph.nodes.map((n) => [n.id, n]));
-    // top-level symbol names per file (for the detail panel).
-    const fileSyms = new Map();
-    for (const n of graph.nodes) {
-        if (n.nodeType !== "symbol")
-            continue;
-        const s = n;
-        if (s.id.indexOf("::") !== s.id.lastIndexOf("::"))
-            continue; // skip nested (one :: only)
-        const arr = fileSyms.get(s.file) ?? [];
-        if (arr.length < 60)
-            arr.push(s.kind + " " + s.symbol);
-        fileSyms.set(s.file, arr);
-    }
-    const nodes = [];
-    for (const n of graph.nodes) {
-        if (n.nodeType !== "file")
-            continue;
-        const f = n;
-        const parts = f.id.split("/");
-        nodes.push({ id: f.id, symbols: f.symbolCount, group: parts.length > 1 ? parts[0] : "(root)", lang: f.language, syms: fileSyms.get(f.id) ?? [], ca: 0, ce: 0, inst: 0 });
-    }
-    const seen = new Set();
-    const links = [];
-    for (const e of graph.edges) {
-        if (e.edgeType !== "imports")
-            continue;
-        const to = nodeMap.get(e.to);
-        const toFile = to ? (to.nodeType === "file" ? to.id : to.file) : null;
-        if (!toFile || e.from === toFile)
-            continue;
-        const key = e.from + "|" + toFile;
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        links.push({ source: e.from, target: toFile });
-    }
-    // Per-file coupling (Ca = fan-in, Ce = fan-out, I = Ce/(Ca+Ce)) from the deduped links.
-    const outSet = new Map();
-    const inSet = new Map();
-    for (const l of links) {
-        (outSet.get(l.source) ?? outSet.set(l.source, new Set()).get(l.source)).add(l.target);
-        (inSet.get(l.target) ?? inSet.set(l.target, new Set()).get(l.target)).add(l.source);
-    }
-    for (const n of nodes) {
-        n.ce = outSet.get(n.id)?.size ?? 0;
-        n.ca = inSet.get(n.id)?.size ?? 0;
-        n.inst = n.ca + n.ce === 0 ? 0 : Math.round((n.ce / (n.ca + n.ce)) * 100) / 100;
-    }
-    return { nodes, links };
-}
-const STYLE = "body{margin:0;font-family:system-ui,sans-serif;color:#222;background:#fafafa}" +
-    "#bar{position:fixed;top:0;left:0;right:0;height:48px;display:flex;align-items:center;gap:12px;padding:0 14px;background:#fff;border-bottom:1px solid #e5e5e5;z-index:4;box-sizing:border-box}" +
-    "#bar h1{font-size:14px;margin:0;font-weight:600}#bar .muted{color:#888;font-size:12px}" +
-    "#q{flex:0 0 200px;padding:6px 10px;border:1px solid #ddd;border-radius:6px;font-size:13px}" +
-    "#cv{position:fixed;top:48px;left:0;right:0;bottom:0;display:block;cursor:grab}" +
-    "#tip{position:fixed;pointer-events:none;background:#222;color:#fff;font-size:12px;padding:4px 8px;border-radius:5px;display:none;z-index:5}" +
-    "#panel{position:fixed;top:48px;right:0;bottom:0;width:300px;background:#fff;border-left:1px solid #e5e5e5;z-index:3;overflow-y:auto;padding:14px 16px;box-sizing:border-box;display:none;font-size:13px}" +
-    "#panel h2{font-size:14px;margin:0 0 2px;word-break:break-all}#panel .path{color:#888;font-size:11px;margin-bottom:10px;word-break:break-all}" +
-    "#panel .meta{color:#555;margin-bottom:12px}#panel h3{font-size:11px;text-transform:uppercase;letter-spacing:.04em;color:#999;margin:14px 0 6px}" +
-    "#panel .row{padding:3px 6px;border-radius:5px;cursor:pointer;word-break:break-all;line-height:1.5}#panel .row:hover{background:#f0f0f0}" +
-    "#panel .sym{color:#444;padding:2px 6px;word-break:break-all}#panel .k{color:#999;font-size:11px}" +
-    "#close{position:absolute;top:10px;right:12px;cursor:pointer;color:#999;font-size:18px;line-height:1;border:none;background:none}" +
-    "#mode{padding:5px 8px;border:1px solid #ddd;border-radius:6px;font-size:12px;background:#fff;color:#222}" +
-    "#leg{position:fixed;left:14px;bottom:14px;z-index:3;background:#fff;border:1px solid #e5e5e5;border-radius:8px;padding:8px 12px;font-size:11px;color:#555;display:none}" +
-    "#leg .bar{width:150px;height:8px;border-radius:4px;background:linear-gradient(90deg,hsl(120,65%,46%),hsl(60,75%,50%),hsl(0,70%,52%));margin:5px 0 3px}" +
-    "@media(prefers-color-scheme:dark){body{color:#ddd;background:#161616}#bar,#panel{background:#1e1e1e;border-color:#333}#q{background:#2a2a2a;border-color:#444;color:#ddd}#panel .row:hover{background:#2a2a2a}#panel .sym{color:#bbb}#mode{background:#2a2a2a;border-color:#444;color:#ddd}#leg{background:#1e1e1e;border-color:#333;color:#bbb}}";
-const CLIENT = "var c=document.getElementById('cv'),ctx=c.getContext('2d'),tip=document.getElementById('tip'),panel=document.getElementById('panel');" +
-    "var PANELW=300,panelOpen=false;" +
-    "var W,H;function resize(){var r=devicePixelRatio||1;W=innerWidth||c.clientWidth||800;H=(innerHeight-48)||c.clientHeight||600;c.width=W*r;c.height=H*r;ctx.setTransform(r,0,0,r,0,0);}addEventListener('resize',function(){resize();});resize();" +
-    "function availW(){return W-(panelOpen?PANELW:0);}" +
-    "var nodes=DATA.nodes,links=DATA.links,byId={};nodes.forEach(function(n){byId[n.id]=n;n.vx=0;n.vy=0;});" +
-    "var deg={},out={},inn={};links.forEach(function(l){deg[l.source]=(deg[l.source]||0)+1;deg[l.target]=(deg[l.target]||0)+1;(out[l.source]=out[l.source]||[]).push(l.target);(inn[l.target]=inn[l.target]||[]).push(l.source);});" +
-    "var sim=nodes.filter(function(n){return deg[n.id];}),orphans=nodes.filter(function(n){return !deg[n.id];});" +
-    "sim.forEach(function(n){n.x=W/2+(Math.random()-0.5)*240;n.y=H/2+(Math.random()-0.5)*240;});" +
-    "var groups={},gi=0;function color(g){if(groups[g]==null)groups[g]=gi++;return 'hsl('+((groups[g]*67)%360)+',58%,55%)';}" +
-    "var adj={};links.forEach(function(l){(adj[l.source]=adj[l.source]||[]).push(l.target);(adj[l.target]=adj[l.target]||[]).push(l.source);});" +
-    "var view={x:0,y:0,k:1},sel=null,hover=null,drag=null,pan=null,q='',autofit=true,mode='group';" +
-    "function instColor(i){return 'hsl('+Math.round((1-i)*120)+',65%,'+Math.round(46+i*8)+'%)';}" +
-    "function radius(n){return 4+Math.sqrt(n.symbols||0)*1.7;}" +
-    "function tick(){if(!sim.length)return;var k=0.0016;for(var i=0;i<sim.length;i++){var a=sim[i];a.vx+=(W/2-a.x)*k;a.vy+=(H/2-a.y)*k;for(var j=i+1;j<sim.length;j++){var b=sim[j];var dx=a.x-b.x,dy=a.y-b.y,d2=dx*dx+dy*dy;if(d2<100)d2=100;var d=Math.sqrt(d2),f=2200/d2,fx=f*dx/d,fy=f*dy/d;a.vx+=fx;a.vy+=fy;b.vx-=fx;b.vy-=fy;}}" +
-    "links.forEach(function(l){var a=byId[l.source],b=byId[l.target];if(!a||!b)return;var dx=b.x-a.x,dy=b.y-a.y,d=Math.sqrt(dx*dx+dy*dy)+0.01,f=(d-90)*0.02,fx=f*dx/d,fy=f*dy/d;a.vx+=fx;a.vy+=fy;b.vx-=fx;b.vy-=fy;});" +
-    "for(var i=0;i<sim.length;i++){var n=sim[i];if(n===drag)continue;n.vx*=0.85;n.vy*=0.85;if(n.vx>30)n.vx=30;if(n.vx<-30)n.vx=-30;if(n.vy>30)n.vy=30;if(n.vy<-30)n.vy=-30;n.x+=n.vx;n.y+=n.vy;}}" +
-    "function bb4(arr){var a=1e9,b=1e9,c2=-1e9,d2=-1e9;for(var i=0;i<arr.length;i++){var n=arr[i];if(n.x<a)a=n.x;if(n.y<b)b=n.y;if(n.x>c2)c2=n.x;if(n.y>d2)d2=n.y;}return[a,b,c2,d2];}" +
-    "function layoutOrphans(){if(!orphans.length)return;var bb=sim.length?bb4(sim):[W*0.3,H*0.3,W*0.7,H*0.5];var left=bb[0],bottom=bb[3]+46,wide=Math.max(bb[2]-bb[0],260);var cols=Math.max(1,Math.ceil(Math.sqrt(orphans.length*1.8)));var gap=Math.max(22,wide/cols);for(var i=0;i<orphans.length;i++){orphans[i].x=left+(i%cols)*gap;orphans[i].y=bottom+Math.floor(i/cols)*22;}}" +
-    "function fitView(){var bb=bb4(nodes);var aw=availW();var bw=Math.max(bb[2]-bb[0],1),bh=Math.max(bb[3]-bb[1],1),k=Math.min(aw/(bw+70),H/(bh+70));k=Math.max(0.12,Math.min(k,2.2));view.k=k;view.x=aw/2-((bb[0]+bb[2])/2)*k;view.y=H/2-((bb[1]+bb[3])/2)*k;}" +
-    "function center(n){view.k=Math.max(view.k,0.7);view.x=availW()/2-n.x*view.k;view.y=H/2-n.y*view.k;}" +
-    "function esc(t){return String(t).replace(/&/g,'&amp;').replace(/</g,'&lt;');}" +
-    "function rowList(ids){if(!ids||!ids.length)return '<div class=\"sym\" style=\"color:#aaa\">none</div>';return ids.slice().sort().map(function(id){return '<div class=\"row\" data-id=\"'+esc(id)+'\">'+esc(id)+'</div>';}).join('');}" +
-    "function showPanel(n){sel=n;panelOpen=true;var imp=out[n.id]||[],impBy=inn[n.id]||[];var syms=(n.syms||[]).map(function(s){var i=s.indexOf(' ');return '<div class=\"sym\"><span class=\"k\">'+esc(s.slice(0,i))+'</span> '+esc(s.slice(i+1))+'</div>';}).join('')||'<div class=\"sym\" style=\"color:#aaa\">none</div>';" +
-    "panel.innerHTML='<button id=\"close\">&times;</button>'+'<h2>'+esc(n.id.split('/').pop())+'</h2><div class=\"path\">'+esc(n.id)+'</div>'+'<div class=\"meta\">'+esc(n.lang)+' &middot; '+(n.symbols||0)+' symbols'+(deg[n.id]?' &middot; Ca '+(n.ca||0)+' &middot; Ce '+(n.ce||0)+' &middot; I '+(n.inst||0):' &middot; no in-scope deps')+'</div>'+'<h3>Imports ('+imp.length+')</h3>'+rowList(imp)+'<h3>Imported by ('+impBy.length+')</h3>'+rowList(impBy)+'<h3>Symbols</h3>'+syms;" +
-    "panel.style.display='block';}" +
-    "panel.addEventListener('click',function(e){if(e.target.id==='close'){panelOpen=false;sel=null;panel.style.display='none';autofit=true;return;}var id=e.target.getAttribute('data-id');if(id&&byId[id]){showPanel(byId[id]);center(byId[id]);}});" +
-    "function draw(){ctx.clearRect(0,0,W,H);ctx.save();ctx.translate(view.x,view.y);ctx.scale(view.k,view.k);ctx.lineWidth=0.8;" +
-    "links.forEach(function(l){var a=byId[l.source],b=byId[l.target];if(!a||!b)return;var on=sel&&(l.source===sel.id||l.target===sel.id);ctx.strokeStyle=on?'rgba(110,110,240,0.9)':'rgba(150,150,150,0.18)';ctx.beginPath();ctx.moveTo(a.x,a.y);ctx.lineTo(b.x,b.y);ctx.stroke();});" +
-    "function dot(n,orphan){var dim=(sel&&n!==sel&&(adj[sel.id]||[]).indexOf(n.id)<0)||(q&&n.id.toLowerCase().indexOf(q)<0);ctx.globalAlpha=dim?0.14:(orphan?0.55:1);ctx.beginPath();ctx.arc(n.x,n.y,orphan?3.2:radius(n),0,6.2832);ctx.fillStyle=mode==='inst'?(deg[n.id]?instColor(n.inst):'#999'):color(n.group);ctx.fill();if(n===sel||n===hover){ctx.lineWidth=2;ctx.strokeStyle='#fff';ctx.stroke();ctx.lineWidth=0.8;}}" +
-    "orphans.forEach(function(n){dot(n,true);});sim.forEach(function(n){dot(n,false);});" +
-    "ctx.globalAlpha=1;ctx.fillStyle=getComputedStyle(document.body).color;ctx.font='11px system-ui';sim.forEach(function(n){if(n===sel||n===hover||n.symbols>=14){ctx.fillText(n.id.split('/').pop(),n.x+radius(n)+3,n.y+3);}});ctx.restore();}" +
-    "function loop(){var w=innerWidth,hh=innerHeight-48;if(w&&hh&&(w!==W||hh!==H))resize();tick();tick();layoutOrphans();if(autofit)fitView();draw();var bx=bb4(nodes);document.getElementById(\"dbg\").textContent=\"W=\"+W+\" H=\"+H+\" iw=\"+innerWidth+\"x\"+innerHeight+\" dpr=\"+(devicePixelRatio||1)+\" k=\"+view.k.toFixed(2)+\" vx=\"+Math.round(view.x)+\" vy=\"+Math.round(view.y)+\" fit=\"+autofit+\" sim=\"+sim.length+\" orph=\"+orphans.length+\" worldBox=\"+Math.round(bx[0])+\",\"+Math.round(bx[1])+\"..\"+Math.round(bx[2])+\",\"+Math.round(bx[3]);requestAnimationFrame(loop);}" +
-    "function world(e){return{x:(e.clientX-view.x)/view.k,y:(e.clientY-48-view.y)/view.k};}" +
-    "function pick(p){var all=sim.concat(orphans);for(var i=all.length-1;i>=0;i--){var n=all[i];var r=(deg[n.id]?radius(n):3.2)+5;if((p.x-n.x)*(p.x-n.x)+(p.y-n.y)*(p.y-n.y)<=r*r)return n;}return null;}" +
-    "c.addEventListener('mousedown',function(e){autofit=false;var n=pick(world(e));if(n){drag=n;showPanel(n);}else{pan={x:e.clientX-view.x,y:e.clientY-view.y};}});" +
-    "c.addEventListener('dblclick',function(){panelOpen=false;sel=null;panel.style.display='none';autofit=true;});" +
-    "addEventListener('mousemove',function(e){var p=world(e);if(drag){drag.x=p.x;drag.y=p.y;drag.vx=0;drag.vy=0;}else if(pan){view.x=e.clientX-pan.x;view.y=e.clientY-pan.y;}else{hover=pick(p);if(hover){tip.style.display='block';tip.style.left=(e.clientX+12)+'px';tip.style.top=(e.clientY+12)+'px';tip.textContent=hover.id+'  ·  '+(hover.symbols||0)+' symbols  ·  '+hover.lang+(deg[hover.id]?'  ·  Ca '+hover.ca+' Ce '+hover.ce+' I '+hover.inst:'');}else tip.style.display='none';}});" +
-    "addEventListener('mouseup',function(){drag=null;pan=null;});" +
-    "c.addEventListener('wheel',function(e){e.preventDefault();autofit=false;var s=e.deltaY<0?1.1:0.9;var mx=e.clientX,my=e.clientY-48;view.x=mx-(mx-view.x)*s;view.y=my-(my-view.y)*s;view.k*=s;},{passive:false});" +
-    "document.getElementById('q').addEventListener('input',function(e){q=e.target.value.toLowerCase();});" +
-    "document.getElementById('mode').addEventListener('change',function(e){mode=e.target.value;document.getElementById('leg').style.display=mode==='inst'?'block':'none';});" +
-    "addEventListener('keydown',function(e){if(e.key==='d'&&e.target.tagName!=='INPUT'){var x=document.getElementById('dbg');x.style.display=x.style.display==='none'?'block':'none';}});loop();";
-/** Build a self-contained, dependency-free HTML graph explorer. */
-export function buildExplorerHtml(graph, root) {
-    const data = deriveFileGraph(graph);
-    const dataJson = JSON.stringify(data);
-    const title = root.split(/[\\/]/).filter(Boolean).pop() || "project";
-    return ("<!doctype html><html><head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">" +
-        "<title>AST-MCP — " + title + " graph</title><style>" + STYLE + "</style></head><body>" +
-        "<div id=\"bar\"><h1>AST-MCP graph</h1><span class=\"muted\">" + data.nodes.length + " files · " + data.links.length + " edges · drag / scroll / click</span>" +
-        "<input id=\"q\" placeholder=\"filter files…\" /><select id=\"mode\"><option value=\"group\">color: folder</option><option value=\"inst\">color: coupling</option></select></div>" +
-        "<canvas id=\"cv\"></canvas><div id=\"tip\"></div><div id=\"panel\"></div><div id=\"leg\"><b>Instability I = Ce/(Ca+Ce)</b><div class=\"bar\"></div><div style=\"display:flex;justify-content:space-between\"><span>0 = stable</span><span>1 = volatile</span></div></div><div id=\"dbg\" style=\"position:fixed;left:8px;bottom:8px;font:11px monospace;color:#e07;z-index:6;pointer-events:none;white-space:pre;display:none\"></div>" +
-        "<script>var DATA=" + dataJson + ";</script><script>" + CLIENT + "</script></body></html>");
-}

package/dist/extractors/c.js

@@ -1,204 +0,0 @@
-import { namedChildren, nameOf, headerSignature, leadingComment } from "../parser.js";
-import { makeSymbol } from "./common.js";
-/* ─── helpers ─────────────────────────────────────────────────────────────── */
-function childOfType(node, type) {
-    for (let i = 0; i < node.childCount; i++) {
-        const c = node.child(i);
-        if (c && c.type === type)
-            return c;
-    }
-    return null;
-}
-/** Recursively unwrap a declarator chain to get the identifier text. */
-function nameFromDeclarator(node) {
-    if (!node)
-        return null;
-    switch (node.type) {
-        case "identifier":
-        case "field_identifier":
-        case "type_identifier":
-            return node.text;
-        case "pointer_declarator":
-        case "array_declarator":
-        case "parenthesized_declarator":
-            return nameFromDeclarator(node.childForFieldName("declarator"));
-        case "function_declarator": {
-            const d = node.childForFieldName("declarator");
-            return nameFromDeclarator(d);
-        }
-        case "init_declarator":
-            return nameFromDeclarator(node.childForFieldName("declarator"));
-        default:
-            // best-effort: find first identifier-like child
-            for (let i = 0; i < node.namedChildCount; i++) {
-                const c = node.namedChild(i);
-                if (c && (c.type === "identifier" || c.type === "field_identifier" || c.type === "type_identifier"))
-                    return c.text;
-            }
-            return null;
-    }
-}
-function hasStaticStorage(node) {
-    for (let i = 0; i < node.childCount; i++) {
-        const c = node.child(i);
-        if (c && c.type === "storage_class_specifier" && c.text === "static")
-            return true;
-    }
-    return false;
-}
-/* ─── imports (#include) ──────────────────────────────────────────────────── */
-export function extractImportsC(root, _source) {
-    const out = [];
-    for (const child of namedChildren(root)) {
-        if (child.type !== "preproc_include")
-            continue;
-        const pathNode = childOfType(child, "system_lib_string") ?? childOfType(child, "string_literal");
-        if (!pathNode)
-            continue;
-        const raw = pathNode.text.replace(/^[<"]|[>"]$/g, "");
-        const base = raw.split("/").pop() ?? raw;
-        const sym = base.replace(/\.[hH]$|\.hpp$|\.hxx$|\.hh$/, "");
-        out.push({ symbol: sym, from: raw });
-    }
-    return out;
-}
-/* ─── symbol extraction ───────────────────────────────────────────────────── */
-export function extractC(root, _source) {
-    return collect(namedChildren(root));
-}
-function collect(nodes) {
-    const out = [];
-    for (const n of nodes) {
-        const res = handle(n);
-        if (Array.isArray(res))
-            out.push(...res);
-        else if (res)
-            out.push(res);
-    }
-    return out;
-}
-function handle(node) {
-    switch (node.type) {
-        case "struct_specifier":
-        case "union_specifier": {
-            const name = nameOf(node);
-            if (!name)
-                return null;
-            const body = node.childForFieldName("body");
-            return makeSymbol({
-                name,
-                kind: "struct",
-                node,
-                rawKind: node.type,
-                doc: leadingComment(node),
-                children: body ? structFields(body) : [],
-            });
-        }
-        case "enum_specifier": {
-            const name = nameOf(node);
-            if (!name)
-                return null;
-            return makeSymbol({
-                name,
-                kind: "enum",
-                node,
-                rawKind: node.type,
-                doc: leadingComment(node),
-            });
-        }
-        case "function_definition": {
-            const decl = node.childForFieldName("declarator");
-            const name = nameFromDeclarator(decl);
-            if (!name)
-                return null;
-            const isStatic = hasStaticStorage(node);
-            return makeSymbol({
-                name,
-                kind: "function",
-                node,
-                rawKind: node.type,
-                signature: headerSignature(node, node.childForFieldName("body")),
-                visibility: isStatic ? "private" : "public",
-                exported: !isStatic,
-                doc: leadingComment(node),
-            });
-        }
-        case "declaration": {
-            // top-level variable/function declarations (prototypes, externs, etc.)
-            const decl = node.childForFieldName("declarator");
-            const name = nameFromDeclarator(decl);
-            if (!name)
-                return null;
-            // skip function prototypes — focus on real defs (function_definition)
-            if (decl && containsFunctionDeclarator(decl))
-                return null;
-            return makeSymbol({
-                name,
-                kind: "var",
-                node,
-                rawKind: node.type,
-                signature: node.text.replace(/\s+/g, " ").replace(/;$/, "").trim(),
-                visibility: hasStaticStorage(node) ? "private" : "public",
-                exported: !hasStaticStorage(node),
-            });
-        }
-        case "preproc_def":
-        case "preproc_function_def": {
-            const name = nameOf(node);
-            if (!name)
-                return null;
-            return makeSymbol({
-                name,
-                kind: "const",
-                node,
-                rawKind: node.type,
-                signature: node.text.replace(/\s+/g, " ").trim(),
-            });
-        }
-        case "type_definition": {
-            // typedef — name is in the declarator (last identifier)
-            const decl = node.childForFieldName("declarator");
-            const name = nameFromDeclarator(decl);
-            if (!name)
-                return null;
-            return makeSymbol({
-                name,
-                kind: "type",
-                node,
-                rawKind: node.type,
-                signature: node.text.replace(/\s+/g, " ").replace(/;$/, "").trim(),
-            });
-        }
-        default:
-            return null;
-    }
-}
-function containsFunctionDeclarator(node) {
-    if (node.type === "function_declarator")
-        return true;
-    for (let i = 0; i < node.namedChildCount; i++) {
-        const c = node.namedChild(i);
-        if (c && containsFunctionDeclarator(c))
-            return true;
-    }
-    return false;
-}
-function structFields(body) {
-    const out = [];
-    for (const field of namedChildren(body)) {
-        if (field.type !== "field_declaration")
-            continue;
-        const decl = field.childForFieldName("declarator");
-        const name = nameFromDeclarator(decl);
-        if (!name)
-            continue;
-        out.push(makeSymbol({
-            name,
-            kind: "field",
-            node: field,
-            rawKind: field.type,
-            signature: field.text.replace(/\s+/g, " ").replace(/;$/, "").trim(),
-        }));
-    }
-    return out;
-}

package/dist/extractors/common.js

@@ -1,56 +0,0 @@
-export function lineRange(node) {
-    return { startLine: node.startPosition.row + 1, endLine: node.endPosition.row + 1 };
-}
-/** True if the identifier begins with an uppercase letter (Go export rule). */
-export function startsUpper(name) {
-    const c = name[0];
-    return !!c && c !== c.toLowerCase() && c === c.toUpperCase();
-}
-/** Python convention: a single leading underscore (but not dunder) means private. */
-export function pythonVisibility(name) {
-    if (name.startsWith("__") && name.endsWith("__"))
-        return "public"; // dunder
-    return name.startsWith("_") ? "private" : "public";
-}
-export function makeSymbol(init) {
-    const sym = {
-        name: init.name,
-        kind: init.kind,
-        visibility: init.visibility ?? "public",
-        range: lineRange(init.node),
-        children: init.children ?? [],
-    };
-    if (init.rawKind !== undefined)
-        sym.rawKind = init.rawKind;
-    if (init.signature !== undefined)
-        sym.signature = init.signature;
-    if (init.exported !== undefined)
-        sym.exported = init.exported;
-    if (init.doc !== undefined)
-        sym.doc = init.doc;
-    return sym;
-}
-/** Count a symbol tree, including nested children. */
-export function countSymbols(symbols) {
-    let n = 0;
-    for (const s of symbols)
-        n += 1 + countSymbols(s.children);
-    return n;
-}
-/** Strip signature/doc/rawKind for the compact "outline" detail level. */
-export function toOutline(symbols) {
-    return symbols.map((s) => {
-        const out = {
-            name: s.name,
-            kind: s.kind,
-            visibility: s.visibility,
-            range: s.range,
-            children: toOutline(s.children),
-        };
-        if (s.exported !== undefined)
-            out.exported = s.exported;
-        if (s.decorators)
-            out.decorators = s.decorators;
-        return out;
-    });
-}