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

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 (279) hide show
  1. package/LICENSE +21 -0
  2. package/dist/RELEASE_PROVENANCE.json +8 -0
  3. package/dist/ai/SKILL.md +245 -0
  4. package/dist/ai/manifest.json +819 -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 +159 -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-NRCPYVJW.js → chunk-36XR4DWY.js} +1 -1
  130. package/dist/chunk-36XR4DWY.js.map +1 -0
  131. package/dist/chunk-3G4F4FBP.js +1 -0
  132. package/dist/chunk-3G4F4FBP.js.map +1 -0
  133. package/dist/chunk-6CAP3PTC.cjs +1 -0
  134. package/dist/chunk-6CAP3PTC.cjs.map +1 -0
  135. package/dist/chunk-EZEVLBUH.cjs +1 -0
  136. package/dist/chunk-EZEVLBUH.cjs.map +1 -0
  137. package/dist/chunk-G7UYIR6Z.js +1 -0
  138. package/dist/chunk-G7UYIR6Z.js.map +1 -0
  139. package/dist/chunk-JJA2B3JL.cjs +1 -0
  140. package/dist/chunk-JJA2B3JL.cjs.map +1 -0
  141. package/dist/chunk-LNVPMWCL.cjs +1 -0
  142. package/dist/chunk-LNVPMWCL.cjs.map +1 -0
  143. package/dist/chunk-NIQAVPSL.js +1 -0
  144. package/dist/chunk-NIQAVPSL.js.map +1 -0
  145. package/dist/chunk-PGJ5O3CM.cjs +1 -0
  146. package/dist/chunk-PGJ5O3CM.cjs.map +1 -0
  147. package/dist/chunk-RLPW73WX.js +1 -0
  148. package/dist/chunk-RLPW73WX.js.map +1 -0
  149. package/dist/chunk-RZSNVJZO.cjs +1 -0
  150. package/dist/chunk-RZSNVJZO.cjs.map +1 -0
  151. package/dist/chunk-Z4MRC4LZ.js +1 -0
  152. package/dist/chunk-Z4MRC4LZ.js.map +1 -0
  153. package/dist/components/alert.d.ts +4 -5
  154. package/dist/components/alert.d.ts.map +1 -1
  155. package/dist/components/avatar.d.ts +4 -5
  156. package/dist/components/avatar.d.ts.map +1 -1
  157. package/dist/components/badge.d.ts +5 -2
  158. package/dist/components/badge.d.ts.map +1 -1
  159. package/dist/components/button.d.ts +10 -5
  160. package/dist/components/button.d.ts.map +1 -1
  161. package/dist/components/checkbox.d.ts +4 -2
  162. package/dist/components/checkbox.d.ts.map +1 -1
  163. package/dist/components/date-picker.d.ts +1 -1
  164. package/dist/components/date-picker.d.ts.map +1 -1
  165. package/dist/components/date-time-picker.d.ts +2 -2
  166. package/dist/components/date-time-picker.d.ts.map +1 -1
  167. package/dist/components/dialog.d.ts.map +1 -1
  168. package/dist/components/drawer.d.ts.map +1 -1
  169. package/dist/components/index.cjs +1 -1
  170. package/dist/components/index.cjs.map +1 -1
  171. package/dist/components/index.js +1 -1
  172. package/dist/components/input.d.ts +2 -0
  173. package/dist/components/input.d.ts.map +1 -1
  174. package/dist/components/number-input.d.ts +4 -2
  175. package/dist/components/number-input.d.ts.map +1 -1
  176. package/dist/components/radio.d.ts +4 -6
  177. package/dist/components/radio.d.ts.map +1 -1
  178. package/dist/components/select.d.ts +4 -0
  179. package/dist/components/select.d.ts.map +1 -1
  180. package/dist/components/sidebar.d.ts +17 -8
  181. package/dist/components/sidebar.d.ts.map +1 -1
  182. package/dist/components/skeleton.d.ts +4 -5
  183. package/dist/components/skeleton.d.ts.map +1 -1
  184. package/dist/components/spinner.d.ts +5 -6
  185. package/dist/components/spinner.d.ts.map +1 -1
  186. package/dist/components/switch.d.ts +2 -0
  187. package/dist/components/switch.d.ts.map +1 -1
  188. package/dist/components/tag.d.ts +5 -2
  189. package/dist/components/tag.d.ts.map +1 -1
  190. package/dist/components/time-picker.d.ts +1 -1
  191. package/dist/components/time-picker.d.ts.map +1 -1
  192. package/dist/essentials.cjs +1 -0
  193. package/dist/essentials.cjs.map +1 -0
  194. package/dist/essentials.css +2 -0
  195. package/dist/essentials.d.ts +9 -0
  196. package/dist/essentials.d.ts.map +1 -0
  197. package/dist/essentials.js +1 -0
  198. package/dist/essentials.js.map +1 -0
  199. package/dist/index.cjs +1 -1
  200. package/dist/index.cjs.map +1 -1
  201. package/dist/index.js +1 -1
  202. package/dist/internal/data-table-header.d.ts.map +1 -1
  203. package/dist/internal/date-time/date-mode-panel.d.ts.map +1 -0
  204. package/dist/internal/{date-time-control.d.ts → date-time/date-time-control.d.ts} +1 -1
  205. package/dist/internal/date-time/date-time-control.d.ts.map +1 -0
  206. package/dist/internal/date-time/date-time-range-control.d.ts.map +1 -0
  207. package/dist/internal/date-time/time-panel.d.ts.map +1 -0
  208. package/dist/internal/{admin-horizontal-navigation.d.ts → navigation/admin-horizontal-navigation.d.ts} +1 -1
  209. package/dist/internal/navigation/admin-horizontal-navigation.d.ts.map +1 -0
  210. package/dist/internal/navigation/sidebar-navigation.d.ts.map +1 -0
  211. package/dist/internal/overlay/use-floating-layout-observer.d.ts.map +1 -0
  212. package/dist/internal/overlay/use-overlay-focus.d.ts.map +1 -0
  213. package/dist/internal/overlay/use-portal-container.d.ts.map +1 -0
  214. package/dist/internal/overlay/use-presence.d.ts.map +1 -0
  215. package/dist/internal/selection/option-window.d.ts.map +1 -0
  216. package/dist/internal/{use-cascader-lazy.d.ts → selection/use-cascader-lazy.d.ts} +1 -1
  217. package/dist/internal/selection/use-cascader-lazy.d.ts.map +1 -0
  218. package/dist/internal/{use-transfer-remote.d.ts → selection/use-transfer-remote.d.ts} +1 -1
  219. package/dist/internal/selection/use-transfer-remote.d.ts.map +1 -0
  220. package/dist/internal/{use-tree-data.d.ts → selection/use-tree-data.d.ts} +1 -1
  221. package/dist/internal/selection/use-tree-data.d.ts.map +1 -0
  222. package/dist/patterns/admin-shell.d.ts +4 -0
  223. package/dist/patterns/admin-shell.d.ts.map +1 -1
  224. package/dist/patterns/data-table.d.ts +18 -7
  225. package/dist/patterns/data-table.d.ts.map +1 -1
  226. package/dist/patterns/index.cjs +1 -1
  227. package/dist/patterns/index.cjs.map +1 -1
  228. package/dist/patterns/index.js +1 -1
  229. package/dist/patterns/index.js.map +1 -1
  230. package/dist/patterns/page-header.d.ts +4 -0
  231. package/dist/patterns/page-header.d.ts.map +1 -1
  232. package/dist/primitives/index.cjs +1 -1
  233. package/dist/primitives/index.js +1 -1
  234. package/dist/styles.css +1 -1
  235. package/dist/themes/dense.css +1 -0
  236. package/dist/tokens.css +1 -1
  237. package/package.json +18 -5
  238. package/dist/chunk-J4NAYP4L.cjs +0 -1
  239. package/dist/chunk-J4NAYP4L.cjs.map +0 -1
  240. package/dist/chunk-JY5S7YLF.cjs +0 -1
  241. package/dist/chunk-JY5S7YLF.cjs.map +0 -1
  242. package/dist/chunk-NRCPYVJW.js.map +0 -1
  243. package/dist/chunk-PXVCZ6AZ.js +0 -1
  244. package/dist/chunk-PXVCZ6AZ.js.map +0 -1
  245. package/dist/chunk-UBZ2ZCEJ.cjs +0 -1
  246. package/dist/chunk-UBZ2ZCEJ.cjs.map +0 -1
  247. package/dist/chunk-UEJM2SLH.js +0 -1
  248. package/dist/chunk-UEJM2SLH.js.map +0 -1
  249. package/dist/chunk-UESSLLSC.js +0 -1
  250. package/dist/chunk-UESSLLSC.js.map +0 -1
  251. package/dist/chunk-VDBATAZ3.js +0 -1
  252. package/dist/chunk-VDBATAZ3.js.map +0 -1
  253. package/dist/chunk-XVFRKGM7.cjs +0 -1
  254. package/dist/chunk-XVFRKGM7.cjs.map +0 -1
  255. package/dist/chunk-ZDO5A2IZ.cjs +0 -1
  256. package/dist/chunk-ZDO5A2IZ.cjs.map +0 -1
  257. package/dist/internal/admin-horizontal-navigation.d.ts.map +0 -1
  258. package/dist/internal/date-mode-panel.d.ts.map +0 -1
  259. package/dist/internal/date-time-control.d.ts.map +0 -1
  260. package/dist/internal/date-time-range-control.d.ts.map +0 -1
  261. package/dist/internal/option-window.d.ts.map +0 -1
  262. package/dist/internal/sidebar-navigation.d.ts.map +0 -1
  263. package/dist/internal/time-panel.d.ts.map +0 -1
  264. package/dist/internal/use-cascader-lazy.d.ts.map +0 -1
  265. package/dist/internal/use-floating-layout-observer.d.ts.map +0 -1
  266. package/dist/internal/use-overlay-focus.d.ts.map +0 -1
  267. package/dist/internal/use-portal-container.d.ts.map +0 -1
  268. package/dist/internal/use-presence.d.ts.map +0 -1
  269. package/dist/internal/use-transfer-remote.d.ts.map +0 -1
  270. package/dist/internal/use-tree-data.d.ts.map +0 -1
  271. /package/dist/internal/{date-mode-panel.d.ts → date-time/date-mode-panel.d.ts} +0 -0
  272. /package/dist/internal/{date-time-range-control.d.ts → date-time/date-time-range-control.d.ts} +0 -0
  273. /package/dist/internal/{time-panel.d.ts → date-time/time-panel.d.ts} +0 -0
  274. /package/dist/internal/{sidebar-navigation.d.ts → navigation/sidebar-navigation.d.ts} +0 -0
  275. /package/dist/internal/{use-floating-layout-observer.d.ts → overlay/use-floating-layout-observer.d.ts} +0 -0
  276. /package/dist/internal/{use-overlay-focus.d.ts → overlay/use-overlay-focus.d.ts} +0 -0
  277. /package/dist/internal/{use-portal-container.d.ts → overlay/use-portal-container.d.ts} +0 -0
  278. /package/dist/internal/{use-presence.d.ts → overlay/use-presence.d.ts} +0 -0
  279. /package/dist/internal/{option-window.d.ts → selection/option-window.d.ts} +0 -0
@@ -0,0 +1,41 @@
1
+ # UGStatistic 统计数字
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`statistic`。
4
+
5
+ 展示核心指标、趋势或可暂停的到期倒计时。
6
+
7
+ ## 适用场景
8
+
9
+ - 核心指标、趋势、前后缀和变化说明。
10
+
11
+ ## 不适用场景
12
+
13
+ - 普通短状态使用 Badge。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGStatistic`
19
+
20
+ ```tsx
21
+ import { UGStatistic } 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
+ - [badge](./badge.md)
34
+ - [progress](./progress.md)
35
+ - [card](./card.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,40 @@
1
+ # UGSteps 步骤条
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`steps`。
4
+
5
+ 展示多步骤进度,支持紧凑、简洁和每步独立状态。
6
+
7
+ ## 适用场景
8
+
9
+ - 展示有顺序的流程阶段和当前进度。
10
+
11
+ ## 不适用场景
12
+
13
+ - 同级面板切换使用 Tabs。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGSteps`
19
+
20
+ ```tsx
21
+ import { UGSteps } 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
+ - [tabs](./tabs.md)
34
+ - [progress](./progress.md)
35
+
36
+ ## 生成前检查
37
+
38
+ - 当前适配器是否真实提供该组件。
39
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
40
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,40 @@
1
+ # UGSwitch 开关
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`switch`。
4
+
5
+ 用于切换二元状态的开关组件。
6
+
7
+ ## 适用场景
8
+
9
+ - 切换后立即生效的二元设置。
10
+
11
+ ## 不适用场景
12
+
13
+ - 提交表单前的条款确认使用 Checkbox。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGSwitch`
19
+
20
+ ```tsx
21
+ import { UGSwitch } 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
+ - [checkbox](./checkbox.md)
34
+ - [radio](./radio.md)
35
+
36
+ ## 生成前检查
37
+
38
+ - 当前适配器是否真实提供该组件。
39
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
40
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGTable 表格
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`table`。
4
+
5
+ 用于后台列表和对比信息的数据表格。
6
+
7
+ ## 适用场景
8
+
9
+ - 列结构稳定、需要扫描和对比的二维数据。
10
+
11
+ ## 不适用场景
12
+
13
+ - 移动优先的摘要列表或结构不一致内容应组合 Card/List。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTable`
19
+
20
+ ```tsx
21
+ import { UGTable } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 二维记录排序、选择、反馈及分页使用 patterns UGDataTable;完整嵌套行用 UGTreeTable,稳定 getRowId 保留原记录身份。columns.width/minWidth/align/fixed 是公开列模型,固定偏移按实际宽度计算,不复制私有 DOM。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [descriptions](./descriptions.md)
34
+ - [pagination](./pagination.md)
35
+ - [empty-state](./empty-state.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGTabs 标签页
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`tabs`。
4
+
5
+ 在同级内容间切换,支持新增与独立关闭入口和键盘回焦。
6
+
7
+ ## 适用场景
8
+
9
+ - 同一页面层级中切换互斥内容面板。
10
+
11
+ ## 不适用场景
12
+
13
+ - 表达跨页面层级使用 Breadcrumb;表达流程使用 Steps。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTabs`
19
+
20
+ ```tsx
21
+ import { UGTabs } 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
+ - [navigation-menu](./navigation-menu.md)
34
+ - [steps](./steps.md)
35
+ - [breadcrumb](./breadcrumb.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,39 @@
1
+ # UGTag 标签
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`tag`。
4
+
5
+ 支持语义变体和关闭操作的内联标签。
6
+
7
+ ## 适用场景
8
+
9
+ - 可关闭、可管理的关键词、筛选项和分类项。
10
+
11
+ ## 不适用场景
12
+
13
+ - 只读短状态;使用 Badge。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/primitives`
18
+ - 公开成员:`UGTag`
19
+
20
+ ```tsx
21
+ import { UGTag } 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
+ - [badge](./badge.md)
34
+
35
+ ## 生成前检查
36
+
37
+ - 当前适配器是否真实提供该组件。
38
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
39
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,39 @@
1
+ # UGText 文本
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`text`。
4
+
5
+ 统一正文尺寸、语义色和截断行为的文本组件。
6
+
7
+ ## 适用场景
8
+
9
+ - 统一正文尺寸、语义色和截断行为的文本组件。
10
+
11
+ ## 不适用场景
12
+
13
+ - 没有额外禁止场景;仍需与相关候选组件比较后选择。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/primitives`
18
+ - 公开成员:`UGText`
19
+
20
+ ```tsx
21
+ import { UGText } 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,40 @@
1
+ # UGTextarea 文本域
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`textarea`。
4
+
5
+ 支持错误和帮助说明的多行文本输入框。
6
+
7
+ ## 适用场景
8
+
9
+ - 备注、描述、提示词等多行自由文本。
10
+
11
+ ## 不适用场景
12
+
13
+ - 短单行值使用 Input。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTextarea`
19
+
20
+ ```tsx
21
+ import { UGTextarea } 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
+ - [input](./input.md)
34
+ - [form](./form.md)
35
+
36
+ ## 生成前检查
37
+
38
+ - 当前适配器是否真实提供该组件。
39
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
40
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,27 @@
1
+ # UGThemeConfiguratorDialog
2
+
3
+ > 包版本:0.3.0-beta.4;发布合同以当前项目实际包为准。
4
+
5
+ 标准居中外观设置弹窗:组合完整配置面板、可选实时预览与重置操作。
6
+
7
+ 复用 Modal 的焦点和键盘合同;主题值、打开状态、预览内容与重置行为全部由调用方控制。
8
+
9
+ ## 适用场景
10
+
11
+ - 标准居中外观设置弹窗:组合完整配置面板、可选实时预览与重置操作。
12
+
13
+ ## 不适用场景
14
+
15
+ - 先比较同一适配器的基础组件。
16
+
17
+ ## 公开导入
18
+
19
+ ```ts
20
+ import { UGThemeConfiguratorDialog } from '@ug666/ui-react/patterns'
21
+ ```
22
+
23
+ ## 相关候选
24
+
25
+ - 暂无;仍需从组件目录按任务语义搜索。
26
+
27
+ - Props、事件和插槽以项目当前依赖的 TypeScript 类型为准。
@@ -0,0 +1,27 @@
1
+ # UGThemeConfigurator
2
+
3
+ > 包版本:0.3.0-beta.4;发布合同以当前项目实际包为准。
4
+
5
+ 完整外观配置:人群方案、视觉主题、模式、品牌色、布局与细节。
6
+
7
+ 完全受控,不访问存储、接口、Cookie、权限或业务路由;应用字段通过扩展区域插入。
8
+
9
+ ## 适用场景
10
+
11
+ - 完整外观配置:人群方案、视觉主题、模式、品牌色、布局与细节。
12
+
13
+ ## 不适用场景
14
+
15
+ - 先比较同一适配器的基础组件。
16
+
17
+ ## 公开导入
18
+
19
+ ```ts
20
+ import { UGThemeConfigurator } from '@ug666/ui-react/patterns'
21
+ ```
22
+
23
+ ## 相关候选
24
+
25
+ - 暂无;仍需从组件目录按任务语义搜索。
26
+
27
+ - Props、事件和插槽以项目当前依赖的 TypeScript 类型为准。
@@ -0,0 +1,41 @@
1
+ # UGThemeController 主题控制器
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`theme-controller`。
4
+
5
+ 低层单项控件:将原生单选或复选控件映射到一个 UG Theme data attribute。
6
+
7
+ ## 适用场景
8
+
9
+ - 让原生 radio/checkbox 修改 UG Theme 的 mode、preset、density、radius、contrast 或 accent。
10
+
11
+ ## 不适用场景
12
+
13
+ - 只想给局部区域固定主题时直接使用 ThemeScope/ThemeProvider;业务主题不是 UG data attribute 时不要使用。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGThemeController`
19
+
20
+ ```tsx
21
+ import { UGThemeController } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 受控 radio 组由业务维护唯一 checked;持久化和服务端同步留在业务层;target 默认是 documentElement,也可传局部元素。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [config-provider](./config-provider.md)
34
+ - [radio](./radio.md)
35
+ - [switch](./switch.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,42 @@
1
+ # UGTimePicker 时间选择器
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`time-picker`。
4
+
5
+ 选择时分秒,支持可用时间边界与禁用时间。
6
+
7
+ ## 适用场景
8
+
9
+ - 选择连续的时分或时分秒。
10
+
11
+ ## 不适用场景
12
+
13
+ - 没有额外禁止场景;仍需与相关候选组件比较后选择。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTimePicker`
19
+
20
+ ```tsx
21
+ import { UGTimePicker } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 值为 HH:mm,可选秒时为 HH:mm:ss;min/max/disabledTime 约束候选与提交。
27
+ - 不要裸 time input 混入不同 yyyy/locale 控件风格。
28
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
29
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
30
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
31
+
32
+ ## 相关候选
33
+
34
+ - [time-select](./time-select.md)
35
+ - [time-range-picker](./time-range-picker.md)
36
+ - [date-time-picker](./date-time-picker.md)
37
+
38
+ ## 生成前检查
39
+
40
+ - 当前适配器是否真实提供该组件。
41
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
42
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGTimeRangePicker 时间范围选择
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`time-range-picker`。
4
+
5
+ 使用成对输入和统一校验选择起止时间。
6
+
7
+ ## 适用场景
8
+
9
+ - 选择同一天的起止时段。
10
+
11
+ ## 不适用场景
12
+
13
+ - 没有额外禁止场景;仍需与相关候选组件比较后选择。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTimeRangePicker`
19
+
20
+ ```tsx
21
+ import { UGTimeRangePicker } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 值是双端点元组;原生标签关联公开 startInputId/endInputId,id/ref 仍指根。
27
+ - 非法、单边或反向草稿保留供用户修正;最终提交统一校验,不自动交换起止。
28
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
29
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
30
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
31
+
32
+ ## 相关候选
33
+
34
+ - [time-picker](./time-picker.md)
35
+ - [date-range-picker](./date-range-picker.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,40 @@
1
+ # UGTimeSelect 固定时间选择
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`time-select`。
4
+
5
+ 从开始、结束和间隔定义的时间候选中选择。
6
+
7
+ ## 适用场景
8
+
9
+ - 预约等场景从固定间隔候选选时间。
10
+
11
+ ## 不适用场景
12
+
13
+ - 没有额外禁止场景;仍需与相关候选组件比较后选择。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTimeSelect`
19
+
20
+ ```tsx
21
+ import { UGTimeSelect } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - start/end/step 为本地时间字符串;使用合法正间隔,应用不重写候选计算。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [time-picker](./time-picker.md)
34
+ - [select](./select.md)
35
+
36
+ ## 生成前检查
37
+
38
+ - 当前适配器是否真实提供该组件。
39
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
40
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGTimeline 时间线
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`timeline`。
4
+
5
+ 以有序列表展示事件、审批和发布记录的先后关系。
6
+
7
+ ## 适用场景
8
+
9
+ - 按时间顺序展示事件、发布记录、审批过程或操作日志。
10
+
11
+ ## 不适用场景
12
+
13
+ - 强调当前可执行流程使用 Steps;高密度二维记录使用 Table。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTimeline`、`UGTimelineItem`、`UGTimelineMarker`、`UGTimelineContent`、`UGTimelineTime`、`UGTimelineTitle`、`UGTimelineDescription`
19
+
20
+ ```tsx
21
+ import { UGTimeline, UGTimelineItem, UGTimelineMarker, UGTimelineContent, UGTimelineTime, UGTimelineTitle, UGTimelineDescription } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 默认使用纵向布局;横向布局会在窄容器内自身滚动,不把横向滚动交给整页。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [steps](./steps.md)
34
+ - [list](./list.md)
35
+ - [badge](./badge.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,39 @@
1
+ # UGToaster 消息通知
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`toast`。
4
+
5
+ 成功、错误和提示反馈,可创建显式隔离实例并配置时长及数量。
6
+
7
+ ## 适用场景
8
+
9
+ - 操作完成后的短暂全局反馈。
10
+
11
+ ## 不适用场景
12
+
13
+ - 需要一直保留并参与页面阅读流时使用 Alert。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGToaster`
19
+
20
+ ```tsx
21
+ import { UGToaster } 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
+ - [alert](./alert.md)
34
+
35
+ ## 生成前检查
36
+
37
+ - 当前适配器是否真实提供该组件。
38
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
39
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,39 @@
1
+ # UGTooltip 文字提示
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`tooltip`。
4
+
5
+ 用于补充解释控件含义的悬停提示。
6
+
7
+ ## 适用场景
8
+
9
+ - 图标或紧凑控件的短说明,不承载操作。
10
+
11
+ ## 不适用场景
12
+
13
+ - 需要点击、表单或多段内容使用 Popover。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTooltip`
19
+
20
+ ```tsx
21
+ import { UGTooltip } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 默认延迟 200ms;即时图标导航可设为 0;不要在复合组件里另画提示气泡。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [popover](./popover.md)
34
+
35
+ ## 生成前检查
36
+
37
+ - 当前适配器是否真实提供该组件。
38
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
39
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。