@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.
- package/README.md +196 -17
- package/dist/button.css +7 -0
- package/dist/calendar.css +2 -1
- package/dist/carousel.css +144 -0
- package/dist/cdn/leaf-0.2.2.min.css +2 -0
- package/dist/cdn/leaf-0.2.2.min.js +165 -0
- package/dist/classes.css +1684 -117
- package/dist/components/Button/Button.d.ts +2 -2
- package/dist/components/Button/Button.d.ts.map +1 -1
- package/dist/components/Button/Button.js +17 -15
- package/dist/components/Button/Button.js.map +1 -1
- package/dist/components/Calendar/Calendar.d.ts +2 -2
- package/dist/components/Calendar/Calendar.d.ts.map +1 -1
- package/dist/components/Calendar/Calendar.js +41 -23
- package/dist/components/Calendar/Calendar.js.map +1 -1
- package/dist/components/Carousel/Carousel.d.ts +35 -0
- package/dist/components/Carousel/Carousel.d.ts.map +1 -0
- package/dist/components/Carousel/Carousel.js +191 -0
- package/dist/components/Carousel/Carousel.js.map +1 -0
- package/dist/components/Carousel/index.d.ts +2 -0
- package/dist/components/Carousel/index.d.ts.map +1 -0
- package/dist/components/Carousel/index.js +2 -0
- package/dist/components/Carousel/index.js.map +1 -0
- package/dist/components/Checkbox/Checkbox.d.ts +2 -2
- package/dist/components/Checkbox/Checkbox.d.ts.map +1 -1
- package/dist/components/Checkbox/Checkbox.js +6 -3
- package/dist/components/Checkbox/Checkbox.js.map +1 -1
- package/dist/components/Date/Date.d.ts +26 -0
- package/dist/components/Date/Date.d.ts.map +1 -0
- package/dist/components/Date/Date.js +26 -0
- package/dist/components/Date/Date.js.map +1 -0
- package/dist/components/Date/index.d.ts +2 -0
- package/dist/components/Date/index.d.ts.map +1 -0
- package/dist/components/Date/index.js +2 -0
- package/dist/components/Date/index.js.map +1 -0
- package/dist/components/Dialog/Dialog.d.ts +1 -2
- package/dist/components/Dialog/Dialog.d.ts.map +1 -1
- package/dist/components/Dialog/Dialog.js +2 -3
- package/dist/components/Dialog/Dialog.js.map +1 -1
- package/dist/components/Dropdown/Dropdown.d.ts +24 -10
- package/dist/components/Dropdown/Dropdown.d.ts.map +1 -1
- package/dist/components/Dropdown/Dropdown.js +244 -37
- package/dist/components/Dropdown/Dropdown.js.map +1 -1
- package/dist/components/Empty/Empty.d.ts +27 -0
- package/dist/components/Empty/Empty.d.ts.map +1 -0
- package/dist/components/Empty/Empty.js +22 -0
- package/dist/components/Empty/Empty.js.map +1 -0
- package/dist/components/Empty/index.d.ts +2 -0
- package/dist/components/Empty/index.d.ts.map +1 -0
- package/dist/components/Empty/index.js +2 -0
- package/dist/components/Empty/index.js.map +1 -0
- package/dist/components/FileViewer/FileViewer.d.ts +63 -0
- package/dist/components/FileViewer/FileViewer.d.ts.map +1 -0
- package/dist/components/FileViewer/FileViewer.js +73 -0
- package/dist/components/FileViewer/FileViewer.js.map +1 -0
- package/dist/components/FileViewer/FileViewerDialog.d.ts +27 -0
- package/dist/components/FileViewer/FileViewerDialog.d.ts.map +1 -0
- package/dist/components/FileViewer/FileViewerDialog.js +13 -0
- package/dist/components/FileViewer/FileViewerDialog.js.map +1 -0
- package/dist/components/FileViewer/index.d.ts +4 -0
- package/dist/components/FileViewer/index.d.ts.map +1 -0
- package/dist/components/FileViewer/index.js +4 -0
- package/dist/components/FileViewer/index.js.map +1 -0
- package/dist/components/Form/DynamicForm.d.ts +52 -0
- package/dist/components/Form/DynamicForm.d.ts.map +1 -0
- package/dist/components/Form/DynamicForm.js +135 -0
- package/dist/components/Form/DynamicForm.js.map +1 -0
- package/dist/components/Form/Form.d.ts +54 -0
- package/dist/components/Form/Form.d.ts.map +1 -0
- package/dist/components/Form/Form.js +127 -0
- package/dist/components/Form/Form.js.map +1 -0
- package/dist/components/Form/adapters.d.ts +66 -0
- package/dist/components/Form/adapters.d.ts.map +1 -0
- package/dist/components/Form/adapters.js +113 -0
- package/dist/components/Form/adapters.js.map +1 -0
- package/dist/components/Form/index.d.ts +24 -0
- package/dist/components/Form/index.d.ts.map +1 -0
- package/dist/components/Form/index.js +23 -0
- package/dist/components/Form/index.js.map +1 -0
- package/dist/components/Form/useForm.d.ts +25 -0
- package/dist/components/Form/useForm.d.ts.map +1 -0
- package/dist/components/Form/useForm.js +46 -0
- package/dist/components/Form/useForm.js.map +1 -0
- package/dist/components/Input/Input.d.ts +1 -2
- package/dist/components/Input/Input.d.ts.map +1 -1
- package/dist/components/Input/Input.js +3 -4
- package/dist/components/Input/Input.js.map +1 -1
- package/dist/components/Input/InputDate.d.ts +3 -4
- package/dist/components/Input/InputDate.d.ts.map +1 -1
- package/dist/components/Input/InputDate.js +13 -6
- package/dist/components/Input/InputDate.js.map +1 -1
- package/dist/components/Input/InputOtp.d.ts +2 -2
- package/dist/components/Input/InputOtp.d.ts.map +1 -1
- package/dist/components/Input/InputOtp.js +2 -3
- package/dist/components/Input/InputOtp.js.map +1 -1
- package/dist/components/Input/InputStepper.d.ts +3 -4
- package/dist/components/Input/InputStepper.d.ts.map +1 -1
- package/dist/components/Input/InputStepper.js +4 -5
- package/dist/components/Input/InputStepper.js.map +1 -1
- package/dist/components/Logo/Logo.d.ts +2 -2
- package/dist/components/Logo/Logo.d.ts.map +1 -1
- package/dist/components/Logo/Logo.js +3 -4
- package/dist/components/Logo/Logo.js.map +1 -1
- package/dist/components/MultiSelect/MultiSelect.d.ts +49 -0
- package/dist/components/MultiSelect/MultiSelect.d.ts.map +1 -0
- package/dist/components/MultiSelect/MultiSelect.js +285 -0
- package/dist/components/MultiSelect/MultiSelect.js.map +1 -0
- package/dist/components/MultiSelect/index.d.ts +2 -0
- package/dist/components/MultiSelect/index.d.ts.map +1 -0
- package/dist/components/MultiSelect/index.js +2 -0
- package/dist/components/MultiSelect/index.js.map +1 -0
- package/dist/components/Number/Number.d.ts +32 -0
- package/dist/components/Number/Number.d.ts.map +1 -0
- package/dist/components/Number/Number.js +43 -0
- package/dist/components/Number/Number.js.map +1 -0
- package/dist/components/Number/index.d.ts +2 -0
- package/dist/components/Number/index.d.ts.map +1 -0
- package/dist/components/Number/index.js +2 -0
- package/dist/components/Number/index.js.map +1 -0
- package/dist/components/QrCode/QrCode.d.ts +27 -0
- package/dist/components/QrCode/QrCode.d.ts.map +1 -0
- package/dist/components/QrCode/QrCode.js +44 -0
- package/dist/components/QrCode/QrCode.js.map +1 -0
- package/dist/components/QrCode/index.d.ts +3 -0
- package/dist/components/QrCode/index.d.ts.map +1 -0
- package/dist/components/QrCode/index.js +3 -0
- package/dist/components/QrCode/index.js.map +1 -0
- package/dist/components/Radio/Radio.d.ts +4 -4
- package/dist/components/Radio/Radio.d.ts.map +1 -1
- package/dist/components/Radio/Radio.js +4 -5
- package/dist/components/Radio/Radio.js.map +1 -1
- package/dist/components/Skeleton/Skeleton.d.ts +2 -2
- package/dist/components/Skeleton/Skeleton.d.ts.map +1 -1
- package/dist/components/Skeleton/Skeleton.js +2 -3
- package/dist/components/Skeleton/Skeleton.js.map +1 -1
- package/dist/components/Slider/Slider.d.ts +8 -6
- package/dist/components/Slider/Slider.d.ts.map +1 -1
- package/dist/components/Slider/Slider.js +12 -8
- package/dist/components/Slider/Slider.js.map +1 -1
- package/dist/components/Spinner/Spinner.d.ts +5 -2
- package/dist/components/Spinner/Spinner.d.ts.map +1 -1
- package/dist/components/Spinner/Spinner.js +5 -4
- package/dist/components/Spinner/Spinner.js.map +1 -1
- package/dist/components/Tabs/Tabs.d.ts +2 -3
- package/dist/components/Tabs/Tabs.d.ts.map +1 -1
- package/dist/components/Tabs/Tabs.js +4 -5
- package/dist/components/Tabs/Tabs.js.map +1 -1
- package/dist/components/Textarea/Textarea.d.ts +18 -0
- package/dist/components/Textarea/Textarea.d.ts.map +1 -0
- package/dist/components/Textarea/Textarea.js +41 -0
- package/dist/components/Textarea/Textarea.js.map +1 -0
- package/dist/components/Textarea/index.d.ts +2 -0
- package/dist/components/Textarea/index.d.ts.map +1 -0
- package/dist/components/Textarea/index.js +2 -0
- package/dist/components/Textarea/index.js.map +1 -0
- package/dist/components/Toast/Toast.d.ts +4 -3
- package/dist/components/Toast/Toast.d.ts.map +1 -1
- package/dist/components/Toast/Toast.js +7 -6
- package/dist/components/Toast/Toast.js.map +1 -1
- package/dist/components/Toggle/Toggle.d.ts +3 -3
- package/dist/components/Toggle/Toggle.d.ts.map +1 -1
- package/dist/components/Toggle/Toggle.js +5 -3
- package/dist/components/Toggle/Toggle.js.map +1 -1
- package/dist/components/Tooltip/Tooltip.d.ts +4 -5
- package/dist/components/Tooltip/Tooltip.d.ts.map +1 -1
- package/dist/components/Tooltip/Tooltip.js +10 -8
- package/dist/components/Tooltip/Tooltip.js.map +1 -1
- package/dist/components/Upload/Upload.d.ts +89 -0
- package/dist/components/Upload/Upload.d.ts.map +1 -0
- package/dist/components/Upload/Upload.js +196 -0
- package/dist/components/Upload/Upload.js.map +1 -0
- package/dist/components/Upload/index.d.ts +2 -0
- package/dist/components/Upload/index.d.ts.map +1 -0
- package/dist/components/Upload/index.js +2 -0
- package/dist/components/Upload/index.js.map +1 -0
- package/dist/core/calendar.d.ts +5 -0
- package/dist/core/calendar.d.ts.map +1 -1
- package/dist/core/calendar.js +11 -0
- package/dist/core/calendar.js.map +1 -1
- package/dist/core/carousel.d.ts +42 -0
- package/dist/core/carousel.d.ts.map +1 -0
- package/dist/core/carousel.js +125 -0
- package/dist/core/carousel.js.map +1 -0
- package/dist/core/date.d.ts +46 -0
- package/dist/core/date.d.ts.map +1 -0
- package/dist/core/date.js +117 -0
- package/dist/core/date.js.map +1 -0
- package/dist/core/dialog.d.ts.map +1 -1
- package/dist/core/dialog.js +28 -2
- package/dist/core/dialog.js.map +1 -1
- package/dist/core/dropdown.d.ts +15 -2
- package/dist/core/dropdown.d.ts.map +1 -1
- package/dist/core/dropdown.js +29 -4
- package/dist/core/dropdown.js.map +1 -1
- package/dist/core/file/csv.d.ts +42 -0
- package/dist/core/file/csv.d.ts.map +1 -0
- package/dist/core/file/csv.js +159 -0
- package/dist/core/file/csv.js.map +1 -0
- package/dist/core/file/detect.d.ts +38 -0
- package/dist/core/file/detect.d.ts.map +1 -0
- package/dist/core/file/detect.js +218 -0
- package/dist/core/file/detect.js.map +1 -0
- package/dist/core/file/docx-render.d.ts +14 -0
- package/dist/core/file/docx-render.d.ts.map +1 -0
- package/dist/core/file/docx-render.js +173 -0
- package/dist/core/file/docx-render.js.map +1 -0
- package/dist/core/file/docx.d.ts +110 -0
- package/dist/core/file/docx.d.ts.map +1 -0
- package/dist/core/file/docx.js +632 -0
- package/dist/core/file/docx.js.map +1 -0
- package/dist/core/file/dom.d.ts +18 -0
- package/dist/core/file/dom.d.ts.map +1 -0
- package/dist/core/file/dom.js +57 -0
- package/dist/core/file/dom.js.map +1 -0
- package/dist/core/file/download.d.ts +26 -0
- package/dist/core/file/download.d.ts.map +1 -0
- package/dist/core/file/download.js +57 -0
- package/dist/core/file/download.js.map +1 -0
- package/dist/core/file/error.d.ts +34 -0
- package/dist/core/file/error.d.ts.map +1 -0
- package/dist/core/file/error.js +19 -0
- package/dist/core/file/error.js.map +1 -0
- package/dist/core/file/mime.d.ts +11 -0
- package/dist/core/file/mime.d.ts.map +1 -0
- package/dist/core/file/mime.js +61 -0
- package/dist/core/file/mime.js.map +1 -0
- package/dist/core/file/render.d.ts +45 -0
- package/dist/core/file/render.d.ts.map +1 -0
- package/dist/core/file/render.js +133 -0
- package/dist/core/file/render.js.map +1 -0
- package/dist/core/file/sheet-render.d.ts +30 -0
- package/dist/core/file/sheet-render.d.ts.map +1 -0
- package/dist/core/file/sheet-render.js +152 -0
- package/dist/core/file/sheet-render.js.map +1 -0
- package/dist/core/file/source.d.ts +56 -0
- package/dist/core/file/source.d.ts.map +1 -0
- package/dist/core/file/source.js +188 -0
- package/dist/core/file/source.js.map +1 -0
- package/dist/core/file/text.d.ts +9 -0
- package/dist/core/file/text.d.ts.map +1 -0
- package/dist/core/file/text.js +21 -0
- package/dist/core/file/text.js.map +1 -0
- package/dist/core/file/viewer.d.ts +160 -0
- package/dist/core/file/viewer.d.ts.map +1 -0
- package/dist/core/file/viewer.js +623 -0
- package/dist/core/file/viewer.js.map +1 -0
- package/dist/core/file/xlsx-format.d.ts +55 -0
- package/dist/core/file/xlsx-format.d.ts.map +1 -0
- package/dist/core/file/xlsx-format.js +476 -0
- package/dist/core/file/xlsx-format.js.map +1 -0
- package/dist/core/file/xlsx-write.d.ts +48 -0
- package/dist/core/file/xlsx-write.d.ts.map +1 -0
- package/dist/core/file/xlsx-write.js +219 -0
- package/dist/core/file/xlsx-write.js.map +1 -0
- package/dist/core/file/xlsx.d.ts +115 -0
- package/dist/core/file/xlsx.d.ts.map +1 -0
- package/dist/core/file/xlsx.js +402 -0
- package/dist/core/file/xlsx.js.map +1 -0
- package/dist/core/file/xml.d.ts +34 -0
- package/dist/core/file/xml.d.ts.map +1 -0
- package/dist/core/file/xml.js +102 -0
- package/dist/core/file/xml.js.map +1 -0
- package/dist/core/file/zip-write.d.ts +24 -0
- package/dist/core/file/zip-write.d.ts.map +1 -0
- package/dist/core/file/zip-write.js +131 -0
- package/dist/core/file/zip-write.js.map +1 -0
- package/dist/core/file/zip.d.ts +37 -0
- package/dist/core/file/zip.d.ts.map +1 -0
- package/dist/core/file/zip.js +195 -0
- package/dist/core/file/zip.js.map +1 -0
- package/dist/core/form.d.ts +88 -0
- package/dist/core/form.d.ts.map +1 -0
- package/dist/core/form.js +353 -0
- package/dist/core/form.js.map +1 -0
- package/dist/core/icons.d.ts +14 -0
- package/dist/core/icons.d.ts.map +1 -1
- package/dist/core/icons.js +14 -0
- package/dist/core/icons.js.map +1 -1
- package/dist/core/number.d.ts +45 -0
- package/dist/core/number.d.ts.map +1 -0
- package/dist/core/number.js +74 -0
- package/dist/core/number.js.map +1 -0
- package/dist/core/qr-code.d.ts +18 -0
- package/dist/core/qr-code.d.ts.map +1 -0
- package/dist/core/qr-code.js +702 -0
- package/dist/core/qr-code.js.map +1 -0
- package/dist/core/stepper.d.ts +6 -2
- package/dist/core/stepper.d.ts.map +1 -1
- package/dist/core/stepper.js +12 -9
- package/dist/core/stepper.js.map +1 -1
- package/dist/core/upload.d.ts +51 -0
- package/dist/core/upload.d.ts.map +1 -0
- package/dist/core/upload.js +114 -0
- package/dist/core/upload.js.map +1 -0
- package/dist/date.css +19 -0
- package/dist/dropdown.css +117 -0
- package/dist/empty.css +74 -0
- package/dist/file-viewer.css +502 -0
- package/dist/focus.css +18 -0
- package/dist/form.css +64 -0
- package/dist/index.d.ts +24 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +26 -0
- package/dist/index.js.map +1 -1
- package/dist/multiselect.css +147 -0
- package/dist/number.css +53 -0
- package/dist/qr-code.css +21 -0
- package/dist/skeleton.css +8 -0
- package/dist/skill/leaf-design-system-0.2.2.zip +0 -0
- package/dist/slider.css +55 -1
- package/dist/spinner.css +9 -1
- package/dist/styles.css +1684 -117
- package/dist/tabs.css +7 -0
- package/dist/textarea.css +28 -0
- package/dist/upload.css +317 -0
- package/dist/utils/colorClass.d.ts +22 -0
- package/dist/utils/colorClass.d.ts.map +1 -0
- package/dist/utils/colorClass.js +93 -0
- package/dist/utils/colorClass.js.map +1 -0
- package/package.json +12 -1
- package/dist/cdn/leaf-0.2.1.min.css +0 -2
- package/dist/cdn/leaf-0.2.1.min.js +0 -9
- 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
|
-
<
|
|
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
|
-
-
|
|
135
|
-
|
|
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
|
|
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.
|
|
412
|
-
<script src="https://<cdn>/leaf-0.2.
|
|
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
|
-
[**
|
|
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
|
-
###
|
|
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
|
-
|
|
577
|
-
|
|
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`
|
|
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,
|
|
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
|
|
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
|
+
}
|