@component-compass/ast-utils 0.0.2 → 0.0.4

package/dist/find-owner.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Walk an oxc/ESTree program from `program` down to `target`, returning the
+ * nearest enclosing component binding.
+ *
+ * A "component binding" is a function or class declaration / variable
+ * declarator whose binding name is PascalCase, OR an anonymous `export default`.
+ *
+ * HOC wrappers (`memo`, `forwardRef`, `observer`, `React.memo`, `React.forwardRef`)
+ * are unwrapped: the binding name comes from the enclosing variable declarator,
+ * not the call expression.
+ *
+ * Returns `null` when no enclosing tracked component is found before reaching
+ * module scope (e.g. JSX at module top-level).
+ *
+ * Algorithm: walk top-down through `program`, maintaining two parallel stacks
+ * of currently-entered nodes: `pathStack` (every node) and `frameStack` (just
+ * the candidate owners — Function/Arrow/Class declarations or expressions).
+ * When the `target` node is entered, scan `frameStack` from innermost outward
+ * and return the first frame whose contextual binding satisfies the rules:
+ * PascalCase id, predicate (if any), default-export special case, HOC
+ * unwrapping. Pop both stacks in `leave`.
+ *
+ * `loc` is always returned as `null` — oxc-parser only emits byte offsets,
+ * and the sole current consumer (parser-react/walk-jsx.ts) reads only
+ * `binding.name`. If a future caller needs a line/column, thread the source
+ * string through and call `positionAt` from `./oxc-helpers.ts`.
+ */
+import type { Node as OxcNode, Program } from "@oxc-project/types";
+export type EnclosingComponentBinding = {
+    /** Binding name; `"default"` for anonymous default exports. */
+    name: string;
+    /** True for `export default ...` cases. */
+    isDefault: boolean;
+    /** Declaration site — always null (oxc-parser emits byte offsets only). */
+    loc: {
+        line: number;
+        column: number;
+    } | null;
+};
+/**
+ * Optional predicate supplied by the caller. When provided, a candidate
+ * binding is only returned if `isKnownComponent(name)` returns true; otherwise
+ * the walk continues upward. When omitted, any PascalCase binding (or
+ * anonymous `export default`) is accepted.
+ */
+export type IsKnownComponent = (name: string) => boolean;
+/**
+ * Walk an oxc/ESTree program from `program` down to `target`, returning the
+ * nearest enclosing component binding. The `target` must be a node within
+ * `program`. Reference equality is used to detect arrival.
+ */
+export declare function findEnclosingComponentBinding(target: OxcNode, program: Program, isKnownComponent?: IsKnownComponent): EnclosingComponentBinding | null;

package/dist/find-owner.js

@@ -0,0 +1,156 @@
+import { walk } from "oxc-walker";
+const HOC_NAMES = new Set(["memo", "forwardRef", "observer"]);
+/**
+ * Walk an oxc/ESTree program from `program` down to `target`, returning the
+ * nearest enclosing component binding. The `target` must be a node within
+ * `program`. Reference equality is used to detect arrival.
+ */
+export function findEnclosingComponentBinding(target, program, isKnownComponent) {
+    const pathStack = [];
+    // Frames hold the candidate node plus the pathStack depth at which it was
+    // pushed, so binding-evaluation can look up parents/grandparents at scan
+    // time without re-discovering them.
+    const frameStack = [];
+    let result = null;
+    let done = false;
+    walk(program, {
+        enter(node) {
+            if (done) {
+                this.skip?.();
+                return;
+            }
+            pathStack.push(node);
+            // Arrival check — must happen BEFORE pushing the target's own frame, so
+            // a candidate-shaped target (e.g. an ArrowFunctionExpression passed in
+            // by a caller) is not considered its own owner.
+            if (node === target) {
+                result = scanFrameStack(frameStack, pathStack, isKnownComponent);
+                done = true;
+                this.skip?.();
+                return;
+            }
+            if (isOwnerCandidateNode(node)) {
+                frameStack.push({ node, depth: pathStack.length - 1 });
+            }
+        },
+        leave(node) {
+            // Pop frameStack first (it is a subset of pathStack frames).
+            const top = frameStack[frameStack.length - 1];
+            if (top && top.node === node)
+                frameStack.pop();
+            pathStack.pop();
+        },
+    });
+    return result;
+}
+function isOwnerCandidateNode(node) {
+    return (node.type === "FunctionDeclaration" ||
+        node.type === "FunctionExpression" ||
+        node.type === "ArrowFunctionExpression" ||
+        node.type === "ClassDeclaration" ||
+        node.type === "ClassExpression");
+}
+function scanFrameStack(frameStack, pathStack, isKnownComponent) {
+    for (let i = frameStack.length - 1; i >= 0; i--) {
+        const frame = frameStack[i];
+        if (!frame)
+            continue;
+        const parent = pathStack[frame.depth - 1] ?? null;
+        const grand = pathStack[frame.depth - 2] ?? null;
+        const binding = bindingForOxcFrame(frame.node, parent, grand, isKnownComponent);
+        if (binding)
+            return binding;
+    }
+    return null;
+}
+function bindingForOxcFrame(node, parent, grand, isKnownComponent) {
+    // class Name { … } / class Name extends Base { … }
+    if (node.type === "ClassDeclaration" || node.type === "ClassExpression") {
+        const cls = node;
+        const id = cls.id;
+        if (id && isPascalCase(id.name)) {
+            if (!isKnownComponent || isKnownComponent(id.name)) {
+                return { name: id.name, isDefault: false, loc: null };
+            }
+        }
+        if (parent?.type === "ExportDefaultDeclaration") {
+            if (!isKnownComponent || isKnownComponent("default")) {
+                return { name: "default", isDefault: true, loc: null };
+            }
+        }
+        return null;
+    }
+    // function Name() { … }
+    if (node.type === "FunctionDeclaration") {
+        const fn = node;
+        const id = fn.id;
+        if (parent?.type === "ExportDefaultDeclaration") {
+            const name = id && isPascalCase(id.name) ? id.name : "default";
+            if (!isKnownComponent || isKnownComponent(name)) {
+                return { name, isDefault: true, loc: null };
+            }
+        }
+        if (id && isPascalCase(id.name)) {
+            if (!isKnownComponent || isKnownComponent(id.name)) {
+                return { name: id.name, isDefault: false, loc: null };
+            }
+        }
+        return null;
+    }
+    // (...) => …  /  function () { … }  (anonymous), examined by its context.
+    if (node.type === "ArrowFunctionExpression" || node.type === "FunctionExpression") {
+        return bindingFromAnonymousFunctionParent(parent, grand, isKnownComponent);
+    }
+    return null;
+}
+function bindingFromAnonymousFunctionParent(parent, grand, isKnownComponent) {
+    if (!parent)
+        return null;
+    if (parent.type === "VariableDeclarator" && parent.id.type === "Identifier") {
+        return bindingFromVariableId(parent.id.name, isKnownComponent);
+    }
+    if (parent.type === "CallExpression" && isHocCall(parent)) {
+        if (!grand)
+            return null;
+        if (grand.type === "VariableDeclarator" && grand.id.type === "Identifier") {
+            return bindingFromVariableId(grand.id.name, isKnownComponent);
+        }
+        if (grand.type === "ExportDefaultDeclaration") {
+            if (!isKnownComponent || isKnownComponent("default")) {
+                return { name: "default", isDefault: true, loc: null };
+            }
+        }
+        return null;
+    }
+    if (parent.type === "ExportDefaultDeclaration") {
+        if (!isKnownComponent || isKnownComponent("default")) {
+            return { name: "default", isDefault: true, loc: null };
+        }
+    }
+    return null;
+}
+function bindingFromVariableId(name, isKnownComponent) {
+    if (!isPascalCase(name))
+        return null;
+    if (isKnownComponent && !isKnownComponent(name))
+        return null;
+    return { name, isDefault: false, loc: null };
+}
+function isHocCall(call) {
+    if (call.type !== "CallExpression")
+        return false;
+    const callee = call.callee;
+    if (callee.type === "Identifier")
+        return HOC_NAMES.has(callee.name);
+    if (callee.type === "MemberExpression" &&
+        callee.object.type === "Identifier" &&
+        callee.object.name === "React" &&
+        callee.property.type === "Identifier") {
+        return HOC_NAMES.has(callee.property.name);
+    }
+    return false;
+}
+function isPascalCase(name) {
+    return /^[A-Z]/.test(name);
+}
+//# sourceMappingURL=find-owner.js.map

package/dist/find-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-owner.js","sourceRoot":"","sources":["../src/find-owner.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export { isElement, hasChildren } from "./parse5-guards.js";
-export { traverse } from "./babel-interop.js";
 export { posixPath } from "./posix.js";
 export { errorMessage, errorStack } from "./errors.js";
 export { classifyImportOrigin } from "./classify-import.js";
 export type { ImportOrigin, ClassifyOptions } from "./classify-import.js";
+export { findEnclosingComponentBinding } from "./find-owner.js";
+export type { EnclosingComponentBinding } from "./find-owner.js";
+export { positionAt, getJSXName, isJSXElement, isJSXFragment, isJSXAttribute, isJSXSpreadAttribute, isCallExpression, isImportDeclaration, } from "./oxc-helpers.js";
+export type { Position } from "./oxc-helpers.js";

package/dist/index.js

@@ -1,6 +1,7 @@
 export { isElement, hasChildren } from "./parse5-guards.js";
-export { traverse } from "./babel-interop.js";
 export { posixPath } from "./posix.js";
 export { errorMessage, errorStack } from "./errors.js";
 export { classifyImportOrigin } from "./classify-import.js";
+export { findEnclosingComponentBinding } from "./find-owner.js";
+export { positionAt, getJSXName, isJSXElement, isJSXFragment, isJSXAttribute, isJSXSpreadAttribute, isCallExpression, isImportDeclaration, } from "./oxc-helpers.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/oxc-helpers.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Helpers for working with oxc-parser's ESTree-shaped AST. Used by every
+ * default-path plugin/detector after the Phase C migration.
+ *
+ *  - `positionAt`     — UTF-16 offset → { line, column } conversion (as emitted by oxc-parser)
+ *  - `getJSXName`     — JSXIdentifier | JSXMemberExpression | JSXNamespacedName → string
+ *  - `is*` predicates — type-narrow ESTree nodes by `type` field
+ *
+ * Keep this module dependency-free except for @oxc-project/types (type-only
+ * at runtime). All helpers work against plain ESTree-shape objects.
+ */
+import type { CallExpression, ImportDeclaration, JSXElement, JSXFragment, JSXIdentifier, JSXMemberExpression, JSXNamespacedName, JSXAttribute, JSXSpreadAttribute } from "@oxc-project/types";
+export type Position = {
+    line: number;
+    column: number;
+};
+/**
+ * Convert a UTF-16 code unit offset (as emitted by oxc-parser) into a
+ * 1-indexed line + 0-indexed column position. O(offset) — fine for emit-time
+ * use (called once per occurrence), avoid in tight walk loops. Cache by source
+ * if profile shows it matters.
+ */
+export declare function positionAt(source: string, offset: number): Position;
+export declare function isJSXElement(node: unknown): node is JSXElement;
+export declare function isJSXFragment(node: unknown): node is JSXFragment;
+export declare function isJSXAttribute(node: unknown): node is JSXAttribute;
+export declare function isJSXSpreadAttribute(node: unknown): node is JSXSpreadAttribute;
+export declare function isCallExpression(node: unknown): node is CallExpression;
+export declare function isImportDeclaration(node: unknown): node is ImportDeclaration;
+type JSXName = JSXIdentifier | JSXMemberExpression | JSXNamespacedName;
+/**
+ * Stringify a JSX element/attribute name node:
+ *   <Foo />          → "Foo"          (JSXIdentifier)
+ *   <Foo.Bar />      → "Foo.Bar"      (JSXMemberExpression)
+ *   <svg:rect />     → "svg:rect"     (JSXNamespacedName)
+ *   <a.b.c />        → "a.b.c"        (nested JSXMemberExpression)
+ */
+export declare function getJSXName(el: JSXElement | {
+    openingElement: JSXElement["openingElement"];
+} | JSXName): string;
+export {};

package/dist/oxc-helpers.js

@@ -0,0 +1,77 @@
+/**
+ * Helpers for working with oxc-parser's ESTree-shaped AST. Used by every
+ * default-path plugin/detector after the Phase C migration.
+ *
+ *  - `positionAt`     — UTF-16 offset → { line, column } conversion (as emitted by oxc-parser)
+ *  - `getJSXName`     — JSXIdentifier | JSXMemberExpression | JSXNamespacedName → string
+ *  - `is*` predicates — type-narrow ESTree nodes by `type` field
+ *
+ * Keep this module dependency-free except for @oxc-project/types (type-only
+ * at runtime). All helpers work against plain ESTree-shape objects.
+ */
+/**
+ * Convert a UTF-16 code unit offset (as emitted by oxc-parser) into a
+ * 1-indexed line + 0-indexed column position. O(offset) — fine for emit-time
+ * use (called once per occurrence), avoid in tight walk loops. Cache by source
+ * if profile shows it matters.
+ */
+export function positionAt(source, offset) {
+    let line = 1;
+    let column = 0;
+    for (let i = 0; i < offset && i < source.length; i++) {
+        if (source[i] === "\n") {
+            line++;
+            column = 0;
+        }
+        else if (source[i] === "\r") {
+            // \r\n counted via the next \n; lone \r increments line.
+            if (source[i + 1] !== "\n") {
+                line++;
+                column = 0;
+            }
+        }
+        else {
+            column++;
+        }
+    }
+    return { line, column };
+}
+export function isJSXElement(node) {
+    return node?.type === "JSXElement";
+}
+export function isJSXFragment(node) {
+    return node?.type === "JSXFragment";
+}
+export function isJSXAttribute(node) {
+    return node?.type === "JSXAttribute";
+}
+export function isJSXSpreadAttribute(node) {
+    return node?.type === "JSXSpreadAttribute";
+}
+export function isCallExpression(node) {
+    return node?.type === "CallExpression";
+}
+export function isImportDeclaration(node) {
+    return node?.type === "ImportDeclaration";
+}
+/**
+ * Stringify a JSX element/attribute name node:
+ *   <Foo />          → "Foo"          (JSXIdentifier)
+ *   <Foo.Bar />      → "Foo.Bar"      (JSXMemberExpression)
+ *   <svg:rect />     → "svg:rect"     (JSXNamespacedName)
+ *   <a.b.c />        → "a.b.c"        (nested JSXMemberExpression)
+ */
+export function getJSXName(el) {
+    const name = "openingElement" in el ? el.openingElement.name : el;
+    return stringifyJSXName(name);
+}
+function stringifyJSXName(name) {
+    if (name.type === "JSXIdentifier")
+        return name.name;
+    if (name.type === "JSXNamespacedName") {
+        return `${name.namespace.name}:${name.name.name}`;
+    }
+    // JSXMemberExpression — may be nested
+    return `${stringifyJSXName(name.object)}.${name.property.name}`;
+}
+//# sourceMappingURL=oxc-helpers.js.map

package/dist/oxc-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oxc-helpers.js","sourceRoot":"","sources":["../src/oxc-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,MAAc;IACvD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrD,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,EAAE,CAAC;YACP,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9B,yDAAyD;YACzD,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC3B,IAAI,EAAE,CAAC;gBACP,MAAM,GAAG,CAAC,CAAC;YACb,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,OAAQ,IAAa,EAAE,IAAI,KAAK,YAAY,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAQ,IAAa,EAAE,IAAI,KAAK,aAAa,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAQ,IAAa,EAAE,IAAI,KAAK,cAAc,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,OAAQ,IAAa,EAAE,IAAI,KAAK,oBAAoB,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAQ,IAAa,EAAE,IAAI,KAAK,gBAAgB,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAQ,IAAa,EAAE,IAAI,KAAK,mBAAmB,CAAC;AACtD,CAAC;AAID;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,EAA2E;IAE3E,MAAM,IAAI,GAAG,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAE,EAAc,CAAC;IAC/E,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAa;IACrC,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACpD,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACtC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IACD,sCAAsC;IACtC,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAiB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC7E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@component-compass/ast-utils",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Shared AST utilities for component-compass parsers and manifest plugins. Internal infrastructure.",
   "license": "MIT",
   "type": "module",
@@ -24,12 +24,13 @@
     "clean": "rm -rf dist .turbo"
   },
   "dependencies": {
-    "@babel/traverse": "^7.29.0",
+    "@oxc-project/types": "^0.130.0",
+    "oxc-walker": "^1.0.0",
     "parse5": "^8.0.0"
   },
   "devDependencies": {
-    "@types/babel__traverse": "^7.28.0",
     "@types/node": "^24.0.0",
+    "oxc-parser": "^0.130.0",
     "typescript": "^5.9.0",
     "vitest": "^4.0.0"
   },

package/dist/babel-interop.d.ts

@@ -1,2 +0,0 @@
-import type traverseType from "@babel/traverse";
-export declare const traverse: typeof traverseType.default;

package/dist/babel-interop.js

@@ -1,15 +0,0 @@
-import { createRequire } from "node:module";
-/**
- * @babel/traverse is a CJS-only package ("type": "commonjs"). Under our
- * module: NodeNext setup, Node's CJS-from-ESM default-import interop puts
- * module.exports itself on the default binding (not module.exports.default),
- * so the bare `import traverse from "@babel/traverse"` shape used in the
- * Babel docs fails at call time. Babel docs assume bundler/esModuleInterop
- * context, which auto-unwraps default — Node-native ESM does not.
- *
- * createRequire is Node's official escape hatch for loading CJS from ESM.
- * Vitest also implements it. No runtime branching needed.
- */
-const require = createRequire(import.meta.url);
-export const traverse = require("@babel/traverse").default;
-//# sourceMappingURL=babel-interop.js.map

package/dist/babel-interop.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"babel-interop.js","sourceRoot":"","sources":["../src/babel-interop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;GAUG;AACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,QAAQ,GAAgC,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC"}