@finhay-pro/leaf-design-system 0.2.6 → 0.2.8

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 (512) hide show
  1. package/README.md +132 -5
  2. package/dist/alert.css +177 -0
  3. package/dist/bulk-action-bar.css +93 -0
  4. package/dist/carousel.css +75 -1
  5. package/dist/cdn/integrity.json +42 -0
  6. package/dist/cdn/leaf-0.2.8.core.min.css +2 -0
  7. package/dist/cdn/leaf-0.2.8.core.min.js +15 -0
  8. package/dist/cdn/leaf-0.2.8.min.css +2 -0
  9. package/dist/cdn/leaf-0.2.8.min.js +185 -0
  10. package/dist/cdn/modules/carousel.min.css +2 -0
  11. package/dist/cdn/modules/carousel.min.js +30 -0
  12. package/dist/cdn/modules/confirm.min.css +2 -0
  13. package/dist/cdn/modules/confirm.min.js +8 -0
  14. package/dist/cdn/modules/date.min.css +2 -0
  15. package/dist/cdn/modules/date.min.js +43 -0
  16. package/dist/cdn/modules/descriptions.min.css +2 -0
  17. package/dist/cdn/modules/file-viewer.min.css +2 -0
  18. package/dist/cdn/modules/file-viewer.min.js +16 -0
  19. package/dist/cdn/modules/form.min.css +2 -0
  20. package/dist/cdn/modules/form.min.js +14 -0
  21. package/dist/cdn/modules/input.min.css +2 -0
  22. package/dist/cdn/modules/input.min.js +9 -0
  23. package/dist/cdn/modules/json.min.css +2 -0
  24. package/dist/cdn/modules/json.min.js +7 -0
  25. package/dist/cdn/modules/logo.min.css +2 -0
  26. package/dist/cdn/modules/pagination.min.css +2 -0
  27. package/dist/cdn/modules/pagination.min.js +7 -0
  28. package/dist/cdn/modules/qr-code.min.css +2 -0
  29. package/dist/cdn/modules/qr-code.min.js +15 -0
  30. package/dist/cdn/modules/select.min.css +2 -0
  31. package/dist/cdn/modules/select.min.js +61 -0
  32. package/dist/cdn/modules/sidebar.min.css +2 -0
  33. package/dist/cdn/modules/stat-card.min.css +2 -0
  34. package/dist/cdn/modules/table.min.css +2 -0
  35. package/dist/cdn/modules/table.min.js +13 -0
  36. package/dist/cdn/modules/timeline.min.css +2 -0
  37. package/dist/cdn/modules/tree.min.css +2 -0
  38. package/dist/cdn/modules/tree.min.js +7 -0
  39. package/dist/cdn/modules/upload.min.css +2 -0
  40. package/dist/cdn/modules/upload.min.js +41 -0
  41. package/dist/cdn/modules/virtual-list.min.css +2 -0
  42. package/dist/cdn/modules/virtual-list.min.js +7 -0
  43. package/dist/classes.css +5043 -1962
  44. package/dist/components/Alert/Alert.d.ts +38 -0
  45. package/dist/components/Alert/Alert.d.ts.map +1 -0
  46. package/dist/components/Alert/Alert.js +32 -0
  47. package/dist/components/Alert/Alert.js.map +1 -0
  48. package/dist/components/Alert/index.d.ts +2 -0
  49. package/dist/components/Alert/index.d.ts.map +1 -0
  50. package/dist/components/Alert/index.js +2 -0
  51. package/dist/components/Alert/index.js.map +1 -0
  52. package/dist/components/Breadcrumb/index.d.ts +1 -1
  53. package/dist/components/Breadcrumb/index.d.ts.map +1 -1
  54. package/dist/components/Breadcrumb/index.js +1 -1
  55. package/dist/components/Breadcrumb/index.js.map +1 -1
  56. package/dist/components/BulkActionBar/BulkActionBar.d.ts +21 -0
  57. package/dist/components/BulkActionBar/BulkActionBar.d.ts.map +1 -0
  58. package/dist/components/BulkActionBar/BulkActionBar.js +27 -0
  59. package/dist/components/BulkActionBar/BulkActionBar.js.map +1 -0
  60. package/dist/components/BulkActionBar/index.d.ts +2 -0
  61. package/dist/components/BulkActionBar/index.d.ts.map +1 -0
  62. package/dist/components/BulkActionBar/index.js +2 -0
  63. package/dist/components/BulkActionBar/index.js.map +1 -0
  64. package/dist/components/CalendarRange/CalendarRange.d.ts +14 -1
  65. package/dist/components/CalendarRange/CalendarRange.d.ts.map +1 -1
  66. package/dist/components/CalendarRange/CalendarRange.js +84 -10
  67. package/dist/components/CalendarRange/CalendarRange.js.map +1 -1
  68. package/dist/components/Carousel/Carousel.d.ts +19 -5
  69. package/dist/components/Carousel/Carousel.d.ts.map +1 -1
  70. package/dist/components/Carousel/Carousel.js +67 -63
  71. package/dist/components/Carousel/Carousel.js.map +1 -1
  72. package/dist/components/Carousel/index.d.ts +1 -1
  73. package/dist/components/Carousel/index.d.ts.map +1 -1
  74. package/dist/components/Carousel/index.js.map +1 -1
  75. package/dist/components/ConfirmDialog/ConfirmDialog.d.ts +69 -0
  76. package/dist/components/ConfirmDialog/ConfirmDialog.d.ts.map +1 -0
  77. package/dist/components/ConfirmDialog/ConfirmDialog.js +146 -0
  78. package/dist/components/ConfirmDialog/ConfirmDialog.js.map +1 -0
  79. package/dist/components/ConfirmDialog/index.d.ts +3 -0
  80. package/dist/components/ConfirmDialog/index.d.ts.map +1 -0
  81. package/dist/components/ConfirmDialog/index.js +3 -0
  82. package/dist/components/ConfirmDialog/index.js.map +1 -0
  83. package/dist/components/Descriptions/Descriptions.d.ts +60 -0
  84. package/dist/components/Descriptions/Descriptions.d.ts.map +1 -0
  85. package/dist/components/Descriptions/Descriptions.js +50 -0
  86. package/dist/components/Descriptions/Descriptions.js.map +1 -0
  87. package/dist/components/Descriptions/index.d.ts +2 -0
  88. package/dist/components/Descriptions/index.d.ts.map +1 -0
  89. package/dist/components/Descriptions/index.js +2 -0
  90. package/dist/components/Descriptions/index.js.map +1 -0
  91. package/dist/components/DiffView/DiffView.d.ts +36 -0
  92. package/dist/components/DiffView/DiffView.d.ts.map +1 -0
  93. package/dist/components/DiffView/DiffView.js +28 -0
  94. package/dist/components/DiffView/DiffView.js.map +1 -0
  95. package/dist/components/DiffView/index.d.ts +2 -0
  96. package/dist/components/DiffView/index.d.ts.map +1 -0
  97. package/dist/components/DiffView/index.js +2 -0
  98. package/dist/components/DiffView/index.js.map +1 -0
  99. package/dist/components/Dropdown/Dropdown.d.ts +26 -4
  100. package/dist/components/Dropdown/Dropdown.d.ts.map +1 -1
  101. package/dist/components/Dropdown/Dropdown.js +66 -18
  102. package/dist/components/Dropdown/Dropdown.js.map +1 -1
  103. package/dist/components/Dropdown/index.d.ts +2 -1
  104. package/dist/components/Dropdown/index.d.ts.map +1 -1
  105. package/dist/components/Dropdown/index.js +2 -0
  106. package/dist/components/Dropdown/index.js.map +1 -1
  107. package/dist/components/Dropdown/parts.d.ts +15 -0
  108. package/dist/components/Dropdown/parts.d.ts.map +1 -0
  109. package/dist/components/Dropdown/parts.js +19 -0
  110. package/dist/components/Dropdown/parts.js.map +1 -0
  111. package/dist/components/FileViewer/FileViewer.d.ts +42 -6
  112. package/dist/components/FileViewer/FileViewer.d.ts.map +1 -1
  113. package/dist/components/FileViewer/FileViewer.js +5 -62
  114. package/dist/components/FileViewer/FileViewer.js.map +1 -1
  115. package/dist/components/FileViewer/FileViewerDialog.d.ts +3 -3
  116. package/dist/components/FileViewer/FileViewerDialog.d.ts.map +1 -1
  117. package/dist/components/FileViewer/FileViewerDialog.js +22 -4
  118. package/dist/components/FileViewer/FileViewerDialog.js.map +1 -1
  119. package/dist/components/FileViewer/FileViewerDialogFrame.d.ts +20 -0
  120. package/dist/components/FileViewer/FileViewerDialogFrame.d.ts.map +1 -0
  121. package/dist/components/FileViewer/FileViewerDialogFrame.js +12 -0
  122. package/dist/components/FileViewer/FileViewerDialogFrame.js.map +1 -0
  123. package/dist/components/FileViewer/FileViewerGallery.d.ts +10 -0
  124. package/dist/components/FileViewer/FileViewerGallery.d.ts.map +1 -0
  125. package/dist/components/FileViewer/FileViewerGallery.js +84 -0
  126. package/dist/components/FileViewer/FileViewerGallery.js.map +1 -0
  127. package/dist/components/FileViewer/FileViewerSingle.d.ts +7 -0
  128. package/dist/components/FileViewer/FileViewerSingle.d.ts.map +1 -0
  129. package/dist/components/FileViewer/FileViewerSingle.js +78 -0
  130. package/dist/components/FileViewer/FileViewerSingle.js.map +1 -0
  131. package/dist/components/FileViewer/index.d.ts +2 -1
  132. package/dist/components/FileViewer/index.d.ts.map +1 -1
  133. package/dist/components/FileViewer/index.js +1 -1
  134. package/dist/components/FileViewer/index.js.map +1 -1
  135. package/dist/components/Form/DynamicForm.d.ts +37 -4
  136. package/dist/components/Form/DynamicForm.d.ts.map +1 -1
  137. package/dist/components/Form/DynamicForm.js +45 -6
  138. package/dist/components/Form/DynamicForm.js.map +1 -1
  139. package/dist/components/Form/Form.d.ts +6 -1
  140. package/dist/components/Form/Form.d.ts.map +1 -1
  141. package/dist/components/Form/Form.js +15 -3
  142. package/dist/components/Form/Form.js.map +1 -1
  143. package/dist/components/Form/adapters.d.ts +31 -1
  144. package/dist/components/Form/adapters.d.ts.map +1 -1
  145. package/dist/components/Form/adapters.js +67 -2
  146. package/dist/components/Form/adapters.js.map +1 -1
  147. package/dist/components/Form/index.d.ts +5 -21
  148. package/dist/components/Form/index.d.ts.map +1 -1
  149. package/dist/components/Form/index.js +5 -19
  150. package/dist/components/Form/index.js.map +1 -1
  151. package/dist/components/Form/namespace.d.ts +25 -0
  152. package/dist/components/Form/namespace.d.ts.map +1 -0
  153. package/dist/components/Form/namespace.js +25 -0
  154. package/dist/components/Form/namespace.js.map +1 -0
  155. package/dist/components/Form/useForm.d.ts.map +1 -1
  156. package/dist/components/Form/useForm.js +5 -0
  157. package/dist/components/Form/useForm.js.map +1 -1
  158. package/dist/components/Input/InputDateRange.d.ts +12 -2
  159. package/dist/components/Input/InputDateRange.d.ts.map +1 -1
  160. package/dist/components/Input/InputDateRange.js +4 -4
  161. package/dist/components/Input/InputDateRange.js.map +1 -1
  162. package/dist/components/JsonView/JsonView.d.ts +38 -0
  163. package/dist/components/JsonView/JsonView.d.ts.map +1 -0
  164. package/dist/components/JsonView/JsonView.js +166 -0
  165. package/dist/components/JsonView/JsonView.js.map +1 -0
  166. package/dist/components/JsonView/index.d.ts +2 -0
  167. package/dist/components/JsonView/index.d.ts.map +1 -0
  168. package/dist/components/JsonView/index.js +2 -0
  169. package/dist/components/JsonView/index.js.map +1 -0
  170. package/dist/components/Menu/Menu.d.ts +8 -2
  171. package/dist/components/Menu/Menu.d.ts.map +1 -1
  172. package/dist/components/Menu/Menu.js +95 -16
  173. package/dist/components/Menu/Menu.js.map +1 -1
  174. package/dist/components/Menu/MenuSubmenu.d.ts +39 -0
  175. package/dist/components/Menu/MenuSubmenu.d.ts.map +1 -0
  176. package/dist/components/Menu/MenuSubmenu.js +61 -0
  177. package/dist/components/Menu/MenuSubmenu.js.map +1 -0
  178. package/dist/components/MultiSelect/MultiSelect.d.ts +34 -6
  179. package/dist/components/MultiSelect/MultiSelect.d.ts.map +1 -1
  180. package/dist/components/MultiSelect/MultiSelect.js +109 -42
  181. package/dist/components/MultiSelect/MultiSelect.js.map +1 -1
  182. package/dist/components/MultiSelect/index.d.ts +2 -1
  183. package/dist/components/MultiSelect/index.d.ts.map +1 -1
  184. package/dist/components/MultiSelect/index.js +2 -0
  185. package/dist/components/MultiSelect/index.js.map +1 -1
  186. package/dist/components/PageHeader/PageHeader.d.ts +39 -0
  187. package/dist/components/PageHeader/PageHeader.d.ts.map +1 -0
  188. package/dist/components/PageHeader/PageHeader.js +18 -0
  189. package/dist/components/PageHeader/PageHeader.js.map +1 -0
  190. package/dist/components/PageHeader/index.d.ts +2 -0
  191. package/dist/components/PageHeader/index.d.ts.map +1 -0
  192. package/dist/components/PageHeader/index.js +2 -0
  193. package/dist/components/PageHeader/index.js.map +1 -0
  194. package/dist/components/SafeHtml/SafeHtml.d.ts +19 -4
  195. package/dist/components/SafeHtml/SafeHtml.d.ts.map +1 -1
  196. package/dist/components/SafeHtml/SafeHtml.js +11 -3
  197. package/dist/components/SafeHtml/SafeHtml.js.map +1 -1
  198. package/dist/components/Sidebar/Sidebar.d.ts +30 -9
  199. package/dist/components/Sidebar/Sidebar.d.ts.map +1 -1
  200. package/dist/components/Sidebar/Sidebar.js +111 -37
  201. package/dist/components/Sidebar/Sidebar.js.map +1 -1
  202. package/dist/components/Sidebar/index.d.ts +1 -1
  203. package/dist/components/Sidebar/index.d.ts.map +1 -1
  204. package/dist/components/Sidebar/index.js +1 -1
  205. package/dist/components/Sidebar/index.js.map +1 -1
  206. package/dist/components/StatCard/StatCard.d.ts +63 -0
  207. package/dist/components/StatCard/StatCard.d.ts.map +1 -0
  208. package/dist/components/StatCard/StatCard.js +67 -0
  209. package/dist/components/StatCard/StatCard.js.map +1 -0
  210. package/dist/components/StatCard/index.d.ts +2 -0
  211. package/dist/components/StatCard/index.d.ts.map +1 -0
  212. package/dist/components/StatCard/index.js +2 -0
  213. package/dist/components/StatCard/index.js.map +1 -0
  214. package/dist/components/Steps/index.d.ts +1 -1
  215. package/dist/components/Steps/index.d.ts.map +1 -1
  216. package/dist/components/Steps/index.js +1 -1
  217. package/dist/components/Steps/index.js.map +1 -1
  218. package/dist/components/Table/Table.d.ts +50 -4
  219. package/dist/components/Table/Table.d.ts.map +1 -1
  220. package/dist/components/Table/Table.js +241 -26
  221. package/dist/components/Table/Table.js.map +1 -1
  222. package/dist/components/Table/TableCellEditor.d.ts +24 -0
  223. package/dist/components/Table/TableCellEditor.d.ts.map +1 -0
  224. package/dist/components/Table/TableCellEditor.js +39 -0
  225. package/dist/components/Table/TableCellEditor.js.map +1 -0
  226. package/dist/components/Table/TableCellTooltip.d.ts +22 -0
  227. package/dist/components/Table/TableCellTooltip.d.ts.map +1 -0
  228. package/dist/components/Table/TableCellTooltip.js +19 -0
  229. package/dist/components/Table/TableCellTooltip.js.map +1 -0
  230. package/dist/components/Table/TableColumnChooser.d.ts +43 -0
  231. package/dist/components/Table/TableColumnChooser.d.ts.map +1 -0
  232. package/dist/components/Table/TableColumnChooser.js +50 -0
  233. package/dist/components/Table/TableColumnChooser.js.map +1 -0
  234. package/dist/components/Table/TableColumnFilter.d.ts +73 -0
  235. package/dist/components/Table/TableColumnFilter.d.ts.map +1 -0
  236. package/dist/components/Table/TableColumnFilter.js +100 -0
  237. package/dist/components/Table/TableColumnFilter.js.map +1 -0
  238. package/dist/components/Table/TableEdit.d.ts +34 -0
  239. package/dist/components/Table/TableEdit.d.ts.map +1 -0
  240. package/dist/components/Table/TableEdit.js +106 -0
  241. package/dist/components/Table/TableEdit.js.map +1 -0
  242. package/dist/components/Table/TableRow.d.ts +33 -3
  243. package/dist/components/Table/TableRow.d.ts.map +1 -1
  244. package/dist/components/Table/TableRow.js +21 -3
  245. package/dist/components/Table/TableRow.js.map +1 -1
  246. package/dist/components/Table/context.d.ts +17 -0
  247. package/dist/components/Table/context.d.ts.map +1 -0
  248. package/dist/components/Table/context.js +3 -0
  249. package/dist/components/Table/context.js.map +1 -0
  250. package/dist/components/Table/index.d.ts +6 -1
  251. package/dist/components/Table/index.d.ts.map +1 -1
  252. package/dist/components/Table/index.js +6 -1
  253. package/dist/components/Table/index.js.map +1 -1
  254. package/dist/components/Timeline/Timeline.d.ts +46 -0
  255. package/dist/components/Timeline/Timeline.d.ts.map +1 -0
  256. package/dist/components/Timeline/Timeline.js +26 -0
  257. package/dist/components/Timeline/Timeline.js.map +1 -0
  258. package/dist/components/Timeline/index.d.ts +2 -0
  259. package/dist/components/Timeline/index.d.ts.map +1 -0
  260. package/dist/components/Timeline/index.js +2 -0
  261. package/dist/components/Timeline/index.js.map +1 -0
  262. package/dist/components/Tree/Tree.d.ts +65 -0
  263. package/dist/components/Tree/Tree.d.ts.map +1 -0
  264. package/dist/components/Tree/Tree.js +262 -0
  265. package/dist/components/Tree/Tree.js.map +1 -0
  266. package/dist/components/Tree/index.d.ts +2 -0
  267. package/dist/components/Tree/index.d.ts.map +1 -0
  268. package/dist/components/Tree/index.js +2 -0
  269. package/dist/components/Tree/index.js.map +1 -0
  270. package/dist/components/Upload/Upload.d.ts +28 -5
  271. package/dist/components/Upload/Upload.d.ts.map +1 -1
  272. package/dist/components/Upload/Upload.js +96 -15
  273. package/dist/components/Upload/Upload.js.map +1 -1
  274. package/dist/components/Upload/index.d.ts +1 -1
  275. package/dist/components/Upload/index.d.ts.map +1 -1
  276. package/dist/components/Upload/index.js +1 -1
  277. package/dist/components/Upload/index.js.map +1 -1
  278. package/dist/confirm-dialog.css +54 -0
  279. package/dist/core/bulk-action-bar.d.ts +19 -0
  280. package/dist/core/bulk-action-bar.d.ts.map +1 -0
  281. package/dist/core/bulk-action-bar.js +19 -0
  282. package/dist/core/bulk-action-bar.js.map +1 -0
  283. package/dist/core/carousel-dom.d.ts +26 -0
  284. package/dist/core/carousel-dom.d.ts.map +1 -0
  285. package/dist/core/carousel-dom.js +65 -0
  286. package/dist/core/carousel-dom.js.map +1 -0
  287. package/dist/core/carousel.d.ts +27 -0
  288. package/dist/core/carousel.d.ts.map +1 -1
  289. package/dist/core/carousel.js +57 -0
  290. package/dist/core/carousel.js.map +1 -1
  291. package/dist/core/confirm.d.ts +101 -0
  292. package/dist/core/confirm.d.ts.map +1 -0
  293. package/dist/core/confirm.js +120 -0
  294. package/dist/core/confirm.js.map +1 -0
  295. package/dist/core/date-range.d.ts +25 -4
  296. package/dist/core/date-range.d.ts.map +1 -1
  297. package/dist/core/date-range.js +36 -8
  298. package/dist/core/date-range.js.map +1 -1
  299. package/dist/core/diff-view.d.ts +37 -0
  300. package/dist/core/diff-view.d.ts.map +1 -0
  301. package/dist/core/diff-view.js +57 -0
  302. package/dist/core/diff-view.js.map +1 -0
  303. package/dist/core/dropdown.d.ts +59 -0
  304. package/dist/core/dropdown.d.ts.map +1 -1
  305. package/dist/core/dropdown.js +85 -0
  306. package/dist/core/dropdown.js.map +1 -1
  307. package/dist/core/file/docx-read.d.ts +9 -0
  308. package/dist/core/file/docx-read.d.ts.map +1 -0
  309. package/dist/core/file/docx-read.js +18 -0
  310. package/dist/core/file/docx-read.js.map +1 -0
  311. package/dist/core/file/docx.d.ts +1 -4
  312. package/dist/core/file/docx.d.ts.map +1 -1
  313. package/dist/core/file/docx.js +4 -10
  314. package/dist/core/file/docx.js.map +1 -1
  315. package/dist/core/file/gallery.d.ts +95 -0
  316. package/dist/core/file/gallery.d.ts.map +1 -0
  317. package/dist/core/file/gallery.js +393 -0
  318. package/dist/core/file/gallery.js.map +1 -0
  319. package/dist/core/file/viewer.d.ts +71 -5
  320. package/dist/core/file/viewer.d.ts.map +1 -1
  321. package/dist/core/file/viewer.js +199 -28
  322. package/dist/core/file/viewer.js.map +1 -1
  323. package/dist/core/file/xlsx-read.d.ts +20 -0
  324. package/dist/core/file/xlsx-read.d.ts.map +1 -0
  325. package/dist/core/file/xlsx-read.js +46 -0
  326. package/dist/core/file/xlsx-read.js.map +1 -0
  327. package/dist/core/file/xlsx.d.ts +2 -12
  328. package/dist/core/file/xlsx.d.ts.map +1 -1
  329. package/dist/core/file/xlsx.js +3 -29
  330. package/dist/core/file/xlsx.js.map +1 -1
  331. package/dist/core/floating.d.ts +7 -0
  332. package/dist/core/floating.d.ts.map +1 -1
  333. package/dist/core/floating.js +33 -0
  334. package/dist/core/floating.js.map +1 -1
  335. package/dist/core/form.d.ts +85 -8
  336. package/dist/core/form.d.ts.map +1 -1
  337. package/dist/core/form.js +335 -68
  338. package/dist/core/form.js.map +1 -1
  339. package/dist/core/html/link-click.d.ts +23 -0
  340. package/dist/core/html/link-click.d.ts.map +1 -0
  341. package/dist/core/html/link-click.js +59 -0
  342. package/dist/core/html/link-click.js.map +1 -0
  343. package/dist/core/html/sanitize.d.ts +23 -1
  344. package/dist/core/html/sanitize.d.ts.map +1 -1
  345. package/dist/core/html/sanitize.js +76 -7
  346. package/dist/core/html/sanitize.js.map +1 -1
  347. package/dist/core/icons.d.ts +10 -0
  348. package/dist/core/icons.d.ts.map +1 -1
  349. package/dist/core/icons.js +11 -1
  350. package/dist/core/icons.js.map +1 -1
  351. package/dist/core/json-diff.d.ts +53 -0
  352. package/dist/core/json-diff.d.ts.map +1 -0
  353. package/dist/core/json-diff.js +162 -0
  354. package/dist/core/json-diff.js.map +1 -0
  355. package/dist/core/json-view.d.ts +107 -0
  356. package/dist/core/json-view.d.ts.map +1 -0
  357. package/dist/core/json-view.js +197 -0
  358. package/dist/core/json-view.js.map +1 -0
  359. package/dist/core/menu.d.ts +24 -0
  360. package/dist/core/menu.d.ts.map +1 -1
  361. package/dist/core/menu.js +40 -0
  362. package/dist/core/menu.js.map +1 -1
  363. package/dist/core/motion.d.ts +56 -0
  364. package/dist/core/motion.d.ts.map +1 -1
  365. package/dist/core/motion.js +56 -0
  366. package/dist/core/motion.js.map +1 -1
  367. package/dist/core/presence-list.d.ts +24 -0
  368. package/dist/core/presence-list.d.ts.map +1 -0
  369. package/dist/core/presence-list.js +62 -0
  370. package/dist/core/presence-list.js.map +1 -0
  371. package/dist/core/safe-url.d.ts +11 -0
  372. package/dist/core/safe-url.d.ts.map +1 -1
  373. package/dist/core/safe-url.js +25 -0
  374. package/dist/core/safe-url.js.map +1 -1
  375. package/dist/core/sidebar.d.ts +31 -0
  376. package/dist/core/sidebar.d.ts.map +1 -0
  377. package/dist/core/sidebar.js +67 -0
  378. package/dist/core/sidebar.js.map +1 -0
  379. package/dist/core/table/attrs.d.ts +7 -2
  380. package/dist/core/table/attrs.d.ts.map +1 -1
  381. package/dist/core/table/attrs.js +12 -1
  382. package/dist/core/table/attrs.js.map +1 -1
  383. package/dist/core/table/chooser.d.ts +46 -0
  384. package/dist/core/table/chooser.d.ts.map +1 -0
  385. package/dist/core/table/chooser.js +99 -0
  386. package/dist/core/table/chooser.js.map +1 -0
  387. package/dist/core/table/columns.d.ts +64 -2
  388. package/dist/core/table/columns.d.ts.map +1 -1
  389. package/dist/core/table/columns.js +19 -1
  390. package/dist/core/table/columns.js.map +1 -1
  391. package/dist/core/table/edit.d.ts +104 -0
  392. package/dist/core/table/edit.d.ts.map +1 -0
  393. package/dist/core/table/edit.js +151 -0
  394. package/dist/core/table/edit.js.map +1 -0
  395. package/dist/core/table/expand.d.ts +33 -0
  396. package/dist/core/table/expand.d.ts.map +1 -0
  397. package/dist/core/table/expand.js +83 -0
  398. package/dist/core/table/expand.js.map +1 -0
  399. package/dist/core/table/features.d.ts +2 -1
  400. package/dist/core/table/features.d.ts.map +1 -1
  401. package/dist/core/table/features.js +1 -1
  402. package/dist/core/table/features.js.map +1 -1
  403. package/dist/core/table/filter.d.ts +88 -0
  404. package/dist/core/table/filter.d.ts.map +1 -0
  405. package/dist/core/table/filter.js +160 -0
  406. package/dist/core/table/filter.js.map +1 -0
  407. package/dist/core/table/index.d.ts +5 -0
  408. package/dist/core/table/index.d.ts.map +1 -1
  409. package/dist/core/table/index.js +5 -0
  410. package/dist/core/table/index.js.map +1 -1
  411. package/dist/core/table/measure.d.ts +7 -1
  412. package/dist/core/table/measure.d.ts.map +1 -1
  413. package/dist/core/table/measure.js +14 -3
  414. package/dist/core/table/measure.js.map +1 -1
  415. package/dist/core/table/span.d.ts +6 -2
  416. package/dist/core/table/span.d.ts.map +1 -1
  417. package/dist/core/table/span.js +22 -4
  418. package/dist/core/table/span.js.map +1 -1
  419. package/dist/core/table/visibility.d.ts +26 -0
  420. package/dist/core/table/visibility.d.ts.map +1 -0
  421. package/dist/core/table/visibility.js +53 -0
  422. package/dist/core/table/visibility.js.map +1 -0
  423. package/dist/core/tree.d.ts +168 -0
  424. package/dist/core/tree.d.ts.map +1 -0
  425. package/dist/core/tree.js +398 -0
  426. package/dist/core/tree.js.map +1 -0
  427. package/dist/core/upload.d.ts +55 -2
  428. package/dist/core/upload.d.ts.map +1 -1
  429. package/dist/core/upload.js +98 -2
  430. package/dist/core/upload.js.map +1 -1
  431. package/dist/descriptions.css +241 -0
  432. package/dist/diff-view.css +244 -0
  433. package/dist/dropdown.css +133 -0
  434. package/dist/file-viewer.css +204 -0
  435. package/dist/fn/cookie.d.ts.map +1 -1
  436. package/dist/fn/cookie.js +8 -1
  437. package/dist/fn/cookie.js.map +1 -1
  438. package/dist/fn/index.d.ts +7 -4
  439. package/dist/fn/index.d.ts.map +1 -1
  440. package/dist/fn/index.js +7 -3
  441. package/dist/fn/index.js.map +1 -1
  442. package/dist/fn/query-state.d.ts +97 -0
  443. package/dist/fn/query-state.d.ts.map +1 -0
  444. package/dist/fn/query-state.js +163 -0
  445. package/dist/fn/query-state.js.map +1 -0
  446. package/dist/fn/sanitize.d.ts +1 -1
  447. package/dist/fn/sanitize.d.ts.map +1 -1
  448. package/dist/fn/sanitize.js.map +1 -1
  449. package/dist/fn/url.d.ts +37 -6
  450. package/dist/fn/url.d.ts.map +1 -1
  451. package/dist/fn/url.js +132 -12
  452. package/dist/fn/url.js.map +1 -1
  453. package/dist/hooks/index.d.ts +3 -0
  454. package/dist/hooks/index.d.ts.map +1 -1
  455. package/dist/hooks/index.js +3 -0
  456. package/dist/hooks/index.js.map +1 -1
  457. package/dist/hooks/usePageLifecycle.d.ts +29 -0
  458. package/dist/hooks/usePageLifecycle.d.ts.map +1 -0
  459. package/dist/hooks/usePageLifecycle.js +66 -0
  460. package/dist/hooks/usePageLifecycle.js.map +1 -0
  461. package/dist/hooks/usePageVisibility.d.ts +4 -1
  462. package/dist/hooks/usePageVisibility.d.ts.map +1 -1
  463. package/dist/hooks/usePageVisibility.js +10 -2
  464. package/dist/hooks/usePageVisibility.js.map +1 -1
  465. package/dist/hooks/useQueryState.d.ts +57 -0
  466. package/dist/hooks/useQueryState.d.ts.map +1 -0
  467. package/dist/hooks/useQueryState.js +122 -0
  468. package/dist/hooks/useQueryState.js.map +1 -0
  469. package/dist/index.d.ts +23 -10
  470. package/dist/index.d.ts.map +1 -1
  471. package/dist/index.js +24 -9
  472. package/dist/index.js.map +1 -1
  473. package/dist/json-view.css +323 -0
  474. package/dist/menu.css +29 -0
  475. package/dist/multiselect.css +61 -0
  476. package/dist/page-header.css +159 -0
  477. package/dist/server/browser.d.ts +2 -0
  478. package/dist/server/browser.d.ts.map +1 -0
  479. package/dist/server/browser.js +9 -0
  480. package/dist/server/browser.js.map +1 -0
  481. package/dist/server/cookie.d.ts +41 -0
  482. package/dist/server/cookie.d.ts.map +1 -0
  483. package/dist/server/cookie.js +102 -0
  484. package/dist/server/cookie.js.map +1 -0
  485. package/dist/server/crypto.d.ts +49 -0
  486. package/dist/server/crypto.d.ts.map +1 -1
  487. package/dist/server/crypto.js +124 -0
  488. package/dist/server/crypto.js.map +1 -1
  489. package/dist/server/index.d.ts +2 -1
  490. package/dist/server/index.d.ts.map +1 -1
  491. package/dist/server/index.js +2 -1
  492. package/dist/server/index.js.map +1 -1
  493. package/dist/sidebar.css +59 -0
  494. package/dist/skill/leaf-design-system-0.2.8.zip +0 -0
  495. package/dist/stat-card.css +191 -0
  496. package/dist/styles.css +5043 -1962
  497. package/dist/table.css +418 -0
  498. package/dist/tabs.css +23 -0
  499. package/dist/timeline.css +268 -0
  500. package/dist/tree.css +197 -0
  501. package/dist/upload.css +153 -0
  502. package/dist/utils/useFloatingLayer.d.ts.map +1 -1
  503. package/dist/utils/useFloatingLayer.js +6 -2
  504. package/dist/utils/useFloatingLayer.js.map +1 -1
  505. package/dist/utils/usePresenceList.d.ts +18 -0
  506. package/dist/utils/usePresenceList.d.ts.map +1 -0
  507. package/dist/utils/usePresenceList.js +51 -0
  508. package/dist/utils/usePresenceList.js.map +1 -0
  509. package/package.json +214 -1
  510. package/dist/cdn/leaf-0.2.6.min.css +0 -2
  511. package/dist/cdn/leaf-0.2.6.min.js +0 -177
  512. package/dist/skill/leaf-design-system-0.2.6.zip +0 -0
package/dist/fn/url.d.ts CHANGED
@@ -2,16 +2,47 @@
2
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
3
  * `javascript:`.
4
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;
5
+ export type SafeHttpUrlOptions = {
6
+ /**
7
+ * Allowlist host: `a.vn` (đúng host) hoặc `.a.vn` (a.vn + mọi subdomain). Host so theo
8
+ * `URL.hostname` (chữ thường, IDN đã sang punycode — mục IDN truyền dạng `xn--…`). Mục sai dạng
9
+ * → `TypeError`. Mảng rỗng → không host nào qua.
10
+ */
11
+ hosts?: readonly string[];
12
+ /** Chỉ nhận `https:`. Mặc định `false`. */
13
+ httpsOnly?: boolean;
14
+ /** Cho phép `user:pass@` trong URL. Mặc định `false` (khi có truyền `options`). */
15
+ allowCredentials?: boolean;
16
+ /** Cho phép port tường minh (`:8443`). Mặc định `false` khi có `hosts`, ngược lại `true`. */
17
+ allowPort?: boolean;
18
+ };
19
+ /** URL tuyệt đối `http:` / `https:` hợp lệ (và thoả `options` nếu có). */
20
+ export declare function isSafeHttpUrl(value: unknown, options?: SafeHttpUrlOptions): value is string;
21
+ /**
22
+ * URL `http(s)` đã chuẩn hoá (`URL.href`), hoặc `null` nếu không an toàn. Không truyền `options` →
23
+ * nhận mọi host (như trước). Có `hosts` → chỉ host trong allowlist, mặc định chặn port lạ và
24
+ * `user:pass@` (chặn nhúng / điều hướng sang trang giả mạo).
25
+ */
26
+ export declare function toSafeHttpUrl(value: unknown, options?: SafeHttpUrlOptions): string | null;
9
27
  /**
10
28
  * Đườ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`).
29
+ * `//host` hay `/\host` (trình duyệt hiểu là URL khác origin), không có `\`, ký tự điều khiển,
30
+ * segment `..`, hay dạng mã hoá (kể cả lồng nhiều lớp) của chúng (`%2F%2F`, `%252F`, `%5C`, `%2e%2e`).
13
31
  */
14
32
  export declare function isSafeRelativePath(value: unknown): value is string;
33
+ /**
34
+ * Giá trị (thường từ query / body) ghép làm **một** segment của URL gọi backend:
35
+ * `` `${BASE}/users/${seg}/profile` ``. Trả chuỗi đã `encodeURIComponent`, hoặc `null` nếu không
36
+ * an toàn: không phải chuỗi / số hữu hạn, rỗng, dài quá 256, có ký tự điều khiển / khoảng trắng,
37
+ * là `.` / `..`, hoặc chứa `/ \ ? #` — kể cả dạng mã hoá (`%2F`, `%2e%2e`) vì gateway / proxy có
38
+ * thể decode thêm một lần rồi đổi path (path traversal / SSRF).
39
+ */
40
+ export declare function encodePathSegment(value: unknown): string | null;
41
+ /**
42
+ * Id ghép vào path khớp `pattern` (mặc định `^[A-Za-z0-9_-]{1,64}$`) **và** an toàn theo
43
+ * `encodePathSegment`. `pattern` nên neo `^…$`; cờ `g` / `y` không làm kết quả đổi giữa các lần gọi.
44
+ */
45
+ export declare function isSafePathSegment(value: unknown, pattern?: RegExp): value is string;
15
46
  /**
16
47
  * URL `http(s)` trỏ ra ngoài `origin` (mặc định origin trang hiện tại; ở server không có
17
48
  * `window` thì mọi URL tuyệt đối đều tính là ngoài).
@@ -1 +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"}
1
+ {"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/fn/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,MAAM,kBAAkB,GAAG;IAC7B;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6FAA6F;IAC7F,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,KAAK,IAAI,MAAM,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CA8BzF;AAqCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAwBlE;AAQD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CA8B/D;AAKD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,MAAgC,GAC1C,KAAK,IAAI,MAAM,CAMjB;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 CHANGED
@@ -2,14 +2,22 @@
2
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
3
  * `javascript:`.
4
4
  */
5
+ import { hostAllowed, normalizeHostList } from "../core/safe-url";
5
6
  /** 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
7
  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;
8
+ /** Số lần decode tối đa khi soi dạng mã hoá lồng (`%252F` → `%2F` → `/`). */
9
+ const MAX_DECODE_ROUNDS = 3;
10
+ /** URL tuyệt đối `http:` / `https:` hợp lệ (và thoả `options` nếu có). */
11
+ export function isSafeHttpUrl(value, options) {
12
+ return toSafeHttpUrl(value, options) !== null;
10
13
  }
11
- /** URL `http(s)` đã chuẩn hoá (`URL.href`), hoặc `null` nếu không an toàn. */
12
- export function toSafeHttpUrl(value) {
14
+ /**
15
+ * URL `http(s)` đã chuẩn hoá (`URL.href`), hoặc `null` nếu không an toàn. Không truyền `options` →
16
+ * nhận mọi host (như trước). Có `hosts` → chỉ host trong allowlist, mặc định chặn port lạ và
17
+ * `user:pass@` (chặn nhúng / điều hướng sang trang giả mạo).
18
+ */
19
+ export function toSafeHttpUrl(value, options) {
20
+ const hosts = options?.hosts === undefined ? undefined : normalizeHostList(options.hosts);
13
21
  if (typeof value !== "string") {
14
22
  return null;
15
23
  }
@@ -17,31 +25,143 @@ export function toSafeHttpUrl(value) {
17
25
  if (trimmed === "" || CONTROL_CHARS.test(trimmed)) {
18
26
  return null;
19
27
  }
28
+ let url;
20
29
  try {
21
- const url = new URL(trimmed);
22
- return url.protocol === "http:" || url.protocol === "https:" ? url.href : null;
30
+ url = new URL(trimmed);
23
31
  }
24
32
  catch {
25
33
  return null;
26
34
  }
35
+ if (url.protocol !== "https:" && (url.protocol !== "http:" || options?.httpsOnly === true)) {
36
+ return null;
37
+ }
38
+ if (options) {
39
+ if ((url.username || url.password) && options.allowCredentials !== true) {
40
+ return null;
41
+ }
42
+ if (url.port && (options.allowPort ?? hosts === undefined) !== true) {
43
+ return null;
44
+ }
45
+ if (hosts && !hostAllowed(url.hostname, hosts)) {
46
+ return null;
47
+ }
48
+ }
49
+ return url.href;
50
+ }
51
+ const ASCII_ESCAPE = /%([0-7][0-9a-f])/gi;
52
+ /** UTF-8 overlong của ký tự ASCII (`%C0%AF` = `/`) — decoder cũ / lỏng hiểu thành ký tự thật. */
53
+ const OVERLONG_ESCAPE = /%(?:c[01]|e0%[89]|f0%8)/i;
54
+ /**
55
+ * Decode lặp các escape ASCII `%00`–`%7F` tới khi ổn định (tối đa `MAX_DECODE_ROUNDS`) để soi dạng
56
+ * mã hoá lồng như một gateway / decoder "lỏng" sẽ thấy — escape hỏng xung quanh (`%2F%`) không cản
57
+ * được. Có overlong UTF-8 hoặc lồng sâu hơn giới hạn → `null` (coi là không an toàn).
58
+ */
59
+ function decodeAsciiDeep(value) {
60
+ let current = value;
61
+ for (let round = 0; round <= MAX_DECODE_ROUNDS; round += 1) {
62
+ if (OVERLONG_ESCAPE.test(current)) {
63
+ return null;
64
+ }
65
+ const next = current.replace(ASCII_ESCAPE, (_, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
66
+ if (next === current) {
67
+ return current;
68
+ }
69
+ current = next;
70
+ }
71
+ return null;
72
+ }
73
+ /** `decodeURIComponent` một lần; escape hỏng → chuỗi gốc. */
74
+ function decodeOnce(value) {
75
+ try {
76
+ return decodeURIComponent(value);
77
+ }
78
+ catch {
79
+ return value;
80
+ }
27
81
  }
28
82
  /**
29
83
  * Đườ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`).
84
+ * `//host` hay `/\host` (trình duyệt hiểu là URL khác origin), không có `\`, ký tự điều khiển,
85
+ * segment `..`, hay dạng mã hoá (kể cả lồng nhiều lớp) của chúng (`%2F%2F`, `%252F`, `%5C`, `%2e%2e`).
32
86
  */
33
87
  export function isSafeRelativePath(value) {
34
88
  if (typeof value !== "string" || !value.startsWith("/") || CONTROL_CHARS.test(value)) {
35
89
  return false;
36
90
  }
37
- let decoded = value;
91
+ let strict;
38
92
  try {
39
- decoded = decodeURIComponent(value);
93
+ // `%` hỏng ngay ở chuỗi gốc (`/%E0%A4%A`) → chặn như trước.
94
+ strict = decodeURIComponent(value);
40
95
  }
41
96
  catch {
42
97
  return false;
43
98
  }
44
- return !/^\/[/\\]/.test(decoded) && !decoded.includes("\\") && !CONTROL_CHARS.test(decoded);
99
+ const deep = decodeAsciiDeep(value);
100
+ if (deep === null) {
101
+ return false;
102
+ }
103
+ return [strict, deep].every((decoded) => {
104
+ const path = decoded.split(/[?#]/, 1)[0];
105
+ return (!/^\/[/\\]/.test(decoded) &&
106
+ !decoded.includes("\\") &&
107
+ !CONTROL_CHARS.test(decoded) &&
108
+ !path.split("/").includes(".."));
109
+ });
110
+ }
111
+ /** Độ dài tối đa một segment — id / mã ghép vào URL không cần dài hơn. */
112
+ const MAX_SEGMENT_LENGTH = 256;
113
+ /** Ký tự đổi cấu trúc URL nếu upstream decode lại (`/`, `\`, `?`, `#`). */
114
+ const SEGMENT_BREAKERS = /[/\\?#]/;
115
+ /**
116
+ * Giá trị (thường từ query / body) ghép làm **một** segment của URL gọi backend:
117
+ * `` `${BASE}/users/${seg}/profile` ``. Trả chuỗi đã `encodeURIComponent`, hoặc `null` nếu không
118
+ * an toàn: không phải chuỗi / số hữu hạn, rỗng, dài quá 256, có ký tự điều khiển / khoảng trắng,
119
+ * là `.` / `..`, hoặc chứa `/ \ ? #` — kể cả dạng mã hoá (`%2F`, `%2e%2e`) vì gateway / proxy có
120
+ * thể decode thêm một lần rồi đổi path (path traversal / SSRF).
121
+ */
122
+ export function encodePathSegment(value) {
123
+ let raw;
124
+ if (typeof value === "number") {
125
+ if (!Number.isFinite(value)) {
126
+ return null;
127
+ }
128
+ raw = String(value);
129
+ }
130
+ else if (typeof value === "string") {
131
+ raw = value;
132
+ }
133
+ else {
134
+ return null;
135
+ }
136
+ if (raw === "" || raw.length > MAX_SEGMENT_LENGTH || CONTROL_CHARS.test(raw)) {
137
+ return null;
138
+ }
139
+ const deep = decodeAsciiDeep(raw);
140
+ if (deep === null) {
141
+ return null;
142
+ }
143
+ for (const decoded of [decodeOnce(raw), deep]) {
144
+ if (decoded === "." ||
145
+ decoded === ".." ||
146
+ SEGMENT_BREAKERS.test(decoded) ||
147
+ CONTROL_CHARS.test(decoded)) {
148
+ return null;
149
+ }
150
+ }
151
+ return encodeURIComponent(raw);
152
+ }
153
+ /** Mặc định của `isSafePathSegment`: chữ, số, `_`, `-`, 1–64 ký tự. */
154
+ const DEFAULT_SEGMENT_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
155
+ /**
156
+ * Id ghép vào path khớp `pattern` (mặc định `^[A-Za-z0-9_-]{1,64}$`) **và** an toàn theo
157
+ * `encodePathSegment`. `pattern` nên neo `^…$`; cờ `g` / `y` không làm kết quả đổi giữa các lần gọi.
158
+ */
159
+ export function isSafePathSegment(value, pattern = DEFAULT_SEGMENT_PATTERN) {
160
+ if (typeof value !== "string") {
161
+ return false;
162
+ }
163
+ pattern.lastIndex = 0;
164
+ return pattern.test(value) && encodePathSegment(value) !== null;
45
165
  }
46
166
  /**
47
167
  * URL `http(s)` trỏ ra ngoài `origin` (mặc định origin trang hiện tại; ở server không có
@@ -1 +1 @@
1
- {"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/fn/url.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/fn/url.ts"],"names":[],"mappings":"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"}
@@ -27,6 +27,7 @@ export { useCopyToClipboard } from "./useCopyToClipboard";
27
27
  export { useObjectUrl } from "./useObjectUrl";
28
28
  export { useOnlineStatus } from "./useOnlineStatus";
29
29
  export { usePageVisibility } from "./usePageVisibility";
30
+ export { usePageLifecycle, type PageLifecycleEvent, type PageLifecycleHandlers, } from "./usePageLifecycle";
30
31
  export { useDocumentTitle } from "./useDocumentTitle";
31
32
  export { useLatest } from "./useLatest";
32
33
  export { usePrevious } from "./usePrevious";
@@ -40,4 +41,6 @@ export { useLocalStorage, useSessionStorage, type StorageStateOptions } from "./
40
41
  export { useAsync, type AsyncState } from "./useAsync";
41
42
  export { useAsyncCallback, type AsyncCallback } from "./useAsyncCallback";
42
43
  export { usePolling, type PollingOptions } from "./usePolling";
44
+ export { useQueryState, historyQueryAdapter, type QueryStateAdapter, type QueryStateHistory, type QueryStateOptions, type QueryStateSetOptions, type QueryStateSetter, } from "./useQueryState";
45
+ export { queryParam, type QueryParam, type QueryState, type QueryStateSchema, } from "../fn/query-state";
43
46
  //# sourceMappingURL=index.d.ts.map
@@ -1 +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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"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"}
@@ -27,6 +27,7 @@ export { useCopyToClipboard } from "./useCopyToClipboard";
27
27
  export { useObjectUrl } from "./useObjectUrl";
28
28
  export { useOnlineStatus } from "./useOnlineStatus";
29
29
  export { usePageVisibility } from "./usePageVisibility";
30
+ export { usePageLifecycle, } from "./usePageLifecycle";
30
31
  export { useDocumentTitle } from "./useDocumentTitle";
31
32
  export { useLatest } from "./useLatest";
32
33
  export { usePrevious } from "./usePrevious";
@@ -40,4 +41,6 @@ export { useLocalStorage, useSessionStorage } from "./useStorageState";
40
41
  export { useAsync } from "./useAsync";
41
42
  export { useAsyncCallback } from "./useAsyncCallback";
42
43
  export { usePolling } from "./usePolling";
44
+ export { useQueryState, historyQueryAdapter, } from "./useQueryState";
45
+ export { queryParam, } from "../fn/query-state";
43
46
  //# sourceMappingURL=index.js.map
@@ -1 +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"}
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,EACH,gBAAgB,GAGnB,MAAM,oBAAoB,CAAC;AAC5B,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;AAC/D,OAAO,EACH,aAAa,EACb,mBAAmB,GAMtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,UAAU,GAIb,MAAM,mBAAmB,CAAC"}
@@ -0,0 +1,29 @@
1
+ export type PageLifecycleEvent = {
2
+ /**
3
+ * `true` khi trang hiện lại từ back-forward cache (lần ẩn trước là `pagehide` có `persisted`) —
4
+ * state React còn nguyên như lúc rời trang, không mount lại. Với `onHide`: trang sắp vào bfcache.
5
+ */
6
+ persisted: boolean;
7
+ /** Sự kiện gốc: `visibilitychange`, `pageshow` hoặc `pagehide`. */
8
+ source: "visibility" | "pageshow" | "pagehide";
9
+ };
10
+ export type PageLifecycleHandlers = {
11
+ /** Trang hiện lại (tab hiện, app đưa WebView lên lại, quay lại từ bfcache). */
12
+ onShow?: (event: PageLifecycleEvent) => void;
13
+ /** Trang bị ẩn (đổi tab, app ẩn WebView, rời trang). */
14
+ onHide?: (event: PageLifecycleEvent) => void;
15
+ };
16
+ /**
17
+ * Gọi `onShow` / `onHide` khi trang hiện / ẩn — gộp `visibilitychange` với `pageshow` / `pagehide`
18
+ * (bfcache: back rồi vào lại trang, hoặc WebView được app giữ lại, **không** mount lại component).
19
+ * Chỉ gọi khi trạng thái thực sự đổi (ẩn → hiện, hiện → ẩn) nên trình duyệt bắn cả hai sự kiện
20
+ * cho cùng một lần quay lại vẫn chỉ gọi `onShow` một lần. Handler luôn là bản mới nhất.
21
+ *
22
+ * ```tsx
23
+ * usePageLifecycle({ onShow: () => setTab(defaultTab()) });
24
+ * ```
25
+ */
26
+ export declare function usePageLifecycle(handlers: PageLifecycleHandlers, { enabled }?: {
27
+ enabled?: boolean;
28
+ }): void;
29
+ //# sourceMappingURL=usePageLifecycle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usePageLifecycle.d.ts","sourceRoot":"","sources":["../../src/hooks/usePageLifecycle.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,GAAG;IAC7B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC7C,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,qBAAqB,EAC/B,EAAE,OAAc,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,IAAI,CAkDN"}
@@ -0,0 +1,66 @@
1
+ "use client";
2
+ import { useEffect } from "react";
3
+ import { useLatest } from "./useLatest";
4
+ /**
5
+ * Gọi `onShow` / `onHide` khi trang hiện / ẩn — gộp `visibilitychange` với `pageshow` / `pagehide`
6
+ * (bfcache: back rồi vào lại trang, hoặc WebView được app giữ lại, **không** mount lại component).
7
+ * Chỉ gọi khi trạng thái thực sự đổi (ẩn → hiện, hiện → ẩn) nên trình duyệt bắn cả hai sự kiện
8
+ * cho cùng một lần quay lại vẫn chỉ gọi `onShow` một lần. Handler luôn là bản mới nhất.
9
+ *
10
+ * ```tsx
11
+ * usePageLifecycle({ onShow: () => setTab(defaultTab()) });
12
+ * ```
13
+ */
14
+ export function usePageLifecycle(handlers, { enabled = true } = {}) {
15
+ const handlersRef = useLatest(handlers);
16
+ useEffect(() => {
17
+ if (!enabled) {
18
+ return;
19
+ }
20
+ let visible = document.visibilityState !== "hidden";
21
+ /** Lần ẩn gần nhất là `pagehide` vào bfcache. */
22
+ let cached = false;
23
+ const show = (source) => {
24
+ if (visible) {
25
+ return;
26
+ }
27
+ visible = true;
28
+ const persisted = cached;
29
+ cached = false;
30
+ handlersRef.current.onShow?.({ persisted, source });
31
+ };
32
+ const hide = (source, persisted) => {
33
+ cached = cached || persisted;
34
+ if (!visible) {
35
+ return;
36
+ }
37
+ visible = false;
38
+ handlersRef.current.onHide?.({ persisted, source });
39
+ };
40
+ const onVisibility = () => {
41
+ if (document.visibilityState === "hidden") {
42
+ hide("visibility", false);
43
+ }
44
+ else {
45
+ show("visibility");
46
+ }
47
+ };
48
+ const onPageShow = (event) => {
49
+ // `pageshow` không persisted là lần tải đầu — component vừa mount, không phải "hiện lại".
50
+ if (event.persisted) {
51
+ cached = true;
52
+ show("pageshow");
53
+ }
54
+ };
55
+ const onPageHide = (event) => hide("pagehide", event.persisted);
56
+ document.addEventListener("visibilitychange", onVisibility);
57
+ window.addEventListener("pageshow", onPageShow);
58
+ window.addEventListener("pagehide", onPageHide);
59
+ return () => {
60
+ document.removeEventListener("visibilitychange", onVisibility);
61
+ window.removeEventListener("pageshow", onPageShow);
62
+ window.removeEventListener("pagehide", onPageHide);
63
+ };
64
+ }, [enabled, handlersRef]);
65
+ }
66
+ //# sourceMappingURL=usePageLifecycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usePageLifecycle.js","sourceRoot":"","sources":["../../src/hooks/usePageLifecycle.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAmBxC;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC5B,QAA+B,EAC/B,EAAE,OAAO,GAAG,IAAI,EAAE,GAA0B,EAAE;IAE9C,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO;QACX,CAAC;QACD,IAAI,OAAO,GAAG,QAAQ,CAAC,eAAe,KAAK,QAAQ,CAAC;QACpD,iDAAiD;QACjD,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,MAAM,IAAI,GAAG,CAAC,MAAoC,EAAE,EAAE;YAClD,IAAI,OAAO,EAAE,CAAC;gBACV,OAAO;YACX,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,SAAS,GAAG,MAAM,CAAC;YACzB,MAAM,GAAG,KAAK,CAAC;YACf,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,MAAoC,EAAE,SAAkB,EAAE,EAAE;YACtE,MAAM,GAAG,MAAM,IAAI,SAAS,CAAC;YAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,OAAO;YACX,CAAC;YACD,OAAO,GAAG,KAAK,CAAC;YAChB,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC;QACF,MAAM,YAAY,GAAG,GAAG,EAAE;YACtB,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;gBACxC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,YAAY,CAAC,CAAC;YACvB,CAAC;QACL,CAAC,CAAC;QACF,MAAM,UAAU,GAAG,CAAC,KAA0B,EAAE,EAAE;YAC9C,0FAA0F;YAC1F,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBAClB,MAAM,GAAG,IAAI,CAAC;gBACd,IAAI,CAAC,UAAU,CAAC,CAAC;YACrB,CAAC;QACL,CAAC,CAAC;QACF,MAAM,UAAU,GAAG,CAAC,KAA0B,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACrF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;QAC5D,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAChD,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAChD,OAAO,GAAG,EAAE;YACR,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;YAC/D,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACnD,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACvD,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAC/B,CAAC"}
@@ -1,3 +1,6 @@
1
- /** Tab đang hiển thị — tạm dừng polling / realtime khi ẩn. Server trả `true`. */
1
+ /**
2
+ * Tab đang hiển thị — tạm dừng polling / realtime khi ẩn. Server trả `true`. Cần chạy việc mỗi lần
3
+ * trang hiện lại (kể cả từ bfcache, không mount lại) → `usePageLifecycle`.
4
+ */
2
5
  export declare function usePageVisibility(): boolean;
3
6
  //# sourceMappingURL=usePageVisibility.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"usePageVisibility.d.ts","sourceRoot":"","sources":["../../src/hooks/usePageVisibility.ts"],"names":[],"mappings":"AASA,iFAAiF;AACjF,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}
1
+ {"version":3,"file":"usePageVisibility.d.ts","sourceRoot":"","sources":["../../src/hooks/usePageVisibility.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}
@@ -2,9 +2,17 @@
2
2
  import { useSyncExternalStore } from "react";
3
3
  function subscribe(notify) {
4
4
  document.addEventListener("visibilitychange", notify);
5
- return () => document.removeEventListener("visibilitychange", notify);
5
+ // Quay lại từ bfcache: đọc lại trạng thái (có trình duyệt không bắn visibilitychange).
6
+ window.addEventListener("pageshow", notify);
7
+ return () => {
8
+ document.removeEventListener("visibilitychange", notify);
9
+ window.removeEventListener("pageshow", notify);
10
+ };
6
11
  }
7
- /** Tab đang hiển thị — tạm dừng polling / realtime khi ẩn. Server trả `true`. */
12
+ /**
13
+ * Tab đang hiển thị — tạm dừng polling / realtime khi ẩn. Server trả `true`. Cần chạy việc mỗi lần
14
+ * trang hiện lại (kể cả từ bfcache, không mount lại) → `usePageLifecycle`.
15
+ */
8
16
  export function usePageVisibility() {
9
17
  return useSyncExternalStore(subscribe, () => document.visibilityState !== "hidden", () => true);
10
18
  }
@@ -1 +1 @@
1
- {"version":3,"file":"usePageVisibility.js","sourceRoot":"","sources":["../../src/hooks/usePageVisibility.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,SAAS,SAAS,CAAC,MAAkB;IACjC,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB;IAC7B,OAAO,oBAAoB,CACvB,SAAS,EACT,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAC3C,GAAG,EAAE,CAAC,IAAI,CACb,CAAC;AACN,CAAC"}
1
+ {"version":3,"file":"usePageVisibility.js","sourceRoot":"","sources":["../../src/hooks/usePageVisibility.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,SAAS,SAAS,CAAC,MAAkB;IACjC,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACtD,uFAAuF;IACvF,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,GAAG,EAAE;QACR,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC7B,OAAO,oBAAoB,CACvB,SAAS,EACT,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAC3C,GAAG,EAAE,CAAC,IAAI,CACb,CAAC;AACN,CAAC"}
@@ -0,0 +1,57 @@
1
+ import { type QueryState, type QueryStateSchema } from "../fn/query-state";
2
+ export type QueryStateHistory = "replace" | "push";
3
+ /**
4
+ * Cầu nối tới router — đọc / ghi query string. Mặc định `historyQueryAdapter` (History API của
5
+ * trình duyệt). Next.js App Router: tự dựng từ `useSearchParams` + `router.replace` (xem docs).
6
+ */
7
+ export type QueryStateAdapter = {
8
+ /** Query hiện tại. Gọi trong lúc render — phải rẻ và không có side effect. */
9
+ read(): URLSearchParams;
10
+ /** Ghi query mới (đã gồm khoá lạ của URL cũ). */
11
+ write(params: URLSearchParams, mode: QueryStateHistory): void;
12
+ /**
13
+ * Báo khi URL đổi từ ngoài (back / forward, hook khác ghi). Không có → hook chỉ đọc lại khi
14
+ * render (router tự render lại khi URL đổi, như `useSearchParams` của Next).
15
+ */
16
+ subscribe?(listener: () => void): () => void;
17
+ /** Query dùng khi render ở server và lúc hydrate. Không có → `read()`. */
18
+ readServer?(): URLSearchParams;
19
+ };
20
+ export type QueryStateOptions = {
21
+ /** `replace` (mặc định — không đầy lịch sử back) hoặc `push`. */
22
+ history?: QueryStateHistory;
23
+ /**
24
+ * Hoãn ghi URL (ms) khi lần cập nhật chỉ đổi khoá chữ (`queryParam.string`, hoặc param có
25
+ * `debounce: true`) — state trả về vẫn đổi ngay để ô nhập không giật. Mặc định `0`.
26
+ */
27
+ debounceMs?: number;
28
+ adapter?: QueryStateAdapter;
29
+ };
30
+ export type QueryStateSetOptions = {
31
+ history?: QueryStateHistory;
32
+ /** Ép hoãn (`true`) / ghi ngay (`false`) cho lần này — mặc định theo loại khoá đổi. */
33
+ debounce?: boolean;
34
+ };
35
+ /** `patch` gộp vào state (khoá không truyền giữ nguyên); `null` → về mặc định toàn bộ. */
36
+ export type QueryStateSetter<S extends QueryStateSchema> = (patch: Partial<QueryState<S>> | ((prev: QueryState<S>) => Partial<QueryState<S>>) | null, options?: QueryStateSetOptions) => void;
37
+ /**
38
+ * Adapter mặc định: `window.location.search` + `history.replaceState` / `pushState` (giữ
39
+ * pathname, hash và `history.state`), nghe `popstate`. Không đụng `window` khi import hay khi
40
+ * render ở server (`readServer` rỗng).
41
+ */
42
+ export declare const historyQueryAdapter: QueryStateAdapter;
43
+ /**
44
+ * Đồng bộ một object state (bộ lọc / trang / sort…) với query string theo schema
45
+ * (`queryParam.*`): đọc từ URL, ghi lại bằng `replace` / `push`, giá trị mặc định không lên URL,
46
+ * khoá lạ của URL giữ nguyên. Back / forward cập nhật state.
47
+ *
48
+ * ```tsx
49
+ * const schema = { q: queryParam.string(), page: queryParam.number({ default: 1 }) };
50
+ * const [query, setQuery] = useQueryState(schema, { debounceMs: 300 });
51
+ * setQuery({ q: "abc", page: 1 });
52
+ * ```
53
+ *
54
+ * `schema` nên là hằng ngoài component (hoặc `useMemo`) — state chỉ parse lại khi URL đổi.
55
+ */
56
+ export declare function useQueryState<S extends QueryStateSchema>(schema: S, { history, debounceMs, adapter }?: QueryStateOptions): [QueryState<S>, QueryStateSetter<S>];
57
+ //# sourceMappingURL=useQueryState.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useQueryState.d.ts","sourceRoot":"","sources":["../../src/hooks/useQueryState.ts"],"names":[],"mappings":"AAGA,OAAO,EAIH,KAAK,UAAU,EACf,KAAK,gBAAgB,EACxB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,8EAA8E;IAC9E,IAAI,IAAI,eAAe,CAAC;IACxB,iDAAiD;IACjD,KAAK,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC9D;;;OAGG;IACH,SAAS,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC7C,0EAA0E;IAC1E,UAAU,CAAC,IAAI,eAAe,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,iEAAiE;IACjE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,0FAA0F;AAC1F,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,IAAI,CACvD,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EACxF,OAAO,CAAC,EAAE,oBAAoB,KAC7B,IAAI,CAAC;AAQV;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBA+BjC,CAAC;AAIF;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,gBAAgB,EACpD,MAAM,EAAE,CAAC,EACT,EAAE,OAAmB,EAAE,UAAc,EAAE,OAA6B,EAAE,GAAE,iBAAsB,GAC/F,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAmFtC"}