Neba UI

关于这个项目

Neba UI 是一个用来搭建应用界面的 React 组件库。按钮与表单控件、菜单与对话框、表格与标签页、图表、进度与通知——真实产品需要的部件都在其中，且样式已经定好、可访问性已经具备、彼此之间已经协调。界面是被组装出来的，而不是被重新设计一遍。它也备齐了 AI 智能体界面需要的东西——提示词输入框、流式文本、工具调用、审批请求、推理面板和步骤列表——位于 neba/a2ui 的 A2UI 渲染器则把智能体用 JSON 描述的界面变成 Neba 组件。

每个组件都取自同一套词汇。size、color、variant、density 和 elevation 在任何地方含义相同，所以中号控件在任何组件上都是同样的高度，主色在任何地方都是同一种颜色。角色、标签、焦点管理与键盘操作住在组件内部，而不是事后补上；深色模式无需编写任何东西，跟随系统。它的外观是一门设计语言而非一份主题文件：带细边的半透明表面、一种统一的动效、以及必须主动索取才会出现的阴影。

安装是一个包加一行 CSS。根部没有 Provider，没有要拼装的主题对象，也没有配置文件。这个包仅提供 ESM，附带 TypeScript 类型定义，并且是真正可摇树的——每个组件都编译成自己的模块，导入一个按钮大约就只付一个按钮的代价。它运行在 React 18 或 19 上，带两个运行时依赖；A2UI 渲染器另带三个可选的同级依赖，从不导入它的项目也就从不解析它们。每个组件的文档配的都是能真正运行的示例而非截图。

功能

• 文档站点

• TypeScript 类型

• 多语言支持

• 经测试验证

• 内置无障碍支持

• 深色模式

• 支持摇树优化