@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,171 @@
1
+ ---
2
+ name: ui-react
3
+ description: 使用 @ug666/ui-react 构建、修改或审查 React UI 时应用。
4
+ ---
5
+
6
+ # @ug666/ui-react AI 使用协议
7
+
8
+ - 内容对应包版本:0.3.0-beta.4。
9
+ - [接入、主题与使用指南](../../SKILL.md) · [版本与公开入口](../release.md)
10
+
11
+ ## 组件发现协议
12
+
13
+ 1. 先理解用户要完成的任务、交互行为和信息结构,不只按字面组件名匹配。
14
+ 2. 从当前适配器的真实组件目录中筛选多个候选组件。
15
+ 3. 选择存在歧义时,先读取所有候选组件的机器文档,再做决定。
16
+ 4. 对照用途、禁止场景、公开结构、Props/事件/插槽和无障碍规则。
17
+ 5. 只从当前包公开入口导入,并严格使用当前类型声明存在的 API。
18
+ 6. 组合完成后检查响应式、长文本、键盘、焦点、禁用、加载和错误状态。
19
+
20
+ ## 全局使用规则
21
+
22
+ - 优先使用已有 UG 组件;不要用原生元素和临时样式重造已存在的公共组件。
23
+ - 组件视觉使用公开 variant、tone、size、Theme、Surface 和语义 Token,不写固定调色板。
24
+ - className/class 只负责页面布局、内容排版和业务语义,不穿透 data-ug-slot 重画组件。
25
+ - 不从 src、dist、内部目录或旧项目深路径导入。
26
+ - 不根据 React API 推导 Vue API,也不根据 Web API 推导 UniApp API。
27
+ - 业务请求、权限、Cookie、路由和持久化留在业务项目,通过 Props、状态、事件和插槽接入。
28
+ - 管理进阶能力在当前适配器目录中选择 Patterns 或 Blocks,再核对真实类型;Cascader/Transfer virtualWindowSize 为显式分窗,不是滚动虚拟化。
29
+ - 图标操作必须有可访问名称;表单、弹层和导航必须保留组件的键盘与焦点合同。
30
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
31
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
32
+
33
+ ## 组件目录
34
+
35
+ ### 基础原语
36
+
37
+ - [UGButton · 按钮](./button.md) — 用于触发主要操作、次级操作与危险操作的按钮组件。
38
+ - [UGInput · 输入框](./input.md) — 带标签、错误信息与帮助文本的文本输入框。
39
+ - [UGLabel · 标签](./label.md) — 语义化表单标签,支持控件关联、必填、禁用和尺寸继承。
40
+ - [UGCard · 卡片](./card.md) — 用于承载模块内容、信息摘要与操作区域的卡片容器。
41
+ - [UGBadge · 徽标](./badge.md) — 用于状态标记、分类标签与数量提示的轻量徽标。
42
+ - [UGTag · 标签](./tag.md) — 支持语义变体和关闭操作的内联标签。
43
+ - [UGSeparator · 分割线](./separator.md) — 用于内容分区的水平或垂直分割线。
44
+ - [UGKbd · 键盘按键](./kbd.md) — 用于展示快捷键、组合键和键盘操作提示。
45
+ - [UGSpinner · 加载指示器](./spinner.md) — 用于局部加载和异步等待的旋转指示器。
46
+ - [UGLink · 链接](./link.md) — 语义化链接组件,支持下划线策略、外链与禁用状态。
47
+ - [UGText · 文本](./text.md) — 统一正文尺寸、语义色和截断行为的文本组件。
48
+ - [UGSpace · 间距](./space.md) — 控制子元素方向、对齐、换行和间距的轻量布局组件。
49
+ - [UGScrollbar · 滚动条](./scrollbar.md) — 使用原生滚动行为并统一滚动条外观的内容容器。
50
+ - [UGIndicator · 角标容器](./indicator.md) — 将状态点、徽标或操作稳定定位到内容的九个边缘锚点。
51
+ - [UGJoin · 连接容器](./join.md) — 将按钮、输入框等控件连接为横向、纵向或响应式连续边界。
52
+ - [UGStack · 层叠容器](./stack.md) — 将多个同尺寸内容按上下或逻辑起止方向视觉层叠。
53
+ - [UGRow · 布局](./layout.md) — 基于 24 栅格的 Row 与 Col 页面布局组件。
54
+ - [UGContainer · 布局容器](./container.md) — 由 Header、Aside、Main 与 Footer 组成的应用布局容器。
55
+ - [UGConfigProvider · 全局配置](./config-provider.md) — 向组件树提供命名空间、尺寸和禁用状态等全局默认值。
56
+ - [UGSplitter · 分割面板](./splitter.md) — 支持多面板、折叠、指针拖动和键盘调整的分割容器。
57
+ - [UGIcon · 图标](./icon.md) — 统一尺寸、描边与语义属性的图标容器。
58
+
59
+ ### 表单输入
60
+
61
+ - [UGAutocomplete · 自动补全](./autocomplete.md) — 带键盘导航、异步候选和过期请求保护的文本补全。
62
+ - [UGCascader · 级联选择](./cascader.md) — 选择完整层级路径,支持多路径、搜索、懒加载与候选分窗。
63
+ - [UGTransfer · 穿梭框](./transfer.md) — 在左右列表间移动选项,支持远程分页及分窗,保留锁定与未知既有值。
64
+ - [UGColorPicker · 颜色选择器](./color-picker.md) — 使用 HSV 色盘、透明度、HEX 输入与确认草稿选择颜色。
65
+ - [UGUpload · 上传](./upload.md) — 管理文件选择、校验、进度、取消和重试,请求由应用提供。
66
+ - [UGDatePicker · 日期选择器](./date-picker.md) — 选择本地日、年、月、ISO周或多个日期,保留原生表单字段。
67
+ - [UGTimePicker · 时间选择器](./time-picker.md) — 选择时分秒,支持可用时间边界与禁用时间。
68
+ - [UGTimeSelect · 固定时间选择](./time-select.md) — 从开始、结束和间隔定义的时间候选中选择。
69
+ - [UGTimeRangePicker · 时间范围选择](./time-range-picker.md) — 使用成对输入和统一校验选择起止时间。
70
+ - [UGDateTimePicker · 日期时间选择器](./date-time-picker.md) — 在一个浮层中完成本地日期时间或范围的选择、校验与确认。
71
+ - [UGTextarea · 文本域](./textarea.md) — 支持错误和帮助说明的多行文本输入框。
72
+ - [UGSelect · 选择器](./select.md) — 支持单选、多选、筛选、分组、清空、键盘操作与原生表单提交的选择器。
73
+ - [UGTreeSelect · 树形选择](./tree-select.md) — 单选或勾选层级字段,支持祖先保留搜索、独立展开、级联半选、清空和原生表单提交。
74
+ - [UGFileInput · 文件选择](./file-input.md) — 保留原生文件选择与表单语义,并统一字段状态和 File 列表回调。
75
+ - [UGFieldset · 字段分组](./fieldset.md) — 使用 fieldset 与 legend 对相关表单控件建立语义分组。
76
+ - [UGCheckbox · 复选框](./checkbox.md) — 用于多项选择的复选框,支持受控、半选和禁用状态。
77
+ - [UGRadio · 单选框](./radio.md) — 用于单项选择的单选框与单选框组。
78
+ - [UGSwitch · 开关](./switch.md) — 用于切换二元状态的开关组件。
79
+ - [UGThemeController · 主题控制器](./theme-controller.md) — 低层单项控件:将原生单选或复选控件映射到一个 UG Theme data attribute。
80
+ - [UGSlider · 滑块](./slider.md) — 支持范围、步长和当前值显示的滑块。
81
+ - [UGRating · 评分](./rating.md) — 使用原生单选组收集离散评分,并支持无伪交互的只读展示。
82
+ - [UGCalendar · 日历](./calendar.md) — 单月日期选择与业务日程单元格,保留范围限制和完整键盘导航。
83
+ - [UGDateRangePicker · 日期范围](./date-range-picker.md) — 一体式本地日期范围输入,支持双月、快捷范围、手动草稿与键盘操作。
84
+ - [UGNumberInput · 数字输入](./number-input.md) — 支持范围、步长和精度控制的数字输入框。
85
+ - [UGOTPInput · 验证码](./otp-input.md) — 支持键盘导航与粘贴填充的验证码输入框。
86
+ - [UGForm · 表单](./form.md) — 组织字段语义、嵌套路径和动态数组,支持跨端校验、提交守卫与重置。
87
+
88
+ ### 导航流程
89
+
90
+ - [UGBacktop · 回到顶部](./backtop.md) — 滚动超过阈值时提供返回指定区域顶部的操作。
91
+ - [UGTabs · 标签页](./tabs.md) — 在同级内容间切换,支持新增与独立关闭入口和键盘回焦。
92
+ - [UGBreadcrumb · 面包屑](./breadcrumb.md) — 面包屑导航组件,用于表达页面层级关系。
93
+ - [UGPagination · 分页](./pagination.md) — 支持页码、省略号和跳转的分页导航。
94
+ - [UGNavigationMenu · 导航菜单](./navigation-menu.md) — 水平或纵向导航,支持折叠和导航事件,路由由应用决定。
95
+ - [UGSidebar · 侧边栏](./sidebar.md) — 面向后台与多模块工作区的侧边导航,支持多级菜单、折叠浮层、可选上下文切换、搜索、品牌与页脚插槽、整数像素宽度、拖拽调整和移动端抽屉。
96
+ - [UGDock · 底部操作坞](./dock.md) — 提供适配移动端安全区、尺寸与当前页状态的底部导航。
97
+ - [UGNavbar · 顶部导航栏](./navbar.md) — 用不易偏移的 start、center、end 三段结构组织通用顶部导航。
98
+ - [UGSteps · 步骤条](./steps.md) — 展示多步骤进度,支持紧凑、简洁和每步独立状态。
99
+
100
+ ### 浮层弹层
101
+
102
+ - [UGPopconfirm · 气泡确认](./popconfirm.md) — 在操作旁确认,支持异步防重、失败重试与焦点返回。
103
+ - [UGModal · 弹窗](./modal.md) — 弹窗组件,支持键盘关闭、异步首字段聚焦与焦点返回。
104
+ - [UGDialog · 对话框](./dialog.md) — 确认关键操作或收集输入,支持异步校验与明确的关闭原因。
105
+ - [UGDrawer · 抽屉](./drawer.md) — 从页面边缘滑出的抽屉容器。
106
+ - [UGSheet · 抽屉面板](./sheet.md) — 适合筛选和补充内容的侧边面板。
107
+ - [UGDropdownMenu · 下拉菜单](./dropdown.md) — 点击触发的下拉操作菜单。
108
+ - [UGContextMenu · 右键菜单](./context-menu.md) — 在指定位置展开的右键操作菜单。
109
+ - [UGPopover · 弹出框](./popover.md) — 用于承载临时上下文内容的通用浮层。
110
+ - [UGTooltip · 文字提示](./tooltip.md) — 用于补充解释控件含义的悬停提示。
111
+ - [UGFab · 浮动操作组](./fab.md) — 提供可控的浮动主操作与纵向或扇形快捷动作组。
112
+
113
+ ### 反馈状态
114
+
115
+ - [UGResult · 结果](./result.md) — 集中展示成功、警告、失败或信息结果及后续操作。
116
+ - [UGLoading · 加载遮罩](./loading.md) — 在保留内容布局时遮挡交互,并提供忙碌播报与焦点保护。
117
+ - [UGNotification · 通知](./notification.md) — 在四角展示带标题、正文和动作的受控通知。
118
+ - [UGAlert · 提示](./alert.md) — 强调型提示横幅,适合信息提醒、警告与错误反馈。
119
+ - [UGToaster · 消息通知](./toast.md) — 成功、错误和提示反馈,可创建显式隔离实例并配置时长及数量。
120
+ - [UGProgress · 进度条](./progress.md) — 使用线形、圆形或仪表盘展示任务进度、状态与自定义文字。
121
+ - [UGRadialProgress · 环形进度](./radial-progress.md) — 用于在紧凑区域展示任务完成度或指标占比的环形进度。
122
+ - [UGSkeleton · 骨架屏](./skeleton.md) — 用于加载阶段结构预览的骨架屏。
123
+ - [UGEmptyState · 空状态](./empty-state.md) — 用于无数据场景的空状态组件。
124
+
125
+ ### 数据展示
126
+
127
+ - [UGImage · 图片](./image.md) — 支持加载、失败重试、适配方式和多图缩放预览。
128
+ - [UGInfiniteScroll · 无限滚动](./infinite-scroll.md) — 在滚动阈值触发加载,支持防重、失败重试与结束状态。
129
+ - [UGTable · 表格](./table.md) — 用于后台列表和对比信息的数据表格。
130
+ - [UGDescriptions · 描述列表](./descriptions.md) — 以键值对形式展示结构化信息。
131
+ - [UGStatistic · 统计数字](./statistic.md) — 展示核心指标、趋势或可暂停的到期倒计时。
132
+ - [UGDataPanel · 数据面板](./data-panel.md) — 用于统一数据块的标题、操作区、内容布局以及加载、空和错误状态。
133
+ - [UGStatisticCard · 指标卡片](./statistic-card.md) — 用于在卡片内组合核心指标、语义图标和变化说明。
134
+ - [UGTrendChart · 趋势图](./trend-chart.md) — 用于以轻量折线和面积展示连续数据变化。
135
+ - [UGDonutChart · 环形占比图](./donut-chart.md) — 用于展示多个分类的数量、占比和总计。
136
+ - [UGRankingList · 排名进度](./ranking-list.md) — 用于在统一刻度下比较多项数值与排名。
137
+ - [UGBarChart · 柱状图](./bar-chart.md) — 用于按分类比较数值,并提供悬浮与键盘明细。
138
+ - [UGGaugeChart · 仪表盘](./gauge-chart.md) — 用于展示区间内的当前值、完成程度和目标刻度。
139
+ - [UGStackedBarChart · 堆叠条形图](./stacked-bar-chart.md) — 用于比较多个对象的组成结构和分类占比。
140
+ - [UGHeatmapChart · 热力图](./heatmap-chart.md) — 用于以二维色阶展示活跃度、密度和时间分布。
141
+ - [UGRadarChart · 雷达图](./radar-chart.md) — 用于比较多个对象在同一组维度上的能力轮廓。
142
+ - [UGAvatar · 头像](./avatar.md) — 头像组件,支持图片回退、尺寸变化与首字母占位。
143
+ - [UGAvatarGroup · 头像组](./avatar-group.md) — 将多个头像以堆叠方式展示,超出数量时显示汇总。
144
+ - [UGAccordion · 折叠面板](./accordion.md) — 手风琴折叠组件,支持单选与多选展开模式。
145
+ - [UGCollapsible · 单项折叠](./collapse.md) — 基于 details 与 summary 原生语义控制单块补充内容。
146
+ - [UGList · 列表](./list.md) — 为文件、成员、通知和对象摘要提供稳定的媒体、内容与操作列布局。
147
+ - [UGTree · 树形列表](./tree.md) — 层级选择、展开、搜索、懒加载和拖放事件;请求及业务重排由应用负责。
148
+ - [UGCarousel · 轮播](./carousel.md) — 使用原生滚动吸附展示内容,支持纵向、卡片模式与可访问控制。
149
+ - [UGTimeline · 时间线](./timeline.md) — 以有序列表展示事件、审批和发布记录的先后关系。
150
+
151
+ ## 高级组合
152
+
153
+ - [UGAdminShell](./admin-shell.md) — 后台应用壳:侧栏、顶栏、内容容器和移动端抽屉状态。
154
+ - [UGAppTabs](./app-tabs.md) — 应用页面标签:浏览器式当前页、关闭操作和容器内横向滚动。
155
+ - [UGDataTable](./data-table.md) — 后台数据表格:统一工具栏、身份单元格、加载、失败、空状态、排序、选择、操作列与分页结构。
156
+ - [UGTreeTable](./tree-table.md) — 树形表格:在二维数据中展示完整嵌套层级、展开、列布局和行操作。
157
+ - [UGDataTableToolbar](./data-table-toolbar.md) — 数据列表工具栏:统一标题、结果摘要和响应式筛选控件排列。
158
+ - [UGDataTableIdentity](./data-table-identity.md) — 数据表格身份单元格:统一头像或图标后的主副文本和长文案换行。
159
+ - [UGThemeConfigurator](./theme-configurator.md) — 完整外观配置:人群方案、视觉主题、模式、品牌色、布局与细节。
160
+ - [UGThemeConfiguratorDialog](./theme-configurator-dialog.md) — 标准居中外观设置弹窗:组合完整配置面板、可选实时预览与重置操作。
161
+ - [UGPageHeader](./page-header.md) — 后台页面页头:标题、说明、状态、元信息和操作区。
162
+ - [UGQuickAccess](./quick-access.md) — 后台首页和工作区的快捷入口:统一导航卡片、响应式网格与交互状态。
163
+ - [UGSelectionList](./selection-list.md) — 可搜索的分组选择列表:统一当前结果的全选、半选和锁定选项说明。
164
+ - [UGCopyField](./copy-field.md) — 只读字段复制:URL、Token、ID 等。
165
+ - [UGConfirmDialog](./confirm-dialog.md) — 危险操作和关键流程确认。
166
+ - [UGPromptComposer](./prompt-composer.md) — 会话输入:受控输入、发送/停止、Enter 语义、工具和附件扩展位。
167
+ - [UGMessage](./message.md) — 会话消息与消息列表:角色、状态、流式标识、内容插槽和跟随输出滚动。
168
+ - [UGAttachmentList](./attachment-list.md) — 附件预览:状态、元信息、移除和键盘可达操作。
169
+ - [UGConversationList](./conversation-list.md) — 会话导航:当前项、切换、数量、操作扩展和窄屏横向布局。
170
+ - [UGLandingHero](./landing-hero.md) — 展示页首屏骨架。
171
+ - [UGFeatureGrid](./feature-grid.md) — 能力点和功能模块网格骨架。
@@ -0,0 +1,41 @@
1
+ # UGIndicator 角标容器
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`indicator`。
4
+
5
+ 将状态点、徽标或操作稳定定位到内容的九个边缘锚点。
6
+
7
+ ## 适用场景
8
+
9
+ - 把状态点、数量徽标或辅助操作定位到头像、按钮、卡片等内容边缘。
10
+
11
+ ## 不适用场景
12
+
13
+ - 普通文档流内的状态文字使用 Badge;不会叠加到其他内容时不需要 Indicator。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/primitives`
18
+ - 公开成员:`UGIndicator`、`UGIndicatorItem`
19
+
20
+ ```tsx
21
+ import { UGIndicator, UGIndicatorItem } from '@ug666/ui-react/primitives'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - UGIndicatorItem 必须是 UGIndicator 的直接子元素;start/end 是逻辑方向并自动适配 RTL;装饰性状态点使用 aria-hidden。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [badge](./badge.md)
34
+ - [avatar](./avatar.md)
35
+ - [button](./button.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,42 @@
1
+ # UGInfiniteScroll 无限滚动
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`infinite-scroll`。
4
+
5
+ 在滚动阈值触发加载,支持防重、失败重试与结束状态。
6
+
7
+ ## 适用场景
8
+
9
+ - 连续资料在区域底部追加。
10
+
11
+ ## 不适用场景
12
+
13
+ - 需要稳定页码和快速定位时用 Pagination/DataTable。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGInfiniteScroll`
19
+
20
+ ```tsx
21
+ import { UGInfiniteScroll } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - React onLoad/onRetry,Vue load/retry 接受可等待函数,不从 emit 返回值判断 Promise。
27
+ - loading/finished/error 明确表达状态,失败后停止自动触发,显式重试;请求、游标、数据留在应用。
28
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
29
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
30
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
31
+
32
+ ## 相关候选
33
+
34
+ - [pagination](./pagination.md)
35
+ - [loading](./loading.md)
36
+ - [backtop](./backtop.md)
37
+
38
+ ## 生成前检查
39
+
40
+ - 当前适配器是否真实提供该组件。
41
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
42
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,42 @@
1
+ # UGInput 输入框
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`input`。
4
+
5
+ 带标签、错误信息与帮助文本的文本输入框。
6
+
7
+ ## 适用场景
8
+
9
+ - 短的单行文本、密码、搜索词和格式化文本输入。
10
+
11
+ ## 不适用场景
12
+
13
+ - 长文本使用 Textarea;固定候选使用 Select;数值步进使用 NumberInput。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/primitives`
18
+ - 公开成员:`UGInput`
19
+
20
+ ```tsx
21
+ import { UGInput } 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
+ - [textarea](./textarea.md)
34
+ - [select](./select.md)
35
+ - [number-input](./number-input.md)
36
+ - [form](./form.md)
37
+
38
+ ## 生成前检查
39
+
40
+ - 当前适配器是否真实提供该组件。
41
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
42
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,40 @@
1
+ # UGJoin 连接容器
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`join`。
4
+
5
+ 将按钮、输入框等控件连接为横向、纵向或响应式连续边界。
6
+
7
+ ## 适用场景
8
+
9
+ - 把同一任务的按钮、输入框或选择控件连接为连续横向、纵向或响应式边界。
10
+
11
+ ## 不适用场景
12
+
13
+ - 控件互不相关或需要正常间距时使用 Space;只组合按钮且需要组级外观默认值时优先 ButtonGroup。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/primitives`
18
+ - 公开成员:`UGJoin`、`UGJoinItem`
19
+
20
+ ```tsx
21
+ import { UGJoin, UGJoinItem } from '@ug666/ui-react/primitives'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 每个连续控件使用 UGJoinItem,并通过 as 渲染真实交互元素;组合需要可访问名称,窄屏布局使用 responsive。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [space](./space.md)
34
+ - [input](./input.md)
35
+
36
+ ## 生成前检查
37
+
38
+ - 当前适配器是否真实提供该组件。
39
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
40
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,40 @@
1
+ # UGKbd 键盘按键
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`kbd`。
4
+
5
+ 用于展示快捷键、组合键和键盘操作提示。
6
+
7
+ ## 适用场景
8
+
9
+ - 展示快捷键、组合键和键盘操作提示。
10
+
11
+ ## 不适用场景
12
+
13
+ - 实际监听按键或触发动作;事件逻辑留在业务层,动作入口使用 Button。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/primitives`
18
+ - 公开成员:`UGKbd`
19
+
20
+ ```tsx
21
+ import { UGKbd } from '@ug666/ui-react/primitives'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - 每个按键使用一个 Kbd;加号、斜杠和说明文字留在 Kbd 外部。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [button](./button.md)
34
+ - [text](./text.md)
35
+
36
+ ## 生成前检查
37
+
38
+ - 当前适配器是否真实提供该组件。
39
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
40
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,39 @@
1
+ # UGLabel 标签
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`label`。
4
+
5
+ 语义化表单标签,支持控件关联、必填、禁用和尺寸继承。
6
+
7
+ ## 适用场景
8
+
9
+ - 语义化表单标签,支持控件关联、必填、禁用和尺寸继承。
10
+
11
+ ## 不适用场景
12
+
13
+ - 没有额外禁止场景;仍需与相关候选组件比较后选择。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/primitives`
18
+ - 公开成员:`UGLabel`
19
+
20
+ ```tsx
21
+ import { UGLabel } 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,27 @@
1
+ # UGLandingHero
2
+
3
+ > 包版本:0.3.0-beta.4;发布合同以当前项目实际包为准。
4
+
5
+ 展示页首屏骨架。
6
+
7
+ 媒体、文案和操作入口都由业务页面传入。
8
+
9
+ ## 适用场景
10
+
11
+ - 展示页首屏骨架。
12
+
13
+ ## 不适用场景
14
+
15
+ - 先比较同一适配器的基础组件。
16
+
17
+ ## 公开导入
18
+
19
+ ```ts
20
+ import { UGLandingHero } from '@ug666/ui-react/blocks'
21
+ ```
22
+
23
+ ## 相关候选
24
+
25
+ - 暂无;仍需从组件目录按任务语义搜索。
26
+
27
+ - Props、事件和插槽以项目当前依赖的 TypeScript 类型为准。
@@ -0,0 +1,39 @@
1
+ # UGRow 布局
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`layout`。
4
+
5
+ 基于 24 栅格的 Row 与 Col 页面布局组件。
6
+
7
+ ## 适用场景
8
+
9
+ - 基于 24 栅格的 Row 与 Col 页面布局组件。
10
+
11
+ ## 不适用场景
12
+
13
+ - 没有额外禁止场景;仍需与相关候选组件比较后选择。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/primitives`
18
+ - 公开成员:`UGRow`、`UGCol`
19
+
20
+ ```tsx
21
+ import { UGRow, UGCol } 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
+ # UGLink 链接
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`link`。
4
+
5
+ 语义化链接组件,支持下划线策略、外链与禁用状态。
6
+
7
+ ## 适用场景
8
+
9
+ - 页面、路由、锚点或外部资源导航。
10
+
11
+ ## 不适用场景
12
+
13
+ - 只改变当前页面状态但不导航;这类场景使用 Button。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/primitives`
18
+ - 公开成员:`UGLink`
19
+
20
+ ```tsx
21
+ import { UGLink } 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
+ - [button](./button.md)
34
+ - [breadcrumb](./breadcrumb.md)
35
+ - [navigation-menu](./navigation-menu.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGList 列表
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`list`。
4
+
5
+ 为文件、成员、通知和对象摘要提供稳定的媒体、内容与操作列布局。
6
+
7
+ ## 适用场景
8
+
9
+ - 以稳定的媒体、主内容和操作列展示文件、成员、通知或对象摘要。
10
+
11
+ ## 不适用场景
12
+
13
+ - 二维对比数据使用 Table;菜单导航使用 Menu 或 NavigationMenu。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGList`、`UGListItem`、`UGListItemContent`、`UGListItemTitle`、`UGListItemDescription`、`UGListItemActions`
19
+
20
+ ```tsx
21
+ import { UGList, UGListItem, UGListItemContent, UGListItemTitle, UGListItemDescription, UGListItemActions } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - UGListItem 只提供行布局;点击、链接和按钮语义由行内真实交互元素承担。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [table](./table.md)
34
+ - [card](./card.md)
35
+ - [avatar](./avatar.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,40 @@
1
+ # UGLoading 加载遮罩
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`loading`。
4
+
5
+ 在保留内容布局时遮挡交互,并提供忙碌播报与焦点保护。
6
+
7
+ ## 适用场景
8
+
9
+ - 区域加载时保留布局并暂时阻止内容操作。
10
+
11
+ ## 不适用场景
12
+
13
+ - 没有额外禁止场景;仍需与相关候选组件比较后选择。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGLoading`
19
+
20
+ ```tsx
21
+ import { UGLoading } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - loading 区域使用 inert 和忙碌播报;不要覆盖焦点保护,区域结束恢复原先可用目标。
27
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
28
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
29
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
30
+
31
+ ## 相关候选
32
+
33
+ - [spinner](./spinner.md)
34
+ - [skeleton](./skeleton.md)
35
+
36
+ ## 生成前检查
37
+
38
+ - 当前适配器是否真实提供该组件。
39
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
40
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,27 @@
1
+ # UGMessage
2
+
3
+ > 包版本:0.3.0-beta.4;发布合同以当前项目实际包为准。
4
+
5
+ 会话消息与消息列表:角色、状态、流式标识、内容插槽和跟随输出滚动。
6
+
7
+ 正文完全由调用方渲染,不内置 Markdown、任务 Store 或媒体协议。
8
+
9
+ ## 适用场景
10
+
11
+ - 会话消息与消息列表:角色、状态、流式标识、内容插槽和跟随输出滚动。
12
+
13
+ ## 不适用场景
14
+
15
+ - 先比较同一适配器的基础组件。
16
+
17
+ ## 公开导入
18
+
19
+ ```ts
20
+ import { UGMessage } from '@ug666/ui-react/patterns'
21
+ ```
22
+
23
+ ## 相关候选
24
+
25
+ - 暂无;仍需从组件目录按任务语义搜索。
26
+
27
+ - Props、事件和插槽以项目当前依赖的 TypeScript 类型为准。