@actview/plugin-babel 2.0.0 → 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

@@ -437,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],
@@ -453,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,
@@ -770,6 +785,7 @@ export {
   createBabelTransform,
   defineComponentPlugin as default,
   defineComponentPlugin,
+  isExcludedTransform,
   solidPlugin,
   transformWithBabel
 };

package/package.json

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