@finhay-pro/leaf-design-system 0.2.3 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +454 -182
  2. package/dist/accordion.css +142 -0
  3. package/dist/avatar.css +168 -0
  4. package/dist/badge.css +193 -0
  5. package/dist/breadcrumb.css +105 -0
  6. package/dist/button.css +221 -0
  7. package/dist/calendar.css +487 -0
  8. package/dist/carousel.css +159 -0
  9. package/dist/cdn/leaf-0.2.4.min.css +2 -0
  10. package/dist/cdn/leaf-0.2.4.min.js +177 -0
  11. package/dist/checkbox.css +140 -0
  12. package/dist/classes.css +7924 -0
  13. package/dist/color.css +260 -0
  14. package/dist/components/Accordion/Accordion.d.ts +43 -0
  15. package/dist/components/Accordion/Accordion.d.ts.map +1 -0
  16. package/dist/components/Accordion/Accordion.js +37 -0
  17. package/dist/components/Accordion/Accordion.js.map +1 -0
  18. package/dist/components/Accordion/index.d.ts +2 -0
  19. package/dist/components/Accordion/index.d.ts.map +1 -0
  20. package/dist/components/Accordion/index.js +2 -0
  21. package/dist/components/Accordion/index.js.map +1 -0
  22. package/dist/components/Avatar/Avatar.d.ts +32 -0
  23. package/dist/components/Avatar/Avatar.d.ts.map +1 -0
  24. package/dist/components/Avatar/Avatar.js +20 -0
  25. package/dist/components/Avatar/Avatar.js.map +1 -0
  26. package/dist/components/Avatar/index.d.ts +2 -0
  27. package/dist/components/Avatar/index.d.ts.map +1 -0
  28. package/dist/components/Avatar/index.js +2 -0
  29. package/dist/components/Avatar/index.js.map +1 -0
  30. package/dist/components/Badge/Badge.d.ts +44 -0
  31. package/dist/components/Badge/Badge.d.ts.map +1 -0
  32. package/dist/components/Badge/Badge.js +21 -0
  33. package/dist/components/Badge/Badge.js.map +1 -0
  34. package/dist/components/Badge/index.d.ts +2 -0
  35. package/dist/components/Badge/index.d.ts.map +1 -0
  36. package/dist/components/Badge/index.js +2 -0
  37. package/dist/components/Badge/index.js.map +1 -0
  38. package/dist/components/Breadcrumb/Breadcrumb.d.ts +33 -0
  39. package/dist/components/Breadcrumb/Breadcrumb.d.ts.map +1 -0
  40. package/dist/components/Breadcrumb/Breadcrumb.js +60 -0
  41. package/dist/components/Breadcrumb/Breadcrumb.js.map +1 -0
  42. package/dist/components/Breadcrumb/index.d.ts +2 -0
  43. package/dist/components/Breadcrumb/index.d.ts.map +1 -0
  44. package/dist/components/Breadcrumb/index.js +2 -0
  45. package/dist/components/Breadcrumb/index.js.map +1 -0
  46. package/dist/components/Button/Button.js +1 -1
  47. package/dist/components/Calendar/Calendar.js +1 -1
  48. package/dist/components/CalendarRange/CalendarRange.d.ts +41 -0
  49. package/dist/components/CalendarRange/CalendarRange.d.ts.map +1 -0
  50. package/dist/components/CalendarRange/CalendarRange.js +74 -0
  51. package/dist/components/CalendarRange/CalendarRange.js.map +1 -0
  52. package/dist/components/CalendarRange/index.d.ts +2 -0
  53. package/dist/components/CalendarRange/index.d.ts.map +1 -0
  54. package/dist/components/CalendarRange/index.js +2 -0
  55. package/dist/components/CalendarRange/index.js.map +1 -0
  56. package/dist/components/Carousel/Carousel.d.ts +23 -3
  57. package/dist/components/Carousel/Carousel.d.ts.map +1 -1
  58. package/dist/components/Carousel/Carousel.js +30 -8
  59. package/dist/components/Carousel/Carousel.js.map +1 -1
  60. package/dist/components/Date/Date.d.ts +1 -1
  61. package/dist/components/Date/Date.d.ts.map +1 -1
  62. package/dist/components/Date/Date.js +2 -2
  63. package/dist/components/Date/Date.js.map +1 -1
  64. package/dist/components/Dialog/Dialog.d.ts +29 -3
  65. package/dist/components/Dialog/Dialog.d.ts.map +1 -1
  66. package/dist/components/Dialog/Dialog.js +40 -7
  67. package/dist/components/Dialog/Dialog.js.map +1 -1
  68. package/dist/components/Dialog/Drawer.d.ts +18 -0
  69. package/dist/components/Dialog/Drawer.d.ts.map +1 -0
  70. package/dist/components/Dialog/Drawer.js +12 -0
  71. package/dist/components/Dialog/Drawer.js.map +1 -0
  72. package/dist/components/Dialog/index.d.ts +2 -1
  73. package/dist/components/Dialog/index.d.ts.map +1 -1
  74. package/dist/components/Dialog/index.js +2 -1
  75. package/dist/components/Dialog/index.js.map +1 -1
  76. package/dist/components/Dropdown/Dropdown.d.ts +15 -1
  77. package/dist/components/Dropdown/Dropdown.d.ts.map +1 -1
  78. package/dist/components/Dropdown/Dropdown.js +106 -20
  79. package/dist/components/Dropdown/Dropdown.js.map +1 -1
  80. package/dist/components/FileViewer/FileViewer.d.ts +3 -1
  81. package/dist/components/FileViewer/FileViewer.d.ts.map +1 -1
  82. package/dist/components/FileViewer/FileViewer.js +2 -1
  83. package/dist/components/FileViewer/FileViewer.js.map +1 -1
  84. package/dist/components/Form/DynamicForm.js +1 -1
  85. package/dist/components/Form/Form.js +1 -1
  86. package/dist/components/Input/Input.d.ts.map +1 -1
  87. package/dist/components/Input/Input.js +3 -1
  88. package/dist/components/Input/Input.js.map +1 -1
  89. package/dist/components/Input/InputDate.d.ts +6 -1
  90. package/dist/components/Input/InputDate.d.ts.map +1 -1
  91. package/dist/components/Input/InputDate.js +36 -11
  92. package/dist/components/Input/InputDate.js.map +1 -1
  93. package/dist/components/Input/InputDateRange.d.ts +43 -0
  94. package/dist/components/Input/InputDateRange.d.ts.map +1 -0
  95. package/dist/components/Input/InputDateRange.js +86 -0
  96. package/dist/components/Input/InputDateRange.js.map +1 -0
  97. package/dist/components/Input/InputNumber.d.ts +28 -0
  98. package/dist/components/Input/InputNumber.d.ts.map +1 -0
  99. package/dist/components/Input/InputNumber.js +58 -0
  100. package/dist/components/Input/InputNumber.js.map +1 -0
  101. package/dist/components/Input/InputOtp.d.ts.map +1 -1
  102. package/dist/components/Input/InputOtp.js +2 -2
  103. package/dist/components/Input/InputOtp.js.map +1 -1
  104. package/dist/components/Input/InputStepper.d.ts +3 -1
  105. package/dist/components/Input/InputStepper.d.ts.map +1 -1
  106. package/dist/components/Input/InputStepper.js +32 -5
  107. package/dist/components/Input/InputStepper.js.map +1 -1
  108. package/dist/components/Input/index.d.ts +2 -0
  109. package/dist/components/Input/index.d.ts.map +1 -1
  110. package/dist/components/Input/index.js +2 -0
  111. package/dist/components/Input/index.js.map +1 -1
  112. package/dist/components/Menu/Menu.d.ts +69 -0
  113. package/dist/components/Menu/Menu.d.ts.map +1 -0
  114. package/dist/components/Menu/Menu.js +140 -0
  115. package/dist/components/Menu/Menu.js.map +1 -0
  116. package/dist/components/Menu/index.d.ts +2 -0
  117. package/dist/components/Menu/index.d.ts.map +1 -0
  118. package/dist/components/Menu/index.js +2 -0
  119. package/dist/components/Menu/index.js.map +1 -0
  120. package/dist/components/MultiSelect/MultiSelect.d.ts +6 -1
  121. package/dist/components/MultiSelect/MultiSelect.d.ts.map +1 -1
  122. package/dist/components/MultiSelect/MultiSelect.js +42 -23
  123. package/dist/components/MultiSelect/MultiSelect.js.map +1 -1
  124. package/dist/components/Number/Number.d.ts +4 -2
  125. package/dist/components/Number/Number.d.ts.map +1 -1
  126. package/dist/components/Number/Number.js +3 -1
  127. package/dist/components/Number/Number.js.map +1 -1
  128. package/dist/components/Pagination/Pagination.d.ts +35 -0
  129. package/dist/components/Pagination/Pagination.d.ts.map +1 -0
  130. package/dist/components/Pagination/Pagination.js +40 -0
  131. package/dist/components/Pagination/Pagination.js.map +1 -0
  132. package/dist/components/Pagination/index.d.ts +2 -0
  133. package/dist/components/Pagination/index.d.ts.map +1 -0
  134. package/dist/components/Pagination/index.js +2 -0
  135. package/dist/components/Pagination/index.js.map +1 -0
  136. package/dist/components/Popover/Popover.d.ts +51 -0
  137. package/dist/components/Popover/Popover.d.ts.map +1 -0
  138. package/dist/components/Popover/Popover.js +83 -0
  139. package/dist/components/Popover/Popover.js.map +1 -0
  140. package/dist/components/Popover/index.d.ts +2 -0
  141. package/dist/components/Popover/index.d.ts.map +1 -0
  142. package/dist/components/Popover/index.js +2 -0
  143. package/dist/components/Popover/index.js.map +1 -0
  144. package/dist/components/Progress/Progress.d.ts +30 -0
  145. package/dist/components/Progress/Progress.d.ts.map +1 -0
  146. package/dist/components/Progress/Progress.js +17 -0
  147. package/dist/components/Progress/Progress.js.map +1 -0
  148. package/dist/components/Progress/index.d.ts +2 -0
  149. package/dist/components/Progress/index.d.ts.map +1 -0
  150. package/dist/components/Progress/index.js +2 -0
  151. package/dist/components/Progress/index.js.map +1 -0
  152. package/dist/components/SafeHtml/SafeHtml.d.ts +326 -0
  153. package/dist/components/SafeHtml/SafeHtml.d.ts.map +1 -0
  154. package/dist/components/SafeHtml/SafeHtml.js +44 -0
  155. package/dist/components/SafeHtml/SafeHtml.js.map +1 -0
  156. package/dist/components/SafeHtml/index.d.ts +2 -0
  157. package/dist/components/SafeHtml/index.d.ts.map +1 -0
  158. package/dist/components/SafeHtml/index.js +2 -0
  159. package/dist/components/SafeHtml/index.js.map +1 -0
  160. package/dist/components/Sidebar/Sidebar.d.ts +50 -0
  161. package/dist/components/Sidebar/Sidebar.d.ts.map +1 -0
  162. package/dist/components/Sidebar/Sidebar.js +71 -0
  163. package/dist/components/Sidebar/Sidebar.js.map +1 -0
  164. package/dist/components/Sidebar/index.d.ts +2 -0
  165. package/dist/components/Sidebar/index.d.ts.map +1 -0
  166. package/dist/components/Sidebar/index.js +2 -0
  167. package/dist/components/Sidebar/index.js.map +1 -0
  168. package/dist/components/Slider/Slider.js +1 -4
  169. package/dist/components/Slider/Slider.js.map +1 -1
  170. package/dist/components/Spinner/Spinner.js +1 -1
  171. package/dist/components/Steps/Steps.d.ts +30 -0
  172. package/dist/components/Steps/Steps.d.ts.map +1 -0
  173. package/dist/components/Steps/Steps.js +26 -0
  174. package/dist/components/Steps/Steps.js.map +1 -0
  175. package/dist/components/Steps/index.d.ts +2 -0
  176. package/dist/components/Steps/index.d.ts.map +1 -0
  177. package/dist/components/Steps/index.js +2 -0
  178. package/dist/components/Steps/index.js.map +1 -0
  179. package/dist/components/Table/Table.d.ts +61 -3
  180. package/dist/components/Table/Table.d.ts.map +1 -1
  181. package/dist/components/Table/Table.js +176 -33
  182. package/dist/components/Table/Table.js.map +1 -1
  183. package/dist/components/Table/TableHeader.d.ts +8 -3
  184. package/dist/components/Table/TableHeader.d.ts.map +1 -1
  185. package/dist/components/Table/TableHeader.js +7 -5
  186. package/dist/components/Table/TableHeader.js.map +1 -1
  187. package/dist/components/Table/TableRow.d.ts +5 -1
  188. package/dist/components/Table/TableRow.d.ts.map +1 -1
  189. package/dist/components/Table/TableRow.js +2 -2
  190. package/dist/components/Table/TableRow.js.map +1 -1
  191. package/dist/components/Table/index.d.ts +1 -1
  192. package/dist/components/Table/index.d.ts.map +1 -1
  193. package/dist/components/Table/index.js +1 -1
  194. package/dist/components/Table/index.js.map +1 -1
  195. package/dist/components/Toast/Toast.d.ts +8 -4
  196. package/dist/components/Toast/Toast.d.ts.map +1 -1
  197. package/dist/components/Toast/Toast.js +15 -4
  198. package/dist/components/Toast/Toast.js.map +1 -1
  199. package/dist/components/Tooltip/Tooltip.d.ts.map +1 -1
  200. package/dist/components/Tooltip/Tooltip.js +5 -2
  201. package/dist/components/Tooltip/Tooltip.js.map +1 -1
  202. package/dist/components/VirtualList/VirtualList.d.ts +39 -0
  203. package/dist/components/VirtualList/VirtualList.d.ts.map +1 -0
  204. package/dist/components/VirtualList/VirtualList.js +113 -0
  205. package/dist/components/VirtualList/VirtualList.js.map +1 -0
  206. package/dist/components/VirtualList/index.d.ts +2 -0
  207. package/dist/components/VirtualList/index.d.ts.map +1 -0
  208. package/dist/components/VirtualList/index.js +2 -0
  209. package/dist/components/VirtualList/index.js.map +1 -0
  210. package/dist/core/accordion.d.ts +15 -0
  211. package/dist/core/accordion.d.ts.map +1 -0
  212. package/dist/core/accordion.js +37 -0
  213. package/dist/core/accordion.js.map +1 -0
  214. package/dist/core/avatar.d.ts +4 -0
  215. package/dist/core/avatar.d.ts.map +1 -0
  216. package/dist/core/avatar.js +12 -0
  217. package/dist/core/avatar.js.map +1 -0
  218. package/dist/core/calendar.d.ts +1 -2
  219. package/dist/core/calendar.d.ts.map +1 -1
  220. package/dist/core/calendar.js +2 -10
  221. package/dist/core/calendar.js.map +1 -1
  222. package/dist/core/carousel.d.ts +8 -0
  223. package/dist/core/carousel.d.ts.map +1 -1
  224. package/dist/core/carousel.js +27 -0
  225. package/dist/core/carousel.js.map +1 -1
  226. package/dist/core/date-math.d.ts +39 -0
  227. package/dist/core/date-math.d.ts.map +1 -0
  228. package/dist/core/date-math.js +82 -0
  229. package/dist/core/date-math.js.map +1 -0
  230. package/dist/core/date-range.d.ts +44 -0
  231. package/dist/core/date-range.d.ts.map +1 -0
  232. package/dist/core/date-range.js +88 -0
  233. package/dist/core/date-range.js.map +1 -0
  234. package/dist/core/date.d.ts +23 -4
  235. package/dist/core/date.d.ts.map +1 -1
  236. package/dist/core/date.js +114 -4
  237. package/dist/core/date.js.map +1 -1
  238. package/dist/core/dialog.d.ts +43 -5
  239. package/dist/core/dialog.d.ts.map +1 -1
  240. package/dist/core/dialog.js +85 -8
  241. package/dist/core/dialog.js.map +1 -1
  242. package/dist/core/file/csv.d.ts +10 -0
  243. package/dist/core/file/csv.d.ts.map +1 -1
  244. package/dist/core/file/csv.js +26 -3
  245. package/dist/core/file/csv.js.map +1 -1
  246. package/dist/core/file/detect.js.map +1 -1
  247. package/dist/core/file/docx-render.js.map +1 -1
  248. package/dist/core/file/docx.js.map +1 -1
  249. package/dist/core/file/dom.d.ts +1 -1
  250. package/dist/core/file/dom.d.ts.map +1 -1
  251. package/dist/core/file/dom.js +3 -3
  252. package/dist/core/file/dom.js.map +1 -1
  253. package/dist/core/file/download.d.ts +5 -0
  254. package/dist/core/file/download.d.ts.map +1 -1
  255. package/dist/core/file/download.js +10 -3
  256. package/dist/core/file/download.js.map +1 -1
  257. package/dist/core/file/error.d.ts.map +1 -1
  258. package/dist/core/file/error.js.map +1 -1
  259. package/dist/core/file/source.d.ts +15 -1
  260. package/dist/core/file/source.d.ts.map +1 -1
  261. package/dist/core/file/source.js +99 -6
  262. package/dist/core/file/source.js.map +1 -1
  263. package/dist/core/file/text.js.map +1 -1
  264. package/dist/core/file/viewer.d.ts +2 -0
  265. package/dist/core/file/viewer.d.ts.map +1 -1
  266. package/dist/core/file/viewer.js +3 -2
  267. package/dist/core/file/viewer.js.map +1 -1
  268. package/dist/core/file/xlsx-format.js.map +1 -1
  269. package/dist/core/file/xlsx-write.js.map +1 -1
  270. package/dist/core/file/xlsx.d.ts.map +1 -1
  271. package/dist/core/file/xlsx.js +4 -3
  272. package/dist/core/file/xlsx.js.map +1 -1
  273. package/dist/core/file/xml.d.ts.map +1 -1
  274. package/dist/core/file/xml.js +5 -0
  275. package/dist/core/file/xml.js.map +1 -1
  276. package/dist/core/file/zip-write.js.map +1 -1
  277. package/dist/core/file/zip.js.map +1 -1
  278. package/dist/core/floating.d.ts +69 -0
  279. package/dist/core/floating.d.ts.map +1 -0
  280. package/dist/core/floating.js +185 -0
  281. package/dist/core/floating.js.map +1 -0
  282. package/dist/core/html/css.d.ts +32 -0
  283. package/dist/core/html/css.d.ts.map +1 -0
  284. package/dist/core/html/css.js +222 -0
  285. package/dist/core/html/css.js.map +1 -0
  286. package/dist/core/html/entities.d.ts +19 -0
  287. package/dist/core/html/entities.d.ts.map +1 -0
  288. package/dist/core/html/entities.js +167 -0
  289. package/dist/core/html/entities.js.map +1 -0
  290. package/dist/core/html/entity-data.d.ts +14 -0
  291. package/dist/core/html/entity-data.d.ts.map +1 -0
  292. package/dist/core/html/entity-data.js +14 -0
  293. package/dist/core/html/entity-data.js.map +1 -0
  294. package/dist/core/html/props.d.ts +9 -0
  295. package/dist/core/html/props.d.ts.map +1 -0
  296. package/dist/core/html/props.js +98 -0
  297. package/dist/core/html/props.js.map +1 -0
  298. package/dist/core/html/sanitize.d.ts +150 -0
  299. package/dist/core/html/sanitize.d.ts.map +1 -0
  300. package/dist/core/html/sanitize.js +800 -0
  301. package/dist/core/html/sanitize.js.map +1 -0
  302. package/dist/core/html/tokenizer.d.ts +33 -0
  303. package/dist/core/html/tokenizer.d.ts.map +1 -0
  304. package/dist/core/html/tokenizer.js +306 -0
  305. package/dist/core/html/tokenizer.js.map +1 -0
  306. package/dist/core/html/tree.d.ts +35 -0
  307. package/dist/core/html/tree.d.ts.map +1 -0
  308. package/dist/core/html/tree.js +253 -0
  309. package/dist/core/html/tree.js.map +1 -0
  310. package/dist/core/icons.d.ts +8 -3
  311. package/dist/core/icons.d.ts.map +1 -1
  312. package/dist/core/icons.js +20 -5
  313. package/dist/core/icons.js.map +1 -1
  314. package/dist/core/language.d.ts.map +1 -1
  315. package/dist/core/menu.d.ts +22 -0
  316. package/dist/core/menu.d.ts.map +1 -0
  317. package/dist/core/menu.js +69 -0
  318. package/dist/core/menu.js.map +1 -0
  319. package/dist/core/motion.d.ts +12 -0
  320. package/dist/core/motion.d.ts.map +1 -0
  321. package/dist/core/motion.js +17 -0
  322. package/dist/core/motion.js.map +1 -0
  323. package/dist/core/number-input.d.ts +29 -0
  324. package/dist/core/number-input.d.ts.map +1 -0
  325. package/dist/core/number-input.js +92 -0
  326. package/dist/core/number-input.js.map +1 -0
  327. package/dist/core/number.d.ts +14 -0
  328. package/dist/core/number.d.ts.map +1 -1
  329. package/dist/core/number.js +48 -2
  330. package/dist/core/number.js.map +1 -1
  331. package/dist/core/otp.d.ts +2 -0
  332. package/dist/core/otp.d.ts.map +1 -1
  333. package/dist/core/otp.js +4 -0
  334. package/dist/core/otp.js.map +1 -1
  335. package/dist/core/pacer.d.ts +63 -0
  336. package/dist/core/pacer.d.ts.map +1 -0
  337. package/dist/core/pacer.js +129 -0
  338. package/dist/core/pacer.js.map +1 -0
  339. package/dist/core/pagination.d.ts +44 -0
  340. package/dist/core/pagination.d.ts.map +1 -0
  341. package/dist/core/pagination.js +78 -0
  342. package/dist/core/pagination.js.map +1 -0
  343. package/dist/core/popover.d.ts +6 -0
  344. package/dist/core/popover.d.ts.map +1 -0
  345. package/dist/core/popover.js +6 -0
  346. package/dist/core/popover.js.map +1 -0
  347. package/dist/core/progress.d.ts +3 -0
  348. package/dist/core/progress.d.ts.map +1 -0
  349. package/dist/core/progress.js +8 -0
  350. package/dist/core/progress.js.map +1 -0
  351. package/dist/core/qr-code.d.ts +7 -0
  352. package/dist/core/qr-code.d.ts.map +1 -1
  353. package/dist/core/qr-code.js +15 -9
  354. package/dist/core/qr-code.js.map +1 -1
  355. package/dist/core/roving.d.ts +19 -0
  356. package/dist/core/roving.d.ts.map +1 -0
  357. package/dist/core/roving.js +54 -0
  358. package/dist/core/roving.js.map +1 -0
  359. package/dist/core/safe-url.d.ts +37 -0
  360. package/dist/core/safe-url.d.ts.map +1 -0
  361. package/dist/core/safe-url.js +68 -0
  362. package/dist/core/safe-url.js.map +1 -0
  363. package/dist/core/sheet.d.ts +19 -0
  364. package/dist/core/sheet.d.ts.map +1 -0
  365. package/dist/core/sheet.js +54 -0
  366. package/dist/core/sheet.js.map +1 -0
  367. package/dist/core/spinner.d.ts +2 -2
  368. package/dist/core/spinner.d.ts.map +1 -1
  369. package/dist/core/spinner.js +22 -4
  370. package/dist/core/spinner.js.map +1 -1
  371. package/dist/core/status.d.ts +20 -0
  372. package/dist/core/status.d.ts.map +1 -0
  373. package/dist/core/status.js +30 -0
  374. package/dist/core/status.js.map +1 -0
  375. package/dist/core/stepper.js.map +1 -1
  376. package/dist/core/table/attrs.d.ts +8 -2
  377. package/dist/core/table/attrs.d.ts.map +1 -1
  378. package/dist/core/table/attrs.js +12 -3
  379. package/dist/core/table/attrs.js.map +1 -1
  380. package/dist/core/table/columns.d.ts +12 -0
  381. package/dist/core/table/columns.d.ts.map +1 -1
  382. package/dist/core/table/columns.js.map +1 -1
  383. package/dist/core/table/features.d.ts +72 -0
  384. package/dist/core/table/features.d.ts.map +1 -0
  385. package/dist/core/table/features.js +198 -0
  386. package/dist/core/table/features.js.map +1 -0
  387. package/dist/core/table/index.d.ts +2 -0
  388. package/dist/core/table/index.d.ts.map +1 -1
  389. package/dist/core/table/index.js +2 -0
  390. package/dist/core/table/index.js.map +1 -1
  391. package/dist/core/table/reorder.d.ts +21 -0
  392. package/dist/core/table/reorder.d.ts.map +1 -0
  393. package/dist/core/table/reorder.js +70 -0
  394. package/dist/core/table/reorder.js.map +1 -0
  395. package/dist/core/table/virtual.d.ts +5 -18
  396. package/dist/core/table/virtual.d.ts.map +1 -1
  397. package/dist/core/table/virtual.js +4 -15
  398. package/dist/core/table/virtual.js.map +1 -1
  399. package/dist/core/tabs.d.ts.map +1 -1
  400. package/dist/core/tabs.js +2 -15
  401. package/dist/core/tabs.js.map +1 -1
  402. package/dist/core/toast.d.ts +15 -3
  403. package/dist/core/toast.d.ts.map +1 -1
  404. package/dist/core/toast.js +9 -6
  405. package/dist/core/toast.js.map +1 -1
  406. package/dist/core/tooltip.d.ts +8 -7
  407. package/dist/core/tooltip.d.ts.map +1 -1
  408. package/dist/core/tooltip.js +14 -119
  409. package/dist/core/tooltip.js.map +1 -1
  410. package/dist/core/upload.d.ts +1 -0
  411. package/dist/core/upload.d.ts.map +1 -1
  412. package/dist/core/upload.js +6 -0
  413. package/dist/core/upload.js.map +1 -1
  414. package/dist/core/virtual.d.ts +76 -0
  415. package/dist/core/virtual.d.ts.map +1 -0
  416. package/dist/core/virtual.js +214 -0
  417. package/dist/core/virtual.js.map +1 -0
  418. package/dist/date.css +19 -0
  419. package/dist/dialog.css +408 -0
  420. package/dist/dropdown.css +514 -0
  421. package/dist/empty.css +82 -0
  422. package/dist/file-viewer.css +519 -0
  423. package/dist/fn/async.d.ts +39 -0
  424. package/dist/fn/async.d.ts.map +1 -0
  425. package/dist/fn/async.js +91 -0
  426. package/dist/fn/async.js.map +1 -0
  427. package/dist/fn/clipboard.d.ts +6 -0
  428. package/dist/fn/clipboard.d.ts.map +1 -0
  429. package/dist/fn/clipboard.js +35 -0
  430. package/dist/fn/clipboard.js.map +1 -0
  431. package/dist/fn/cookie.d.ts +7 -0
  432. package/dist/fn/cookie.d.ts.map +1 -0
  433. package/dist/fn/cookie.js +22 -0
  434. package/dist/fn/cookie.js.map +1 -0
  435. package/dist/fn/error.d.ts +24 -0
  436. package/dist/fn/error.d.ts.map +1 -0
  437. package/dist/fn/error.js +50 -0
  438. package/dist/fn/error.js.map +1 -0
  439. package/dist/fn/html.d.ts +34 -0
  440. package/dist/fn/html.d.ts.map +1 -0
  441. package/dist/fn/html.js +60 -0
  442. package/dist/fn/html.js.map +1 -0
  443. package/dist/fn/index.d.ts +39 -0
  444. package/dist/fn/index.d.ts.map +1 -0
  445. package/dist/fn/index.js +40 -0
  446. package/dist/fn/index.js.map +1 -0
  447. package/dist/fn/jwt.d.ts +12 -0
  448. package/dist/fn/jwt.d.ts.map +1 -0
  449. package/dist/fn/jwt.js +42 -0
  450. package/dist/fn/jwt.js.map +1 -0
  451. package/dist/fn/locale.d.ts +20 -0
  452. package/dist/fn/locale.d.ts.map +1 -0
  453. package/dist/fn/locale.js +33 -0
  454. package/dist/fn/locale.js.map +1 -0
  455. package/dist/fn/query.d.ts +11 -0
  456. package/dist/fn/query.d.ts.map +1 -0
  457. package/dist/fn/query.js +41 -0
  458. package/dist/fn/query.js.map +1 -0
  459. package/dist/fn/sanitize.d.ts +15 -0
  460. package/dist/fn/sanitize.d.ts.map +1 -0
  461. package/dist/fn/sanitize.js +15 -0
  462. package/dist/fn/sanitize.js.map +1 -0
  463. package/dist/fn/storage.d.ts +13 -0
  464. package/dist/fn/storage.d.ts.map +1 -0
  465. package/dist/fn/storage.js +69 -0
  466. package/dist/fn/storage.js.map +1 -0
  467. package/dist/fn/string.d.ts +13 -0
  468. package/dist/fn/string.d.ts.map +1 -0
  469. package/dist/fn/string.js +30 -0
  470. package/dist/fn/string.js.map +1 -0
  471. package/dist/fn/url.d.ts +27 -0
  472. package/dist/fn/url.d.ts.map +1 -0
  473. package/dist/fn/url.js +71 -0
  474. package/dist/fn/url.js.map +1 -0
  475. package/dist/fn/version.d.ts +5 -0
  476. package/dist/fn/version.d.ts.map +1 -0
  477. package/dist/fn/version.js +23 -0
  478. package/dist/fn/version.js.map +1 -0
  479. package/dist/focus.css +18 -0
  480. package/dist/form.css +64 -0
  481. package/dist/hooks/index.d.ts +43 -0
  482. package/dist/hooks/index.d.ts.map +1 -0
  483. package/dist/hooks/index.js +43 -0
  484. package/dist/hooks/index.js.map +1 -0
  485. package/dist/hooks/useAsync.d.ts +17 -0
  486. package/dist/hooks/useAsync.d.ts.map +1 -0
  487. package/dist/hooks/useAsync.js +38 -0
  488. package/dist/hooks/useAsync.js.map +1 -0
  489. package/dist/hooks/useAsyncCallback.d.ts +26 -0
  490. package/dist/hooks/useAsyncCallback.d.ts.map +1 -0
  491. package/dist/hooks/useAsyncCallback.js +57 -0
  492. package/dist/hooks/useAsyncCallback.js.map +1 -0
  493. package/dist/hooks/useBatcher.d.ts +11 -0
  494. package/dist/hooks/useBatcher.d.ts.map +1 -0
  495. package/dist/hooks/useBatcher.js +16 -0
  496. package/dist/hooks/useBatcher.js.map +1 -0
  497. package/dist/hooks/useClickOutside.d.ts +12 -0
  498. package/dist/hooks/useClickOutside.d.ts.map +1 -0
  499. package/dist/hooks/useClickOutside.js +29 -0
  500. package/dist/hooks/useClickOutside.js.map +1 -0
  501. package/dist/hooks/useControllableState.d.ts +2 -0
  502. package/dist/hooks/useControllableState.d.ts.map +1 -0
  503. package/dist/hooks/useControllableState.js +3 -0
  504. package/dist/hooks/useControllableState.js.map +1 -0
  505. package/dist/hooks/useCopyToClipboard.d.ts +9 -0
  506. package/dist/hooks/useCopyToClipboard.d.ts.map +1 -0
  507. package/dist/hooks/useCopyToClipboard.js +23 -0
  508. package/dist/hooks/useCopyToClipboard.js.map +1 -0
  509. package/dist/hooks/useCountdown.d.ts +24 -0
  510. package/dist/hooks/useCountdown.d.ts.map +1 -0
  511. package/dist/hooks/useCountdown.js +59 -0
  512. package/dist/hooks/useCountdown.js.map +1 -0
  513. package/dist/hooks/useDebouncedCallback.d.ts +7 -0
  514. package/dist/hooks/useDebouncedCallback.d.ts.map +1 -0
  515. package/dist/hooks/useDebouncedCallback.js +15 -0
  516. package/dist/hooks/useDebouncedCallback.js.map +1 -0
  517. package/dist/hooks/useDebouncedValue.d.ts +4 -0
  518. package/dist/hooks/useDebouncedValue.d.ts.map +1 -0
  519. package/dist/hooks/useDebouncedValue.js +19 -0
  520. package/dist/hooks/useDebouncedValue.js.map +1 -0
  521. package/dist/hooks/useDisclosure.d.ts +21 -0
  522. package/dist/hooks/useDisclosure.d.ts.map +1 -0
  523. package/dist/hooks/useDisclosure.js +20 -0
  524. package/dist/hooks/useDisclosure.js.map +1 -0
  525. package/dist/hooks/useDocumentTitle.d.ts +8 -0
  526. package/dist/hooks/useDocumentTitle.d.ts.map +1 -0
  527. package/dist/hooks/useDocumentTitle.js +18 -0
  528. package/dist/hooks/useDocumentTitle.js.map +1 -0
  529. package/dist/hooks/useElementSize.d.ts +13 -0
  530. package/dist/hooks/useElementSize.d.ts.map +1 -0
  531. package/dist/hooks/useElementSize.js +28 -0
  532. package/dist/hooks/useElementSize.js.map +1 -0
  533. package/dist/hooks/useEventListener.d.ts +10 -0
  534. package/dist/hooks/useEventListener.d.ts.map +1 -0
  535. package/dist/hooks/useEventListener.js +30 -0
  536. package/dist/hooks/useEventListener.js.map +1 -0
  537. package/dist/hooks/useHotkeys.d.ts +24 -0
  538. package/dist/hooks/useHotkeys.d.ts.map +1 -0
  539. package/dist/hooks/useHotkeys.js +69 -0
  540. package/dist/hooks/useHotkeys.js.map +1 -0
  541. package/dist/hooks/useIdle.d.ts +16 -0
  542. package/dist/hooks/useIdle.d.ts.map +1 -0
  543. package/dist/hooks/useIdle.js +63 -0
  544. package/dist/hooks/useIdle.js.map +1 -0
  545. package/dist/hooks/useInView.d.ts +13 -0
  546. package/dist/hooks/useInView.d.ts.map +1 -0
  547. package/dist/hooks/useInView.js +32 -0
  548. package/dist/hooks/useInView.js.map +1 -0
  549. package/dist/hooks/useInfiniteScroll.d.ts +20 -0
  550. package/dist/hooks/useInfiniteScroll.d.ts.map +1 -0
  551. package/dist/hooks/useInfiniteScroll.js +38 -0
  552. package/dist/hooks/useInfiniteScroll.js.map +1 -0
  553. package/dist/hooks/useInterval.d.ts +3 -0
  554. package/dist/hooks/useInterval.d.ts.map +1 -0
  555. package/dist/hooks/useInterval.js +15 -0
  556. package/dist/hooks/useInterval.js.map +1 -0
  557. package/dist/hooks/useIsClient.d.ts +6 -0
  558. package/dist/hooks/useIsClient.d.ts.map +1 -0
  559. package/dist/hooks/useIsClient.js +11 -0
  560. package/dist/hooks/useIsClient.js.map +1 -0
  561. package/dist/hooks/useLatest.d.ts +7 -0
  562. package/dist/hooks/useLatest.d.ts.map +1 -0
  563. package/dist/hooks/useLatest.js +14 -0
  564. package/dist/hooks/useLatest.js.map +1 -0
  565. package/dist/hooks/useMediaQuery.d.ts +6 -0
  566. package/dist/hooks/useMediaQuery.d.ts.map +1 -0
  567. package/dist/hooks/useMediaQuery.js +20 -0
  568. package/dist/hooks/useMediaQuery.js.map +1 -0
  569. package/dist/hooks/useMergedRefs.d.ts +6 -0
  570. package/dist/hooks/useMergedRefs.d.ts.map +1 -0
  571. package/dist/hooks/useMergedRefs.js +9 -0
  572. package/dist/hooks/useMergedRefs.js.map +1 -0
  573. package/dist/hooks/useObjectUrl.d.ts +7 -0
  574. package/dist/hooks/useObjectUrl.d.ts.map +1 -0
  575. package/dist/hooks/useObjectUrl.js +21 -0
  576. package/dist/hooks/useObjectUrl.js.map +1 -0
  577. package/dist/hooks/useOnlineStatus.d.ts +3 -0
  578. package/dist/hooks/useOnlineStatus.d.ts.map +1 -0
  579. package/dist/hooks/useOnlineStatus.js +15 -0
  580. package/dist/hooks/useOnlineStatus.js.map +1 -0
  581. package/dist/hooks/usePageVisibility.d.ts +3 -0
  582. package/dist/hooks/usePageVisibility.d.ts.map +1 -0
  583. package/dist/hooks/usePageVisibility.js +11 -0
  584. package/dist/hooks/usePageVisibility.js.map +1 -0
  585. package/dist/hooks/usePolling.d.ts +17 -0
  586. package/dist/hooks/usePolling.d.ts.map +1 -0
  587. package/dist/hooks/usePolling.js +46 -0
  588. package/dist/hooks/usePolling.js.map +1 -0
  589. package/dist/hooks/usePrefersReducedMotion.d.ts +3 -0
  590. package/dist/hooks/usePrefersReducedMotion.d.ts.map +1 -0
  591. package/dist/hooks/usePrefersReducedMotion.js +7 -0
  592. package/dist/hooks/usePrefersReducedMotion.js.map +1 -0
  593. package/dist/hooks/usePresence.d.ts +2 -0
  594. package/dist/hooks/usePresence.d.ts.map +1 -0
  595. package/dist/hooks/usePresence.js +3 -0
  596. package/dist/hooks/usePresence.js.map +1 -0
  597. package/dist/hooks/usePrevious.d.ts +3 -0
  598. package/dist/hooks/usePrevious.d.ts.map +1 -0
  599. package/dist/hooks/usePrevious.js +15 -0
  600. package/dist/hooks/usePrevious.js.map +1 -0
  601. package/dist/hooks/useScroll.d.ts +22 -0
  602. package/dist/hooks/useScroll.d.ts.map +1 -0
  603. package/dist/hooks/useScroll.js +73 -0
  604. package/dist/hooks/useScroll.js.map +1 -0
  605. package/dist/hooks/useScrollLock.d.ts +6 -0
  606. package/dist/hooks/useScrollLock.d.ts.map +1 -0
  607. package/dist/hooks/useScrollLock.js +17 -0
  608. package/dist/hooks/useScrollLock.js.map +1 -0
  609. package/dist/hooks/useStorageState.d.ts +14 -0
  610. package/dist/hooks/useStorageState.d.ts.map +1 -0
  611. package/dist/hooks/useStorageState.js +62 -0
  612. package/dist/hooks/useStorageState.js.map +1 -0
  613. package/dist/hooks/useSyncedState.d.ts +6 -0
  614. package/dist/hooks/useSyncedState.d.ts.map +1 -0
  615. package/dist/hooks/useSyncedState.js +16 -0
  616. package/dist/hooks/useSyncedState.js.map +1 -0
  617. package/dist/hooks/useThrottledCallback.d.ts +4 -0
  618. package/dist/hooks/useThrottledCallback.d.ts.map +1 -0
  619. package/dist/hooks/useThrottledCallback.js +12 -0
  620. package/dist/hooks/useThrottledCallback.js.map +1 -0
  621. package/dist/hooks/useThrottledValue.d.ts +4 -0
  622. package/dist/hooks/useThrottledValue.d.ts.map +1 -0
  623. package/dist/hooks/useThrottledValue.js +19 -0
  624. package/dist/hooks/useThrottledValue.js.map +1 -0
  625. package/dist/hooks/useTimeout.d.ts +9 -0
  626. package/dist/hooks/useTimeout.d.ts.map +1 -0
  627. package/dist/hooks/useTimeout.js +23 -0
  628. package/dist/hooks/useTimeout.js.map +1 -0
  629. package/dist/hooks/useWindowSize.d.ts +12 -0
  630. package/dist/hooks/useWindowSize.d.ts.map +1 -0
  631. package/dist/hooks/useWindowSize.js +38 -0
  632. package/dist/hooks/useWindowSize.js.map +1 -0
  633. package/dist/index.d.ts +26 -6
  634. package/dist/index.d.ts.map +1 -1
  635. package/dist/index.js +26 -6
  636. package/dist/index.js.map +1 -1
  637. package/dist/input-date.css +99 -0
  638. package/dist/input-otp.css +76 -0
  639. package/dist/input-stepper.css +179 -0
  640. package/dist/input.css +231 -0
  641. package/dist/logo-assets.css +81 -0
  642. package/dist/logo.css +59 -0
  643. package/dist/menu.css +198 -0
  644. package/dist/multiselect.css +147 -0
  645. package/dist/number.css +53 -0
  646. package/dist/pagination.css +140 -0
  647. package/dist/popover.css +106 -0
  648. package/dist/progress.css +187 -0
  649. package/dist/qr-code.css +28 -0
  650. package/dist/radio.css +124 -0
  651. package/dist/server/crypto.d.ts +26 -0
  652. package/dist/server/crypto.d.ts.map +1 -0
  653. package/dist/server/crypto.js +50 -0
  654. package/dist/server/crypto.js.map +1 -0
  655. package/dist/server/index.d.ts +9 -0
  656. package/dist/server/index.d.ts.map +1 -0
  657. package/dist/server/index.js +9 -0
  658. package/dist/server/index.js.map +1 -0
  659. package/dist/server/rate-limit.d.ts +20 -0
  660. package/dist/server/rate-limit.d.ts.map +1 -0
  661. package/dist/server/rate-limit.js +42 -0
  662. package/dist/server/rate-limit.js.map +1 -0
  663. package/dist/server/request.d.ts +42 -0
  664. package/dist/server/request.d.ts.map +1 -0
  665. package/dist/server/request.js +94 -0
  666. package/dist/server/request.js.map +1 -0
  667. package/dist/server/response.d.ts +19 -0
  668. package/dist/server/response.d.ts.map +1 -0
  669. package/dist/server/response.js +44 -0
  670. package/dist/server/response.js.map +1 -0
  671. package/dist/sidebar.css +271 -0
  672. package/dist/skeleton.css +57 -0
  673. package/dist/skill/leaf-design-system-0.2.4.zip +0 -0
  674. package/dist/slider.css +312 -0
  675. package/dist/spinner.css +132 -0
  676. package/dist/steps.css +211 -0
  677. package/dist/{leaf.css → styles.css} +4665 -2198
  678. package/dist/table.css +421 -0
  679. package/dist/tabs.css +260 -0
  680. package/dist/textarea.css +28 -0
  681. package/dist/toast.css +272 -0
  682. package/dist/toggle.css +123 -0
  683. package/dist/tokens.css +264 -0
  684. package/dist/tooltip.css +259 -0
  685. package/dist/typography.css +150 -0
  686. package/dist/upload.css +326 -0
  687. package/dist/utils/RemixGlyph.d.ts +1 -1
  688. package/dist/utils/RemixGlyph.d.ts.map +1 -1
  689. package/dist/utils/RemixGlyph.js +1 -1
  690. package/dist/utils/RemixGlyph.js.map +1 -1
  691. package/dist/utils/useFloating.d.ts +11 -0
  692. package/dist/utils/useFloating.d.ts.map +1 -0
  693. package/dist/utils/useFloating.js +34 -0
  694. package/dist/utils/useFloating.js.map +1 -0
  695. package/dist/utils/useFloatingLayer.d.ts +40 -0
  696. package/dist/utils/useFloatingLayer.d.ts.map +1 -0
  697. package/dist/utils/useFloatingLayer.js +95 -0
  698. package/dist/utils/useFloatingLayer.js.map +1 -0
  699. package/dist/utils/usePresence.d.ts +9 -0
  700. package/dist/utils/usePresence.d.ts.map +1 -0
  701. package/dist/utils/usePresence.js +25 -0
  702. package/dist/utils/usePresence.js.map +1 -0
  703. package/dist/virtual-list.css +60 -0
  704. package/package.json +82 -21
  705. package/dist/cdn/leaf-0.2.3.min.css +0 -8
  706. package/dist/cdn/leaf-0.2.3.min.js +0 -204
  707. package/dist/engine/assets.json +0 -1
  708. package/dist/engine/chunk-X2H56OKG.js +0 -4854
  709. package/dist/engine/cli.js +0 -8
  710. package/dist/engine/postcss.d.ts +0 -3
  711. package/dist/engine/postcss.js +0 -7
  712. package/dist/engine/vite.d.ts +0 -3
  713. package/dist/engine/vite.js +0 -7
  714. package/dist/skill/leaf-design-system-0.2.3.zip +0 -0
@@ -0,0 +1,69 @@
1
+ /**
2
+ * `localStorage` / `sessionStorage` an toàn: không lỗi khi SSR, khi trình duyệt chặn storage
3
+ * (Safari private, iframe bên thứ ba) hay khi JSON hỏng — lỗi trả `null` / `false`.
4
+ */
5
+ function storageOf(area) {
6
+ try {
7
+ if (typeof window === "undefined") {
8
+ return null;
9
+ }
10
+ return area === "session" ? window.sessionStorage : window.localStorage;
11
+ }
12
+ catch {
13
+ return null;
14
+ }
15
+ }
16
+ export function getStorageItem(key, area = "local") {
17
+ try {
18
+ return storageOf(area)?.getItem(key) ?? null;
19
+ }
20
+ catch {
21
+ return null;
22
+ }
23
+ }
24
+ /** Ghi chuỗi. Trả `false` khi không ghi được (SSR, bị chặn, đầy quota). */
25
+ export function setStorageItem(key, value, area = "local") {
26
+ const storage = storageOf(area);
27
+ if (!storage) {
28
+ return false;
29
+ }
30
+ try {
31
+ storage.setItem(key, value);
32
+ return true;
33
+ }
34
+ catch {
35
+ return false;
36
+ }
37
+ }
38
+ export function removeStorageItem(key, area = "local") {
39
+ try {
40
+ storageOf(area)?.removeItem(key);
41
+ }
42
+ catch {
43
+ // Bị chặn storage — không có gì để xoá.
44
+ }
45
+ }
46
+ /** Đọc JSON; thiếu / hỏng → `fallback` (mặc định `null`). */
47
+ export function getStorageJson(key, fallback = null, area = "local") {
48
+ const raw = getStorageItem(key, area);
49
+ if (raw === null) {
50
+ return fallback;
51
+ }
52
+ try {
53
+ return JSON.parse(raw);
54
+ }
55
+ catch {
56
+ return fallback;
57
+ }
58
+ }
59
+ export function setStorageJson(key, value, area = "local") {
60
+ let raw;
61
+ try {
62
+ raw = JSON.stringify(value);
63
+ }
64
+ catch {
65
+ return false;
66
+ }
67
+ return setStorageItem(key, raw, area);
68
+ }
69
+ //# sourceMappingURL=storage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/fn/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,SAAS,SAAS,CAAC,IAAiB;IAChC,IAAI,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,IAAI,GAAgB,OAAO;IACnE,IAAI,CAAC;QACD,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,KAAa,EAAE,IAAI,GAAgB,OAAO;IAClF,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,IAAI,GAAgB,OAAO;IACtE,IAAI,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACL,wCAAwC;IAC5C,CAAC;AACL,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAC1B,GAAW,EACX,QAAQ,GAAa,IAAI,EACzB,IAAI,GAAgB,OAAO;IAE3B,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,QAAQ,CAAC;IACpB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,KAAc,EAAE,IAAI,GAAgB,OAAO;IACnF,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC"}
@@ -0,0 +1,13 @@
1
+ /** Chuỗi tiếng Việt: bỏ dấu, chuẩn hoá để tìm kiếm không phân biệt dấu / hoa thường. */
2
+ /** Bỏ dấu tiếng Việt: "Đặng Thị Ánh" → "Dang Thi Anh". */
3
+ export declare function removeVietnameseTones(value: string): string;
4
+ /** Chuẩn hoá để so khớp: bỏ dấu, chữ thường, gộp khoảng trắng, trim. */
5
+ export declare function normalizeSearch(value: string): string;
6
+ /** `text` có chứa `query` không — bỏ dấu, không phân biệt hoa thường. `query` rỗng → `true`. */
7
+ export declare function includesText(text: string | null | undefined, query: string): boolean;
8
+ /**
9
+ * Chuỗi → slug cho URL / anchor mục lục: bỏ dấu, chữ thường, ký tự khác chữ / số thành `-`.
10
+ * "Quỹ mở & Trái phiếu 2026" → "quy-mo-trai-phieu-2026".
11
+ */
12
+ export declare function slugify(value: string, separator?: string): string;
13
+ //# sourceMappingURL=string.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/fn/string.ts"],"names":[],"mappings":"AAAA,wFAAwF;AAExF,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAO9D"}
@@ -0,0 +1,30 @@
1
+ /** Chuỗi tiếng Việt: bỏ dấu, chuẩn hoá để tìm kiếm không phân biệt dấu / hoa thường. */
2
+ /** Bỏ dấu tiếng Việt: "Đặng Thị Ánh" → "Dang Thi Anh". */
3
+ export function removeVietnameseTones(value) {
4
+ return value
5
+ .normalize("NFD")
6
+ .replace(/[\u0300-\u036f]/g, "")
7
+ .replace(/đ/g, "d")
8
+ .replace(/Đ/g, "D");
9
+ }
10
+ /** Chuẩn hoá để so khớp: bỏ dấu, chữ thường, gộp khoảng trắng, trim. */
11
+ export function normalizeSearch(value) {
12
+ return removeVietnameseTones(value).toLowerCase().replace(/\s+/g, " ").trim();
13
+ }
14
+ /** `text` có chứa `query` không — bỏ dấu, không phân biệt hoa thường. `query` rỗng → `true`. */
15
+ export function includesText(text, query) {
16
+ return normalizeSearch(text ?? "").includes(normalizeSearch(query));
17
+ }
18
+ /**
19
+ * Chuỗi → slug cho URL / anchor mục lục: bỏ dấu, chữ thường, ký tự khác chữ / số thành `-`.
20
+ * "Quỹ mở & Trái phiếu 2026" → "quy-mo-trai-phieu-2026".
21
+ */
22
+ export function slugify(value, separator = "-") {
23
+ return removeVietnameseTones(value)
24
+ .toLowerCase()
25
+ .replace(/[^a-z0-9]+/g, separator)
26
+ .split(separator)
27
+ .filter(Boolean)
28
+ .join(separator);
29
+ }
30
+ //# sourceMappingURL=string.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/fn/string.ts"],"names":[],"mappings":"AAAA,wFAAwF;AAExF,0DAA0D;AAC1D,MAAM,UAAU,qBAAqB,CAAC,KAAa;IAC/C,OAAO,KAAK;SACP,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,KAAa;IACzC,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAClF,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,YAAY,CAAC,IAA+B,EAAE,KAAa;IACvE,OAAO,eAAe,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,SAAS,GAAG,GAAG;IAClD,OAAO,qBAAqB,CAAC,KAAK,CAAC;SAC9B,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC;SACjC,KAAK,CAAC,SAAS,CAAC;SAChB,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,SAAS,CAAC,CAAC;AACzB,CAAC"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Kiểm tra URL / đường dẫn trước khi điều hướng, mở tab, gắn `href` — chặn open redirect và
3
+ * `javascript:`.
4
+ */
5
+ /** URL tuyệt đối `http:` / `https:` hợp lệ. */
6
+ export declare function isSafeHttpUrl(value: unknown): value is string;
7
+ /** URL `http(s)` đã chuẩn hoá (`URL.href`), hoặc `null` nếu không an toàn. */
8
+ export declare function toSafeHttpUrl(value: unknown): string | null;
9
+ /**
10
+ * Đường dẫn nội bộ an toàn để redirect (`?next=/tai-khoan`): bắt đầu bằng một `/`, không phải
11
+ * `//host` hay `/\host` (trình duyệt hiểu là URL khác origin), không có `\`, ký tự điều khiển, hay
12
+ * dạng mã hoá của chúng (`%2F%2F`, `%5C`).
13
+ */
14
+ export declare function isSafeRelativePath(value: unknown): value is string;
15
+ /**
16
+ * URL `http(s)` trỏ ra ngoài `origin` (mặc định origin trang hiện tại; ở server không có
17
+ * `window` thì mọi URL tuyệt đối đều tính là ngoài).
18
+ */
19
+ export declare function isExternalUrl(value: unknown, origin?: string): boolean;
20
+ /** Prop cho link: URL ngoài → mở tab mới kèm `rel="noopener noreferrer"`. */
21
+ export declare function externalLinkProps(value: unknown, origin?: string): {
22
+ target?: "_blank";
23
+ rel?: string;
24
+ };
25
+ /** Mở URL `http(s)` ở tab mới (`noopener`). URL không an toàn → không mở, trả `false`. */
26
+ export declare function openExternal(value: unknown): boolean;
27
+ //# sourceMappingURL=url.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/fn/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAc3D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAWlE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAOtE;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,MAAM,GAChB;IAAE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAErC;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOpD"}
package/dist/fn/url.js ADDED
@@ -0,0 +1,71 @@
1
+ /**
2
+ * Kiểm tra URL / đường dẫn trước khi điều hướng, mở tab, gắn `href` — chặn open redirect và
3
+ * `javascript:`.
4
+ */
5
+ /** Ký tự điều khiển + khoảng trắng — trình duyệt bỏ qua khi parse URL nên kẻ xấu chèn để lách kiểm tra. */
6
+ const CONTROL_CHARS = new RegExp("[\\u0000-\\u0020\\u007f-\\u009f]");
7
+ /** URL tuyệt đối `http:` / `https:` hợp lệ. */
8
+ export function isSafeHttpUrl(value) {
9
+ return toSafeHttpUrl(value) !== null;
10
+ }
11
+ /** URL `http(s)` đã chuẩn hoá (`URL.href`), hoặc `null` nếu không an toàn. */
12
+ export function toSafeHttpUrl(value) {
13
+ if (typeof value !== "string") {
14
+ return null;
15
+ }
16
+ const trimmed = value.trim();
17
+ if (trimmed === "" || CONTROL_CHARS.test(trimmed)) {
18
+ return null;
19
+ }
20
+ try {
21
+ const url = new URL(trimmed);
22
+ return url.protocol === "http:" || url.protocol === "https:" ? url.href : null;
23
+ }
24
+ catch {
25
+ return null;
26
+ }
27
+ }
28
+ /**
29
+ * Đường dẫn nội bộ an toàn để redirect (`?next=/tai-khoan`): bắt đầu bằng một `/`, không phải
30
+ * `//host` hay `/\host` (trình duyệt hiểu là URL khác origin), không có `\`, ký tự điều khiển, hay
31
+ * dạng mã hoá của chúng (`%2F%2F`, `%5C`).
32
+ */
33
+ export function isSafeRelativePath(value) {
34
+ if (typeof value !== "string" || !value.startsWith("/") || CONTROL_CHARS.test(value)) {
35
+ return false;
36
+ }
37
+ let decoded = value;
38
+ try {
39
+ decoded = decodeURIComponent(value);
40
+ }
41
+ catch {
42
+ return false;
43
+ }
44
+ return !/^\/[/\\]/.test(decoded) && !decoded.includes("\\") && !CONTROL_CHARS.test(decoded);
45
+ }
46
+ /**
47
+ * URL `http(s)` trỏ ra ngoài `origin` (mặc định origin trang hiện tại; ở server không có
48
+ * `window` thì mọi URL tuyệt đối đều tính là ngoài).
49
+ */
50
+ export function isExternalUrl(value, origin) {
51
+ const safe = toSafeHttpUrl(value);
52
+ if (!safe) {
53
+ return false;
54
+ }
55
+ const base = origin ?? (typeof window === "undefined" ? undefined : window.location.origin);
56
+ return !base || new URL(safe).origin !== new URL(base).origin;
57
+ }
58
+ /** Prop cho link: URL ngoài → mở tab mới kèm `rel="noopener noreferrer"`. */
59
+ export function externalLinkProps(value, origin) {
60
+ return isExternalUrl(value, origin) ? { target: "_blank", rel: "noopener noreferrer" } : {};
61
+ }
62
+ /** Mở URL `http(s)` ở tab mới (`noopener`). URL không an toàn → không mở, trả `false`. */
63
+ export function openExternal(value) {
64
+ const safe = toSafeHttpUrl(value);
65
+ if (!safe || typeof window === "undefined") {
66
+ return false;
67
+ }
68
+ window.open(safe, "_blank", "noopener,noreferrer");
69
+ return true;
70
+ }
71
+ //# sourceMappingURL=url.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/fn/url.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ /** So sánh phiên bản dạng số `1.12.3` (phần sau `-` / `+` bị bỏ qua, phần thiếu = 0). */
2
+ export declare function compareVersions(a: string, b: string): -1 | 0 | 1;
3
+ /** `version` < `minVersion` — vd. chặn tính năng trên app native cũ. */
4
+ export declare function isVersionLessThan(version: string, minVersion: string): boolean;
5
+ //# sourceMappingURL=version.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/fn/version.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAiBhE;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9E"}
@@ -0,0 +1,23 @@
1
+ /** So sánh phiên bản dạng số `1.12.3` (phần sau `-` / `+` bị bỏ qua, phần thiếu = 0). */
2
+ export function compareVersions(a, b) {
3
+ const parse = (value) => value
4
+ .trim()
5
+ .replace(/^v/i, "")
6
+ .split(/[-+]/)[0]
7
+ .split(".")
8
+ .map((part) => Number.parseInt(part, 10) || 0);
9
+ const left = parse(a);
10
+ const right = parse(b);
11
+ for (let i = 0; i < Math.max(left.length, right.length); i += 1) {
12
+ const diff = (left[i] ?? 0) - (right[i] ?? 0);
13
+ if (diff !== 0) {
14
+ return diff < 0 ? -1 : 1;
15
+ }
16
+ }
17
+ return 0;
18
+ }
19
+ /** `version` < `minVersion` — vd. chặn tính năng trên app native cũ. */
20
+ export function isVersionLessThan(version, minVersion) {
21
+ return compareVersions(version, minVersion) < 0;
22
+ }
23
+ //# sourceMappingURL=version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/fn/version.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAChD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAC5B,KAAK;SACA,IAAI,EAAE;SACN,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACb,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;IACL,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,UAAkB;IACjE,OAAO,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;AACpD,CAAC"}
package/dist/focus.css ADDED
@@ -0,0 +1,18 @@
1
+ /* @finhay-pro/leaf-design-system — generated by scripts/build-css.mjs. Do not edit. */
2
+ @layer theme, base, components, utilities;
3
+
4
+ /* --- src/styles/focus.css --- */
5
+
6
+ /*
7
+ * Leaf — không hiện outline khi focus bằng chuột / chạm trên control `.leaf-*`.
8
+ *
9
+ * Chỉ `:focus:not(:focus-visible)`: focus bằng bàn phím (`:focus-visible`) vẫn có ring token do
10
+ * CSS từng component vẽ (WCAG 2.4.7). Chỉ nhắm chính phần tử có class `leaf-*`, KHÔNG nhắm phần
11
+ * tử con — nút / link của app nằm trong Dialog, `.leaf-form`… giữ nguyên focus ring của app.
12
+ */
13
+
14
+ @layer components {
15
+ :where([class^="leaf-"], [class*=" leaf-"]):focus:not(:focus-visible) {
16
+ outline: none;
17
+ }
18
+ }
package/dist/form.css ADDED
@@ -0,0 +1,64 @@
1
+ /* @finhay-pro/leaf-design-system — generated by scripts/build-css.mjs. Do not edit. */
2
+ @layer theme, base, components, utilities;
3
+
4
+ /* --- src/components/Form/form.css --- */
5
+
6
+ /*
7
+ * Form layout helpers — spacing cố định (Leaf không còn --spacing-*);
8
+ * gap khớp thang Figma spacing md (16px).
9
+ */
10
+
11
+ @layer components {
12
+ .leaf-form {
13
+ display: flex;
14
+ flex-direction: column;
15
+ gap: 16px;
16
+ box-sizing: border-box;
17
+ width: 100%;
18
+ }
19
+
20
+ .leaf-form--grid-2 {
21
+ display: grid;
22
+ grid-template-columns: repeat(2, minmax(0, 1fr));
23
+ gap: 16px;
24
+ align-items: start;
25
+ }
26
+
27
+ .leaf-form--inline {
28
+ display: flex;
29
+ flex-direction: row;
30
+ flex-wrap: wrap;
31
+ gap: 16px;
32
+ align-items: flex-start;
33
+ }
34
+
35
+ .leaf-form__field {
36
+ min-width: 0;
37
+ }
38
+
39
+ .leaf-form[hidden],
40
+ .leaf-form--grid-2[hidden],
41
+ .leaf-form--inline[hidden] {
42
+ display: none;
43
+ }
44
+
45
+ .leaf-form__field--span-2 {
46
+ grid-column: span 2;
47
+ }
48
+
49
+ /* margin đủ 4 phía: <p> có margin mặc định của trình duyệt (lib không dựa vào CSS reset).
50
+ * Cách control 8px như message của Input. */
51
+ .leaf-form__message {
52
+ margin: 8px 0 0;
53
+ color: var(--system-red);
54
+ }
55
+
56
+ /* Sau control dạng khung (MultiSelect…): thụt 12px cho thẳng chữ trong trigger, như Input. */
57
+ .leaf-form__field > .leaf-dropdown + .leaf-form__message {
58
+ padding-left: 12px;
59
+ }
60
+
61
+ .leaf-form__message:not([data-invalid]) {
62
+ color: var(--text-secondary);
63
+ }
64
+ }
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Entry `@finhay-pro/leaf-design-system/hooks` — hook React dùng chung (client). Không kéo theo
3
+ * component của Leaf; mỗi hook một file nên import hook nào chỉ tải hook đó.
4
+ */
5
+ export { useDebouncedCallback } from "./useDebouncedCallback";
6
+ export { useDebouncedValue } from "./useDebouncedValue";
7
+ export { useThrottledCallback } from "./useThrottledCallback";
8
+ export { useThrottledValue } from "./useThrottledValue";
9
+ export { useBatcher } from "./useBatcher";
10
+ export type { Batcher, DebounceOptions, PacedFunction, ThrottleOptions } from "../core/pacer";
11
+ export { useInterval } from "./useInterval";
12
+ export { useTimeout } from "./useTimeout";
13
+ export { useCountdown, type Countdown, type CountdownOptions } from "./useCountdown";
14
+ export { useIdle, type IdleOptions } from "./useIdle";
15
+ export { useEventListener, type EventTargetLike } from "./useEventListener";
16
+ export { useClickOutside, type ClickOutsideOptions } from "./useClickOutside";
17
+ export { useHotkeys, type HotkeyOptions } from "./useHotkeys";
18
+ export { useMediaQuery } from "./useMediaQuery";
19
+ export { usePrefersReducedMotion } from "./usePrefersReducedMotion";
20
+ export { useElementSize, type ElementSize } from "./useElementSize";
21
+ export { useWindowSize, type WindowSize } from "./useWindowSize";
22
+ export { useInView, type InViewOptions } from "./useInView";
23
+ export { useInfiniteScroll, type InfiniteScrollOptions } from "./useInfiniteScroll";
24
+ export { useScroll, type ScrollOptions, type ScrollState } from "./useScroll";
25
+ export { useScrollLock } from "./useScrollLock";
26
+ export { useCopyToClipboard } from "./useCopyToClipboard";
27
+ export { useObjectUrl } from "./useObjectUrl";
28
+ export { useOnlineStatus } from "./useOnlineStatus";
29
+ export { usePageVisibility } from "./usePageVisibility";
30
+ export { useDocumentTitle } from "./useDocumentTitle";
31
+ export { useLatest } from "./useLatest";
32
+ export { usePrevious } from "./usePrevious";
33
+ export { useIsClient } from "./useIsClient";
34
+ export { useControllableState } from "./useControllableState";
35
+ export { usePresence } from "./usePresence";
36
+ export { useMergedRefs, mergeRefs } from "./useMergedRefs";
37
+ export { useSyncedState } from "./useSyncedState";
38
+ export { useDisclosure, type Disclosure } from "./useDisclosure";
39
+ export { useLocalStorage, useSessionStorage, type StorageStateOptions } from "./useStorageState";
40
+ export { useAsync, type AsyncState } from "./useAsync";
41
+ export { useAsyncCallback, type AsyncCallback } from "./useAsyncCallback";
42
+ export { usePolling, type PollingOptions } from "./usePolling";
43
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE9F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC"}
@@ -0,0 +1,43 @@
1
+ "use client";
2
+ /**
3
+ * Entry `@finhay-pro/leaf-design-system/hooks` — hook React dùng chung (client). Không kéo theo
4
+ * component của Leaf; mỗi hook một file nên import hook nào chỉ tải hook đó.
5
+ */
6
+ export { useDebouncedCallback } from "./useDebouncedCallback";
7
+ export { useDebouncedValue } from "./useDebouncedValue";
8
+ export { useThrottledCallback } from "./useThrottledCallback";
9
+ export { useThrottledValue } from "./useThrottledValue";
10
+ export { useBatcher } from "./useBatcher";
11
+ export { useInterval } from "./useInterval";
12
+ export { useTimeout } from "./useTimeout";
13
+ export { useCountdown } from "./useCountdown";
14
+ export { useIdle } from "./useIdle";
15
+ export { useEventListener } from "./useEventListener";
16
+ export { useClickOutside } from "./useClickOutside";
17
+ export { useHotkeys } from "./useHotkeys";
18
+ export { useMediaQuery } from "./useMediaQuery";
19
+ export { usePrefersReducedMotion } from "./usePrefersReducedMotion";
20
+ export { useElementSize } from "./useElementSize";
21
+ export { useWindowSize } from "./useWindowSize";
22
+ export { useInView } from "./useInView";
23
+ export { useInfiniteScroll } from "./useInfiniteScroll";
24
+ export { useScroll } from "./useScroll";
25
+ export { useScrollLock } from "./useScrollLock";
26
+ export { useCopyToClipboard } from "./useCopyToClipboard";
27
+ export { useObjectUrl } from "./useObjectUrl";
28
+ export { useOnlineStatus } from "./useOnlineStatus";
29
+ export { usePageVisibility } from "./usePageVisibility";
30
+ export { useDocumentTitle } from "./useDocumentTitle";
31
+ export { useLatest } from "./useLatest";
32
+ export { usePrevious } from "./usePrevious";
33
+ export { useIsClient } from "./useIsClient";
34
+ export { useControllableState } from "./useControllableState";
35
+ export { usePresence } from "./usePresence";
36
+ export { useMergedRefs, mergeRefs } from "./useMergedRefs";
37
+ export { useSyncedState } from "./useSyncedState";
38
+ export { useDisclosure } from "./useDisclosure";
39
+ export { useLocalStorage, useSessionStorage } from "./useStorageState";
40
+ export { useAsync } from "./useAsync";
41
+ export { useAsyncCallback } from "./useAsyncCallback";
42
+ export { usePolling } from "./usePolling";
43
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAyC,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAA4B,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAsB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAoB,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAmB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAsB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAA8B,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAwC,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAmB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAA4B,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAsB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAuB,MAAM,cAAc,CAAC"}
@@ -0,0 +1,17 @@
1
+ import { type DependencyList } from "react";
2
+ export type AsyncState<T> = {
3
+ data: T | undefined;
4
+ error: unknown;
5
+ loading: boolean;
6
+ /** Chạy lại (giữ `data` cũ trong lúc tải). */
7
+ retry: () => void;
8
+ };
9
+ /**
10
+ * Chạy hàm async khi `deps` đổi, kèm `AbortSignal` — đổi deps / unmount thì huỷ lần cũ (không ghi
11
+ * kết quả trễ đè kết quả mới). Dữ liệu cần cache / chia sẻ giữa màn hình → dùng store / thư viện
12
+ * fetch của app.
13
+ */
14
+ export declare function useAsync<T>(fn: (signal: AbortSignal) => Promise<T>, deps: DependencyList, { enabled }?: {
15
+ enabled?: boolean;
16
+ }): AsyncState<T>;
17
+ //# sourceMappingURL=useAsync.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useAsync.d.ts","sourceRoot":"","sources":["../../src/hooks/useAsync.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAG9E,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IACxB,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACtB,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,IAAI,EAAE,cAAc,EACpB,EAAE,OAAc,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,UAAU,CAAC,CAAC,CAAC,CAiCf"}
@@ -0,0 +1,38 @@
1
+ "use client";
2
+ import { useCallback, useEffect, useState } from "react";
3
+ import { useLatest } from "./useLatest";
4
+ /**
5
+ * Chạy hàm async khi `deps` đổi, kèm `AbortSignal` — đổi deps / unmount thì huỷ lần cũ (không ghi
6
+ * kết quả trễ đè kết quả mới). Dữ liệu cần cache / chia sẻ giữa màn hình → dùng store / thư viện
7
+ * fetch của app.
8
+ */
9
+ export function useAsync(fn, deps, { enabled = true } = {}) {
10
+ const fnRef = useLatest(fn);
11
+ const [round, setRound] = useState(0);
12
+ const [state, setState] = useState({
13
+ data: undefined,
14
+ error: undefined,
15
+ loading: enabled,
16
+ });
17
+ useEffect(() => {
18
+ if (!enabled) {
19
+ setState((prev) => (prev.loading ? { ...prev, loading: false } : prev));
20
+ return;
21
+ }
22
+ const controller = new AbortController();
23
+ setState((prev) => ({ ...prev, error: undefined, loading: true }));
24
+ fnRef.current(controller.signal).then((data) => {
25
+ if (!controller.signal.aborted) {
26
+ setState({ data, error: undefined, loading: false });
27
+ }
28
+ }, (error) => {
29
+ if (!controller.signal.aborted) {
30
+ setState((prev) => ({ ...prev, error, loading: false }));
31
+ }
32
+ });
33
+ return () => controller.abort();
34
+ }, [enabled, round, fnRef, ...deps]);
35
+ const retry = useCallback(() => setRound((value) => value + 1), []);
36
+ return { ...state, retry };
37
+ }
38
+ //# sourceMappingURL=useAsync.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useAsync.js","sourceRoot":"","sources":["../../src/hooks/useAsync.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAuB,MAAM,OAAO,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxC;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACpB,EAAuC,EACvC,IAAoB,EACpB,EAAE,OAAO,GAAG,IAAI,EAAE,GAA0B,EAAE;IAE9C,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IAC5B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA4D;QAC1F,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACxE,OAAO;QACX,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACnE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CACjC,CAAC,IAAI,EAAE,EAAE;YACL,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC7B,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACzD,CAAC;QACL,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACf,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC7B,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC7D,CAAC;QACL,CAAC,CACJ,CAAC;QACF,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACpC,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAErC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC"}
@@ -0,0 +1,26 @@
1
+ export type AsyncCallback<A extends unknown[], T> = {
2
+ data: T | undefined;
3
+ error: unknown;
4
+ loading: boolean;
5
+ /**
6
+ * Chạy hành động. Lượt đang chạy (nếu có) bị huỷ qua `AbortSignal`. Không ném lỗi — lỗi nằm ở
7
+ * `error`; resolve `undefined` khi lỗi hoặc bị huỷ.
8
+ */
9
+ run: (...args: A) => Promise<T | undefined>;
10
+ /** Huỷ lượt đang chạy (giữ `data` / `error` cũ). */
11
+ cancel: () => void;
12
+ /** Huỷ và về trạng thái ban đầu. */
13
+ reset: () => void;
14
+ };
15
+ /**
16
+ * Hành động bất đồng bộ gọi tay — submit form, xác nhận lệnh, nhận voucher. Cặp với `useAsync`
17
+ * (tự chạy theo deps). Gọi lại khi lượt trước chưa xong thì lượt trước bị huỷ; unmount cũng huỷ,
18
+ * nên kết quả trễ không ghi đè state.
19
+ *
20
+ * ```tsx
21
+ * const submit = useAsyncCallback((signal, values: FormValues) => orderService.place(values, { signal }));
22
+ * <Button loading={submit.loading} onClick={() => submit.run(values)}>Đặt lệnh</Button>
23
+ * ```
24
+ */
25
+ export declare function useAsyncCallback<A extends unknown[], T>(fn: (signal: AbortSignal, ...args: A) => Promise<T>): AsyncCallback<A, T>;
26
+ //# sourceMappingURL=useAsyncCallback.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useAsyncCallback.d.ts","sourceRoot":"","sources":["../../src/hooks/useAsyncCallback.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,IAAI;IAChD,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5C,oDAAoD;IACpD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,oCAAoC;IACpC,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAMF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EACnD,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACpD,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAgDrB"}
@@ -0,0 +1,57 @@
1
+ "use client";
2
+ import { useCallback, useEffect, useRef, useState } from "react";
3
+ import { useLatest } from "./useLatest";
4
+ const IDLE = { data: undefined, error: undefined, loading: false };
5
+ /**
6
+ * Hành động bất đồng bộ gọi tay — submit form, xác nhận lệnh, nhận voucher. Cặp với `useAsync`
7
+ * (tự chạy theo deps). Gọi lại khi lượt trước chưa xong thì lượt trước bị huỷ; unmount cũng huỷ,
8
+ * nên kết quả trễ không ghi đè state.
9
+ *
10
+ * ```tsx
11
+ * const submit = useAsyncCallback((signal, values: FormValues) => orderService.place(values, { signal }));
12
+ * <Button loading={submit.loading} onClick={() => submit.run(values)}>Đặt lệnh</Button>
13
+ * ```
14
+ */
15
+ export function useAsyncCallback(fn) {
16
+ const fnRef = useLatest(fn);
17
+ const controller = useRef(null);
18
+ const [state, setState] = useState(IDLE);
19
+ const cancel = useCallback(() => {
20
+ if (controller.current) {
21
+ controller.current.abort();
22
+ controller.current = null;
23
+ // Còn controller nghĩa là đang có lượt chạy (loading = true).
24
+ setState((prev) => ({ ...prev, loading: false }));
25
+ }
26
+ }, []);
27
+ const run = useCallback(async (...args) => {
28
+ controller.current?.abort();
29
+ const current = new AbortController();
30
+ controller.current = current;
31
+ setState((prev) => ({ ...prev, error: undefined, loading: true }));
32
+ try {
33
+ const data = await fnRef.current(current.signal, ...args);
34
+ if (current.signal.aborted) {
35
+ return undefined;
36
+ }
37
+ controller.current = null;
38
+ setState({ data, error: undefined, loading: false });
39
+ return data;
40
+ }
41
+ catch (error) {
42
+ if (!current.signal.aborted) {
43
+ controller.current = null;
44
+ setState((prev) => ({ ...prev, error, loading: false }));
45
+ }
46
+ return undefined;
47
+ }
48
+ }, [fnRef]);
49
+ const reset = useCallback(() => {
50
+ controller.current?.abort();
51
+ controller.current = null;
52
+ setState(IDLE);
53
+ }, []);
54
+ useEffect(() => () => controller.current?.abort(), []);
55
+ return { ...state, run, cancel, reset };
56
+ }
57
+ //# sourceMappingURL=useAsyncCallback.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useAsyncCallback.js","sourceRoot":"","sources":["../../src/hooks/useAsyncCallback.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import { type Batcher } from "../core/pacer";
2
+ /**
3
+ * Gom phần tử rồi xử lý một lần (vd. tick giá realtime → một lần `setState`; `wait: "frame"` để
4
+ * flush theo nhịp vẽ). `onFlush` luôn là
5
+ * bản mới nhất; unmount thì flush phần còn lại.
6
+ */
7
+ export declare function useBatcher<T>(onFlush: (items: T[]) => void, { wait, maxSize }?: {
8
+ wait?: number | "frame";
9
+ maxSize?: number;
10
+ }): Batcher<T>;
11
+ //# sourceMappingURL=useBatcher.d.ts.map