# @darkalpha/nova-ui 中文文档

规范地址：https://npmcn.com/package/%40darkalpha/nova-ui/

版本：0\.9\.0
npm 元数据更新时间：2026-11-14T08:40:13.979Z
中文译文更新时间：2026-11-14T09:54:32.513Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40darkalpha/nova-ui
原文对照：https://npmcn.com/package/%40darkalpha/nova-ui/?lang=original
项目主页：https://github.com/darka1pha/nova-ui#readme
源码仓库：https://github.com/darka1pha/nova-ui

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.8 MB，409 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：7 个
- peer 依赖：react ^18\.2\.0 \|\| ^19\.0\.0，react-dom ^18\.2\.0 \|\| ^19\.0\.0，@tiptap/pm ^3\.32\.2，@tiptap/core ^3\.32\.2，@tiptap/react ^3\.32\.2，react-hook-form ^7\.55\.0，@tiptap/extensions ^3\.32\.2，@tiptap/suggestion ^3\.32\.2，@tiptap/starter-kit ^3\.32\.2，@tiptap/extension-list ^3\.32\.2，@tiptap/extension-image ^3\.32\.2，@tiptap/extension-table ^3\.32\.2，@tiptap/extension-highlight ^3\.32\.2，@tiptap/extension-subscript ^3\.32\.2，@tiptap/extension-text-align ^3\.32\.2，@tiptap/extension-text-style ^3\.32\.2，@tiptap/extension-typography ^3\.32\.2，@tiptap/extension-bubble-menu ^3\.32\.2，@tiptap/extension-superscript ^3\.32\.2
- 首次发布：2026-11-04T06:08:12.766Z
- 最新版本发布：2026-11-14T08:40:13.651Z
- 近 30 天下载量：2084（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

Nova UI设计系统的有色可取,可访问,可主题反应组件.

## 安装

```sh
npm install @darkalpha/nova-ui
```

也可以使用：`pnpm add @darkalpha/nova-ui`、`yarn add @darkalpha/nova-ui`、`bun add @darkalpha/nova-ui`

## README

# @darkalpha/nova-ui (法语)

色彩丰富,可访问,可主题反应组件.

```bash
pnpm add @darkalpha/nova-ui
```

```tsx
import { Button, ThemeProvider } from "@darkalpha/nova-ui";
import "@darkalpha/nova-ui/styles.css";

<ThemeProvider theme="ocean" brand={{ primary: "#0f766e" }}>
  <Button>Get started</Button>
</ThemeProvider>;
```

## 入境点

| 导入 | 目录 |
| --- | --- |
| `@darkalpha/nova-ui` | 组件, `ThemeProvider`, (中文(简体) ), `ThemeScript`钩子, `cn`,以及符号 API(`createTheme`, (中文(简体) ), `registerTheme`, (中文(简体) ), `auditContrast`. ) (中文(简体) ) |
| `@darkalpha/nova-ui/styles.css` | 需要一次(除非您使用) `tailwind.css`) (中文(简体) ). Tokens, 重设范围到 `.nv-theme`,以及组件样式。 没有全球飞行前. |
| `@darkalpha/nova-ui/themes.css` | 可选的 所有预设为 `[data-nv-theme="…"]` 零JS主题的块. |
| `@darkalpha/nova-ui/react-hook-form` | 反应-hook-form(任何解析器,如zod)的可选约束. 要求数 `react-hook-form` 7.55;从未被主条目装入. |
| `@darkalpha/nova-ui/rich-text-editor` | `RichTextEditor` 财务报告和审定财务报表 `RichTextViewer`,基于Tiptap/ProseMilrror。 Tiptap 是一个可选的对等依赖: 只有当您使用编辑器( 命令下面) 时才会安装它 。 它的风格已经进入了 `styles.css`。 。 。 . |
| `@darkalpha/nova-ui/kaveh` | Kaveh品牌套件(logo家族、品牌元素、页面部分、卡片)和Yalda/Nowruz季节性艺术品。 与 `kaveh`, (中文(简体) ), `kaveh-yalda` 财务报告和审定财务报表 `kaveh-nowruz` 主题. |
| `@darkalpha/nova-ui/tailwind.css` | 对于Tailwind v4应用程序, **改为** `styles.css`数字 : `@import "tailwindcss"; @import "@darkalpha/nova-ui/tailwind.css";` |

### 丰富的文本编辑器

Tiptap 没有安装 Nova UI 。 导入的应用程序 `@darkalpha/nova-ui/rich-text-editor` 加上一点:

```bash
pnpm add @tiptap/core @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/extensions @tiptap/suggestion @tiptap/extension-bubble-menu @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-subscript @tiptap/extension-superscript @tiptap/extension-table @tiptap/extension-text-align @tiptap/extension-text-style @tiptap/extension-typography
```

## 使用 Tailwind CSS v4 的应用程序

导入 `tailwind.css` 从您的 CSS 条目中删除 `styles.css` 导入 :

```css
@import "tailwindcss";
@import "@darkalpha/nova-ui/tailwind.css";
```

Nova UI号作为源头(仓库、范围基地、材料、代用品等) 作为 `bg-primary`加上一个 `@source` 对于组件,所以您的构建生成 和你的部分公用事业。 正在装入已预编译的 `styles.css` 也给你们两个分别排序的 `utilities` 分层: `.flex-col` 然后可以跟随图书馆的 `sm:flex-row` 并在每个宽度上获胜. 带有类前缀( N)`prefix(tw)`),使用时 `styles.css` 取而代之; 前缀 公用事业不能与组件相撞.

## 主题提供

| Prop | 类型 | 默认 |
| --- | --- | --- |
| `theme` | 预设名称、注册编号或 `ThemeDefinition` | `"vibrant"` |
| `brand` | `{ primary?, secondary?, accent?, neutral? }` (hex) (英语) | —— 说 |
| `overrides` | `{ light?: {...}, dark?: {...} }` 语义符号 | —— 说 |
| `mode` 编号 : `defaultMode` 编号 : `onModeChange` | `"light" | "dark" | "system"` | 主题偏好, 否则 `"system"` |
| `storageKey` | 持续模式( 以 `<ThemeScript>`(中文(简体) ) | —— 说 |
| `radius` | `"none" | "sm" | "md" | "lg" | "xl"` | 从主题 |
| `density` | `"compact" | "comfortable" | "spacious"` | 从主题 |
| `fonts` | `{ sans?, display?, mono? }` | 从主题 |
| `motion` | `"system" | "reduce"` | `"system"` |
| `dir` | `"ltr" | "rtl"` | 继承,否则 `"ltr"` |

完整的文档、符号参考和主题游乐场都在 `apps/docs`。 。 。 .

同伴依赖性 : `react` 财务报告和审定财务报表 `react-dom` 18.2+或19 (中文(简体) ).

## 常见问题

### @darkalpha/nova-ui 是什么？

Nova UI设计系统的有色可取,可访问,可主题反应组件\.

### 如何安装 @darkalpha/nova-ui？

在项目目录运行 npm install @darkalpha/nova-ui，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.2\.0 \|\| ^19\.0\.0）、react-dom（^18\.2\.0 \|\| ^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @darkalpha/nova-ui 支持 TypeScript 吗？

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

### @darkalpha/nova-ui 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @darkalpha/nova-ui 可以商用吗？

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

### @darkalpha/nova-ui 的下载量有多少？

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

### @darkalpha/nova-ui 还在维护吗？

最新版本 0\.9\.0 发布于 2026/11/14（今天）；至今共发布 13 个版本，其中过去 12 个月发布了 13 个；首次发布于 2026/11/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。