@fibrae/semi-foundation 0.5.0 → 0.6.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 (570) hide show
  1. package/README.md +20 -18
  2. package/README.zh-CN.md +20 -18
  3. package/dist/base/auto-close-foundation.d.ts +3 -10
  4. package/dist/base/auto-close-foundation.js +21 -42
  5. package/dist/base/constants.d.ts +1 -0
  6. package/dist/base/focus-handle.js +2 -2
  7. package/dist/base/focus-scope.js +1 -20
  8. package/dist/base/foundation.d.ts +0 -1
  9. package/dist/base/hook-api.d.ts +21 -0
  10. package/dist/base/hook-api.js +20 -0
  11. package/dist/base/index.d.ts +14 -0
  12. package/dist/base/index.js +14 -0
  13. package/dist/base/list-store.d.ts +53 -13
  14. package/dist/base/list-store.js +126 -48
  15. package/dist/base/modal-resources.js +1 -1
  16. package/dist/base/static-list-wrapper.d.ts +6 -1
  17. package/dist/base/static-list-wrapper.js +12 -3
  18. package/dist/components/anchor/anchor.css +0 -4
  19. package/dist/components/anchor/anchor.scss +0 -3
  20. package/dist/components/anchor/foundation.d.ts +10 -2
  21. package/dist/components/anchor/foundation.js +45 -6
  22. package/dist/components/audio-player/audio-player.css +1 -1
  23. package/dist/components/audio-player/audio-player.scss +3 -1
  24. package/dist/components/audio-player/foundation.d.ts +7 -5
  25. package/dist/components/audio-player/foundation.js +5 -1
  26. package/dist/components/auto-complete/auto-complete.css +0 -4
  27. package/dist/components/auto-complete/auto-complete.scss +0 -2
  28. package/dist/components/auto-complete/foundation.d.ts +4 -6
  29. package/dist/components/auto-complete/foundation.js +26 -21
  30. package/dist/components/avatar/avatar.css +1 -4
  31. package/dist/components/avatar/avatar.scss +1 -3
  32. package/dist/components/avatar/foundation.d.ts +3 -0
  33. package/dist/components/avatar/foundation.js +6 -2
  34. package/dist/components/backtop/backtop.css +0 -4
  35. package/dist/components/backtop/backtop.scss +0 -3
  36. package/dist/components/backtop/constants.d.ts +4 -0
  37. package/dist/components/backtop/constants.js +5 -1
  38. package/dist/components/backtop/foundation.d.ts +1 -0
  39. package/dist/components/backtop/foundation.js +7 -3
  40. package/dist/components/badge/badge.css +1 -4
  41. package/dist/components/badge/badge.scss +1 -3
  42. package/dist/components/banner/banner.css +0 -4
  43. package/dist/components/banner/banner.scss +0 -3
  44. package/dist/components/banner/foundation.d.ts +1 -0
  45. package/dist/components/breadcrumb/breadcrumb.css +9 -8
  46. package/dist/components/breadcrumb/breadcrumb.scss +10 -6
  47. package/dist/components/breadcrumb/foundation.d.ts +1 -0
  48. package/dist/components/breadcrumb/item-foundation.d.ts +3 -1
  49. package/dist/components/breadcrumb/item-foundation.js +1 -1
  50. package/dist/components/button/button.css +0 -9
  51. package/dist/components/button/icon-button.css +0 -10
  52. package/dist/components/button/icon-button.scss +0 -1
  53. package/dist/components/button/rtl.scss +0 -7
  54. package/dist/components/calendar/calendar.css +0 -6
  55. package/dist/components/calendar/calendar.scss +0 -3
  56. package/dist/components/calendar/event-util.d.ts +3 -3
  57. package/dist/components/calendar/foundation.d.ts +15 -7
  58. package/dist/components/calendar/foundation.js +28 -17
  59. package/dist/components/calendar/month-foundation.d.ts +7 -2
  60. package/dist/components/calendar/month-foundation.js +11 -3
  61. package/dist/components/card/card.css +0 -14
  62. package/dist/components/card/card.scss +0 -3
  63. package/dist/components/carousel/carousel.css +0 -4
  64. package/dist/components/carousel/foundation.d.ts +4 -1
  65. package/dist/components/carousel/foundation.js +20 -8
  66. package/dist/components/carousel/rtl.scss +0 -4
  67. package/dist/components/cascader/cascader.css +1 -6
  68. package/dist/components/cascader/cascader.scss +1 -1
  69. package/dist/components/cascader/foundation.d.ts +6 -3
  70. package/dist/components/cascader/foundation.js +12 -6
  71. package/dist/components/cascader/rtl.scss +0 -5
  72. package/dist/components/cascader/util.d.ts +2 -2
  73. package/dist/components/cascader/util.js +2 -2
  74. package/dist/components/checkbox/checkbox-foundation.d.ts +4 -4
  75. package/dist/components/checkbox/checkbox-foundation.js +3 -1
  76. package/dist/components/checkbox/checkbox-group-foundation.d.ts +5 -0
  77. package/dist/components/checkbox/checkbox-group-foundation.js +4 -0
  78. package/dist/components/checkbox/checkbox.css +0 -5
  79. package/dist/components/checkbox/checkbox.scss +0 -3
  80. package/dist/components/code-highlight/code-highlight.css +1 -1
  81. package/dist/components/code-highlight/code-highlight.scss +1 -1
  82. package/dist/components/code-highlight/index.d.ts +2 -0
  83. package/dist/components/code-highlight/index.js +3 -0
  84. package/dist/components/collapse/collapse.css +1 -4
  85. package/dist/components/collapse/collapse.scss +1 -3
  86. package/dist/components/collapse/foundation.d.ts +1 -0
  87. package/dist/components/collapsible/foundation.d.ts +1 -0
  88. package/dist/components/color-picker/color-choose-area-foundation.d.ts +1 -0
  89. package/dist/components/color-picker/color-picker.css +1 -3
  90. package/dist/components/color-picker/color-picker.scss +1 -3
  91. package/dist/components/color-picker/color-slider-foundation.d.ts +1 -0
  92. package/dist/components/color-picker/data-part-foundation.d.ts +2 -1
  93. package/dist/components/color-picker/data-part-foundation.js +1 -1
  94. package/dist/components/color-picker/foundation.d.ts +7 -1
  95. package/dist/components/color-picker/foundation.js +15 -5
  96. package/dist/components/color-picker/utils/round.js +1 -1
  97. package/dist/components/config-provider/inherit-config.d.ts +5 -2
  98. package/dist/components/config-provider/inherit-config.js +1 -0
  99. package/dist/components/config-provider/responsive-types.d.ts +0 -3
  100. package/dist/components/cropper/cropper.css +20 -22
  101. package/dist/components/cropper/cropper.scss +21 -23
  102. package/dist/components/cropper/foundation.d.ts +2 -15
  103. package/dist/components/cropper/foundation.js +139 -132
  104. package/dist/components/cropper/utils.d.ts +0 -1
  105. package/dist/components/cropper/utils.js +0 -1
  106. package/dist/components/date-picker/_utils/get-default-picker-date.d.ts +6 -4
  107. package/dist/components/date-picker/_utils/get-default-picker-date.js +12 -27
  108. package/dist/components/date-picker/_utils/index.d.ts +2 -2
  109. package/dist/components/date-picker/_utils/index.js +2 -2
  110. package/dist/components/date-picker/_utils/parse-value.d.ts +13 -0
  111. package/dist/components/date-picker/_utils/parse-value.js +21 -0
  112. package/dist/components/date-picker/_utils/parser.d.ts +1 -0
  113. package/dist/components/date-picker/_utils/parser.js +5 -7
  114. package/dist/components/date-picker/_utils/to-callback-args.d.ts +2 -5
  115. package/dist/components/date-picker/_utils/to-callback-args.js +4 -9
  116. package/dist/components/date-picker/constants.js +1 -1
  117. package/dist/components/date-picker/date-picker.css +0 -4
  118. package/dist/components/date-picker/foundation.d.ts +13 -22
  119. package/dist/components/date-picker/foundation.js +42 -40
  120. package/dist/components/date-picker/input-foundation.d.ts +10 -6
  121. package/dist/components/date-picker/input-foundation.js +13 -13
  122. package/dist/components/date-picker/month-foundation.d.ts +23 -8
  123. package/dist/components/date-picker/month-foundation.js +48 -10
  124. package/dist/components/date-picker/months-grid-foundation.d.ts +11 -9
  125. package/dist/components/date-picker/months-grid-foundation.js +59 -30
  126. package/dist/components/date-picker/rtl.scss +0 -4
  127. package/dist/components/date-picker/year-and-month-foundation.d.ts +2 -6
  128. package/dist/components/date-picker/year-and-month-foundation.js +5 -8
  129. package/dist/components/descriptions/descriptions.css +0 -4
  130. package/dist/components/descriptions/descriptions.scss +0 -3
  131. package/dist/components/divider/constants.d.ts +1 -1
  132. package/dist/components/divider/constants.js +1 -1
  133. package/dist/components/drag-move/foundation.d.ts +1 -0
  134. package/dist/components/dropdown/dropdown.css +0 -4
  135. package/dist/components/dropdown/dropdown.scss +0 -3
  136. package/dist/components/dropdown/foundation.d.ts +13 -0
  137. package/dist/components/dropdown/foundation.js +18 -7
  138. package/dist/components/dropdown/menu-foundation.d.ts +1 -0
  139. package/dist/components/dropdown/menu-foundation.js +2 -2
  140. package/dist/components/empty/empty.css +0 -4
  141. package/dist/components/empty/empty.scss +0 -3
  142. package/dist/components/feedback/foundation.d.ts +9 -0
  143. package/dist/components/feedback/foundation.js +9 -0
  144. package/dist/components/float-button/float-button.css +2 -2
  145. package/dist/components/float-button/float-button.scss +2 -5
  146. package/dist/components/form/array-field-rows.d.ts +37 -8
  147. package/dist/components/form/array-field-rows.js +72 -18
  148. package/dist/components/form/errors.d.ts +3 -1
  149. package/dist/components/form/errors.js +5 -1
  150. package/dist/components/form/form.css +0 -10
  151. package/dist/components/form/form.scss +0 -7
  152. package/dist/components/form/foundation.d.ts +7 -2
  153. package/dist/components/form/foundation.js +14 -2
  154. package/dist/components/form/interface.d.ts +9 -2
  155. package/dist/components/form/utils.d.ts +54 -1
  156. package/dist/components/form/utils.js +43 -5
  157. package/dist/components/grid/grid.css +88 -4154
  158. package/dist/components/grid/grid.scss +32 -59
  159. package/dist/components/grid/gutter.d.ts +1 -1
  160. package/dist/components/grid/mixin.scss +20 -101
  161. package/dist/components/grid/utils.d.ts +8 -4
  162. package/dist/components/grid/utils.js +40 -27
  163. package/dist/components/grid/variables.scss +0 -1
  164. package/dist/components/highlight/foundation.d.ts +7 -4
  165. package/dist/components/highlight/foundation.js +9 -7
  166. package/dist/components/hot-keys/foundation.d.ts +1 -0
  167. package/dist/components/image/image-foundation.d.ts +1 -0
  168. package/dist/components/image/image.css +0 -6
  169. package/dist/components/image/preview-footer-foundation.d.ts +1 -0
  170. package/dist/components/image/preview-foundation.d.ts +1 -0
  171. package/dist/components/image/preview-image-foundation.d.ts +1 -0
  172. package/dist/components/image/preview-inner-foundation.d.ts +9 -6
  173. package/dist/components/image/preview-inner-foundation.js +53 -29
  174. package/dist/components/image/rtl.scss +0 -6
  175. package/dist/components/input/foundation.d.ts +22 -2
  176. package/dist/components/input/foundation.js +26 -1
  177. package/dist/components/input/input.css +0 -18
  178. package/dist/components/input/input.scss +0 -17
  179. package/dist/components/input/text-entry-foundation.d.ts +8 -1
  180. package/dist/components/input/text-entry-foundation.js +13 -1
  181. package/dist/components/input/textarea-foundation.d.ts +23 -5
  182. package/dist/components/input/textarea-foundation.js +30 -6
  183. package/dist/components/input/textarea.css +0 -6
  184. package/dist/components/input/textarea.scss +0 -3
  185. package/dist/components/input/variables.scss +0 -3
  186. package/dist/components/input-number/foundation.d.ts +1 -0
  187. package/dist/components/input-number/foundation.js +2 -2
  188. package/dist/components/input-number/input-number.css +0 -4
  189. package/dist/components/input-number/input-number.scss +0 -3
  190. package/dist/components/json-viewer/foundation.d.ts +10 -5
  191. package/dist/components/json-viewer/foundation.js +38 -23
  192. package/dist/components/layout/layout.css +0 -4
  193. package/dist/components/layout/layout.scss +0 -3
  194. package/dist/components/list/list.css +0 -5
  195. package/dist/components/list/list.scss +0 -3
  196. package/dist/components/lottie/foundation.d.ts +2 -2
  197. package/dist/components/lottie/foundation.js +23 -7
  198. package/dist/components/markdown-render/foundation.d.ts +2 -2
  199. package/dist/components/markdown-render/foundation.js +5 -2
  200. package/dist/components/markdown-render/markdown-render.css +2 -1
  201. package/dist/components/markdown-render/markdown-render.scss +2 -1
  202. package/dist/components/modal/confirm-instance.d.ts +28 -0
  203. package/dist/components/modal/confirm-instance.js +54 -0
  204. package/dist/components/modal/modal-content-foundation.d.ts +2 -2
  205. package/dist/components/modal/modal-content-foundation.js +1 -1
  206. package/dist/components/modal/modal-foundation.d.ts +3 -2
  207. package/dist/components/modal/modal-foundation.js +3 -2
  208. package/dist/components/modal/modal.css +0 -4
  209. package/dist/components/modal/modal.scss +0 -3
  210. package/dist/components/navigation/foundation.d.ts +12 -4
  211. package/dist/components/navigation/foundation.js +19 -15
  212. package/dist/components/navigation/item-foundation.d.ts +14 -4
  213. package/dist/components/navigation/item-foundation.js +23 -10
  214. package/dist/components/navigation/navigation.css +0 -4
  215. package/dist/components/navigation/rtl.scss +0 -4
  216. package/dist/components/navigation/sub-nav-foundation.d.ts +1 -0
  217. package/dist/components/notification/constants.d.ts +1 -4
  218. package/dist/components/notification/constants.js +1 -6
  219. package/dist/components/notification/notification-api-foundation.d.ts +4 -2
  220. package/dist/components/notification/notification-api-foundation.js +14 -4
  221. package/dist/components/notification/notification-foundation.d.ts +1 -0
  222. package/dist/components/notification/notification-list-foundation.d.ts +14 -51
  223. package/dist/components/notification/notification-list-foundation.js +7 -63
  224. package/dist/components/notification/notification.css +0 -4
  225. package/dist/components/notification/notification.scss +0 -3
  226. package/dist/components/overflow-list/foundation.d.ts +27 -15
  227. package/dist/components/overflow-list/foundation.js +105 -31
  228. package/dist/components/overflow-list/overflow-list.css +0 -4
  229. package/dist/components/overflow-list/overflow-list.scss +0 -3
  230. package/dist/components/pagination/foundation.d.ts +20 -2
  231. package/dist/components/pagination/foundation.js +32 -4
  232. package/dist/components/pagination/pagination.css +0 -4
  233. package/dist/components/pagination/rtl.scss +0 -4
  234. package/dist/components/pincode/foundation.d.ts +9 -2
  235. package/dist/components/pincode/foundation.js +11 -5
  236. package/dist/components/pincode/pincode.css +6 -8
  237. package/dist/components/pincode/pincode.scss +6 -9
  238. package/dist/components/popconfirm/popconfirm-foundation.d.ts +4 -1
  239. package/dist/components/popconfirm/popconfirm-foundation.js +2 -1
  240. package/dist/components/popconfirm/popconfirm.css +0 -4
  241. package/dist/components/popconfirm/rtl.scss +0 -4
  242. package/dist/components/popover/popover.css +1 -4
  243. package/dist/components/popover/popover.scss +0 -2
  244. package/dist/components/progress/progress.css +2 -4
  245. package/dist/components/progress/progress.scss +2 -0
  246. package/dist/components/progress/rtl.scss +0 -4
  247. package/dist/components/radio/radio-foundation.d.ts +3 -5
  248. package/dist/components/radio/radio-foundation.js +3 -5
  249. package/dist/components/radio/radio-group-foundation.d.ts +6 -0
  250. package/dist/components/radio/radio-group-foundation.js +7 -0
  251. package/dist/components/radio/radio.css +0 -5
  252. package/dist/components/radio/radio.scss +0 -3
  253. package/dist/components/rating/foundation.d.ts +6 -0
  254. package/dist/components/rating/foundation.js +7 -2
  255. package/dist/components/rating/rating.css +0 -4
  256. package/dist/components/rating/rating.scss +0 -3
  257. package/dist/components/resizable/group/index.d.ts +1 -0
  258. package/dist/components/resizable/group/index.js +11 -1
  259. package/dist/components/resizable/resizable.css +6 -0
  260. package/dist/components/resizable/resizable.scss +3 -0
  261. package/dist/components/resizable/single/index.d.ts +1 -0
  262. package/dist/components/resizable/utils.js +1 -1
  263. package/dist/components/scroll-list/item-foundation.d.ts +17 -5
  264. package/dist/components/scroll-list/item-foundation.js +43 -29
  265. package/dist/components/scroll-list/scroll-list.css +0 -4
  266. package/dist/components/scroll-list/scroll-list.scss +0 -3
  267. package/dist/components/select/constants.js +1 -1
  268. package/dist/components/select/foundation.d.ts +36 -10
  269. package/dist/components/select/foundation.js +105 -39
  270. package/dist/components/select/select.css +1 -4
  271. package/dist/components/select/select.scss +2 -2
  272. package/dist/components/side-sheet/side-sheet-foundation.d.ts +4 -3
  273. package/dist/components/side-sheet/side-sheet-foundation.js +7 -7
  274. package/dist/components/side-sheet/side-sheet.css +0 -4
  275. package/dist/components/side-sheet/side-sheet.scss +0 -3
  276. package/dist/components/skeleton/skeleton.css +0 -4
  277. package/dist/components/skeleton/skeleton.scss +0 -3
  278. package/dist/components/slider/foundation.d.ts +34 -1
  279. package/dist/components/slider/foundation.js +47 -5
  280. package/dist/components/slider/rtl.scss +0 -2
  281. package/dist/components/slider/slider.css +2 -4
  282. package/dist/components/slider/slider.scss +2 -0
  283. package/dist/components/space/space.css +0 -4
  284. package/dist/components/space/space.scss +0 -3
  285. package/dist/components/spin/foundation.d.ts +1 -0
  286. package/dist/components/spin/foundation.js +1 -1
  287. package/dist/components/spin/spin.css +0 -5
  288. package/dist/components/spin/spin.scss +0 -3
  289. package/dist/components/steps/fill-steps.css +1 -1
  290. package/dist/components/steps/fill-steps.scss +1 -1
  291. package/dist/components/steps/steps.css +1 -7
  292. package/dist/components/steps/steps.scss +0 -2
  293. package/dist/components/switch/foundation.d.ts +1 -0
  294. package/dist/components/switch/rtl.scss +0 -4
  295. package/dist/components/switch/switch.css +0 -4
  296. package/dist/components/table/foundation.d.ts +4 -3
  297. package/dist/components/table/foundation.js +40 -47
  298. package/dist/components/table/rtl.scss +0 -5
  299. package/dist/components/table/table.css +1 -6
  300. package/dist/components/table/table.scss +2 -1
  301. package/dist/components/table/utils.d.ts +59 -7
  302. package/dist/components/table/utils.js +90 -9
  303. package/dist/components/tabs/foundation.d.ts +1 -9
  304. package/dist/components/tabs/foundation.js +2 -30
  305. package/dist/components/tabs/rtl.scss +0 -4
  306. package/dist/components/tabs/tab-bar-foundation.d.ts +45 -0
  307. package/dist/components/tabs/tab-bar-foundation.js +94 -0
  308. package/dist/components/tabs/tabs.css +4 -6
  309. package/dist/components/tabs/tabs.scss +4 -2
  310. package/dist/components/tabs/variables.scss +1 -1
  311. package/dist/components/tag/tag.css +0 -7
  312. package/dist/components/tag/tag.scss +0 -3
  313. package/dist/components/tag-input/foundation.d.ts +37 -14
  314. package/dist/components/tag-input/foundation.js +27 -1
  315. package/dist/components/tag-input/tag-input.css +0 -4
  316. package/dist/components/tag-input/tag-input.scss +0 -3
  317. package/dist/components/time-picker/combobox-options.d.ts +69 -0
  318. package/dist/components/time-picker/combobox-options.js +98 -0
  319. package/dist/components/time-picker/foundation.d.ts +16 -3
  320. package/dist/components/time-picker/foundation.js +39 -25
  321. package/dist/components/time-picker/input-foundation.d.ts +9 -2
  322. package/dist/components/time-picker/input-foundation.js +7 -0
  323. package/dist/components/time-picker/time-picker.css +0 -6
  324. package/dist/components/time-picker/time-picker.scss +0 -3
  325. package/dist/components/time-picker/utils/index.d.ts +4 -2
  326. package/dist/components/time-picker/utils/index.js +4 -6
  327. package/dist/components/timeline/rtl.scss +0 -4
  328. package/dist/components/timeline/timeline.css +0 -4
  329. package/dist/components/toast/constants.d.ts +0 -2
  330. package/dist/components/toast/constants.js +0 -2
  331. package/dist/components/toast/toast-api-foundation.d.ts +3 -2
  332. package/dist/components/toast/toast-api-foundation.js +14 -6
  333. package/dist/components/toast/toast-foundation.d.ts +1 -0
  334. package/dist/components/toast/toast-list-foundation.d.ts +11 -29
  335. package/dist/components/toast/toast-list-foundation.js +6 -74
  336. package/dist/components/toast/toast.css +0 -4
  337. package/dist/components/toast/toast.scss +0 -3
  338. package/dist/components/tooltip/constants.d.ts +0 -6
  339. package/dist/components/tooltip/constants.js +1 -7
  340. package/dist/components/tooltip/foundation.d.ts +2 -1
  341. package/dist/components/tooltip/foundation.js +6 -5
  342. package/dist/components/tooltip/tooltip.css +1 -4
  343. package/dist/components/tooltip/tooltip.scss +0 -2
  344. package/dist/components/transfer/constants.d.ts +1 -0
  345. package/dist/components/transfer/constants.js +2 -1
  346. package/dist/components/transfer/foundation.d.ts +37 -0
  347. package/dist/components/transfer/foundation.js +42 -1
  348. package/dist/components/transfer/transfer-utils.js +1 -1
  349. package/dist/components/transfer/transfer.css +0 -4
  350. package/dist/components/transfer/transfer.scss +0 -3
  351. package/dist/components/tree/foundation.d.ts +2 -1
  352. package/dist/components/tree/foundation.js +3 -3
  353. package/dist/components/tree/rtl.scss +0 -7
  354. package/dist/components/tree/shared.d.ts +13 -7
  355. package/dist/components/tree/shared.js +9 -8
  356. package/dist/components/tree/tree-util.d.ts +37 -38
  357. package/dist/components/tree/tree-util.js +5 -5
  358. package/dist/components/tree/tree.css +0 -7
  359. package/dist/components/tree-select/constants.js +1 -1
  360. package/dist/components/tree-select/foundation.d.ts +10 -7
  361. package/dist/components/tree-select/foundation.js +18 -10
  362. package/dist/components/tree-select/tree-select.css +0 -5
  363. package/dist/components/tree-select/tree-select.scss +0 -3
  364. package/dist/components/typography/copy.d.ts +8 -0
  365. package/dist/components/typography/copy.js +11 -0
  366. package/dist/components/typography/ellipsis.d.ts +31 -0
  367. package/dist/components/typography/ellipsis.js +30 -1
  368. package/dist/components/typography/rtl.scss +0 -4
  369. package/dist/components/typography/typography.css +0 -4
  370. package/dist/components/upload/constants.js +1 -1
  371. package/dist/components/upload/foundation.d.ts +26 -0
  372. package/dist/components/upload/foundation.js +28 -3
  373. package/dist/components/upload/rtl.scss +0 -4
  374. package/dist/components/upload/upload.css +0 -4
  375. package/dist/components/upload/utils.d.ts +2 -1
  376. package/dist/components/upload/utils.js +7 -3
  377. package/dist/components/user-guide/foundation.d.ts +5 -13
  378. package/dist/components/user-guide/foundation.js +91 -39
  379. package/dist/components/video-player/constants.d.ts +3 -0
  380. package/dist/components/video-player/constants.js +13 -1
  381. package/dist/components/video-player/foundation.d.ts +5 -4
  382. package/dist/components/video-player/foundation.js +6 -2
  383. package/dist/components/video-player/progress-foundation.d.ts +1 -1
  384. package/dist/components/video-player/progress-foundation.js +2 -2
  385. package/dist/components/video-player/seek-foundation.d.ts +7 -4
  386. package/dist/components/video-player/seek-foundation.js +26 -16
  387. package/dist/components/video-player/video-player.css +10 -16
  388. package/dist/components/video-player/video-player.scss +12 -16
  389. package/dist/locale/index.d.ts +6 -0
  390. package/dist/locale/index.js +5 -0
  391. package/dist/locale/interface.d.ts +14 -5
  392. package/dist/locale/resolve-locale.d.ts +3 -3
  393. package/dist/locale/resolve-locale.js +20 -6
  394. package/dist/locale/source/en_US.js +3 -2
  395. package/dist/locale/source/zh_CN.js +3 -2
  396. package/dist/utils/a11y.d.ts +14 -11
  397. package/dist/utils/a11y.js +14 -17
  398. package/dist/utils/announcer.d.ts +0 -17
  399. package/dist/utils/announcer.js +1 -19
  400. package/dist/utils/assert-client.d.ts +1 -0
  401. package/dist/utils/assert-client.js +5 -0
  402. package/dist/utils/clipboard.d.ts +9 -1
  403. package/dist/utils/clipboard.js +25 -1
  404. package/dist/utils/date-fns-locale.d.ts +6 -0
  405. package/dist/utils/date-fns-locale.js +15 -0
  406. package/dist/utils/dom.d.ts +10 -6
  407. package/dist/utils/dom.js +17 -6
  408. package/dist/utils/focus-handover.js +2 -2
  409. package/dist/utils/index.d.ts +31 -0
  410. package/dist/utils/index.js +30 -0
  411. package/dist/utils/layer.d.ts +15 -0
  412. package/dist/utils/layer.js +38 -1
  413. package/dist/utils/zoned-time.d.ts +6 -0
  414. package/dist/utils/zoned-time.js +18 -0
  415. package/package.json +10 -7
  416. package/dist/components/anchor/rtl.scss +0 -9
  417. package/dist/components/auto-complete/rtl.scss +0 -9
  418. package/dist/components/avatar/rtl.scss +0 -11
  419. package/dist/components/backtop/rtl.scss +0 -8
  420. package/dist/components/badge/rtl.scss +0 -8
  421. package/dist/components/banner/rtl.scss +0 -8
  422. package/dist/components/breadcrumb/rtl.scss +0 -9
  423. package/dist/components/calendar/rtl.scss +0 -10
  424. package/dist/components/card/rtl.scss +0 -18
  425. package/dist/components/checkbox/rtl.scss +0 -11
  426. package/dist/components/collapse/rtl.scss +0 -8
  427. package/dist/components/descriptions/rtl.scss +0 -8
  428. package/dist/components/dropdown/rtl.scss +0 -9
  429. package/dist/components/empty/rtl.scss +0 -8
  430. package/dist/components/float-button/rtl.scss +0 -2
  431. package/dist/components/form/rtl.scss +0 -13
  432. package/dist/components/grid/rtl.scss +0 -10
  433. package/dist/components/input/rtl.scss +0 -11
  434. package/dist/components/input-number/rtl.scss +0 -9
  435. package/dist/components/layout/rtl.scss +0 -7
  436. package/dist/components/list/rtl.scss +0 -9
  437. package/dist/components/modal/rtl.scss +0 -10
  438. package/dist/components/notification/rtl.scss +0 -9
  439. package/dist/components/overflow-list/rtl.scss +0 -7
  440. package/dist/components/popover/rtl.scss +0 -9
  441. package/dist/components/radio/rtl.scss +0 -11
  442. package/dist/components/rating/rtl.scss +0 -9
  443. package/dist/components/scroll-list/rtl.scss +0 -9
  444. package/dist/components/select/rtl.scss +0 -10
  445. package/dist/components/side-sheet/rtl.scss +0 -9
  446. package/dist/components/skeleton/rtl.scss +0 -9
  447. package/dist/components/space/rtl.scss +0 -8
  448. package/dist/components/spin/rtl.scss +0 -11
  449. package/dist/components/steps/rtl.scss +0 -14
  450. package/dist/components/tag/rtl.scss +0 -12
  451. package/dist/components/tag-input/rtl.scss +0 -9
  452. package/dist/components/time-picker/combox-foundation.d.ts +0 -64
  453. package/dist/components/time-picker/combox-foundation.js +0 -96
  454. package/dist/components/time-picker/rtl.scss +0 -10
  455. package/dist/components/toast/rtl.scss +0 -9
  456. package/dist/components/tooltip/rtl.scss +0 -9
  457. package/dist/components/transfer/rtl.scss +0 -9
  458. package/dist/components/tree-select/rtl.scss +0 -9
  459. package/dist/locale/source/ar.d.ts +0 -3
  460. package/dist/locale/source/ar.js +0 -520
  461. package/dist/locale/source/az.d.ts +0 -3
  462. package/dist/locale/source/az.js +0 -520
  463. package/dist/locale/source/bg.d.ts +0 -3
  464. package/dist/locale/source/bg.js +0 -520
  465. package/dist/locale/source/bn_IN.d.ts +0 -3
  466. package/dist/locale/source/bn_IN.js +0 -520
  467. package/dist/locale/source/ca.d.ts +0 -3
  468. package/dist/locale/source/ca.js +0 -520
  469. package/dist/locale/source/ceb_PH.d.ts +0 -3
  470. package/dist/locale/source/ceb_PH.js +0 -520
  471. package/dist/locale/source/cs_CZ.d.ts +0 -3
  472. package/dist/locale/source/cs_CZ.js +0 -520
  473. package/dist/locale/source/da.d.ts +0 -3
  474. package/dist/locale/source/da.js +0 -520
  475. package/dist/locale/source/de.d.ts +0 -3
  476. package/dist/locale/source/de.js +0 -520
  477. package/dist/locale/source/el_GR.d.ts +0 -3
  478. package/dist/locale/source/el_GR.js +0 -520
  479. package/dist/locale/source/en_GB.d.ts +0 -3
  480. package/dist/locale/source/en_GB.js +0 -520
  481. package/dist/locale/source/es.d.ts +0 -3
  482. package/dist/locale/source/es.js +0 -520
  483. package/dist/locale/source/es_419.d.ts +0 -3
  484. package/dist/locale/source/es_419.js +0 -520
  485. package/dist/locale/source/et.d.ts +0 -3
  486. package/dist/locale/source/et.js +0 -520
  487. package/dist/locale/source/fa_IR.d.ts +0 -3
  488. package/dist/locale/source/fa_IR.js +0 -520
  489. package/dist/locale/source/fi_FI.d.ts +0 -3
  490. package/dist/locale/source/fi_FI.js +0 -520
  491. package/dist/locale/source/fil_PH.d.ts +0 -3
  492. package/dist/locale/source/fil_PH.js +0 -520
  493. package/dist/locale/source/fr.d.ts +0 -3
  494. package/dist/locale/source/fr.js +0 -520
  495. package/dist/locale/source/fr_CA.d.ts +0 -3
  496. package/dist/locale/source/fr_CA.js +0 -520
  497. package/dist/locale/source/ga.d.ts +0 -3
  498. package/dist/locale/source/ga.js +0 -520
  499. package/dist/locale/source/he_IL.d.ts +0 -3
  500. package/dist/locale/source/he_IL.js +0 -520
  501. package/dist/locale/source/hi_IN.d.ts +0 -3
  502. package/dist/locale/source/hi_IN.js +0 -520
  503. package/dist/locale/source/hr.d.ts +0 -3
  504. package/dist/locale/source/hr.js +0 -520
  505. package/dist/locale/source/hu_HU.d.ts +0 -3
  506. package/dist/locale/source/hu_HU.js +0 -520
  507. package/dist/locale/source/id_ID.d.ts +0 -3
  508. package/dist/locale/source/id_ID.js +0 -520
  509. package/dist/locale/source/is.d.ts +0 -3
  510. package/dist/locale/source/is.js +0 -520
  511. package/dist/locale/source/it.d.ts +0 -3
  512. package/dist/locale/source/it.js +0 -520
  513. package/dist/locale/source/ja_JP.d.ts +0 -3
  514. package/dist/locale/source/ja_JP.js +0 -520
  515. package/dist/locale/source/jv_ID.d.ts +0 -3
  516. package/dist/locale/source/jv_ID.js +0 -520
  517. package/dist/locale/source/kk.d.ts +0 -3
  518. package/dist/locale/source/kk.js +0 -520
  519. package/dist/locale/source/km_KH.d.ts +0 -3
  520. package/dist/locale/source/km_KH.js +0 -520
  521. package/dist/locale/source/ko_KR.d.ts +0 -3
  522. package/dist/locale/source/ko_KR.js +0 -520
  523. package/dist/locale/source/lt.d.ts +0 -3
  524. package/dist/locale/source/lt.js +0 -520
  525. package/dist/locale/source/lv.d.ts +0 -3
  526. package/dist/locale/source/lv.js +0 -520
  527. package/dist/locale/source/ms_MY.d.ts +0 -3
  528. package/dist/locale/source/ms_MY.js +0 -520
  529. package/dist/locale/source/my_MM.d.ts +0 -3
  530. package/dist/locale/source/my_MM.js +0 -520
  531. package/dist/locale/source/nb.d.ts +0 -3
  532. package/dist/locale/source/nb.js +0 -520
  533. package/dist/locale/source/nl_NL.d.ts +0 -3
  534. package/dist/locale/source/nl_NL.js +0 -520
  535. package/dist/locale/source/pl_PL.d.ts +0 -3
  536. package/dist/locale/source/pl_PL.js +0 -520
  537. package/dist/locale/source/pt.d.ts +0 -3
  538. package/dist/locale/source/pt.js +0 -520
  539. package/dist/locale/source/pt_BR.d.ts +0 -3
  540. package/dist/locale/source/pt_BR.js +0 -520
  541. package/dist/locale/source/ro.d.ts +0 -3
  542. package/dist/locale/source/ro.js +0 -520
  543. package/dist/locale/source/ru_RU.d.ts +0 -3
  544. package/dist/locale/source/ru_RU.js +0 -520
  545. package/dist/locale/source/sk.d.ts +0 -3
  546. package/dist/locale/source/sk.js +0 -520
  547. package/dist/locale/source/sl.d.ts +0 -3
  548. package/dist/locale/source/sl.js +0 -520
  549. package/dist/locale/source/sq.d.ts +0 -3
  550. package/dist/locale/source/sq.js +0 -520
  551. package/dist/locale/source/sv_SE.d.ts +0 -3
  552. package/dist/locale/source/sv_SE.js +0 -520
  553. package/dist/locale/source/sw.d.ts +0 -3
  554. package/dist/locale/source/sw.js +0 -520
  555. package/dist/locale/source/th_TH.d.ts +0 -3
  556. package/dist/locale/source/th_TH.js +0 -520
  557. package/dist/locale/source/tr_TR.d.ts +0 -3
  558. package/dist/locale/source/tr_TR.js +0 -520
  559. package/dist/locale/source/uk_UA.d.ts +0 -3
  560. package/dist/locale/source/uk_UA.js +0 -520
  561. package/dist/locale/source/ur.d.ts +0 -3
  562. package/dist/locale/source/ur.js +0 -520
  563. package/dist/locale/source/uz.d.ts +0 -3
  564. package/dist/locale/source/uz.js +0 -520
  565. package/dist/locale/source/vi_VN.d.ts +0 -3
  566. package/dist/locale/source/vi_VN.js +0 -520
  567. package/dist/locale/source/zh_TW.d.ts +0 -3
  568. package/dist/locale/source/zh_TW.js +0 -520
  569. package/dist/utils/is-element.d.ts +0 -1
  570. package/dist/utils/is-element.js +0 -5
package/README.md CHANGED
@@ -23,49 +23,51 @@ Build plugins need it to resolve `semi:` addresses, and the UI packages already
23
23
 
24
24
  ## Usage
25
25
 
26
- This package has no root entry. It offers only deep file paths, which map one-to-one to the directories under `src/` and come with type declarations:
26
+ This package has no root entry. The `base`, `utils` and `locale` directories each have an entry that gathers the directory's exports. Other modules are imported by deep file paths, which map one-to-one to the directories under `src/`. All come with type declarations:
27
27
 
28
28
  ```ts
29
- import BaseFoundation from '@fibrae/semi-foundation/base/foundation';
29
+ import { BaseFoundation, FocusScope } from '@fibrae/semi-foundation/base';
30
30
  import InputFoundation from '@fibrae/semi-foundation/components/input/foundation';
31
- import type { Locale } from '@fibrae/semi-foundation/locale/interface';
32
- import en_GB from '@fibrae/semi-foundation/locale/source/en_GB';
31
+ import type { Locale } from '@fibrae/semi-foundation/locale';
33
32
  import { utcToZonedTime } from '@fibrae/semi-foundation/utils/date-fns-extra';
34
33
  ```
35
34
 
35
+ The `utils` entry leaves out the date modules (`date-fns-extra`, `date-fns-locale`, `zoned-time`), and the `base` entry leaves out `base/env`. Import those by deep path.
36
+
36
37
  `exports` also includes `./*.css` and `./*.scss`. The component CSS is compiled by `vp pack`. The published `.scss` contains `semi:` addresses and cannot be compiled by Sass directly; it goes through a build plugin or `@fibrae/semi-scss-compile`.
37
38
 
38
39
  ## Directories
39
40
 
40
- | Directory | Contents |
41
- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
42
- | `components/` | One directory per component, containing `foundation.ts`, `constants.ts` and `*.scss` as needed (`variables.scss`, `mixin.scss`, `rtl.scss` and similar ship only as source) |
43
- | `base/` | `BaseFoundation`, common constants and the stateful classes a foundation composes (focus scope, popup lifecycle, modal resources and similar) |
44
- | `utils/` | Stateless utilities: DOM, date, focus helpers, layer stack and similar |
45
- | `theme/` | The one theme: global tokens, palettes and mixins, loaded by component SCSS through `semi:theme` |
46
- | `locale/` | Locale packs and the `Locale` type |
41
+ | Directory | Contents |
42
+ | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
43
+ | `components/` | One directory per component, containing `foundation.ts`, `constants.ts` and `*.scss` as needed (`variables.scss`, `mixin.scss` and similar ship only as source) |
44
+ | `base/` | `BaseFoundation`, common constants and the stateful classes a foundation composes (focus scope, popup lifecycle, modal resources and similar) |
45
+ | `utils/` | Stateless utilities: DOM, date, focus helpers, layer stack and similar |
46
+ | `theme/` | The one theme: global tokens, palettes and mixins, loaded by component SCSS through `semi:theme` |
47
+ | `locale/` | Locale packs, the `Locale` and `LocaleInput` types and the locale resolution shared by every framework |
47
48
 
48
49
  ## Locale packs
49
50
 
50
- `src/locale/source/` holds 57 locale packs. Each file default-exports a `Locale`, whose type is in `src/locale/interface.ts`:
51
+ `src/locale/source/` holds the two built-in packs, `zh_CN` and `en_US`. Each file default-exports a `Locale`. `src/locale/index.ts` exports both packs and the `Locale`, `LocaleInput`, `LocaleComponentName` and `LocaleResult` types, and other packages import from `@fibrae/semi-foundation/locale`:
51
52
 
52
- - `code`: the language code.
53
- - `dateFnsLocale`: the date-fns locale object used to format and parse dates.
53
+ - `code`: the language code. Date components pick their date-fns locale by it (`src/utils/date-fns-locale.ts` builds in only zh-CN and en-US; others come from ConfigProvider's `dateFnsLocale`).
54
54
  - `currency`: the ISO 4217 currency code, passed by InputNumber to `Intl.NumberFormat`.
55
55
  - The other keys are grouped by component and hold built-in text and accessible names. Values with `${name}` are placeholders; do not translate the placeholder itself.
56
56
 
57
- To use a pack, pass it to the UI package's `LocaleProvider`:
57
+ Every UI package exports `zh_CN` and `en_US` from its `locale` entry. Pass one to the UI package's `LocaleProvider` or `ConfigProvider`:
58
58
 
59
59
  ```tsx
60
60
  import { LocaleProvider } from '@fibrae/semi-ui-react';
61
- import en_GB from '@fibrae/semi-ui-react/locale/source/en_GB';
61
+ import { en_US } from '@fibrae/semi-ui-react/locale';
62
62
 
63
- <LocaleProvider locale={en_GB}>
63
+ <LocaleProvider locale={en_US}>
64
64
  <App />
65
65
  </LocaleProvider>;
66
66
  ```
67
67
 
68
- The Vue package's `LocaleProvider` has the same name and takes `:locale`. For adding text or accessible names and filling in every locale pack, see [locale-text](../../../.agents/skills/locale-text/SKILL.md).
68
+ Both providers also take a custom pack typed `LocaleInput`: only `code` is required, and every text or `currency` it leaves out comes from `en_US`. `src/locale/resolve-locale.ts` fills the gaps once per pack object and reuses the result, so create the pack once (at module level or memoized) and replace it rather than mutating it in place.
69
+
70
+ The Vue package's `LocaleProvider` has the same name and takes `:locale`. For adding text or accessible names to both built-in packs, see [locale-text](../../../.agents/skills/locale-text/SKILL.md).
69
71
 
70
72
  ## Related packages
71
73
 
package/README.zh-CN.md CHANGED
@@ -23,49 +23,51 @@ pnpm add @fibrae/semi-foundation
23
23
 
24
24
  ## 使用
25
25
 
26
- 本包没有根入口,只提供逐文件的深路径,与 `src/` 下的目录一一对应,同时提供类型声明:
26
+ 本包没有根入口。`base`、`utils`、`locale` 三个目录各有一个入口,汇总该目录的导出;其余模块按逐文件的深路径导入,与 `src/` 下的目录一一对应。都提供类型声明:
27
27
 
28
28
  ```ts
29
- import BaseFoundation from '@fibrae/semi-foundation/base/foundation';
29
+ import { BaseFoundation, FocusScope } from '@fibrae/semi-foundation/base';
30
30
  import InputFoundation from '@fibrae/semi-foundation/components/input/foundation';
31
- import type { Locale } from '@fibrae/semi-foundation/locale/interface';
32
- import en_GB from '@fibrae/semi-foundation/locale/source/en_GB';
31
+ import type { Locale } from '@fibrae/semi-foundation/locale';
33
32
  import { utcToZonedTime } from '@fibrae/semi-foundation/utils/date-fns-extra';
34
33
  ```
35
34
 
35
+ `utils` 入口不含日期模块(`date-fns-extra`、`date-fns-locale`、`zoned-time`),`base` 入口不含 `base/env`,它们只按深路径导入。
36
+
36
37
  `exports` 还包含 `./*.css` 与 `./*.scss`:组件 CSS 是 `vp pack` 编译的产物;发布的 `.scss` 含有 `semi:` 地址,不能直接用 Sass 编译,需要经构建插件或 `@fibrae/semi-scss-compile`。
37
38
 
38
39
  ## 目录
39
40
 
40
- | 目录 | 内容 |
41
- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
42
- | `components/` | 每个组件一个目录,按需包含 `foundation.ts`、`constants.ts` 与 `*.scss`(`variables.scss`、`mixin.scss`、`rtl.scss` 等只按源文件发布) |
43
- | `base/` | `BaseFoundation`、通用常量,以及 foundation 组合使用的有状态类(焦点范围、弹层生命周期、模态资源等) |
44
- | `utils/` | 无状态工具:DOM、日期、焦点辅助、层栈等 |
45
- | `theme/` | 唯一的主题:全局 token、色板、mixin,组件 SCSS 经 `semi:theme` 加载 |
46
- | `locale/` | 语言包与 `Locale` 类型 |
41
+ | 目录 | 内容 |
42
+ | ------------- | ------------------------------------------------------------------------------------------------------------------------- |
43
+ | `components/` | 每个组件一个目录,按需包含 `foundation.ts`、`constants.ts` 与 `*.scss`(`variables.scss`、`mixin.scss` 等只按源文件发布) |
44
+ | `base/` | `BaseFoundation`、通用常量,以及 foundation 组合使用的有状态类(焦点范围、弹层生命周期、模态资源等) |
45
+ | `utils/` | 无状态工具:DOM、日期、焦点辅助、层栈等 |
46
+ | `theme/` | 唯一的主题:全局 token、色板、mixin,组件 SCSS 经 `semi:theme` 加载 |
47
+ | `locale/` | 语言包、`Locale` 与 `LocaleInput` 类型,以及各框架共用的语言解析 |
47
48
 
48
49
  ## 语言包
49
50
 
50
- `src/locale/source/` 下有 57 个语言包,每个文件默认导出一个 `Locale`,类型在 `src/locale/interface.ts`:
51
+ `src/locale/source/` 下有 `zh_CN`、`en_US` 两个内置语言包,每个文件默认导出一个 `Locale`。`src/locale/index.ts` 统一导出两个语言包与 `Locale`、`LocaleInput`、`LocaleComponentName`、`LocaleResult` 类型,其他包从 `@fibrae/semi-foundation/locale` 导入:
51
52
 
52
- - `code`:语言代码。
53
- - `dateFnsLocale`:格式化和解析日期时使用的 date-fns locale 对象。
53
+ - `code`:语言代码。日期组件按它取 date-fns locale(`src/utils/date-fns-locale.ts` 只内置 zh-CN、en-US,其余由 ConfigProvider 的 `dateFnsLocale` 传入)。
54
54
  - `currency`:ISO 4217 货币代码,InputNumber 传给 `Intl.NumberFormat`。
55
55
  - 其余键按组件分组,是组件的内置文案和可访问名称。含 `${名字}` 的值是占位符,翻译时不要替换占位符本身。
56
56
 
57
- 使用时把语言包传给 UI 包的 `LocaleProvider`:
57
+ 各 UI 包的 `locale` 入口导出 `zh_CN`、`en_US`,传给 UI 包的 `LocaleProvider` 或 `ConfigProvider`:
58
58
 
59
59
  ```tsx
60
60
  import { LocaleProvider } from '@fibrae/semi-ui-react';
61
- import en_GB from '@fibrae/semi-ui-react/locale/source/en_GB';
61
+ import { en_US } from '@fibrae/semi-ui-react/locale';
62
62
 
63
- <LocaleProvider locale={en_GB}>
63
+ <LocaleProvider locale={en_US}>
64
64
  <App />
65
65
  </LocaleProvider>;
66
66
  ```
67
67
 
68
- Vue 包的 `LocaleProvider` 同名,通过 `:locale` 传入。新增文案或可访问名称、补齐全部语言包的步骤见 [locale-text](../../../.agents/skills/locale-text/SKILL.md)。
68
+ 两个 provider 也接受 `LocaleInput` 类型的自定义语言包:只有 `code` 必填,没写的文案和 `currency` 取 `en_US`。`src/locale/resolve-locale.ts` 对同一个语言包对象只补齐一次并复用结果,所以语言包只创建一次(放在模块顶层或做 memo),要改就换一个新对象,不要原地修改。
69
+
70
+ Vue 包的 `LocaleProvider` 同名,通过 `:locale` 传入。给两个内置语言包新增文案或可访问名称的步骤见 [locale-text](../../../.agents/skills/locale-text/SKILL.md)。
69
71
 
70
72
  ## 与其他包的关系
71
73
 
@@ -19,26 +19,19 @@ export interface AutoCloseListState {
19
19
  id?: string;
20
20
  }[];
21
21
  }
22
- /** Closes a toast or notice after `duration`; the list pauses the countdown on hover and restarts it after */
22
+ /** Closes a toast or notice after `duration`; its list pauses the countdown on hover and restarts it on an update */
23
23
  export default class AutoCloseFoundation<P extends AutoCloseBaseProps = AutoCloseBaseProps, S = Record<string, never>, A extends AutoCloseAdapter<P, S> = AutoCloseAdapter<P, S>> extends BaseFoundation<A, P, S> {
24
24
  #private;
25
25
  init(): void;
26
26
  destroy(): void;
27
27
  isLeaving: () => boolean;
28
- leave: () => void;
29
- pauseCloseTimer: () => void;
30
- resumeCloseTimer: () => void;
31
28
  /**
32
29
  * Follows the list: pauses while it is hovered or focused, stops when the store removed this item from outside (the
33
30
  * countdown must not call onClose during the leave), and restarts when the store updated it in place. The first call
34
- * only applies the state the item mounted into; hosts may call it before or after init(). Returns whether this call
35
- * saw this item updated, so the host can follow up (announce it).
31
+ * only applies the state the item mounted into; hosts may call it before or after init().
36
32
  */
37
- handleListChange: (list: AutoCloseListState) => boolean;
38
- startCloseTimer(): void;
33
+ handleListChange: (list: AutoCloseListState) => void;
39
34
  close: (e?: {
40
35
  stopPropagation: () => void;
41
36
  }) => void;
42
- clearCloseTimer(): void;
43
- restartCloseTimer: () => void;
44
37
  }
@@ -1,8 +1,9 @@
1
1
  import BaseFoundation from "./foundation.js";
2
+ import { ResetTimer } from "./reset-timer.js";
2
3
  // src/base/auto-close-foundation.ts
3
- /** Closes a toast or notice after `duration`; the list pauses the countdown on hover and restarts it after */
4
+ /** Closes a toast or notice after `duration`; its list pauses the countdown on hover and restarts it on an update */
4
5
  var AutoCloseFoundation = class extends BaseFoundation {
5
- #timer = null;
6
+ #timer = new ResetTimer();
6
7
  #id = null;
7
8
  #paused = false;
8
9
  #leaving = false;
@@ -11,70 +12,48 @@ var AutoCloseFoundation = class extends BaseFoundation {
11
12
  const id = this.getProp("id");
12
13
  return items.some((item) => item.id === id);
13
14
  }
15
+ #startCloseTimer() {
16
+ this.#timer.clear();
17
+ const duration = this.getProp("duration");
18
+ if (!this.#leaving && !this.#paused && duration && typeof duration === "number") this.#timer.start(duration * 1e3, () => this.close());
19
+ }
14
20
  init() {
15
- this.startCloseTimer();
21
+ this.#timer.mount();
22
+ this.#startCloseTimer();
16
23
  this.#id = this.getProp("id");
17
24
  }
18
25
  destroy() {
19
- this.clearCloseTimer();
26
+ this.#timer.unmount();
20
27
  }
21
28
  isLeaving = () => this.#leaving;
22
- leave = () => {
23
- this.#leaving = true;
24
- this.clearCloseTimer();
25
- };
26
- pauseCloseTimer = () => {
27
- this.#paused = true;
28
- this.clearCloseTimer();
29
- };
30
- resumeCloseTimer = () => {
31
- this.#paused = false;
32
- this.startCloseTimer();
33
- };
34
29
  /**
35
30
  * Follows the list: pauses while it is hovered or focused, stops when the store removed this item from outside (the
36
31
  * countdown must not call onClose during the leave), and restarts when the store updated it in place. The first call
37
- * only applies the state the item mounted into; hosts may call it before or after init(). Returns whether this call
38
- * saw this item updated, so the host can follow up (announce it).
32
+ * only applies the state the item mounted into; hosts may call it before or after init().
39
33
  */
40
34
  handleListChange = (list) => {
41
35
  const prev = this.#list;
42
36
  this.#list = list;
43
37
  if (list.paused !== (prev?.paused ?? false)) {
44
- if (list.paused) this.pauseCloseTimer();
45
- else this.resumeCloseTimer();
38
+ this.#paused = list.paused;
39
+ this.#startCloseTimer();
40
+ }
41
+ if (list.removedItems && list.removedItems !== prev?.removedItems && this.#includesThis(list.removedItems)) {
42
+ this.#leaving = true;
43
+ this.#timer.clear();
46
44
  }
47
- if (list.removedItems && list.removedItems !== prev?.removedItems && this.#includesThis(list.removedItems)) this.leave();
48
45
  if (prev && list.updatedItems !== prev.updatedItems && this.#includesThis(list.updatedItems)) {
49
- this.restartCloseTimer();
50
- return true;
46
+ this.#leaving = false;
47
+ this.#startCloseTimer();
51
48
  }
52
- return false;
53
49
  };
54
- startCloseTimer() {
55
- this.clearCloseTimer();
56
- const duration = this.getProp("duration");
57
- if (!this.#leaving && !this.#paused && duration && typeof duration === "number") this.#timer = setTimeout(() => {
58
- this.close();
59
- }, duration * 1e3);
60
- }
61
50
  close = (e) => {
62
51
  e?.stopPropagation();
63
52
  if (this.#leaving) return;
64
53
  this.#leaving = true;
65
- this.clearCloseTimer();
54
+ this.#timer.clear();
66
55
  this.adapter.notifyWrapperToRemove(this.#id);
67
56
  this.adapter.notifyClose();
68
57
  };
69
- clearCloseTimer() {
70
- if (this.#timer) {
71
- clearTimeout(this.#timer);
72
- this.#timer = null;
73
- }
74
- }
75
- restartCloseTimer = () => {
76
- this.#leaving = false;
77
- this.startCloseTimer();
78
- };
79
58
  };
80
59
  export { AutoCloseFoundation as default };
@@ -1,5 +1,6 @@
1
1
  import { BASE_CLASS_PREFIX } from "./env.js";
2
2
  export declare const VALIDATE_STATUS: readonly ["default", "error", "warning", "success"];
3
+ export type ValidateStatus = (typeof VALIDATE_STATUS)[number];
3
4
  declare const instanceIdKeyList: readonly ["id", "insetLabelId", "wrapperId", "addonId", "extraId"];
4
5
  export type InstanceIdKey = (typeof instanceIdKeyList)[number];
5
6
  export type GlobalDefaults<P> = P extends unknown ? Partial<Omit<P, InstanceIdKey>> : never;
@@ -1,4 +1,4 @@
1
- import isElement from "../utils/is-element.js";
1
+ import { isHTMLElement } from "../utils/dom.js";
2
2
  import { tabbable } from "tabbable";
3
3
  // src/base/focus-handle.ts
4
4
  var FocusTrapHandle = class FocusTrapHandle {
@@ -37,7 +37,7 @@ var FocusTrapHandle = class FocusTrapHandle {
37
37
  if (isFirstCurrentFocus) this.#focusElement(redirectForcingElement, event);
38
38
  }
39
39
  static getFocusableElements(node) {
40
- return isElement(node) ? tabbable(node, { displayCheck: "full-native" }) : [];
40
+ return isHTMLElement(node) ? tabbable(node, { displayCheck: "full-native" }) : [];
41
41
  }
42
42
  /**
43
43
  * The focused element as the tree of `scope` sees it, the document without one. Comparing it with nodes of that
@@ -1,25 +1,6 @@
1
+ import { popupTriggers } from "../utils/layer.js";
1
2
  import FocusTrapHandle from "./focus-handle.js";
2
- import { POPUP_SELECTOR } from "../components/tooltip/constants.js";
3
- import { getPopupTrigger } from "../utils/a11y.js";
4
3
  // src/base/focus-scope.ts
5
- function closestPopup(element) {
6
- for (let current = element; current; current = current.getRootNode().host ?? null) {
7
- const popup = current.closest(`${POPUP_SELECTOR}[id]`);
8
- if (popup) return popup;
9
- }
10
- return null;
11
- }
12
- /** The triggers of the Tooltip-family popups around `element`, innermost first (D5 markup, see tooltip constants) */
13
- function popupTriggers(element) {
14
- const triggers = [];
15
- for (let popup = closestPopup(element); popup;) {
16
- const trigger = getPopupTrigger(popup.id, popup.getRootNode());
17
- if (!trigger) break;
18
- triggers.push(trigger);
19
- popup = closestPopup(trigger);
20
- }
21
- return triggers;
22
- }
23
4
  const canTakeFocus = (element) => element?.isConnected && !element.matches(":disabled") && element.checkVisibility();
24
5
  /**
25
6
  * Focus handling of a modal overlay (APG dialog pattern): remember the focused element when the overlay opens, move
@@ -17,7 +17,6 @@ export interface DefaultAdapter<P = Record<string, any>, S = Record<string, any>
17
17
  }
18
18
  /** The context type an adapter declares; `unknown` for a foundation that does not read context */
19
19
  export type ContextOf<T> = T extends DefaultAdapter<any, any, infer C> ? C : never;
20
- export type HostContext<A> = unknown extends ContextOf<A> ? ([keyof ContextOf<A>] extends [never] ? any : ContextOf<A>) : ContextOf<A>;
21
20
  export interface DirectionContext {
22
21
  direction?: 'ltr' | 'rtl';
23
22
  }
@@ -0,0 +1,21 @@
1
+ export interface HookApi<O> {
2
+ success: (config: O) => string;
3
+ info: (config: O) => string;
4
+ error: (config: O) => string;
5
+ warning: (config: O) => string;
6
+ open: (config: O) => string;
7
+ close: (id: string) => void;
8
+ }
9
+ export interface HookApiOptions {
10
+ /** Read on every call, so a context provider that changes the defaults takes effect */
11
+ readGlobalDefaults: () => object;
12
+ /** Runs before every call; a host that mounts its list lazily does it here */
13
+ beforeAdd?: () => void;
14
+ }
15
+ interface HookApiStore {
16
+ open(opts: object, globalDefaults: object): string;
17
+ remove(id: string): void;
18
+ }
19
+ /** The api of `useToast` and `useNotification` over one list store; `O` is the framework's options */
20
+ export declare function createHookApi<O extends object>(store: HookApiStore, { readGlobalDefaults, beforeAdd }: HookApiOptions): HookApi<O>;
21
+ export {};
@@ -0,0 +1,20 @@
1
+ // src/base/hook-api.ts
2
+ /** The api of `useToast` and `useNotification` over one list store; `O` is the framework's options */
3
+ function createHookApi(store, { readGlobalDefaults, beforeAdd }) {
4
+ const add = (config, type) => {
5
+ beforeAdd?.();
6
+ return store.open({
7
+ ...config,
8
+ type
9
+ }, readGlobalDefaults());
10
+ };
11
+ return {
12
+ success: (config) => add(config, "success"),
13
+ info: (config) => add(config, "info"),
14
+ error: (config) => add(config, "error"),
15
+ warning: (config) => add(config, "warning"),
16
+ open: (config) => add(config, "default"),
17
+ close: (id) => store.remove(id)
18
+ };
19
+ }
20
+ export { createHookApi };
@@ -0,0 +1,14 @@
1
+ import AutoCloseFoundation, { AutoCloseAdapter, AutoCloseBaseProps, AutoCloseListState } from "./auto-close-foundation.js";
2
+ import { GlobalDefaults, InstanceIdKey, VALIDATE_STATUS, ValidateStatus, omitInstanceIds } from "./constants.js";
3
+ import { BASE_CLASS_PREFIX } from "./env.js";
4
+ import FocusTrapHandle from "./focus-handle.js";
5
+ import FocusScope from "./focus-scope.js";
6
+ import BaseFoundation, { ContextOf, DefaultAdapter, DirectionContext, Lifecycle, PropReactions, createPropsTracker } from "./foundation.js";
7
+ import { HookApi, HookApiOptions, createHookApi } from "./hook-api.js";
8
+ import ListStore, { FreshItems, ListStoreItem, ListStoreState, getStackDepths, hasLostFocus, isAlertType, isStackExpanded, isStackHidden, readNoticeText } from "./list-store.js";
9
+ import ModalResources, { ModalHold } from "./modal-resources.js";
10
+ import PopupLifecycle from "./popup-lifecycle.js";
11
+ import ReleaseHolder from "./release-holder.js";
12
+ import { ResetTimer } from "./reset-timer.js";
13
+ import StaticListWrapper from "./static-list-wrapper.js";
14
+ export { AutoCloseAdapter, AutoCloseBaseProps, AutoCloseFoundation, AutoCloseListState, BASE_CLASS_PREFIX, BaseFoundation, ContextOf, DefaultAdapter, DirectionContext, FocusScope, FocusTrapHandle, FreshItems, GlobalDefaults, HookApi, HookApiOptions, InstanceIdKey, Lifecycle, ListStore, ListStoreItem, ListStoreState, ModalHold, ModalResources, PopupLifecycle, PropReactions, ReleaseHolder, ResetTimer, StaticListWrapper, VALIDATE_STATUS, ValidateStatus, createHookApi, createPropsTracker, getStackDepths, hasLostFocus, isAlertType, isStackExpanded, isStackHidden, omitInstanceIds, readNoticeText };
@@ -0,0 +1,14 @@
1
+ import AutoCloseFoundation from "./auto-close-foundation.js";
2
+ import { VALIDATE_STATUS, omitInstanceIds } from "./constants.js";
3
+ import FocusTrapHandle from "./focus-handle.js";
4
+ import { BASE_CLASS_PREFIX } from "./env.js";
5
+ import FocusScope from "./focus-scope.js";
6
+ import BaseFoundation, { createPropsTracker } from "./foundation.js";
7
+ import { createHookApi } from "./hook-api.js";
8
+ import ListStore, { FreshItems, getStackDepths, hasLostFocus, isAlertType, isStackExpanded, isStackHidden, readNoticeText } from "./list-store.js";
9
+ import ModalResources from "./modal-resources.js";
10
+ import PopupLifecycle from "./popup-lifecycle.js";
11
+ import ReleaseHolder from "./release-holder.js";
12
+ import { ResetTimer } from "./reset-timer.js";
13
+ import StaticListWrapper from "./static-list-wrapper.js";
14
+ export { AutoCloseFoundation, BASE_CLASS_PREFIX, BaseFoundation, FocusScope, FocusTrapHandle, FreshItems, ListStore, ModalResources, PopupLifecycle, ReleaseHolder, ResetTimer, StaticListWrapper, VALIDATE_STATUS, createHookApi, createPropsTracker, getStackDepths, hasLostFocus, isAlertType, isStackExpanded, isStackHidden, omitInstanceIds, readNoticeText };
@@ -1,25 +1,65 @@
1
+ export interface ListStoreItem {
2
+ id?: string;
3
+ type?: string;
4
+ stack?: boolean | number;
5
+ }
1
6
  export interface ListStoreState<T> {
7
+ items: T[];
2
8
  removedItems: T[];
3
9
  updatedItems: T[];
4
10
  order: string[];
11
+ /** How many items show before the list stacks, as the latest `open` asked; 0 never stacks */
12
+ stack: number;
5
13
  }
6
14
  /**
7
15
  * The items of one Toast or Notification list, read by the list through subscribe and getSnapshot
8
16
  * (useSyncExternalStore). Every change publishes a new state object, so a snapshot never changes after it is read.
9
- * `key` names the field of the shown items: each store's state type exposes it under its own public name.
17
+ * `defaults` are the options of the static API that owns the list.
10
18
  */
11
- export default class ListStore<T extends {
12
- id?: string;
13
- }, K extends string, S extends ListStoreState<T> & Record<K, T[]>> {
19
+ export default class ListStore<I extends ListStoreItem> {
14
20
  #private;
15
- constructor(key: K, insertAt: 'start' | 'end', initialState: S);
21
+ defaults: I;
22
+ constructor(insertAt: 'start' | 'end', idPrefix: string, defaults: I);
16
23
  subscribe: (listener: () => void) => () => void;
17
- getSnapshot: () => S;
18
- /** Publishes a change; `updatedItems` is reset unless the change carries it */
19
- set(state: Partial<S>): void;
20
- /** Shows an item at the `insertAt` end, or updates the shown one with the same id in place */
21
- add(item: T): void;
22
- remove(id: string): void;
23
- finishLeave(id: string): void;
24
- clear(): void;
24
+ getSnapshot: () => ListStoreState<I & {
25
+ id: string;
26
+ }>;
27
+ /**
28
+ * Shows an item with `opts` over the list's defaults and the global defaults, which is where the global defaults
29
+ * take effect: an explicit undefined replaces nothing. The item goes to the `insertAt` end, or updates the shown one
30
+ * with the same id in place. `beforeShow` gets the merged options before the item is added, so a static API can
31
+ * place its wrapper by them. Returns the id.
32
+ */
33
+ open: (opts: I, globalDefaults: Partial<I>, beforeShow?: (merged: I) => void) => string;
34
+ remove: (id: string) => void;
35
+ finishLeave: (id: string) => void;
36
+ clear: () => void;
37
+ }
38
+ /** Whether the stack shows every item flat: no stacking, opened by hover or focus, or no more items than the threshold */
39
+ export declare function isStackExpanded(stack: number, opened: boolean, shownCount: number): boolean;
40
+ /** Whether a collapsed stack hides the item that `depth` shown items are newer than */
41
+ export declare function isStackHidden(expanded: boolean, depth: number): boolean;
42
+ /**
43
+ * How many shown items are newer than each item, keyed by id; `ids` run newest first. Leaving items are not counted,
44
+ * or the ones behind them would sink and spring back when they go.
45
+ */
46
+ export declare function getStackDepths(ids: readonly string[], shown: ReadonlySet<string>): Map<string, number>;
47
+ /** The focus was inside `list` but its item unmounted, which fires no reliable blur and would keep the list paused */
48
+ export declare function hasLostFocus(focusInside: boolean, list?: Element | null): boolean;
49
+ /**
50
+ * Whether a Toast or Notification of this type is an alert, which its own `role="alert"` announces; the list's
51
+ * announcer skips it so it is not read twice.
52
+ */
53
+ export declare function isAlertType(type?: string): type is "error" | "warning";
54
+ /** What an item announces: its title and content (`.${prefixCls}-title`, `.${prefixCls}-content`), without the icon and close button */
55
+ export declare function readNoticeText(item: Element | null | undefined, prefixCls: string): string;
56
+ /** Picks what a list announces: the items new since the previous call or updated in place, alerts excepted */
57
+ export declare class FreshItems {
58
+ #private;
59
+ pick<T extends {
60
+ id: string;
61
+ type?: string;
62
+ }>(items: readonly T[], updatedItems: readonly {
63
+ id?: string;
64
+ }[]): T[];
25
65
  }