@finhay-pro/leaf-design-system 0.2.1 → 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 (323) hide show
  1. package/README.md +196 -17
  2. package/dist/button.css +7 -0
  3. package/dist/calendar.css +2 -1
  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 +1684 -117
  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 +2 -2
  13. package/dist/components/Calendar/Calendar.d.ts.map +1 -1
  14. package/dist/components/Calendar/Calendar.js +41 -23
  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 +6 -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 +244 -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 +3 -4
  89. package/dist/components/Input/InputDate.d.ts.map +1 -1
  90. package/dist/components/Input/InputDate.js +13 -6
  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 +2 -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 +4 -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 +12 -8
  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 +5 -0
  177. package/dist/core/calendar.d.ts.map +1 -1
  178. package/dist/core/calendar.js +11 -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.map +1 -1
  189. package/dist/core/dialog.js +28 -2
  190. package/dist/core/dialog.js.map +1 -1
  191. package/dist/core/dropdown.d.ts +15 -2
  192. package/dist/core/dropdown.d.ts.map +1 -1
  193. package/dist/core/dropdown.js +29 -4
  194. package/dist/core/dropdown.js.map +1 -1
  195. package/dist/core/file/csv.d.ts +42 -0
  196. package/dist/core/file/csv.d.ts.map +1 -0
  197. package/dist/core/file/csv.js +159 -0
  198. package/dist/core/file/csv.js.map +1 -0
  199. package/dist/core/file/detect.d.ts +38 -0
  200. package/dist/core/file/detect.d.ts.map +1 -0
  201. package/dist/core/file/detect.js +218 -0
  202. package/dist/core/file/detect.js.map +1 -0
  203. package/dist/core/file/docx-render.d.ts +14 -0
  204. package/dist/core/file/docx-render.d.ts.map +1 -0
  205. package/dist/core/file/docx-render.js +173 -0
  206. package/dist/core/file/docx-render.js.map +1 -0
  207. package/dist/core/file/docx.d.ts +110 -0
  208. package/dist/core/file/docx.d.ts.map +1 -0
  209. package/dist/core/file/docx.js +632 -0
  210. package/dist/core/file/docx.js.map +1 -0
  211. package/dist/core/file/dom.d.ts +18 -0
  212. package/dist/core/file/dom.d.ts.map +1 -0
  213. package/dist/core/file/dom.js +57 -0
  214. package/dist/core/file/dom.js.map +1 -0
  215. package/dist/core/file/download.d.ts +26 -0
  216. package/dist/core/file/download.d.ts.map +1 -0
  217. package/dist/core/file/download.js +57 -0
  218. package/dist/core/file/download.js.map +1 -0
  219. package/dist/core/file/error.d.ts +34 -0
  220. package/dist/core/file/error.d.ts.map +1 -0
  221. package/dist/core/file/error.js +19 -0
  222. package/dist/core/file/error.js.map +1 -0
  223. package/dist/core/file/mime.d.ts +11 -0
  224. package/dist/core/file/mime.d.ts.map +1 -0
  225. package/dist/core/file/mime.js +61 -0
  226. package/dist/core/file/mime.js.map +1 -0
  227. package/dist/core/file/render.d.ts +45 -0
  228. package/dist/core/file/render.d.ts.map +1 -0
  229. package/dist/core/file/render.js +133 -0
  230. package/dist/core/file/render.js.map +1 -0
  231. package/dist/core/file/sheet-render.d.ts +30 -0
  232. package/dist/core/file/sheet-render.d.ts.map +1 -0
  233. package/dist/core/file/sheet-render.js +152 -0
  234. package/dist/core/file/sheet-render.js.map +1 -0
  235. package/dist/core/file/source.d.ts +56 -0
  236. package/dist/core/file/source.d.ts.map +1 -0
  237. package/dist/core/file/source.js +188 -0
  238. package/dist/core/file/source.js.map +1 -0
  239. package/dist/core/file/text.d.ts +9 -0
  240. package/dist/core/file/text.d.ts.map +1 -0
  241. package/dist/core/file/text.js +21 -0
  242. package/dist/core/file/text.js.map +1 -0
  243. package/dist/core/file/viewer.d.ts +160 -0
  244. package/dist/core/file/viewer.d.ts.map +1 -0
  245. package/dist/core/file/viewer.js +623 -0
  246. package/dist/core/file/viewer.js.map +1 -0
  247. package/dist/core/file/xlsx-format.d.ts +55 -0
  248. package/dist/core/file/xlsx-format.d.ts.map +1 -0
  249. package/dist/core/file/xlsx-format.js +476 -0
  250. package/dist/core/file/xlsx-format.js.map +1 -0
  251. package/dist/core/file/xlsx-write.d.ts +48 -0
  252. package/dist/core/file/xlsx-write.d.ts.map +1 -0
  253. package/dist/core/file/xlsx-write.js +219 -0
  254. package/dist/core/file/xlsx-write.js.map +1 -0
  255. package/dist/core/file/xlsx.d.ts +115 -0
  256. package/dist/core/file/xlsx.d.ts.map +1 -0
  257. package/dist/core/file/xlsx.js +402 -0
  258. package/dist/core/file/xlsx.js.map +1 -0
  259. package/dist/core/file/xml.d.ts +34 -0
  260. package/dist/core/file/xml.d.ts.map +1 -0
  261. package/dist/core/file/xml.js +102 -0
  262. package/dist/core/file/xml.js.map +1 -0
  263. package/dist/core/file/zip-write.d.ts +24 -0
  264. package/dist/core/file/zip-write.d.ts.map +1 -0
  265. package/dist/core/file/zip-write.js +131 -0
  266. package/dist/core/file/zip-write.js.map +1 -0
  267. package/dist/core/file/zip.d.ts +37 -0
  268. package/dist/core/file/zip.d.ts.map +1 -0
  269. package/dist/core/file/zip.js +195 -0
  270. package/dist/core/file/zip.js.map +1 -0
  271. package/dist/core/form.d.ts +88 -0
  272. package/dist/core/form.d.ts.map +1 -0
  273. package/dist/core/form.js +353 -0
  274. package/dist/core/form.js.map +1 -0
  275. package/dist/core/icons.d.ts +14 -0
  276. package/dist/core/icons.d.ts.map +1 -1
  277. package/dist/core/icons.js +14 -0
  278. package/dist/core/icons.js.map +1 -1
  279. package/dist/core/number.d.ts +45 -0
  280. package/dist/core/number.d.ts.map +1 -0
  281. package/dist/core/number.js +74 -0
  282. package/dist/core/number.js.map +1 -0
  283. package/dist/core/qr-code.d.ts +18 -0
  284. package/dist/core/qr-code.d.ts.map +1 -0
  285. package/dist/core/qr-code.js +702 -0
  286. package/dist/core/qr-code.js.map +1 -0
  287. package/dist/core/stepper.d.ts +6 -2
  288. package/dist/core/stepper.d.ts.map +1 -1
  289. package/dist/core/stepper.js +12 -9
  290. package/dist/core/stepper.js.map +1 -1
  291. package/dist/core/upload.d.ts +51 -0
  292. package/dist/core/upload.d.ts.map +1 -0
  293. package/dist/core/upload.js +114 -0
  294. package/dist/core/upload.js.map +1 -0
  295. package/dist/date.css +19 -0
  296. package/dist/dropdown.css +117 -0
  297. package/dist/empty.css +74 -0
  298. package/dist/file-viewer.css +502 -0
  299. package/dist/focus.css +18 -0
  300. package/dist/form.css +64 -0
  301. package/dist/index.d.ts +24 -0
  302. package/dist/index.d.ts.map +1 -1
  303. package/dist/index.js +26 -0
  304. package/dist/index.js.map +1 -1
  305. package/dist/multiselect.css +147 -0
  306. package/dist/number.css +53 -0
  307. package/dist/qr-code.css +21 -0
  308. package/dist/skeleton.css +8 -0
  309. package/dist/skill/leaf-design-system-0.2.2.zip +0 -0
  310. package/dist/slider.css +55 -1
  311. package/dist/spinner.css +9 -1
  312. package/dist/styles.css +1684 -117
  313. package/dist/tabs.css +7 -0
  314. package/dist/textarea.css +28 -0
  315. package/dist/upload.css +317 -0
  316. package/dist/utils/colorClass.d.ts +22 -0
  317. package/dist/utils/colorClass.d.ts.map +1 -0
  318. package/dist/utils/colorClass.js +93 -0
  319. package/dist/utils/colorClass.js.map +1 -0
  320. package/package.json +12 -1
  321. package/dist/cdn/leaf-0.2.1.min.css +0 -2
  322. package/dist/cdn/leaf-0.2.1.min.js +0 -9
  323. package/dist/skill/leaf-design-system-0.2.1.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,7 +317,7 @@ 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
 
@@ -318,6 +330,7 @@ vào bản CDN, không vào bản npm.
318
330
  | `Dialog` | Panel + backdrop blur — `open` (controlled), `title` / `onBack` / `onClose(reason)`, `dismissible`, `closeLabel` / `backLabel`, `theme`, `maxWidth` / `height` / `maxHeight` |
319
331
  | `Logo` | Wordmark FHSC · Finhay · FHC — `brand` / `mode` / `side` / `size` |
320
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”) |
321
334
  | `Spinner` | Indicator 8 nan — `animation` (`spin` · `fade` · `pulse` · `breathe`), `size` |
322
335
  | `Toggle` | Công tắc On/Off — `size` md/sm, `checked`, `disabled` (Figma Active Off); `name` / `value` → input ẩn cho form |
323
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 |
@@ -331,6 +344,7 @@ vào bản CDN, không vào bản npm.
331
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 |
332
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` |
333
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` |
334
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
@@ -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.1.min.css" />
412
- <script src="https://<cdn>/leaf-0.2.1.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,12 +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
535
  (và `.min.js`) — cũng là link trên trang docs
456
- [**Develop → Web**](http://leaf-design-system.finhay.local/develop/web) (`apps/docs/config/shared.ts` →
536
+ [**Installation**](http://leaf-design-system.finhay.local/installation) (`apps/docs/config/shared.ts` →
457
537
  `leafCdn`). Trang demo đủ mọi component có bản HTML tĩnh:
458
538
  [`examples/static.html`](examples/static.html) (mở bằng `file://` sau khi build).
459
539
 
@@ -571,10 +651,32 @@ giống React. Trigger `filled` có nền `--base-secondary` — đặt trên ca
571
651
  `leaf:dropdown-change`. Có `input.leaf-dropdown__input` thì leaf.js ghi value vào đó. Panel nằm ngay
572
652
  dưới trigger (không portal) — tránh đặt trong khung `overflow: hidden / auto` thấp hơn panel.
573
653
 
574
- ### 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
662
+
663
+ `Leaf.file` — cùng API phần [Đọc & ghi file](#đọc--ghi-file-không-ui), không cần markup:
575
664
 
576
- Chỉ CSS. Skeleton: `--leaf-skeleton-width` / `height` / `radius`. Spinner: `data-animation` /
577
- `data-size` + SVG path; overlay = `.leaf-spinner-overlay` (app tự `hidden`/mount).
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).
578
680
 
579
681
  ### Cần biết
580
682
 
@@ -609,6 +711,81 @@ Chỉ CSS. Skeleton: `--leaf-skeleton-width` / `height` / `radius`. Spinner: `da
609
711
 
610
712
  ## Changelog
611
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
+
612
789
  ### 0.2.1
613
790
 
614
791
  **InputDate / Calendar — chọn theo tháng**
@@ -624,7 +801,7 @@ Chỉ CSS. Skeleton: `--leaf-skeleton-width` / `height` / `radius`. Spinner: `da
624
801
  - `calendar.css`: ô tháng (`.leaf-calendar__option`) có trạng thái `data-today` / `:disabled`;
625
802
  root `data-month-only="true"` cho ô cao 40px.
626
803
  - Docs (Input, Calendar) và Claude skill (`input-date.md`, `calendar.md`) cập nhật ví dụ / prop.
627
- - `monthOnly` chỉ có ở React — leaf.js không có Calendar / InputDate.
804
+ - `monthOnly` trên React và leaf.js (`data-month-only` trên `data-leaf-calendar` / `data-leaf-input-date`).
628
805
 
629
806
  **Sửa lỗi**
630
807
 
@@ -885,10 +1062,12 @@ Chỉ CSS. Skeleton: `--leaf-skeleton-width` / `height` / `radius`. Spinner: `da
885
1062
  Logo CSS data-URI theo `data-brand` / `data-mode` / `data-side`; docs `htmlSection` +
886
1063
  `examples/static.html` cover đủ component.
887
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”).
888
1067
  - Spinner: indicator 8 nan (loader-line), animation `spin` · `fade` · `pulse` · `breathe`; màu
889
1068
  mặc định trắng (dark) / đen (light) qua `--base-quinary`, overlay cũng vậy — không dùng highlight.
890
1069
  - Toggle: công tắc On/Off (Figma 730:12438) — size md/sm, checked, disabled.
891
- - 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).
892
1071
  - Tooltip: hover/focus (Figma 891:4983) — size/position/align + TooltipContent.
893
1072
  - Dialog / Logo: React component + CSS (Logo asset generate qua `embed-logo-assets.mjs`).
894
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
@@ -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 {
@@ -0,0 +1,144 @@
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/Carousel/carousel.css --- */
5
+
6
+ /*
7
+ * Carousel — cuộn ngang native, kéo khi free mode, snap khi free mode tắt.
8
+ * Nav dùng token semantic (--base-tertiary / --text-primary) để đổi đúng light/dark.
9
+ */
10
+
11
+ @layer components {
12
+ .leaf-carousel {
13
+ --leaf-carousel-space-between: 12px;
14
+ --leaf-carousel-slides-per-view: auto;
15
+
16
+ position: relative;
17
+ display: flex;
18
+ flex-direction: column;
19
+ width: 100%;
20
+ box-sizing: border-box;
21
+ }
22
+
23
+ .leaf-carousel__viewport {
24
+ overflow-x: auto;
25
+ overflow-y: hidden;
26
+ width: 100%;
27
+ -webkit-overflow-scrolling: touch;
28
+ scrollbar-width: none;
29
+ }
30
+
31
+ .leaf-carousel__viewport::-webkit-scrollbar {
32
+ display: none;
33
+ }
34
+
35
+ .leaf-carousel__viewport[data-free-mode="true"] {
36
+ touch-action: pan-y;
37
+ cursor: grab;
38
+ }
39
+
40
+ .leaf-carousel__viewport[data-free-mode="true"][data-dragging="true"] {
41
+ cursor: grabbing;
42
+ user-select: none;
43
+ -webkit-user-select: none;
44
+ }
45
+
46
+ .leaf-carousel__viewport[data-free-mode="false"] {
47
+ scroll-snap-type: x mandatory;
48
+ }
49
+
50
+ .leaf-carousel__track {
51
+ display: flex;
52
+ flex-direction: row;
53
+ align-items: stretch;
54
+ gap: var(--leaf-carousel-space-between);
55
+ width: max-content;
56
+ min-width: 100%;
57
+ box-sizing: border-box;
58
+ }
59
+
60
+ .leaf-carousel__slide {
61
+ flex: 0 0 auto;
62
+ box-sizing: border-box;
63
+ scroll-snap-align: start;
64
+ transform: scale(1);
65
+ opacity: 1;
66
+ transition:
67
+ transform 180ms ease,
68
+ opacity 180ms ease;
69
+ }
70
+
71
+ /* Kéo card: thu nhẹ + mờ nhẹ, thả tay transition về chỗ. */
72
+ .leaf-carousel__viewport[data-dragging="true"] .leaf-carousel__slide {
73
+ transform: scale(0.97);
74
+ opacity: 0.92;
75
+ }
76
+
77
+ .leaf-carousel[data-slides-per-view]:not([data-slides-per-view="auto"]) .leaf-carousel__slide {
78
+ flex: 0 0
79
+ calc(
80
+ (100% - (var(--leaf-carousel-slides-per-view) - 1) * var(--leaf-carousel-space-between)) /
81
+ var(--leaf-carousel-slides-per-view)
82
+ );
83
+ max-width: calc(
84
+ (100% - (var(--leaf-carousel-slides-per-view) - 1) * var(--leaf-carousel-space-between)) /
85
+ var(--leaf-carousel-slides-per-view)
86
+ );
87
+ }
88
+
89
+ .leaf-carousel__nav {
90
+ position: absolute;
91
+ top: 50%;
92
+ z-index: 1;
93
+ display: inline-flex;
94
+ align-items: center;
95
+ justify-content: center;
96
+ width: 28px;
97
+ height: 28px;
98
+ margin: 0;
99
+ padding: 0;
100
+ border: none;
101
+ border-radius: 999px;
102
+ /* Token semantic — đổi theo data-theme light/dark (không hard-code #fff). */
103
+ background-color: var(--base-tertiary);
104
+ color: var(--text-primary);
105
+ box-shadow: none;
106
+ transform: translateY(-50%);
107
+ cursor: pointer;
108
+ font: inherit;
109
+ appearance: none;
110
+ transition:
111
+ opacity 160ms ease,
112
+ background-color 160ms ease,
113
+ color 160ms ease;
114
+ }
115
+
116
+ .leaf-carousel__nav:focus-visible {
117
+ outline: 2px solid var(--text-highlight);
118
+ outline-offset: 2px;
119
+ }
120
+
121
+ .leaf-carousel__nav--prev {
122
+ left: 4px;
123
+ }
124
+
125
+ .leaf-carousel__nav--next {
126
+ right: 4px;
127
+ }
128
+
129
+ /* Icon nhỏ hơn ring (28px) — SVG RemixGlyph hoặc font <i class="ri-*">. */
130
+ .leaf-carousel__nav svg,
131
+ .leaf-carousel__nav i {
132
+ width: 14px;
133
+ height: 14px;
134
+ font-size: 14px;
135
+ line-height: 1;
136
+ display: block;
137
+ color: inherit;
138
+ }
139
+
140
+ .leaf-carousel__nav[data-nav-disabled="true"] {
141
+ opacity: 0;
142
+ pointer-events: none;
143
+ }
144
+ }