universal-ast-mapper 1.3.0 → 1.5.0

package/README.md

@@ -605,6 +605,8 @@ Not part of the public API: the internal `src/` module layout and the generated
 
 | Version | What changed |
 |---------|--------------|
+| **1.5.0** | **`.d.ts` / ambient declarations** — `declare function/const/class`, `declare module "x"`, and `declare namespace` (and plain `namespace`) are now extracted (previously a `.d.ts` yielded 0 symbols). Adds a `namespace` symbol kind; declared APIs surface as exported, nested under their module/namespace. |
+| **1.4.0** | **Dynamic import tracking** — dynamic `import("...")` and CommonJS `require("...")` calls (anywhere in a file) are now captured as imports with an `isDynamic` flag. Relative dynamic imports resolve and draw graph edges like static ones, so lazy-loaded routes/modules show up in the dependency graph. |
 | **1.3.0** | **TS/JS decorators** — class and method symbols now carry a `decorators` field (`@Component({...})`, `@Injectable()`, `@Get("/x")`), in skeletons and `get_call_graph`. Extends the Python decorator support (v0.8.7) to TypeScript/JavaScript — traces Angular/NestJS-style framework wiring to its class/handler. |
 | **1.2.0** | **File-level cross-package resolution** — in a monorepo, bare imports of a workspace package (`@org/utils`, `@org/utils/sub`) now resolve to the actual source file (preferring `src/` over built `dist/`), so `resolve_imports` marks them in-project and `build_symbol_graph` draws cross-package edges. Builds on the v1.1.0 workspace discovery. |
 | **1.1.0** | **Monorepo support** — new `analyze_workspace` MCP tool + `ast-map workspace` (alias `ws`) CLI: discovers packages from npm/yarn `workspaces`, `pnpm-workspace.yaml`, or `lerna.json`, maps internal package dependencies, and flags circular package deps. **19 MCP tools**. |

package/dist/extractors/typescript.js

@@ -147,6 +147,38 @@ function handle(node, exported, typeIndex) {
             }
             return null;
         }
+        case "ambient_declaration":
+            // `.d.ts` / `declare ...` — surface the declared API as exported.
+            return collect(namedChildren(node), true, typeIndex);
+        case "function_signature": {
+            const name = nameOf(node) ?? "(function)";
+            return makeSymbol({
+                name,
+                kind: "function",
+                node,
+                rawKind: node.type,
+                signature: node.text.replace(/\s+/g, " ").replace(/;\s*$/, "").trim(),
+                exported,
+                doc: leadingComment(node),
+            });
+        }
+        case "module": // declare module "name" { ... }
+        case "internal_module": { // namespace Name { ... }
+            const nameNode = node.childForFieldName("name");
+            const rawName = nameNode ? nameNode.text : "(namespace)";
+            const name = rawName.replace(/^['"`]|['"`]$/g, "");
+            const body = node.childForFieldName("body");
+            const children = body ? collect(namedChildren(body), false, typeIndex) : [];
+            return makeSymbol({
+                name,
+                kind: "namespace",
+                node,
+                rawKind: node.type,
+                exported,
+                doc: leadingComment(node),
+                children,
+            });
+        }
         default:
             return null;
     }
@@ -200,6 +232,18 @@ function fromVariableDeclaration(node, exported, typeIndex) {
                 doc: leadingComment(node),
             }));
         }
+        else if (exported && !value && decl.childForFieldName("type")) {
+            // Ambient `declare const X: T` — no initializer, but part of the typed API.
+            out.push(makeSymbol({
+                name,
+                kind: "const",
+                node: decl,
+                rawKind: `${node.type}>declare`,
+                signature: decl.text.replace(/\s+/g, " ").trim().slice(0, 120),
+                exported: true,
+                doc: leadingComment(node),
+            }));
+        }
     }
     return out;
 }
@@ -213,8 +257,50 @@ export function extractImportsTS(root, _source) {
         else if (child.type === "export_statement")
             parseReExportStatement(child, imports);
     }
+    collectDynamicImports(root, imports);
     return imports;
 }
+/** First string-literal argument of a call's `arguments` node, or null. */
+function firstStringArg(args) {
+    for (let i = 0; i < args.namedChildCount; i++) {
+        const a = args.namedChild(i);
+        if (a && a.type === "string") {
+            for (let j = 0; j < a.namedChildCount; j++) {
+                const frag = a.namedChild(j);
+                if (frag && frag.type === "string_fragment")
+                    return frag.text;
+            }
+            return a.text.replace(/^['"`]|['"`]$/g, "");
+        }
+    }
+    return null;
+}
+/**
+ * Walk the whole tree for dynamic `import("...")` and CommonJS `require("...")`
+ * calls (they can appear anywhere, not just at the top level). Only string-literal
+ * specifiers are captured; computed requires are skipped.
+ */
+function collectDynamicImports(node, out) {
+    if (node.type === "call_expression") {
+        const fn = node.childForFieldName("function");
+        const args = node.childForFieldName("arguments");
+        if (fn && args) {
+            const isImport = fn.type === "import";
+            const isRequire = fn.type === "identifier" && fn.text === "require";
+            if (isImport || isRequire) {
+                const spec = firstStringArg(args);
+                if (spec !== null) {
+                    out.push({ symbol: "*", from: spec, isNamespaceImport: true, isDynamic: true });
+                }
+            }
+        }
+    }
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const c = node.namedChild(i);
+        if (c)
+            collectDynamicImports(c, out);
+    }
+}
 function parseReExportStatement(node, out) {
     const source = extractModulePath(node.text);
     if (!source)

package/dist/html.js

@@ -9,6 +9,7 @@ const KIND_COLORS = {
     const: "#65a30d",
     var: "#ca8a04",
     field: "#64748b",
+    namespace: "#9333ea",
 };
 function esc(s) {
     return s

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-ast-mapper",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "MCP server that maps source files into a normalized code skeleton (JSON + HTML) using tree-sitter.",
   "type": "module",
   "main": "dist/index.js",