@finhay-pro/leaf-design-system 0.2.0 → 0.2.2

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 (324) hide show
  1. package/README.md +245 -37
  2. package/dist/button.css +7 -0
  3. package/dist/calendar.css +19 -7
  4. package/dist/carousel.css +144 -0
  5. package/dist/cdn/leaf-0.2.2.min.css +2 -0
  6. package/dist/cdn/leaf-0.2.2.min.js +165 -0
  7. package/dist/classes.css +1699 -121
  8. package/dist/components/Button/Button.d.ts +2 -2
  9. package/dist/components/Button/Button.d.ts.map +1 -1
  10. package/dist/components/Button/Button.js +17 -15
  11. package/dist/components/Button/Button.js.map +1 -1
  12. package/dist/components/Calendar/Calendar.d.ts +12 -4
  13. package/dist/components/Calendar/Calendar.d.ts.map +1 -1
  14. package/dist/components/Calendar/Calendar.js +65 -26
  15. package/dist/components/Calendar/Calendar.js.map +1 -1
  16. package/dist/components/Carousel/Carousel.d.ts +35 -0
  17. package/dist/components/Carousel/Carousel.d.ts.map +1 -0
  18. package/dist/components/Carousel/Carousel.js +191 -0
  19. package/dist/components/Carousel/Carousel.js.map +1 -0
  20. package/dist/components/Carousel/index.d.ts +2 -0
  21. package/dist/components/Carousel/index.d.ts.map +1 -0
  22. package/dist/components/Carousel/index.js +2 -0
  23. package/dist/components/Carousel/index.js.map +1 -0
  24. package/dist/components/Checkbox/Checkbox.d.ts +2 -2
  25. package/dist/components/Checkbox/Checkbox.d.ts.map +1 -1
  26. package/dist/components/Checkbox/Checkbox.js +7 -3
  27. package/dist/components/Checkbox/Checkbox.js.map +1 -1
  28. package/dist/components/Date/Date.d.ts +26 -0
  29. package/dist/components/Date/Date.d.ts.map +1 -0
  30. package/dist/components/Date/Date.js +26 -0
  31. package/dist/components/Date/Date.js.map +1 -0
  32. package/dist/components/Date/index.d.ts +2 -0
  33. package/dist/components/Date/index.d.ts.map +1 -0
  34. package/dist/components/Date/index.js +2 -0
  35. package/dist/components/Date/index.js.map +1 -0
  36. package/dist/components/Dialog/Dialog.d.ts +1 -2
  37. package/dist/components/Dialog/Dialog.d.ts.map +1 -1
  38. package/dist/components/Dialog/Dialog.js +2 -3
  39. package/dist/components/Dialog/Dialog.js.map +1 -1
  40. package/dist/components/Dropdown/Dropdown.d.ts +24 -10
  41. package/dist/components/Dropdown/Dropdown.d.ts.map +1 -1
  42. package/dist/components/Dropdown/Dropdown.js +245 -37
  43. package/dist/components/Dropdown/Dropdown.js.map +1 -1
  44. package/dist/components/Empty/Empty.d.ts +27 -0
  45. package/dist/components/Empty/Empty.d.ts.map +1 -0
  46. package/dist/components/Empty/Empty.js +22 -0
  47. package/dist/components/Empty/Empty.js.map +1 -0
  48. package/dist/components/Empty/index.d.ts +2 -0
  49. package/dist/components/Empty/index.d.ts.map +1 -0
  50. package/dist/components/Empty/index.js +2 -0
  51. package/dist/components/Empty/index.js.map +1 -0
  52. package/dist/components/FileViewer/FileViewer.d.ts +63 -0
  53. package/dist/components/FileViewer/FileViewer.d.ts.map +1 -0
  54. package/dist/components/FileViewer/FileViewer.js +73 -0
  55. package/dist/components/FileViewer/FileViewer.js.map +1 -0
  56. package/dist/components/FileViewer/FileViewerDialog.d.ts +27 -0
  57. package/dist/components/FileViewer/FileViewerDialog.d.ts.map +1 -0
  58. package/dist/components/FileViewer/FileViewerDialog.js +13 -0
  59. package/dist/components/FileViewer/FileViewerDialog.js.map +1 -0
  60. package/dist/components/FileViewer/index.d.ts +4 -0
  61. package/dist/components/FileViewer/index.d.ts.map +1 -0
  62. package/dist/components/FileViewer/index.js +4 -0
  63. package/dist/components/FileViewer/index.js.map +1 -0
  64. package/dist/components/Form/DynamicForm.d.ts +52 -0
  65. package/dist/components/Form/DynamicForm.d.ts.map +1 -0
  66. package/dist/components/Form/DynamicForm.js +135 -0
  67. package/dist/components/Form/DynamicForm.js.map +1 -0
  68. package/dist/components/Form/Form.d.ts +54 -0
  69. package/dist/components/Form/Form.d.ts.map +1 -0
  70. package/dist/components/Form/Form.js +127 -0
  71. package/dist/components/Form/Form.js.map +1 -0
  72. package/dist/components/Form/adapters.d.ts +66 -0
  73. package/dist/components/Form/adapters.d.ts.map +1 -0
  74. package/dist/components/Form/adapters.js +113 -0
  75. package/dist/components/Form/adapters.js.map +1 -0
  76. package/dist/components/Form/index.d.ts +24 -0
  77. package/dist/components/Form/index.d.ts.map +1 -0
  78. package/dist/components/Form/index.js +23 -0
  79. package/dist/components/Form/index.js.map +1 -0
  80. package/dist/components/Form/useForm.d.ts +25 -0
  81. package/dist/components/Form/useForm.d.ts.map +1 -0
  82. package/dist/components/Form/useForm.js +46 -0
  83. package/dist/components/Form/useForm.js.map +1 -0
  84. package/dist/components/Input/Input.d.ts +1 -2
  85. package/dist/components/Input/Input.d.ts.map +1 -1
  86. package/dist/components/Input/Input.js +3 -4
  87. package/dist/components/Input/Input.js.map +1 -1
  88. package/dist/components/Input/InputDate.d.ts +17 -7
  89. package/dist/components/Input/InputDate.d.ts.map +1 -1
  90. package/dist/components/Input/InputDate.js +48 -22
  91. package/dist/components/Input/InputDate.js.map +1 -1
  92. package/dist/components/Input/InputOtp.d.ts +2 -2
  93. package/dist/components/Input/InputOtp.d.ts.map +1 -1
  94. package/dist/components/Input/InputOtp.js +3 -3
  95. package/dist/components/Input/InputOtp.js.map +1 -1
  96. package/dist/components/Input/InputStepper.d.ts +3 -4
  97. package/dist/components/Input/InputStepper.d.ts.map +1 -1
  98. package/dist/components/Input/InputStepper.js +4 -5
  99. package/dist/components/Input/InputStepper.js.map +1 -1
  100. package/dist/components/Logo/Logo.d.ts +2 -2
  101. package/dist/components/Logo/Logo.d.ts.map +1 -1
  102. package/dist/components/Logo/Logo.js +3 -4
  103. package/dist/components/Logo/Logo.js.map +1 -1
  104. package/dist/components/MultiSelect/MultiSelect.d.ts +49 -0
  105. package/dist/components/MultiSelect/MultiSelect.d.ts.map +1 -0
  106. package/dist/components/MultiSelect/MultiSelect.js +285 -0
  107. package/dist/components/MultiSelect/MultiSelect.js.map +1 -0
  108. package/dist/components/MultiSelect/index.d.ts +2 -0
  109. package/dist/components/MultiSelect/index.d.ts.map +1 -0
  110. package/dist/components/MultiSelect/index.js +2 -0
  111. package/dist/components/MultiSelect/index.js.map +1 -0
  112. package/dist/components/Number/Number.d.ts +32 -0
  113. package/dist/components/Number/Number.d.ts.map +1 -0
  114. package/dist/components/Number/Number.js +43 -0
  115. package/dist/components/Number/Number.js.map +1 -0
  116. package/dist/components/Number/index.d.ts +2 -0
  117. package/dist/components/Number/index.d.ts.map +1 -0
  118. package/dist/components/Number/index.js +2 -0
  119. package/dist/components/Number/index.js.map +1 -0
  120. package/dist/components/QrCode/QrCode.d.ts +27 -0
  121. package/dist/components/QrCode/QrCode.d.ts.map +1 -0
  122. package/dist/components/QrCode/QrCode.js +44 -0
  123. package/dist/components/QrCode/QrCode.js.map +1 -0
  124. package/dist/components/QrCode/index.d.ts +3 -0
  125. package/dist/components/QrCode/index.d.ts.map +1 -0
  126. package/dist/components/QrCode/index.js +3 -0
  127. package/dist/components/QrCode/index.js.map +1 -0
  128. package/dist/components/Radio/Radio.d.ts +4 -4
  129. package/dist/components/Radio/Radio.d.ts.map +1 -1
  130. package/dist/components/Radio/Radio.js +5 -5
  131. package/dist/components/Radio/Radio.js.map +1 -1
  132. package/dist/components/Skeleton/Skeleton.d.ts +2 -2
  133. package/dist/components/Skeleton/Skeleton.d.ts.map +1 -1
  134. package/dist/components/Skeleton/Skeleton.js +2 -3
  135. package/dist/components/Skeleton/Skeleton.js.map +1 -1
  136. package/dist/components/Slider/Slider.d.ts +8 -6
  137. package/dist/components/Slider/Slider.d.ts.map +1 -1
  138. package/dist/components/Slider/Slider.js +16 -9
  139. package/dist/components/Slider/Slider.js.map +1 -1
  140. package/dist/components/Spinner/Spinner.d.ts +5 -2
  141. package/dist/components/Spinner/Spinner.d.ts.map +1 -1
  142. package/dist/components/Spinner/Spinner.js +5 -4
  143. package/dist/components/Spinner/Spinner.js.map +1 -1
  144. package/dist/components/Tabs/Tabs.d.ts +2 -3
  145. package/dist/components/Tabs/Tabs.d.ts.map +1 -1
  146. package/dist/components/Tabs/Tabs.js +4 -5
  147. package/dist/components/Tabs/Tabs.js.map +1 -1
  148. package/dist/components/Textarea/Textarea.d.ts +18 -0
  149. package/dist/components/Textarea/Textarea.d.ts.map +1 -0
  150. package/dist/components/Textarea/Textarea.js +41 -0
  151. package/dist/components/Textarea/Textarea.js.map +1 -0
  152. package/dist/components/Textarea/index.d.ts +2 -0
  153. package/dist/components/Textarea/index.d.ts.map +1 -0
  154. package/dist/components/Textarea/index.js +2 -0
  155. package/dist/components/Textarea/index.js.map +1 -0
  156. package/dist/components/Toast/Toast.d.ts +4 -3
  157. package/dist/components/Toast/Toast.d.ts.map +1 -1
  158. package/dist/components/Toast/Toast.js +7 -6
  159. package/dist/components/Toast/Toast.js.map +1 -1
  160. package/dist/components/Toggle/Toggle.d.ts +3 -3
  161. package/dist/components/Toggle/Toggle.d.ts.map +1 -1
  162. package/dist/components/Toggle/Toggle.js +5 -3
  163. package/dist/components/Toggle/Toggle.js.map +1 -1
  164. package/dist/components/Tooltip/Tooltip.d.ts +4 -5
  165. package/dist/components/Tooltip/Tooltip.d.ts.map +1 -1
  166. package/dist/components/Tooltip/Tooltip.js +10 -8
  167. package/dist/components/Tooltip/Tooltip.js.map +1 -1
  168. package/dist/components/Upload/Upload.d.ts +89 -0
  169. package/dist/components/Upload/Upload.d.ts.map +1 -0
  170. package/dist/components/Upload/Upload.js +196 -0
  171. package/dist/components/Upload/Upload.js.map +1 -0
  172. package/dist/components/Upload/index.d.ts +2 -0
  173. package/dist/components/Upload/index.d.ts.map +1 -0
  174. package/dist/components/Upload/index.js +2 -0
  175. package/dist/components/Upload/index.js.map +1 -0
  176. package/dist/core/calendar.d.ts +13 -0
  177. package/dist/core/calendar.d.ts.map +1 -1
  178. package/dist/core/calendar.js +43 -0
  179. package/dist/core/calendar.js.map +1 -1
  180. package/dist/core/carousel.d.ts +42 -0
  181. package/dist/core/carousel.d.ts.map +1 -0
  182. package/dist/core/carousel.js +125 -0
  183. package/dist/core/carousel.js.map +1 -0
  184. package/dist/core/date.d.ts +46 -0
  185. package/dist/core/date.d.ts.map +1 -0
  186. package/dist/core/date.js +117 -0
  187. package/dist/core/date.js.map +1 -0
  188. package/dist/core/dialog.d.ts +2 -1
  189. package/dist/core/dialog.d.ts.map +1 -1
  190. package/dist/core/dialog.js +35 -9
  191. package/dist/core/dialog.js.map +1 -1
  192. package/dist/core/dropdown.d.ts +15 -2
  193. package/dist/core/dropdown.d.ts.map +1 -1
  194. package/dist/core/dropdown.js +29 -4
  195. package/dist/core/dropdown.js.map +1 -1
  196. package/dist/core/file/csv.d.ts +42 -0
  197. package/dist/core/file/csv.d.ts.map +1 -0
  198. package/dist/core/file/csv.js +159 -0
  199. package/dist/core/file/csv.js.map +1 -0
  200. package/dist/core/file/detect.d.ts +38 -0
  201. package/dist/core/file/detect.d.ts.map +1 -0
  202. package/dist/core/file/detect.js +218 -0
  203. package/dist/core/file/detect.js.map +1 -0
  204. package/dist/core/file/docx-render.d.ts +14 -0
  205. package/dist/core/file/docx-render.d.ts.map +1 -0
  206. package/dist/core/file/docx-render.js +173 -0
  207. package/dist/core/file/docx-render.js.map +1 -0
  208. package/dist/core/file/docx.d.ts +110 -0
  209. package/dist/core/file/docx.d.ts.map +1 -0
  210. package/dist/core/file/docx.js +632 -0
  211. package/dist/core/file/docx.js.map +1 -0
  212. package/dist/core/file/dom.d.ts +18 -0
  213. package/dist/core/file/dom.d.ts.map +1 -0
  214. package/dist/core/file/dom.js +57 -0
  215. package/dist/core/file/dom.js.map +1 -0
  216. package/dist/core/file/download.d.ts +26 -0
  217. package/dist/core/file/download.d.ts.map +1 -0
  218. package/dist/core/file/download.js +57 -0
  219. package/dist/core/file/download.js.map +1 -0
  220. package/dist/core/file/error.d.ts +34 -0
  221. package/dist/core/file/error.d.ts.map +1 -0
  222. package/dist/core/file/error.js +19 -0
  223. package/dist/core/file/error.js.map +1 -0
  224. package/dist/core/file/mime.d.ts +11 -0
  225. package/dist/core/file/mime.d.ts.map +1 -0
  226. package/dist/core/file/mime.js +61 -0
  227. package/dist/core/file/mime.js.map +1 -0
  228. package/dist/core/file/render.d.ts +45 -0
  229. package/dist/core/file/render.d.ts.map +1 -0
  230. package/dist/core/file/render.js +133 -0
  231. package/dist/core/file/render.js.map +1 -0
  232. package/dist/core/file/sheet-render.d.ts +30 -0
  233. package/dist/core/file/sheet-render.d.ts.map +1 -0
  234. package/dist/core/file/sheet-render.js +152 -0
  235. package/dist/core/file/sheet-render.js.map +1 -0
  236. package/dist/core/file/source.d.ts +56 -0
  237. package/dist/core/file/source.d.ts.map +1 -0
  238. package/dist/core/file/source.js +188 -0
  239. package/dist/core/file/source.js.map +1 -0
  240. package/dist/core/file/text.d.ts +9 -0
  241. package/dist/core/file/text.d.ts.map +1 -0
  242. package/dist/core/file/text.js +21 -0
  243. package/dist/core/file/text.js.map +1 -0
  244. package/dist/core/file/viewer.d.ts +160 -0
  245. package/dist/core/file/viewer.d.ts.map +1 -0
  246. package/dist/core/file/viewer.js +623 -0
  247. package/dist/core/file/viewer.js.map +1 -0
  248. package/dist/core/file/xlsx-format.d.ts +55 -0
  249. package/dist/core/file/xlsx-format.d.ts.map +1 -0
  250. package/dist/core/file/xlsx-format.js +476 -0
  251. package/dist/core/file/xlsx-format.js.map +1 -0
  252. package/dist/core/file/xlsx-write.d.ts +48 -0
  253. package/dist/core/file/xlsx-write.d.ts.map +1 -0
  254. package/dist/core/file/xlsx-write.js +219 -0
  255. package/dist/core/file/xlsx-write.js.map +1 -0
  256. package/dist/core/file/xlsx.d.ts +115 -0
  257. package/dist/core/file/xlsx.d.ts.map +1 -0
  258. package/dist/core/file/xlsx.js +402 -0
  259. package/dist/core/file/xlsx.js.map +1 -0
  260. package/dist/core/file/xml.d.ts +34 -0
  261. package/dist/core/file/xml.d.ts.map +1 -0
  262. package/dist/core/file/xml.js +102 -0
  263. package/dist/core/file/xml.js.map +1 -0
  264. package/dist/core/file/zip-write.d.ts +24 -0
  265. package/dist/core/file/zip-write.d.ts.map +1 -0
  266. package/dist/core/file/zip-write.js +131 -0
  267. package/dist/core/file/zip-write.js.map +1 -0
  268. package/dist/core/file/zip.d.ts +37 -0
  269. package/dist/core/file/zip.d.ts.map +1 -0
  270. package/dist/core/file/zip.js +195 -0
  271. package/dist/core/file/zip.js.map +1 -0
  272. package/dist/core/form.d.ts +88 -0
  273. package/dist/core/form.d.ts.map +1 -0
  274. package/dist/core/form.js +353 -0
  275. package/dist/core/form.js.map +1 -0
  276. package/dist/core/icons.d.ts +14 -0
  277. package/dist/core/icons.d.ts.map +1 -1
  278. package/dist/core/icons.js +14 -0
  279. package/dist/core/icons.js.map +1 -1
  280. package/dist/core/number.d.ts +45 -0
  281. package/dist/core/number.d.ts.map +1 -0
  282. package/dist/core/number.js +74 -0
  283. package/dist/core/number.js.map +1 -0
  284. package/dist/core/qr-code.d.ts +18 -0
  285. package/dist/core/qr-code.d.ts.map +1 -0
  286. package/dist/core/qr-code.js +702 -0
  287. package/dist/core/qr-code.js.map +1 -0
  288. package/dist/core/stepper.d.ts +6 -2
  289. package/dist/core/stepper.d.ts.map +1 -1
  290. package/dist/core/stepper.js +12 -9
  291. package/dist/core/stepper.js.map +1 -1
  292. package/dist/core/upload.d.ts +51 -0
  293. package/dist/core/upload.d.ts.map +1 -0
  294. package/dist/core/upload.js +114 -0
  295. package/dist/core/upload.js.map +1 -0
  296. package/dist/date.css +19 -0
  297. package/dist/dropdown.css +117 -0
  298. package/dist/empty.css +74 -0
  299. package/dist/file-viewer.css +502 -0
  300. package/dist/focus.css +18 -0
  301. package/dist/form.css +64 -0
  302. package/dist/index.d.ts +24 -0
  303. package/dist/index.d.ts.map +1 -1
  304. package/dist/index.js +26 -0
  305. package/dist/index.js.map +1 -1
  306. package/dist/multiselect.css +147 -0
  307. package/dist/number.css +53 -0
  308. package/dist/qr-code.css +21 -0
  309. package/dist/skeleton.css +8 -0
  310. package/dist/skill/leaf-design-system-0.2.2.zip +0 -0
  311. package/dist/slider.css +55 -1
  312. package/dist/spinner.css +9 -1
  313. package/dist/styles.css +1699 -121
  314. package/dist/tabs.css +7 -0
  315. package/dist/textarea.css +28 -0
  316. package/dist/upload.css +317 -0
  317. package/dist/utils/colorClass.d.ts +22 -0
  318. package/dist/utils/colorClass.d.ts.map +1 -0
  319. package/dist/utils/colorClass.js +93 -0
  320. package/dist/utils/colorClass.js.map +1 -0
  321. package/package.json +17 -3
  322. package/dist/cdn/leaf-0.2.0.min.css +0 -2
  323. package/dist/cdn/leaf-0.2.0.min.js +0 -2
  324. package/dist/skill/leaf-design-system-0.2.0.zip +0 -0
package/README.md CHANGED
@@ -36,6 +36,9 @@ chọn phần class cần dùng.
36
36
  | `@finhay-pro/leaf-design-system/logo.css` | Style của component `Logo`. |
37
37
  | `@finhay-pro/leaf-design-system/logo-assets.css` | SVG data-URI cho Logo HTML tĩnh — không nằm trong `classes.css` / `styles.css`. |
38
38
  | `@finhay-pro/leaf-design-system/skeleton.css` | Style của component `Skeleton`. |
39
+ | `@finhay-pro/leaf-design-system/empty.css` | Style của component `Empty`. |
40
+ | `@finhay-pro/leaf-design-system/qr-code.css` | Style của component `QrCode`. |
41
+ | `@finhay-pro/leaf-design-system/carousel.css` | Style của component `Carousel`. |
39
42
  | `@finhay-pro/leaf-design-system/spinner.css` | Style của component `Spinner`. |
40
43
  | `@finhay-pro/leaf-design-system/toggle.css` | Style của component `Toggle`. |
41
44
  | `@finhay-pro/leaf-design-system/slider.css` | Style của component `Slider`. |
@@ -49,6 +52,7 @@ chọn phần class cần dùng.
49
52
  | `@finhay-pro/leaf-design-system/input-date.css` | Popover của `InputDate` (kèm `input.css` + `calendar.css` + `button.css` + `color.css`). |
50
53
  | `@finhay-pro/leaf-design-system/toast.css` | Style của `Toaster` / `ToastContent`. |
51
54
  | `@finhay-pro/leaf-design-system/dropdown.css` | Style của component `Dropdown`. |
55
+ | `@finhay-pro/leaf-design-system/file-viewer.css` | Style của `FileViewer` (kèm `button.css` + `spinner.css` + `empty.css`). |
52
56
  | `@finhay-pro/leaf-design-system/classes.css` | Tất cả class + component, không token. |
53
57
  | `@finhay-pro/leaf-design-system/styles.css` | Token + tất cả class + component. Một dòng là đủ. |
54
58
 
@@ -68,6 +72,9 @@ Import bằng CSS:
68
72
  @import "@finhay-pro/leaf-design-system/dialog.css";
69
73
  @import "@finhay-pro/leaf-design-system/logo.css";
70
74
  @import "@finhay-pro/leaf-design-system/skeleton.css";
75
+ @import "@finhay-pro/leaf-design-system/empty.css";
76
+ @import "@finhay-pro/leaf-design-system/qr-code.css";
77
+ @import "@finhay-pro/leaf-design-system/carousel.css";
71
78
  @import "@finhay-pro/leaf-design-system/spinner.css";
72
79
  @import "@finhay-pro/leaf-design-system/toggle.css";
73
80
  @import "@finhay-pro/leaf-design-system/slider.css";
@@ -81,6 +88,7 @@ Import bằng CSS:
81
88
  @import "@finhay-pro/leaf-design-system/input-date.css";
82
89
  @import "@finhay-pro/leaf-design-system/toast.css";
83
90
  @import "@finhay-pro/leaf-design-system/dropdown.css";
91
+ @import "@finhay-pro/leaf-design-system/file-viewer.css";
84
92
  ```
85
93
 
86
94
  Muốn gọn thì một dòng `@import "@finhay-pro/leaf-design-system/styles.css";` thay cho cả khối trên.
@@ -116,7 +124,9 @@ import { Button } from "@finhay-pro/leaf-design-system";
116
124
  <section className="bg-secondary border-quaternary flex flex-col gap-3 rounded-xl border p-4 md:p-6">
117
125
  <h3 className="heading-3 text-primary">Tích luỹ</h3>
118
126
  <p className="body-4 text-secondary hover:text-(color:--text-highlight)">Lợi nhuận 8.5%/năm</p>
119
- <Button className="w-full md:w-auto">Đầu tư</Button>
127
+ <div className="w-full md:w-auto">
128
+ <Button width="100%">Đầu tư</Button>
129
+ </div>
120
130
  </section>;
121
131
  ```
122
132
 
@@ -131,8 +141,9 @@ import { Button } from "@finhay-pro/leaf-design-system";
131
141
  | Radius S/M/L/Full | 4 · 8 · 12 · full | `rounded-sm` / `rounded-lg` / `rounded-xl` / `rounded-full` |
132
142
  | Border S/M/L/XL | 0.5 · 1 · 1.5 · 2 | `border-[0.5px]` / `border` / `border-[1.5px]` / `border-2` |
133
143
 
134
- - Override CSS của component bằng `className` Tailwind: utility (`@layer utilities`) luôn thắng CSS
135
- component (`@layer components`), không cần `!important`.
144
+ - Component React **không nhận `className`**. Layout / spacing: bọc `div` Tailwind. Màu / chữ:
145
+ prop token (`color`, `background`, `typography`). Size: prop `width` / `height` nếu component
146
+ có. HTML tĩnh gắn class Leaf (`text-*`, `bg-*`) trên markup `.leaf-*`.
136
147
 
137
148
  ## Typography class
138
149
 
@@ -174,7 +185,8 @@ nhau, nên một `h1` hoàn toàn có thể hiển thị bằng style `display-3
174
185
  <h1 class="display-3">Finhay</h1>
175
186
  ```
176
187
 
177
- Trong React / Next.js, class đi thẳng vào `className` của bất kỳ element hay component nào:
188
+ Trong React / Next.js, class typography / màu gắn vào `className` của element HTML — **không**
189
+ truyền `className` vào component Leaf (dùng prop token / bọc `div`):
178
190
 
179
191
  ```tsx
180
192
  <h2 className="heading-2">Tài sản của bạn</h2>
@@ -305,33 +317,35 @@ Thêm component React (khi thật sự cần state/behavior, không phải để
305
317
  `src/components/<Tên>/` (kèm `<tên>.css` nếu cần) rồi re-export trong `src/index.ts`. CSS của
306
318
  component cũng ra `dist/<tên>.css` và được gom vào `classes.css` / `styles.css` — nhớ thêm dòng
307
319
  `"./<tên>.css"` vào `exports`. Tên file CSS phải duy nhất trong cả `src/` (script báo lỗi nếu trùng).
308
- Component có hành vi (Button loading · Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown) cần thêm bản vanilla cho HTML
320
+ Component có hành vi (Button loading · Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown · Carousel · QrCode · Upload · Calendar · InputDate · MultiSelect · Form) cần thêm bản vanilla cho HTML
309
321
  tĩnh trong `src/vanilla/` và gắn vào `window.Leaf` qua `src/vanilla/index.ts`. `src/vanilla` chỉ
310
322
  vào bản CDN, không vào bản npm.
311
323
 
312
324
  ## Components
313
325
 
314
- | Export | Mô tả |
315
- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
316
- | `Button` | Khung icon · label · icon — bật/tắt từng phần; `width` / `height`; `onClick` trả Promise → tự loading (spinner thay leading icon, khoá click), `loading` controlled |
317
- | `Tabs` | Tabs Items — `items[]` (`value` · `label: ReactNode` · `disabled`); phím ← → Home End |
318
- | `Dialog` | Panel + backdrop blur — `open` (controlled), `title` / `onBack` / `onClose(reason)`, `dismissible`, `closeLabel` / `backLabel`, `theme`, `maxWidth` / `height` / `maxHeight` |
319
- | `Logo` | Wordmark FHSC · Finhay · FHC — `brand` / `mode` / `side` / `size` |
320
- | `Skeleton` | Placeholder shimmer — `width` / `height` / `border` (radius), nền `--base-tertiary` |
321
- | `Spinner` | Indicator 8 nan — `animation` (`spin` · `fade` · `pulse` · `breathe`), `size` |
322
- | `Toggle` | Công tắc On/Off — `size` md/sm, `checked`, `disabled` (Figma Active Off); `name` / `value` → input ẩn cho form |
323
- | `Slider` | Kéo từng `step` trong `min`–`max` (mặc định 0–100, bước 1) · mốc `steps` · `labels`; `name` → input ẩn |
324
- | `Tooltip` | Hover/focus/Escape — `size`, `position`, `align`, `onOpenChange`; `trigger="click"`, `openDelay` / `closeDelay`, tự lật phía khi thiếu chỗ, `theme`; kèm `TooltipContent` |
325
- | `Radio` / `RadioGroup` | Radio đơn + nhóm — `value` / `defaultValue` / `onValueChange`, `name` cho form, `disabled`, `orientation` |
326
- | `Checkbox` | Checkbox — `checked` / `defaultChecked` / `onCheckedChange` (`checked="indeterminate"` cho trạng thái lưng chừng), `label`, `disabled`; input native nên đi thẳng vào `FormData` |
327
- | `Input` | Input dynamic — `variant` field/inline, `shape` default/pill, slot `label` · `leadingIcon` · `trailingIcon` · `action` · `message`, `invalid`, `revealPassword`; `as="button"` làm trigger |
328
- | `InputOtp` | Ô OTP — `length`, `mask`, dán cả mã, `onComplete`; `name` → input ẩn |
329
- | `InputStepper` | Nhập số với −/+ — `tone` buy/sell, `step` / `min` / `max` / `precision`, `locale`, `unit`; phím ↑ ↓, chốt khi blur/Enter |
330
- | `Calendar` | Lịch tháng (port từ vnsc) — chọn ngày / giờ (`showTime`, `timeOnly`), `minDate` / `maxDate` / `disablePast` / `disableFuture` / `disableDate`, luật giờ (`minHour` / `maxHour` / `minuteStep`…), `weekStartsOn`, `labels`; dùng độc lập được |
331
- | `InputDate` | `Input` trigger + popover `Calendar` — `value` chốt khi bấm "Chọn" (hoặc `confirmOnSelect`), `formatDisplay`, `align`, tự lật phía; `name` → input ẩn ISO |
332
- | `Toaster` / `toast` | Toast success / error / warning — `toast.success(title, { description, duration })`, `duration: -1` không tự đóng, dừng khi hover / focus, `toast.dismiss(id)`; `<Toaster position closeLabel theme />` đặt một lần; kèm `ToastContent` |
333
- | `Dropdown` | Chọn một giá trị — `variant` list / radio, `trigger` field / text, `appearance` filled / outlined, `size` md / sm, `openOn` click / hover, `align`, `readOnly`, `maxHeight`; option `leading` / `disabled`; phím ↑ ↓ Home End + typeahead |
334
- | `LanguageDropdown` | Chọn ngôn ngữ Tiếng Việt / English kèm cờ (CDN Finhay) — danh sách ở `LEAF_LANGUAGES`, `value` kiểu `LeafLanguageCode`; mặc định `size="sm"`, `openOn="hover"`, `align="end"` |
326
+ | Export | Mô tả |
327
+ | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
328
+ | `Button` | Khung icon · label · icon — bật/tắt từng phần; `width` / `height`; `onClick` trả Promise → tự loading (spinner thay leading icon, khoá click), `loading` controlled |
329
+ | `Tabs` | Tabs Items — `items[]` (`value` · `label: ReactNode` · `disabled`); phím ← → Home End |
330
+ | `Dialog` | Panel + backdrop blur — `open` (controlled), `title` / `onBack` / `onClose(reason)`, `dismissible`, `closeLabel` / `backLabel`, `theme`, `maxWidth` / `height` / `maxHeight` |
331
+ | `Logo` | Wordmark FHSC · Finhay · FHC — `brand` / `mode` / `side` / `size` |
332
+ | `Skeleton` | Placeholder shimmer — `width` / `height` / `border` (radius), nền `--base-tertiary` |
333
+ | `Empty` | Trạng thái không có dữ liệu — `image` (string URL; không truyền = ẩn, `""` = CDN mặc định) · `size` sm/md · `description` (mặc định “Không có dữ liệu”) |
334
+ | `Spinner` | Indicator 8 nan — `animation` (`spin` · `fade` · `pulse` · `breathe`), `size` |
335
+ | `Toggle` | Công tắc On/Off — `size` md/sm, `checked`, `disabled` (Figma Active Off); `name` / `value` → input ẩn cho form |
336
+ | `Slider` | Kéo từng `step` trong `min`–`max` (mặc định 0–100, bước 1) · mốc `steps` · `labels`; `name` → input ẩn |
337
+ | `Tooltip` | Hover/focus/Escape — `size`, `position`, `align`, `onOpenChange`; `trigger="click"`, `openDelay` / `closeDelay`, tự lật phía khi thiếu chỗ, `theme`; kèm `TooltipContent` |
338
+ | `Radio` / `RadioGroup` | Radio đơn + nhóm — `value` / `defaultValue` / `onValueChange`, `name` cho form, `disabled`, `orientation` |
339
+ | `Checkbox` | Checkbox — `checked` / `defaultChecked` / `onCheckedChange` (`checked="indeterminate"` cho trạng thái lưng chừng), `label`, `disabled`; input native nên đi thẳng vào `FormData` |
340
+ | `Input` | Input dynamic — `variant` field/inline, `shape` default/pill, slot `label` · `leadingIcon` · `trailingIcon` · `action` · `message`, `invalid`, `revealPassword`; `as="button"` làm trigger |
341
+ | `InputOtp` | Ô OTP — `length`, `mask`, dán cả mã, `onComplete`; `name` → input ẩn |
342
+ | `InputStepper` | Nhập số với −/+ — `tone` buy/sell, `step` / `min` / `max` / `precision`, `locale`, `unit`; phím ↑ ↓, chốt khi blur/Enter |
343
+ | `Calendar` | Lịch tháng (port từ vnsc) — chọn ngày / giờ / tháng (`showTime`, `timeOnly`, `monthOnly`), `minDate` / `maxDate` / `disablePast` / `disableFuture` / `disableDate`, luật giờ (`minHour` / `maxHour` / `minuteStep`…), `weekStartsOn`, `labels`; dùng độc lập được |
344
+ | `InputDate` | `Input` trigger + popover `Calendar` — `value` chốt khi bấm "Chọn" (hoặc `confirmOnSelect`), `formatDisplay`, `align`, `monthOnly` (MM/YYYY); `name` → input ẩn ISO |
345
+ | `Toaster` / `toast` | Toast success / error / warning — `toast.success(title, { description, duration })`, `duration: -1` không tự đóng, dừng khi hover / focus, `toast.dismiss(id)`; `<Toaster position closeLabel theme />` đặt một lần; kèm `ToastContent` |
346
+ | `Dropdown` | Chọn một giá trị — `variant` list / radio, `trigger` field / text, `appearance` filled / outlined, `size` md / sm, `openOn` click / hover, `align`, `readOnly`, `maxHeight`; option `leading` / `disabled`; phím ↑ ↓ Home End + typeahead |
347
+ | `FileViewer` | Xem file (PDF native, XLSX / CSV, DOCX, ảnh, video / audio, text) không thư viện ngoài — `source` URL (+`fetchInit`) / Blob / base64, toolbar, `ref`; kèm `FileViewerDialog` |
348
+ | `LanguageDropdown` | Chọn ngôn ngữ Tiếng Việt / English kèm cờ (CDN Finhay) — danh sách ở `LEAF_LANGUAGES`, `value` kiểu `LeafLanguageCode`; mặc định `size="sm"`, `openOn="hover"`, `align="end"` |
335
349
 
336
350
  ```css
337
351
  /* Ngoài tokens.css + typography.css, mỗi component cần CSS riêng của nó
@@ -342,7 +356,7 @@ vào bản CDN, không vào bản npm.
342
356
  @import "@finhay-pro/leaf-design-system/toast.css";
343
357
  @import "@finhay-pro/leaf-design-system/input.css";
344
358
  @import "@finhay-pro/leaf-design-system/dropdown.css";
345
- /* … skeleton / spinner / toggle / slider / tooltip / radio / checkbox / input-otp /
359
+ /* … skeleton / empty / spinner / toggle / slider / tooltip / radio / checkbox / input-otp /
346
360
  input-stepper / calendar / input-date / logo */
347
361
  ```
348
362
 
@@ -353,6 +367,7 @@ import {
353
367
  Dialog,
354
368
  Logo,
355
369
  Skeleton,
370
+ Empty,
356
371
  Spinner,
357
372
  Toggle,
358
373
  Slider,
@@ -384,6 +399,9 @@ import { RiAddLine, RiArrowRightLine } from "@remixicon/react";
384
399
  </Button>
385
400
 
386
401
  <Skeleton height={48} border={12} />
402
+ <Empty image="" />
403
+ <Empty image="" size="sm" description="Chưa có giao dịch" />
404
+ <Empty image="https://cdn.example.com/empty.png" />
387
405
 
388
406
  <Tabs
389
407
  variant="buy"
@@ -399,17 +417,79 @@ import { RiAddLine, RiArrowRightLine } from "@remixicon/react";
399
417
  toast.success("Đặt lệnh thành công", { description: "Mua 100 AAA" });
400
418
  ```
401
419
 
420
+ ## Đọc & ghi file (không UI)
421
+
422
+ Đọc / ghi Excel / CSV / text ngay trên trình duyệt, **không thư viện ngoài** (ZIP giải bằng
423
+ `DecompressionStream("deflate-raw")`, XML bằng `DOMParser`). Source nhận URL (kèm `fetchInit` để
424
+ gửi header đăng nhập), `Blob` / `File`, `ArrayBuffer` / typed array, hoặc `{ base64, mimeType }`.
425
+
426
+ | Export | Mô tả |
427
+ | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
428
+ | `readSpreadsheet(source, opt)` | XLSX / CSV → `{ sheets: [{ name, hidden, rows, merges, colWidths }] }`; ô `{ v, t, w }` — `w` là chuỗi hiển thị như Excel (numFmt + locale) |
429
+ | `spreadsheetToCsv(sheet, opt)` | Một sheet → CSV; `values: "raw"` (mặc định, cho import dữ liệu) hoặc `"formatted"`, `delimiter`, `blankRows` |
430
+ | `readText(source)` | Text theo BOM (UTF-8 / UTF-16) |
431
+ | `readFileSource(source, opt)` | Chuẩn hoá source → `{ blob, name, mime, size }`; `maxSize` (mặc định 20 MB), `signal` |
432
+ | `detectFileType(file)` | `pdf` · `image` · `video` · `audio` · `text` · `csv` · `xlsx` · `docx` · `unsupported` (MIME → đuôi → magic bytes) |
433
+ | `readSpreadsheetRecords` / `sheetToRecords` | Sheet → mảng object theo dòng header (`headerRow`, `values: "raw" \| "formatted"`) — thay `XLSX.utils.sheet_to_json` |
434
+ | `parseCsv` / `toCsv` | CSV RFC 4180, tự nhận `,` `;` `\t` `\|` |
435
+ | `parseCsvRecords` | CSV → `Record<string, string>[]` (trim, bỏ dòng trống, `transformHeader`) — thay `papaparse` `header: true` |
436
+ | `writeXlsx(sheets, opt)` | → `Blob` XLSX: nhiều sheet, chuỗi / số / boolean / `Date`, header đậm + cố định, độ rộng cột (tự tính), ô gộp — thay `XLSX.write` |
437
+ | `jsonToSheetRows(objs, cols)` | Mảng object → dòng có header (`key` / hàm + `header`) — thay `XLSX.utils.json_to_sheet` |
438
+ | `downloadXlsx` / `downloadCsv` / `downloadBlob` / `csvBlob` | Tải file qua `<a download>`; CSV có BOM UTF-8 cho Excel — thay `XLSX.writeFile`, `react-csv`, `file-saver` |
439
+ | `FileReadError` | Lỗi có `code`: `invalid-source` · `fetch-failed` · `too-large` · `corrupt` · `encrypted` · `unsupported` · `legacy-format` · `unsupported-browser` · `aborted` |
440
+
441
+ ```ts
442
+ import { readSpreadsheet, spreadsheetToCsv, FileReadError } from "@finhay-pro/leaf-design-system";
443
+
444
+ try {
445
+ const { sheets } = await readSpreadsheet(file); // File từ <Upload> / <input type="file">
446
+ const csv = spreadsheetToCsv(sheets[0]); // "FPT,1200,98500,…" — số / ngày (YYYY-MM-DD) giá trị gốc
447
+ } catch (error) {
448
+ if (error instanceof FileReadError && error.code === "legacy-format") {
449
+ // .xls (Excel 97–2003) — yêu cầu lưu lại dạng .xlsx; file có mật khẩu → "encrypted"
450
+ }
451
+ }
452
+
453
+ // Import → mảng object; xuất báo cáo
454
+ const rows = await readSpreadsheetRecords(file); // [{ "Mã CK": "VNM", "KL": 1000 }]
455
+ await downloadXlsx("bao-cao.xlsx", [{ name: "Lệnh", header: true, rows: jsonToSheetRows(orders) }]);
456
+ downloadCsv("lenh.csv", [
457
+ ["Mã", "KL"],
458
+ ["VNM", 1000],
459
+ ]);
460
+ ```
461
+
462
+ Giới hạn: không đọc `.xls` cũ (BIFF) → `legacy-format`, ZIP64, file có mật khẩu → `encrypted`;
463
+ `writeXlsx` không ghi công thức / màu / viền; trình duyệt tối thiểu Chrome 103+, Safari 16.4+,
464
+ Firefox 113+ (thiếu API → `unsupported-browser`; ghi XLSX thiếu `CompressionStream` thì lưu không
465
+ nén, file vẫn hợp lệ).
466
+
467
+ ### Thay thư viện nào bằng gì
468
+
469
+ | Đang dùng | Leaf |
470
+ | -------------------------------------------------------- | --------------------------------------------------------------------- |
471
+ | `react-dropzone` | `Upload` (`accept`, `maxSize`, `minSize`, `maxFiles`, `onReject`) |
472
+ | `react-medium-image-zoom`, `react-image-pan-zoom-rotate` | `FileViewer` ảnh (zoom 25–400%, xoay, kéo) / `Upload preview` |
473
+ | `<object>` / `<iframe>` PDF base64 | `FileViewer` / `FileViewerDialog` với `source={{ base64, mimeType }}` |
474
+ | `react-pdf` (desktop web) | `FileViewer` PDF (trình xem của trình duyệt) |
475
+ | `xlsx` đọc (`read`, `sheet_to_json`) | `readSpreadsheet`, `readSpreadsheetRecords`, `spreadsheetToCsv` |
476
+ | `xlsx` ghi (`json_to_sheet`, `writeFile`) | `jsonToSheetRows`, `writeXlsx`, `downloadXlsx` |
477
+ | `papaparse` | `parseCsv`, `parseCsvRecords` |
478
+ | `react-csv`, `file-saver` | `downloadCsv`, `downloadBlob` |
479
+
480
+ Chưa thay được: đọc `.xls` cũ (BIFF), xem PDF inline trên Chrome Android / WebView (Leaf hiện nút
481
+ Mở tab mới / Tải xuống).
482
+
402
483
  ## HTML tĩnh (CDN)
403
484
 
404
485
  Cho landing page / trang dựng tay không có bundler: **Leaf CDN + CSS riêng của page**. 1 `<link>` +
405
486
  1 `<script>` là dùng được toàn bộ class typography, color và mọi component (CSS). Script chỉ cần
406
- khi dùng hành vi Button loading · Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown (`data-leaf-*` / `window.Leaf`).
407
- Calendar / InputDate chưa có bản HTML tĩnh (chỉ React).
487
+ khi dùng hành vi Button loading · Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown · Carousel · QrCode · Upload · Calendar · InputDate · MultiSelect · Form (`data-leaf-*` / `window.Leaf`).
408
488
  Layout, spacing, responsive của page viết trong CSS của page, dùng token Leaf.
409
489
 
410
490
  ```html
411
- <link rel="stylesheet" href="https://<cdn>/leaf-0.2.0.min.css" />
412
- <script src="https://<cdn>/leaf-0.2.0.min.js" defer></script>
491
+ <link rel="stylesheet" href="https://<cdn>/leaf-0.2.2.min.css" />
492
+ <script src="https://<cdn>/leaf-0.2.2.min.js" defer></script>
413
493
  <!-- Icon: Remix Icon (xem mục Icon) -->
414
494
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/remixicon@4.9.1/fonts/remixicon.css" />
415
495
 
@@ -448,11 +528,12 @@ Layout, spacing, responsive của page viết trong CSS của page, dùng token
448
528
  | File | Nội dung |
449
529
  | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
450
530
  | `leaf-<version>.min.css` | `styles.css` đã minify: token + typography + color + CSS của mọi component. |
451
- | `leaf-<version>.min.js` | Hành vi Button loading · Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown → `window.Leaf`. Trang CSS-only có thể bỏ. |
531
+ | `leaf-<version>.min.js` | Hành vi Button loading · Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown · Carousel · QrCode · Upload · Calendar · InputDate · MultiSelect · Form → `window.Leaf`. Trang CSS-only có thể bỏ. |
452
532
 
453
533
  Bản CDN nằm trong package npm (`dist/cdn/`), nên jsDelivr phục vụ trực tiếp theo version:
454
534
  `https://cdn.jsdelivr.net/npm/@finhay-pro/leaf-design-system@<version>/dist/cdn/leaf-<version>.min.css`
455
- (và `.min.js`) — cũng là link trên trang docs **Develop → Web** (`apps/docs/config/shared.ts` →
535
+ (và `.min.js`) — cũng là link trên trang docs
536
+ [**Installation**](http://leaf-design-system.finhay.local/installation) (`apps/docs/config/shared.ts` →
456
537
  `leafCdn`). Trang demo đủ mọi component có bản HTML tĩnh:
457
538
  [`examples/static.html`](examples/static.html) (mở bằng `file://` sau khi build).
458
539
 
@@ -570,10 +651,32 @@ giống React. Trigger `filled` có nền `--base-secondary` — đặt trên ca
570
651
  `leaf:dropdown-change`. Có `input.leaf-dropdown__input` thì leaf.js ghi value vào đó. Panel nằm ngay
571
652
  dưới trigger (không portal) — tránh đặt trong khung `overflow: hidden / auto` thấp hơn panel.
572
653
 
573
- ### Skeleton / Spinner
654
+ ### FileViewer
655
+
656
+ `<div class="leaf-file-viewer" data-leaf-file-viewer data-src="…">` tự tải khi DOM sẵn sàng; hoặc
657
+ `Leaf.fileViewer.open(el, source, options)` / `clear(el)` / `get(el)` / `zoom(el, n)`, event
658
+ `leaf:file-viewer-load` · `-error` · `-change`. Markup do controller dùng chung với React dựng nên
659
+ giống hệt. Dùng được trong app React 18 qua `useEffect`.
660
+
661
+ ### Đọc file
574
662
 
575
- Chỉ CSS. Skeleton: `--leaf-skeleton-width` / `height` / `radius`. Spinner: `data-animation` /
576
- `data-size` + SVG path; overlay = `.leaf-spinner-overlay` (app tự `hidden`/mount).
663
+ `Leaf.file` — cùng API phần [Đọc & ghi file](#đọc--ghi-file-không-ui), không cần markup:
664
+
665
+ ```js
666
+ input.addEventListener("change", async () => {
667
+ const { sheets } = await Leaf.file.readSpreadsheet(input.files[0]);
668
+ console.log(Leaf.file.spreadsheetToCsv(sheets[0]));
669
+ });
670
+ // Leaf.file.read(source) · Leaf.file.detectType(file) · Leaf.file.readText(source)
671
+ // Leaf.file.readSpreadsheetRecords(file) · Leaf.file.parseCsvRecords(text)
672
+ // Leaf.file.downloadXlsx(name, sheets) · Leaf.file.downloadCsv(name, rows) · Leaf.file.download(name, blob)
673
+ ```
674
+
675
+ ### Skeleton / Empty / Spinner
676
+
677
+ Chỉ CSS. Skeleton: `--leaf-skeleton-width` / `height` / `radius`. Empty: `.leaf-empty` +
678
+ `data-size` sm/md (ảnh CDN + description). Spinner: `data-animation` / `data-size` + SVG path;
679
+ overlay = `.leaf-spinner-overlay` (app tự `hidden`/mount).
577
680
 
578
681
  ### Cần biết
579
682
 
@@ -608,6 +711,109 @@ Chỉ CSS. Skeleton: `--leaf-skeleton-width` / `height` / `radius`. Spinner: `da
608
711
 
609
712
  ## Changelog
610
713
 
714
+ ### 0.2.2
715
+
716
+ **Đọc file — không thư viện ngoài**
717
+
718
+ - `readSpreadsheet` đọc XLSX / CSV thành `{ sheets }`: ô gộp, sheet ẩn, độ rộng cột, shared string /
719
+ rich text / inline string, công thức (giá trị cache), boolean, lỗi, ngày (hệ 1900 và 1904); chuỗi
720
+ hiển thị `w` theo numFmt của Excel (`#,##0`, `0.00%`, `dd/mm/yyyy`, `[h]:mm`, `"đ"`…) và locale
721
+ (mặc định `vi-VN`). Thay được `xlsx` (SheetJS) khi import dữ liệu.
722
+ - `spreadsheetToCsv`, `readText`, `readFileSource` (URL + `fetchInit`, Blob, base64, `maxSize`),
723
+ `detectFileType`, `parseCsv` / `toCsv`, `FileReadError` (`code`).
724
+ - Chống zip bomb (giới hạn entry / dung lượng giải nén, đếm byte thực), từ chối ZIP64 / mã hoá.
725
+ - `readDocxText` (plain text của DOCX), ô bảng tính có style `s` (đậm / nghiêng / màu / nền / căn lề).
726
+ - leaf.js: `Leaf.file.{read, detectType, readText, readSpreadsheet, spreadsheetToCsv, readDocxText}`.
727
+
728
+ **FileViewer — xem file trong app (React + leaf.js)**
729
+
730
+ - `FileViewer` / `FileViewerDialog` + `Leaf.fileViewer` (`data-leaf-file-viewer`) — một controller
731
+ dùng chung (`core/file/viewer.ts`) nên markup React và HTML tĩnh trùng nhau.
732
+ - PDF: trình xem có sẵn của trình duyệt; `navigator.pdfViewerEnabled === false` (Chrome Android) →
733
+ "Mở tab mới" / "Tải xuống" (`pdfMode`). XLSX / CSV: bảng có header dính, ô gộp, style ô, tab sheet,
734
+ ảo hoá > 200 dòng. DOCX: heading, list nhiều cấp, bảng gộp ô, ảnh, link, ngắt trang. Ảnh: zoom /
735
+ xoay / kéo. Video / audio / text.
736
+ - Trạng thái idle / loading / lỗi (Thử lại) / không hỗ trợ (PPTX, Office cũ — Tải xuống); nhãn
737
+ tiếng Việt mặc định + `FILE_VIEWER_LABELS_EN`; `ref` (`FileViewerHandle`) điều khiển từ ngoài.
738
+ - An toàn: không `innerHTML` với nội dung file, link DOCX chỉ http(s) / mailto / tel, object URL
739
+ luôn được thu hồi. CSS `file-viewer.css`; icon Remix mới trong `core/icons.ts`.
740
+ - Docs `/components/file-viewer` (13 ví dụ React + 8 snippet HTML) — người dùng tự chọn / kéo thả
741
+ file để xem; skill `references/components/file-viewer.md`.
742
+ - leaf.js tăng ~60 KB minified (~56 KB gzip toàn bộ) do parser ZIP / XML / XLSX / DOCX.
743
+ - Fixture test trong `test/fixtures/`: `example1.xlsx` (3 sheet) · `example2.docx` · `example3.pdf`
744
+ (2 trang) · `example4.png`; CSV `;` / PPTX dựng trong bộ nhớ (`csvSample` / `pptxSample`), edge
745
+ case dựng bằng `test/helpers/zip.ts`.
746
+
747
+ **Ghi file — không thư viện ngoài**
748
+
749
+ - `writeXlsx(sheets)` → `Blob` XLSX hợp lệ (shared strings, numFmt ngày `dd/mm/yyyy` /
750
+ `dd/mm/yyyy hh:mm:ss`, header đậm + cố định, độ rộng cột tự tính, ô gộp, tên sheet tự làm sạch /
751
+ chống trùng); ZIP nén bằng `CompressionStream("deflate-raw")`, thiếu API thì lưu không nén.
752
+ - `jsonToSheetRows`, `downloadBlob`, `downloadCsv` (BOM UTF-8 mặc định), `downloadXlsx`, `csvBlob`.
753
+ - `readSpreadsheetRecords` / `sheetToRecords` / `parseCsvRecords`: dữ liệu import thành mảng object
754
+ (header trim, rỗng → `Cột N`, trùng → `_2`).
755
+ - leaf.js: `Leaf.file` thêm `readSpreadsheetRecords`, `sheetToRecords`, `parseCsv`,
756
+ `parseCsvRecords`, `toCsv`, `writeXlsx`, `jsonToSheetRows`, `csvBlob`, `download`, `downloadCsv`,
757
+ `downloadXlsx`.
758
+
759
+ **Upload**
760
+
761
+ - `maxSize` / `minSize`, `onReject(rejections)` với lý do `accept` · `max-size` · `min-size` ·
762
+ `max-files` · `multiple` — trước đây file bị loại biến mất im lặng. Thả file khi đã đủ `maxFiles`
763
+ cũng báo `max-files`.
764
+ - `preview`: thumbnail ảnh (icon file với loại khác), dung lượng (`formatFileSize`), nút xem mở
765
+ `FileViewerDialog`; `viewLabel`, `viewerLabels`.
766
+ - `accept` khớp cả MIME suy từ đuôi khi `File.type` rỗng (`.heic` trên Chrome) hoặc sai (`.csv` từ
767
+ Excel Windows).
768
+ - `DynamicForm` field `upload` nhận `upload: { accept, maxSize, minSize, multiple, maxFiles, preview,
769
+ formats, dropLabel, onReject }`.
770
+ - leaf.js: `data-max-size` / `data-min-size`, `data-preview` / `data-view-label`, event
771
+ `leaf:upload-reject` · `leaf:upload-view` (`Leaf.upload.REJECT_EVENT` / `VIEW_EVENT`).
772
+ - Sửa: leaf.js nội suy tên file vào `innerHTML` (tên file chứa HTML chạy được script) — nay dựng DOM
773
+ bằng `textContent`. `countLabel` dạng chuỗi thay mọi chữ `N` (vd. "Nhận" → "1hận") — nay chỉ
774
+ `{count}` hoặc `N` đứng riêng.
775
+
776
+ **FileViewer — sửa / bổ sung**
777
+
778
+ - An toàn: object URL luôn bọc lại với MIME cố định theo loại thay vì `Content-Type` của server; PDF
779
+ bắt buộc chữ ký `%PDF-` kể cả khi app ép `type` / `mimeType` (server trả nhầm HTML không còn chạy
780
+ trong iframe dưới origin app); "Mở tab mới" chỉ cho PDF; "Tải xuống" luôn
781
+ `application/octet-stream`.
782
+ - `FileReadError` code mới `legacy-format` cho `.xls` / `.doc` / `.ppt` (Office 97–2003); OOXML có mật
783
+ khẩu báo `encrypted` — cả viewer lẫn `readSpreadsheet` / `readDocxText`.
784
+ - HEIC / HEIF / TIFF: trình duyệt không decode được (Chrome, Firefox) → "không hỗ trợ" + Tải xuống
785
+ thay vì "file hỏng". Nhận `.tif` / `.tiff` / `image/tiff` là ảnh.
786
+ - DOCX: đọc bookmark; link `#bookmark` cuộn trong viewer thay vì đổi hash / route của app.
787
+ - `FileViewerDialog` thêm `footer` (hàng nút dưới viewer).
788
+
789
+ ### 0.2.1
790
+
791
+ **InputDate / Calendar — chọn theo tháng**
792
+
793
+ - Thêm prop `monthOnly` cho `InputDate` và `Calendar`: panel là lưới 12 tháng (header năm trước /
794
+ năm / năm sau, footer "Tháng này" / "Chọn") thay cho lưới ngày. Giá trị là ngày 1 của tháng lúc
795
+ 00:00 (giờ local); `showTime` / `timeOnly` bị bỏ qua khi có `monthOnly`.
796
+ - `InputDate monthOnly`: trigger + placeholder `MM/YYYY`, input ẩn (`name`) `YYYY-MM`,
797
+ `confirmOnSelect` chọn tháng là xác nhận.
798
+ - Rule ngày so theo tháng khi `monthOnly`: `minDate` / `maxDate` / `disablePast` /
799
+ `disableFuture` khoá cả tháng nằm ngoài khoảng, `disableDate` nhận ngày 1 của từng tháng.
800
+ - `CalendarLabels` thêm `thisMonth` (mặc định "Tháng này").
801
+ - `calendar.css`: ô tháng (`.leaf-calendar__option`) có trạng thái `data-today` / `:disabled`;
802
+ root `data-month-only="true"` cho ô cao 40px.
803
+ - Docs (Input, Calendar) và Claude skill (`input-date.md`, `calendar.md`) cập nhật ví dụ / prop.
804
+ - `monthOnly` trên React và leaf.js (`data-month-only` trên `data-leaf-calendar` / `data-leaf-input-date`).
805
+
806
+ **Sửa lỗi**
807
+
808
+ - Dialog: hàm dọn dẹp của dialog gọi lại lần nữa (đóng 2 lần) không còn mở khoá scroll của
809
+ `<body>` khi dialog khác vẫn đang mở — cả React lẫn leaf.js.
810
+
811
+ **Test**
812
+
813
+ - Test chuyển ra `test/` (không nằm trong `src`): `test/unit` (giống cấu trúc `src`), `test/build`
814
+ (test bản build: export npm, CSS, CDN `window.Leaf`, skill zip, markup build so với source),
815
+ `test/helpers`. Coverage bắt buộc 100%. Chạy `pnpm verify` (cần Node ≥ 22).
816
+
611
817
  ### 0.2.0
612
818
 
613
819
  **Icon — Remix Icon**
@@ -856,10 +1062,12 @@ Chỉ CSS. Skeleton: `--leaf-skeleton-width` / `height` / `radius`. Spinner: `da
856
1062
  Logo CSS data-URI theo `data-brand` / `data-mode` / `data-side`; docs `htmlSection` +
857
1063
  `examples/static.html` cover đủ component.
858
1064
  - Skeleton: placeholder shimmer (`width` / `height` / `border`), nền `--base-tertiary`.
1065
+ - Empty: trạng thái không dữ liệu — `image` (string URL; `""` = CDN mặc định) · `size`
1066
+ sm/md · `description` (mặc định “Không có dữ liệu”).
859
1067
  - Spinner: indicator 8 nan (loader-line), animation `spin` · `fade` · `pulse` · `breathe`; màu
860
1068
  mặc định trắng (dark) / đen (light) qua `--base-quinary`, overlay cũng vậy — không dùng highlight.
861
1069
  - Toggle: công tắc On/Off (Figma 730:12438) — size md/sm, checked, disabled.
862
- - Slider: bước rời (Figma 730:12646) — title/unit, labels, activeColor.
1070
+ - Slider: bước rời (Figma 730:12646) — title/unit, labels, color (LeafTextColor → data-color).
863
1071
  - Tooltip: hover/focus (Figma 891:4983) — size/position/align + TooltipContent.
864
1072
  - Dialog / Logo: React component + CSS (Logo asset generate qua `embed-logo-assets.mjs`).
865
1073
  - Thêm bản CDN cho HTML tĩnh: `leaf-<version>.min.css` + `leaf-<version>.min.js` (`window.Leaf`).
package/dist/button.css CHANGED
@@ -61,6 +61,13 @@
61
61
  vertical-align: middle;
62
62
  text-decoration: none;
63
63
  appearance: none;
64
+ outline: none;
65
+ }
66
+
67
+ /* Chỉ báo focus bàn phím (WCAG 2.4.7) — :focus-visible nên click chuột không hiện ring. */
68
+ .leaf-button:focus-visible {
69
+ outline: 2px solid var(--text-highlight);
70
+ outline-offset: 2px;
64
71
  }
65
72
 
66
73
  .leaf-button__icon {
package/dist/calendar.css CHANGED
@@ -4,11 +4,11 @@
4
4
  /* --- src/components/Calendar/calendar.css --- */
5
5
 
6
6
  /*
7
- * Calendar — port từ vnsc Calendar (panel chọn ngày / giờ).
7
+ * Calendar — port từ vnsc Calendar (panel chọn ngày / giờ / tháng).
8
8
  *
9
9
  * Typography và màu tĩnh (nền, màu viền) là class Leaf trên markup. File này giữ khung
10
- * (padding, radius, độ dày viền), layout, size cố định (panel 256, ô 28, select 64), hover,
11
- * trạng thái ngày (data-selected / data-today / :disabled), vị trí dropdown
10
+ * (padding, radius, độ dày viền), layout, size cố định (panel 256, ô 28, ô tháng 40, select 64),
11
+ * hover, trạng thái ngày / tháng (data-selected / data-today / :disabled), vị trí dropdown
12
12
  * (data-placement), bóng đổ, reset button. Footer là `Button` (cần button.css).
13
13
  */
14
14
 
@@ -114,9 +114,10 @@
114
114
  color: var(--text-tertiary);
115
115
  }
116
116
 
117
+ /* Bóng theo token --overlay (80% alpha) × 44% ≈ độ đậm 35% trước đây. */
117
118
  .leaf-calendar__months,
118
119
  .leaf-calendar__list {
119
- box-shadow: 0 16px 40px rgb(0 0 0 / 0.35);
120
+ box-shadow: 0 16px 40px color-mix(in srgb, var(--overlay) 44%, transparent);
120
121
  }
121
122
 
122
123
  .leaf-calendar__months {
@@ -147,6 +148,15 @@
147
148
  gap: 4px;
148
149
  }
149
150
 
151
+ /* monthOnly — lưới 12 tháng thay cho lưới ngày. */
152
+ .leaf-calendar[data-month-only="true"] .leaf-calendar__months-grid {
153
+ row-gap: 8px;
154
+ }
155
+
156
+ .leaf-calendar[data-month-only="true"] .leaf-calendar__option {
157
+ height: 40px;
158
+ }
159
+
150
160
  .leaf-calendar__weekdays,
151
161
  .leaf-calendar__days {
152
162
  display: grid;
@@ -188,11 +198,12 @@
188
198
  }
189
199
 
190
200
  .leaf-calendar__day:not(:disabled):not([data-selected="true"]):hover,
191
- .leaf-calendar__option:not([data-selected="true"]):hover {
201
+ .leaf-calendar__option:not(:disabled):not([data-selected="true"]):hover {
192
202
  background-color: var(--base-tertiary);
193
203
  }
194
204
 
195
- .leaf-calendar__day[data-today="true"] {
205
+ .leaf-calendar__day[data-today="true"],
206
+ .leaf-calendar__option[data-today="true"] {
196
207
  border-color: var(--text-highlight);
197
208
  color: var(--text-highlight);
198
209
  }
@@ -205,7 +216,8 @@
205
216
  font-weight: var(--body-5-highlight-weight);
206
217
  }
207
218
 
208
- .leaf-calendar__day:disabled {
219
+ .leaf-calendar__day:disabled,
220
+ .leaf-calendar__option:disabled {
209
221
  border-color: transparent;
210
222
  background-color: transparent;
211
223
  color: var(--text-tertiary);