@animus-ui/unplugin

中文文档
0.1.87发布于 2026/10/24MITTypeScriptCommonJS构建来源已验证近 30 天下载 6531

Animus 将主机转换为非插件捆绑机——在一次提取会话中不以插件为基础的滚动/构建/rspack/webpack入口

中文使用文档
文档目录6 节
  1. 安装
  2. 设置( 滚动)
  3. 插件顺序
  4. 它会做什么
  5. 选项
  6. 许可证

@animus-ui/ unplugin (英语)

Animus 变换主机,用于非插剂捆绑器——滚出,起积, rspack, 和 Webpack 的切入点在一次提取会话上。 变换 @animus-ui/system 构建器链条在构建时间进入静态CSS,交付 样式表作为真实释放的资产( q)animus.css供应 __ANIMUS_DEV__ 定义.

虚拟用户: 使用 @animus-ui/vite-plugin。下一个.js用户: 使用情况 @animus-ui/next-plugin。根导出可达 .vite 适配器是 不支持 - 支撑的地表就是 4个子路径条目下面.

安装

npm install --save-dev @animus-ui/unplugin
npm install @animus-ui/system

需要节点 >=22.12.0原生引擎二进制飞船,为darwin-arm64, linux-x64-gnu,和 linux-arm64-gnu (英语).

设置( 滚动)

// rollup.config.mjs — ESM configs use the NAMED export.
import { animusRollup as animus } from '@animus-ui/unplugin/rollup';
import esbuild from 'rollup-plugin-esbuild';

export default {
  input: 'src/entry.tsx',
  plugins: [
    // The host FIRST: its transform must see raw TSX (rollup has no
    // enforce ordering — config order is the law).
    animus({ system: './src/ds.ts', strict: true }),
    esbuild({ jsx: 'automatic', target: 'es2022' }),
  ],
  output: { dir: 'dist', format: 'esm' },
};

其他捆绑者从自己的子路径遵循相同的形状: animusEsbuild 从 @animus-ui/unplugin/esbuild, (中文(简体) ), animusRspack 从 @animus-ui/unplugin/rspack, (中文(简体) ), animusWebpack 从 @animus-ui/unplugin/webpack在 CJS 配置文件中使用默认导出 :

// CJS config files:
const animus = require('@animus-ui/unplugin/rollup').default;

节点- ESM 默认 输入 CJS 构建约束导出对象, 而不是插件功能——在无害环境管理配置中,总是使用命名导出.

插件顺序

提取引擎解析 原始 TSX 数据 ——这个主机的变换必须运行 在任何TS/JSX转录之前. enforce: 'pre' 命令网络包装和rs包装 自动加载链; 滚动消费者必须列出此插件 在他们的转接器之前 在配置中。 命令错误的建筑发出 a 源驱动警告( e)transform-time source … differs from analyze-time source) 之后在 TSX 语法上进行捆绑解析错误——移动 Animus 首先要修复插件 .

它会做什么

  • 运行一个 ExtractionSession 时间 buildStart 在你的包厢里 process;每个文件的变换来自保留的引擎状态. 分析 失败就是建设失败——绝不是沉默的通过.
  • 解析样式表 id (.animus/styles.css),系统道具id, 并且每个被录取的设计系统设备包的规格调整到准确位置 分析条目提取。 配置图 paths 是别名来源.
  • 将已提取的样式表显示为真实 animus.css 资产(用于建造: 写入 outdir,或旁边 outfile) (中文(简体) ).
  • 与 stylesheets: 'split'样式表 旁边的切片 animus.css, (中文(简体) ), animus.<slice>.<hash>.css (创始人, (b) 部件、公用事业) animus-stylesheets.json,其名称链接 秩序。 秩序。 它们的字节顺序是 animus.css's; 切片编辑叶 独守其名. 后建到同一目录中可删除 切片它不再出版, 当它出版无.
  • 用品 __ANIMUS_DEV__ dev- signal 定义通过每个捆绑器 自己的机制.
  • 当字体面部声明时 preload: true输出 animus-font-preloads.json 旁边 animus.css: 预装, 如 { href, type, fetchpriority },与样式表相对. renderFontPreloads(preloads, { base, exclude }) 返回时 <link> hTML 标记, 在哪里 base 是一个 URL animus.css'目录是 任职于 exclude 列出已预加载的文档. 这个 fontPreloads 选项(姓氏,或 { family, weight?, style?, unicodeRange?, fetchpriority? })选择预先装入的面孔 联合国 preload 旗帜; 条目 fetchpriority 到达他们的标记.

选项

选项是共享驱动程序核心( S)system, (中文(简体) ), exclude, (中文(简体) ), strict, (中文(简体) ), mode, (中文(简体) ), targets, (中文(简体) ), minify,...);未知的密钥响亮失效. mode (单位:千美元)'development' | 'production'选择 仅限排放量 - 微调 默认, dev- signal 定义, 引擎 dev 诊断—— 永不处理 生命周期。 缺席时,则适用捆绑者自己的命令甲骨文(webpack/ 橡胶包 compiler.options.mode,滚动表模式),其他 production (建设显示没有信号). exclude 模式是模糊的; 列表 核可 dist, (中文(简体) ), .test. 财务报告和审定财务报表 .spec. 默认值,而 node_modules, (中文(简体) ), .next 财务报告和审定财务报表 .animus 总是适用。 无论绑匪写到哪里 总是被排除在外:它的输出目录(每个虚拟环境的, 每个输出的 dir网络包装 output.path 直至第一个 […] 占位符)及其输出文件的精确名称(outfile, (中文(简体) ), output.file网络包装, rspack, esbuilt 和Vite 命名它们之前 分析。 卷起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起 将它们排除在其第二个发展之外,以及已经 分析了1份报告(一个产出文件作为先前的输出;一个文件在内) 输出目录作为较早的输出或输出旁的源, 命名要添加的内容 exclude; 下节 strict 建造失败.

完整的消费者合同——模块化家庭、界定的合同、, 工艺品、平台矩阵——生活在 独立开采合同。 。 。 .

许可证

麻省理工学院

版本与发布记录

@animus-ui/unplugin 共发布 68 个版本,首次发布于 2026/08/20;过去 12 个月发布了 68 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.87latest2026/10/2414 天前
0.1.862026/10/2315 天前
0.1.852026/10/2315 天前
0.1.842026/10/2216 天前
0.1.832026/10/2217 天前
0.1.822026/10/2217 天前

关于 @animus-ui/unplugin 的常见问题

@animus-ui/unplugin 是什么?

Animus 将主机转换为非插件捆绑机——在一次提取会话中不以插件为基础的滚动/构建/rspack/webpack入口

如何安装 @animus-ui/unplugin?

在项目目录运行 npm install @animus-ui/unplugin,或使用 pnpm add / yarn add / bun add。

@animus-ui/unplugin 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@animus-ui/unplugin 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@animus-ui/unplugin 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@animus-ui/unplugin 可以商用吗?

@animus-ui/unplugin 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@animus-ui/unplugin 的下载量有多少?

根据 npm 官方下载统计,@animus-ui/unplugin 在 2026/10/06 – 2026/11/04 这 30 天内被下载 6,531 次,日均约 218 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@animus-ui/unplugin 还在维护吗?

最新版本 0.1.87 发布于 2026/10/24(14 天前);至今共发布 68 个版本,其中过去 12 个月发布了 68 个;首次发布于 2026/08/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。