react-kui 3.1.2 → 3.2.0

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 (396) hide show
  1. package/README.zh-CN.md +3 -1
  2. package/ai/kui-components.json +912 -318
  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 +3 -3
  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 +544 -206
  177. package/es/table/utils.js +141 -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/select/select.d.cts +2 -0
  360. package/types/select/select.d.ts +2 -0
  361. package/types/stat-card/stat-card.d.cts +3 -3
  362. package/types/stat-card/stat-card.d.ts +3 -3
  363. package/types/stat-card/utils/stat-item-key.d.cts +11 -0
  364. package/types/stat-card/utils/stat-item-key.d.ts +11 -0
  365. package/types/table/column-setting.d.cts +4 -4
  366. package/types/table/column-setting.d.ts +4 -4
  367. package/types/table/index.d.cts +2 -2
  368. package/types/table/index.d.ts +2 -2
  369. package/types/table/types.d.cts +21 -2
  370. package/types/table/types.d.ts +21 -2
  371. package/types/table/utils.d.cts +75 -0
  372. package/types/table/utils.d.ts +75 -0
  373. package/types/tag/index.d.cts +2 -2
  374. package/types/tag/index.d.ts +2 -2
  375. package/types/tooltip/index.d.cts +2 -0
  376. package/types/tooltip/index.d.ts +2 -0
  377. package/types/transfer/index.d.cts +3 -2
  378. package/types/transfer/index.d.ts +3 -2
  379. package/types/tree-select/index.d.cts +3 -1
  380. package/types/tree-select/index.d.ts +3 -1
  381. package/types/utils/checked.d.cts +1 -1
  382. package/types/utils/checked.d.ts +1 -1
  383. package/types/utils/color.d.cts +13 -0
  384. package/types/utils/color.d.ts +13 -0
  385. package/types/utils/css.d.cts +2 -0
  386. package/types/utils/css.d.ts +2 -0
  387. package/types/utils/focus.d.cts +5 -0
  388. package/types/utils/focus.d.ts +5 -0
  389. package/types/utils/overlay-order.d.cts +6 -0
  390. package/types/utils/overlay-order.d.ts +6 -0
  391. package/types/utils/overlay-stack.d.cts +13 -0
  392. package/types/utils/overlay-stack.d.ts +13 -0
  393. package/types/utils/promise.d.cts +5 -0
  394. package/types/utils/promise.d.ts +5 -0
  395. package/types/utils/react-node.d.cts +10 -0
  396. package/types/utils/react-node.d.ts +10 -0
@@ -1,7 +1,13 @@
1
+ import { ConfigContextValue } from './config-context.cjs';
1
2
  interface Point {
2
3
  x: number;
3
4
  y: number;
4
5
  }
5
6
  export declare const recordMousePoint: () => void;
6
7
  export declare const getMousePoint: () => Point;
8
+ export declare const pushConfig: (config: ConfigContextValue) => () => void;
9
+ /** 当前该给命令式弹窗用的配置;页面上没有 ConfigProvider 时返回 null。 */
10
+ export declare const currentConfig: () => ConfigContextValue | null;
11
+ /** 配置换了要通知活着的命令式弹窗重渲染,否则它们会停在打开那一刻的语言/尺寸上。 */
12
+ export declare const subscribeConfig: (listener: () => void) => () => void;
7
13
  export {};
@@ -1,7 +1,13 @@
1
+ import { ConfigContextValue } from './config-context.js';
1
2
  interface Point {
2
3
  x: number;
3
4
  y: number;
4
5
  }
5
6
  export declare const recordMousePoint: () => void;
6
7
  export declare const getMousePoint: () => Point;
8
+ export declare const pushConfig: (config: ConfigContextValue) => () => void;
9
+ /** 当前该给命令式弹窗用的配置;页面上没有 ConfigProvider 时返回 null。 */
10
+ export declare const currentConfig: () => ConfigContextValue | null;
11
+ /** 配置换了要通知活着的命令式弹窗重渲染,否则它们会停在打开那一刻的语言/尺寸上。 */
12
+ export declare const subscribeConfig: (listener: () => void) => () => void;
7
13
  export {};
@@ -0,0 +1,16 @@
1
+ type PopupCloser = () => void;
2
+ type PopupRegistrar = (close: PopupCloser) => () => void;
3
+ /**
4
+ * Modal / Drawer 用它给自己圈一个浮层作用域:挂在里面的 Popup(下拉、气泡、子菜单……)
5
+ * 把关闭方法登记进来,宿主窗口关的时候一起关掉——否则窗口都没了,teleported 的下拉还悬在 body 上。
6
+ * Vue 侧是同名 API 的 provide/inject 版(components/config/popup-host.ts)。
7
+ */
8
+ export declare const PopupHostContext: import('react').Context<PopupRegistrar | null>;
9
+ /** 宿主窗口(Modal / Drawer)用:拿到 register 传给 Provider,关窗时调 closeAll。 */
10
+ export declare function usePopupHostScope(): {
11
+ register: PopupRegistrar;
12
+ closeAll: () => void;
13
+ };
14
+ /** 浮层用:把自己的关闭方法登记给最近的宿主窗口;外面没有宿主时什么都不做。 */
15
+ export declare function usePopupHost(close: PopupCloser): void;
16
+ export {};
@@ -0,0 +1,16 @@
1
+ type PopupCloser = () => void;
2
+ type PopupRegistrar = (close: PopupCloser) => () => void;
3
+ /**
4
+ * Modal / Drawer 用它给自己圈一个浮层作用域:挂在里面的 Popup(下拉、气泡、子菜单……)
5
+ * 把关闭方法登记进来,宿主窗口关的时候一起关掉——否则窗口都没了,teleported 的下拉还悬在 body 上。
6
+ * Vue 侧是同名 API 的 provide/inject 版(components/config/popup-host.ts)。
7
+ */
8
+ export declare const PopupHostContext: import('react').Context<PopupRegistrar | null>;
9
+ /** 宿主窗口(Modal / Drawer)用:拿到 register 传给 Provider,关窗时调 closeAll。 */
10
+ export declare function usePopupHostScope(): {
11
+ register: PopupRegistrar;
12
+ closeAll: () => void;
13
+ };
14
+ /** 浮层用:把自己的关闭方法登记给最近的宿主窗口;外面没有宿主时什么都不做。 */
15
+ export declare function usePopupHost(close: PopupCloser): void;
16
+ export {};
@@ -1,7 +1,46 @@
1
- import { ShapeType } from '../const/types.cjs';
1
+ import { MarkThemeType, ShapeType, SurfaceThemeType, ThemeType } from '../const/types.cjs';
2
+ /**
3
+ * What a `ConfigProvider` says about everything under it. Form is deliberately absent: `Form`'s `size`,
4
+ * `shape` and `theme` are documented as the appearance of its *child controls*, and a Card, Table or Alert
5
+ * sitting inside a form is not one — inheriting there meant `<Form size="small">` shrank every panel around it.
6
+ * Controls call `useFormAppearance` instead, which keeps the same three keys and layers Form on top.
7
+ */
2
8
  export declare function useConfigAppearance(): {
3
9
  size: import('../index.cjs').SizeType | undefined;
4
10
  shape: ShapeType | undefined;
5
- theme: import('../index.cjs').ThemeType | undefined;
11
+ theme: ThemeType | undefined;
12
+ };
13
+ /** For the controls a `Form` wraps: what the form says, then what the provider says. */
14
+ export declare function useFormAppearance(): {
15
+ size: import('../index.cjs').SizeType | undefined;
16
+ shape: ShapeType | undefined;
17
+ theme: ThemeType | undefined;
6
18
  };
7
19
  export declare function normalizeSurfaceShape(shape: ShapeType | undefined): "round" | "default" | "square" | undefined;
20
+ /**
21
+ * Every component that paints tier classes resolves its value here instead of copying the comparison.
22
+ * Writing no `theme` at all is how a caller says "listen to the component", and this returns the tier
23
+ * that component was built to look like — the same class it reaches with no `theme`, so the two can
24
+ * never drift. A component's own default differs (input-family is `fill`, `collapse` is `outline`,
25
+ * `image` is `plain`), which is why the fallback is a parameter rather than a constant.
26
+ */
27
+ export declare function resolveTheme(theme: ThemeType | undefined, fallback: ThemeType): ThemeType;
28
+ /**
29
+ * The other shape of "listen to the component": some components own no tier class for their default
30
+ * look at all. Button's `k-btn-default` is a *type* class, and a tier the stylesheet never paints —
31
+ * `k-btn-underlined`, since an underline only means something on a control you type into — is a dead
32
+ * class. An unguarded `` [`k-<component>-${theme}`]: theme `` ships both, so a component in this shape
33
+ * resolves through here: a value outside the tiers it actually paints yields `undefined`, emits no tier
34
+ * class, and leaves the component's own look in place.
35
+ */
36
+ export declare function resolvePaintedTheme<T extends ThemeType>(theme: ThemeType | undefined, painted: readonly T[]): T | undefined;
37
+ /**
38
+ * The two painted sets as values, for the components that hand a tier *onward* instead of painting it:
39
+ * a group forwarding to its items, a dropdown forwarding to its buttons, a chip list forwarding to
40
+ * `Tag`. Those callers must vouch for what they pass — `theme` is typed by what the receiver paints —
41
+ * so they run the inherited value through the receiver's guard rather than forwarding a tier the
42
+ * receiver would only fall back from. A component that paints its own surface keeps its own
43
+ * `PAINTED_THEMES` list next to its stylesheet, because the style contract reads it from there.
44
+ */
45
+ export declare const SURFACE_THEMES: readonly SurfaceThemeType[];
46
+ export declare const MARK_THEMES: readonly MarkThemeType[];
@@ -1,7 +1,46 @@
1
- import { ShapeType } from '../const/types.js';
1
+ import { MarkThemeType, ShapeType, SurfaceThemeType, ThemeType } from '../const/types.js';
2
+ /**
3
+ * What a `ConfigProvider` says about everything under it. Form is deliberately absent: `Form`'s `size`,
4
+ * `shape` and `theme` are documented as the appearance of its *child controls*, and a Card, Table or Alert
5
+ * sitting inside a form is not one — inheriting there meant `<Form size="small">` shrank every panel around it.
6
+ * Controls call `useFormAppearance` instead, which keeps the same three keys and layers Form on top.
7
+ */
2
8
  export declare function useConfigAppearance(): {
3
9
  size: import('../index.js').SizeType | undefined;
4
10
  shape: ShapeType | undefined;
5
- theme: import('../index.js').ThemeType | undefined;
11
+ theme: ThemeType | undefined;
12
+ };
13
+ /** For the controls a `Form` wraps: what the form says, then what the provider says. */
14
+ export declare function useFormAppearance(): {
15
+ size: import('../index.js').SizeType | undefined;
16
+ shape: ShapeType | undefined;
17
+ theme: ThemeType | undefined;
6
18
  };
7
19
  export declare function normalizeSurfaceShape(shape: ShapeType | undefined): "round" | "default" | "square" | undefined;
20
+ /**
21
+ * Every component that paints tier classes resolves its value here instead of copying the comparison.
22
+ * Writing no `theme` at all is how a caller says "listen to the component", and this returns the tier
23
+ * that component was built to look like — the same class it reaches with no `theme`, so the two can
24
+ * never drift. A component's own default differs (input-family is `fill`, `collapse` is `outline`,
25
+ * `image` is `plain`), which is why the fallback is a parameter rather than a constant.
26
+ */
27
+ export declare function resolveTheme(theme: ThemeType | undefined, fallback: ThemeType): ThemeType;
28
+ /**
29
+ * The other shape of "listen to the component": some components own no tier class for their default
30
+ * look at all. Button's `k-btn-default` is a *type* class, and a tier the stylesheet never paints —
31
+ * `k-btn-underlined`, since an underline only means something on a control you type into — is a dead
32
+ * class. An unguarded `` [`k-<component>-${theme}`]: theme `` ships both, so a component in this shape
33
+ * resolves through here: a value outside the tiers it actually paints yields `undefined`, emits no tier
34
+ * class, and leaves the component's own look in place.
35
+ */
36
+ export declare function resolvePaintedTheme<T extends ThemeType>(theme: ThemeType | undefined, painted: readonly T[]): T | undefined;
37
+ /**
38
+ * The two painted sets as values, for the components that hand a tier *onward* instead of painting it:
39
+ * a group forwarding to its items, a dropdown forwarding to its buttons, a chip list forwarding to
40
+ * `Tag`. Those callers must vouch for what they pass — `theme` is typed by what the receiver paints —
41
+ * so they run the inherited value through the receiver's guard rather than forwarding a tier the
42
+ * receiver would only fall back from. A component that paints its own surface keeps its own
43
+ * `PAINTED_THEMES` list next to its stylesheet, because the style contract reads it from there.
44
+ */
45
+ export declare const SURFACE_THEMES: readonly SurfaceThemeType[];
46
+ export declare const MARK_THEMES: readonly MarkThemeType[];
@@ -5,9 +5,38 @@ export type DropPlacementsType = "top" | "top-left" | "top-right" | "bottom" | "
5
5
  export type ValueType = "string" | "number" | "boolean";
6
6
  export type SizeType = "small" | "medium" | "large";
7
7
  export type ShapeType = "circle" | "square" | "round" | "default";
8
+ /**
9
+ * Shapes a surface (card / panel / stat card) can actually draw.
10
+ *
11
+ * `ShapeType` is the global vocabulary and keeps `circle` for controls that mean it
12
+ * (Avatar, Badge). A surface rounds its corners instead: a circle would clip the
13
+ * content, so `circle` — inherited from ConfigProvider or passed by an older caller —
14
+ * is normalised to `round`, and `default` keeps the inherited card radius. Same subset
15
+ * as the Vue build.
16
+ */
17
+ export type SurfaceShapeType = "square" | "round";
8
18
  export type BooleanType = boolean | undefined;
9
19
  export type ButtonType = "primary" | "danger" | "warning" | "default" | "text" | "link";
10
- export type ThemeType = "outline" | "fill" | "plain" | "underlined" | "default" | "solid" | "dashed";
20
+ export type ThemeType = "outline" | "fill" | "plain" | "underlined" | "solid" | "dashed";
21
+ /**
22
+ * The five tiers a component that paints a *plate* actually draws: every surface (Card, Collapse,
23
+ * Alert, Page, Kanban, Transfer, ListPanel, CheckCard, Image, QRCode, FeedbackPanel) plus Tag and
24
+ * Button. `underlined` belongs to controls you type into — a card with one edge deleted is not an
25
+ * appearance preset — so a surface never accepts it, and the runtime guard
26
+ * (`resolvePaintedTheme(theme, PAINTED_THEMES)`) lands anything outside these five on the plate the
27
+ * component was built to look like.
28
+ *
29
+ * `ThemeType` stays the wider vocabulary of `ConfigProvider` and `Form`: a provider can still say
30
+ * `underlined`, and the component that cannot paint it decides what that means.
31
+ */
32
+ export type SurfaceThemeType = "fill" | "outline" | "plain" | "solid" | "dashed";
33
+ /**
34
+ * The two tiers a mark actually draws. A checkbox or radio box paints a shallow filled plate
35
+ * (`fill`) or an outlined one (`outline`); the other four would either delete its border or flood
36
+ * the tick, so the mark family — Checkbox, CheckboxGroup, Radio, RadioButton, RadioGroup — accepts
37
+ * only these two, and the guard lands anything else on `fill`.
38
+ */
39
+ export type MarkThemeType = "fill" | "outline";
11
40
  export type RadioType = "radio" | "button";
12
41
  export type DirectionType = "horizontal" | "vertical" | "inline";
13
42
  export type AlignType = "start" | "center" | "end";
@@ -5,9 +5,38 @@ export type DropPlacementsType = "top" | "top-left" | "top-right" | "bottom" | "
5
5
  export type ValueType = "string" | "number" | "boolean";
6
6
  export type SizeType = "small" | "medium" | "large";
7
7
  export type ShapeType = "circle" | "square" | "round" | "default";
8
+ /**
9
+ * Shapes a surface (card / panel / stat card) can actually draw.
10
+ *
11
+ * `ShapeType` is the global vocabulary and keeps `circle` for controls that mean it
12
+ * (Avatar, Badge). A surface rounds its corners instead: a circle would clip the
13
+ * content, so `circle` — inherited from ConfigProvider or passed by an older caller —
14
+ * is normalised to `round`, and `default` keeps the inherited card radius. Same subset
15
+ * as the Vue build.
16
+ */
17
+ export type SurfaceShapeType = "square" | "round";
8
18
  export type BooleanType = boolean | undefined;
9
19
  export type ButtonType = "primary" | "danger" | "warning" | "default" | "text" | "link";
10
- export type ThemeType = "outline" | "fill" | "plain" | "underlined" | "default" | "solid" | "dashed";
20
+ export type ThemeType = "outline" | "fill" | "plain" | "underlined" | "solid" | "dashed";
21
+ /**
22
+ * The five tiers a component that paints a *plate* actually draws: every surface (Card, Collapse,
23
+ * Alert, Page, Kanban, Transfer, ListPanel, CheckCard, Image, QRCode, FeedbackPanel) plus Tag and
24
+ * Button. `underlined` belongs to controls you type into — a card with one edge deleted is not an
25
+ * appearance preset — so a surface never accepts it, and the runtime guard
26
+ * (`resolvePaintedTheme(theme, PAINTED_THEMES)`) lands anything outside these five on the plate the
27
+ * component was built to look like.
28
+ *
29
+ * `ThemeType` stays the wider vocabulary of `ConfigProvider` and `Form`: a provider can still say
30
+ * `underlined`, and the component that cannot paint it decides what that means.
31
+ */
32
+ export type SurfaceThemeType = "fill" | "outline" | "plain" | "solid" | "dashed";
33
+ /**
34
+ * The two tiers a mark actually draws. A checkbox or radio box paints a shallow filled plate
35
+ * (`fill`) or an outlined one (`outline`); the other four would either delete its border or flood
36
+ * the tick, so the mark family — Checkbox, CheckboxGroup, Radio, RadioButton, RadioGroup — accepts
37
+ * only these two, and the guard lands anything else on `fill`.
38
+ */
39
+ export type MarkThemeType = "fill" | "outline";
11
40
  export type RadioType = "radio" | "button";
12
41
  export type DirectionType = "horizontal" | "vertical" | "inline";
13
42
  export type AlignType = "start" | "center" | "end";
@@ -1 +1,6 @@
1
- export declare const colors: readonly ["default", "red", "orange", "yellow", "olive", "green", "teal", "blue", "volcano", "violet", "cyan", "gold", "lime", "magenta", "purple", "pink", "brown", "gray"];
1
+ /**
2
+ * 预设色值名,`Tag` / `Badge` / `Button` / `Tooltip` 的 `color` 共用这一套。
3
+ * 里面只有能上色的名字:不传 `color` 就是组件自己的那张表面,给它再取一个名字只会让人以为
4
+ * 色板里存在一套跟主题无关的档。
5
+ */
6
+ export declare const colors: readonly ["red", "orange", "yellow", "olive", "green", "teal", "blue", "volcano", "violet", "cyan", "gold", "lime", "magenta", "purple", "pink", "brown", "gray"];
@@ -1 +1,6 @@
1
- export declare const colors: readonly ["default", "red", "orange", "yellow", "olive", "green", "teal", "blue", "volcano", "violet", "cyan", "gold", "lime", "magenta", "purple", "pink", "brown", "gray"];
1
+ /**
2
+ * 预设色值名,`Tag` / `Badge` / `Button` / `Tooltip` 的 `color` 共用这一套。
3
+ * 里面只有能上色的名字:不传 `color` 就是组件自己的那张表面,给它再取一个名字只会让人以为
4
+ * 色板里存在一套跟主题无关的档。
5
+ */
6
+ export declare const colors: readonly ["red", "orange", "yellow", "olive", "green", "teal", "blue", "volcano", "violet", "cyan", "gold", "lime", "magenta", "purple", "pink", "brown", "gray"];
@@ -32,6 +32,8 @@ export interface DatePickerProps extends Omit<HTMLAttributes<HTMLDivElement>, "o
32
32
  shape?: ShapeType;
33
33
  bordered?: boolean;
34
34
  placement?: DropPlacementsType;
35
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
36
+ destroyOnClose?: boolean;
35
37
  header?: ReactNode | ((api: {
36
38
  emit: (value: DatePickerInput | DatePickerInput[]) => void;
37
39
  }) => ReactNode);
@@ -46,7 +48,7 @@ export interface DatePickerProps extends Omit<HTMLAttributes<HTMLDivElement>, "o
46
48
  /** Render only the picker panel without a trigger or portal. */
47
49
  panelOnly?: boolean;
48
50
  }
49
- declare function DatePicker({ value, startDate, endDate, valueType, mode, presets, disabled, readOnly, open, clearable, editable, placeholder, format, disabledDate, disabledTime, size: sizeProp, dateIcon, theme: themeProp, shape: shapeProp, bordered, placement, header, footer, onChange, onStartDateChange, onEndDateChange, onOpenChange, onClear, panelOnly, className, style, ...rest }: DatePickerProps): import("react").JSX.Element;
51
+ declare function DatePicker({ value, startDate, endDate, valueType, mode, presets, disabled, readOnly, open, clearable, editable, placeholder, format, disabledDate, disabledTime, size: sizeProp, dateIcon, theme: themeProp, shape: shapeProp, bordered, placement, destroyOnClose, header, footer, onChange, onStartDateChange, onEndDateChange, onOpenChange, onClear, panelOnly, className, style, ...rest }: DatePickerProps): import("react").JSX.Element;
50
52
  export type DatePickerPanelProps = Omit<DatePickerProps, "panelOnly" | "open">;
51
53
  export declare function DatePickerPanel(props: DatePickerPanelProps): import("react").JSX.Element;
52
54
  declare const _default: typeof DatePicker;
@@ -32,6 +32,8 @@ export interface DatePickerProps extends Omit<HTMLAttributes<HTMLDivElement>, "o
32
32
  shape?: ShapeType;
33
33
  bordered?: boolean;
34
34
  placement?: DropPlacementsType;
35
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
36
+ destroyOnClose?: boolean;
35
37
  header?: ReactNode | ((api: {
36
38
  emit: (value: DatePickerInput | DatePickerInput[]) => void;
37
39
  }) => ReactNode);
@@ -46,7 +48,7 @@ export interface DatePickerProps extends Omit<HTMLAttributes<HTMLDivElement>, "o
46
48
  /** Render only the picker panel without a trigger or portal. */
47
49
  panelOnly?: boolean;
48
50
  }
49
- declare function DatePicker({ value, startDate, endDate, valueType, mode, presets, disabled, readOnly, open, clearable, editable, placeholder, format, disabledDate, disabledTime, size: sizeProp, dateIcon, theme: themeProp, shape: shapeProp, bordered, placement, header, footer, onChange, onStartDateChange, onEndDateChange, onOpenChange, onClear, panelOnly, className, style, ...rest }: DatePickerProps): import("react").JSX.Element;
51
+ declare function DatePicker({ value, startDate, endDate, valueType, mode, presets, disabled, readOnly, open, clearable, editable, placeholder, format, disabledDate, disabledTime, size: sizeProp, dateIcon, theme: themeProp, shape: shapeProp, bordered, placement, destroyOnClose, header, footer, onChange, onStartDateChange, onEndDateChange, onOpenChange, onClear, panelOnly, className, style, ...rest }: DatePickerProps): import("react").JSX.Element;
50
52
  export type DatePickerPanelProps = Omit<DatePickerProps, "panelOnly" | "open">;
51
53
  export declare function DatePickerPanel(props: DatePickerPanelProps): import("react").JSX.Element;
52
54
  declare const _default: typeof DatePicker;
@@ -1,5 +1,5 @@
1
1
  import { default as React } from 'react';
2
- import { DirectionType, ShapeType, SizeType } from '../const/types.cjs';
2
+ import { DirectionType, SizeType, SurfaceShapeType } from '../const/types.cjs';
3
3
  import { ResponsiveValue } from '../grid/useBreakpoint.cjs';
4
4
  export interface DescriptionsItemProps {
5
5
  label?: React.ReactNode;
@@ -14,7 +14,7 @@ export interface DescriptionsProps extends Omit<React.HTMLAttributes<HTMLDivElem
14
14
  title?: React.ReactNode;
15
15
  extra?: React.ReactNode;
16
16
  size?: SizeType;
17
- shape?: ShapeType;
17
+ shape?: SurfaceShapeType;
18
18
  children?: React.ReactNode;
19
19
  }
20
20
  declare const Descriptions: React.FC<DescriptionsProps>;
@@ -1,5 +1,5 @@
1
1
  import { default as React } from 'react';
2
- import { DirectionType, ShapeType, SizeType } from '../const/types.js';
2
+ import { DirectionType, SizeType, SurfaceShapeType } from '../const/types.js';
3
3
  import { ResponsiveValue } from '../grid/useBreakpoint.js';
4
4
  export interface DescriptionsItemProps {
5
5
  label?: React.ReactNode;
@@ -14,7 +14,7 @@ export interface DescriptionsProps extends Omit<React.HTMLAttributes<HTMLDivElem
14
14
  title?: React.ReactNode;
15
15
  extra?: React.ReactNode;
16
16
  size?: SizeType;
17
- shape?: ShapeType;
17
+ shape?: SurfaceShapeType;
18
18
  children?: React.ReactNode;
19
19
  }
20
20
  declare const Descriptions: React.FC<DescriptionsProps>;
@@ -16,6 +16,7 @@ export interface DrawerProps {
16
16
  mask?: boolean;
17
17
  loading?: boolean;
18
18
  escKey?: boolean;
19
+ destroyOnClose?: boolean;
19
20
  onOk?: () => void;
20
21
  onCancel?: () => void;
21
22
  onClose?: () => void;
@@ -16,6 +16,7 @@ export interface DrawerProps {
16
16
  mask?: boolean;
17
17
  loading?: boolean;
18
18
  escKey?: boolean;
19
+ destroyOnClose?: boolean;
19
20
  onOk?: () => void;
20
21
  onCancel?: () => void;
21
22
  onClose?: () => void;
@@ -1,14 +1,17 @@
1
1
  import { default as React } from 'react';
2
- import { DropPlacementsType, ShapeType, SizeType, ThemeType } from '../const/types.cjs';
2
+ import { DropPlacementsType, ShapeType, SizeType, SurfaceThemeType, TriggerType } from '../const/types.cjs';
3
3
  import { IconType } from '../icon/index.cjs';
4
4
  export interface DropdownButtonProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onClick" | "defaultValue" | "defaultChecked"> {
5
5
  size?: SizeType;
6
6
  shape?: ShapeType;
7
7
  disabled?: boolean;
8
8
  icon?: IconType[];
9
- theme?: ThemeType;
9
+ theme?: SurfaceThemeType;
10
10
  arrow?: boolean;
11
+ trigger?: TriggerType;
11
12
  placement?: DropPlacementsType;
13
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
14
+ destroyOnClose?: boolean;
12
15
  onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
13
16
  overlay?: React.ReactNode;
14
17
  children?: React.ReactNode;
@@ -1,14 +1,17 @@
1
1
  import { default as React } from 'react';
2
- import { DropPlacementsType, ShapeType, SizeType, ThemeType } from '../const/types.js';
2
+ import { DropPlacementsType, ShapeType, SizeType, SurfaceThemeType, TriggerType } from '../const/types.js';
3
3
  import { IconType } from '../icon/index.js';
4
4
  export interface DropdownButtonProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onClick" | "defaultValue" | "defaultChecked"> {
5
5
  size?: SizeType;
6
6
  shape?: ShapeType;
7
7
  disabled?: boolean;
8
8
  icon?: IconType[];
9
- theme?: ThemeType;
9
+ theme?: SurfaceThemeType;
10
10
  arrow?: boolean;
11
+ trigger?: TriggerType;
11
12
  placement?: DropPlacementsType;
13
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
14
+ destroyOnClose?: boolean;
12
15
  onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
13
16
  overlay?: React.ReactNode;
14
17
  children?: React.ReactNode;
@@ -1,6 +1,12 @@
1
+ import { KeyboardEvent } from 'react';
1
2
  export interface DropdownContextProps {
3
+ /** target 模式下的触发按钮(DropdownButton 右块)需要自己反映展开状态 */
4
+ expanded?: boolean;
2
5
  onMouseEnter?: () => void;
3
6
  onMouseLeave?: () => void;
7
+ onClick?: () => void;
8
+ onContextMenu?: () => void;
9
+ onTriggerKeydown?: (event: KeyboardEvent<HTMLElement>) => void;
4
10
  clearPopTimer?: () => void;
5
11
  menuSelected?: (data: {
6
12
  key: string;
@@ -1,6 +1,12 @@
1
+ import { KeyboardEvent } from 'react';
1
2
  export interface DropdownContextProps {
3
+ /** target 模式下的触发按钮(DropdownButton 右块)需要自己反映展开状态 */
4
+ expanded?: boolean;
2
5
  onMouseEnter?: () => void;
3
6
  onMouseLeave?: () => void;
7
+ onClick?: () => void;
8
+ onContextMenu?: () => void;
9
+ onTriggerKeydown?: (event: KeyboardEvent<HTMLElement>) => void;
4
10
  clearPopTimer?: () => void;
5
11
  menuSelected?: (data: {
6
12
  key: string;
@@ -8,6 +8,8 @@ export interface DropdownProps extends Omit<React.HTMLAttributes<HTMLDivElement>
8
8
  /** @deprecated Use `open` instead. */
9
9
  show?: boolean;
10
10
  placement?: DropPlacementsType;
11
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
12
+ destroyOnClose?: boolean;
11
13
  target?: React.RefObject<HTMLElement | null>;
12
14
  onOpenChange?: (opened: boolean) => void;
13
15
  overlay?: React.ReactNode;
@@ -8,6 +8,8 @@ export interface DropdownProps extends Omit<React.HTMLAttributes<HTMLDivElement>
8
8
  /** @deprecated Use `open` instead. */
9
9
  show?: boolean;
10
10
  placement?: DropPlacementsType;
11
+ /** 关闭后是否销毁面板内容。默认销毁(重开时重新挂载);设为 false 可保留面板内的表单状态,代价是每个打开过的实例留一份隐藏 DOM。 */
12
+ destroyOnClose?: boolean;
11
13
  target?: React.RefObject<HTMLElement | null>;
12
14
  onOpenChange?: (opened: boolean) => void;
13
15
  overlay?: React.ReactNode;
@@ -1,5 +1,5 @@
1
1
  import { HTMLAttributes, ReactNode } from 'react';
2
- import { ShapeType, ThemeType } from '../const/types.cjs';
2
+ import { SurfaceShapeType, SurfaceThemeType } from '../const/types.cjs';
3
3
  import { IconType } from '../icon/index.cjs';
4
4
  export interface FeatureCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "defaultValue" | "defaultChecked"> {
5
5
  icon?: IconType[] | ReactNode;
@@ -7,8 +7,8 @@ export interface FeatureCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "
7
7
  desc?: ReactNode;
8
8
  extra?: ReactNode;
9
9
  bordered?: boolean;
10
- theme?: ThemeType;
11
- shape?: ShapeType;
10
+ theme?: SurfaceThemeType;
11
+ shape?: SurfaceShapeType;
12
12
  size?: "small" | "medium" | "large";
13
13
  direction?: "horizontal" | "vertical";
14
14
  clickable?: boolean;
@@ -1,5 +1,5 @@
1
1
  import { HTMLAttributes, ReactNode } from 'react';
2
- import { ShapeType, ThemeType } from '../const/types.js';
2
+ import { SurfaceShapeType, SurfaceThemeType } from '../const/types.js';
3
3
  import { IconType } from '../icon/index.js';
4
4
  export interface FeatureCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "defaultValue" | "defaultChecked"> {
5
5
  icon?: IconType[] | ReactNode;
@@ -7,8 +7,8 @@ export interface FeatureCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "
7
7
  desc?: ReactNode;
8
8
  extra?: ReactNode;
9
9
  bordered?: boolean;
10
- theme?: ThemeType;
11
- shape?: ShapeType;
10
+ theme?: SurfaceThemeType;
11
+ shape?: SurfaceShapeType;
12
12
  size?: "small" | "medium" | "large";
13
13
  direction?: "horizontal" | "vertical";
14
14
  clickable?: boolean;
@@ -1,5 +1,5 @@
1
1
  import { HTMLAttributes, ReactNode } from 'react';
2
- import { FeedbackPanelKind, ShapeType, ThemeType } from '../const/types.cjs';
2
+ import { FeedbackPanelKind, SurfaceShapeType, SurfaceThemeType } from '../const/types.cjs';
3
3
  import { IconType } from '../icon/index.cjs';
4
4
  export interface FeedbackPanelProps extends Omit<HTMLAttributes<HTMLElement>, "defaultValue" | "defaultChecked"> {
5
5
  kind?: FeedbackPanelKind;
@@ -8,8 +8,8 @@ export interface FeedbackPanelProps extends Omit<HTMLAttributes<HTMLElement>, "d
8
8
  symbol?: IconType[] | ReactNode;
9
9
  compact?: boolean;
10
10
  actions?: ReactNode;
11
- theme?: ThemeType;
12
- shape?: ShapeType;
11
+ theme?: SurfaceThemeType;
12
+ shape?: SurfaceShapeType;
13
13
  }
14
14
  export default function FeedbackPanel({ kind, heading, description, symbol, compact, actions, theme: themeProp, shape: shapeProp, children, className, ...rest }: FeedbackPanelProps): import("react").JSX.Element;
15
15
  export type { FeedbackPanelKind } from '../const/types.cjs';
@@ -1,5 +1,5 @@
1
1
  import { HTMLAttributes, ReactNode } from 'react';
2
- import { FeedbackPanelKind, ShapeType, ThemeType } from '../const/types.js';
2
+ import { FeedbackPanelKind, SurfaceShapeType, SurfaceThemeType } from '../const/types.js';
3
3
  import { IconType } from '../icon/index.js';
4
4
  export interface FeedbackPanelProps extends Omit<HTMLAttributes<HTMLElement>, "defaultValue" | "defaultChecked"> {
5
5
  kind?: FeedbackPanelKind;
@@ -8,8 +8,8 @@ export interface FeedbackPanelProps extends Omit<HTMLAttributes<HTMLElement>, "d
8
8
  symbol?: IconType[] | ReactNode;
9
9
  compact?: boolean;
10
10
  actions?: ReactNode;
11
- theme?: ThemeType;
12
- shape?: ShapeType;
11
+ theme?: SurfaceThemeType;
12
+ shape?: SurfaceShapeType;
13
13
  }
14
14
  export default function FeedbackPanel({ kind, heading, description, symbol, compact, actions, theme: themeProp, shape: shapeProp, children, className, ...rest }: FeedbackPanelProps): import("react").JSX.Element;
15
15
  export type { FeedbackPanelKind } from '../const/types.js';
@@ -62,6 +62,24 @@ export interface FlameWrapInstance {
62
62
  /** Stop the loop and release all GPU resources. */
63
63
  destroy: () => void;
64
64
  }
65
+ /**
66
+ * Attributes that turn a canvas into an HTML-in-Canvas host, and the matching
67
+ * opt-in for the element that gets drawn.
68
+ */
69
+ export interface HtmlInCanvasMarkup {
70
+ canvas: Record<string, string>;
71
+ element: Record<string, string>;
72
+ }
73
+ /**
74
+ * Chrome 156 renames the experimental boolean `layoutsubtree` to the
75
+ * standardized `content="drawable"`, and the element handed to
76
+ * `drawElementImage()` now declares itself with its own `drawable` attribute
77
+ * (WICG html-in-canvas issue #169). Browsers advertise the new spelling with a
78
+ * reflected `content` IDL attribute, so the shape is read off the prototype
79
+ * rather than sniffed from a version string: every release only ever sees the
80
+ * attribute it understands.
81
+ */
82
+ export declare function htmlInCanvasMarkup(): HtmlInCanvasMarkup;
65
83
  export declare function supportsHtmlInCanvas(): boolean;
66
84
  export declare function createFlameWrap(elements: FlameWrapElements, options?: FlameWrapOptions): FlameWrapInstance | null;
67
85
  export interface FlameWrapProps extends FlameWrapOptions {
@@ -62,6 +62,24 @@ export interface FlameWrapInstance {
62
62
  /** Stop the loop and release all GPU resources. */
63
63
  destroy: () => void;
64
64
  }
65
+ /**
66
+ * Attributes that turn a canvas into an HTML-in-Canvas host, and the matching
67
+ * opt-in for the element that gets drawn.
68
+ */
69
+ export interface HtmlInCanvasMarkup {
70
+ canvas: Record<string, string>;
71
+ element: Record<string, string>;
72
+ }
73
+ /**
74
+ * Chrome 156 renames the experimental boolean `layoutsubtree` to the
75
+ * standardized `content="drawable"`, and the element handed to
76
+ * `drawElementImage()` now declares itself with its own `drawable` attribute
77
+ * (WICG html-in-canvas issue #169). Browsers advertise the new spelling with a
78
+ * reflected `content` IDL attribute, so the shape is read off the prototype
79
+ * rather than sniffed from a version string: every release only ever sees the
80
+ * attribute it understands.
81
+ */
82
+ export declare function htmlInCanvasMarkup(): HtmlInCanvasMarkup;
65
83
  export declare function supportsHtmlInCanvas(): boolean;
66
84
  export declare function createFlameWrap(elements: FlameWrapElements, options?: FlameWrapOptions): FlameWrapInstance | null;
67
85
  export interface FlameWrapProps extends FlameWrapOptions {
@@ -32,6 +32,8 @@ export declare const resolveFormControlAttrs: (props: Record<string, unknown>, f
32
32
  "aria-required": {} | undefined;
33
33
  };
34
34
  export declare const isFormFieldComponent: (component: unknown) => boolean;
35
+ export declare const markFormFieldWrapper: <T extends object>(component: T) => T;
36
+ export declare const isFormFieldWrapper: (component: unknown) => boolean;
35
37
  export declare function createFormFieldComponent<T extends ElementType>(Component: T, adapter?: FormFieldAdapter): T;
36
38
  export declare function FormFieldProvider({ value, children, }: {
37
39
  value: FormFieldContextValue;
@@ -32,6 +32,8 @@ export declare const resolveFormControlAttrs: (props: Record<string, unknown>, f
32
32
  "aria-required": {} | undefined;
33
33
  };
34
34
  export declare const isFormFieldComponent: (component: unknown) => boolean;
35
+ export declare const markFormFieldWrapper: <T extends object>(component: T) => T;
36
+ export declare const isFormFieldWrapper: (component: unknown) => boolean;
35
37
  export declare function createFormFieldComponent<T extends ElementType>(Component: T, adapter?: FormFieldAdapter): T;
36
38
  export declare function FormFieldProvider({ value, children, }: {
37
39
  value: FormFieldContextValue;
@@ -1,6 +1,6 @@
1
1
  import { CSSProperties, HTMLAttributes, ReactNode } from 'react';
2
2
  import { ImagePreviewProps, ImageType } from './preview.cjs';
3
- import { ShapeType, ThemeType } from '../const/types.cjs';
3
+ import { ShapeType, SurfaceThemeType } from '../const/types.cjs';
4
4
  export interface ImageRef {
5
5
  show: (props?: ImagePreviewProps) => void;
6
6
  destroy: () => void;
@@ -21,7 +21,7 @@ export interface ImageProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSwit
21
21
  panel?: ReactNode;
22
22
  onClose?: () => void;
23
23
  onSwitch?: (index: number) => void;
24
- theme?: ThemeType;
24
+ theme?: SurfaceThemeType;
25
25
  shape?: ShapeType;
26
26
  }
27
27
  declare const KImage: import('react').ForwardRefExoticComponent<ImageProps & import('react').RefAttributes<ImageRef>>;
@@ -1,6 +1,6 @@
1
1
  import { CSSProperties, HTMLAttributes, ReactNode } from 'react';
2
2
  import { ImagePreviewProps, ImageType } from './preview.js';
3
- import { ShapeType, ThemeType } from '../const/types.js';
3
+ import { ShapeType, SurfaceThemeType } from '../const/types.js';
4
4
  export interface ImageRef {
5
5
  show: (props?: ImagePreviewProps) => void;
6
6
  destroy: () => void;
@@ -21,7 +21,7 @@ export interface ImageProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSwit
21
21
  panel?: ReactNode;
22
22
  onClose?: () => void;
23
23
  onSwitch?: (index: number) => void;
24
- theme?: ThemeType;
24
+ theme?: SurfaceThemeType;
25
25
  shape?: ShapeType;
26
26
  }
27
27
  declare const KImage: import('react').ForwardRefExoticComponent<ImageProps & import('react').RefAttributes<ImageRef>>;