从 0.11 迁移到 0.12

这篇给正在使用 Blackwork 0.11 的项目。新项目直接看 快速开始 即可。

先升级 Blackwork 和 Tailwind CSS：

pnpm add blackwork@^0.12 tailwindcss@^4

如果项目有使用 blackwork/form，再安装 TanStack Form：

pnpm add @tanstack/react-form

组合 API

DialogTrigger、SheetTrigger 等触发器仍然支持 asChild。子节点请传真正的 <button> 或 Button，不要为了样式再包一层非 button 元素。

Button 仍然支持 loading。SheetContent 仍然支持 closeButtonVisible。

表单

blackwork/form 基于 TanStack Form。

1. 安装 @tanstack/react-form。
2. 如果只是通过 Blackwork 使用 react-hook-form，可以卸掉它。
3. 按 Form 使用 useAppForm、Form 和 FieldGroup。

字段布局（Field、FieldLabel、FieldGroup）不依赖任何表单库，可以单独使用。

图标

blackwork/icons 子路径已移除。通用图标从 lucide-react 引入。名称对照见 图标。

样式

Blackwork 0.12 只支持 Tailwind CSS v4。移除 blackwork/tailwind-config 和旧的 Tailwind plugin 配置，在应用样式表改用：

@import 'tailwindcss';
@import 'blackwork/tailwind.css';