react-kui 3.1.2 → 3.2.1

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 (398) hide show
  1. package/README.zh-CN.md +3 -1
  2. package/ai/kui-components.json +918 -324
  3. package/es/_virtual/_rolldown/runtime.js +1 -1
  4. package/es/affix/index.js +1 -1
  5. package/es/alert/index.js +11 -4
  6. package/es/anchor/anchor-context.js +1 -1
  7. package/es/anchor/anchor-link.js +1 -1
  8. package/es/anchor/anchor.js +1 -1
  9. package/es/auto-complete/index.js +371 -347
  10. package/es/avatar/avatar-group-context.js +1 -1
  11. package/es/avatar/avatar-group.js +1 -1
  12. package/es/avatar/avatar.js +1 -1
  13. package/es/back-top/index.js +1 -1
  14. package/es/badge/index.js +10 -8
  15. package/es/base/teleport.js +1 -1
  16. package/es/base/transition-props.js +1 -1
  17. package/es/base/transition.js +1 -1
  18. package/es/breadcrumb/breadcrumb-context.js +1 -1
  19. package/es/breadcrumb/breadcrumb-item.js +1 -1
  20. package/es/breadcrumb/breadcrumb.js +1 -1
  21. package/es/button/button-group-context.js +1 -1
  22. package/es/button/button-group.js +1 -1
  23. package/es/button/button.js +13 -6
  24. package/es/calendar/index.js +20 -6
  25. package/es/card/index.js +11 -4
  26. package/es/carousel/carousel-context.js +1 -1
  27. package/es/carousel/carousel-item.js +1 -1
  28. package/es/carousel/carousel.js +1 -1
  29. package/es/carousel/drag.js +1 -1
  30. package/es/cascader/index.js +13 -10
  31. package/es/check-card/check-card-group.js +3 -3
  32. package/es/check-card/check-card.js +155 -141
  33. package/es/check-card/context.js +1 -1
  34. package/es/checkbox/checkbox-group-context.js +1 -1
  35. package/es/checkbox/checkbox-group.js +3 -3
  36. package/es/checkbox/checkbox.js +64 -244
  37. package/es/checkbox/index.js +1 -1
  38. package/es/collapse/collapse-panel.js +1 -1
  39. package/es/collapse/collapse.js +96 -82
  40. package/es/color-picker/alpha.js +1 -1
  41. package/es/color-picker/hue.js +1 -1
  42. package/es/color-picker/index.js +7 -7
  43. package/es/color-picker/mode.js +2 -2
  44. package/es/color-picker/paint.js +1 -1
  45. package/es/color-picker/presets.js +1 -1
  46. package/es/components.js +4 -4
  47. package/es/config/config-context.js +16 -3
  48. package/es/config/context.js +29 -2
  49. package/es/config/index.js +31 -12
  50. package/es/config/popup-host.js +106 -0
  51. package/es/config/size-context.js +1 -1
  52. package/es/config/use-config-appearance.js +62 -2
  53. package/es/const/var.js +6 -2
  54. package/es/date-picker/index.js +404 -885
  55. package/es/descriptions/descriptions-item.js +1 -1
  56. package/es/descriptions/descriptions.js +1 -1
  57. package/es/divider/index.js +1 -1
  58. package/es/drawer/index.js +328 -240
  59. package/es/dropdown/dropdown-button.js +69 -51
  60. package/es/dropdown/dropdown-context.js +1 -1
  61. package/es/dropdown/dropdown.js +137 -93
  62. package/es/dropdown/trigger.js +85 -33
  63. package/es/empty/index.js +3 -4
  64. package/es/feature-card/index.js +15 -4
  65. package/es/feedback-panel/index.js +95 -81
  66. package/es/flame-wrap/index.js +116 -109
  67. package/es/flame-wrap/types.js +54 -6
  68. package/es/flex/index.js +1 -1
  69. package/es/form/field-context.js +16 -2
  70. package/es/form/form-context.js +1 -1
  71. package/es/form/form-item.js +7 -6
  72. package/es/form/form.js +1 -1
  73. package/es/form/utils.js +1 -1
  74. package/es/grid/grid-item.js +1 -1
  75. package/es/grid/grid.js +1 -1
  76. package/es/grid/useBreakpoint.js +1 -1
  77. package/es/icon/index.js +1 -1
  78. package/es/image/group.js +1 -1
  79. package/es/image/image-group-context.js +1 -1
  80. package/es/image/image.js +137 -123
  81. package/es/image/instance.js +1 -1
  82. package/es/image/preview.js +1 -1
  83. package/es/image/utils.js +1 -1
  84. package/es/index.js +3 -3
  85. package/es/input/index.js +3 -3
  86. package/es/input/input-base.js +7 -7
  87. package/es/input/input-box.js +2 -2
  88. package/es/input/input-group.js +43 -127
  89. package/es/input/input.js +1 -1
  90. package/es/input/textarea.js +28 -114
  91. package/es/input-number/index.js +7 -5
  92. package/es/input-otp/index.js +5 -5
  93. package/es/input-tag/index.js +5 -5
  94. package/es/kanban/index.js +79 -63
  95. package/es/layout/index.js +1 -1
  96. package/es/layout/layout-context.js +1 -1
  97. package/es/list-panel/index.js +96 -83
  98. package/es/loading/index.js +1 -1
  99. package/es/loading/loading-bar.js +1 -1
  100. package/es/locale/de.js +10 -2
  101. package/es/locale/el.js +10 -2
  102. package/es/locale/en.js +10 -2
  103. package/es/locale/fr.js +10 -2
  104. package/es/locale/it.js +10 -2
  105. package/es/locale/ja.js +10 -2
  106. package/es/locale/ko.js +10 -2
  107. package/es/locale/ru.js +10 -2
  108. package/es/locale/th.js +10 -2
  109. package/es/locale/uk.js +10 -2
  110. package/es/locale/vi.js +10 -2
  111. package/es/locale/zh-CN.js +10 -2
  112. package/es/locale/zh-TW.js +10 -2
  113. package/es/mentions/index.js +291 -286
  114. package/es/menu/menu-context.js +1 -1
  115. package/es/menu/menu-divider.js +1 -1
  116. package/es/menu/menu-group.js +1 -1
  117. package/es/menu/menu-item.js +1 -1
  118. package/es/menu/menu-keyboard.js +41 -2
  119. package/es/menu/menu.js +268 -222
  120. package/es/menu/recursive-menu.js +1 -1
  121. package/es/menu/sub-menu.js +81 -23
  122. package/es/message/index.js +1 -1
  123. package/es/modal/api.js +46 -12
  124. package/es/modal/modal.js +441 -345
  125. package/es/modal/toast.js +177 -64
  126. package/es/node_modules/.pnpm/kui-icons@5.0.0/node_modules/kui-icons/dist/kui-icons.esm.js +1 -1
  127. package/es/notice/container.js +1 -1
  128. package/es/notice/content.js +1 -1
  129. package/es/notice/index.js +1 -1
  130. package/es/notice/instance.js +1 -1
  131. package/es/page/index.js +13 -8
  132. package/es/page/responsive.js +1 -1
  133. package/es/page-header/index.js +1 -1
  134. package/es/popconfirm/index.js +36 -35
  135. package/es/poptip/index.js +47 -45
  136. package/es/popup/index.js +5 -2
  137. package/es/popup/layers.js +11 -2
  138. package/es/progress/index.js +1 -1
  139. package/es/qrcode/index.js +13 -7
  140. package/es/radio/radio-button.js +51 -44
  141. package/es/radio/radio-group-context.js +1 -1
  142. package/es/radio/radio-group.js +49 -52
  143. package/es/radio/radio.js +46 -197
  144. package/es/rate/index.js +1 -1
  145. package/es/rate/star.js +1 -1
  146. package/es/result/index.js +1 -1
  147. package/es/ripple/index.js +104 -97
  148. package/es/ripple/types.js +71 -18
  149. package/es/row-col/col.js +1 -1
  150. package/es/row-col/row.js +1 -1
  151. package/es/segmented/index.js +112 -92
  152. package/es/select/option.js +1 -1
  153. package/es/select/select.js +29 -29
  154. package/es/skeleton/skeleton-avatar.js +1 -1
  155. package/es/skeleton/skeleton-button.js +1 -1
  156. package/es/skeleton/skeleton-image.js +1 -1
  157. package/es/skeleton/skeleton-text.js +1 -1
  158. package/es/skeleton/skeleton.js +1 -1
  159. package/es/skeleton/use-skeleton-loading.js +1 -1
  160. package/es/slider/index.js +1 -1
  161. package/es/slider/thumb.js +1 -1
  162. package/es/space/index.js +1 -1
  163. package/es/spin/index.js +1 -1
  164. package/es/splitter/splitter-panel.js +1 -1
  165. package/es/splitter/splitter.js +1 -1
  166. package/es/stat-card/countup.js +2 -2
  167. package/es/stat-card/rollup.js +1 -1
  168. package/es/stat-card/stat-card.js +16 -7
  169. package/es/stat-card/stat-number.js +4 -3
  170. package/es/stat-card/utils/countup.js +1 -1
  171. package/es/stat-card/utils/odometer.js +1 -1
  172. package/es/stat-card/utils/stat-item-key.js +22 -0
  173. package/es/steps/index.js +1 -1
  174. package/es/switch/index.js +3 -3
  175. package/es/table/column-setting.js +104 -115
  176. package/es/table/index.js +556 -207
  177. package/es/table/utils.js +140 -3
  178. package/es/tabs/tab-panel.js +1 -1
  179. package/es/tabs/tabs.js +1 -1
  180. package/es/tag/index.js +12 -5
  181. package/es/time-line/timeline-item.js +1 -1
  182. package/es/time-line/timeline.js +1 -1
  183. package/es/tooltip/index.js +114 -94
  184. package/es/tour/index.js +1 -1
  185. package/es/transfer/index.js +190 -172
  186. package/es/tree/index.js +55 -44
  187. package/es/tree/utils.js +1 -1
  188. package/es/tree-select/index.js +259 -781
  189. package/es/typography/index.js +1 -1
  190. package/es/upload/file-list.js +1 -1
  191. package/es/upload/index.js +5 -6
  192. package/es/upload/picture-sort.js +1 -1
  193. package/es/upload/selector.js +1 -1
  194. package/es/utils/checked.js +1 -1
  195. package/es/utils/color.js +25 -2
  196. package/es/utils/css.js +19 -0
  197. package/es/utils/focus.js +63 -0
  198. package/es/utils/number.js +1 -1
  199. package/es/utils/overlay-order.js +18 -0
  200. package/es/utils/overlay-stack.js +33 -0
  201. package/es/utils/placement.js +1 -1
  202. package/es/utils/popup.js +1 -1
  203. package/es/utils/promise.js +18 -0
  204. package/es/utils/react-node.js +55 -30
  205. package/es/utils/selection-tags.js +6 -4
  206. package/es/utils/share.js +5 -2
  207. package/es/utils/theme.js +1 -1
  208. package/es/utils/transition.js +1 -1
  209. package/es/utils/use-value.js +1 -1
  210. package/es/virtual-list/index.js +1 -1
  211. package/es/virtual-list/range.js +3 -2
  212. package/es/watermark/index.js +1 -1
  213. package/lib/index.cjs +2 -2
  214. package/lib/locale/de.cjs +2 -2
  215. package/lib/locale/el.cjs +2 -2
  216. package/lib/locale/en.cjs +2 -2
  217. package/lib/locale/fr.cjs +2 -2
  218. package/lib/locale/it.cjs +2 -2
  219. package/lib/locale/ja.cjs +2 -2
  220. package/lib/locale/ko.cjs +2 -2
  221. package/lib/locale/ru.cjs +2 -2
  222. package/lib/locale/th.cjs +2 -2
  223. package/lib/locale/uk.cjs +2 -2
  224. package/lib/locale/vi.cjs +2 -2
  225. package/lib/locale/zh-CN.cjs +2 -2
  226. package/lib/locale/zh-TW.cjs +2 -2
  227. package/package.json +4 -3
  228. package/readme.md +3 -1
  229. package/style/base.css +2 -2
  230. package/style/components.css +2 -2
  231. package/style/index.css +2 -2
  232. package/style/theme.css +2 -2
  233. package/types/alert/index.d.cts +2 -2
  234. package/types/alert/index.d.ts +2 -2
  235. package/types/auto-complete/index.d.cts +7 -1
  236. package/types/auto-complete/index.d.ts +7 -1
  237. package/types/badge/index.d.cts +2 -1
  238. package/types/badge/index.d.ts +2 -1
  239. package/types/button/button.d.cts +2 -2
  240. package/types/button/button.d.ts +2 -2
  241. package/types/card/index.d.cts +3 -3
  242. package/types/card/index.d.ts +3 -3
  243. package/types/cascader/index.d.cts +1 -1
  244. package/types/cascader/index.d.ts +1 -1
  245. package/types/cascader/types.d.cts +2 -0
  246. package/types/cascader/types.d.ts +2 -0
  247. package/types/check-card/context.d.cts +4 -3
  248. package/types/check-card/context.d.ts +4 -3
  249. package/types/check-card/index.d.cts +1 -1
  250. package/types/check-card/index.d.ts +1 -1
  251. package/types/check-card/types.d.cts +3 -4
  252. package/types/check-card/types.d.ts +3 -4
  253. package/types/checkbox/checkbox-group.d.cts +2 -2
  254. package/types/checkbox/checkbox-group.d.ts +2 -2
  255. package/types/checkbox/checkbox.d.cts +2 -2
  256. package/types/checkbox/checkbox.d.ts +2 -2
  257. package/types/collapse/collapse.d.cts +3 -3
  258. package/types/collapse/collapse.d.ts +3 -3
  259. package/types/color-picker/index.d.cts +3 -1
  260. package/types/color-picker/index.d.ts +3 -1
  261. package/types/components.d.cts +2 -2
  262. package/types/components.d.ts +2 -2
  263. package/types/config/config-context.d.cts +15 -2
  264. package/types/config/config-context.d.ts +15 -2
  265. package/types/config/context.d.cts +6 -0
  266. package/types/config/context.d.ts +6 -0
  267. package/types/config/popup-host.d.cts +16 -0
  268. package/types/config/popup-host.d.ts +16 -0
  269. package/types/config/use-config-appearance.d.cts +41 -2
  270. package/types/config/use-config-appearance.d.ts +41 -2
  271. package/types/const/types.d.cts +30 -1
  272. package/types/const/types.d.ts +30 -1
  273. package/types/const/var.d.cts +6 -1
  274. package/types/const/var.d.ts +6 -1
  275. package/types/date-picker/index.d.cts +3 -1
  276. package/types/date-picker/index.d.ts +3 -1
  277. package/types/descriptions/descriptions.d.cts +2 -2
  278. package/types/descriptions/descriptions.d.ts +2 -2
  279. package/types/drawer/index.d.cts +1 -0
  280. package/types/drawer/index.d.ts +1 -0
  281. package/types/dropdown/dropdown-button.d.cts +5 -2
  282. package/types/dropdown/dropdown-button.d.ts +5 -2
  283. package/types/dropdown/dropdown-context.d.cts +6 -0
  284. package/types/dropdown/dropdown-context.d.ts +6 -0
  285. package/types/dropdown/dropdown.d.cts +2 -0
  286. package/types/dropdown/dropdown.d.ts +2 -0
  287. package/types/feature-card/index.d.cts +3 -3
  288. package/types/feature-card/index.d.ts +3 -3
  289. package/types/feedback-panel/index.d.cts +3 -3
  290. package/types/feedback-panel/index.d.ts +3 -3
  291. package/types/flame-wrap/types.d.cts +18 -0
  292. package/types/flame-wrap/types.d.ts +18 -0
  293. package/types/form/field-context.d.cts +2 -0
  294. package/types/form/field-context.d.ts +2 -0
  295. package/types/image/image.d.cts +2 -2
  296. package/types/image/image.d.ts +2 -2
  297. package/types/input/input-group.d.cts +2 -2
  298. package/types/input/input-group.d.ts +2 -2
  299. package/types/input-number/index.d.cts +2 -0
  300. package/types/input-number/index.d.ts +2 -0
  301. package/types/kanban/index.d.cts +3 -2
  302. package/types/kanban/index.d.ts +3 -2
  303. package/types/list-panel/index.d.cts +3 -3
  304. package/types/list-panel/index.d.ts +3 -3
  305. package/types/locale/de.d.cts +6 -0
  306. package/types/locale/de.d.ts +6 -0
  307. package/types/locale/el.d.cts +6 -0
  308. package/types/locale/el.d.ts +6 -0
  309. package/types/locale/en.d.cts +6 -0
  310. package/types/locale/en.d.ts +6 -0
  311. package/types/locale/fr.d.cts +6 -0
  312. package/types/locale/fr.d.ts +6 -0
  313. package/types/locale/it.d.cts +6 -0
  314. package/types/locale/it.d.ts +6 -0
  315. package/types/locale/ja.d.cts +6 -0
  316. package/types/locale/ja.d.ts +6 -0
  317. package/types/locale/ko.d.cts +6 -0
  318. package/types/locale/ko.d.ts +6 -0
  319. package/types/locale/ru.d.cts +6 -0
  320. package/types/locale/ru.d.ts +6 -0
  321. package/types/locale/th.d.cts +6 -0
  322. package/types/locale/th.d.ts +6 -0
  323. package/types/locale/uk.d.cts +6 -0
  324. package/types/locale/uk.d.ts +6 -0
  325. package/types/locale/vi.d.cts +6 -0
  326. package/types/locale/vi.d.ts +6 -0
  327. package/types/locale/zh-CN.d.cts +6 -0
  328. package/types/locale/zh-CN.d.ts +6 -0
  329. package/types/locale/zh-TW.d.cts +6 -0
  330. package/types/locale/zh-TW.d.ts +6 -0
  331. package/types/mentions/index.d.cts +2 -0
  332. package/types/mentions/index.d.ts +2 -0
  333. package/types/menu/menu-keyboard.d.cts +23 -0
  334. package/types/menu/menu-keyboard.d.ts +23 -0
  335. package/types/modal/api.d.cts +6 -1
  336. package/types/modal/api.d.ts +6 -1
  337. package/types/modal/modal.d.cts +1 -0
  338. package/types/modal/modal.d.ts +1 -0
  339. package/types/modal/toast.d.cts +8 -2
  340. package/types/modal/toast.d.ts +8 -2
  341. package/types/page/index.d.cts +2 -2
  342. package/types/page/index.d.ts +2 -2
  343. package/types/popconfirm/index.d.cts +2 -0
  344. package/types/popconfirm/index.d.ts +2 -0
  345. package/types/poptip/index.d.cts +2 -0
  346. package/types/poptip/index.d.ts +2 -0
  347. package/types/popup/layers.d.cts +2 -0
  348. package/types/popup/layers.d.ts +2 -0
  349. package/types/qrcode/index.d.cts +2 -2
  350. package/types/qrcode/index.d.ts +2 -2
  351. package/types/radio/radio-button.d.cts +2 -2
  352. package/types/radio/radio-button.d.ts +2 -2
  353. package/types/radio/radio-group.d.cts +2 -2
  354. package/types/radio/radio-group.d.ts +2 -2
  355. package/types/radio/radio.d.cts +2 -2
  356. package/types/radio/radio.d.ts +2 -2
  357. package/types/ripple/types.d.cts +18 -0
  358. package/types/ripple/types.d.ts +18 -0
  359. package/types/segmented/index.d.cts +2 -1
  360. package/types/segmented/index.d.ts +2 -1
  361. package/types/select/select.d.cts +2 -0
  362. package/types/select/select.d.ts +2 -0
  363. package/types/stat-card/stat-card.d.cts +3 -3
  364. package/types/stat-card/stat-card.d.ts +3 -3
  365. package/types/stat-card/utils/stat-item-key.d.cts +11 -0
  366. package/types/stat-card/utils/stat-item-key.d.ts +11 -0
  367. package/types/table/column-setting.d.cts +4 -4
  368. package/types/table/column-setting.d.ts +4 -4
  369. package/types/table/index.d.cts +2 -2
  370. package/types/table/index.d.ts +2 -2
  371. package/types/table/types.d.cts +21 -2
  372. package/types/table/types.d.ts +21 -2
  373. package/types/table/utils.d.cts +75 -0
  374. package/types/table/utils.d.ts +75 -0
  375. package/types/tag/index.d.cts +2 -2
  376. package/types/tag/index.d.ts +2 -2
  377. package/types/tooltip/index.d.cts +2 -0
  378. package/types/tooltip/index.d.ts +2 -0
  379. package/types/transfer/index.d.cts +3 -2
  380. package/types/transfer/index.d.ts +3 -2
  381. package/types/tree-select/index.d.cts +3 -1
  382. package/types/tree-select/index.d.ts +3 -1
  383. package/types/utils/checked.d.cts +1 -1
  384. package/types/utils/checked.d.ts +1 -1
  385. package/types/utils/color.d.cts +13 -0
  386. package/types/utils/color.d.ts +13 -0
  387. package/types/utils/css.d.cts +2 -0
  388. package/types/utils/css.d.ts +2 -0
  389. package/types/utils/focus.d.cts +5 -0
  390. package/types/utils/focus.d.ts +5 -0
  391. package/types/utils/overlay-order.d.cts +6 -0
  392. package/types/utils/overlay-order.d.ts +6 -0
  393. package/types/utils/overlay-stack.d.cts +13 -0
  394. package/types/utils/overlay-stack.d.ts +13 -0
  395. package/types/utils/promise.d.cts +5 -0
  396. package/types/utils/promise.d.ts +5 -0
  397. package/types/utils/react-node.d.cts +10 -0
  398. package/types/utils/react-node.d.ts +10 -0
@@ -1,5 +1,5 @@
1
1
  import { default as React } from 'react';
2
- import { ShapeType, SizeType, ThemeType } from '../const/types.cjs';
2
+ import { ShapeType, SizeType, SurfaceThemeType } from '../const/types.cjs';
3
3
  export interface PageProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue" | "defaultChecked"> {
4
4
  simple?: boolean;
5
5
  responsive?: boolean;
@@ -7,7 +7,7 @@ export interface PageProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "o
7
7
  showSizer?: boolean;
8
8
  showTotal?: boolean;
9
9
  showElevator?: boolean;
10
- theme?: ThemeType;
10
+ theme?: SurfaceThemeType;
11
11
  shape?: ShapeType;
12
12
  sizeData?: number[];
13
13
  size?: SizeType;
@@ -1,5 +1,5 @@
1
1
  import { default as React } from 'react';
2
- import { ShapeType, SizeType, ThemeType } from '../const/types.js';
2
+ import { ShapeType, SizeType, SurfaceThemeType } from '../const/types.js';
3
3
  export interface PageProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue" | "defaultChecked"> {
4
4
  simple?: boolean;
5
5
  responsive?: boolean;
@@ -7,7 +7,7 @@ export interface PageProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "o
7
7
  showSizer?: boolean;
8
8
  showTotal?: boolean;
9
9
  showElevator?: boolean;
10
- theme?: ThemeType;
10
+ theme?: SurfaceThemeType;
11
11
  shape?: ShapeType;
12
12
  sizeData?: number[];
13
13
  size?: SizeType;
@@ -10,6 +10,8 @@ export interface PopconfirmProps {
10
10
  okText?: string;
11
11
  cancelText?: string;
12
12
  placement?: PlacementsType;
13
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
14
+ destroyOnClose?: boolean;
13
15
  /** 只渲染浮层本身,不包含触发元素、定位与动画,与 kui-vue 一致 */
14
16
  panelOnly?: boolean;
15
17
  onCancel?: () => void;
@@ -10,6 +10,8 @@ export interface PopconfirmProps {
10
10
  okText?: string;
11
11
  cancelText?: string;
12
12
  placement?: PlacementsType;
13
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
14
+ destroyOnClose?: boolean;
13
15
  /** 只渲染浮层本身,不包含触发元素、定位与动画,与 kui-vue 一致 */
14
16
  panelOnly?: boolean;
15
17
  onCancel?: () => void;
@@ -10,6 +10,8 @@ export interface PoptipProps {
10
10
  width?: number | string;
11
11
  trigger?: "click" | "hover" | "focus";
12
12
  placement?: PlacementsType;
13
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
14
+ destroyOnClose?: boolean;
13
15
  /** 只渲染浮层本身,不包含触发元素、定位与动画,与 kui-vue 一致 */
14
16
  panelOnly?: boolean;
15
17
  onClose?: () => void;
@@ -10,6 +10,8 @@ export interface PoptipProps {
10
10
  width?: number | string;
11
11
  trigger?: "click" | "hover" | "focus";
12
12
  placement?: PlacementsType;
13
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
14
+ destroyOnClose?: boolean;
13
15
  /** 只渲染浮层本身,不包含触发元素、定位与动画,与 kui-vue 一致 */
14
16
  panelOnly?: boolean;
15
17
  onClose?: () => void;
@@ -4,6 +4,8 @@ export interface PopupLayer {
4
4
  close: () => void;
5
5
  }
6
6
  export declare function registerPopupLayer(layer: PopupLayer): () => void;
7
+ /** 还开着的弹层里最晚打开那位的顺序号;一个都没有则 0。遮罩层用它判断自己有没有被弹层压住。 */
8
+ export declare function latestPopupLayerOrder(): number;
7
9
  export declare function isTopPopupLayer(layer: PopupLayer): boolean;
8
10
  export declare function popupLayerElements(layer: PopupLayer): HTMLElement[];
9
11
  export declare function closePopupChildren(popup: HTMLElement): void;
@@ -4,6 +4,8 @@ export interface PopupLayer {
4
4
  close: () => void;
5
5
  }
6
6
  export declare function registerPopupLayer(layer: PopupLayer): () => void;
7
+ /** 还开着的弹层里最晚打开那位的顺序号;一个都没有则 0。遮罩层用它判断自己有没有被弹层压住。 */
8
+ export declare function latestPopupLayerOrder(): number;
7
9
  export declare function isTopPopupLayer(layer: PopupLayer): boolean;
8
10
  export declare function popupLayerElements(layer: PopupLayer): HTMLElement[];
9
11
  export declare function closePopupChildren(popup: HTMLElement): void;
@@ -1,5 +1,5 @@
1
1
  import { HTMLAttributes, ReactNode } from 'react';
2
- import { QRCodeErrorLevel, QRCodeStatus, ShapeType, ThemeType } from '../const/types.cjs';
2
+ import { QRCodeErrorLevel, QRCodeStatus, ShapeType, SurfaceThemeType } from '../const/types.cjs';
3
3
  export interface QRCodeRef {
4
4
  download: (fileName?: string) => Promise<void>;
5
5
  }
@@ -10,7 +10,7 @@ export interface QRCodeProps extends Omit<HTMLAttributes<HTMLDivElement>, "child
10
10
  colorLight?: string;
11
11
  bordered?: boolean;
12
12
  shape?: ShapeType;
13
- theme?: ThemeType;
13
+ theme?: SurfaceThemeType;
14
14
  status?: QRCodeStatus;
15
15
  logo?: string;
16
16
  logoSize?: number;
@@ -1,5 +1,5 @@
1
1
  import { HTMLAttributes, ReactNode } from 'react';
2
- import { QRCodeErrorLevel, QRCodeStatus, ShapeType, ThemeType } from '../const/types.js';
2
+ import { QRCodeErrorLevel, QRCodeStatus, ShapeType, SurfaceThemeType } from '../const/types.js';
3
3
  export interface QRCodeRef {
4
4
  download: (fileName?: string) => Promise<void>;
5
5
  }
@@ -10,7 +10,7 @@ export interface QRCodeProps extends Omit<HTMLAttributes<HTMLDivElement>, "child
10
10
  colorLight?: string;
11
11
  bordered?: boolean;
12
12
  shape?: ShapeType;
13
- theme?: ThemeType;
13
+ theme?: SurfaceThemeType;
14
14
  status?: QRCodeStatus;
15
15
  logo?: string;
16
16
  logoSize?: number;
@@ -1,11 +1,11 @@
1
1
  import { default as React } from 'react';
2
- import { ShapeType, SizeType, ThemeType } from '../const/types.cjs';
2
+ import { ShapeType, SizeType, SurfaceThemeType } from '../const/types.cjs';
3
3
  import { IconType } from '../icon/index.cjs';
4
4
  import { ChangeEvent } from './types.cjs';
5
5
  export interface RadioButtonProps extends Omit<React.HTMLAttributes<HTMLButtonElement>, "onChange" | "defaultValue" | "defaultChecked"> {
6
6
  label?: string;
7
7
  value?: string | number;
8
- theme?: ThemeType;
8
+ theme?: SurfaceThemeType;
9
9
  disabled?: boolean;
10
10
  readOnly?: boolean;
11
11
  checked?: boolean;
@@ -1,11 +1,11 @@
1
1
  import { default as React } from 'react';
2
- import { ShapeType, SizeType, ThemeType } from '../const/types.js';
2
+ import { ShapeType, SizeType, SurfaceThemeType } from '../const/types.js';
3
3
  import { IconType } from '../icon/index.js';
4
4
  import { ChangeEvent } from './types.js';
5
5
  export interface RadioButtonProps extends Omit<React.HTMLAttributes<HTMLButtonElement>, "onChange" | "defaultValue" | "defaultChecked"> {
6
6
  label?: string;
7
7
  value?: string | number;
8
- theme?: ThemeType;
8
+ theme?: SurfaceThemeType;
9
9
  disabled?: boolean;
10
10
  readOnly?: boolean;
11
11
  checked?: boolean;
@@ -1,5 +1,5 @@
1
1
  import { default as React } from 'react';
2
- import { DirectionType, RadioType, ShapeType, SizeType, ThemeType } from '../const/types.cjs';
2
+ import { DirectionType, RadioType, ShapeType, SizeType, SurfaceThemeType } from '../const/types.cjs';
3
3
  import { IconType } from '../icon/index.cjs';
4
4
  type RadioValue = string | number | undefined;
5
5
  export interface RadioOption {
@@ -15,7 +15,7 @@ export interface RadioGroupProps<T extends RadioValue = string | number> extends
15
15
  readOnly?: boolean;
16
16
  direction?: DirectionType;
17
17
  size?: SizeType;
18
- theme?: ThemeType;
18
+ theme?: SurfaceThemeType;
19
19
  shape?: ShapeType;
20
20
  options?: RadioOption[];
21
21
  type?: RadioType;
@@ -1,5 +1,5 @@
1
1
  import { default as React } from 'react';
2
- import { DirectionType, RadioType, ShapeType, SizeType, ThemeType } from '../const/types.js';
2
+ import { DirectionType, RadioType, ShapeType, SizeType, SurfaceThemeType } from '../const/types.js';
3
3
  import { IconType } from '../icon/index.js';
4
4
  type RadioValue = string | number | undefined;
5
5
  export interface RadioOption {
@@ -15,7 +15,7 @@ export interface RadioGroupProps<T extends RadioValue = string | number> extends
15
15
  readOnly?: boolean;
16
16
  direction?: DirectionType;
17
17
  size?: SizeType;
18
- theme?: ThemeType;
18
+ theme?: SurfaceThemeType;
19
19
  shape?: ShapeType;
20
20
  options?: RadioOption[];
21
21
  type?: RadioType;
@@ -1,11 +1,11 @@
1
1
  import { default as React } from 'react';
2
- import { SizeType, ThemeType } from '../const/types.cjs';
2
+ import { SizeType, MarkThemeType } from '../const/types.cjs';
3
3
  import { ChangeEvent } from './types.cjs';
4
4
  export interface RadioProps extends Omit<React.HTMLAttributes<HTMLLabelElement>, "onChange" | "defaultValue" | "defaultChecked"> {
5
5
  checked?: boolean;
6
6
  value?: string | number;
7
7
  label?: string;
8
- theme?: ThemeType;
8
+ theme?: MarkThemeType;
9
9
  size?: SizeType;
10
10
  onChange?: (e: ChangeEvent) => void;
11
11
  children?: React.ReactNode;
@@ -1,11 +1,11 @@
1
1
  import { default as React } from 'react';
2
- import { SizeType, ThemeType } from '../const/types.js';
2
+ import { SizeType, MarkThemeType } from '../const/types.js';
3
3
  import { ChangeEvent } from './types.js';
4
4
  export interface RadioProps extends Omit<React.HTMLAttributes<HTMLLabelElement>, "onChange" | "defaultValue" | "defaultChecked"> {
5
5
  checked?: boolean;
6
6
  value?: string | number;
7
7
  label?: string;
8
- theme?: ThemeType;
8
+ theme?: MarkThemeType;
9
9
  size?: SizeType;
10
10
  onChange?: (e: ChangeEvent) => void;
11
11
  children?: React.ReactNode;
@@ -44,5 +44,23 @@ export interface RippleInstance {
44
44
  /** Stop the loop and release all GPU resources. */
45
45
  destroy: () => void;
46
46
  }
47
+ /**
48
+ * Attributes that turn a canvas into an HTML-in-Canvas host, and the matching
49
+ * opt-in for the element that gets drawn.
50
+ */
51
+ export interface HtmlInCanvasMarkup {
52
+ canvas: Record<string, string>;
53
+ element: Record<string, string>;
54
+ }
55
+ /**
56
+ * Chrome 156 renames the experimental boolean `layoutsubtree` to the
57
+ * standardized `content="drawable"`, and the element handed to
58
+ * `drawElementImage()` now declares itself with its own `drawable` attribute
59
+ * (WICG html-in-canvas issue #169). Browsers advertise the new spelling with a
60
+ * reflected `content` IDL attribute, so the shape is read off the prototype
61
+ * rather than sniffed from a version string: every release only ever sees the
62
+ * attribute it understands.
63
+ */
64
+ export declare function htmlInCanvasMarkup(): HtmlInCanvasMarkup;
47
65
  export declare function supportsHtmlInCanvas(): boolean;
48
66
  export declare function createRipple(elements: RippleElements, options?: RippleOptions): RippleInstance | null;
@@ -44,5 +44,23 @@ export interface RippleInstance {
44
44
  /** Stop the loop and release all GPU resources. */
45
45
  destroy: () => void;
46
46
  }
47
+ /**
48
+ * Attributes that turn a canvas into an HTML-in-Canvas host, and the matching
49
+ * opt-in for the element that gets drawn.
50
+ */
51
+ export interface HtmlInCanvasMarkup {
52
+ canvas: Record<string, string>;
53
+ element: Record<string, string>;
54
+ }
55
+ /**
56
+ * Chrome 156 renames the experimental boolean `layoutsubtree` to the
57
+ * standardized `content="drawable"`, and the element handed to
58
+ * `drawElementImage()` now declares itself with its own `drawable` attribute
59
+ * (WICG html-in-canvas issue #169). Browsers advertise the new spelling with a
60
+ * reflected `content` IDL attribute, so the shape is read off the prototype
61
+ * rather than sniffed from a version string: every release only ever sees the
62
+ * attribute it understands.
63
+ */
64
+ export declare function htmlInCanvasMarkup(): HtmlInCanvasMarkup;
47
65
  export declare function supportsHtmlInCanvas(): boolean;
48
66
  export declare function createRipple(elements: RippleElements, options?: RippleOptions): RippleInstance | null;
@@ -9,9 +9,10 @@ export interface SegmentedOption {
9
9
  disabled?: boolean;
10
10
  [key: string]: unknown;
11
11
  }
12
+ export type SegmentedOptionInput = SegmentedValue | SegmentedOption;
12
13
  export interface SegmentedProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange" | "defaultChecked"> {
13
14
  value?: SegmentedValue;
14
- options?: SegmentedOption[];
15
+ options?: SegmentedOptionInput[];
15
16
  disabled?: boolean;
16
17
  readOnly?: boolean;
17
18
  block?: boolean;
@@ -9,9 +9,10 @@ export interface SegmentedOption {
9
9
  disabled?: boolean;
10
10
  [key: string]: unknown;
11
11
  }
12
+ export type SegmentedOptionInput = SegmentedValue | SegmentedOption;
12
13
  export interface SegmentedProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange" | "defaultChecked"> {
13
14
  value?: SegmentedValue;
14
- options?: SegmentedOption[];
15
+ options?: SegmentedOptionInput[];
15
16
  disabled?: boolean;
16
17
  readOnly?: boolean;
17
18
  block?: boolean;
@@ -11,6 +11,8 @@ export interface SelectProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
11
11
  placeholder?: string;
12
12
  size?: SizeType;
13
13
  placement?: DropPlacementsType;
14
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
15
+ destroyOnClose?: boolean;
14
16
  width?: number;
15
17
  maxTagCount?: number;
16
18
  value?: SelectValue;
@@ -11,6 +11,8 @@ export interface SelectProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
11
11
  placeholder?: string;
12
12
  size?: SizeType;
13
13
  placement?: DropPlacementsType;
14
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
15
+ destroyOnClose?: boolean;
14
16
  width?: number;
15
17
  maxTagCount?: number;
16
18
  value?: SelectValue;
@@ -1,5 +1,5 @@
1
1
  import { HTMLAttributes, ReactNode } from 'react';
2
- import { ShapeType, SizeType } from '../const/types.cjs';
2
+ import { SizeType, SurfaceShapeType, SurfaceThemeType } from '../const/types.cjs';
3
3
  export interface StatNumberItem {
4
4
  key?: string | number;
5
5
  value: number;
@@ -22,8 +22,8 @@ export interface StatCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "tit
22
22
  statNumberType?: "rollup" | "countup";
23
23
  reverse?: boolean;
24
24
  bordered?: boolean;
25
- theme?: "fill" | "outline" | "plain";
26
- shape?: ShapeType;
25
+ theme?: SurfaceThemeType;
26
+ shape?: SurfaceShapeType;
27
27
  size?: SizeType;
28
28
  prefix?: ReactNode;
29
29
  suffix?: ReactNode;
@@ -1,5 +1,5 @@
1
1
  import { HTMLAttributes, ReactNode } from 'react';
2
- import { ShapeType, SizeType } from '../const/types.js';
2
+ import { SizeType, SurfaceShapeType, SurfaceThemeType } from '../const/types.js';
3
3
  export interface StatNumberItem {
4
4
  key?: string | number;
5
5
  value: number;
@@ -22,8 +22,8 @@ export interface StatCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "tit
22
22
  statNumberType?: "rollup" | "countup";
23
23
  reverse?: boolean;
24
24
  bordered?: boolean;
25
- theme?: "fill" | "outline" | "plain";
26
- shape?: ShapeType;
25
+ theme?: SurfaceThemeType;
26
+ shape?: SurfaceShapeType;
27
27
  size?: SizeType;
28
28
  prefix?: ReactNode;
29
29
  suffix?: ReactNode;
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Identity of one `items` entry across renders.
3
+ *
4
+ * The `kui-item-` prefix keeps a keyless item's position out of the namespace of
5
+ * caller-supplied keys: without it `[{key: 1}, {}]` hands two different metrics the
6
+ * same key, which lets the diffing move a CountUp instance from one item to the
7
+ * other. This rule and these strings are identical in both builds.
8
+ */
9
+ export declare function statItemKey(item: {
10
+ key?: string | number;
11
+ }, index: number): string;
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Identity of one `items` entry across renders.
3
+ *
4
+ * The `kui-item-` prefix keeps a keyless item's position out of the namespace of
5
+ * caller-supplied keys: without it `[{key: 1}, {}]` hands two different metrics the
6
+ * same key, which lets the diffing move a CountUp instance from one item to the
7
+ * other. This rule and these strings are identical in both builds.
8
+ */
9
+ export declare function statItemKey(item: {
10
+ key?: string | number;
11
+ }, index: number): string;
@@ -4,10 +4,10 @@ import { Column } from './types.cjs';
4
4
  export interface TableColumnSettingProps<T = Record<string, unknown>> {
5
5
  /** 所有列定义 */
6
6
  columns?: Column<T>[];
7
- /** 当前隐藏的列 key 集合 */
8
- hiddenColumnKeys?: (string | number)[];
7
+ /** 当前隐藏的列 key 集合,与 Table 的 `hiddenColumnKeys` 使用同一份值 */
8
+ hiddenKeys?: (string | number)[];
9
9
  /** 隐藏列变化时触发 */
10
- onHiddenColumnKeysChange?: (keys: (string | number)[]) => void;
10
+ onHiddenKeysChange?: (keys: (string | number)[]) => void;
11
11
  /** 禁用的列 key 集合 */
12
12
  disabledKeys?: (string | number)[];
13
13
  /** 标题文案 */
@@ -25,4 +25,4 @@ export interface TableColumnSettingProps<T = Record<string, unknown>> {
25
25
  * 表格列设置组件,用于动态显示/隐藏列
26
26
  * 与 kui-vue 一致,使用 CheckboxGroup 简单列表
27
27
  */
28
- export declare function TableColumnSetting<T extends object = Record<string, unknown>>({ columns, hiddenColumnKeys, onHiddenColumnKeysChange, disabledKeys, title, resetText, size, showReset, children, }: TableColumnSettingProps<T>): import("react").JSX.Element;
28
+ export declare function TableColumnSetting<T extends object = Record<string, unknown>>({ columns, hiddenKeys, onHiddenKeysChange, disabledKeys, title: titleProp, resetText: resetTextProp, size, showReset, children, }: TableColumnSettingProps<T>): import("react").JSX.Element;
@@ -4,10 +4,10 @@ import { Column } from './types.js';
4
4
  export interface TableColumnSettingProps<T = Record<string, unknown>> {
5
5
  /** 所有列定义 */
6
6
  columns?: Column<T>[];
7
- /** 当前隐藏的列 key 集合 */
8
- hiddenColumnKeys?: (string | number)[];
7
+ /** 当前隐藏的列 key 集合,与 Table 的 `hiddenColumnKeys` 使用同一份值 */
8
+ hiddenKeys?: (string | number)[];
9
9
  /** 隐藏列变化时触发 */
10
- onHiddenColumnKeysChange?: (keys: (string | number)[]) => void;
10
+ onHiddenKeysChange?: (keys: (string | number)[]) => void;
11
11
  /** 禁用的列 key 集合 */
12
12
  disabledKeys?: (string | number)[];
13
13
  /** 标题文案 */
@@ -25,4 +25,4 @@ export interface TableColumnSettingProps<T = Record<string, unknown>> {
25
25
  * 表格列设置组件,用于动态显示/隐藏列
26
26
  * 与 kui-vue 一致,使用 CheckboxGroup 简单列表
27
27
  */
28
- export declare function TableColumnSetting<T extends object = Record<string, unknown>>({ columns, hiddenColumnKeys, onHiddenColumnKeysChange, disabledKeys, title, resetText, size, showReset, children, }: TableColumnSettingProps<T>): import("react").JSX.Element;
28
+ export declare function TableColumnSetting<T extends object = Record<string, unknown>>({ columns, hiddenKeys, onHiddenKeysChange, disabledKeys, title: titleProp, resetText: resetTextProp, size, showReset, children, }: TableColumnSettingProps<T>): import("react").JSX.Element;
@@ -1,5 +1,5 @@
1
1
  import { TableProps } from './types.cjs';
2
- export type { Column, SortState, TableKey, TableProps, TableTreeRow } from './types.cjs';
2
+ export type { Column, SortState, TableEllipsisOptions, TableKey, TableProps, TableTreeRow, } from './types.cjs';
3
3
  export { TableColumnSetting } from './column-setting.cjs';
4
4
  export type { TableColumnSettingProps } from './column-setting.cjs';
5
- export default function Table<T extends object = Record<string, unknown>>({ data, columns, selectedKeys, disabledKeys, rowKey, childrenColumnName, expandedKeys, expandAllRows, expandRowByClick, indentSize, scroll, size: sizeProp, striped, bordered, shape: shapeProp, checkable, loading, emptyText, header, footer, virtual, itemHeight, overscan, hiddenColumnKeys, onSort, onRowClick, onSelect, onSelectAll, onSelectedKeysChange, onExpand, onExpandedKeysChange, className, ...rest }: TableProps<T>): import("react").JSX.Element;
5
+ export default function Table<T extends object = Record<string, unknown>>({ data, columns, ellipsis: tableEllipsis, selectedKeys, disabledKeys, rowKey, childrenColumnName, expandedKeys, expandAllRows, expandRowByClick, indentSize, scroll, size: sizeProp, striped, bordered, shape: shapeProp, checkable, loading, emptyText, header, footer, virtual, itemHeight, overscan, hiddenColumnKeys, onSort, onRowClick, onSelect, onSelectAll, onSelectedKeysChange, onExpand, onExpandedKeysChange, className, ...rest }: TableProps<T>): import("react").JSX.Element;
@@ -1,5 +1,5 @@
1
1
  import { TableProps } from './types.js';
2
- export type { Column, SortState, TableKey, TableProps, TableTreeRow } from './types.js';
2
+ export type { Column, SortState, TableEllipsisOptions, TableKey, TableProps, TableTreeRow, } from './types.js';
3
3
  export { TableColumnSetting } from './column-setting.js';
4
4
  export type { TableColumnSettingProps } from './column-setting.js';
5
- export default function Table<T extends object = Record<string, unknown>>({ data, columns, selectedKeys, disabledKeys, rowKey, childrenColumnName, expandedKeys, expandAllRows, expandRowByClick, indentSize, scroll, size: sizeProp, striped, bordered, shape: shapeProp, checkable, loading, emptyText, header, footer, virtual, itemHeight, overscan, hiddenColumnKeys, onSort, onRowClick, onSelect, onSelectAll, onSelectedKeysChange, onExpand, onExpandedKeysChange, className, ...rest }: TableProps<T>): import("react").JSX.Element;
5
+ export default function Table<T extends object = Record<string, unknown>>({ data, columns, ellipsis: tableEllipsis, selectedKeys, disabledKeys, rowKey, childrenColumnName, expandedKeys, expandAllRows, expandRowByClick, indentSize, scroll, size: sizeProp, striped, bordered, shape: shapeProp, checkable, loading, emptyText, header, footer, virtual, itemHeight, overscan, hiddenColumnKeys, onSort, onRowClick, onSelect, onSelectAll, onSelectedKeysChange, onExpand, onExpandedKeysChange, className, ...rest }: TableProps<T>): import("react").JSX.Element;
@@ -1,16 +1,30 @@
1
1
  import { HTMLAttributes, ReactNode } from 'react';
2
- import { ShapeType, SizeType } from '../const/types.cjs';
2
+ import { SurfaceShapeType, SizeType } from '../const/types.cjs';
3
3
  export type TableKey = string | number;
4
4
  export interface SortState {
5
5
  key: string;
6
6
  order: null | "desc" | "asc";
7
7
  }
8
+ export interface TableEllipsisOptions {
9
+ /** 截断到第几行,默认 `1`(单行不换行) */
10
+ rows?: number;
11
+ /**
12
+ * 悬停提示。默认用被截断的那段文本;传字符串或节点换成指定内容;`false` 关掉提示。
13
+ * 只有真的被截断才会弹,没截断的格子不会多出气泡。
14
+ */
15
+ tooltip?: boolean | ReactNode;
16
+ }
8
17
  export interface Column<T = Record<string, unknown>> {
9
18
  key: string;
10
19
  title: ReactNode;
11
20
  width?: number;
12
21
  fixed?: "left" | "right";
13
22
  sorter?: boolean | ((state: SortState) => void);
23
+ /**
24
+ * 内容超出列宽时显示省略号。`true` 单行、数字或 `rows` 是多行,`tooltip` 定制悬停提示。
25
+ * 表格级 `ellipsis` 打开时,这一列写 `false` 可以单独关掉。
26
+ */
27
+ ellipsis?: boolean | number | TableEllipsisOptions;
14
28
  render?(value: unknown, record: T, rowIndex: number, column: Column<T>): ReactNode;
15
29
  renderHeader?(column: Column<T>, index: number): ReactNode;
16
30
  colSpan?: number | ((record: T, index: number) => number);
@@ -20,6 +34,11 @@ export interface Column<T = Record<string, unknown>> {
20
34
  export interface TableProps<T = Record<string, unknown>> extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect" | "defaultValue" | "defaultChecked"> {
21
35
  data?: T[];
22
36
  columns?: Column<T>[];
37
+ /**
38
+ * 给所有列打开省略号,省得一列列写 `ellipsis`。
39
+ * `true` 单行、数字或 `rows` 是多行,`tooltip` 定制悬停提示;某一列想留完整内容就在那列写 `ellipsis: false`。
40
+ */
41
+ ellipsis?: boolean | number | TableEllipsisOptions;
23
42
  selectedKeys?: TableKey[];
24
43
  disabledKeys?: TableKey[];
25
44
  rowKey?: string | ((record: T) => TableKey);
@@ -35,7 +54,7 @@ export interface TableProps<T = Record<string, unknown>> extends Omit<HTMLAttrib
35
54
  size?: SizeType;
36
55
  striped?: boolean;
37
56
  bordered?: boolean;
38
- shape?: ShapeType;
57
+ shape?: SurfaceShapeType;
39
58
  checkable?: boolean;
40
59
  loading?: boolean;
41
60
  emptyText?: string;
@@ -1,16 +1,30 @@
1
1
  import { HTMLAttributes, ReactNode } from 'react';
2
- import { ShapeType, SizeType } from '../const/types.js';
2
+ import { SurfaceShapeType, SizeType } from '../const/types.js';
3
3
  export type TableKey = string | number;
4
4
  export interface SortState {
5
5
  key: string;
6
6
  order: null | "desc" | "asc";
7
7
  }
8
+ export interface TableEllipsisOptions {
9
+ /** 截断到第几行,默认 `1`(单行不换行) */
10
+ rows?: number;
11
+ /**
12
+ * 悬停提示。默认用被截断的那段文本;传字符串或节点换成指定内容;`false` 关掉提示。
13
+ * 只有真的被截断才会弹,没截断的格子不会多出气泡。
14
+ */
15
+ tooltip?: boolean | ReactNode;
16
+ }
8
17
  export interface Column<T = Record<string, unknown>> {
9
18
  key: string;
10
19
  title: ReactNode;
11
20
  width?: number;
12
21
  fixed?: "left" | "right";
13
22
  sorter?: boolean | ((state: SortState) => void);
23
+ /**
24
+ * 内容超出列宽时显示省略号。`true` 单行、数字或 `rows` 是多行,`tooltip` 定制悬停提示。
25
+ * 表格级 `ellipsis` 打开时,这一列写 `false` 可以单独关掉。
26
+ */
27
+ ellipsis?: boolean | number | TableEllipsisOptions;
14
28
  render?(value: unknown, record: T, rowIndex: number, column: Column<T>): ReactNode;
15
29
  renderHeader?(column: Column<T>, index: number): ReactNode;
16
30
  colSpan?: number | ((record: T, index: number) => number);
@@ -20,6 +34,11 @@ export interface Column<T = Record<string, unknown>> {
20
34
  export interface TableProps<T = Record<string, unknown>> extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect" | "defaultValue" | "defaultChecked"> {
21
35
  data?: T[];
22
36
  columns?: Column<T>[];
37
+ /**
38
+ * 给所有列打开省略号,省得一列列写 `ellipsis`。
39
+ * `true` 单行、数字或 `rows` 是多行,`tooltip` 定制悬停提示;某一列想留完整内容就在那列写 `ellipsis: false`。
40
+ */
41
+ ellipsis?: boolean | number | TableEllipsisOptions;
23
42
  selectedKeys?: TableKey[];
24
43
  disabledKeys?: TableKey[];
25
44
  rowKey?: string | ((record: T) => TableKey);
@@ -35,7 +54,7 @@ export interface TableProps<T = Record<string, unknown>> extends Omit<HTMLAttrib
35
54
  size?: SizeType;
36
55
  striped?: boolean;
37
56
  bordered?: boolean;
38
- shape?: ShapeType;
57
+ shape?: SurfaceShapeType;
39
58
  checkable?: boolean;
40
59
  loading?: boolean;
41
60
  emptyText?: string;