@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
@@ -517,3 +517,207 @@
517
517
  display: none;
518
518
  }
519
519
  }
520
+
521
+ /*
522
+ * Hiệu ứng đổi file / sheet — nội dung mới (ảnh, bảng, văn bản…) mờ dần vào bằng
523
+ * `@starting-style`; zoom / xoay ảnh đã chạy `transition: transform` ở trên. Tắt hết khi giảm
524
+ * chuyển động (kể cả zoom / xoay).
525
+ */
526
+ @layer components {
527
+ .leaf-file-viewer__content > * {
528
+ transition: opacity 150ms ease;
529
+ }
530
+
531
+ @starting-style {
532
+ .leaf-file-viewer__content > * {
533
+ opacity: 0;
534
+ }
535
+ }
536
+
537
+ @media (prefers-reduced-motion: reduce) {
538
+ .leaf-file-viewer__content > *,
539
+ .leaf-file-viewer__image {
540
+ transition: none;
541
+ }
542
+ }
543
+ }
544
+
545
+ /*
546
+ * Gallery / so sánh (`sources`) — root `.leaf-file-viewer-gallery[data-layout]` bọc một hoặc nhiều
547
+ * `.leaf-file-viewer` y hệt FileViewer một file. DOM do `core/file/gallery.ts` dựng (React + leaf.js).
548
+ * Đổi file ở `single` dùng lại hiệu ứng mờ dần nội dung ở trên; ô mới ở grid / compare hiện ra nhẹ.
549
+ */
550
+ @layer components {
551
+ .leaf-file-viewer-gallery {
552
+ --leaf-file-viewer-gallery-columns: 2;
553
+
554
+ display: flex;
555
+ flex-direction: column;
556
+ gap: 8px;
557
+ box-sizing: border-box;
558
+ width: 100%;
559
+ min-width: 0;
560
+ min-height: 0;
561
+ color: var(--text-primary);
562
+ font-family: var(--font-sans);
563
+ }
564
+
565
+ .leaf-dialog__body > .leaf-file-viewer-gallery,
566
+ .leaf-file-viewer-dialog > .leaf-file-viewer-gallery {
567
+ flex: 1 1 0;
568
+ min-height: 0;
569
+ }
570
+
571
+ .leaf-file-viewer-gallery__stage {
572
+ display: flex;
573
+ flex: 1 1 auto;
574
+ flex-direction: column;
575
+ min-height: 0;
576
+ }
577
+
578
+ .leaf-file-viewer-gallery__nav {
579
+ display: flex;
580
+ flex-shrink: 0;
581
+ align-items: center;
582
+ justify-content: center;
583
+ gap: 8px;
584
+ }
585
+
586
+ .leaf-file-viewer-gallery__counter {
587
+ min-width: 56px;
588
+ color: var(--text-secondary);
589
+ text-align: center;
590
+ font-variant-numeric: tabular-nums;
591
+ }
592
+
593
+ .leaf-file-viewer-gallery__thumbs {
594
+ display: flex;
595
+ flex-shrink: 0;
596
+ gap: 8px;
597
+ padding: 2px;
598
+ overflow-x: auto;
599
+ scrollbar-width: thin;
600
+ }
601
+
602
+ .leaf-file-viewer-gallery__thumb {
603
+ display: inline-flex;
604
+ flex-shrink: 0;
605
+ align-items: center;
606
+ justify-content: center;
607
+ box-sizing: border-box;
608
+ width: 56px;
609
+ height: 56px;
610
+ margin: 0;
611
+ padding: 0;
612
+ overflow: hidden;
613
+ border: 1.5px solid var(--base-tertiary);
614
+ border-radius: 8px;
615
+ background-color: var(--base-secondary);
616
+ color: var(--text-secondary);
617
+ cursor: pointer;
618
+ appearance: none;
619
+ transition:
620
+ border-color 150ms ease,
621
+ opacity 150ms ease;
622
+ }
623
+
624
+ .leaf-file-viewer-gallery__thumb[aria-selected="false"] {
625
+ opacity: 0.72;
626
+ }
627
+
628
+ .leaf-file-viewer-gallery__thumb:hover {
629
+ opacity: 1;
630
+ }
631
+
632
+ .leaf-file-viewer-gallery__thumb[aria-selected="true"] {
633
+ border-color: var(--text-highlight);
634
+ }
635
+
636
+ .leaf-file-viewer-gallery__thumb:focus-visible {
637
+ outline: 2px solid var(--text-highlight);
638
+ outline-offset: 2px;
639
+ }
640
+
641
+ .leaf-file-viewer-gallery__thumb > img {
642
+ display: block;
643
+ width: 100%;
644
+ height: 100%;
645
+ object-fit: cover;
646
+ user-select: none;
647
+ -webkit-user-select: none;
648
+ }
649
+
650
+ .leaf-file-viewer-gallery__thumb > svg {
651
+ display: block;
652
+ width: 24px;
653
+ height: 24px;
654
+ }
655
+
656
+ /* grid: ô tự co theo bề rộng · compare: mọi file cạnh nhau một hàng. */
657
+ .leaf-file-viewer-gallery__items {
658
+ display: grid;
659
+ grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
660
+ gap: 12px;
661
+ min-width: 0;
662
+ }
663
+
664
+ .leaf-file-viewer-gallery[data-layout="compare"] .leaf-file-viewer-gallery__items {
665
+ grid-template-columns: repeat(var(--leaf-file-viewer-gallery-columns), minmax(0, 1fr));
666
+ }
667
+
668
+ .leaf-file-viewer-gallery[data-layout="grid"] .leaf-file-viewer {
669
+ --leaf-file-viewer-height: 320px;
670
+ }
671
+
672
+ .leaf-file-viewer-gallery__item {
673
+ display: flex;
674
+ flex-direction: column;
675
+ gap: 6px;
676
+ min-width: 0;
677
+ margin: 0;
678
+ transition: opacity 150ms ease;
679
+ }
680
+
681
+ @starting-style {
682
+ .leaf-file-viewer-gallery__item {
683
+ opacity: 0;
684
+ }
685
+ }
686
+
687
+ .leaf-file-viewer-gallery__item[data-active="true"] > .leaf-file-viewer {
688
+ border-color: var(--text-highlight);
689
+ }
690
+
691
+ .leaf-file-viewer-gallery__caption {
692
+ min-width: 0;
693
+ overflow: hidden;
694
+ color: var(--text-secondary);
695
+ text-align: center;
696
+ text-overflow: ellipsis;
697
+ white-space: nowrap;
698
+ }
699
+
700
+ @media (max-width: 640px) {
701
+ .leaf-file-viewer-gallery[data-layout="compare"] .leaf-file-viewer-gallery__items {
702
+ grid-template-columns: minmax(0, 1fr);
703
+ }
704
+ }
705
+
706
+ @media (prefers-reduced-motion: reduce) {
707
+ .leaf-file-viewer-gallery__thumb,
708
+ .leaf-file-viewer-gallery__item {
709
+ transition: none;
710
+ }
711
+ }
712
+
713
+ .leaf-file-viewer-gallery[hidden],
714
+ .leaf-file-viewer-gallery__stage[hidden],
715
+ .leaf-file-viewer-gallery__nav[hidden],
716
+ .leaf-file-viewer-gallery__thumbs[hidden],
717
+ .leaf-file-viewer-gallery__thumb[hidden],
718
+ .leaf-file-viewer-gallery__items[hidden],
719
+ .leaf-file-viewer-gallery__item[hidden],
720
+ .leaf-file-viewer-gallery__caption[hidden] {
721
+ display: none;
722
+ }
723
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/fn/cookie.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAc9F"}
1
+ {"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/fn/cookie.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAe9F"}
package/dist/fn/cookie.js CHANGED
@@ -1,10 +1,17 @@
1
+ /**
2
+ * Giới hạn đầu vào — header `Cookie` thật không vượt ~16 KB (giới hạn header mặc định của Node /
3
+ * nginx), nên chỉ đọc 32 KB / 512 cặp đầu; chuỗi lớn bất thường không làm parse tốn tài nguyên.
4
+ */
5
+ const MAX_COOKIE_STRING = 32 * 1024;
6
+ const MAX_COOKIE_PAIRS = 512;
1
7
  /**
2
8
  * Đọc cookie từ chuỗi `Cookie` (header request ở server, hoặc chuỗi cookie trình duyệt do app tự
3
9
  * truyền vào). Leaf không tự đọc / ghi cookie của trình duyệt — `check-dist` chặn package chạm
4
10
  * cookie để giảm rủi ro chuỗi cung ứng; cookie phiên luôn là HttpOnly do server đặt.
5
11
  */
6
12
  export function getCookie(name, cookieString) {
7
- for (const part of (cookieString ?? "").split(";")) {
13
+ const source = (cookieString ?? "").slice(0, MAX_COOKIE_STRING);
14
+ for (const part of source.split(";", MAX_COOKIE_PAIRS)) {
8
15
  const index = part.indexOf("=");
9
16
  const key = (index < 0 ? part : part.slice(0, index)).trim();
10
17
  if (key === name) {
@@ -1 +1 @@
1
- {"version":3,"file":"cookie.js","sourceRoot":"","sources":["../../src/fn/cookie.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,YAAuC;IAC3E,KAAK,MAAM,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1D,IAAI,CAAC;gBACD,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,GAAG,CAAC;YACf,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}
1
+ {"version":3,"file":"cookie.js","sourceRoot":"","sources":["../../src/fn/cookie.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC;AACpC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,YAAuC;IAC3E,MAAM,MAAM,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAChE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1D,IAAI,CAAC;gBACD,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,GAAG,CAAC;YACf,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}
@@ -6,10 +6,11 @@ export { debounce, throttle, createBatcher, type Batcher, type BatcherOptions, t
6
6
  export { retry, timeoutSignal, type RetryOptions } from "./async";
7
7
  export { getErrorMessage, type ErrorMessageOptions } from "./error";
8
8
  export { includesText, normalizeSearch, removeVietnameseTones, slugify } from "./string";
9
- export { externalLinkProps, isExternalUrl, isSafeHttpUrl, isSafeRelativePath, openExternal, toSafeHttpUrl, } from "./url";
9
+ export { encodePathSegment, externalLinkProps, isExternalUrl, isSafeHttpUrl, isSafePathSegment, isSafeRelativePath, openExternal, toSafeHttpUrl, type SafeHttpUrlOptions, } from "./url";
10
10
  export { decodeEntities, escapeHtml, stringifyForScript, toPlainText, type DecodeEntitiesOptions, } from "./html";
11
- export { createSanitizer, extendSanitizeOptions, parseSafeHtml, sanitizeCss, sanitizeHtml, serializeSafeHtml, SANITIZE_FORBIDDEN_TAGS, SANITIZE_PRESETS, type AttributeRule, type SafeElement, type SafeHtmlResult, type SafeNode, type SafeStyle, type SafeText, type SanitizeCssOptions, type SanitizeIframeOptions, type SanitizeOptions, type Sanitizer, type StylePolicy, type StyleValueRule, } from "./sanitize";
11
+ export { createSanitizer, extendSanitizeOptions, parseSafeHtml, sanitizeCss, sanitizeHtml, serializeSafeHtml, SANITIZE_FORBIDDEN_TAGS, SANITIZE_PRESETS, type AttributeRule, type SafeElement, type SafeHtmlResult, type SafeNode, type SafeStyle, type SafeText, type SanitizeCssOptions, type SanitizeIframeOptions, type SanitizeLinkOptions, type SanitizeOptions, type Sanitizer, type StylePolicy, type StyleValueRule, } from "./sanitize";
12
12
  export { queryFromSearchParams, toSearchParams, type QueryInput, type QueryObject } from "./query";
13
+ export { isSameQueryValue, parseQueryState, queryParam, serializeQueryState, type QueryParam, type QueryState, type QueryStateSchema, } from "./query-state";
13
14
  export { getCookie } from "./cookie";
14
15
  export { getStorageItem, getStorageJson, removeStorageItem, setStorageItem, setStorageJson, type StorageArea, } from "./storage";
15
16
  export { decodeJwtPayload, isJwtExpired } from "./jwt";
@@ -27,13 +28,15 @@ export { FileReadError, isFileReadError, type FileErrorCode } from "../core/file
27
28
  export { base64ToBlob, readFileSource, FILE_DEFAULT_MAX_SIZE, type FileSource, type FileSourceBase64, type LoadedFile, type ReadFileSourceOptions, } from "../core/file/source";
28
29
  export { detectFileType, type DetectFileTypeOptions, type FileKind } from "../core/file/detect";
29
30
  export { readText } from "../core/file/text";
30
- export { readDocxText } from "../core/file/docx";
31
+ export { readDocxText } from "../core/file/docx-read";
31
32
  export { parseCsv, parseCsvRecords, toCsv, type CsvDelimiter, type ParseCsvOptions, type ParseCsvRecordsOptions, type ToCsvOptions, } from "../core/file/csv";
32
- export { readSpreadsheet, readSpreadsheetRecords, sheetToRecords, spreadsheetToCsv, SPREADSHEET_MAX_CELLS, type ReadSpreadsheetOptions, type ReadSpreadsheetRecordsOptions, type SheetToRecordsOptions, type SpreadsheetRecordValue, type Spreadsheet, type SpreadsheetCell, type SpreadsheetCellType, type SpreadsheetMerge, type SpreadsheetSheet, type SpreadsheetToCsvOptions, } from "../core/file/xlsx";
33
+ export { readSpreadsheet, readSpreadsheetRecords } from "../core/file/xlsx-read";
34
+ export { sheetToRecords, spreadsheetToCsv, SPREADSHEET_MAX_CELLS, type ReadSpreadsheetOptions, type ReadSpreadsheetRecordsOptions, type SheetToRecordsOptions, type SpreadsheetRecordValue, type Spreadsheet, type SpreadsheetCell, type SpreadsheetCellType, type SpreadsheetMerge, type SpreadsheetSheet, type SpreadsheetToCsvOptions, } from "../core/file/xlsx";
33
35
  export { type CellFormatOptions } from "../core/file/xlsx-format";
34
36
  export { jsonToSheetRows, writeXlsx, XLSX_MIME_TYPE, type SheetColumn, type WriteXlsxOptions, type XlsxCellValue, type XlsxSheetInput, } from "../core/file/xlsx-write";
35
37
  export { csvBlob, downloadBlob, downloadCsv, downloadXlsx, type CsvBlobOptions, } from "../core/file/download";
36
38
  export { progressPercent } from "../core/progress";
37
39
  export { initialsOf } from "../core/avatar";
38
40
  export { formatFileSize, matchesAccept } from "../core/upload";
41
+ export { diffJson, formatJsonPath, stringifyJson, summarizeJsonDiff, type JsonDiffEntry, type JsonDiffKind, type JsonDiffOptions, type JsonDiffSummary, type JsonPathSegment, } from "../core/json-diff";
39
42
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fn/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fn/index.ts"],"names":[],"mappings":"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"}
package/dist/fn/index.js CHANGED
@@ -6,10 +6,11 @@ export { debounce, throttle, createBatcher, } from "../core/pacer";
6
6
  export { retry, timeoutSignal } from "./async";
7
7
  export { getErrorMessage } from "./error";
8
8
  export { includesText, normalizeSearch, removeVietnameseTones, slugify } from "./string";
9
- export { externalLinkProps, isExternalUrl, isSafeHttpUrl, isSafeRelativePath, openExternal, toSafeHttpUrl, } from "./url";
9
+ export { encodePathSegment, externalLinkProps, isExternalUrl, isSafeHttpUrl, isSafePathSegment, isSafeRelativePath, openExternal, toSafeHttpUrl, } from "./url";
10
10
  export { decodeEntities, escapeHtml, stringifyForScript, toPlainText, } from "./html";
11
11
  export { createSanitizer, extendSanitizeOptions, parseSafeHtml, sanitizeCss, sanitizeHtml, serializeSafeHtml, SANITIZE_FORBIDDEN_TAGS, SANITIZE_PRESETS, } from "./sanitize";
12
12
  export { queryFromSearchParams, toSearchParams } from "./query";
13
+ export { isSameQueryValue, parseQueryState, queryParam, serializeQueryState, } from "./query-state";
13
14
  export { getCookie } from "./cookie";
14
15
  export { getStorageItem, getStorageJson, removeStorageItem, setStorageItem, setStorageJson, } from "./storage";
15
16
  export { decodeJwtPayload, isJwtExpired } from "./jwt";
@@ -28,13 +29,16 @@ export { FileReadError, isFileReadError } from "../core/file/error";
28
29
  export { base64ToBlob, readFileSource, FILE_DEFAULT_MAX_SIZE, } from "../core/file/source";
29
30
  export { detectFileType } from "../core/file/detect";
30
31
  export { readText } from "../core/file/text";
31
- export { readDocxText } from "../core/file/docx";
32
+ export { readDocxText } from "../core/file/docx-read";
32
33
  export { parseCsv, parseCsvRecords, toCsv, } from "../core/file/csv";
33
- export { readSpreadsheet, readSpreadsheetRecords, sheetToRecords, spreadsheetToCsv, SPREADSHEET_MAX_CELLS, } from "../core/file/xlsx";
34
+ export { readSpreadsheet, readSpreadsheetRecords } from "../core/file/xlsx-read";
35
+ export { sheetToRecords, spreadsheetToCsv, SPREADSHEET_MAX_CELLS, } from "../core/file/xlsx";
34
36
  export {} from "../core/file/xlsx-format";
35
37
  export { jsonToSheetRows, writeXlsx, XLSX_MIME_TYPE, } from "../core/file/xlsx-write";
36
38
  export { csvBlob, downloadBlob, downloadCsv, downloadXlsx, } from "../core/file/download";
37
39
  export { progressPercent } from "../core/progress";
38
40
  export { initialsOf } from "../core/avatar";
39
41
  export { formatFileSize, matchesAccept } from "../core/upload";
42
+ // So sánh JSON theo đường dẫn khoá (audit log) — cùng thuật toán của `<DiffView>`.
43
+ export { diffJson, formatJsonPath, stringifyJson, summarizeJsonDiff, } from "../core/json-diff";
40
44
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fn/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fn/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,97 @@
1
+ /**
2
+ * State ↔ query string theo schema — logic thuần của `useQueryState` (entry `/hooks`), cũng
3
+ * dùng được ở server (đọc `searchParams` của request) và trang tĩnh (`Leaf.utils`).
4
+ *
5
+ * Mỗi khoá của schema là một `QueryParam`: parse mảng chuỗi của khoá đó (key lặp → nhiều
6
+ * phần tử) thành giá trị, và serialize ngược lại. Giá trị bằng `default` hoặc `undefined` không
7
+ * ghi lên URL (URL ngắn, link chia sẻ gọn). Khoá ngoài schema được giữ nguyên khi ghi.
8
+ *
9
+ * An toàn: parser không bao giờ `eval` / `JSON.parse` dữ liệu URL thành object tuỳ ý — `enum`
10
+ * chỉ nhận giá trị trong danh sách; khoá `__proto__` / `constructor` / `prototype` bị bỏ.
11
+ */
12
+ export type QueryParam<T> = {
13
+ /** Mảng chuỗi của khoá (rỗng = không có trên URL) → giá trị. Hỏng → về `default`. */
14
+ parse(values: readonly string[]): T;
15
+ /** Giá trị → mảng chuỗi ghi lên URL (rỗng = bỏ khoá). */
16
+ serialize(value: T): string[];
17
+ /** Giá trị mặc định (không ghi lên URL). */
18
+ readonly default: T;
19
+ /**
20
+ * Ô gõ chữ — `useQueryState` hoãn ghi URL theo `debounceMs` khi chỉ các khoá loại này đổi.
21
+ * Mặc định `true` cho `string`, `false` cho loại khác.
22
+ */
23
+ readonly debounce: boolean;
24
+ };
25
+ export type QueryStateSchema = Record<string, QueryParam<any>>;
26
+ /** Kiểu state suy ra từ schema. */
27
+ export type QueryState<S extends QueryStateSchema> = {
28
+ [K in keyof S]: S[K] extends QueryParam<infer T> ? T : never;
29
+ };
30
+ type ParamOptions<T> = {
31
+ default?: T;
32
+ debounce?: boolean;
33
+ };
34
+ type ArrayOptions<T> = {
35
+ /** Parser cho từng phần tử (mặc định chuỗi). */
36
+ of?: QueryParam<T | undefined> | QueryParam<T>;
37
+ /** `repeat` (mặc định): `?s=a&s=b` · `comma`: `?s=a,b`. */
38
+ format?: "repeat" | "comma";
39
+ default?: T[];
40
+ };
41
+ type NumberOptions = {
42
+ integer?: boolean;
43
+ min?: number;
44
+ max?: number;
45
+ };
46
+ type DateOptions = {
47
+ withTime?: boolean;
48
+ };
49
+ declare function stringParam(options: ParamOptions<string> & {
50
+ default: string;
51
+ }): QueryParam<string>;
52
+ declare function stringParam(options?: ParamOptions<string>): QueryParam<string | undefined>;
53
+ declare function numberParam(options: ParamOptions<number> & NumberOptions & {
54
+ default: number;
55
+ }): QueryParam<number>;
56
+ declare function numberParam(options?: ParamOptions<number> & NumberOptions): QueryParam<number | undefined>;
57
+ declare function booleanParam(options?: ParamOptions<boolean>): QueryParam<boolean>;
58
+ declare function dateParam(options: ParamOptions<Date> & DateOptions & {
59
+ default: Date;
60
+ }): QueryParam<Date>;
61
+ declare function dateParam(options?: ParamOptions<Date> & DateOptions): QueryParam<Date | undefined>;
62
+ declare function enumParam<const V extends string>(values: readonly V[], options: ParamOptions<V> & {
63
+ default: V;
64
+ }): QueryParam<V>;
65
+ declare function enumParam<const V extends string>(values: readonly V[], options?: ParamOptions<V>): QueryParam<V | undefined>;
66
+ declare function arrayParam<T = string>(options?: ArrayOptions<T>): QueryParam<T[]>;
67
+ /**
68
+ * Bộ parser cho `useQueryState` / `parseQueryState`. Không truyền `default` → giá trị là
69
+ * `undefined` khi URL không có khoá (array mặc định `[]`, boolean mặc định `false`).
70
+ *
71
+ * - `string()` — chuỗi (rỗng = không có); mặc định hoãn ghi theo `debounceMs`.
72
+ * - `number({ integer, min, max })` — số hữu hạn, kẹp min / max.
73
+ * - `boolean()` — `true` / `1` · `false` / `0`.
74
+ * - `date({ withTime })` — `YYYY-MM-DD` (giờ máy) hoặc ISO đủ giờ.
75
+ * - `enum(values)` — chỉ nhận giá trị trong danh sách.
76
+ * - `array({ of, format: "repeat" | "comma" })` — `?s=a&s=b` hoặc `?s=a,b`.
77
+ */
78
+ export declare const queryParam: {
79
+ string: typeof stringParam;
80
+ number: typeof numberParam;
81
+ boolean: typeof booleanParam;
82
+ date: typeof dateParam;
83
+ enum: typeof enumParam;
84
+ array: typeof arrayParam;
85
+ };
86
+ /** Hai giá trị của cùng một tham số có ghi ra URL giống nhau không. */
87
+ export declare function isSameQueryValue<T>(param: QueryParam<T>, a: T, b: T): boolean;
88
+ /** Query string → state theo schema (khoá thiếu / hỏng → `default`). */
89
+ export declare function parseQueryState<S extends QueryStateSchema>(schema: S, params: URLSearchParams | string): QueryState<S>;
90
+ /**
91
+ * State → `URLSearchParams`: ghi đè khoá của schema lên `base` (giữ nguyên khoá lạ và thứ tự của
92
+ * chúng), bỏ khoá có giá trị bằng `default` / `undefined`. Khoá schema không có trong `state`
93
+ * giữ nguyên giá trị đang có trên `base`.
94
+ */
95
+ export declare function serializeQueryState<S extends QueryStateSchema>(schema: S, state: Partial<QueryState<S>>, base?: URLSearchParams | string): URLSearchParams;
96
+ export {};
97
+ //# sourceMappingURL=query-state.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query-state.d.ts","sourceRoot":"","sources":["../../src/fn/query-state.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,163 @@
1
+ /**
2
+ * State ↔ query string theo schema — logic thuần của `useQueryState` (entry `/hooks`), cũng
3
+ * dùng được ở server (đọc `searchParams` của request) và trang tĩnh (`Leaf.utils`).
4
+ *
5
+ * Mỗi khoá của schema là một `QueryParam`: parse mảng chuỗi của khoá đó (key lặp → nhiều
6
+ * phần tử) thành giá trị, và serialize ngược lại. Giá trị bằng `default` hoặc `undefined` không
7
+ * ghi lên URL (URL ngắn, link chia sẻ gọn). Khoá ngoài schema được giữ nguyên khi ghi.
8
+ *
9
+ * An toàn: parser không bao giờ `eval` / `JSON.parse` dữ liệu URL thành object tuỳ ý — `enum`
10
+ * chỉ nhận giá trị trong danh sách; khoá `__proto__` / `constructor` / `prototype` bị bỏ.
11
+ */
12
+ const PROTOTYPE_KEYS = new Set(["__proto__", "constructor", "prototype"]);
13
+ const ISO_DATE_ONLY = /^(\d{4})-(\d{2})-(\d{2})$/;
14
+ function createParam(fallback, options, debounce, parseOne, serializeOne) {
15
+ const defaultValue = options.default === undefined ? fallback : options.default;
16
+ return {
17
+ default: defaultValue,
18
+ debounce: options.debounce ?? debounce,
19
+ parse(values) {
20
+ // Key lặp với tham số đơn → lấy giá trị cuối (giống form ghi đè).
21
+ const raw = values[values.length - 1];
22
+ if (raw === undefined) {
23
+ return defaultValue;
24
+ }
25
+ const parsed = parseOne(raw);
26
+ return parsed === undefined ? defaultValue : parsed;
27
+ },
28
+ serialize(value) {
29
+ const raw = value == null ? "" : serializeOne(value);
30
+ // Chuỗi rỗng = không có khoá (ô tìm kiếm xoá hết chữ không để lại `?q=`).
31
+ return raw === "" ? [] : [raw];
32
+ },
33
+ };
34
+ }
35
+ function pad(value, length = 2) {
36
+ return String(value).padStart(length, "0");
37
+ }
38
+ /** `Date` → `YYYY-MM-DD` theo giờ máy (cùng ngày người dùng thấy trên lịch). */
39
+ function formatLocalDate(date) {
40
+ return `${pad(date.getFullYear(), 4)}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
41
+ }
42
+ function parseDate(raw, withTime) {
43
+ const match = ISO_DATE_ONLY.exec(raw);
44
+ const date = match
45
+ ? new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3]))
46
+ : withTime
47
+ ? new Date(raw)
48
+ : undefined;
49
+ return date && !Number.isNaN(date.getTime()) ? date : undefined;
50
+ }
51
+ function stringParam(options = {}) {
52
+ return createParam(options.default, options, true, (raw) => (raw === "" ? undefined : raw), String);
53
+ }
54
+ function numberParam(options = {}) {
55
+ return createParam(options.default, options, false, (raw) => {
56
+ const value = raw.trim() === "" ? Number.NaN : Number(raw);
57
+ if (!Number.isFinite(value) || (options.integer && !Number.isInteger(value))) {
58
+ return undefined;
59
+ }
60
+ return Math.min(options.max ?? Infinity, Math.max(options.min ?? -Infinity, value));
61
+ }, String);
62
+ }
63
+ function booleanParam(options = {}) {
64
+ return createParam(false, options, false, (raw) => raw === "true" || raw === "1"
65
+ ? true
66
+ : raw === "false" || raw === "0"
67
+ ? false
68
+ : undefined, String);
69
+ }
70
+ function dateParam(options = {}) {
71
+ const withTime = Boolean(options.withTime);
72
+ return createParam(options.default, options, false, (raw) => parseDate(raw, withTime), (date) => (withTime ? date.toISOString() : formatLocalDate(date)));
73
+ }
74
+ function enumParam(values, options = {}) {
75
+ return createParam(options.default, options, false, (raw) => (values.includes(raw) ? raw : undefined), String);
76
+ }
77
+ function arrayParam(options = {}) {
78
+ const item = (options.of ?? stringParam());
79
+ const comma = options.format === "comma";
80
+ const defaultValue = options.default ?? [];
81
+ return {
82
+ default: defaultValue,
83
+ debounce: false,
84
+ parse(values) {
85
+ if (values.length === 0) {
86
+ return defaultValue;
87
+ }
88
+ const raws = comma ? values.flatMap((value) => value.split(",")) : values;
89
+ return raws
90
+ .filter((raw) => raw !== "")
91
+ .map((raw) => item.parse([raw]))
92
+ .filter((value) => value !== undefined);
93
+ },
94
+ serialize(value) {
95
+ const raws = value.flatMap((entry) => item.serialize(entry));
96
+ return comma ? (raws.length > 0 ? [raws.join(",")] : []) : raws;
97
+ },
98
+ };
99
+ }
100
+ /**
101
+ * Bộ parser cho `useQueryState` / `parseQueryState`. Không truyền `default` → giá trị là
102
+ * `undefined` khi URL không có khoá (array mặc định `[]`, boolean mặc định `false`).
103
+ *
104
+ * - `string()` — chuỗi (rỗng = không có); mặc định hoãn ghi theo `debounceMs`.
105
+ * - `number({ integer, min, max })` — số hữu hạn, kẹp min / max.
106
+ * - `boolean()` — `true` / `1` · `false` / `0`.
107
+ * - `date({ withTime })` — `YYYY-MM-DD` (giờ máy) hoặc ISO đủ giờ.
108
+ * - `enum(values)` — chỉ nhận giá trị trong danh sách.
109
+ * - `array({ of, format: "repeat" | "comma" })` — `?s=a&s=b` hoặc `?s=a,b`.
110
+ */
111
+ export const queryParam = {
112
+ string: stringParam,
113
+ number: numberParam,
114
+ boolean: booleanParam,
115
+ date: dateParam,
116
+ enum: enumParam,
117
+ array: arrayParam,
118
+ };
119
+ function sameValues(a, b) {
120
+ return a.length === b.length && a.every((value, index) => value === b[index]);
121
+ }
122
+ /** Hai giá trị của cùng một tham số có ghi ra URL giống nhau không. */
123
+ export function isSameQueryValue(param, a, b) {
124
+ return sameValues(param.serialize(a), param.serialize(b));
125
+ }
126
+ function toParams(params) {
127
+ return typeof params === "string" ? new URLSearchParams(params) : params;
128
+ }
129
+ /** Query string → state theo schema (khoá thiếu / hỏng → `default`). */
130
+ export function parseQueryState(schema, params) {
131
+ const source = toParams(params);
132
+ const state = {};
133
+ for (const [key, param] of Object.entries(schema)) {
134
+ if (PROTOTYPE_KEYS.has(key)) {
135
+ continue;
136
+ }
137
+ state[key] = param.parse(source.getAll(key));
138
+ }
139
+ return state;
140
+ }
141
+ /**
142
+ * State → `URLSearchParams`: ghi đè khoá của schema lên `base` (giữ nguyên khoá lạ và thứ tự của
143
+ * chúng), bỏ khoá có giá trị bằng `default` / `undefined`. Khoá schema không có trong `state`
144
+ * giữ nguyên giá trị đang có trên `base`.
145
+ */
146
+ export function serializeQueryState(schema, state, base = "") {
147
+ const next = new URLSearchParams(toParams(base));
148
+ for (const [key, param] of Object.entries(schema)) {
149
+ if (PROTOTYPE_KEYS.has(key) || !Object.hasOwn(state, key)) {
150
+ continue;
151
+ }
152
+ const value = state[key];
153
+ next.delete(key);
154
+ if (value === undefined || isSameQueryValue(param, value, param.default)) {
155
+ continue;
156
+ }
157
+ for (const raw of param.serialize(value)) {
158
+ next.append(key, raw);
159
+ }
160
+ }
161
+ return next;
162
+ }
163
+ //# sourceMappingURL=query-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query-state.js","sourceRoot":"","sources":["../../src/fn/query-state.ts"],"names":[],"mappings":"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"}
@@ -10,6 +10,6 @@
10
10
  *
11
11
  * Render trong React: dùng `<SafeHtml>` (entry chính) thay cho gán HTML thô.
12
12
  */
13
- export { createSanitizer, extendSanitizeOptions, parseSafeHtml, sanitizeHtml, serializeSafeHtml, SANITIZE_FORBIDDEN_TAGS, SANITIZE_PRESETS, type AttributeRule, type SafeElement, type SafeHtmlResult, type SafeNode, type SafeStyle, type SafeText, type SanitizeIframeOptions, type SanitizeOptions, type Sanitizer, } from "../core/html/sanitize";
13
+ export { createSanitizer, extendSanitizeOptions, parseSafeHtml, sanitizeHtml, serializeSafeHtml, SANITIZE_FORBIDDEN_TAGS, SANITIZE_PRESETS, type AttributeRule, type SafeElement, type SafeHtmlResult, type SafeNode, type SafeStyle, type SafeText, type SanitizeIframeOptions, type SanitizeLinkOptions, type SanitizeOptions, type Sanitizer, } from "../core/html/sanitize";
14
14
  export { sanitizeCss, type SanitizeCssOptions, type StylePolicy, type StyleValueRule, } from "../core/html/css";
15
15
  //# sourceMappingURL=sanitize.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/fn/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACH,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,SAAS,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACH,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,cAAc,GACtB,MAAM,kBAAkB,CAAC"}
1
+ {"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/fn/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACH,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,SAAS,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACH,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,cAAc,GACtB,MAAM,kBAAkB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/fn/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACH,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,GAUnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACH,WAAW,GAId,MAAM,kBAAkB,CAAC"}
1
+ {"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/fn/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACH,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,GAWnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACH,WAAW,GAId,MAAM,kBAAkB,CAAC"}