@actview/plugin-babel 1.0.7 → 2.1.0

package/README.md

@@ -42,10 +42,32 @@ const result = babel.transformSync(code, {
 | 导出 | 说明 |
 |---|---|
 | `defineComponentPlugin`（默认导出同） | Babel 插件工厂：组件 → `defineComponent` 转换 |
-| `createBabelTransform(plugin)` | 宿主壳工厂：模块级创建一次 ConfigItem，返回 `(code, filename) => { code, map } \| null` |
+| `createBabelTransform(plugin, options?)` | 宿主壳工厂：模块级创建一次 ConfigItem，返回 `(code, filename) => { code, map } \| null` |
 | `createBabelItem(plugin)` | 把插件工厂预编译为 ConfigItem（Babel 8 同步） |
-| `transformWithBabel(code, filename, pluginItem)` | 统一参数的 `transformSync` |
-| 类型：`BabelPlugin` / `BabelHostResult` | 宿主壳类型 |
+| `transformWithBabel(code, filename, pluginItem, options?)` | 统一参数的 `transformSync` |
+| `isExcludedTransform(filename, options?)` | 排除判定：node_modules 硬排除 / 未命中 include / 命中 exclude |
+| 类型：`BabelPlugin` / `BabelHostResult` / `BabelTransformOptions` | 宿主壳类型 |
+
+## 排除规则（node_modules 硬排除）
+
+宿主壳**硬排除 node_modules 下的文件**（返回 `null` 不转换）：依赖是第三方代码，属依赖管线（esbuild 预构建），不是源码管线——`babel-loader` / `@rollup/plugin-babel` 同款默认。`BabelTransformOptions`：
+
+```ts
+{
+  include?: Array<string | RegExp>,  // 白名单：命中任一才转换（默认不过滤；node_modules 硬排除优先）
+  exclude?: Array<string | RegExp>,  // 黑名单：命中任一即跳过（优先于 include）
+}
+```
+
+**源码分发库包 / 主题包（node_modules 下）需要现场编译时**，不在插件层开洞，而是在宿主构建配置里做**路径转换**，让文件解析路径脱离 node_modules 段、进入源码管线：
+
+```ts
+// vite.config.ts
+resolve: {
+  alias: { 'my-lib': 'node_modules/my-lib/src' }, // 路径不再含 node_modules 段 → 正常转换
+},
+optimizeDeps: { exclude: ['my-lib'] },            // 不预构建，保持源码形态
+```
 
 ## 依赖关系
 

package/dist/index.d.ts

@@ -21,15 +21,24 @@ interface BabelHostResult {
     code: string;
     map: unknown;
 }
+/** 宿主壳排除规则（createBabelTransform / transformWithBabel 第二/四参） */
+interface BabelTransformOptions {
+    /** 白名单：文件命中任一规则才转换（默认不过滤；node_modules 硬排除优先） */
+    include?: Array<string | RegExp>;
+    /** 黑名单：命中任一规则即跳过（优先级高于 include） */
+    exclude?: Array<string | RegExp>;
+}
+/** 是否应跳过转换：node_modules 硬排除 / 未命中 include / 命中 exclude */
+declare function isExcludedTransform(filename: string, options?: BabelTransformOptions): boolean;
 /** 把插件工厂预编译为 ConfigItem（Babel 8 同步版本，可跨多次 transformSync 复用） */
 declare function createBabelItem(plugin: BabelPlugin): PluginItem;
-/** 统一参数的 transformSync：失败返回 null，成功返回 { code, map } */
-declare function transformWithBabel(code: string, filename: string, pluginItem: PluginItem): BabelHostResult | null;
+/** 统一参数的 transformSync：排除命中或失败返回 null，成功返回 { code, map } */
+declare function transformWithBabel(code: string, filename: string, pluginItem: PluginItem, options?: BabelTransformOptions): BabelHostResult | null;
 /**
  * 静态插件的便捷工厂：模块级调用一次，ConfigItem 只创建一次。
  * 适用于插件对象不随文件变化的场景（如 defineComponentPlugin）。
  */
-declare function createBabelTransform(plugin: BabelPlugin | BabelPlugin[]): (code: string, filename: string) => BabelHostResult | null;
+declare function createBabelTransform(plugin: BabelPlugin | BabelPlugin[], options?: BabelTransformOptions): (code: string, filename: string) => BabelHostResult | null;
 
 declare function solidPlugin(): {
     visitor: {
@@ -40,4 +49,4 @@ declare function solidPlugin(): {
     };
 };
 
-export { type BabelHostResult, createBabelItem, createBabelTransform, defineComponentPlugin as default, defineComponentPlugin, solidPlugin, transformWithBabel };
+export { type BabelHostResult, type BabelTransformOptions, createBabelItem, createBabelTransform, defineComponentPlugin as default, defineComponentPlugin, isExcludedTransform, solidPlugin, transformWithBabel };

package/dist/index.js

@@ -130,9 +130,10 @@ function defineComponentPlugin() {
         if (!node.id) return;
         const name = node.id.name;
         if (!/^[A-Z]/.test(name)) return;
+        assertNoSetupStyleEarlyReturns(path, name);
         const fn = t.functionExpression(null, node.params, node.body, false, false);
         if (node.typeParameters) fn.typeParameters = node.typeParameters;
-        const wrapped = wrapComponentFn(fn, name);
+        const wrapped = wrapComponentFn(fn, name, path);
         if (!wrapped) return;
         const call = wrapped;
         hasTransformed = true;
@@ -153,11 +154,12 @@ function defineComponentPlugin() {
         const init = node.init;
         const isFn = t.isFunctionExpression(init) || t.isArrowFunctionExpression(init);
         if (!isFn) return;
-        const wrapped = wrapComponentFn(init, id.name);
+        const initPath = path.get("init");
+        assertNoSetupStyleEarlyReturns(initPath, id.name);
+        const wrapped = wrapComponentFn(init, id.name, initPath);
         if (!wrapped) return;
         const call = wrapped;
         hasTransformed = true;
-        const initPath = path.get("init");
         wrapEarlyReturns(initPath);
         node.init = call;
       },
@@ -184,18 +186,19 @@ function defineComponentPlugin() {
           ;
           fn.typeParameters = decl.typeParameters;
         }
-        const wrapped = wrapComponentFn(fn);
+        const declPath = path.get("declaration");
+        assertNoSetupStyleEarlyReturns(declPath);
+        const wrapped = wrapComponentFn(fn, void 0, path);
         if (!wrapped) return;
         const call = wrapped;
         hasTransformed = true;
-        const declPath = path.get("declaration");
         wrapEarlyReturns(declPath);
         path.node.declaration = call;
       }
     }
   };
 }
-function wrapComponentFn(fn, name) {
+function wrapComponentFn(fn, name, fnPath) {
   const body = fn.body;
   const isExprBody = !t.isBlockStatement(body);
   let last = null;
@@ -214,7 +217,13 @@ function wrapComponentFn(fn, name) {
   const isJsxCall = t.isCallExpression(ret) && t.isIdentifier(ret.callee) && /^_?jsx/.test(ret.callee.name);
   const isNullRet = t.isNullLiteral(ret);
   const isCondRet = isRenderExpr(ret);
-  if (!isJsx && !isJsxCall && !isNullRet && !isCondRet) return null;
+  if (!isJsx && !isJsxCall && !isNullRet && !isCondRet) {
+    const returnsFn = t.isArrowFunctionExpression(ret) || t.isFunctionExpression(ret);
+    if (returnsFn && (name !== void 0 || containsRenderNode(ret))) {
+      throw buildSetupStyleError(fnPath, name);
+    }
+    return null;
+  }
   if (isJsx) walkJSX(ret);
   if (isExprBody) {
     fn.body = t.blockStatement([
@@ -229,6 +238,54 @@ function wrapComponentFn(fn, name) {
   if (name) args.push(t.stringLiteral(name));
   return t.callExpression(t.identifier("defineComponent"), args);
 }
+function assertNoSetupStyleEarlyReturns(fnPath, name) {
+  const body = fnPath.node.body;
+  if (!t.isBlockStatement(body)) return;
+  const stmts = body.body;
+  const trailing = stmts.length ? stmts[stmts.length - 1] : null;
+  fnPath.traverse({
+    ReturnStatement(retPath) {
+      if (retPath.getFunctionParent() !== fnPath) return;
+      if (trailing && retPath.node === trailing) return;
+      const arg = retPath.node.argument;
+      if (t.isArrowFunctionExpression(arg) || t.isFunctionExpression(arg)) {
+        throw buildSetupStyleError(retPath, name);
+      }
+    }
+  });
+}
+function buildSetupStyleError(fnPath, name) {
+  const label = name ? `\u7EC4\u4EF6 ${name}` : "\u7EC4\u4EF6\u51FD\u6570";
+  const msg = `[actview] \u5DF2\u5E9F\u5F03\u7684 setup \u98CE\u683C\uFF1A${label}\u4F53\u5185 return \u4E86\u6E32\u67D3\u51FD\u6570\uFF08() => JSX / function () { JSX }\uFF09\u3002
+ActView \u53EA\u652F\u6301\u7B80\u5199\u7EC4\u4EF6\u2014\u2014\u76F4\u63A5 return JSX\uFF0C\u63D2\u4EF6\u4F1A\u81EA\u52A8\u5305\u88C5 render \u51FD\u6570\uFF1A
+
+    \u2717 function App() { return () => <div /> }
+    \u2713 function App() { return <div /> }
+`;
+  try {
+    return fnPath.buildCodeFrameError(msg);
+  } catch {
+    return new Error(msg);
+  }
+}
+function containsRenderNode(node, seen = /* @__PURE__ */ new Set()) {
+  if (!node || typeof node !== "object" || seen.has(node)) return false;
+  seen.add(node);
+  if (t.isJSXElement(node) || t.isJSXFragment(node)) return true;
+  if (t.isCallExpression(node) && t.isIdentifier(node.callee) && /^_?jsx/.test(node.callee.name)) {
+    return true;
+  }
+  for (const k in node) {
+    if (k === "leadingComments" || k === "trailingComments") continue;
+    const v = node[k];
+    if (Array.isArray(v)) {
+      if (v.some((c) => containsRenderNode(c, seen))) return true;
+    } else if (v !== null && typeof v === "object") {
+      if (containsRenderNode(v, seen)) return true;
+    }
+  }
+  return false;
+}
 function wrapEarlyReturns(fnPath) {
   fnPath.traverse({
     ReturnStatement(innerPath) {
@@ -380,10 +437,24 @@ function buildSolidMark(el, state) {
 
 // src/babel-host.ts
 import * as babel from "@babel/core";
+var NODE_MODULES_RE = /(^|[\\/])node_modules[\\/]/;
+function matchesRule(rule, filename) {
+  return typeof rule === "string" ? filename.includes(rule) : rule.test(filename);
+}
+function isExcludedTransform(filename, options) {
+  const norm = filename.replace(/\\/g, "/");
+  if (NODE_MODULES_RE.test(norm)) return true;
+  if (options?.include?.length && !options.include.some((r) => matchesRule(r, norm))) {
+    return true;
+  }
+  if (options?.exclude?.some((r) => matchesRule(r, norm))) return true;
+  return false;
+}
 function createBabelItem(plugin) {
   return babel.createConfigItemSync(plugin, { type: "plugin" });
 }
-function transformWithBabel(code, filename, pluginItem) {
+function transformWithBabel(code, filename, pluginItem, options) {
+  if (isExcludedTransform(filename, options)) return null;
   const result = babel.transformSync(code, {
     filename,
     plugins: [pluginItem],
@@ -396,9 +467,10 @@ function transformWithBabel(code, filename, pluginItem) {
   if (!result) return null;
   return { code: result.code || code, map: result.map };
 }
-function createBabelTransform(plugin) {
+function createBabelTransform(plugin, options) {
   const items = (Array.isArray(plugin) ? plugin : [plugin]).map((p) => createBabelItem(p));
   return (code, filename) => {
+    if (isExcludedTransform(filename, options)) return null;
     const result = babel.transformSync(code, {
       filename,
       plugins: items,
@@ -713,6 +785,7 @@ export {
   createBabelTransform,
   defineComponentPlugin as default,
   defineComponentPlugin,
+  isExcludedTransform,
   solidPlugin,
   transformWithBabel
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actview/plugin-babel",
-  "version": "1.0.7",
+  "version": "2.1.0",
   "type": "module",
   "description": "Babel 插件：JSX 组件自动 defineComponent 转换（ActView 编译核心，独立于 Vite 宿主）",
   "exports": {