@finhay-pro/leaf-design-system 0.2.5 → 0.2.7

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 (523) hide show
  1. package/README.md +131 -6
  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.7.core.min.css +2 -0
  7. package/dist/cdn/leaf-0.2.7.core.min.js +15 -0
  8. package/dist/cdn/leaf-0.2.7.min.css +2 -0
  9. package/dist/cdn/leaf-0.2.7.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 +5040 -1938
  44. package/dist/components/Accordion/Accordion.d.ts +1 -1
  45. package/dist/components/Accordion/Accordion.d.ts.map +1 -1
  46. package/dist/components/Alert/Alert.d.ts +38 -0
  47. package/dist/components/Alert/Alert.d.ts.map +1 -0
  48. package/dist/components/Alert/Alert.js +32 -0
  49. package/dist/components/Alert/Alert.js.map +1 -0
  50. package/dist/components/Alert/index.d.ts +2 -0
  51. package/dist/components/Alert/index.d.ts.map +1 -0
  52. package/dist/components/Alert/index.js +2 -0
  53. package/dist/components/Alert/index.js.map +1 -0
  54. package/dist/components/Breadcrumb/index.d.ts +1 -1
  55. package/dist/components/Breadcrumb/index.d.ts.map +1 -1
  56. package/dist/components/Breadcrumb/index.js +1 -1
  57. package/dist/components/Breadcrumb/index.js.map +1 -1
  58. package/dist/components/BulkActionBar/BulkActionBar.d.ts +21 -0
  59. package/dist/components/BulkActionBar/BulkActionBar.d.ts.map +1 -0
  60. package/dist/components/BulkActionBar/BulkActionBar.js +27 -0
  61. package/dist/components/BulkActionBar/BulkActionBar.js.map +1 -0
  62. package/dist/components/BulkActionBar/index.d.ts +2 -0
  63. package/dist/components/BulkActionBar/index.d.ts.map +1 -0
  64. package/dist/components/BulkActionBar/index.js +2 -0
  65. package/dist/components/BulkActionBar/index.js.map +1 -0
  66. package/dist/components/CalendarRange/CalendarRange.d.ts +14 -1
  67. package/dist/components/CalendarRange/CalendarRange.d.ts.map +1 -1
  68. package/dist/components/CalendarRange/CalendarRange.js +84 -10
  69. package/dist/components/CalendarRange/CalendarRange.js.map +1 -1
  70. package/dist/components/Carousel/Carousel.d.ts +19 -5
  71. package/dist/components/Carousel/Carousel.d.ts.map +1 -1
  72. package/dist/components/Carousel/Carousel.js +67 -63
  73. package/dist/components/Carousel/Carousel.js.map +1 -1
  74. package/dist/components/Carousel/index.d.ts +1 -1
  75. package/dist/components/Carousel/index.d.ts.map +1 -1
  76. package/dist/components/Carousel/index.js.map +1 -1
  77. package/dist/components/ConfirmDialog/ConfirmDialog.d.ts +69 -0
  78. package/dist/components/ConfirmDialog/ConfirmDialog.d.ts.map +1 -0
  79. package/dist/components/ConfirmDialog/ConfirmDialog.js +146 -0
  80. package/dist/components/ConfirmDialog/ConfirmDialog.js.map +1 -0
  81. package/dist/components/ConfirmDialog/index.d.ts +3 -0
  82. package/dist/components/ConfirmDialog/index.d.ts.map +1 -0
  83. package/dist/components/ConfirmDialog/index.js +3 -0
  84. package/dist/components/ConfirmDialog/index.js.map +1 -0
  85. package/dist/components/Descriptions/Descriptions.d.ts +60 -0
  86. package/dist/components/Descriptions/Descriptions.d.ts.map +1 -0
  87. package/dist/components/Descriptions/Descriptions.js +50 -0
  88. package/dist/components/Descriptions/Descriptions.js.map +1 -0
  89. package/dist/components/Descriptions/index.d.ts +2 -0
  90. package/dist/components/Descriptions/index.d.ts.map +1 -0
  91. package/dist/components/Descriptions/index.js +2 -0
  92. package/dist/components/Descriptions/index.js.map +1 -0
  93. package/dist/components/Dialog/Dialog.d.ts +6 -1
  94. package/dist/components/Dialog/Dialog.d.ts.map +1 -1
  95. package/dist/components/Dialog/Dialog.js +2 -1
  96. package/dist/components/Dialog/Dialog.js.map +1 -1
  97. package/dist/components/DiffView/DiffView.d.ts +36 -0
  98. package/dist/components/DiffView/DiffView.d.ts.map +1 -0
  99. package/dist/components/DiffView/DiffView.js +28 -0
  100. package/dist/components/DiffView/DiffView.js.map +1 -0
  101. package/dist/components/DiffView/index.d.ts +2 -0
  102. package/dist/components/DiffView/index.d.ts.map +1 -0
  103. package/dist/components/DiffView/index.js +2 -0
  104. package/dist/components/DiffView/index.js.map +1 -0
  105. package/dist/components/Dropdown/Dropdown.d.ts +26 -4
  106. package/dist/components/Dropdown/Dropdown.d.ts.map +1 -1
  107. package/dist/components/Dropdown/Dropdown.js +66 -18
  108. package/dist/components/Dropdown/Dropdown.js.map +1 -1
  109. package/dist/components/Dropdown/index.d.ts +2 -1
  110. package/dist/components/Dropdown/index.d.ts.map +1 -1
  111. package/dist/components/Dropdown/index.js +2 -0
  112. package/dist/components/Dropdown/index.js.map +1 -1
  113. package/dist/components/Dropdown/parts.d.ts +15 -0
  114. package/dist/components/Dropdown/parts.d.ts.map +1 -0
  115. package/dist/components/Dropdown/parts.js +19 -0
  116. package/dist/components/Dropdown/parts.js.map +1 -0
  117. package/dist/components/FileViewer/FileViewer.d.ts +37 -6
  118. package/dist/components/FileViewer/FileViewer.d.ts.map +1 -1
  119. package/dist/components/FileViewer/FileViewer.js +5 -62
  120. package/dist/components/FileViewer/FileViewer.js.map +1 -1
  121. package/dist/components/FileViewer/FileViewerDialog.d.ts +4 -4
  122. package/dist/components/FileViewer/FileViewerDialog.d.ts.map +1 -1
  123. package/dist/components/FileViewer/FileViewerDialog.js +22 -4
  124. package/dist/components/FileViewer/FileViewerDialog.js.map +1 -1
  125. package/dist/components/FileViewer/FileViewerDialogFrame.d.ts +20 -0
  126. package/dist/components/FileViewer/FileViewerDialogFrame.d.ts.map +1 -0
  127. package/dist/components/FileViewer/FileViewerDialogFrame.js +12 -0
  128. package/dist/components/FileViewer/FileViewerDialogFrame.js.map +1 -0
  129. package/dist/components/FileViewer/FileViewerGallery.d.ts +10 -0
  130. package/dist/components/FileViewer/FileViewerGallery.d.ts.map +1 -0
  131. package/dist/components/FileViewer/FileViewerGallery.js +83 -0
  132. package/dist/components/FileViewer/FileViewerGallery.js.map +1 -0
  133. package/dist/components/FileViewer/FileViewerSingle.d.ts +7 -0
  134. package/dist/components/FileViewer/FileViewerSingle.d.ts.map +1 -0
  135. package/dist/components/FileViewer/FileViewerSingle.js +77 -0
  136. package/dist/components/FileViewer/FileViewerSingle.js.map +1 -0
  137. package/dist/components/FileViewer/index.d.ts +2 -1
  138. package/dist/components/FileViewer/index.d.ts.map +1 -1
  139. package/dist/components/FileViewer/index.js.map +1 -1
  140. package/dist/components/Form/DynamicForm.d.ts +37 -4
  141. package/dist/components/Form/DynamicForm.d.ts.map +1 -1
  142. package/dist/components/Form/DynamicForm.js +45 -6
  143. package/dist/components/Form/DynamicForm.js.map +1 -1
  144. package/dist/components/Form/Form.d.ts +6 -1
  145. package/dist/components/Form/Form.d.ts.map +1 -1
  146. package/dist/components/Form/Form.js +15 -3
  147. package/dist/components/Form/Form.js.map +1 -1
  148. package/dist/components/Form/adapters.d.ts +31 -1
  149. package/dist/components/Form/adapters.d.ts.map +1 -1
  150. package/dist/components/Form/adapters.js +67 -2
  151. package/dist/components/Form/adapters.js.map +1 -1
  152. package/dist/components/Form/index.d.ts +5 -21
  153. package/dist/components/Form/index.d.ts.map +1 -1
  154. package/dist/components/Form/index.js +5 -19
  155. package/dist/components/Form/index.js.map +1 -1
  156. package/dist/components/Form/namespace.d.ts +25 -0
  157. package/dist/components/Form/namespace.d.ts.map +1 -0
  158. package/dist/components/Form/namespace.js +25 -0
  159. package/dist/components/Form/namespace.js.map +1 -0
  160. package/dist/components/Form/useForm.d.ts.map +1 -1
  161. package/dist/components/Form/useForm.js +5 -0
  162. package/dist/components/Form/useForm.js.map +1 -1
  163. package/dist/components/Input/InputDateRange.d.ts +12 -2
  164. package/dist/components/Input/InputDateRange.d.ts.map +1 -1
  165. package/dist/components/Input/InputDateRange.js +4 -4
  166. package/dist/components/Input/InputDateRange.js.map +1 -1
  167. package/dist/components/JsonView/JsonView.d.ts +38 -0
  168. package/dist/components/JsonView/JsonView.d.ts.map +1 -0
  169. package/dist/components/JsonView/JsonView.js +166 -0
  170. package/dist/components/JsonView/JsonView.js.map +1 -0
  171. package/dist/components/JsonView/index.d.ts +2 -0
  172. package/dist/components/JsonView/index.d.ts.map +1 -0
  173. package/dist/components/JsonView/index.js +2 -0
  174. package/dist/components/JsonView/index.js.map +1 -0
  175. package/dist/components/Menu/Menu.d.ts +8 -2
  176. package/dist/components/Menu/Menu.d.ts.map +1 -1
  177. package/dist/components/Menu/Menu.js +95 -16
  178. package/dist/components/Menu/Menu.js.map +1 -1
  179. package/dist/components/Menu/MenuSubmenu.d.ts +39 -0
  180. package/dist/components/Menu/MenuSubmenu.d.ts.map +1 -0
  181. package/dist/components/Menu/MenuSubmenu.js +61 -0
  182. package/dist/components/Menu/MenuSubmenu.js.map +1 -0
  183. package/dist/components/MultiSelect/MultiSelect.d.ts +34 -6
  184. package/dist/components/MultiSelect/MultiSelect.d.ts.map +1 -1
  185. package/dist/components/MultiSelect/MultiSelect.js +109 -42
  186. package/dist/components/MultiSelect/MultiSelect.js.map +1 -1
  187. package/dist/components/MultiSelect/index.d.ts +2 -1
  188. package/dist/components/MultiSelect/index.d.ts.map +1 -1
  189. package/dist/components/MultiSelect/index.js +2 -0
  190. package/dist/components/MultiSelect/index.js.map +1 -1
  191. package/dist/components/PageHeader/PageHeader.d.ts +39 -0
  192. package/dist/components/PageHeader/PageHeader.d.ts.map +1 -0
  193. package/dist/components/PageHeader/PageHeader.js +18 -0
  194. package/dist/components/PageHeader/PageHeader.js.map +1 -0
  195. package/dist/components/PageHeader/index.d.ts +2 -0
  196. package/dist/components/PageHeader/index.d.ts.map +1 -0
  197. package/dist/components/PageHeader/index.js +2 -0
  198. package/dist/components/PageHeader/index.js.map +1 -0
  199. package/dist/components/SafeHtml/SafeHtml.d.ts +19 -4
  200. package/dist/components/SafeHtml/SafeHtml.d.ts.map +1 -1
  201. package/dist/components/SafeHtml/SafeHtml.js +11 -3
  202. package/dist/components/SafeHtml/SafeHtml.js.map +1 -1
  203. package/dist/components/Sidebar/Sidebar.d.ts +30 -9
  204. package/dist/components/Sidebar/Sidebar.d.ts.map +1 -1
  205. package/dist/components/Sidebar/Sidebar.js +111 -37
  206. package/dist/components/Sidebar/Sidebar.js.map +1 -1
  207. package/dist/components/Sidebar/index.d.ts +1 -1
  208. package/dist/components/Sidebar/index.d.ts.map +1 -1
  209. package/dist/components/Sidebar/index.js +1 -1
  210. package/dist/components/Sidebar/index.js.map +1 -1
  211. package/dist/components/Slider/Slider.d.ts +1 -1
  212. package/dist/components/Slider/Slider.d.ts.map +1 -1
  213. package/dist/components/StatCard/StatCard.d.ts +63 -0
  214. package/dist/components/StatCard/StatCard.d.ts.map +1 -0
  215. package/dist/components/StatCard/StatCard.js +67 -0
  216. package/dist/components/StatCard/StatCard.js.map +1 -0
  217. package/dist/components/StatCard/index.d.ts +2 -0
  218. package/dist/components/StatCard/index.d.ts.map +1 -0
  219. package/dist/components/StatCard/index.js +2 -0
  220. package/dist/components/StatCard/index.js.map +1 -0
  221. package/dist/components/Steps/index.d.ts +1 -1
  222. package/dist/components/Steps/index.d.ts.map +1 -1
  223. package/dist/components/Steps/index.js +1 -1
  224. package/dist/components/Steps/index.js.map +1 -1
  225. package/dist/components/Table/Table.d.ts +50 -4
  226. package/dist/components/Table/Table.d.ts.map +1 -1
  227. package/dist/components/Table/Table.js +241 -26
  228. package/dist/components/Table/Table.js.map +1 -1
  229. package/dist/components/Table/TableCellEditor.d.ts +24 -0
  230. package/dist/components/Table/TableCellEditor.d.ts.map +1 -0
  231. package/dist/components/Table/TableCellEditor.js +39 -0
  232. package/dist/components/Table/TableCellEditor.js.map +1 -0
  233. package/dist/components/Table/TableCellTooltip.d.ts +22 -0
  234. package/dist/components/Table/TableCellTooltip.d.ts.map +1 -0
  235. package/dist/components/Table/TableCellTooltip.js +19 -0
  236. package/dist/components/Table/TableCellTooltip.js.map +1 -0
  237. package/dist/components/Table/TableColumnChooser.d.ts +43 -0
  238. package/dist/components/Table/TableColumnChooser.d.ts.map +1 -0
  239. package/dist/components/Table/TableColumnChooser.js +50 -0
  240. package/dist/components/Table/TableColumnChooser.js.map +1 -0
  241. package/dist/components/Table/TableColumnFilter.d.ts +73 -0
  242. package/dist/components/Table/TableColumnFilter.d.ts.map +1 -0
  243. package/dist/components/Table/TableColumnFilter.js +100 -0
  244. package/dist/components/Table/TableColumnFilter.js.map +1 -0
  245. package/dist/components/Table/TableEdit.d.ts +34 -0
  246. package/dist/components/Table/TableEdit.d.ts.map +1 -0
  247. package/dist/components/Table/TableEdit.js +106 -0
  248. package/dist/components/Table/TableEdit.js.map +1 -0
  249. package/dist/components/Table/TableRow.d.ts +33 -3
  250. package/dist/components/Table/TableRow.d.ts.map +1 -1
  251. package/dist/components/Table/TableRow.js +21 -3
  252. package/dist/components/Table/TableRow.js.map +1 -1
  253. package/dist/components/Table/context.d.ts +17 -0
  254. package/dist/components/Table/context.d.ts.map +1 -0
  255. package/dist/components/Table/context.js +3 -0
  256. package/dist/components/Table/context.js.map +1 -0
  257. package/dist/components/Table/index.d.ts +6 -1
  258. package/dist/components/Table/index.d.ts.map +1 -1
  259. package/dist/components/Table/index.js +6 -1
  260. package/dist/components/Table/index.js.map +1 -1
  261. package/dist/components/Tabs/Tabs.d.ts +6 -1
  262. package/dist/components/Tabs/Tabs.d.ts.map +1 -1
  263. package/dist/components/Tabs/Tabs.js +2 -2
  264. package/dist/components/Tabs/Tabs.js.map +1 -1
  265. package/dist/components/Timeline/Timeline.d.ts +46 -0
  266. package/dist/components/Timeline/Timeline.d.ts.map +1 -0
  267. package/dist/components/Timeline/Timeline.js +26 -0
  268. package/dist/components/Timeline/Timeline.js.map +1 -0
  269. package/dist/components/Timeline/index.d.ts +2 -0
  270. package/dist/components/Timeline/index.d.ts.map +1 -0
  271. package/dist/components/Timeline/index.js +2 -0
  272. package/dist/components/Timeline/index.js.map +1 -0
  273. package/dist/components/Tree/Tree.d.ts +65 -0
  274. package/dist/components/Tree/Tree.d.ts.map +1 -0
  275. package/dist/components/Tree/Tree.js +262 -0
  276. package/dist/components/Tree/Tree.js.map +1 -0
  277. package/dist/components/Tree/index.d.ts +2 -0
  278. package/dist/components/Tree/index.d.ts.map +1 -0
  279. package/dist/components/Tree/index.js +2 -0
  280. package/dist/components/Tree/index.js.map +1 -0
  281. package/dist/components/Upload/Upload.d.ts +28 -5
  282. package/dist/components/Upload/Upload.d.ts.map +1 -1
  283. package/dist/components/Upload/Upload.js +96 -15
  284. package/dist/components/Upload/Upload.js.map +1 -1
  285. package/dist/components/Upload/index.d.ts +1 -1
  286. package/dist/components/Upload/index.d.ts.map +1 -1
  287. package/dist/components/Upload/index.js +1 -1
  288. package/dist/components/Upload/index.js.map +1 -1
  289. package/dist/confirm-dialog.css +54 -0
  290. package/dist/core/bulk-action-bar.d.ts +19 -0
  291. package/dist/core/bulk-action-bar.d.ts.map +1 -0
  292. package/dist/core/bulk-action-bar.js +19 -0
  293. package/dist/core/bulk-action-bar.js.map +1 -0
  294. package/dist/core/carousel-dom.d.ts +26 -0
  295. package/dist/core/carousel-dom.d.ts.map +1 -0
  296. package/dist/core/carousel-dom.js +65 -0
  297. package/dist/core/carousel-dom.js.map +1 -0
  298. package/dist/core/carousel.d.ts +27 -0
  299. package/dist/core/carousel.d.ts.map +1 -1
  300. package/dist/core/carousel.js +57 -0
  301. package/dist/core/carousel.js.map +1 -1
  302. package/dist/core/confirm.d.ts +101 -0
  303. package/dist/core/confirm.d.ts.map +1 -0
  304. package/dist/core/confirm.js +120 -0
  305. package/dist/core/confirm.js.map +1 -0
  306. package/dist/core/date-range.d.ts +25 -4
  307. package/dist/core/date-range.d.ts.map +1 -1
  308. package/dist/core/date-range.js +36 -8
  309. package/dist/core/date-range.js.map +1 -1
  310. package/dist/core/diff-view.d.ts +37 -0
  311. package/dist/core/diff-view.d.ts.map +1 -0
  312. package/dist/core/diff-view.js +57 -0
  313. package/dist/core/diff-view.js.map +1 -0
  314. package/dist/core/dropdown.d.ts +59 -0
  315. package/dist/core/dropdown.d.ts.map +1 -1
  316. package/dist/core/dropdown.js +85 -0
  317. package/dist/core/dropdown.js.map +1 -1
  318. package/dist/core/file/docx-read.d.ts +9 -0
  319. package/dist/core/file/docx-read.d.ts.map +1 -0
  320. package/dist/core/file/docx-read.js +18 -0
  321. package/dist/core/file/docx-read.js.map +1 -0
  322. package/dist/core/file/docx.d.ts +1 -4
  323. package/dist/core/file/docx.d.ts.map +1 -1
  324. package/dist/core/file/docx.js +4 -10
  325. package/dist/core/file/docx.js.map +1 -1
  326. package/dist/core/file/gallery.d.ts +95 -0
  327. package/dist/core/file/gallery.d.ts.map +1 -0
  328. package/dist/core/file/gallery.js +393 -0
  329. package/dist/core/file/gallery.js.map +1 -0
  330. package/dist/core/file/viewer.d.ts +48 -4
  331. package/dist/core/file/viewer.d.ts.map +1 -1
  332. package/dist/core/file/viewer.js +92 -12
  333. package/dist/core/file/viewer.js.map +1 -1
  334. package/dist/core/file/xlsx-read.d.ts +20 -0
  335. package/dist/core/file/xlsx-read.d.ts.map +1 -0
  336. package/dist/core/file/xlsx-read.js +46 -0
  337. package/dist/core/file/xlsx-read.js.map +1 -0
  338. package/dist/core/file/xlsx.d.ts +2 -12
  339. package/dist/core/file/xlsx.d.ts.map +1 -1
  340. package/dist/core/file/xlsx.js +3 -29
  341. package/dist/core/file/xlsx.js.map +1 -1
  342. package/dist/core/floating.d.ts +7 -0
  343. package/dist/core/floating.d.ts.map +1 -1
  344. package/dist/core/floating.js +33 -0
  345. package/dist/core/floating.js.map +1 -1
  346. package/dist/core/form.d.ts +85 -8
  347. package/dist/core/form.d.ts.map +1 -1
  348. package/dist/core/form.js +335 -68
  349. package/dist/core/form.js.map +1 -1
  350. package/dist/core/html/link-click.d.ts +23 -0
  351. package/dist/core/html/link-click.d.ts.map +1 -0
  352. package/dist/core/html/link-click.js +59 -0
  353. package/dist/core/html/link-click.js.map +1 -0
  354. package/dist/core/html/sanitize.d.ts +23 -1
  355. package/dist/core/html/sanitize.d.ts.map +1 -1
  356. package/dist/core/html/sanitize.js +76 -7
  357. package/dist/core/html/sanitize.js.map +1 -1
  358. package/dist/core/icons.d.ts +10 -0
  359. package/dist/core/icons.d.ts.map +1 -1
  360. package/dist/core/icons.js +11 -1
  361. package/dist/core/icons.js.map +1 -1
  362. package/dist/core/json-diff.d.ts +53 -0
  363. package/dist/core/json-diff.d.ts.map +1 -0
  364. package/dist/core/json-diff.js +162 -0
  365. package/dist/core/json-diff.js.map +1 -0
  366. package/dist/core/json-view.d.ts +107 -0
  367. package/dist/core/json-view.d.ts.map +1 -0
  368. package/dist/core/json-view.js +197 -0
  369. package/dist/core/json-view.js.map +1 -0
  370. package/dist/core/menu.d.ts +24 -0
  371. package/dist/core/menu.d.ts.map +1 -1
  372. package/dist/core/menu.js +40 -0
  373. package/dist/core/menu.js.map +1 -1
  374. package/dist/core/motion.d.ts +56 -0
  375. package/dist/core/motion.d.ts.map +1 -1
  376. package/dist/core/motion.js +56 -0
  377. package/dist/core/motion.js.map +1 -1
  378. package/dist/core/presence-list.d.ts +24 -0
  379. package/dist/core/presence-list.d.ts.map +1 -0
  380. package/dist/core/presence-list.js +62 -0
  381. package/dist/core/presence-list.js.map +1 -0
  382. package/dist/core/safe-url.d.ts +11 -0
  383. package/dist/core/safe-url.d.ts.map +1 -1
  384. package/dist/core/safe-url.js +25 -0
  385. package/dist/core/safe-url.js.map +1 -1
  386. package/dist/core/sidebar.d.ts +31 -0
  387. package/dist/core/sidebar.d.ts.map +1 -0
  388. package/dist/core/sidebar.js +67 -0
  389. package/dist/core/sidebar.js.map +1 -0
  390. package/dist/core/table/attrs.d.ts +7 -2
  391. package/dist/core/table/attrs.d.ts.map +1 -1
  392. package/dist/core/table/attrs.js +12 -1
  393. package/dist/core/table/attrs.js.map +1 -1
  394. package/dist/core/table/chooser.d.ts +46 -0
  395. package/dist/core/table/chooser.d.ts.map +1 -0
  396. package/dist/core/table/chooser.js +99 -0
  397. package/dist/core/table/chooser.js.map +1 -0
  398. package/dist/core/table/columns.d.ts +64 -2
  399. package/dist/core/table/columns.d.ts.map +1 -1
  400. package/dist/core/table/columns.js +19 -1
  401. package/dist/core/table/columns.js.map +1 -1
  402. package/dist/core/table/edit.d.ts +104 -0
  403. package/dist/core/table/edit.d.ts.map +1 -0
  404. package/dist/core/table/edit.js +151 -0
  405. package/dist/core/table/edit.js.map +1 -0
  406. package/dist/core/table/expand.d.ts +33 -0
  407. package/dist/core/table/expand.d.ts.map +1 -0
  408. package/dist/core/table/expand.js +83 -0
  409. package/dist/core/table/expand.js.map +1 -0
  410. package/dist/core/table/features.d.ts +2 -1
  411. package/dist/core/table/features.d.ts.map +1 -1
  412. package/dist/core/table/features.js +1 -1
  413. package/dist/core/table/features.js.map +1 -1
  414. package/dist/core/table/filter.d.ts +88 -0
  415. package/dist/core/table/filter.d.ts.map +1 -0
  416. package/dist/core/table/filter.js +160 -0
  417. package/dist/core/table/filter.js.map +1 -0
  418. package/dist/core/table/index.d.ts +5 -0
  419. package/dist/core/table/index.d.ts.map +1 -1
  420. package/dist/core/table/index.js +5 -0
  421. package/dist/core/table/index.js.map +1 -1
  422. package/dist/core/table/measure.d.ts +7 -1
  423. package/dist/core/table/measure.d.ts.map +1 -1
  424. package/dist/core/table/measure.js +14 -3
  425. package/dist/core/table/measure.js.map +1 -1
  426. package/dist/core/table/span.d.ts +6 -2
  427. package/dist/core/table/span.d.ts.map +1 -1
  428. package/dist/core/table/span.js +22 -4
  429. package/dist/core/table/span.js.map +1 -1
  430. package/dist/core/table/visibility.d.ts +26 -0
  431. package/dist/core/table/visibility.d.ts.map +1 -0
  432. package/dist/core/table/visibility.js +53 -0
  433. package/dist/core/table/visibility.js.map +1 -0
  434. package/dist/core/tree.d.ts +168 -0
  435. package/dist/core/tree.d.ts.map +1 -0
  436. package/dist/core/tree.js +398 -0
  437. package/dist/core/tree.js.map +1 -0
  438. package/dist/core/upload.d.ts +55 -2
  439. package/dist/core/upload.d.ts.map +1 -1
  440. package/dist/core/upload.js +98 -2
  441. package/dist/core/upload.js.map +1 -1
  442. package/dist/descriptions.css +241 -0
  443. package/dist/diff-view.css +244 -0
  444. package/dist/dropdown.css +133 -0
  445. package/dist/file-viewer.css +204 -0
  446. package/dist/fn/cookie.d.ts.map +1 -1
  447. package/dist/fn/cookie.js +8 -1
  448. package/dist/fn/cookie.js.map +1 -1
  449. package/dist/fn/index.d.ts +7 -4
  450. package/dist/fn/index.d.ts.map +1 -1
  451. package/dist/fn/index.js +7 -3
  452. package/dist/fn/index.js.map +1 -1
  453. package/dist/fn/query-state.d.ts +97 -0
  454. package/dist/fn/query-state.d.ts.map +1 -0
  455. package/dist/fn/query-state.js +163 -0
  456. package/dist/fn/query-state.js.map +1 -0
  457. package/dist/fn/sanitize.d.ts +1 -1
  458. package/dist/fn/sanitize.d.ts.map +1 -1
  459. package/dist/fn/sanitize.js.map +1 -1
  460. package/dist/fn/url.d.ts +37 -6
  461. package/dist/fn/url.d.ts.map +1 -1
  462. package/dist/fn/url.js +132 -12
  463. package/dist/fn/url.js.map +1 -1
  464. package/dist/hooks/index.d.ts +3 -0
  465. package/dist/hooks/index.d.ts.map +1 -1
  466. package/dist/hooks/index.js +3 -0
  467. package/dist/hooks/index.js.map +1 -1
  468. package/dist/hooks/usePageLifecycle.d.ts +29 -0
  469. package/dist/hooks/usePageLifecycle.d.ts.map +1 -0
  470. package/dist/hooks/usePageLifecycle.js +66 -0
  471. package/dist/hooks/usePageLifecycle.js.map +1 -0
  472. package/dist/hooks/usePageVisibility.d.ts +4 -1
  473. package/dist/hooks/usePageVisibility.d.ts.map +1 -1
  474. package/dist/hooks/usePageVisibility.js +10 -2
  475. package/dist/hooks/usePageVisibility.js.map +1 -1
  476. package/dist/hooks/useQueryState.d.ts +57 -0
  477. package/dist/hooks/useQueryState.d.ts.map +1 -0
  478. package/dist/hooks/useQueryState.js +122 -0
  479. package/dist/hooks/useQueryState.js.map +1 -0
  480. package/dist/index.d.ts +23 -10
  481. package/dist/index.d.ts.map +1 -1
  482. package/dist/index.js +23 -8
  483. package/dist/index.js.map +1 -1
  484. package/dist/json-view.css +323 -0
  485. package/dist/menu.css +29 -0
  486. package/dist/multiselect.css +61 -0
  487. package/dist/page-header.css +159 -0
  488. package/dist/server/browser.d.ts +2 -0
  489. package/dist/server/browser.d.ts.map +1 -0
  490. package/dist/server/browser.js +9 -0
  491. package/dist/server/browser.js.map +1 -0
  492. package/dist/server/cookie.d.ts +41 -0
  493. package/dist/server/cookie.d.ts.map +1 -0
  494. package/dist/server/cookie.js +102 -0
  495. package/dist/server/cookie.js.map +1 -0
  496. package/dist/server/crypto.d.ts +49 -0
  497. package/dist/server/crypto.d.ts.map +1 -1
  498. package/dist/server/crypto.js +124 -0
  499. package/dist/server/crypto.js.map +1 -1
  500. package/dist/server/index.d.ts +2 -1
  501. package/dist/server/index.d.ts.map +1 -1
  502. package/dist/server/index.js +2 -1
  503. package/dist/server/index.js.map +1 -1
  504. package/dist/sidebar.css +59 -0
  505. package/dist/skill/leaf-design-system-0.2.7.zip +0 -0
  506. package/dist/stat-card.css +191 -0
  507. package/dist/styles.css +5040 -1938
  508. package/dist/table.css +418 -0
  509. package/dist/tabs.css +44 -0
  510. package/dist/timeline.css +268 -0
  511. package/dist/tree.css +197 -0
  512. package/dist/upload.css +153 -0
  513. package/dist/utils/useFloatingLayer.d.ts.map +1 -1
  514. package/dist/utils/useFloatingLayer.js +6 -2
  515. package/dist/utils/useFloatingLayer.js.map +1 -1
  516. package/dist/utils/usePresenceList.d.ts +18 -0
  517. package/dist/utils/usePresenceList.d.ts.map +1 -0
  518. package/dist/utils/usePresenceList.js +51 -0
  519. package/dist/utils/usePresenceList.js.map +1 -0
  520. package/package.json +219 -6
  521. package/dist/cdn/leaf-0.2.5.min.css +0 -2
  522. package/dist/cdn/leaf-0.2.5.min.js +0 -177
  523. package/dist/skill/leaf-design-system-0.2.5.zip +0 -0
package/dist/menu.css CHANGED
@@ -196,3 +196,32 @@
196
196
  }
197
197
  }
198
198
  }
199
+
200
+ /*
201
+ * Menu con (opt-in: mục có `children` / markup `aria-haspopup="menu"`) — chỉ thêm selector mới.
202
+ * Mũi tên phải `.leaf-menu__submenu-icon` (Remix arrow-right-s-line, 16px như icon trước nhãn,
203
+ * màu --text-tertiary như shortcut) đẩy về mép phải; mục cha đang mở menu con giữ nền hover.
204
+ * Menu con là một `.leaf-floating` riêng (portal) nên dùng lại nguyên hiệu ứng hiện / ẩn ở trên.
205
+ */
206
+ @layer components {
207
+ .leaf-menu__submenu-icon {
208
+ flex-shrink: 0;
209
+ width: 16px;
210
+ height: 16px;
211
+ margin-left: auto;
212
+ color: var(--text-tertiary);
213
+ }
214
+
215
+ .leaf-menu__shortcut + .leaf-menu__submenu-icon {
216
+ margin-left: 0;
217
+ }
218
+
219
+ .leaf-menu__item[aria-haspopup="menu"][aria-expanded="true"] {
220
+ background-color: var(--base-tertiary);
221
+ color: var(--text-primary);
222
+ }
223
+
224
+ .leaf-menu__item:disabled > .leaf-menu__submenu-icon {
225
+ color: inherit;
226
+ }
227
+ }
@@ -145,3 +145,64 @@
145
145
  color: var(--text-tertiary);
146
146
  }
147
147
  }
148
+
149
+ /*
150
+ * Hiệu ứng chip vào / ra — `@starting-style` khi chip mới xuất hiện; khi bị xoá, React / leaf.js
151
+ * giữ chip thêm 150ms với `data-state="closing"` rồi mới gỡ. Panel dùng hiệu ứng của
152
+ * `.leaf-dropdown__list` (dropdown.css). Tắt khi giảm chuyển động.
153
+ */
154
+ @layer components {
155
+ .leaf-multiselect__chip {
156
+ transition:
157
+ opacity 150ms ease,
158
+ scale 150ms ease;
159
+ }
160
+
161
+ .leaf-multiselect__chip[data-state="closing"] {
162
+ opacity: 0;
163
+ scale: 0.9;
164
+ }
165
+
166
+ @starting-style {
167
+ .leaf-multiselect__chip {
168
+ opacity: 0;
169
+ scale: 0.9;
170
+ }
171
+ }
172
+
173
+ @media (prefers-reduced-motion: reduce) {
174
+ .leaf-multiselect__chip {
175
+ transition: none;
176
+ }
177
+ }
178
+ }
179
+
180
+ /*
181
+ * Phần tử mới chỉ hiện khi bật prop (UI cũ không đổi):
182
+ * - `.leaf-multiselect__select-all` — dòng "Chọn tất cả" (`selectAll`) đầu danh sách: Checkbox Leaf
183
+ * (chỉ hiển thị, cần `checkbox.css`) + nhãn, ngăn với option bằng viền --base-tertiary như filter.
184
+ * - `.leaf-multiselect__more` — chip "+N" (`maxTagCount`), cùng style chip, chữ --text-secondary.
185
+ * - Nút xoá / dòng "Đang tải…" / header nhóm / message dùng class `leaf-dropdown__*` (dropdown.css).
186
+ */
187
+ @layer components {
188
+ .leaf-multiselect__select-all-box[hidden] {
189
+ display: none;
190
+ }
191
+
192
+ .leaf-multiselect .leaf-dropdown__option.leaf-multiselect__select-all {
193
+ border-bottom: 1px solid var(--base-tertiary);
194
+ }
195
+
196
+ .leaf-multiselect__select-all-box {
197
+ display: inline-flex;
198
+ flex-shrink: 0;
199
+ pointer-events: none;
200
+ }
201
+
202
+ .leaf-multiselect__more {
203
+ flex-shrink: 0;
204
+ padding: 2px 8px;
205
+ color: var(--text-secondary);
206
+ cursor: default;
207
+ }
208
+ }
@@ -0,0 +1,159 @@
1
+ /* @finhay-pro/leaf-design-system — generated by scripts/build-css.mjs. Do not edit. */
2
+ @layer theme, base, components, utilities;
3
+
4
+ /* --- src/components/PageHeader/page-header.css --- */
5
+
6
+ /*
7
+ * PageHeader — đầu trang backoffice.
8
+ *
9
+ * Breadcrumb · hàng chính (nút quay lại + tiêu đề / mô tả bên trái, hành động bên phải) · phần
10
+ * thêm · tabs, cách nhau 12px. Tiêu đề heading-2 --text-primary, mô tả body-3 --text-secondary.
11
+ * Nút quay lại 36px, icon 20px, hover nền --base-tertiary (như nút thu gọn Sidebar). Mobile
12
+ * (< 640px): hành động xuống dòng dưới tiêu đề, tiêu đề heading-3, mô tả body-4.
13
+ */
14
+
15
+ @layer components {
16
+ .leaf-page-header {
17
+ display: flex;
18
+ flex-direction: column;
19
+ gap: 12px;
20
+ box-sizing: border-box;
21
+ min-width: 0;
22
+ margin: 0;
23
+ padding: 0;
24
+ color: var(--text-primary);
25
+ font-family: var(--font-sans);
26
+ font-size: var(--body-4-size);
27
+ line-height: var(--body-4-line-height);
28
+ font-weight: var(--body-4-weight);
29
+ }
30
+
31
+ .leaf-page-header__main {
32
+ display: flex;
33
+ align-items: flex-start;
34
+ justify-content: space-between;
35
+ gap: 12px 16px;
36
+ min-width: 0;
37
+ }
38
+
39
+ .leaf-page-header__heading {
40
+ display: flex;
41
+ flex: 1 1 auto;
42
+ align-items: flex-start;
43
+ gap: 8px;
44
+ min-width: 0;
45
+ }
46
+
47
+ .leaf-page-header__back {
48
+ display: inline-flex;
49
+ flex-shrink: 0;
50
+ align-items: center;
51
+ justify-content: center;
52
+ box-sizing: border-box;
53
+ width: 36px;
54
+ height: 36px;
55
+ margin: 0;
56
+ padding: 0;
57
+ border: none;
58
+ border-radius: 8px;
59
+ background: transparent;
60
+ color: var(--text-secondary);
61
+ font: inherit;
62
+ text-decoration: none;
63
+ cursor: pointer;
64
+ appearance: none;
65
+ }
66
+
67
+ .leaf-page-header__back:hover {
68
+ background-color: var(--base-tertiary);
69
+ color: var(--text-primary);
70
+ }
71
+
72
+ .leaf-page-header__back:focus-visible {
73
+ outline: 2px solid var(--text-highlight);
74
+ outline-offset: -2px;
75
+ }
76
+
77
+ .leaf-page-header__back-icon {
78
+ display: block;
79
+ width: 20px;
80
+ height: 20px;
81
+ }
82
+
83
+ .leaf-page-header__text {
84
+ display: flex;
85
+ flex-direction: column;
86
+ gap: 4px;
87
+ min-width: 0;
88
+ }
89
+
90
+ .leaf-page-header__title {
91
+ margin: 0;
92
+ color: var(--text-primary);
93
+ font-size: var(--heading-2-size);
94
+ line-height: var(--heading-2-line-height);
95
+ font-weight: var(--heading-2-weight);
96
+ overflow-wrap: anywhere;
97
+ }
98
+
99
+ .leaf-page-header__description {
100
+ margin: 0;
101
+ color: var(--text-secondary);
102
+ font-size: var(--body-3-size);
103
+ line-height: var(--body-3-line-height);
104
+ font-weight: var(--body-3-weight);
105
+ }
106
+
107
+ .leaf-page-header__actions {
108
+ display: flex;
109
+ flex-shrink: 0;
110
+ flex-wrap: wrap;
111
+ align-items: center;
112
+ gap: 8px;
113
+ }
114
+
115
+ .leaf-page-header__breadcrumb,
116
+ .leaf-page-header__extra,
117
+ .leaf-page-header__tabs {
118
+ display: block;
119
+ min-width: 0;
120
+ }
121
+
122
+ @media (max-width: 639.98px) {
123
+ .leaf-page-header__main {
124
+ flex-direction: column;
125
+ align-items: stretch;
126
+ }
127
+
128
+ .leaf-page-header__title {
129
+ font-size: var(--heading-3-size);
130
+ line-height: var(--heading-3-line-height);
131
+ font-weight: var(--heading-3-weight);
132
+ }
133
+
134
+ .leaf-page-header__description {
135
+ font-size: var(--body-4-size);
136
+ line-height: var(--body-4-line-height);
137
+ font-weight: var(--body-4-weight);
138
+ }
139
+
140
+ .leaf-page-header__back {
141
+ width: 32px;
142
+ height: 32px;
143
+ }
144
+ }
145
+
146
+ .leaf-page-header[hidden],
147
+ .leaf-page-header__breadcrumb[hidden],
148
+ .leaf-page-header__main[hidden],
149
+ .leaf-page-header__heading[hidden],
150
+ .leaf-page-header__back[hidden],
151
+ .leaf-page-header__back-icon[hidden],
152
+ .leaf-page-header__text[hidden],
153
+ .leaf-page-header__description[hidden],
154
+ .leaf-page-header__actions[hidden],
155
+ .leaf-page-header__extra[hidden],
156
+ .leaf-page-header__tabs[hidden] {
157
+ display: none;
158
+ }
159
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=browser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/server/browser.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Bản `browser` của entry `/server` (điều kiện `browser` trong `package.json` `exports`): bundle
3
+ * phía client import nhầm helper server (secret HMAC, cookie phiên…) → lỗi ngay lúc build / chạy
4
+ * thay vì âm thầm đưa code server xuống trình duyệt. Môi trường server (`node`, `edge-light`,
5
+ * `worker`, `react-server`) được khai trước `browser` nên vẫn lấy entry thật.
6
+ */
7
+ throw new Error("[Leaf] @finhay-pro/leaf-design-system/server chỉ dùng ở server (route handler, middleware, Server Action).");
8
+ export {};
9
+ //# sourceMappingURL=browser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/server/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,IAAI,KAAK,CACX,4GAA4G,CAC/G,CAAC;AAEF,OAAO,EAAE,CAAC"}
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Dựng header `Set-Cookie` cho route handler / middleware — **mặc định an toàn**: `HttpOnly`,
3
+ * `Secure`, `SameSite=Lax`, `Path=/`. Muốn nới phải ghi rõ (`httpOnly: false`…). Đầu vào sai (tên
4
+ * không phải token RFC 6265, giá trị chèn header, prefix `__Host-` / `__Secure-` sai luật,
5
+ * `SameSite=None` không `Secure`) → `TypeError` thay vì âm thầm ghi cookie hỏng / mất bảo vệ.
6
+ *
7
+ * Leaf không đọc / ghi cookie của trình duyệt — cookie phiên luôn do server đặt.
8
+ */
9
+ export type CookieSameSite = "Strict" | "Lax" | "None";
10
+ export type CookieOptions = {
11
+ /** Giây, số nguyên 0 – 400 ngày (trần của trình duyệt). */
12
+ maxAge?: number;
13
+ expires?: Date;
14
+ /** Mặc định `/`. */
15
+ path?: string;
16
+ /** Không truyền → host-only (khuyến nghị). */
17
+ domain?: string;
18
+ /** Mặc định `true`. */
19
+ httpOnly?: boolean;
20
+ /** Mặc định `true`. */
21
+ secure?: boolean;
22
+ /** Mặc định `Lax`. */
23
+ sameSite?: CookieSameSite;
24
+ /** CHIPS — cần `Secure`. */
25
+ partitioned?: boolean;
26
+ };
27
+ /**
28
+ * Chuỗi giá trị header `Set-Cookie` (không kèm tên header). `value` được `encodeURIComponent`
29
+ * (đọc lại bằng `getCookie` của `/utils` — tự decode).
30
+ *
31
+ * ```ts
32
+ * response.headers.append("Set-Cookie", serializeCookie("__Host-session", token, { maxAge: 3600 }));
33
+ * ```
34
+ */
35
+ export declare function serializeCookie(name: string, value: string, options?: CookieOptions): string;
36
+ /**
37
+ * `Set-Cookie` xoá cookie: giá trị rỗng, `Max-Age=0`, `Expires` 1970. `path` / `domain` / prefix
38
+ * phải giống lúc đặt thì trình duyệt mới xoá đúng cookie.
39
+ */
40
+ export declare function deleteCookie(name: string, options?: Omit<CookieOptions, "maxAge" | "expires">): string;
41
+ //# sourceMappingURL=cookie.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/server/cookie.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG;IACxB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,4BAA4B;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAeF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAgFhG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAM,GACxD,MAAM,CAER"}
@@ -0,0 +1,102 @@
1
+ /**
2
+ * Dựng header `Set-Cookie` cho route handler / middleware — **mặc định an toàn**: `HttpOnly`,
3
+ * `Secure`, `SameSite=Lax`, `Path=/`. Muốn nới phải ghi rõ (`httpOnly: false`…). Đầu vào sai (tên
4
+ * không phải token RFC 6265, giá trị chèn header, prefix `__Host-` / `__Secure-` sai luật,
5
+ * `SameSite=None` không `Secure`) → `TypeError` thay vì âm thầm ghi cookie hỏng / mất bảo vệ.
6
+ *
7
+ * Leaf không đọc / ghi cookie của trình duyệt — cookie phiên luôn do server đặt.
8
+ */
9
+ /** Token RFC 6265 (`cookie-name`). */
10
+ const COOKIE_NAME = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
11
+ const DOMAIN = /^[a-z0-9-]+(?:\.[a-z0-9-]+)*$/;
12
+ const MAX_AGE_LIMIT = 400 * 24 * 60 * 60;
13
+ /** Trình duyệt bỏ cookie có name + value > 4096 byte. */
14
+ const MAX_COOKIE_SIZE = 4096;
15
+ // eslint-disable-next-line no-control-regex
16
+ const UNSAFE_PATH = /[;\u0000-\u001f\u007f]/;
17
+ function fail(message) {
18
+ throw new TypeError(`[Leaf] cookie: ${message}`);
19
+ }
20
+ /**
21
+ * Chuỗi giá trị header `Set-Cookie` (không kèm tên header). `value` được `encodeURIComponent`
22
+ * (đọc lại bằng `getCookie` của `/utils` — tự decode).
23
+ *
24
+ * ```ts
25
+ * response.headers.append("Set-Cookie", serializeCookie("__Host-session", token, { maxAge: 3600 }));
26
+ * ```
27
+ */
28
+ export function serializeCookie(name, value, options = {}) {
29
+ if (typeof name !== "string" || !COOKIE_NAME.test(name)) {
30
+ fail(`tên không hợp lệ: ${String(name)}`);
31
+ }
32
+ if (typeof value !== "string") {
33
+ fail("giá trị phải là chuỗi");
34
+ }
35
+ const encoded = encodeURIComponent(value);
36
+ if (name.length + encoded.length > MAX_COOKIE_SIZE) {
37
+ fail(`name + value vượt ${MAX_COOKIE_SIZE} byte`);
38
+ }
39
+ const { maxAge, expires, path = "/", domain, httpOnly = true, secure = true, sameSite = "Lax", partitioned = false, } = options;
40
+ const lowerName = name.toLowerCase();
41
+ if ((lowerName.startsWith("__secure-") || lowerName.startsWith("__host-")) && !secure) {
42
+ fail(`${name}: prefix __Secure- / __Host- bắt buộc Secure`);
43
+ }
44
+ if (lowerName.startsWith("__host-") && (path !== "/" || domain !== undefined)) {
45
+ fail(`${name}: prefix __Host- bắt buộc Path=/ và không có Domain`);
46
+ }
47
+ if (sameSite !== "Strict" && sameSite !== "Lax" && sameSite !== "None") {
48
+ fail(`SameSite không hợp lệ: ${String(sameSite)}`);
49
+ }
50
+ if (sameSite === "None" && !secure) {
51
+ fail("SameSite=None bắt buộc Secure");
52
+ }
53
+ if (partitioned && !secure) {
54
+ fail("Partitioned bắt buộc Secure");
55
+ }
56
+ const parts = [`${name}=${encoded}`];
57
+ if (maxAge !== undefined) {
58
+ if (!Number.isInteger(maxAge) || maxAge < 0 || maxAge > MAX_AGE_LIMIT) {
59
+ fail("maxAge phải là số nguyên giây trong 0 – 400 ngày");
60
+ }
61
+ parts.push(`Max-Age=${maxAge}`);
62
+ }
63
+ if (expires !== undefined) {
64
+ if (!(expires instanceof Date) || Number.isNaN(expires.getTime())) {
65
+ fail("expires phải là Date hợp lệ");
66
+ }
67
+ parts.push(`Expires=${expires.toUTCString()}`);
68
+ }
69
+ if (domain !== undefined) {
70
+ const host = typeof domain === "string" ? domain.trim().toLowerCase().replace(/^\./, "") : "";
71
+ if (!DOMAIN.test(host)) {
72
+ fail(`Domain không hợp lệ: ${String(domain)}`);
73
+ }
74
+ parts.push(`Domain=${host}`);
75
+ }
76
+ if (typeof path !== "string" ||
77
+ !path.startsWith("/") ||
78
+ UNSAFE_PATH.test(path) ||
79
+ path.length > 1024) {
80
+ fail(`Path không hợp lệ: ${String(path)}`);
81
+ }
82
+ parts.push(`Path=${path}`);
83
+ if (httpOnly) {
84
+ parts.push("HttpOnly");
85
+ }
86
+ if (secure) {
87
+ parts.push("Secure");
88
+ }
89
+ parts.push(`SameSite=${sameSite}`);
90
+ if (partitioned) {
91
+ parts.push("Partitioned");
92
+ }
93
+ return parts.join("; ");
94
+ }
95
+ /**
96
+ * `Set-Cookie` xoá cookie: giá trị rỗng, `Max-Age=0`, `Expires` 1970. `path` / `domain` / prefix
97
+ * phải giống lúc đặt thì trình duyệt mới xoá đúng cookie.
98
+ */
99
+ export function deleteCookie(name, options = {}) {
100
+ return serializeCookie(name, "", { ...options, maxAge: 0, expires: new Date(0) });
101
+ }
102
+ //# sourceMappingURL=cookie.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookie.js","sourceRoot":"","sources":["../../src/server/cookie.ts"],"names":[],"mappings":"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"}
@@ -23,4 +23,53 @@ export declare function randomToken(bytes?: number): string;
23
23
  * ```
24
24
  */
25
25
  export declare function pkceChallenge(verifier: string): Promise<string>;
26
+ /** Secret HMAC tối thiểu 32 byte (256 bit, bằng độ dài đầu ra SHA-256) — chặn secret yếu / rỗng. */
27
+ export declare const HMAC_MIN_SECRET_BYTES = 32;
28
+ export type HmacSecret = string | Uint8Array;
29
+ export type HmacEncoding = "hex" | "base64url";
30
+ /**
31
+ * Chữ ký HMAC-SHA256 của `message` (Web Crypto, key không export được). `encoding` mặc định
32
+ * `base64url`; `hex` (chữ thường) cho chữ ký do hệ thống khác tạo theo hex. Secret < 32 byte →
33
+ * `TypeError`.
34
+ */
35
+ export declare function hmacSha256(secret: HmacSecret, message: string, { encoding }?: {
36
+ encoding?: HmacEncoding;
37
+ }): Promise<string>;
38
+ /**
39
+ * Kiểm chữ ký HMAC-SHA256 (so bằng `timingSafeEqual`). `signature` sai kiểu / sai định dạng /
40
+ * sai độ dài → `false` (không throw). Hex nhận cả chữ hoa. Secret < 32 byte → `TypeError` (lỗi cấu
41
+ * hình, không phải chữ ký sai).
42
+ */
43
+ export declare function verifyHmacSha256(secret: HmacSecret, message: string, signature: unknown, { encoding }?: {
44
+ encoding?: HmacEncoding;
45
+ }): Promise<boolean>;
46
+ export type SignedValueOptions = {
47
+ secret: HmacSecret;
48
+ /**
49
+ * Mục đích (`webview-session`, `email-verify`…) — nằm trong phần được ký nên token của mục đích
50
+ * này không dùng được cho mục đích khác dù chung secret.
51
+ */
52
+ purpose: string;
53
+ /** Mốc thời gian (ms) thay `Date.now()` — test / đồng bộ giờ. */
54
+ now?: number;
55
+ };
56
+ /**
57
+ * Đóng gói `payload` (chuỗi, vd. uid) kèm hạn dùng và chữ ký HMAC-SHA256:
58
+ * `base64url(payload).expiresAt.signature`. Dùng cho cookie phiên HttpOnly, link ký sẵn. Payload
59
+ * **không mã hoá** (đọc được) — không đặt bí mật vào payload.
60
+ *
61
+ * ```ts
62
+ * const token = await createSignedValue(uid, { secret, purpose: "webview-session", maxAgeMs: 3_600_000 });
63
+ * headers.append("Set-Cookie", serializeCookie("__Host-session", token, { maxAge: 3600 }));
64
+ * ```
65
+ */
66
+ export declare function createSignedValue(payload: string, options: SignedValueOptions & {
67
+ maxAgeMs: number;
68
+ }): Promise<string>;
69
+ /**
70
+ * Đọc token của `createSignedValue`: đúng định dạng, chưa hết hạn, đúng `purpose` và chữ ký →
71
+ * payload; còn lại → `null` (không throw với input lạ). Secret < 32 byte / `purpose` sai dạng →
72
+ * `TypeError` (lỗi cấu hình).
73
+ */
74
+ export declare function readSignedValue(token: unknown, options: SignedValueOptions): Promise<string | null>;
26
75
  //# sourceMappingURL=crypto.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/server/crypto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAS7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAK,GAAG,MAAM,CAI9C;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrE"}
1
+ {"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/server/crypto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAS7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAK,GAAG,MAAM,CAI9C;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrE;AAED,oGAAoG;AACpG,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,WAAW,CAAC;AA4B/C;;;;GAIG;AACH,wBAAsB,UAAU,CAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,EAAE,QAAsB,EAAE,GAAE;IAAE,QAAQ,CAAC,EAAE,YAAY,CAAA;CAAO,GAC7D,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,EAClB,EAAE,QAAsB,EAAE,GAAE;IAAE,QAAQ,CAAC,EAAE,YAAY,CAAA;CAAO,GAC7D,OAAO,CAAC,OAAO,CAAC,CAUlB;AAQD,MAAM,MAAM,kBAAkB,GAAG;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AA2BF;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,MAAM,CAAC,CAajB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuBxB"}
@@ -47,4 +47,128 @@ export async function pkceChallenge(verifier) {
47
47
  const digest = await globalThis.crypto.subtle.digest("SHA-256", encoder.encode(verifier));
48
48
  return toBase64Url(new Uint8Array(digest));
49
49
  }
50
+ /** Secret HMAC tối thiểu 32 byte (256 bit, bằng độ dài đầu ra SHA-256) — chặn secret yếu / rỗng. */
51
+ export const HMAC_MIN_SECRET_BYTES = 32;
52
+ const HEX_SIGNATURE = /^[0-9a-f]{64}$/;
53
+ const BASE64URL_SIGNATURE = /^[A-Za-z0-9_-]{43}$/;
54
+ function secretBytes(secret) {
55
+ const bytes = typeof secret === "string"
56
+ ? encoder.encode(secret)
57
+ : secret instanceof Uint8Array
58
+ ? new Uint8Array(secret)
59
+ : null;
60
+ if (!bytes || bytes.byteLength < HMAC_MIN_SECRET_BYTES) {
61
+ throw new TypeError(`[Leaf] secret HMAC phải dài tối thiểu ${HMAC_MIN_SECRET_BYTES} byte (vd. randomToken(32))`);
62
+ }
63
+ return bytes;
64
+ }
65
+ function toHex(bytes) {
66
+ let out = "";
67
+ for (const byte of bytes) {
68
+ out += byte.toString(16).padStart(2, "0");
69
+ }
70
+ return out;
71
+ }
72
+ /**
73
+ * Chữ ký HMAC-SHA256 của `message` (Web Crypto, key không export được). `encoding` mặc định
74
+ * `base64url`; `hex` (chữ thường) cho chữ ký do hệ thống khác tạo theo hex. Secret < 32 byte →
75
+ * `TypeError`.
76
+ */
77
+ export async function hmacSha256(secret, message, { encoding = "base64url" } = {}) {
78
+ const key = await globalThis.crypto.subtle.importKey("raw", secretBytes(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
79
+ const signature = new Uint8Array(await globalThis.crypto.subtle.sign("HMAC", key, encoder.encode(message)));
80
+ return encoding === "hex" ? toHex(signature) : toBase64Url(signature);
81
+ }
82
+ /**
83
+ * Kiểm chữ ký HMAC-SHA256 (so bằng `timingSafeEqual`). `signature` sai kiểu / sai định dạng /
84
+ * sai độ dài → `false` (không throw). Hex nhận cả chữ hoa. Secret < 32 byte → `TypeError` (lỗi cấu
85
+ * hình, không phải chữ ký sai).
86
+ */
87
+ export async function verifyHmacSha256(secret, message, signature, { encoding = "base64url" } = {}) {
88
+ const expected = await hmacSha256(secret, message, { encoding });
89
+ if (typeof signature !== "string") {
90
+ return false;
91
+ }
92
+ const candidate = encoding === "hex" ? signature.toLowerCase() : signature;
93
+ if (!(encoding === "hex" ? HEX_SIGNATURE : BASE64URL_SIGNATURE).test(candidate)) {
94
+ return false;
95
+ }
96
+ return timingSafeEqual(candidate, expected);
97
+ }
98
+ /** Tên mục đích của giá trị ký: chữ, số, `.` `_` `:` `-`, 1–64 ký tự. */
99
+ const PURPOSE = /^[A-Za-z0-9._:-]{1,64}$/;
100
+ const BASE64URL = /^[A-Za-z0-9_-]*$/;
101
+ /** Token dài hơn mức này không phải do `createSignedValue` tạo cho cookie / link — bỏ. */
102
+ const MAX_SIGNED_VALUE_LENGTH = 8192;
103
+ function signedMessage(purpose, body, expiresAt) {
104
+ return `leaf-signed|${purpose}|${body}|${expiresAt}`;
105
+ }
106
+ function checkPurpose(purpose) {
107
+ if (typeof purpose !== "string" || !PURPOSE.test(purpose)) {
108
+ throw new TypeError("[Leaf] purpose phải là chuỗi [A-Za-z0-9._:-], 1–64 ký tự");
109
+ }
110
+ return purpose;
111
+ }
112
+ function base64UrlEncodeText(text) {
113
+ return toBase64Url(encoder.encode(text));
114
+ }
115
+ function base64UrlDecodeText(value) {
116
+ try {
117
+ const binary = atob(value.replace(/-/g, "+").replace(/_/g, "/"));
118
+ const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
119
+ return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
120
+ }
121
+ catch {
122
+ return null;
123
+ }
124
+ }
125
+ /**
126
+ * Đóng gói `payload` (chuỗi, vd. uid) kèm hạn dùng và chữ ký HMAC-SHA256:
127
+ * `base64url(payload).expiresAt.signature`. Dùng cho cookie phiên HttpOnly, link ký sẵn. Payload
128
+ * **không mã hoá** (đọc được) — không đặt bí mật vào payload.
129
+ *
130
+ * ```ts
131
+ * const token = await createSignedValue(uid, { secret, purpose: "webview-session", maxAgeMs: 3_600_000 });
132
+ * headers.append("Set-Cookie", serializeCookie("__Host-session", token, { maxAge: 3600 }));
133
+ * ```
134
+ */
135
+ export async function createSignedValue(payload, options) {
136
+ const purpose = checkPurpose(options.purpose);
137
+ const { maxAgeMs, now = Date.now() } = options;
138
+ if (typeof payload !== "string") {
139
+ throw new TypeError("[Leaf] payload phải là chuỗi");
140
+ }
141
+ if (!Number.isFinite(maxAgeMs) || maxAgeMs <= 0) {
142
+ throw new TypeError("[Leaf] maxAgeMs phải là số dương hữu hạn");
143
+ }
144
+ const body = base64UrlEncodeText(payload);
145
+ const expiresAt = String(Math.floor(now + maxAgeMs));
146
+ const signature = await hmacSha256(options.secret, signedMessage(purpose, body, expiresAt));
147
+ return `${body}.${expiresAt}.${signature}`;
148
+ }
149
+ /**
150
+ * Đọc token của `createSignedValue`: đúng định dạng, chưa hết hạn, đúng `purpose` và chữ ký →
151
+ * payload; còn lại → `null` (không throw với input lạ). Secret < 32 byte / `purpose` sai dạng →
152
+ * `TypeError` (lỗi cấu hình).
153
+ */
154
+ export async function readSignedValue(token, options) {
155
+ const purpose = checkPurpose(options.purpose);
156
+ secretBytes(options.secret);
157
+ if (typeof token !== "string" || token.length > MAX_SIGNED_VALUE_LENGTH) {
158
+ return null;
159
+ }
160
+ const parts = token.split(".");
161
+ if (parts.length !== 3) {
162
+ return null;
163
+ }
164
+ const [body, expiresAt, signature] = parts;
165
+ if (!BASE64URL.test(body) || !/^\d{1,16}$/.test(expiresAt)) {
166
+ return null;
167
+ }
168
+ if (Number(expiresAt) <= (options.now ?? Date.now())) {
169
+ return null;
170
+ }
171
+ const valid = await verifyHmacSha256(options.secret, signedMessage(purpose, body, expiresAt), signature);
172
+ return valid ? base64UrlDecodeText(body) : null;
173
+ }
50
174
  //# sourceMappingURL=crypto.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/server/crypto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC,SAAS,WAAW,CAAC,KAAiB;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACnF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAK,GAAG,EAAE;IAClC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9D,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAChD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1F,OAAO,WAAW,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/C,CAAC"}
1
+ {"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/server/crypto.ts"],"names":[],"mappings":"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"}
@@ -5,5 +5,6 @@
5
5
  export { badRequest, emptyResponse, errorResponse, forbidden, jsonResponse, methodNotAllowed, notFound, tooManyRequests, unauthorized, } from "./response";
6
6
  export { getBearerToken, getClientIp, queryOf, readBody, type BodyResult, type ClientIpOptions, } from "./request";
7
7
  export { createRateLimiter, type RateLimiter, type RateLimiterOptions } from "./rate-limit";
8
- export { pkceChallenge, randomToken, timingSafeEqual } from "./crypto";
8
+ export { createSignedValue, HMAC_MIN_SECRET_BYTES, hmacSha256, pkceChallenge, randomToken, readSignedValue, timingSafeEqual, verifyHmacSha256, type HmacEncoding, type HmacSecret, type SignedValueOptions, } from "./crypto";
9
+ export { deleteCookie, serializeCookie, type CookieOptions, type CookieSameSite } from "./cookie";
9
10
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,UAAU,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,YAAY,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,cAAc,EACd,WAAW,EACX,OAAO,EACP,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,eAAe,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,UAAU,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,YAAY,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,cAAc,EACd,WAAW,EACX,OAAO,EACP,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,eAAe,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EACH,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,kBAAkB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC"}