# @javaabu/onu 中文文档

规范地址：https://npmcn.com/package/%40javaabu/onu/

版本：0\.2\.0
npm 元数据更新时间：2026-11-01T10:40:59.207Z
中文译文更新时间：2026-11-01T13:12:35.289Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：7.5 MB，1395 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：23 个
- peer 依赖：react ^19\.0\.0，shiki ^4\.5\.0，recharts ^3\.10\.1，react-dom ^19\.0\.0，@tiptap/pm ^3\.31\.4，@turf/turf ^7\.4\.0，terra-draw ^1\.37\.0，tailwindcss ^4\.0\.0，@tiptap/core ^3\.31\.4，media-chrome ^4\.19\.3，@deck\.gl/core ^9\.4\.0，@tiptap/react ^3\.31\.4，signature\_pad ^5\.1\.4，@iconify/react ^6\.0\.2，@deck\.gl/layers ^9\.4\.0，react-easy-crop ^6\.2\.4，react-hook-form ^7\.89\.0，barcode-detector ^3\.2\.2，write-excel-file ^4\.1\.1，@fullcalendar/core ^6\.1\.21，@fullcalendar/list ^6\.1\.21，@tiptap/suggestion ^3\.31\.4，@fullcalendar/react ^6\.1\.21，@tiptap/starter-kit ^3\.31\.4，@deck\.gl/google-maps ^9\.4\.0，@fullcalendar/daygrid ^6\.1\.21，@tanstack/react-query ^5\.104\.1，@fullcalendar/timegrid ^6\.1\.21，@tiptap/extension-image ^3\.31\.4，@tiptap/extension-table ^3\.31\.4，@tiptap/static-renderer ^3\.31\.4，@fullcalendar/interaction ^6\.1\.21，@vis\.gl/react-google-maps ^1\.10\.1，@fontsource-variable/geist ^5\.3\.0，@fontsource-variable/inter ^5\.3\.0，yet-another-react-lightbox ^3\.32\.2，@deck\.gl/aggregation-layers ^9\.4\.0，@googlemaps/markerclusterer ^2\.6\.2，@tiptap/extension-text-align ^3\.31\.4，@tiptap/extension-placeholder ^3\.31\.4，@fortawesome/react-fontawesome ^3\.5\.0，terra-draw-google-maps-adapter ^1\.7\.0，@fortawesome/fontawesome-svg-core ^7\.3\.1，@fontsource-variable/jetbrains-mono ^5\.3\.0，@fontsource-variable/source-serif-4 ^5\.3\.0，@fontsource-variable/noto-sans-thaana ^5\.3\.0
- 首次发布：2026-10-18T09:48:14.869Z
- 最新版本发布：2026-11-01T10:40:58.980Z
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

Javaabu的React UI组件库：基于shadcn/ UI， RTL和Dhivehi优先，thana键盘输入，单变量主题。

## 安装

```sh
npm install @javaabu/onu
```

也可以使用：`pnpm add @javaabu/onu`、`yarn add @javaabu/onu`、`bun add @javaabu/onu`

## README

# @javaabu / onu

> **Onu** (އޮނު)的意思 _竹子_ 在迪维希。

Javaabu的React UI组件库，构建于 [shadcn / ui](https://ui.shadcn.com/) 和顺风CSS v4。

-   **先说劳教和迪维希**：每个部件都能工作 `dir="rtl"`，内置了Dhivehi字符串、日期和字体。
-   **塔纳键盘输入** 在每个自由文本字段，语音（jtk兼容）或打字机布局。
-   **一个变量重新主题**： `--onu-primary`。其他所有内容的颗粒令牌。
-   **黑暗的模式**， **密度模式** （紧凑→触摸）和 **响应,触屏移动** 组件。
-   **可使用的**： WCAG 2.2 AA，用斧头测试。
-   **Lucide图标** 默认情况下，使用 **FontAwesome职业** 和Iconify适配器。

每个组件和示例页面： [onu.on-forge.com](https://onu.on-forge.com/).

## 安装

```bash
npm install @javaabu/onu react-hook-form @tanstack/react-query
# optional font pack (Inter, JetBrains Mono, Noto Sans Thaana; Faruma and MV Faseyha come with tailwind.css and styles.css)
npm install @fontsource-variable/inter @fontsource-variable/jetbrains-mono @fontsource-variable/noto-sans-thaana
```

```css
/* app.css */
@import "tailwindcss";
@import "@javaabu/onu/tailwind.css";
@import "@javaabu/onu/fonts.css"; /* optional font pack: needs the packages above */
```

```tsx
import { Button, OnuProvider, ThemeProvider } from "@javaabu/onu"
import { dv } from "@javaabu/onu/locales/dv"

export function App() {
  return (
    <ThemeProvider>
      <OnuProvider locale={dv}>
        <Button>ސޭވްކުރޭ</Button>
      </OnuProvider>
    </ThemeProvider>
  )
}
```

用一个变量重新主题：

```css
:root {
  --onu-primary: oklch(0.55 0.15 240);
}
```

## 文档

文档随包一起发布，作为与已安装版本匹配的Markdown：

-   `node_modules/@javaabu/onu/llms.txt`：设置和编写Onu代码的规则，然后每个组件，钩子和指南都用一行说明它的用途
-   `node_modules/@javaabu/onu/docs/<group>/<name>.md`：每个组件一个页面，包含其道具和可访问性说明

将你的AI编码助手指向 `llms.txt`，或使用MCP服务器 [`@javaabu/onu-mcp`](https://www.npmjs.com/package/@javaabu/onu-mcp).

## 许可证

MIT©Javaabu Pvt. Ltd。

## 常见问题

### @javaabu/onu 是什么？

Javaabu的React UI组件库：基于shadcn/ UI， RTL和Dhivehi优先，thana键盘输入，单变量主题。

### 如何安装 @javaabu/onu？

在项目目录运行 npm install @javaabu/onu，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.0\.0）、react-dom（^19\.0\.0）、tailwindcss（^4\.0\.0）、react-hook-form（^7\.89\.0）、@tanstack/react-query（^5\.104\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @javaabu/onu 支持 TypeScript 吗？

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

### @javaabu/onu 支持 ESM 还是 CommonJS？

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

### @javaabu/onu 可以商用吗？

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

### @javaabu/onu 还在维护吗？

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