universal-ast-mapper 1.2.0 → 1.3.0

package/README.md

@@ -605,6 +605,7 @@ Not part of the public API: the internal `src/` module layout and the generated
 
 | Version | What changed |
 |---------|--------------|
+| **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**. |
 | **1.0.0** | **Stable release.** Locks the public API (MCP tool names + schemas, CLI surface) for the 1.x line. Adds a **GitHub Action** (`action.yml`) to run `ast-map validate` as a CI architecture gate, plus a project CI workflow. Caps a 12-language engine with 18 MCP tools / 17 CLI commands spanning skeletons, dependency graphs, and deep analysis (dead code · cycles · impact · complexity · duplicates · unused params · decorators · type flow). |

package/dist/extractors/typescript.js

@@ -47,7 +47,7 @@ function handle(node, exported, typeIndex) {
             const name = nameOf(node) ?? "(anonymous class)";
             const body = node.childForFieldName("body");
             const children = body ? collect(namedChildren(body), false, typeIndex) : [];
-            return makeSymbol({
+            const clsSym = makeSymbol({
                 name,
                 kind: "class",
                 node,
@@ -56,6 +56,8 @@ function handle(node, exported, typeIndex) {
                 doc: leadingComment(node),
                 children,
             });
+            attachDecorators(clsSym, node);
+            return clsSym;
         }
         case "interface_declaration": {
             const name = nameOf(node) ?? "(anonymous interface)";
@@ -114,7 +116,7 @@ function handle(node, exported, typeIndex) {
         case "abstract_method_signature": {
             const name = nameOf(node) ?? "(method)";
             const body = node.childForFieldName("body");
-            return makeSymbol({
+            const mSym = makeSymbol({
                 name,
                 kind: "method",
                 node,
@@ -123,6 +125,8 @@ function handle(node, exported, typeIndex) {
                 visibility: memberVisibility(node),
                 doc: leadingComment(node),
             });
+            attachDecorators(mSym, node);
+            return mSym;
         }
         case "public_field_definition":
         case "field_definition": {
@@ -454,3 +458,34 @@ function attachComponentInfo(sym, funcNode, declNode, name, idx) {
     if (resolved)
         sym.props = resolved;
 }
+// ─── TS/JS decorators ─────────────────────────────────────────────────────────
+/** Strip the leading `@` and collapse whitespace from a decorator node. */
+function decoratorText(node) {
+    return node.text.replace(/^@\s*/, "").replace(/\s+/g, " ").trim();
+}
+/**
+ * Attach decorators to a class/method symbol. TS decorators appear either as
+ * preceding sibling `decorator` nodes (classes, methods) or as leading child
+ * decorators (some grammars) — collect both.
+ */
+function attachDecorators(sym, node) {
+    const decs = [];
+    // leading child decorators
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const c = node.namedChild(i);
+        if (c && c.type === "decorator")
+            decs.push(decoratorText(c));
+        else if (c && c.type !== "decorator")
+            break;
+    }
+    // preceding sibling decorators (most common for classes/methods)
+    let prev = node.previousNamedSibling;
+    const lead = [];
+    while (prev && prev.type === "decorator") {
+        lead.unshift(decoratorText(prev));
+        prev = prev.previousNamedSibling;
+    }
+    const all = [...lead, ...decs].filter((t) => t.length > 0);
+    if (all.length > 0)
+        sym.decorators = all;
+}

package/package.json

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