@ dominis/ 转换
AST 为多姆文斯注入稳定元素ID和捆绑插件.
安装
npm install -D @domscribe/transform
说明: 您可能想要一个框架适配器
@domscribe/react, (中文(简体) ),@domscribe/vue, (中文(简体) ),@domscribe/next, (中文(简体) ),@domscribe/nuxt) (中文(简体) ). 这些软件包将这个包包裹起来,并自动处理特定框架的接线.
Bundler 支持系统
| 邦德勒语Name | 插件 | 解析器 |
|---|---|---|
| 视频 5-8 | @domscribe/transform/plugins/vite | 橡子(JS/JSX)或VueSFC |
| 网页包 5 | @domscribe/transform/plugins/webpack | 贝贝(TS/JSX)或VueSFC |
| 涡轮包装 | 自启动装入器 | 贝贝(TS/JSX) |
Vite 8相容性需要多姆文斯0.7.0或更后;npm 6.6.1声明Vite 5-7支持.
配置
共享选项——中继
这些选项适用于: relay 字段覆盖所有捆绑插件.
| 选项 | 类型 | 默认 | 说明 |
|---|---|---|---|
autoStart | boolean | true | 如果不运行则自动启动中继守护进程 |
port | number | 0 (动力学) | 中继服务器端口( 仅在启动时使用) |
host | string | '127.0.0.1' | 中继服务器主机( 仅在启动时使用) |
bodyLimit | number | 10485760 (10MB) (英语) | 最大请求体积以字节表示( 仅在开始时使用) |
共享选项——重叠
这些选项适用于 overlay 设置为对象而不是布尔.
| 选项 | 类型 | 默认 | 说明 |
|---|---|---|---|
initialMode | 'collapsed' | 'expanded' | 'collapsed' | 覆盖的初始显示模式 |
debug | boolean | false | 启用覆盖中的调试记录 |
虚拟插件
import { domscribe } from '@domscribe/transform/plugins/vite';
domscribe({
include: /\.(jsx|tsx|vue)$/i,
exclude: /node_modules|\.test\.|\.spec\./i,
debug: false,
relay: { autoStart: true, port: 0, host: '127.0.0.1', bodyLimit: 10485760 },
overlay: true,
rootDir: undefined, // Override root directory for .domscribe/ artifacts
});
| 选项 | 类型 | 默认 | 说明 |
|---|---|---|---|
include | RegExp | /\.(jsx|tsx|vue)$/i | 要包含的文件模式 |
exclude | RegExp | /node_modules|\.test\.|\.spec\./i | 要排除的文件模式 |
debug | boolean | false | 启用调试日志 |
relay | RelayPluginOptions | 见共享 | 中继服务器配置 |
overlay | boolean | OverlayPluginOptions | true | 重叠 UI 配置 |
rootDir | string | 维特的 config.root | 覆盖根目录 .domscribe/ 文物. 当 Vite 根与工程根不同时( 如自定义 Nuxt) 需要 srcDir) (中文(简体) ). |
Webpack 插件
import { DomscribeWebpackPlugin } from '@domscribe/transform/plugins/webpack';
new DomscribeWebpackPlugin({
enabled: true,
debug: false,
relay: { autoStart: true, port: 0, host: '127.0.0.1' },
overlay: true,
});
| 选项 | 类型 | 默认 | 说明 |
|---|---|---|---|
enabled | boolean | true 以表白, false 生产 | 启用插件 |
debug | boolean | false | 启用调试日志 |
relay | RelayPluginOptions | 见共享 | 中继服务器配置 |
overlay | boolean | OverlayPluginOptions | true | 重叠 UI 配置 |
Webpack 装入器选项
网络包装装载器由内部管理 DomscribeWebpackPlugin。如果需要直接通过 @domscribe/transform/webpack-loader数字 :
| 选项 | 类型 | 默认 | 说明 |
|---|---|---|---|
debug | boolean | false | 启用调试日志 |
enabled | boolean | true | 启用转换 |
涡轮包装装载器
Turbopack没有插件系统,因此加载器是自我初始化的——它直接管理接力生命周期并覆盖注射.
// next.config.ts (turbopack)
{
turbopack: {
rules: {
'*.{tsx,jsx}': {
loaders: [{
loader: '@domscribe/transform/turbopack-loader',
options: {
enabled: true,
debug: false,
relay: { autoStart: true, port: 0, host: '127.0.0.1' },
overlay: false,
autoInitPath: undefined,
},
}],
},
},
},
}
| 选项 | 类型 | 默认 | 说明 |
|---|---|---|---|
enabled | boolean | true | 启用转换 |
debug | boolean | false | 启用调试日志 |
relay | RelayPluginOptions | 见共享 | 中继服务器配置 |
overlay | boolean | OverlayPluginOptions | false | 重叠 UI 配置 。 默认为 false 与Vite/Webpack不同的是——上覆注射必须由元框包装处理. |
autoInitPath | string | undefined (倒计时) @domscribe/next/auto-init(中文(简体) ) | 自动init模块的绝对文件系统路径 。 在pnpm monrepos中被使用,其中被转换出的文件并不直接依赖于自動init包. 元框架包头应通过 require.resolve()。 。 。 . |
getInitResult()
import { getInitResult } from '@domscribe/transform/plugins/turbopack';
const result = getInitResult();
// { relayHost: string | undefined, relayPort: number | undefined }
返回加载器初始化时检测到的中继主机和端口 。 处理第一个文件后可用 。 用于元框架包装(例如, @domscribe/next)在装入器初始化后读取中继连接信息.
子路径导出
| 子路径 | 说明 |
|---|---|
@domscribe/transform/plugins/vite | 维特插件( V)domscribe(中文(简体) ) |
@domscribe/transform/plugins/webpack | Webpack 插件 (帮助)DomscribeWebpackPlugin(中文(简体) ) |
@domscribe/transform/webpack-loader | Webpack 加载器路径(字符串,直接使用) |
@domscribe/transform/plugins/turbopack | 涡轮包装出口getInitResult(中文(简体) ) |
@domscribe/transform/turbopack-loader | 涡轮包装装载器路径(字符串,直接使用) |
链接
部分 多写。 。 。 .
许可证
麻省理工学院