@ug666/ui-react 0.3.0-beta.2 → 0.3.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (254) hide show
  1. package/LICENSE +21 -0
  2. package/dist/RELEASE_PROVENANCE.json +8 -0
  3. package/dist/ai/SKILL.md +242 -0
  4. package/dist/ai/manifest.json +815 -0
  5. package/dist/ai/references/components/accordion.md +41 -0
  6. package/dist/ai/references/components/admin-shell.md +27 -0
  7. package/dist/ai/references/components/alert.md +40 -0
  8. package/dist/ai/references/components/app-tabs.md +27 -0
  9. package/dist/ai/references/components/attachment-list.md +27 -0
  10. package/dist/ai/references/components/autocomplete.md +41 -0
  11. package/dist/ai/references/components/avatar-group.md +39 -0
  12. package/dist/ai/references/components/avatar.md +39 -0
  13. package/dist/ai/references/components/backtop.md +40 -0
  14. package/dist/ai/references/components/badge.md +43 -0
  15. package/dist/ai/references/components/bar-chart.md +41 -0
  16. package/dist/ai/references/components/breadcrumb.md +41 -0
  17. package/dist/ai/references/components/button.md +39 -0
  18. package/dist/ai/references/components/calendar.md +42 -0
  19. package/dist/ai/references/components/card.md +39 -0
  20. package/dist/ai/references/components/carousel.md +41 -0
  21. package/dist/ai/references/components/cascader.md +43 -0
  22. package/dist/ai/references/components/checkbox.md +40 -0
  23. package/dist/ai/references/components/collapse.md +41 -0
  24. package/dist/ai/references/components/color-picker.md +42 -0
  25. package/dist/ai/references/components/config-provider.md +39 -0
  26. package/dist/ai/references/components/confirm-dialog.md +27 -0
  27. package/dist/ai/references/components/container.md +39 -0
  28. package/dist/ai/references/components/context-menu.md +40 -0
  29. package/dist/ai/references/components/conversation-list.md +27 -0
  30. package/dist/ai/references/components/copy-field.md +27 -0
  31. package/dist/ai/references/components/data-panel.md +43 -0
  32. package/dist/ai/references/components/data-table-identity.md +27 -0
  33. package/dist/ai/references/components/data-table-toolbar.md +27 -0
  34. package/dist/ai/references/components/data-table.md +32 -0
  35. package/dist/ai/references/components/date-picker.md +42 -0
  36. package/dist/ai/references/components/date-range-picker.md +43 -0
  37. package/dist/ai/references/components/date-time-picker.md +40 -0
  38. package/dist/ai/references/components/descriptions.md +40 -0
  39. package/dist/ai/references/components/dialog.md +40 -0
  40. package/dist/ai/references/components/dock.md +41 -0
  41. package/dist/ai/references/components/donut-chart.md +41 -0
  42. package/dist/ai/references/components/drawer.md +41 -0
  43. package/dist/ai/references/components/dropdown.md +42 -0
  44. package/dist/ai/references/components/empty-state.md +40 -0
  45. package/dist/ai/references/components/fab.md +41 -0
  46. package/dist/ai/references/components/feature-grid.md +27 -0
  47. package/dist/ai/references/components/fieldset.md +41 -0
  48. package/dist/ai/references/components/file-input.md +41 -0
  49. package/dist/ai/references/components/form.md +42 -0
  50. package/dist/ai/references/components/gauge-chart.md +41 -0
  51. package/dist/ai/references/components/heatmap-chart.md +41 -0
  52. package/dist/ai/references/components/icon.md +39 -0
  53. package/dist/ai/references/components/image.md +41 -0
  54. package/dist/ai/references/components/index.md +171 -0
  55. package/dist/ai/references/components/indicator.md +41 -0
  56. package/dist/ai/references/components/infinite-scroll.md +42 -0
  57. package/dist/ai/references/components/input.md +42 -0
  58. package/dist/ai/references/components/join.md +40 -0
  59. package/dist/ai/references/components/kbd.md +40 -0
  60. package/dist/ai/references/components/label.md +39 -0
  61. package/dist/ai/references/components/landing-hero.md +27 -0
  62. package/dist/ai/references/components/layout.md +39 -0
  63. package/dist/ai/references/components/link.md +41 -0
  64. package/dist/ai/references/components/list.md +41 -0
  65. package/dist/ai/references/components/loading.md +40 -0
  66. package/dist/ai/references/components/message.md +27 -0
  67. package/dist/ai/references/components/modal.md +42 -0
  68. package/dist/ai/references/components/navbar.md +41 -0
  69. package/dist/ai/references/components/navigation-menu.md +41 -0
  70. package/dist/ai/references/components/notification.md +41 -0
  71. package/dist/ai/references/components/number-input.md +40 -0
  72. package/dist/ai/references/components/otp-input.md +40 -0
  73. package/dist/ai/references/components/page-header.md +27 -0
  74. package/dist/ai/references/components/pagination.md +42 -0
  75. package/dist/ai/references/components/popconfirm.md +42 -0
  76. package/dist/ai/references/components/popover.md +41 -0
  77. package/dist/ai/references/components/progress.md +41 -0
  78. package/dist/ai/references/components/prompt-composer.md +27 -0
  79. package/dist/ai/references/components/quick-access.md +30 -0
  80. package/dist/ai/references/components/radar-chart.md +41 -0
  81. package/dist/ai/references/components/radial-progress.md +41 -0
  82. package/dist/ai/references/components/radio.md +40 -0
  83. package/dist/ai/references/components/ranking-list.md +41 -0
  84. package/dist/ai/references/components/rating.md +42 -0
  85. package/dist/ai/references/components/result.md +40 -0
  86. package/dist/ai/references/components/scrollbar.md +39 -0
  87. package/dist/ai/references/components/select.md +41 -0
  88. package/dist/ai/references/components/selection-list.md +29 -0
  89. package/dist/ai/references/components/separator.md +39 -0
  90. package/dist/ai/references/components/sheet.md +40 -0
  91. package/dist/ai/references/components/sidebar.md +46 -0
  92. package/dist/ai/references/components/skeleton.md +40 -0
  93. package/dist/ai/references/components/slider.md +40 -0
  94. package/dist/ai/references/components/space.md +39 -0
  95. package/dist/ai/references/components/spinner.md +41 -0
  96. package/dist/ai/references/components/splitter.md +39 -0
  97. package/dist/ai/references/components/stack.md +41 -0
  98. package/dist/ai/references/components/stacked-bar-chart.md +41 -0
  99. package/dist/ai/references/components/statistic-card.md +41 -0
  100. package/dist/ai/references/components/statistic.md +41 -0
  101. package/dist/ai/references/components/steps.md +40 -0
  102. package/dist/ai/references/components/switch.md +40 -0
  103. package/dist/ai/references/components/table.md +41 -0
  104. package/dist/ai/references/components/tabs.md +41 -0
  105. package/dist/ai/references/components/tag.md +39 -0
  106. package/dist/ai/references/components/text.md +39 -0
  107. package/dist/ai/references/components/textarea.md +40 -0
  108. package/dist/ai/references/components/theme-configurator-dialog.md +27 -0
  109. package/dist/ai/references/components/theme-configurator.md +27 -0
  110. package/dist/ai/references/components/theme-controller.md +41 -0
  111. package/dist/ai/references/components/time-picker.md +42 -0
  112. package/dist/ai/references/components/time-range-picker.md +41 -0
  113. package/dist/ai/references/components/time-select.md +40 -0
  114. package/dist/ai/references/components/timeline.md +41 -0
  115. package/dist/ai/references/components/toast.md +39 -0
  116. package/dist/ai/references/components/tooltip.md +39 -0
  117. package/dist/ai/references/components/transfer.md +41 -0
  118. package/dist/ai/references/components/tree-select.md +45 -0
  119. package/dist/ai/references/components/tree-table.md +27 -0
  120. package/dist/ai/references/components/tree.md +43 -0
  121. package/dist/ai/references/components/trend-chart.md +41 -0
  122. package/dist/ai/references/components/upload.md +43 -0
  123. package/dist/ai/references/components.md +97 -0
  124. package/dist/ai/references/examples/data-table.md +50 -0
  125. package/dist/ai/references/release.md +158 -0
  126. package/dist/ai/ui-react.zip +0 -0
  127. package/dist/blocks/index.cjs +1 -1
  128. package/dist/blocks/index.js +1 -1
  129. package/dist/{chunk-ZDO5A2IZ.cjs → chunk-3A5O2NHW.cjs} +1 -1
  130. package/dist/chunk-3A5O2NHW.cjs.map +1 -0
  131. package/dist/chunk-3LSTRFSY.js +1 -0
  132. package/dist/chunk-3LSTRFSY.js.map +1 -0
  133. package/dist/{chunk-NRCPYVJW.js → chunk-AQJWS45G.js} +1 -1
  134. package/dist/chunk-AQJWS45G.js.map +1 -0
  135. package/dist/{chunk-UEJM2SLH.js → chunk-DJDACMBD.js} +1 -1
  136. package/dist/chunk-DJDACMBD.js.map +1 -0
  137. package/dist/{chunk-XVFRKGM7.cjs → chunk-EYSM2SU5.cjs} +1 -1
  138. package/dist/chunk-EYSM2SU5.cjs.map +1 -0
  139. package/dist/chunk-HCGUPREG.cjs +1 -0
  140. package/dist/chunk-HCGUPREG.cjs.map +1 -0
  141. package/dist/{chunk-J4NAYP4L.cjs → chunk-IOUGF444.cjs} +1 -1
  142. package/dist/{chunk-J4NAYP4L.cjs.map → chunk-IOUGF444.cjs.map} +1 -1
  143. package/dist/{chunk-JY5S7YLF.cjs → chunk-JJQENNZW.cjs} +1 -1
  144. package/dist/chunk-JJQENNZW.cjs.map +1 -0
  145. package/dist/{chunk-UESSLLSC.js → chunk-KNWHIFJE.js} +1 -1
  146. package/dist/{chunk-VDBATAZ3.js → chunk-TWOBEV2L.js} +1 -1
  147. package/dist/chunk-TWOBEV2L.js.map +1 -0
  148. package/dist/{chunk-PXVCZ6AZ.js → chunk-V4VCVCOX.js} +1 -1
  149. package/dist/{chunk-PXVCZ6AZ.js.map → chunk-V4VCVCOX.js.map} +1 -1
  150. package/dist/{chunk-UBZ2ZCEJ.cjs → chunk-YI5JDPI2.cjs} +1 -1
  151. package/dist/{chunk-UBZ2ZCEJ.cjs.map → chunk-YI5JDPI2.cjs.map} +1 -1
  152. package/dist/components/alert.d.ts +4 -5
  153. package/dist/components/alert.d.ts.map +1 -1
  154. package/dist/components/avatar.d.ts +4 -5
  155. package/dist/components/avatar.d.ts.map +1 -1
  156. package/dist/components/badge.d.ts +5 -2
  157. package/dist/components/badge.d.ts.map +1 -1
  158. package/dist/components/button.d.ts +8 -5
  159. package/dist/components/button.d.ts.map +1 -1
  160. package/dist/components/checkbox.d.ts +4 -2
  161. package/dist/components/checkbox.d.ts.map +1 -1
  162. package/dist/components/date-picker.d.ts +1 -1
  163. package/dist/components/date-picker.d.ts.map +1 -1
  164. package/dist/components/date-time-picker.d.ts +2 -2
  165. package/dist/components/date-time-picker.d.ts.map +1 -1
  166. package/dist/components/dialog.d.ts.map +1 -1
  167. package/dist/components/drawer.d.ts.map +1 -1
  168. package/dist/components/index.cjs +1 -1
  169. package/dist/components/index.cjs.map +1 -1
  170. package/dist/components/index.js +1 -1
  171. package/dist/components/number-input.d.ts +4 -2
  172. package/dist/components/number-input.d.ts.map +1 -1
  173. package/dist/components/radio.d.ts +4 -6
  174. package/dist/components/radio.d.ts.map +1 -1
  175. package/dist/components/sidebar.d.ts +1 -1
  176. package/dist/components/sidebar.d.ts.map +1 -1
  177. package/dist/components/skeleton.d.ts +4 -5
  178. package/dist/components/skeleton.d.ts.map +1 -1
  179. package/dist/components/spinner.d.ts +5 -6
  180. package/dist/components/spinner.d.ts.map +1 -1
  181. package/dist/components/tag.d.ts +5 -2
  182. package/dist/components/tag.d.ts.map +1 -1
  183. package/dist/components/time-picker.d.ts +1 -1
  184. package/dist/components/time-picker.d.ts.map +1 -1
  185. package/dist/essentials.cjs +1 -0
  186. package/dist/essentials.cjs.map +1 -0
  187. package/dist/essentials.css +2 -0
  188. package/dist/essentials.d.ts +9 -0
  189. package/dist/essentials.d.ts.map +1 -0
  190. package/dist/essentials.js +1 -0
  191. package/dist/essentials.js.map +1 -0
  192. package/dist/index.cjs +1 -1
  193. package/dist/index.cjs.map +1 -1
  194. package/dist/index.js +1 -1
  195. package/dist/internal/data-table-header.d.ts.map +1 -1
  196. package/dist/internal/date-time/date-mode-panel.d.ts.map +1 -0
  197. package/dist/internal/{date-time-control.d.ts → date-time/date-time-control.d.ts} +1 -1
  198. package/dist/internal/date-time/date-time-control.d.ts.map +1 -0
  199. package/dist/internal/date-time/date-time-range-control.d.ts.map +1 -0
  200. package/dist/internal/date-time/time-panel.d.ts.map +1 -0
  201. package/dist/internal/{admin-horizontal-navigation.d.ts → navigation/admin-horizontal-navigation.d.ts} +1 -1
  202. package/dist/internal/navigation/admin-horizontal-navigation.d.ts.map +1 -0
  203. package/dist/internal/navigation/sidebar-navigation.d.ts.map +1 -0
  204. package/dist/internal/overlay/use-floating-layout-observer.d.ts.map +1 -0
  205. package/dist/internal/overlay/use-overlay-focus.d.ts.map +1 -0
  206. package/dist/internal/overlay/use-portal-container.d.ts.map +1 -0
  207. package/dist/internal/overlay/use-presence.d.ts.map +1 -0
  208. package/dist/internal/selection/option-window.d.ts.map +1 -0
  209. package/dist/internal/{use-cascader-lazy.d.ts → selection/use-cascader-lazy.d.ts} +1 -1
  210. package/dist/internal/selection/use-cascader-lazy.d.ts.map +1 -0
  211. package/dist/internal/{use-transfer-remote.d.ts → selection/use-transfer-remote.d.ts} +1 -1
  212. package/dist/internal/selection/use-transfer-remote.d.ts.map +1 -0
  213. package/dist/internal/{use-tree-data.d.ts → selection/use-tree-data.d.ts} +1 -1
  214. package/dist/internal/selection/use-tree-data.d.ts.map +1 -0
  215. package/dist/patterns/data-table.d.ts.map +1 -1
  216. package/dist/patterns/index.cjs +1 -1
  217. package/dist/patterns/index.cjs.map +1 -1
  218. package/dist/patterns/index.js +1 -1
  219. package/dist/patterns/index.js.map +1 -1
  220. package/dist/primitives/index.cjs +1 -1
  221. package/dist/primitives/index.js +1 -1
  222. package/dist/styles.css +1 -1
  223. package/dist/tokens.css +1 -1
  224. package/package.json +12 -4
  225. package/dist/chunk-JY5S7YLF.cjs.map +0 -1
  226. package/dist/chunk-NRCPYVJW.js.map +0 -1
  227. package/dist/chunk-UEJM2SLH.js.map +0 -1
  228. package/dist/chunk-VDBATAZ3.js.map +0 -1
  229. package/dist/chunk-XVFRKGM7.cjs.map +0 -1
  230. package/dist/chunk-ZDO5A2IZ.cjs.map +0 -1
  231. package/dist/internal/admin-horizontal-navigation.d.ts.map +0 -1
  232. package/dist/internal/date-mode-panel.d.ts.map +0 -1
  233. package/dist/internal/date-time-control.d.ts.map +0 -1
  234. package/dist/internal/date-time-range-control.d.ts.map +0 -1
  235. package/dist/internal/option-window.d.ts.map +0 -1
  236. package/dist/internal/sidebar-navigation.d.ts.map +0 -1
  237. package/dist/internal/time-panel.d.ts.map +0 -1
  238. package/dist/internal/use-cascader-lazy.d.ts.map +0 -1
  239. package/dist/internal/use-floating-layout-observer.d.ts.map +0 -1
  240. package/dist/internal/use-overlay-focus.d.ts.map +0 -1
  241. package/dist/internal/use-portal-container.d.ts.map +0 -1
  242. package/dist/internal/use-presence.d.ts.map +0 -1
  243. package/dist/internal/use-transfer-remote.d.ts.map +0 -1
  244. package/dist/internal/use-tree-data.d.ts.map +0 -1
  245. /package/dist/{chunk-UESSLLSC.js.map → chunk-KNWHIFJE.js.map} +0 -0
  246. /package/dist/internal/{date-mode-panel.d.ts → date-time/date-mode-panel.d.ts} +0 -0
  247. /package/dist/internal/{date-time-range-control.d.ts → date-time/date-time-range-control.d.ts} +0 -0
  248. /package/dist/internal/{time-panel.d.ts → date-time/time-panel.d.ts} +0 -0
  249. /package/dist/internal/{sidebar-navigation.d.ts → navigation/sidebar-navigation.d.ts} +0 -0
  250. /package/dist/internal/{use-floating-layout-observer.d.ts → overlay/use-floating-layout-observer.d.ts} +0 -0
  251. /package/dist/internal/{use-overlay-focus.d.ts → overlay/use-overlay-focus.d.ts} +0 -0
  252. /package/dist/internal/{use-portal-container.d.ts → overlay/use-portal-container.d.ts} +0 -0
  253. /package/dist/internal/{use-presence.d.ts → overlay/use-presence.d.ts} +0 -0
  254. /package/dist/internal/{option-window.d.ts → selection/option-window.d.ts} +0 -0
@@ -0,0 +1,41 @@
1
+ # UGDock 底部操作坞
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`dock`。
4
+
5
+ 提供适配移动端安全区、尺寸与当前页状态的底部导航。
6
+
7
+ ## 适用场景
8
+
9
+ - 移动端需要始终可达的 3–5 个主要目的地或高频页面入口。
10
+
11
+ ## 不适用场景
12
+
13
+ - 桌面端主导航使用 Navbar/NavigationMenu/Sidebar;临时动作使用 Fab;不要承载过多入口。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGDock`、`UGDockItem`、`UGDockLabel`
19
+
20
+ ```tsx
21
+ import { UGDock, UGDockItem, UGDockLabel } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 导航根必须有可访问名称;当前页只标记一个 active 项;应用页面需保留底部安全区与内容避让。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [navbar](./navbar.md)
34
+ - [navigation-menu](./navigation-menu.md)
35
+ - [sidebar](./sidebar.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGDonutChart 环形占比图
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`donut-chart`。
4
+
5
+ 用于展示多个分类的数量、占比和总计。
6
+
7
+ ## 适用场景
8
+
9
+ - 多个分类需要同时展示数量、占比和总计。
10
+
11
+ ## 不适用场景
12
+
13
+ - 分类过多或需要精确横向比较时使用 RankingList 或 Table。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGDonutChart`
19
+
20
+ ```tsx
21
+ import { UGDonutChart } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 具体 Props、事件、插槽和默认值必须读取当前包类型与组件文档,不得猜测。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [ranking-list](./ranking-list.md)
34
+ - [radial-progress](./radial-progress.md)
35
+ - [trend-chart](./trend-chart.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGDrawer 抽屉
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`drawer`。
4
+
5
+ 从页面边缘滑出的抽屉容器。
6
+
7
+ ## 适用场景
8
+
9
+ - 从页面边缘进入的大块补充内容,方向和主轴尺寸需要控制。
10
+
11
+ ## 不适用场景
12
+
13
+ - 更约束的筛选/详情侧面板可用 Sheet;应用主导航用 Sidebar。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGDrawer`
19
+
20
+ ```tsx
21
+ import { UGDrawer } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 具体 Props、事件、插槽和默认值必须读取当前包类型与组件文档,不得猜测。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [sheet](./sheet.md)
34
+ - [sidebar](./sidebar.md)
35
+ - [modal](./modal.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,42 @@
1
+ # UGDropdownMenu 下拉菜单
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`dropdown`。
4
+
5
+ 点击触发的下拉操作菜单。
6
+
7
+ ## 适用场景
8
+
9
+ - 由按钮触发的一组命令或操作。
10
+
11
+ ## 不适用场景
12
+
13
+ - 选择业务值使用 Select;右键操作使用 ContextMenu;导航使用 NavigationMenu。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGDropdownMenu`
19
+
20
+ ```tsx
21
+ import { UGDropdownMenu } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 具体 Props、事件、插槽和默认值必须读取当前包类型与组件文档,不得猜测。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [select](./select.md)
34
+ - [context-menu](./context-menu.md)
35
+ - [navigation-menu](./navigation-menu.md)
36
+ - [popover](./popover.md)
37
+
38
+ ## 生成前检查
39
+
40
+ - 当前适配器是否真实提供该组件。
41
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
42
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,40 @@
1
+ # UGEmptyState 空状态
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`empty-state`。
4
+
5
+ 用于无数据场景的空状态组件。
6
+
7
+ ## 适用场景
8
+
9
+ - 加载完成后没有记录、没有搜索结果或尚未创建内容。
10
+
11
+ ## 不适用场景
12
+
13
+ - 数据仍在加载;使用 Skeleton 或 Spinner。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGEmptyState`
19
+
20
+ ```tsx
21
+ import { UGEmptyState } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 具体 Props、事件、插槽和默认值必须读取当前包类型与组件文档,不得猜测。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [skeleton](./skeleton.md)
34
+ - [alert](./alert.md)
35
+
36
+ ## 生成前检查
37
+
38
+ - 当前适配器是否真实提供该组件。
39
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
40
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGFab 浮动操作组
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`fab`。
4
+
5
+ 提供可控的浮动主操作与纵向或扇形快捷动作组。
6
+
7
+ ## 适用场景
8
+
9
+ - 页面存在一个高优先级主动作,或需要展开少量相关快捷动作。
10
+
11
+ ## 不适用场景
12
+
13
+ - 普通表单操作使用 Button;超过 4 个动作使用 Dropdown/Sheet;不要遮挡 Dock 和关键内容。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGFab`、`UGFabTrigger`、`UGFabActions`、`UGFabAction`
19
+
20
+ ```tsx
21
+ import { UGFab, UGFabTrigger, UGFabActions, UGFabAction } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - Trigger 必须有可访问名称;Actions/Action 必须在 Fab 内使用;业务可控制 open,选择动作默认关闭并支持 Escape。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [button](./button.md)
34
+ - [dropdown](./dropdown.md)
35
+ - [dock](./dock.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,27 @@
1
+ # UGFeatureGrid
2
+
3
+ > 包版本:0.3.0-beta.3;发布合同以当前项目实际包为准。
4
+
5
+ 能力点和功能模块网格骨架。
6
+
7
+ 只负责结构化展示,不内置产品文案和业务跳转。
8
+
9
+ ## 适用场景
10
+
11
+ - 能力点和功能模块网格骨架。
12
+
13
+ ## 不适用场景
14
+
15
+ - 先比较同一适配器的基础组件。
16
+
17
+ ## 公开导入
18
+
19
+ ```ts
20
+ import { UGFeatureGrid } from '@ug666/ui-react/blocks'
21
+ ```
22
+
23
+ ## 相关候选
24
+
25
+ - 暂无;仍需从组件目录按任务语义搜索。
26
+
27
+ - Props、事件和插槽以项目当前依赖的 TypeScript 类型为准。
@@ -0,0 +1,41 @@
1
+ # UGFieldset 字段分组
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`fieldset`。
4
+
5
+ 使用 fieldset 与 legend 对相关表单控件建立语义分组。
6
+
7
+ ## 适用场景
8
+
9
+ - 用 legend 对一组相关表单控件建立语义分组。
10
+
11
+ ## 不适用场景
12
+
13
+ - 单个字段使用组件自身 label;纯视觉卡片使用 Card。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGFieldset`、`UGFieldsetLegend`、`UGFieldsetDescription`
19
+
20
+ ```tsx
21
+ import { UGFieldset, UGFieldsetLegend, UGFieldsetDescription } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 标题使用 UGFieldsetLegend;补充说明使用 UGFieldsetDescription,不用普通 div 模拟 legend。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [file-input](./file-input.md)
34
+ - [form](./form.md)
35
+ - [card](./card.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGFileInput 文件选择
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`file-input`。
4
+
5
+ 保留原生文件选择与表单语义,并统一字段状态和 File 列表回调。
6
+
7
+ ## 适用场景
8
+
9
+ - 通过原生文件选择器收集单个或多个本地文件。
10
+
11
+ ## 不适用场景
12
+
13
+ - 拖拽上传、上传进度、对象存储请求属于业务组合,不由 FileInput 发起。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGFileInput`
19
+
20
+ ```tsx
21
+ import { UGFileInput } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 使用 accept 和 multiple 表达选择约束;上传请求、大小校验和失败重试留在业务层。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [fieldset](./fieldset.md)
34
+ - [input](./input.md)
35
+ - [form](./form.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,42 @@
1
+ # UGForm 表单
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`form`。
4
+
5
+ 组织字段语义、嵌套路径和动态数组,支持跨端校验、提交守卫与重置。
6
+
7
+ ## 适用场景
8
+
9
+ - 需要字段语义、校验、提交守卫和重置的完整表单。
10
+
11
+ ## 不适用场景
12
+
13
+ - 单个无校验控件不必强制套完整 Form。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGForm`
19
+
20
+ ```tsx
21
+ import { UGForm } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - useForm 接受点路径及数字方括号嵌套字段,fieldArray 提供稳定 UI id 的 append/insert/remove/move/replace;UI id 不进入业务值,完整提交仍校验全部规则。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [input](./input.md)
34
+ - [select](./select.md)
35
+ - [checkbox](./checkbox.md)
36
+ - [radio](./radio.md)
37
+
38
+ ## 生成前检查
39
+
40
+ - 当前适配器是否真实提供该组件。
41
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
42
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGGaugeChart 仪表盘
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`gauge-chart`。
4
+
5
+ 用于展示区间内的当前值、完成程度和目标刻度。
6
+
7
+ ## 适用场景
8
+
9
+ - 单个数值需要同时表达范围、进度与目标刻度。
10
+
11
+ ## 不适用场景
12
+
13
+ - 多个分类需要精确比较时使用 BarChart 或 RankingList。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGGaugeChart`
19
+
20
+ ```tsx
21
+ import { UGGaugeChart } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 具体 Props、事件、插槽和默认值必须读取当前包类型与组件文档,不得猜测。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [statistic-card](./statistic-card.md)
34
+ - [radial-progress](./radial-progress.md)
35
+ - [ranking-list](./ranking-list.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGHeatmapChart 热力图
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`heatmap-chart`。
4
+
5
+ 用于以二维色阶展示活跃度、密度和时间分布。
6
+
7
+ ## 适用场景
8
+
9
+ - 二维时间或分类数据需要快速发现密集区和低谷。
10
+
11
+ ## 不适用场景
12
+
13
+ - 需要精确读取全部数字时使用 Table;只有单维分类时使用 BarChart。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGHeatmapChart`
19
+
20
+ ```tsx
21
+ import { UGHeatmapChart } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 具体 Props、事件、插槽和默认值必须读取当前包类型与组件文档,不得猜测。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [bar-chart](./bar-chart.md)
34
+ - [trend-chart](./trend-chart.md)
35
+ - [table](./table.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,39 @@
1
+ # UGIcon 图标
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`icon`。
4
+
5
+ 统一尺寸、描边与语义属性的图标容器。
6
+
7
+ ## 适用场景
8
+
9
+ - 统一尺寸、描边与语义属性的图标容器。
10
+
11
+ ## 不适用场景
12
+
13
+ - 没有额外禁止场景;仍需与相关候选组件比较后选择。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/primitives`
18
+ - 公开成员:`UGIcon`
19
+
20
+ ```tsx
21
+ import { UGIcon } from '@ug666/ui-react/primitives'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 具体 Props、事件、插槽和默认值必须读取当前包类型与组件文档,不得猜测。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - 暂无;仍需从组件目录按任务语义搜索。
34
+
35
+ ## 生成前检查
36
+
37
+ - 当前适配器是否真实提供该组件。
38
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
39
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGImage 图片
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.3;状态:available;slug:`image`。
4
+
5
+ 支持加载、失败重试、适配方式和多图缩放预览。
6
+
7
+ ## 适用场景
8
+
9
+ - 展示通用图片并需要加载、失败重试或预览。
10
+
11
+ ## 不适用场景
12
+
13
+ - 没有额外禁止场景;仍需与相关候选组件比较后选择。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGImage`、`UGImageViewer`
19
+
20
+ ```tsx
21
+ import { UGImage, UGImageViewer } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - alt 必填,width/height 提前保留布局;previewItems 每张都提供描述。
27
+ - 预览器支持缩放、切换与 Escape;放大后的查看区左右键优先原生平移,工具栏左右键切图,业务不覆盖焦点隔离。
28
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
29
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
30
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
31
+
32
+ ## 相关候选
33
+
34
+ - [avatar](./avatar.md)
35
+ - [upload](./upload.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。