@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
+ # UGTransfer 穿梭框
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`transfer`。
4
+
5
+ 在左右列表间移动选项,支持远程分页及分窗,保留锁定与未知既有值。
6
+
7
+ ## 适用场景
8
+
9
+ - 本地或明确分页的数据集需要左右对照并批量移入移出。
10
+
11
+ ## 不适用场景
12
+
13
+ - 需要跨远程全部结果执行全选时使用明确的业务批处理流程,不能把当前页全选当全部。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTransfer`
19
+
20
+ ```tsx
21
+ import { UGTransfer } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - data.key 唯一且稳定;搜索和批量操作保留隐藏、禁用既有及未知 key。
27
+ - name/form 重复提交 JSON 编码 key,避免数字和字符串身份混淆。
28
+ - loadPage 接收 direction/page/pageSize/query/selectedKeys/signal;两侧页码和请求独立,只操作已加载项。virtualWindowSize 是显式候选分窗。
29
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
30
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
31
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
32
+
33
+ ## 相关候选
34
+
35
+ - [selection-list](./selection-list.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,45 @@
1
+ # UGTreeSelect 树形选择
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`tree-select`。
4
+
5
+ 单选或勾选层级字段,支持祖先保留搜索、独立展开、级联半选、清空和原生表单提交。
6
+
7
+ ## 适用场景
8
+
9
+ - 从部门、分类等层级候选中单选或勾选多个节点,且需要保留祖先上下文。
10
+
11
+ ## 不适用场景
12
+
13
+ - 平铺或远程候选使用 Select;完整路径使用 Cascader;常驻展示层级使用 Tree。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTreeSelect`
19
+
20
+ ```tsx
21
+ import { UGTreeSelect } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - items 使用稳定 key;默认 value/modelValue 为单 key,展开与选择独立。
27
+ - checkable 使用 checkedKeys/defaultCheckedKeys,React onCheckedKeysChange、Vue update:checkedKeys/check-change;checkStrictly 独立勾选,否则级联并提供 halfCheckedKeys。
28
+ - name/form 参与真实原生表单,多选重复同名 key 字段;禁用不提交,reset 不改受控外部值。
29
+ - disabled 只禁止选择;停用分支仍可展开。loadChildren 接收节点及 signal,isLeaf 明确终点;不承诺虚拟树或整库 Element API 兼容。
30
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
31
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
32
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
33
+
34
+ ## 相关候选
35
+
36
+ - [tree](./tree.md)
37
+ - [select](./select.md)
38
+ - [input](./input.md)
39
+ - [form](./form.md)
40
+
41
+ ## 生成前检查
42
+
43
+ - 当前适配器是否真实提供该组件。
44
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
45
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,27 @@
1
+ # UGTreeTable
2
+
3
+ > 包版本:0.3.0-beta.4;发布合同以当前项目实际包为准。
4
+
5
+ 树形表格:在二维数据中展示完整嵌套层级、展开、列布局和行操作。
6
+
7
+ 复用 DataTable;rows 是完整嵌套根记录,getRowId 返回稳定唯一标识,getChildren 默认读取 children;展开仅投影可见行,不分页、不截断、不改原记录。列支持 width/minWidth/align/fixed,偏移按真实宽度测量;请求、权限、排序和勾选级联由消费方负责。使用原生 table 与可访问展开按钮,不声明 treegrid 或虚拟树表能力。
8
+
9
+ ## 适用场景
10
+
11
+ - 树形表格:在二维数据中展示完整嵌套层级、展开、列布局和行操作。
12
+
13
+ ## 不适用场景
14
+
15
+ - 先比较同一适配器的基础组件。
16
+
17
+ ## 公开导入
18
+
19
+ ```ts
20
+ import { UGTreeTable } from '@ug666/ui-react/patterns'
21
+ ```
22
+
23
+ ## 相关候选
24
+
25
+ - 暂无;仍需从组件目录按任务语义搜索。
26
+
27
+ - Props、事件和插槽以项目当前依赖的 TypeScript 类型为准。
@@ -0,0 +1,43 @@
1
+ # UGTree 树形列表
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`tree`。
4
+
5
+ 层级选择、展开、搜索、懒加载和拖放事件;请求及业务重排由应用负责。
6
+
7
+ ## 适用场景
8
+
9
+ - 常驻展示和选择部门、分类等层级,且需要独立展开与搜索。
10
+
11
+ ## 不适用场景
12
+
13
+ - 浮层中的层级单选或勾选使用 TreeSelect;平铺候选使用 Select。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTree`
19
+
20
+ ```tsx
21
+ import { UGTree } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - items 使用稳定 key/label/children,展开与选择独立;query 搜索临时展开祖先,清空后恢复。
27
+ - checkable 与 checkedKeys/defaultCheckedKeys 提供勾选;checkStrictly 独立,否则父子联动与半选。禁用及未知既有 key 保留,搜索不改变已选集合;授权目录和业务勾选级联策略由应用负责。
28
+ - showNodeIcons 默认 true,统一控制默认和自定义装饰;React renderNodeIcon / Vue node-icon 插槽接收 node、expanded、hasChildren,可将部门显示为组织图标。自定义内容只替换默认装饰,使用 16px 静态图标,不放交互节点;空内容保留槽宽。关闭装饰仍保留展开箭头、缩进、键盘与选择,不用业务私有 CSS 重画。
29
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
30
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
31
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
32
+
33
+ ## 相关候选
34
+
35
+ - [tree-select](./tree-select.md)
36
+ - [input](./input.md)
37
+ - [splitter](./splitter.md)
38
+
39
+ ## 生成前检查
40
+
41
+ - 当前适配器是否真实提供该组件。
42
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
43
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,41 @@
1
+ # UGTrendChart 趋势图
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`trend-chart`。
4
+
5
+ 用于以轻量折线和面积展示连续数据变化。
6
+
7
+ ## 适用场景
8
+
9
+ - 少量连续数据需要多系列趋势对比、图例筛选和逐点明细。
10
+
11
+ ## 不适用场景
12
+
13
+ - 需要缩放、钻取、复杂坐标轴或海量数据时使用独立图表扩展包。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGTrendChart`
19
+
20
+ ```tsx
21
+ import { UGTrendChart } 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
+ - [donut-chart](./donut-chart.md)
35
+ - [bar-chart](./bar-chart.md)
36
+
37
+ ## 生成前检查
38
+
39
+ - 当前适配器是否真实提供该组件。
40
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
41
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,43 @@
1
+ # UGUpload 上传
2
+
3
+ > 适配器:React;包版本:0.3.0-beta.4;状态:available;slug:`upload`。
4
+
5
+ 管理文件选择、校验、进度、取消和重试,请求由应用提供。
6
+
7
+ ## 适用场景
8
+
9
+ - 文件选择后需要列表、进度、取消、失败重试和拖放。
10
+
11
+ ## 不适用场景
12
+
13
+ - 只需要浏览器原生文件表单字段时使用 FileInput。
14
+
15
+ ## 公开入口
16
+
17
+ - 包入口:`@ug666/ui-react/components`
18
+ - 公开成员:`UGUpload`
19
+
20
+ ```tsx
21
+ import { UGUpload } from '@ug666/ui-react/components'
22
+ ```
23
+
24
+ ## 使用规则
25
+
26
+ - request 由业务提供并遵守 signal/onProgress;组件不管理接口、凭据或对象存储。
27
+ - 未传 request 仅选择文件,不显示虚假成功。File 从 fileList 获取,不声称 Upload 自动生成原生 multipart 字段。
28
+ - 受控 fileList 以外部值为准;实际移除或卸载后旧结果失效。非受控 reset 取消任务并恢复初值;受控 reset 不改外部列表及其保留任务,父级实际移除后才失效。
29
+ - 受控值使用当前组件声明的 value/onValueChange 或公开回调。
30
+ - 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
31
+ - 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。
32
+
33
+ ## 相关候选
34
+
35
+ - [file-input](./file-input.md)
36
+ - [image](./image.md)
37
+ - [progress](./progress.md)
38
+
39
+ ## 生成前检查
40
+
41
+ - 当前适配器是否真实提供该组件。
42
+ - 导入路径、组件名和 API 是否存在于当前版本类型声明。
43
+ - 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。
@@ -0,0 +1,97 @@
1
+ # React 组件使用策略
2
+
3
+ 完整组件名称、层级和当前版本由同目录 `release.md` 自动生成。本文件只维护不随组件数量变化的使用规则。
4
+
5
+ ## 分层选择
6
+
7
+ | 层级 | 适用场景 | 导入方式 |
8
+ |---|---|---|
9
+ | 主入口 | 高频稳定组件、常用 hooks | `@ug666/ui-react` |
10
+ | primitives | 轻量基础能力 | `@ug666/ui-react/primitives` |
11
+ | components | 通用交互能力 | `@ug666/ui-react/components` |
12
+ | patterns | 后台、表单和工具型组合 | `@ug666/ui-react/patterns` |
13
+ | blocks | 展示页与产品区块 | `@ug666/ui-react/blocks` |
14
+ | hooks | React 通用状态工具 | `@ug666/ui-react/hooks` |
15
+ | theme | 主题运行时 | `@ug666/ui-react/theme` |
16
+
17
+ 只有 `release.md` 列出的入口才是当前版本公开合同。
18
+
19
+ ## 选择原则
20
+
21
+ - 操作使用 Button,导航使用 Link。
22
+ - 紧凑图标操作使用 `UGButton size="icon-sm"`,常规图标操作使用 `size="icon"`;两者都必须提供可访问名称。
23
+ - 有标签、错误、帮助文字的字段使用表单组件合同,不手工拼 ARIA。
24
+ - 错误、帮助文字和通知消息会自动断开超长标识符;不要在消费项目穿透 message slot 修补换行。
25
+ - Toast 关闭会先进入不可交互的 `closed` 离场状态,再由统一动效完成卸载;业务侧不要自行延迟删除或覆盖通知动画。
26
+ - Select、Checkbox、Radio、Switch 等值组件使用各自公开值事件。
27
+ - 层级单选使用 `UGTreeSelect items={tree} value={key} onValueChange={setKey}`;可启用 `filterable clearable defaultExpandAll`。父节点与叶子均可选,停用分支仍可展开,清空返回 `undefined`。勾选使用 `checkable/checkedKeys/onCheckedKeysChange`,加载子项用 `loadChildren(node,{signal})` 和 `isLeaf`。平铺或搜索式 remote 候选使用 Select,常驻层级使用 Tree。原生 name/required 与尺寸继承保留,不在业务层重画浮层。
28
+ - Tree/TreeSelect 同一加载来源保持 `loadChildren` 引用稳定,必要时仅对该回调使用 `useCallback`;新引用或移除回调会取消请求并清缓存/错误,晚到旧结果被丢弃。节点对象不变、loader 不变时复用缓存,组件自身搜索/展开不应导致重载。
29
+ - Input/Textarea 的清空和 Input 密码切换保留在 Tab 顺序中;Select 的名称、键盘高亮和候选项滚动由组件维护,不在业务层覆盖。
30
+ - Modal、Drawer、Dropdown、Select、Tooltip、Popover 与 ContextMenu 等浮层必须验证 Portal 主题继承、焦点返回和视口安全区;长内容由组件内部换行或滚动,业务侧不重复指定超视口宽高。
31
+ - Dropdown 中的互斥偏好使用 `UGDropdownRadioItem` 并传入 `checked`;不要用普通菜单项手写勾选图标或单选 ARIA。
32
+ - Tooltip 的悬停延迟通过根组件 `delayDuration` 配置;传 `0` 可立即显示,键盘聚焦不受延迟影响。
33
+ - 浮层翻转方向后的进入/离场动画由组件依据最终方位维护,业务侧不要覆盖 `data-side` 动效。
34
+ - Input、Textarea、Select、Checkbox、Radio 与 Switch 的标签、帮助和错误内容已处理收缩及连续字符断行;业务侧不要添加固定高度或 `nowrap`。
35
+ - 独立 `UGLabel` 已处理多行行高、连续标识断行和必填标记避让;`UGAvatarFallback` 的默认图标会随头像尺寸等比缩放并使用统一短入场动效,不要在业务侧重新固定行高或图标像素。
36
+ - 列表、表格、分页、空状态和加载状态使用同一套语义组件,避免页面内视觉漂移。
37
+ - 原生 multipart 文件字段使用 `UGFileInput`,相关字段组使用 `UGFieldset + UGFieldsetLegend`。已有 `UGUpload` 负责拖放、文件列表、类型/大小/数量校验、进度、取消、删除和显式重试;业务通过 `request` 提供传输、鉴权与服务端校验,未提供请求时仅选择文件。
38
+ - 单块补充内容使用 `UGCollapsible`,多项展开组使用 `UGAccordion`;对象摘要使用 `UGList`,二维数据继续使用 Table。
39
+ - 评分输入使用原生单选合同的 `UGRating`,只读评分显式设置 `readOnly`;历史事件使用 `UGTimeline`,当前流程使用 Steps。
40
+ - 单月日期选择使用 `UGCalendar`;一体式日期范围输入使用 `UGDateRangePicker`,保留本地 ISO 与单边草稿,调用方在提交入口校验。Calendar 可用 `range / previewRange / onDateHover` 组合无业务的范围展示;预览不提交值。图片或卡片轮播使用 `UGCarousel + UGCarouselItem`,索引从 0 开始,默认不自动播放。
41
+ - Card 的公共视觉层级使用 `variant`,内容密度使用 `size`;标题已处理长文本换行和行高,业务侧只补布局与内容节奏,不重复手写边框、背景、阴影、内部 padding 或固定标题高度。
42
+ - Alert、EmptyState 与 Accordion 的标题/说明区已经建立可收缩和安全断行合同;业务侧不要用固定高度、`nowrap` 或穿透子节点重做长内容布局。
43
+ - Progress、Spinner、Skeleton 和 Accordion 统一读取 motion Token;业务侧只更新状态和值,不覆盖持续时间、缓动或进入/退出关键帧。
44
+ - Table 的横向浏览由可聚焦滚动区域负责;业务侧提供可访问名称,不在页面外层叠加第二层横向滚动。
45
+ - Scrollbar 默认可聚焦并自带焦点反馈,必须通过 `aria-label` 或 `aria-labelledby` 说明滚动内容;Splitter 的拖拽和焦点手柄反馈由组件维护,业务侧不得给面板比例添加过渡。
46
+ - Statistic 的标题、数值、前后缀与趋势说明支持窄容器断行和语义色过渡;业务侧只设置卡片 Grid,不用 `nowrap` 或固定宽度重做内部数值行。
47
+ - Badge 的公共密度使用 `size="sm|md|lg"`;业务侧只设置布局或最大宽度,不用 `className` 重做高度、内边距和字号。
48
+ - Tag 的公共密度使用 `size="sm|md|lg"`;`default` 只作为 `md` 的兼容别名,新代码不再依赖它。
49
+ - Breadcrumb 的文字、层级高度和分隔图标使用 `size="sm|md|lg"` 统一控制,不用 `className` 分别修补。
50
+ - NavigationMenu 的下拉链接默认纵向排列并处理长文本;Pagination 和 Tabs 在窄容器中保持单行水平浏览,业务侧不重写这些 Anatomy。
51
+ - Sheet 的面板宽度使用 `size="sm|md|lg"`,底部操作使用 `footer`;业务侧不重复维护面板宽度、边界和固定操作区。
52
+ - Drawer 的主轴尺寸使用 `size="sm|md|lg"`:左右方向控制宽度,上下方向控制高度;根容器样式使用 `className`,面板样式只通过 `UGDrawerContent.className` 补业务布局。
53
+ - Dialog 的固定确认结构会统一维护宽度、长内容滚动、操作区换行和进入/退出动画;业务侧只传标题、说明、文案和回调,不用 `className` 重做面板 Anatomy。
54
+ - Tabs 使用 `size` 和 `variant`,Table 使用 `size / bordered / striped / hoverable`,Modal 使用 `size`;不要用 `className` 复制这些基础外观。
55
+ - 会话产品使用 `UGPromptComposer`、`UGMessageList`、`UGMessage`、`UGAttachmentList`、`UGConversationList` 组合公共交互;请求、Markdown、任务和持久化继续留在业务层。
56
+ - 后台产品用 `UGAdminShell` 统一侧栏与顶栏;菜单父项只负责展开,模块首页显式建成首个叶子项。平台、租户、工作区或环境切换使用默认关闭的 `sidebarContextSwitcher / sidebarContextSwitcherVisible`,不占用一级菜单;用 `sidebarContextSwitcherPlacement` 控制它与搜索区的顺序。活动菜单默认自动滚入可视区域。折叠入口使用 `sidebarTogglePlacement="sidebar|topbar|bottom"` 选择位置,折叠品牌使用 `sidebarCollapsedHeader`,拖拽宽度使用默认关闭的 `sidebarResizable`,静态展开宽度直接使用 `sidebarWidth / defaultSidebarWidth`。品牌对齐与品牌分隔线使用 `sidebarHeaderAlign / sidebarHeaderDivider`,搜索区使用 `sidebarSearchable / sidebarSearchPlaceholder / sidebarSearchDividers`,页脚通过可选 `sidebarFooter` 完全替换,不复制壳层结构或穿透内部 Anatomy。
57
+ - 完整外观设置使用 `/patterns` 的 `UGThemeConfigurator` 或 `UGThemeConfiguratorDialog`,在左侧固定显示竖向“主题外观 / 导航菜单”两个 Tab,通过 `value / onValueChange` 与必传的 `sidebarValue / onSidebarValueChange` 分别受控;导航值包含左侧/顶部模式、配色基准、五项颜色、活动样式与密度。相关扩展只放进 `appearanceAddon / sidebarAddon`,存储留在业务。`UGThemeController` 只用于单项属性控制。
58
+ - 业务数据请求、权限和路由留在业务层,通过 props、状态和回调传入 UG UI。
59
+
60
+ ## 判断 API 是否可用
61
+
62
+ 按以下顺序检查:
63
+
64
+ 1. `release.md`:组件和入口是否属于当前包版本。
65
+ 2. 包类型声明:Props、事件、ref 和导出类型。
66
+ 3. 文档站当前组件页:真实示例、边界行为和响应式说明。
67
+ 4. CHANGELOG:升级是否包含兼容性变化。
68
+
69
+ 不要从其他框架、旧版本代码或组件内部实现推导公开 API。
70
+
71
+ ## React 专属边界
72
+
73
+ - 管理场景进阶能力见 `docs/ADVANCED_COMPONENT_CONTRACTS.md` 及当前类型:日期 mode/多选/shortcuts、DateTime range、Cascader lazyLoad/Transfer loadPage、Tree loadChildren/drop、DataTable children/span/summary/order、useForm 嵌套路径/fieldArray。`virtualWindowSize` 是显式候选分窗,不是滚动虚拟化;请求及业务重排在应用。
74
+ - SelectionList `/patterns` 可用 `layout="grid" / collapsibleGroups / expandedGroups / onExpandedGroupsChange`;组 key 为 `group:名称` 或 `ungrouped`,搜索临时展开且保留既有/锁定值。Modal `initialFocusSelector` 支持异步首字段且用户移动焦点后不抢回。
75
+ - Dialog prompt/validateInput/confirmAction/onDismiss、createToastStore 显式隔离、Progress circle/dashboard、Statistic countdownTo/paused、NavigationMenu orientation/collapsed/onNavigate、Tabs onClose/onAdd、Steps variant、Carousel card、Calendar renderDateCell 均按公开类型使用,不推导 Element API。
76
+
77
+ - Server Component 不直接导入依赖浏览器状态的客户端组件。
78
+ - 使用 `useState`、Portal、浏览器事件或本地存储的页面需要清晰的 client boundary。
79
+ - ref 只依赖组件明确暴露的原生元素或公开方法。
80
+ - 不在模块顶层访问 `window`、`document` 或 `localStorage`。
81
+
82
+ ## 业务封装
83
+
84
+ 允许:
85
+
86
+ - 把 API DTO 转成组件需要的 options、rows、items。
87
+ - 统一默认文案、空状态、loading 和错误映射。
88
+ - 用公开 `className`、`style`、Token 做页面布局、内容排版和业务语义强调。
89
+ - 复杂按钮内容使用一个完整的子容器组织,不依赖组件内部 slot DOM。
90
+
91
+ 不允许:
92
+
93
+ - 把请求、Cookie、鉴权或权限判断塞进 UG UI。
94
+ - 复制组件内部 DOM 和 anatomy。
95
+ - 使用 `[data-ug-slot=...]` 等选择器穿透组件内部结构。
96
+ - 长期 fork Button、Input、Modal、Table 等基础组件。
97
+ - 从 `dist` 深路径绕开 exports。
@@ -0,0 +1,50 @@
1
+ # UGDataTable
2
+
3
+ ```tsx
4
+ /** @description DataTable 受限高度、状态与分页的公开使用示例。 */
5
+ import { useState } from 'react'
6
+ import { UGButton, UGInput } from '@ug666/ui-react'
7
+ import { UGDataTable, UGDataTableIdentity, UGDataTableToolbar } from '@ug666/ui-react/patterns'
8
+
9
+ const modes = ['少量数据', '长列表', '空数据', '加载中', '加载失败'] as const
10
+
11
+ export default function DataTableFillDemo() {
12
+ const [mode, setMode] = useState<typeof modes[number]>('少量数据')
13
+ const [fill, setFill] = useState(true)
14
+ const [bordered, setBordered] = useState(true)
15
+ const [page, setPage] = useState(1)
16
+ const [pageSize, setPageSize] = useState(2)
17
+ const [order, setOrder] = useState<'asc' | 'desc'>('asc')
18
+ const [actionResult, setActionResult] = useState('尚未操作')
19
+ const [query, setQuery] = useState('')
20
+ const total = mode === '长列表' ? 80 : mode === '空数据' ? 0 : 4
21
+ const matches = Array.from({ length: total }, (_, index) => ({ id: String(index + 1), name: `记录 ${index + 1}`, description: '资料核对与成员协作' }))
22
+ .filter(({ name }) => name.includes(query.trim()))
23
+ .sort((left, right) => left.name.localeCompare(right.name, 'zh-CN', { numeric: true }) * (order === 'asc' ? 1 : -1))
24
+ const rows = matches.slice((page - 1) * pageSize, page * pageSize)
25
+ return <section className="space-y-3 border-t border-border-base p-[var(--content-gap)]" aria-label="填满高度的数据表格">
26
+ <h3 className="text-base font-semibold text-text-primary">DataTable 填满高度</h3>
27
+ <p className="text-sm text-text-secondary">父容器设置高度后开启 fill,表格内部滚动,分页留在底部;无边框填充列表使用直角,有边框和独立布局保留圆角。空数据提示在可见表格区域居中,横向滚动后仍可阅读。</p>
28
+ <div className="flex flex-wrap gap-2">
29
+ {modes.map((value) => <UGButton key={value} size="sm" variant={mode === value ? 'soft' : 'default'} tone={mode === value ? 'primary' : 'neutral'} aria-pressed={mode === value} onClick={() => { setMode(value); setPage(1); setPageSize(value === '长列表' ? 40 : 2) }}>{value}</UGButton>)}
30
+ <UGButton size="sm" variant={fill ? 'soft' : 'default'} tone={fill ? 'primary' : 'neutral'} aria-pressed={fill} onClick={() => setFill(!fill)}>填满容器</UGButton>
31
+ <UGButton size="sm" variant={bordered ? 'soft' : 'default'} tone={bordered ? 'primary' : 'neutral'} aria-pressed={bordered} onClick={() => setBordered(!bordered)}>显示边框</UGButton>
32
+ </div>
33
+ <UGDataTableToolbar description={`${rows.length} 条当前结果`} title="资料列表">
34
+ <UGInput aria-label="搜索资料" placeholder="搜索资料" value={query} onChange={(event) => { setQuery(event.target.value); setPage(1) }} />
35
+ </UGDataTableToolbar>
36
+ <div style={{ height: 360 }} data-testid="data-table-fill-container">
37
+ <UGDataTable fill={fill} bordered={bordered} rows={rows} columns={[{ id: 'name', header: '名称', sortable: true, cell: (row) => <UGDataTableIdentity title={row.name} description={row.description} /> }, { id: 'description', header: '说明', cell: (row) => row.description }]}
38
+ sort="name" order={order} onSortChange={(_column, nextOrder) => { setOrder(nextOrder); setPage(1) }}
39
+ getRowId={(row) => row.id} page={page} total={matches.length} pageSize={pageSize} pageSizeOptions={[2, 10, 20, 40, 50]} onPageChange={setPage} onPageSizeChange={(size) => { setPageSize(size); setPage(1) }}
40
+ loading={mode === '加载中'} error={mode === '加载失败' ? '请稍后重试读取资料。' : undefined} onRetry={() => setMode('少量数据')}
41
+ rowActions={(row) => <>
42
+ <UGButton variant="link" tone="primary" onClick={() => setActionResult(`正在查看${row.name}`)}>查看{row.name}</UGButton>
43
+ <UGButton variant="link" tone="primary" onClick={() => setActionResult(`正在编辑${row.name}`)}>编辑</UGButton>
44
+ </>}
45
+ scrollRegionLabel="填满表格滚动区域" />
46
+ </div>
47
+ <p role="status">{actionResult}</p>
48
+ </section>
49
+ }
50
+ ```
@@ -0,0 +1,159 @@
1
+ # UG UI 发布参考
2
+
3
+ > 本文件由文档站构建脚本根据 `configs/registry/entrypoints.ts`、`configs/registry/registry.ts` 和 package manifest 自动生成,请勿手工维护。
4
+
5
+ - 包:`@ug666/ui-react`
6
+ - 版本:`0.3.0-beta.4`
7
+ - 框架:`react`
8
+ - 此指南对应 tarball `@ug666/ui-react@0.3.0-beta.4`。确认 npm 已分发该版本后运行 `bun add @ug666/ui-react@0.3.0-beta.4`。
9
+
10
+ ## 公开入口
11
+
12
+ - `@ug666/ui-react` — stable;保留现有高频组件与 hooks,兼容旧业务接入。
13
+ - `@ug666/ui-react/styles.css` — stable;业务应用入口引入一次,包含组件样式与设计 token。
14
+ - `@ug666/ui-react/essentials.css` — beta;只使用 Button、Input、Textarea 时减少样式体积;出现其他组件时切回完整 styles.css。
15
+ - `@ug666/ui-react/essentials` — beta;与 essentials.css 配对,只导出 Button、Input、Textarea,避免引入完整组件聚合层。
16
+ - `@ug666/ui-react/tokens.css` — stable;只需要原始 CSS 变量和 Tailwind v4 token 桥接时使用。
17
+ - `@ug666/ui-react/primitives` — stable;Button、Input、Card、Badge 等轻量基础组件。
18
+ - `@ug666/ui-react/components` — stable;Modal、Drawer、Tabs、Table 等通用交互组件。
19
+ - `@ug666/ui-react/patterns` — beta;应用壳、页面页头、复制字段、分组选择列表、确认弹窗等通用模式。
20
+ - `@ug666/ui-react/blocks` — beta;展示页和产品页区块骨架,可按项目风格组合使用。
21
+ - `@ug666/ui-react/hooks` — stable;通用 React hooks。
22
+ - `@ug666/ui-react/theme` — beta;ThemeProvider、ThemeScope、ThemeSurface 和 useUGTheme。
23
+ - `@ug666/ui-react/themes/default.css` — beta;默认主题的显式 CSS 入口,适合需要固定 preset 的应用。
24
+ - `@ug666/ui-react/themes/minimal.css` — beta;轻量、低阴影主题骨架。
25
+ - `@ug666/ui-react/themes/dense.css` — beta;高信息密度后台:小圆角、16px 间距、浅灰页面底色。
26
+ - `@ug666/ui-react/themes/mecha.css` — beta;机械感主题骨架,保持独立 CSS 入口。
27
+
28
+ ## 稳定组件目录
29
+
30
+ - `UGButton` — 基础原语 / `button`
31
+ - `UGButtonGroup` — 基础原语 / `button-group`
32
+ - `UGInput` — 基础原语 / `input`
33
+ - `UGLabel` — 基础原语 / `label`
34
+ - `UGCard` — 基础原语 / `card`
35
+ - `UGBadge` — 基础原语 / `badge`
36
+ - `UGTag` — 基础原语 / `tag`
37
+ - `UGSeparator` — 基础原语 / `separator`
38
+ - `UGKbd` — 基础原语 / `kbd`
39
+ - `UGSpinner` — 基础原语 / `spinner`
40
+ - `UGLink` — 基础原语 / `link`
41
+ - `UGText` — 基础原语 / `text`
42
+ - `UGSpace` — 基础原语 / `space`
43
+ - `UGScrollbar` — 基础原语 / `scrollbar`
44
+ - `UGIndicator` — 基础原语 / `indicator`
45
+ - `UGJoin` — 基础原语 / `join`
46
+ - `UGStack` — 基础原语 / `stack`
47
+ - `UGRow` — 基础原语 / `layout`
48
+ - `UGContainer` — 基础原语 / `container`
49
+ - `UGConfigProvider` — 基础原语 / `config-provider`
50
+ - `UGSplitter` — 基础原语 / `splitter`
51
+ - `UGSplitterPanel` — 基础原语 / `splitter-panel`
52
+ - `UGIcon` — 基础原语 / `icon`
53
+ - `UGAutocomplete` — 表单输入 / `autocomplete`
54
+ - `UGCascader` — 表单输入 / `cascader`
55
+ - `UGTransfer` — 表单输入 / `transfer`
56
+ - `UGColorPicker` — 表单输入 / `color-picker`
57
+ - `UGUpload` — 表单输入 / `upload`
58
+ - `UGDatePicker` — 表单输入 / `date-picker`
59
+ - `UGTimePicker` — 表单输入 / `time-picker`
60
+ - `UGTimeSelect` — 表单输入 / `time-select`
61
+ - `UGTimeRangePicker` — 表单输入 / `time-range-picker`
62
+ - `UGDateTimePicker` — 表单输入 / `date-time-picker`
63
+ - `UGTextarea` — 表单输入 / `textarea`
64
+ - `UGSelect` — 表单输入 / `select`
65
+ - `UGTreeSelect` — 表单输入 / `tree-select`
66
+ - `UGFileInput` — 表单输入 / `file-input`
67
+ - `UGFieldset` — 表单输入 / `fieldset`
68
+ - `UGCheckbox` — 表单输入 / `checkbox`
69
+ - `UGCheckboxGroup` — 表单输入 / `checkbox-group`
70
+ - `UGRadio` — 表单输入 / `radio`
71
+ - `UGSwitch` — 表单输入 / `switch`
72
+ - `UGThemeController` — 表单输入 / `theme-controller`
73
+ - `UGSlider` — 表单输入 / `slider`
74
+ - `UGRating` — 表单输入 / `rating`
75
+ - `UGCalendar` — 表单输入 / `calendar`
76
+ - `UGDateRangePicker` — 表单输入 / `date-range-picker`
77
+ - `UGNumberInput` — 表单输入 / `number-input`
78
+ - `UGOTPInput` — 表单输入 / `otp-input`
79
+ - `UGForm` — 表单输入 / `form`
80
+ - `UGBacktop` — 导航流程 / `backtop`
81
+ - `UGTabs` — 导航流程 / `tabs`
82
+ - `UGBreadcrumb` — 导航流程 / `breadcrumb`
83
+ - `UGPagination` — 导航流程 / `pagination`
84
+ - `UGNavigationMenu` — 导航流程 / `navigation-menu`
85
+ - `UGSidebar` — 导航流程 / `sidebar`
86
+ - `UGDock` — 导航流程 / `dock`
87
+ - `UGNavbar` — 导航流程 / `navbar`
88
+ - `UGSteps` — 导航流程 / `steps`
89
+ - `UGPopconfirm` — 浮层弹层 / `popconfirm`
90
+ - `UGModal` — 浮层弹层 / `modal`
91
+ - `UGDialog` — 浮层弹层 / `dialog`
92
+ - `UGDrawer` — 浮层弹层 / `drawer`
93
+ - `UGSheet` — 浮层弹层 / `sheet`
94
+ - `UGDropdownMenu` — 浮层弹层 / `dropdown`
95
+ - `UGContextMenu` — 浮层弹层 / `context-menu`
96
+ - `UGPopover` — 浮层弹层 / `popover`
97
+ - `UGTooltip` — 浮层弹层 / `tooltip`
98
+ - `UGFab` — 浮层弹层 / `fab`
99
+ - `UGResult` — 反馈状态 / `result`
100
+ - `UGLoading` — 反馈状态 / `loading`
101
+ - `UGNotification` — 反馈状态 / `notification`
102
+ - `UGAlert` — 反馈状态 / `alert`
103
+ - `UGToaster` — 反馈状态 / `toast`
104
+ - `UGProgress` — 反馈状态 / `progress`
105
+ - `UGRadialProgress` — 反馈状态 / `radial-progress`
106
+ - `UGSkeleton` — 反馈状态 / `skeleton`
107
+ - `UGEmptyState` — 反馈状态 / `empty-state`
108
+ - `UGImage` — 数据展示 / `image`
109
+ - `UGImageViewer` — 数据展示 / `image-viewer`
110
+ - `UGInfiniteScroll` — 数据展示 / `infinite-scroll`
111
+ - `UGTable` — 数据展示 / `table`
112
+ - `UGDescriptions` — 数据展示 / `descriptions`
113
+ - `UGStatistic` — 数据展示 / `statistic`
114
+ - `UGDataPanel` — 数据展示 / `data-panel`
115
+ - `UGStatisticCard` — 数据展示 / `statistic-card`
116
+ - `UGTrendChart` — 数据展示 / `trend-chart`
117
+ - `UGDonutChart` — 数据展示 / `donut-chart`
118
+ - `UGRankingList` — 数据展示 / `ranking-list`
119
+ - `UGBarChart` — 数据展示 / `bar-chart`
120
+ - `UGGaugeChart` — 数据展示 / `gauge-chart`
121
+ - `UGStackedBarChart` — 数据展示 / `stacked-bar-chart`
122
+ - `UGHeatmapChart` — 数据展示 / `heatmap-chart`
123
+ - `UGRadarChart` — 数据展示 / `radar-chart`
124
+ - `UGAvatar` — 数据展示 / `avatar`
125
+ - `UGAvatarGroup` — 数据展示 / `avatar-group`
126
+ - `UGAccordion` — 数据展示 / `accordion`
127
+ - `UGCollapsible` — 数据展示 / `collapse`
128
+ - `UGList` — 数据展示 / `list`
129
+ - `UGTree` — 数据展示 / `tree`
130
+ - `UGCarousel` — 数据展示 / `carousel`
131
+ - `UGTimeline` — 数据展示 / `timeline`
132
+
133
+ ## 高级与实验入口
134
+
135
+ - `UGAdminShell` — patterns / available / `@ug666/ui-react/patterns`
136
+ - `UGAppTabs` — patterns / available / `@ug666/ui-react/patterns`
137
+ - `UGDataTable` — patterns / available / `@ug666/ui-react/patterns`
138
+ - `UGTreeTable` — patterns / available / `@ug666/ui-react/patterns`
139
+ - `UGDataTableToolbar` — patterns / available / `@ug666/ui-react/patterns`
140
+ - `UGDataTableIdentity` — patterns / available / `@ug666/ui-react/patterns`
141
+ - `UGThemeConfigurator` — patterns / available / `@ug666/ui-react/patterns`
142
+ - `UGThemeConfiguratorDialog` — patterns / available / `@ug666/ui-react/patterns`
143
+ - `UGPageHeader` — patterns / available / `@ug666/ui-react/patterns`
144
+ - `UGQuickAccess` — patterns / available / `@ug666/ui-react/patterns`
145
+ - `UGSelectionList` — patterns / available / `@ug666/ui-react/patterns`
146
+ - `UGCopyField` — patterns / available / `@ug666/ui-react/patterns`
147
+ - `UGConfirmDialog` — patterns / available / `@ug666/ui-react/patterns`
148
+ - `UGPromptComposer` — patterns / available / `@ug666/ui-react/patterns`
149
+ - `UGMessage` — patterns / available / `@ug666/ui-react/patterns`
150
+ - `UGAttachmentList` — patterns / available / `@ug666/ui-react/patterns`
151
+ - `UGConversationList` — patterns / available / `@ug666/ui-react/patterns`
152
+ - `UGLandingHero` — blocks / available / `@ug666/ui-react/blocks`
153
+ - `UGFeatureGrid` — blocks / available / `@ug666/ui-react/blocks`
154
+
155
+ ## 使用约束
156
+
157
+ - 具体 Props、事件和插槽以当前版本类型声明与文档站对应组件页为准。
158
+ - `patterns`、`blocks` 使用各自子入口,不假定它们全部从主入口导出。
159
+ - 不根据旧项目代码猜测 API;版本升级后先查看本文件和包类型声明。
Binary file
@@ -1 +1 @@
1
- "use strict";function _optionalChain(a){let e,l=a[0],t=1;for(;t<a.length;){const i=a[t],r=a[t+1];if(t+=2,("optionalAccess"===i||"optionalCall"===i)&&null==l)return;"access"===i||"optionalAccess"===i?(e=l,l=r(l)):"call"!==i&&"optionalCall"!==i||(l=r((...a)=>l.call(e,...a)),e=void 0)}return l}Object.defineProperty(exports,"__esModule",{value:!0});var a=require("../chunk-XVFRKGM7.cjs"),e=require("react"),l=require("lucide-react"),t=require("react/jsx-runtime"),i={2:"lg:grid-cols-2",3:"lg:grid-cols-3",4:"lg:grid-cols-4"},r={2:"two",3:"three",4:"four"},s=e.forwardRef.call(void 0,({title:e,description:s,features:c,columns:o=3,showIcon:n=!0,showAction:d=!0,actionLabel:x="查看详情",bordered:v=!0,className:u,...g},m)=>{const p=a.cn.call(void 0,"flex min-w-0 flex-col gap-[var(--content-gap)] rounded-[var(--radius-panel)] bg-surface-1 p-[var(--content-gap)]",v?"border border-border-base":"border border-transparent");return t.jsx.call(void 0,"section",{ref:m,...g,"data-ug":"feature-grid","data-state":"default","data-variant":r[o],"data-size":"md",className:a.cn.call(void 0,"bg-surface-0 px-[var(--content-gap)] py-[var(--section-gap)] sm:px-[calc(var(--content-gap)*1.25)] lg:px-[calc(var(--content-gap)*1.5)]",u),children:t.jsxs.call(void 0,"div",{className:"mx-auto w-full max-w-7xl space-y-[calc(var(--section-gap)*0.8)]",children:[e||s?t.jsxs.call(void 0,"div",{"data-ug-slot":"header",className:"max-w-3xl space-y-[calc(var(--content-gap)*0.5)]",children:[e?t.jsx.call(void 0,"h2",{"data-ug-slot":"title",className:"break-words text-3xl font-bold leading-tight text-text-primary",children:e}):null,s?t.jsx.call(void 0,"p",{"data-ug-slot":"description",className:"text-sm leading-6 text-text-secondary",children:s}):null]}):null,t.jsx.call(void 0,"div",{"data-ug-slot":"grid",className:a.cn.call(void 0,"grid gap-[calc(var(--content-gap)*0.8)] md:grid-cols-2",i[o]),children:c.map((e,i)=>{const r=e.icon,s=n&&Boolean(r)||Boolean(e.meta),c=t.jsxs.call(void 0,t.Fragment,{children:[s?t.jsxs.call(void 0,"div",{className:"flex min-w-0 items-start justify-between gap-[calc(var(--content-gap)*0.6)]",children:[n&&r?t.jsx.call(void 0,"span",{"data-ug-slot":"icon",className:"flex h-[var(--control-height-lg)] w-[var(--control-height-lg)] shrink-0 items-center justify-center rounded-[var(--radius-control)] bg-primary-soft text-primary-soft-fg",children:t.jsx.call(void 0,r,{size:20,"aria-hidden":"true",focusable:"false"})}):null,e.meta?t.jsx.call(void 0,"span",{"data-ug-slot":"meta",className:"shrink-0 text-xs font-medium text-text-tertiary",children:e.meta}):null]}):null,t.jsxs.call(void 0,"div",{"data-ug-slot":"content",className:"min-w-0 flex-1 space-y-[calc(var(--content-gap)*0.4)]",children:[t.jsx.call(void 0,"h3",{"data-ug-slot":"item-title",className:"break-words text-base font-semibold text-text-primary",children:e.title}),t.jsx.call(void 0,"p",{"data-ug-slot":"item-description",className:"text-sm leading-6 text-text-secondary",children:e.description})]}),d&&e.href?t.jsxs.call(void 0,"span",{"data-ug-slot":"item-action",className:"inline-flex items-center gap-[calc(var(--content-gap)*0.25)] text-sm font-medium text-primary",children:[x,t.jsx.call(void 0,l.ArrowRight,{size:14,"aria-hidden":"true",focusable:"false"})]}):null]});return e.href?t.jsx.call(void 0,"a",{href:e.href,"data-ug-slot":"item","data-state":"interactive",className:a.cn.call(void 0,p,"hover:border-primary/35 hover:bg-surface-2 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary focus-visible:ring-offset-2"),children:c},i):t.jsx.call(void 0,"article",{"data-ug-slot":"item","data-state":"static",className:p,children:c},i)})})]})})});function HeroAction({label:e,href:i,icon:r=l.ArrowRight,variant:s="primary",className:c,disabled:o,onClick:n,...d}){return i&&!o?t.jsxs.call(void 0,"a",{href:i,onClick:a=>_optionalChain([n,"optionalCall",e=>e(a)]),className:a.cn.call(void 0,"inline-flex min-h-[var(--control-height-md)] items-center justify-center gap-[calc(var(--content-gap)*0.5)] rounded-[var(--radius-control)] px-[var(--control-padding-x-md)] text-sm font-medium focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring","outline"===s?"border border-border-strong bg-surface-1 text-text-primary hover:bg-surface-2":"bg-primary text-primary-fg hover:bg-primary-hover",c),children:[t.jsx.call(void 0,"span",{"data-ug-slot":"action-label",children:e}),t.jsx.call(void 0,r,{size:16,"aria-hidden":"true",focusable:"false","data-ug-slot":"action-icon"})]}):t.jsxs.call(void 0,a.Button,{variant:s,className:c,disabled:o,onClick:n,...d,children:[t.jsx.call(void 0,"span",{"data-ug-slot":"action-label",children:e}),t.jsx.call(void 0,r,{size:16,"aria-hidden":"true",focusable:"false","data-ug-slot":"action-icon"})]})}s.displayName="FeatureGrid";var c=e.forwardRef.call(void 0,({eyebrow:e,title:l,description:i,media:r,primaryAction:s,secondaryAction:c,stats:o,align:n="start",bordered:d=!0,showStats:x=!0,children:v,className:u,...g},m)=>{const p="center"===n;return t.jsxs.call(void 0,"section",{ref:m,className:a.cn.call(void 0,"relative isolate overflow-hidden bg-surface-0",d&&"border-b border-border-base",u),...g,"data-ug":"landing-hero","data-align":n,"data-state":"default","data-variant":r?"media":"default","data-size":"md",children:[r?t.jsxs.call(void 0,t.Fragment,{children:[t.jsx.call(void 0,"div",{className:"absolute inset-0 -z-20 overflow-hidden","data-ug-slot":"media",children:r}),t.jsx.call(void 0,"div",{className:"absolute inset-0 -z-10 bg-surface-0/78","aria-hidden":"true","data-ug-slot":"overlay"})]}):null,t.jsx.call(void 0,"div",{className:a.cn.call(void 0,"mx-auto flex min-h-[calc(var(--control-height-lg)*10)] w-full max-w-7xl flex-col justify-center px-[var(--content-gap)] py-[calc(var(--content-gap)*4)] sm:px-[calc(var(--content-gap)*1.25)] lg:px-[calc(var(--content-gap)*1.5)]",p&&"items-center text-center"),"data-ug-slot":"container",children:t.jsxs.call(void 0,"div",{className:a.cn.call(void 0,"max-w-4xl space-y-[calc(var(--content-gap)*1.75)]",p&&"flex flex-col items-center"),"data-ug-slot":"content",children:[e?t.jsx.call(void 0,"div",{className:"inline-flex rounded-[var(--radius-control)] border border-primary/25 bg-primary-soft px-[var(--control-padding-x-sm)] py-[calc(var(--content-gap)*0.25)] text-xs font-semibold text-primary-soft-fg","data-ug-slot":"eyebrow",children:e}):null,t.jsxs.call(void 0,"div",{className:"space-y-[var(--content-gap)]",children:[t.jsx.call(void 0,"h1",{className:"max-w-4xl break-words text-4xl font-bold leading-tight text-text-primary sm:text-5xl lg:text-6xl","data-ug-slot":"title",children:l}),i?t.jsx.call(void 0,"p",{className:a.cn.call(void 0,"max-w-2xl text-base leading-7 text-text-secondary sm:text-lg",p&&"mx-auto"),"data-ug-slot":"description",children:i}):null]}),s||c?t.jsxs.call(void 0,"div",{className:a.cn.call(void 0,"flex flex-wrap items-center gap-[calc(var(--content-gap)*0.75)]",p&&"justify-center"),"data-ug-slot":"actions",children:[s?t.jsx.call(void 0,HeroAction,{...s}):null,c?t.jsx.call(void 0,HeroAction,{variant:"outline",...c}):null]}):null,x&&_optionalChain([o,"optionalAccess",a=>a.length])?t.jsx.call(void 0,"dl",{className:"grid max-w-2xl gap-[var(--content-gap)] text-left sm:grid-cols-3","data-ug-slot":"stats",children:o.map((a,e)=>t.jsxs.call(void 0,"div",{className:"border-l border-border-base pl-[var(--content-gap)]","data-ug-slot":"stat",children:[t.jsx.call(void 0,"dt",{className:"text-xs font-medium text-text-tertiary","data-ug-slot":"stat-label",children:a.label}),t.jsx.call(void 0,"dd",{className:"mt-[calc(var(--content-gap)*0.25)] text-2xl font-bold text-text-primary","data-ug-slot":"stat-value",children:a.value})]},e))}):null,v?t.jsx.call(void 0,"div",{className:"min-w-0","data-ug-slot":"footer",children:v}):null]})})]})});c.displayName="LandingHero",exports.FeatureGrid=s,exports.LandingHero=c,exports.UGFeatureGrid=s,exports.UGLandingHero=c;//# sourceMappingURL=index.cjs.map
1
+ "use strict";function _optionalChain(a){let e,l=a[0],t=1;for(;t<a.length;){const i=a[t],r=a[t+1];if(t+=2,("optionalAccess"===i||"optionalCall"===i)&&null==l)return;"access"===i||"optionalAccess"===i?(e=l,l=r(l)):"call"!==i&&"optionalCall"!==i||(l=r((...a)=>l.call(e,...a)),e=void 0)}return l}Object.defineProperty(exports,"__esModule",{value:!0});var a=require("../chunk-RZSNVJZO.cjs"),e=require("react"),l=require("lucide-react"),t=require("react/jsx-runtime"),i={2:"lg:grid-cols-2",3:"lg:grid-cols-3",4:"lg:grid-cols-4"},r={2:"two",3:"three",4:"four"},s=e.forwardRef.call(void 0,({title:e,description:s,features:c,columns:o=3,showIcon:n=!0,showAction:d=!0,actionLabel:x="查看详情",bordered:v=!0,className:u,...g},m)=>{const p=a.cn.call(void 0,"flex min-w-0 flex-col gap-[var(--content-gap)] rounded-[var(--radius-panel)] bg-surface-1 p-[var(--content-gap)]",v?"border border-border-base":"border border-transparent");return t.jsx.call(void 0,"section",{ref:m,...g,"data-ug":"feature-grid","data-state":"default","data-variant":r[o],"data-size":"md",className:a.cn.call(void 0,"bg-surface-0 px-[var(--content-gap)] py-[var(--section-gap)] sm:px-[calc(var(--content-gap)*1.25)] lg:px-[calc(var(--content-gap)*1.5)]",u),children:t.jsxs.call(void 0,"div",{className:"mx-auto w-full max-w-7xl space-y-[calc(var(--section-gap)*0.8)]",children:[e||s?t.jsxs.call(void 0,"div",{"data-ug-slot":"header",className:"max-w-3xl space-y-[calc(var(--content-gap)*0.5)]",children:[e?t.jsx.call(void 0,"h2",{"data-ug-slot":"title",className:"break-words text-3xl font-bold leading-tight text-text-primary",children:e}):null,s?t.jsx.call(void 0,"p",{"data-ug-slot":"description",className:"text-sm leading-6 text-text-secondary",children:s}):null]}):null,t.jsx.call(void 0,"div",{"data-ug-slot":"grid",className:a.cn.call(void 0,"grid gap-[calc(var(--content-gap)*0.8)] md:grid-cols-2",i[o]),children:c.map((e,i)=>{const r=e.icon,s=n&&Boolean(r)||Boolean(e.meta),c=t.jsxs.call(void 0,t.Fragment,{children:[s?t.jsxs.call(void 0,"div",{className:"flex min-w-0 items-start justify-between gap-[calc(var(--content-gap)*0.6)]",children:[n&&r?t.jsx.call(void 0,"span",{"data-ug-slot":"icon",className:"flex h-[var(--control-height-lg)] w-[var(--control-height-lg)] shrink-0 items-center justify-center rounded-[var(--radius-control)] bg-primary-soft text-primary-soft-fg",children:t.jsx.call(void 0,r,{size:20,"aria-hidden":"true",focusable:"false"})}):null,e.meta?t.jsx.call(void 0,"span",{"data-ug-slot":"meta",className:"shrink-0 text-xs font-medium text-text-tertiary",children:e.meta}):null]}):null,t.jsxs.call(void 0,"div",{"data-ug-slot":"content",className:"min-w-0 flex-1 space-y-[calc(var(--content-gap)*0.4)]",children:[t.jsx.call(void 0,"h3",{"data-ug-slot":"item-title",className:"break-words text-base font-semibold text-text-primary",children:e.title}),t.jsx.call(void 0,"p",{"data-ug-slot":"item-description",className:"text-sm leading-6 text-text-secondary",children:e.description})]}),d&&e.href?t.jsxs.call(void 0,"span",{"data-ug-slot":"item-action",className:"inline-flex items-center gap-[calc(var(--content-gap)*0.25)] text-sm font-medium text-primary",children:[x,t.jsx.call(void 0,l.ArrowRight,{size:14,"aria-hidden":"true",focusable:"false"})]}):null]});return e.href?t.jsx.call(void 0,"a",{href:e.href,"data-ug-slot":"item","data-state":"interactive",className:a.cn.call(void 0,p,"hover:border-primary/35 hover:bg-surface-2 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary focus-visible:ring-offset-2"),children:c},i):t.jsx.call(void 0,"article",{"data-ug-slot":"item","data-state":"static",className:p,children:c},i)})})]})})});function HeroAction({label:e,href:i,icon:r=l.ArrowRight,variant:s="primary",className:c,disabled:o,onClick:n,...d}){return i&&!o?t.jsxs.call(void 0,"a",{href:i,onClick:a=>_optionalChain([n,"optionalCall",e=>e(a)]),className:a.cn.call(void 0,"inline-flex min-h-[var(--control-height-md)] items-center justify-center gap-[calc(var(--content-gap)*0.5)] rounded-[var(--radius-control)] px-[var(--control-padding-x-md)] text-sm font-medium focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring","outline"===s?"border border-border-strong bg-surface-1 text-text-primary hover:bg-surface-2":"bg-primary text-primary-fg hover:bg-primary-hover",c),children:[t.jsx.call(void 0,"span",{"data-ug-slot":"action-label",children:e}),t.jsx.call(void 0,r,{size:16,"aria-hidden":"true",focusable:"false","data-ug-slot":"action-icon"})]}):t.jsxs.call(void 0,a.Button,{variant:s,className:c,disabled:o,onClick:n,...d,children:[t.jsx.call(void 0,"span",{"data-ug-slot":"action-label",children:e}),t.jsx.call(void 0,r,{size:16,"aria-hidden":"true",focusable:"false","data-ug-slot":"action-icon"})]})}s.displayName="FeatureGrid";var c=e.forwardRef.call(void 0,({eyebrow:e,title:l,description:i,media:r,primaryAction:s,secondaryAction:c,stats:o,align:n="start",bordered:d=!0,showStats:x=!0,children:v,className:u,...g},m)=>{const p="center"===n;return t.jsxs.call(void 0,"section",{ref:m,className:a.cn.call(void 0,"relative isolate overflow-hidden bg-surface-0",d&&"border-b border-border-base",u),...g,"data-ug":"landing-hero","data-align":n,"data-state":"default","data-variant":r?"media":"default","data-size":"md",children:[r?t.jsxs.call(void 0,t.Fragment,{children:[t.jsx.call(void 0,"div",{className:"absolute inset-0 -z-20 overflow-hidden","data-ug-slot":"media",children:r}),t.jsx.call(void 0,"div",{className:"absolute inset-0 -z-10 bg-surface-0/78","aria-hidden":"true","data-ug-slot":"overlay"})]}):null,t.jsx.call(void 0,"div",{className:a.cn.call(void 0,"mx-auto flex min-h-[calc(var(--control-height-lg)*10)] w-full max-w-7xl flex-col justify-center px-[var(--content-gap)] py-[calc(var(--content-gap)*4)] sm:px-[calc(var(--content-gap)*1.25)] lg:px-[calc(var(--content-gap)*1.5)]",p&&"items-center text-center"),"data-ug-slot":"container",children:t.jsxs.call(void 0,"div",{className:a.cn.call(void 0,"max-w-4xl space-y-[calc(var(--content-gap)*1.75)]",p&&"flex flex-col items-center"),"data-ug-slot":"content",children:[e?t.jsx.call(void 0,"div",{className:"inline-flex rounded-[var(--radius-control)] border border-primary/25 bg-primary-soft px-[var(--control-padding-x-sm)] py-[calc(var(--content-gap)*0.25)] text-xs font-semibold text-primary-soft-fg","data-ug-slot":"eyebrow",children:e}):null,t.jsxs.call(void 0,"div",{className:"space-y-[var(--content-gap)]",children:[t.jsx.call(void 0,"h1",{className:"max-w-4xl break-words text-4xl font-bold leading-tight text-text-primary sm:text-5xl lg:text-6xl","data-ug-slot":"title",children:l}),i?t.jsx.call(void 0,"p",{className:a.cn.call(void 0,"max-w-2xl text-base leading-7 text-text-secondary sm:text-lg",p&&"mx-auto"),"data-ug-slot":"description",children:i}):null]}),s||c?t.jsxs.call(void 0,"div",{className:a.cn.call(void 0,"flex flex-wrap items-center gap-[calc(var(--content-gap)*0.75)]",p&&"justify-center"),"data-ug-slot":"actions",children:[s?t.jsx.call(void 0,HeroAction,{...s}):null,c?t.jsx.call(void 0,HeroAction,{variant:"outline",...c}):null]}):null,x&&_optionalChain([o,"optionalAccess",a=>a.length])?t.jsx.call(void 0,"dl",{className:"grid max-w-2xl gap-[var(--content-gap)] text-left sm:grid-cols-3","data-ug-slot":"stats",children:o.map((a,e)=>t.jsxs.call(void 0,"div",{className:"border-l border-border-base pl-[var(--content-gap)]","data-ug-slot":"stat",children:[t.jsx.call(void 0,"dt",{className:"text-xs font-medium text-text-tertiary","data-ug-slot":"stat-label",children:a.label}),t.jsx.call(void 0,"dd",{className:"mt-[calc(var(--content-gap)*0.25)] text-2xl font-bold text-text-primary","data-ug-slot":"stat-value",children:a.value})]},e))}):null,v?t.jsx.call(void 0,"div",{className:"min-w-0","data-ug-slot":"footer",children:v}):null]})})]})});c.displayName="LandingHero",exports.FeatureGrid=s,exports.LandingHero=c,exports.UGFeatureGrid=s,exports.UGLandingHero=c;//# sourceMappingURL=index.cjs.map