@component-compass/ast-utils 0.0.1 → 0.0.3

package/dist/find-owner.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Walk a Babel NodePath upward to find 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).
+ */
+import type { NodePath } from "@babel/traverse";
+export type EnclosingComponentBinding = {
+    /** Binding name; `"default"` for anonymous default exports. */
+    name: string;
+    /** True for `export default ...` cases. */
+    isDefault: boolean;
+    /** Declaration site (line/column from the node's source position). */
+    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 — preserving backward compatibility.
+ */
+export type IsKnownComponent = (name: string) => boolean;
+export declare function findEnclosingComponentBinding(path: NodePath, isKnownComponent?: IsKnownComponent): EnclosingComponentBinding | null;

package/dist/find-owner.js

@@ -0,0 +1,106 @@
+const HOC_NAMES = new Set(["memo", "forwardRef", "observer"]);
+export function findEnclosingComponentBinding(path, isKnownComponent) {
+    let current = path.parentPath;
+    while (current) {
+        if (current.isClassDeclaration() || current.isClassExpression()) {
+            const node = current.node;
+            const id = node.id;
+            if (id && isPascalCase(id.name)) {
+                if (!isKnownComponent || isKnownComponent(id.name)) {
+                    return { name: id.name, isDefault: false, loc: nodeLoc(node) };
+                }
+            }
+            const parent = current.parentPath;
+            if (parent?.isExportDefaultDeclaration()) {
+                if (!isKnownComponent || isKnownComponent("default")) {
+                    return { name: "default", isDefault: true, loc: nodeLoc(node) };
+                }
+            }
+        }
+        if (current.isFunctionDeclaration()) {
+            const node = current.node;
+            const id = node.id;
+            const parent = current.parentPath;
+            if (parent?.isExportDefaultDeclaration()) {
+                const name = id && isPascalCase(id.name) ? id.name : "default";
+                if (!isKnownComponent || isKnownComponent(name)) {
+                    return {
+                        name,
+                        isDefault: true,
+                        loc: nodeLoc(node),
+                    };
+                }
+            }
+            if (id && isPascalCase(id.name)) {
+                if (!isKnownComponent || isKnownComponent(id.name)) {
+                    return { name: id.name, isDefault: false, loc: nodeLoc(node) };
+                }
+            }
+        }
+        if (current.isArrowFunctionExpression() || current.isFunctionExpression()) {
+            const binding = ownerFromFunctionExprAncestor(current, isKnownComponent);
+            if (binding)
+                return binding;
+        }
+        current = current.parentPath;
+    }
+    return null;
+}
+function ownerFromFunctionExprAncestor(path, isKnownComponent) {
+    const parent = path.parentPath;
+    if (!parent)
+        return null;
+    if (parent.isVariableDeclarator()) {
+        return bindingFromVariableDeclarator(parent.node, path.node, isKnownComponent);
+    }
+    if (parent.isCallExpression() && isHocCall(parent.node)) {
+        const grand = parent.parentPath;
+        if (!grand)
+            return null;
+        if (grand.isVariableDeclarator()) {
+            return bindingFromVariableDeclarator(grand.node, path.node, isKnownComponent);
+        }
+        if (grand.isExportDefaultDeclaration()) {
+            if (!isKnownComponent || isKnownComponent("default")) {
+                return { name: "default", isDefault: true, loc: nodeLoc(path.node) };
+            }
+        }
+    }
+    if (parent.isExportDefaultDeclaration()) {
+        if (!isKnownComponent || isKnownComponent("default")) {
+            return { name: "default", isDefault: true, loc: nodeLoc(path.node) };
+        }
+    }
+    return null;
+}
+function bindingFromVariableDeclarator(decl, fnNode, isKnownComponent) {
+    if (decl.id.type !== "Identifier")
+        return null;
+    if (!isPascalCase(decl.id.name))
+        return null;
+    if (isKnownComponent && !isKnownComponent(decl.id.name))
+        return null;
+    return { name: decl.id.name, isDefault: false, loc: nodeLoc(decl) ?? nodeLoc(fnNode) };
+}
+function isHocCall(node) {
+    const callee = node.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);
+}
+function nodeLoc(node) {
+    if (!node)
+        return null;
+    const s = node.loc?.start;
+    return s ? { line: s.line, column: s.column } : null;
+}
+//# 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":"AAgCA,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;AAE9D,MAAM,UAAU,6BAA6B,CAC3C,IAAc,EACd,gBAAmC;IAEnC,IAAI,OAAO,GAAoB,IAAI,CAAC,UAAU,CAAC;IAC/C,OAAO,OAAO,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,kBAAkB,EAAE,IAAI,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;YAChE,MAAM,IAAI,GAAG,OAAO,CAAC,IAA8C,CAAC;YACpE,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YACnB,IAAI,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnD,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjE,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;YAClC,IAAI,MAAM,EAAE,0BAA0B,EAAE,EAAE,CAAC;gBACzC,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;oBACrD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,OAAO,CAAC,IAA6B,CAAC;YACnD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;YAClC,IAAI,MAAM,EAAE,0BAA0B,EAAE,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC/D,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChD,OAAO;wBACL,IAAI;wBACJ,SAAS,EAAE,IAAI;wBACf,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC;qBACnB,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,IAAI,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnD,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjE,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,yBAAyB,EAAE,IAAI,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;YAC1E,MAAM,OAAO,GAAG,6BAA6B,CAC3C,OAAqE,EACrE,gBAAgB,CACjB,CAAC;YACF,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QAED,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,6BAA6B,CACpC,IAAgE,EAChE,gBAAmC;IAEnC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,IAAI,MAAM,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAClC,OAAO,6BAA6B,CAAC,MAAM,CAAC,IAA4B,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACzG,CAAC;IAED,IAAI,MAAM,CAAC,gBAAgB,EAAE,IAAI,SAAS,CAAC,MAAM,CAAC,IAAwB,CAAC,EAAE,CAAC;QAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,KAAK,CAAC,oBAAoB,EAAE,EAAE,CAAC;YACjC,OAAO,6BAA6B,CAAC,KAAK,CAAC,IAA4B,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACxG,CAAC;QACD,IAAI,KAAK,CAAC,0BAA0B,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,0BAA0B,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,6BAA6B,CACpC,IAA0B,EAC1B,MAAc,EACd,gBAAmC;IAEnC,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,gBAAgB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,SAAS,SAAS,CAAC,IAAsB;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpE,IACE,MAAM,CAAC,IAAI,KAAK,kBAAkB;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO;QAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY,EACrC,CAAC;QACD,OAAO,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,OAAO,CAAC,IAA+B;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC"}

package/dist/index.d.ts

@@ -4,3 +4,5 @@ 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";

package/dist/index.js

@@ -3,4 +3,5 @@ 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";
 //# 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,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;AAE5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@component-compass/ast-utils",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Shared AST utilities for component-compass parsers and manifest plugins. Internal infrastructure.",
   "license": "MIT",
   "type": "module",