vlite3 0.4.10 → 0.5.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 (264) hide show
  1. package/README.md +201 -100
  2. package/_virtual/Barcode.js +4 -0
  3. package/_virtual/CODE128.js +4 -0
  4. package/_virtual/CODE128A.js +4 -0
  5. package/_virtual/CODE128B.js +4 -0
  6. package/_virtual/CODE128C.js +4 -0
  7. package/_virtual/CODE128_AUTO.js +4 -0
  8. package/_virtual/CODE93.js +4 -0
  9. package/_virtual/CODE93FullASCII.js +4 -0
  10. package/_virtual/EAN.js +4 -0
  11. package/_virtual/EAN13.js +4 -0
  12. package/_virtual/EAN2.js +4 -0
  13. package/_virtual/EAN5.js +4 -0
  14. package/_virtual/EAN8.js +4 -0
  15. package/_virtual/ErrorHandler.js +4 -0
  16. package/_virtual/FileSaver.min.js +5 -0
  17. package/_virtual/FileSaver.min2.js +4 -0
  18. package/_virtual/ITF.js +4 -0
  19. package/_virtual/ITF14.js +4 -0
  20. package/_virtual/JsBarcode.js +7 -0
  21. package/_virtual/MSI.js +4 -0
  22. package/_virtual/MSI10.js +4 -0
  23. package/_virtual/MSI1010.js +4 -0
  24. package/_virtual/MSI11.js +4 -0
  25. package/_virtual/MSI1110.js +4 -0
  26. package/_virtual/UPC.js +4 -0
  27. package/_virtual/UPCE.js +4 -0
  28. package/_virtual/_commonjsHelpers.js +8 -0
  29. package/_virtual/alignment-pattern.js +4 -0
  30. package/_virtual/auto.js +4 -0
  31. package/_virtual/browser.js +7 -0
  32. package/_virtual/browser2.js +4 -0
  33. package/_virtual/canvas.js +4 -0
  34. package/_virtual/canvas2.js +4 -0
  35. package/_virtual/checksums.js +4 -0
  36. package/_virtual/constants.js +4 -0
  37. package/_virtual/constants2.js +4 -0
  38. package/_virtual/constants3.js +4 -0
  39. package/_virtual/constants4.js +4 -0
  40. package/_virtual/defaults.js +4 -0
  41. package/_virtual/dijkstra.js +4 -0
  42. package/_virtual/encoder.js +4 -0
  43. package/_virtual/error-correction-code.js +4 -0
  44. package/_virtual/error-correction-level.js +4 -0
  45. package/_virtual/exceptions.js +4 -0
  46. package/_virtual/finder-pattern.js +4 -0
  47. package/_virtual/fixOptions.js +4 -0
  48. package/_virtual/format-info.js +4 -0
  49. package/_virtual/galois-field.js +4 -0
  50. package/_virtual/getOptionsFromElement.js +4 -0
  51. package/_virtual/getRenderProperties.js +4 -0
  52. package/_virtual/index.js +4 -0
  53. package/_virtual/index10.js +4 -0
  54. package/_virtual/index11.js +4 -0
  55. package/_virtual/index2.js +4 -0
  56. package/_virtual/index3.js +4 -0
  57. package/_virtual/index4.js +4 -0
  58. package/_virtual/index5.js +4 -0
  59. package/_virtual/index6.js +4 -0
  60. package/_virtual/index7.js +4 -0
  61. package/_virtual/index8.js +4 -0
  62. package/_virtual/index9.js +4 -0
  63. package/_virtual/linearizeEncodings.js +4 -0
  64. package/_virtual/mask-pattern.js +4 -0
  65. package/_virtual/merge.js +4 -0
  66. package/_virtual/mode.js +4 -0
  67. package/_virtual/object.js +4 -0
  68. package/_virtual/optionsFromStrings.js +4 -0
  69. package/_virtual/papaparse.min.js +7 -0
  70. package/_virtual/papaparse.min2.js +4 -0
  71. package/_virtual/polynomial.js +4 -0
  72. package/_virtual/qrcode.js +4 -0
  73. package/_virtual/regex.js +4 -0
  74. package/_virtual/segments.js +4 -0
  75. package/_virtual/shared.js +4 -0
  76. package/_virtual/svg-tag.js +4 -0
  77. package/_virtual/svg.js +4 -0
  78. package/_virtual/utils.js +4 -0
  79. package/_virtual/utils2.js +4 -0
  80. package/_virtual/version-check.js +4 -0
  81. package/_virtual/version.js +4 -0
  82. package/components/Accordion/Accordion.vue.d.ts +7 -7
  83. package/components/Accordion/AccordionItem.vue.d.ts +4 -4
  84. package/components/Accordion/AccordionTrigger.vue.d.ts +2 -2
  85. package/components/Alert.vue.d.ts +1 -1
  86. package/components/Avatar.vue.d.ts +2 -2
  87. package/components/Avatar.vue.js +2 -2
  88. package/components/AvatarUploader/AvatarUploader.vue.d.ts +5 -5
  89. package/components/Badge.vue.d.ts +1 -1
  90. package/components/Barcode/Barcode.vue.d.ts +22 -0
  91. package/components/Barcode/Barcode.vue.js +58 -0
  92. package/components/Barcode/Barcode.vue2.js +4 -0
  93. package/components/Barcode/index.d.ts +2 -0
  94. package/components/Barcode/types.d.ts +5 -0
  95. package/components/Barcode/types.js +15 -0
  96. package/components/Breadcrumb/Breadcrumb.vue.d.ts +23 -0
  97. package/components/Breadcrumb/Breadcrumb.vue.js +7 -0
  98. package/components/Breadcrumb/Breadcrumb.vue2.js +84 -0
  99. package/components/Breadcrumb/BreadcrumbItem.vue.d.ts +27 -0
  100. package/components/Breadcrumb/BreadcrumbItem.vue.js +7 -0
  101. package/components/Breadcrumb/BreadcrumbItem.vue2.js +50 -0
  102. package/components/Breadcrumb/index.d.ts +3 -0
  103. package/components/Breadcrumb/types.d.ts +19 -0
  104. package/components/Button.vue.d.ts +4 -4
  105. package/components/Button.vue.js +32 -29
  106. package/components/ButtonGroup.vue.d.ts +1 -1
  107. package/components/Carousel/Carousel.vue.d.ts +58 -58
  108. package/components/CheckBox.vue.d.ts +2 -2
  109. package/components/Chip/Chip.vue.d.ts +3 -3
  110. package/components/ChoiceBox/ChoiceBox.vue.d.ts +4 -4
  111. package/components/ColorPicker/ColorIro.vue3.js +2 -2
  112. package/components/ColorPicker/ColorPicker.vue.d.ts +3 -3
  113. package/components/ColorPicker/ColorPicker.vue.js +2 -2
  114. package/components/ColorPicker/index.d.ts +1 -0
  115. package/components/CommandPaletteContent.vue.d.ts +15 -0
  116. package/components/CommandPaletteContent.vue.js +7 -0
  117. package/components/CommandPaletteContent.vue2.js +287 -0
  118. package/components/ConfirmationModal.vue.js +12 -10
  119. package/components/DataList/DataList.vue.d.ts +2 -2
  120. package/components/DataTable/DataTable.vue.d.ts +6 -6
  121. package/components/DataTable/DataTableRow.vue.d.ts +3 -3
  122. package/components/DatePicker.vue.d.ts +2 -2
  123. package/components/DatePicker.vue.js +7 -7
  124. package/components/DateRangePicker.vue.d.ts +29 -0
  125. package/components/DateRangePicker.vue.js +231 -0
  126. package/components/DateRangePicker.vue2.js +4 -0
  127. package/components/Dropdown/Dropdown.vue.d.ts +10 -6
  128. package/components/Dropdown/Dropdown.vue.js +146 -109
  129. package/components/Dropdown/DropdownGroupedLayout.vue.d.ts +1 -1
  130. package/components/Dropdown/DropdownMenu.vue.d.ts +5 -3
  131. package/components/Dropdown/DropdownMenu.vue.js +112 -109
  132. package/components/ExportData/ExportData.vue.d.ts +16 -0
  133. package/components/ExportData/ExportData.vue.js +135 -0
  134. package/components/ExportData/ExportData.vue2.js +4 -0
  135. package/components/ExportData/index.d.ts +2 -0
  136. package/components/ExportData/types.d.ts +17 -0
  137. package/components/FilePicker/FilePicker.vue.d.ts +5 -5
  138. package/components/Form/CustomFields.vue.d.ts +6 -6
  139. package/components/Form/CustomFields.vue.js +1 -1
  140. package/components/Form/Form.vue.d.ts +4 -5
  141. package/components/Form/Form.vue.js +2 -2
  142. package/components/Form/Form.vue2.js +221 -178
  143. package/components/Form/FormField.vue.d.ts +4 -3
  144. package/components/Form/FormField.vue.js +70 -62
  145. package/components/Form/FormFields.vue.d.ts +3 -1
  146. package/components/Form/FormFields.vue.js +2 -2
  147. package/components/Form/FormFields.vue2.js +105 -59
  148. package/components/GoogleLogin.vue.d.ts +2 -2
  149. package/components/ImportData/ImportData.vue.d.ts +31 -0
  150. package/components/ImportData/ImportData.vue.js +242 -0
  151. package/components/ImportData/ImportData.vue2.js +4 -0
  152. package/components/ImportData/ImportStep1.vue.d.ts +23 -0
  153. package/components/ImportData/ImportStep1.vue.js +162 -0
  154. package/components/ImportData/ImportStep1.vue2.js +4 -0
  155. package/components/ImportData/ImportStep2.vue.d.ts +20 -0
  156. package/components/ImportData/ImportStep2.vue.js +98 -0
  157. package/components/ImportData/ImportStep2.vue2.js +4 -0
  158. package/components/ImportData/ImportStep3.vue.d.ts +6 -0
  159. package/components/ImportData/ImportStep3.vue.js +98 -0
  160. package/components/ImportData/ImportStep3.vue2.js +4 -0
  161. package/components/ImportData/ImportStep4.vue.d.ts +6 -0
  162. package/components/ImportData/ImportStep4.vue.js +139 -0
  163. package/components/ImportData/ImportStep4.vue2.js +4 -0
  164. package/components/ImportData/index.d.ts +2 -0
  165. package/components/ImportData/types.d.ts +51 -0
  166. package/components/Input.vue.d.ts +9 -9
  167. package/components/Input.vue.js +137 -120
  168. package/components/List/List.vue.d.ts +18 -0
  169. package/components/List/List.vue.js +189 -0
  170. package/components/List/List.vue2.js +4 -0
  171. package/components/List/ListFieldRow.vue.d.ts +35 -0
  172. package/components/List/ListFieldRow.vue.js +119 -0
  173. package/components/List/ListFieldRow.vue2.js +4 -0
  174. package/components/List/index.d.ts +4 -0
  175. package/components/List/types.d.ts +1 -0
  176. package/components/List/utils.d.ts +9 -0
  177. package/components/List/utils.js +64 -0
  178. package/components/Masonry/Masonry.vue.d.ts +2 -2
  179. package/components/Modal.vue.js +5 -122
  180. package/components/Modal.vue2.js +133 -2
  181. package/components/MultiSelect/MultiSelect.vue.d.ts +12 -9
  182. package/components/MultiSelect/MultiSelect.vue.js +101 -64
  183. package/components/Navbar/Navbar.vue.d.ts +14 -6
  184. package/components/Navbar/Navbar.vue.js +425 -356
  185. package/components/Navbar/NavbarItem.vue.d.ts +2 -2
  186. package/components/Navbar/NavbarTabs.vue.d.ts +21 -0
  187. package/components/Navbar/NavbarTabs.vue.js +179 -0
  188. package/components/Navbar/NavbarTabs.vue3.js +5 -0
  189. package/components/Navbar/index.d.ts +3 -0
  190. package/components/NavbarCommandPalette.vue.d.ts +48 -0
  191. package/components/NumberInput.vue.d.ts +8 -8
  192. package/components/OTPInput/OTPInput.vue.d.ts +7 -7
  193. package/components/Pagination/Pagination.vue.d.ts +1 -1
  194. package/components/PermissionMatrix/PermissionEditor.vue.d.ts +36 -0
  195. package/components/PermissionMatrix/PermissionEditor.vue.js +323 -0
  196. package/components/PermissionMatrix/PermissionEditor.vue2.js +4 -0
  197. package/components/PermissionMatrix/PermissionMatrix.vue.d.ts +15 -0
  198. package/components/PermissionMatrix/PermissionMatrix.vue.js +7 -0
  199. package/components/PermissionMatrix/PermissionMatrix.vue2.js +245 -0
  200. package/components/PermissionMatrix/index.d.ts +3 -0
  201. package/components/PermissionMatrix/types.d.ts +59 -0
  202. package/components/PricingPlan/PricingPlan.vue.d.ts +3 -3
  203. package/components/ProgressBar/ProgressBar.vue.d.ts +3 -3
  204. package/components/QRCode/QRCode.vue.d.ts +15 -0
  205. package/components/QRCode/QRCode.vue.js +38 -0
  206. package/components/QRCode/QRCode.vue2.js +4 -0
  207. package/components/QRCode/index.d.ts +1 -0
  208. package/components/Screen/Screen.vue.d.ts +232 -5
  209. package/components/Screen/Screen.vue.js +423 -271
  210. package/components/Screen/ScreenFilter.vue.d.ts +2 -2
  211. package/components/Screen/ScreenFilter.vue.js +10 -10
  212. package/components/Screen/types.d.ts +12 -0
  213. package/components/SidePanel.vue.d.ts +2 -2
  214. package/components/SidebarMenu/SidebarMenu.vue.d.ts +6 -2
  215. package/components/SidebarMenu/SidebarMenu.vue.js +104 -50
  216. package/components/SidebarMenu/SidebarMenuItem.vue.d.ts +2 -0
  217. package/components/SidebarMenu/SidebarMenuItem.vue.js +187 -174
  218. package/components/SidebarMenu/types.d.ts +8 -0
  219. package/components/Slider.vue.d.ts +2 -2
  220. package/components/Spinner/Spinner.vue.d.ts +2 -2
  221. package/components/Stats/Stats.vue.d.ts +14 -0
  222. package/components/Stats/Stats.vue.js +307 -0
  223. package/components/Stats/Stats.vue2.js +4 -0
  224. package/components/Stats/index.d.ts +2 -0
  225. package/components/Stats/types.d.ts +32 -0
  226. package/components/Switch.vue.d.ts +2 -1
  227. package/components/Switch.vue.js +4 -2
  228. package/components/Tabes/Tabes.vue.d.ts +3 -3
  229. package/components/Tabes/Tabes.vue.js +60 -57
  230. package/components/Tabes/types.d.ts +5 -0
  231. package/components/Textarea.vue.d.ts +3 -3
  232. package/components/{Timeline.vue.d.ts → Timeline/Timeline.vue.d.ts} +23 -2
  233. package/components/Timeline/Timeline.vue.js +92 -0
  234. package/components/Timeline/TimelineIndicator.vue.d.ts +9 -0
  235. package/components/Timeline/TimelineIndicator.vue.js +68 -0
  236. package/components/Timeline/TimelineIndicator.vue2.js +4 -0
  237. package/components/Timeline/TimelineItem.vue.d.ts +56 -0
  238. package/components/Timeline/TimelineItem.vue.js +173 -0
  239. package/components/Timeline/TimelineItem.vue2.js +4 -0
  240. package/components/Timeline/index.d.ts +3 -0
  241. package/components/Tooltip.vue.d.ts +2 -2
  242. package/components/Workbook/Sheet.vue.d.ts +2 -2
  243. package/components/Workbook/Workbook.vue.d.ts +3 -3
  244. package/components/index.d.ts +62 -0
  245. package/composables/useBreadcrumb.d.ts +17 -0
  246. package/composables/useBreadcrumb.js +27 -0
  247. package/core/config.d.ts +34 -0
  248. package/core/config.js +10 -7
  249. package/core/index.js +15 -8
  250. package/index.d.ts +55 -44
  251. package/index.js +243 -200
  252. package/package.json +12 -2
  253. package/router.d.ts +2 -0
  254. package/style.css +7 -5
  255. package/types/button.d.ts +1 -1
  256. package/types/config.type.d.ts +35 -0
  257. package/types/form.type.d.ts +3 -1
  258. package/types/index.d.ts +2 -1
  259. package/types/list.type.d.ts +57 -0
  260. package/types/navbar.type.d.ts +38 -1
  261. package/types/timeline.type.d.ts +14 -4
  262. package/components/Timeline.vue.js +0 -160
  263. /package/components/ColorPicker/{ColorIro.vue2.js → ColorIro.vue.js} +0 -0
  264. /package/components/{Timeline.vue2.js → Timeline/Timeline.vue2.js} +0 -0
package/README.md CHANGED
@@ -6,10 +6,12 @@ A lightweight Vue 3 UI component library built with Tailwind CSS, created for pe
6
6
 
7
7
  ```bash
8
8
  npm install vlite3
9
+
9
10
  ```
10
11
 
11
12
  ```bash
12
13
  yarn add vlite3
14
+
13
15
  ```
14
16
 
15
17
  ## 2. Tailwind CSS Setup (Tailwind v4)
@@ -22,6 +24,7 @@ import tailwindcss from '@tailwindcss/vite'
22
24
  export default defineConfig({
23
25
  plugins: [vue(), tailwindcss()],
24
26
  })
27
+
25
28
  ```
26
29
 
27
30
  `style.css`
@@ -32,6 +35,7 @@ export default defineConfig({
32
35
 
33
36
  @import 'vlite3/style.css';
34
37
  @source "../node_modules/vlite3";
38
+
35
39
  ```
36
40
 
37
41
  ## 3. Usage
@@ -49,15 +53,16 @@ import { Button, Input } from 'vlite3'
49
53
  <Input placeholder="Type here..." />
50
54
  </div>
51
55
  </template>
56
+
52
57
  ```
53
58
 
54
59
  ## Global Configuration (Registry System)
55
60
 
56
- vlite3 features a plugin-based architecture that allows you to register global services. This is particularly useful for dependency injection, such as defining how file uploads should be handled across all `Form` components in your app.
61
+ vlite3 features a plugin-based architecture that allows you to register global services and set global component configurations. This ensures consistency and prevents repetition across your application.
57
62
 
58
63
  ### Setting up the Plugin
59
64
 
60
- In your `main.ts` or `main.js`, import `createVLite` and `vScrollReveal` and register your services:
65
+ In your `main.ts` or `main.js`, import `createVLite` and `vScrollReveal` and register your services and component configurations:
61
66
 
62
67
  ```typescript
63
68
  import { createApp } from 'vue'
@@ -75,6 +80,7 @@ app.use(GoogleSignInPlugin, {
75
80
 
76
81
  // Initialize VLite with custom configuration
77
82
  const vlite = createVLite({
83
+ // Global Service Registry
78
84
  services: {
79
85
  /**
80
86
  * Global File Upload Handler
@@ -111,29 +117,49 @@ const vlite = createVLite({
111
117
  return data.url // MUST return the file URL string
112
118
  },
113
119
  },
120
+
121
+ // Global UI Components Configuration
122
+ components: {
123
+ form: {
124
+ variant: 'outline', // Applies 'outline' globally to all Form inputs ('solid' | 'outline' | 'floating' | etc.)
125
+ size: 'md', // Global size for form inputs ('sm' | 'md' | 'lg')
126
+ rounded: 'md', // Global border radius for forms
127
+ showRequiredAsterisk: true, // Globally toggle the visibility of the required asterisk
128
+ }
129
+ }
114
130
  })
115
131
 
116
132
  app.use(vlite)
117
133
  app.mount('#app')
134
+
118
135
  ```
119
136
 
120
137
  ### How it works
121
138
 
139
+ #### Global Services (e.g., Uploads)
140
+
122
141
  Once registered, you don't need to pass upload handlers to individual components.
123
142
 
124
143
  1. **Automatic Injection**: The `Form` component detects input types like `file`, `avatarUpload`, or `fileUploader`.
125
144
  2. **Parallel Processing**: When the form is submitted, it automatically uploads all files in **parallel** using your registered `upload` service.
126
145
  3. **URL Replacement**: The File objects in your form data are replaced with the returned URLs before the final `onSubmit` event is triggered.
127
146
 
128
- ## 4. Usage
147
+ #### Global Component Configuration (e.g., Forms)
129
148
 
130
- Import components directly in your Vue files:
149
+ By setting `components.form` in the global configuration, you establish app-wide defaults.
150
+
151
+ 1. **Consistency**: Every `<Form />` rendered in your application will automatically inherit the global `variant`, `size`, `rounded`, and `showRequiredAsterisk` configurations.
152
+ 2. **Local Overrides**: If you need a specific form to behave differently, simply pass the prop locally on the component (e.g., `<Form variant="floating" ... />`). Local props will always override the global configuration fallback.
153
+
154
+ ## 4. Advanced Usage
155
+
156
+ Import components directly in your Vue files and leverage the global configuration:
131
157
 
132
158
  ```vue
133
159
  <script setup>
134
160
  import { Button, Input, Form } from 'vlite3'
135
161
 
136
- // The form will automatically use the global upload service defined in main.ts
162
+ // The form will automatically use the global upload service AND the global style configurations
137
163
  const schema = [
138
164
  {
139
165
  name: 'avatar',
@@ -158,8 +184,11 @@ const handleSubmit = (payload) => {
158
184
  <template>
159
185
  <div class="">
160
186
  <Form :schema="schema" @onSubmit="handleSubmit" />
187
+
188
+ <Form :schema="schema" variant="solid" size="lg" @onSubmit="handleSubmit" />
161
189
  </div>
162
190
  </template>
191
+
163
192
  ```
164
193
 
165
194
  # 🎨 Theming & Customization
@@ -174,23 +203,23 @@ All colors are defined as CSS variables, allowing you to customize the appearanc
174
203
 
175
204
  Override these variables in `:root` or within a `.dark` class (when using class-based dark mode) to adjust your theme.
176
205
 
177
- | Variable | Utility Class | Description | Recommended Usage |
178
- | -------------------------------- | ----------------------------- | --------------------------------------- | ----------------------------------------------- |
179
- | `--color-background` | `bg-background` | Default page background (white) | Main application background |
180
- | `--color-foreground` | `text-foreground` | Default text color (gray-900) | Primary content text |
181
- | `--color-card` | `bg-card` | Card background (gray-100) | Cards, containers, surfaces, panels, dialogs |
182
- | `--color-primary` | `bg-primary` | Primary brand color (blue) | Main actions, buttons, active states |
183
- | `--color-primary-foreground` | `text-primary-foreground` | Text on primary background (white) | Text/icons displayed on primary elements |
184
- | `--color-secondary` | `bg-secondary` | Secondary background (gray-200) | Secondary actions, muted sections |
185
- | `--color-secondary-foreground` | `text-secondary-foreground` | Text on secondary background (gray-900) | Content displayed on secondary elements |
186
- | `--color-muted` | `bg-muted` | Muted background (gray-150) | Subtle surfaces, table headers, disabled states |
187
- | `--color-muted` | `text-muted` | Muted text (gray-600) | Secondary text, inactive links, descriptions |
188
- | `--color-accent` | `bg-accent` | Accent background (gray-150) | Hover states, selection highlights |
189
- | `--color-accent-foreground` | `text-accent-foreground` | Text on accent background (gray-900) | Content displayed on accent elements |
190
- | `--color-destructive` | `bg-destructive` | Destructive color (red) | Errors, warnings, destructive actions |
191
- | `--color-destructive-foreground` | `text-destructive-foreground` | Text on destructive background (white) | Content displayed on destructive elements |
192
- | `--color-border` | `border` | Default border color (gray-250) | Inputs, cards, dividers |
193
- | `--radius` | `rounded` | Global border radius | Shared radius across components |
206
+ | Variable | Utility Class | Description | Recommended Usage |
207
+ | --- | --- | --- | --- |
208
+ | `--color-background` | `bg-background` | Default page background (white) | Main application background |
209
+ | `--color-foreground` | `text-foreground` | Default text color (gray-900) | Primary content text |
210
+ | `--color-card` | `bg-card` | Card background (gray-100) | Cards, containers, surfaces, panels, dialogs |
211
+ | `--color-primary` | `bg-primary` | Primary brand color (blue) | Main actions, buttons, active states |
212
+ | `--color-primary-foreground` | `text-primary-foreground` | Text on primary background (white) | Text/icons displayed on primary elements |
213
+ | `--color-secondary` | `bg-secondary` | Secondary background (gray-200) | Secondary actions, muted sections |
214
+ | `--color-secondary-foreground` | `text-secondary-foreground` | Text on secondary background (gray-900) | Content displayed on secondary elements |
215
+ | `--color-muted` | `bg-muted` | Muted background (gray-150) | Subtle surfaces, table headers, disabled states |
216
+ | `--color-muted` | `text-muted` | Muted text (gray-600) | Secondary text, inactive links, descriptions |
217
+ | `--color-accent` | `bg-accent` | Accent background (gray-150) | Hover states, selection highlights |
218
+ | `--color-accent-foreground` | `text-accent-foreground` | Text on accent background (gray-900) | Content displayed on accent elements |
219
+ | `--color-destructive` | `bg-destructive` | Destructive color (red) | Errors, warnings, destructive actions |
220
+ | `--color-destructive-foreground` | `text-destructive-foreground` | Text on destructive background (white) | Content displayed on destructive elements |
221
+ | `--color-border` | `border` | Default border color (gray-250) | Inputs, cards, dividers |
222
+ | `--radius` | `rounded` | Global border radius | Shared radius across components |
194
223
 
195
224
  ---
196
225
 
@@ -198,36 +227,95 @@ Override these variables in `:root` or within a `.dark` class (when using class-
198
227
 
199
228
  For more complex components, vlite3 provides extended variants for main semantic colors (`primary`, `danger`, `warning`, `info`, `success`). These are useful for building nuanced UIs with subtle backgrounds, hover states, and accessible text.
200
229
 
201
- | Base Color | Variant Variables | Usage Description |
202
- | :---------- | :------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
203
- | **Primary** | `--color-primary-light`<br>`--color-primary-dark`<br>`--color-primary-fg`<br>`--color-primary-fg-light` | **Light**: Subtle background (e.g., 10% opacity).<br>**Dark**: Hover state for the main color.<br>**Fg**: Text color on top of the _main_ color.<br>**Fg-Light**: Text color on top of the _light_ variant. |
204
- | **Danger** | `--color-danger-light`<br>`--color-danger-dark`<br>`--color-danger-fg`<br>`--color-danger-fg-light` | **Light**: Error backgrounds (alerts).<br>**Dark**: Hover state for destructive buttons.<br>**Fg**: Text on destructive buttons.<br>**Fg-Light**: Text on error alerts. |
205
- | **Warning** | `--color-warning-light`<br>`--color-warning-dark`<br>`--color-warning-fg`<br>`--color-warning-fg-light` | **Light**: Warning backgrounds.<br>**Dark**: Active/Determined warning states.<br>**Fg**: Text on warning badges.<br>**Fg-Light**: Text on warning backgrounds. |
206
- | **Success** | `--color-success-light`<br>`--color-success-dark`<br>`--color-success-fg`<br>`--color-success-fg-light` | **Light**: Success backgrounds (toasts).<br>**Dark**: Hover/Active success actions.<br>**Fg**: Text on success buttons.<br>**Fg-Light**: Text on success backgrounds. |
207
- | **Info** | `--color-info-light`<br>`--color-info-dark`<br>`--color-info-fg`<br>`--color-info-fg-light` | **Light**: Info backgrounds.<br>**Dark**: Hover/Active info actions.<br>**Fg**: Text on info buttons.<br>**Fg-Light**: Text on info backgrounds. |
230
+ | Base Color | Variant Variables | Usage Description |
231
+ | --- | --- | --- |
232
+ | **Primary** | `--color-primary-light`<br>
233
+
234
+ <br>`--color-primary-dark`<br>
235
+
236
+ <br>`--color-primary-fg`<br>
237
+
238
+ <br>`--color-primary-fg-light` | **Light**: Subtle background (e.g., 10% opacity).<br>
239
+
240
+ <br>**Dark**: Hover state for the main color.<br>
241
+
242
+ <br>**Fg**: Text color on top of the *main* color.<br>
243
+
244
+ <br>**Fg-Light**: Text color on top of the *light* variant. |
245
+ | **Danger** | `--color-danger-light`<br>
246
+
247
+ <br>`--color-danger-dark`<br>
248
+
249
+ <br>`--color-danger-fg`<br>
250
+
251
+ <br>`--color-danger-fg-light` | **Light**: Error backgrounds (alerts).<br>
252
+
253
+ <br>**Dark**: Hover state for destructive buttons.<br>
254
+
255
+ <br>**Fg**: Text on destructive buttons.<br>
256
+
257
+ <br>**Fg-Light**: Text on error alerts. |
258
+ | **Warning** | `--color-warning-light`<br>
259
+
260
+ <br>`--color-warning-dark`<br>
261
+
262
+ <br>`--color-warning-fg`<br>
263
+
264
+ <br>`--color-warning-fg-light` | **Light**: Warning backgrounds.<br>
265
+
266
+ <br>**Dark**: Active/Determined warning states.<br>
267
+
268
+ <br>**Fg**: Text on warning badges.<br>
269
+
270
+ <br>**Fg-Light**: Text on warning backgrounds. |
271
+ | **Success** | `--color-success-light`<br>
272
+
273
+ <br>`--color-success-dark`<br>
274
+
275
+ <br>`--color-success-fg`<br>
276
+
277
+ <br>`--color-success-fg-light` | **Light**: Success backgrounds (toasts).<br>
278
+
279
+ <br>**Dark**: Hover/Active success actions.<br>
280
+
281
+ <br>**Fg**: Text on success buttons.<br>
282
+
283
+ <br>**Fg-Light**: Text on success backgrounds. |
284
+ | **Info** | `--color-info-light`<br>
285
+
286
+ <br>`--color-info-dark`<br>
287
+
288
+ <br>`--color-info-fg`<br>
289
+
290
+ <br>`--color-info-fg-light` | **Light**: Info backgrounds.<br>
291
+
292
+ <br>**Dark**: Hover/Active info actions.<br>
293
+
294
+ <br>**Fg**: Text on info buttons.<br>
295
+
296
+ <br>**Fg-Light**: Text on info backgrounds. |
208
297
 
209
298
  **Example Usage:**
210
299
 
211
300
  ```html
212
- <!-- A success badge with subtle background and matching text -->
213
301
  <div class="bg-success-light text-success-fg-light border border-success/20">
214
302
  Operation Completed
215
303
  </div>
216
304
 
217
- <!-- A danger button with hover effect -->
218
305
  <button class="bg-danger text-danger-fg hover:bg-danger-dark">Delete</button>
306
+
219
307
  ```
220
308
 
221
309
  ### Additional Colors
222
310
 
223
311
  vlite3 also provides additional utility colors for specific feedback states:
224
312
 
225
- | Variable | Class Name | Description |
226
- | :---------------- | :--------------------------- | :-------------------------------------- |
227
- | `--color-success` | `text-success`, `bg-success` | For success messages/badges. |
228
- | `--color-warning` | `text-warning`, `bg-warning` | For warning messages/badges. |
229
- | `--color-info` | `text-info`, `bg-info` | For informational messages/badges. |
230
- | `--color-danger` | `text-danger`, `bg-danger` | Alias for destructive in some contexts. |
313
+ | Variable | Class Name | Description |
314
+ | --- | --- | --- |
315
+ | `--color-success` | `text-success`, `bg-success` | For success messages/badges. |
316
+ | `--color-warning` | `text-warning`, `bg-warning` | For warning messages/badges. |
317
+ | `--color-info` | `text-info`, `bg-info` | For informational messages/badges. |
318
+ | `--color-danger` | `text-danger`, `bg-danger` | Alias for destructive in some contexts. |
231
319
 
232
320
  ---
233
321
 
@@ -235,8 +323,8 @@ vlite3 also provides additional utility colors for specific feedback states:
235
323
 
236
324
  The typography system is organized into two complementary scales:
237
325
 
238
- - Compact scale (prefixed with `--text--fs-*`)
239
- - Progressive scale (prefixed with `--text-fs-*`)
326
+ * Compact scale (prefixed with `--text--fs-*`)
327
+ * Progressive scale (prefixed with `--text-fs-*`)
240
328
 
241
329
  Use the progressive scale only when you need finer visual control beyond the standard Tailwind size tokens.
242
330
  For most layout and content needs, prefer the default Tailwind text sizes to maintain consistency.
@@ -252,6 +340,7 @@ For most layout and content needs, prefer the default Tailwind text sizes to mai
252
340
  --text--fs-6: 0.6em;
253
341
  --text--fs-7: 0.55em;
254
342
  --text--fs-8: 0.5em;
343
+
255
344
  ```
256
345
 
257
346
  ### Progressive Text Scale
@@ -277,13 +366,23 @@ For most layout and content needs, prefer the default Tailwind text sizes to mai
277
366
  --text-fs-9: 1.8em;
278
367
  --text-fs-9.5: 2em;
279
368
  --text-fs-10: 2.5em;
369
+
280
370
  ```
281
371
 
282
372
  ### Tailwind Size Tokens
283
373
 
284
374
  ```css
285
- --text-xs: 0.75rem --text-sm: 0.875rem --text-base: 1rem --text-lg: 1.125rem --text-xl: 1.25rem
286
- --text-2xl: 1.5rem --text-3xl: 1.875rem --text-4xl: 2.25rem --text-5xl: 3rem --text-6xl: 4rem;
375
+ --text-xs: 0.75rem
376
+ --text-sm: 0.875rem
377
+ --text-base: 1rem
378
+ --text-lg: 1.125rem
379
+ --text-xl: 1.25rem
380
+ --text-2xl: 1.5rem
381
+ --text-3xl: 1.875rem
382
+ --text-4xl: 2.25rem
383
+ --text-5xl: 3rem
384
+ --text-6xl: 4rem;
385
+
287
386
  ```
288
387
 
289
388
  ---
@@ -296,85 +395,87 @@ For most layout and content needs, prefer the default Tailwind text sizes to mai
296
395
  <span class="-text-fs-4 text-muted"> Caption text </span>
297
396
 
298
397
  <h1 class="text-xl font-semibold">Page Title</h1>
398
+
299
399
  ```
300
400
 
301
401
  ## Hard Rules
302
402
 
303
403
  Follow these rules strictly to ensure visual consistency and predictable styling across the system:
304
404
 
305
- - Use `border` instead of `border-border` (the default border color (gray-250) is already applied).
306
- - Use `rounded` instead of `rounded-rounded`.
307
- - Use `bg-muted` instead of `bg-secondary/20`.
308
- - Use `gap-x-*` instead of applying `ml-*` or `mr-*` directly on sibling items.
309
- - Use `gap-y-*` instead of applying `mt
405
+ * Use `border` instead of `border-border` (the default border color (gray-250) is already applied).
406
+ * Use `rounded` instead of `rounded-rounded`.
407
+ * Use `bg-muted` instead of `bg-secondary/20`.
408
+ * Use `gap-x-*` instead of applying `ml-*` or `mr-*` directly on sibling items.
409
+ * Use `gap-y-*` instead of applying `mt-*` or `mb-*` directly on sibling items.
310
410
 
311
411
  ---
312
412
 
313
413
  ## ✅ Components
314
414
 
315
- - **Button**
316
- - **ButtonGroup**
317
- - **Icon**
318
- - **Label**
319
- - **Badge**
320
- - **Chip**
321
- - **Logo**
322
- - **Navbar**
323
- - **SidebarMenu**
324
- - **SidePanel**
325
- - **Masonry Grid**
326
- - **ThemeToggle**
415
+ * **Button**
416
+ * **ButtonGroup**
417
+ * **Icon**
418
+ * **Label**
419
+ * **Badge**
420
+ * **Chip**
421
+ * **Logo**
422
+ * **Navbar**
423
+ * **SidebarMenu**
424
+ * **SidePanel**
425
+ * **Masonry Grid**
426
+ * **ThemeToggle**
327
427
 
328
428
  ### Inputs & Forms
329
429
 
330
- - **Input**
331
- - **Textarea**
332
- - **CheckBox**
333
- - **Switch**
334
- - **ChoiceBox**
335
- - **Slider**
336
- - **OTPInput**
337
- - **DatePicker**
338
- - **ColorPicker**
339
- - **FilePicker**
340
- - **AvatarUploader**
341
- - **IconPicker**
342
- - **MultiSelect**
343
- - **Form**
344
- - **CustomFields**
345
- - **NumberInput**
346
- - **Google Login**
430
+ * **Input**
431
+ * **Textarea**
432
+ * **CheckBox**
433
+ * **Switch**
434
+ * **ChoiceBox**
435
+ * **Slider**
436
+ * **OTPInput**
437
+ * **DatePicker**
438
+ * **ColorPicker**
439
+ * **FilePicker**
440
+ * **AvatarUploader**
441
+ * **IconPicker**
442
+ * **MultiSelect**
443
+ * **Form**
444
+ * **CustomFields**
445
+ * **NumberInput**
446
+ * **Google Login**
347
447
 
348
448
  ### Data Display
349
449
 
350
- - **Avatar**
351
- - **Accordion**
352
- - **Carousel**
353
- - **DataTable**
354
- - **Pagination**
355
- - **Timeline**
356
- - **Heatmap**
357
- - **PricingPlan**
358
- - **FileTree**
359
- - **Workbook**
360
- - **Tabes**
450
+ * **Avatar**
451
+ * **Accordion**
452
+ * **Carousel**
453
+ * **DataTable**
454
+ * **Pagination**
455
+ * **Timeline**
456
+ * **Heatmap**
457
+ * **PricingPlan**
458
+ * **FileTree**
459
+ * **Workbook**
460
+ * **Tabes**
361
461
 
362
462
  ### Feedback & Overlays
363
463
 
364
- - **Alert**
365
- - **Modal**
366
- - **ConfirmationModal**
367
- - **ToastNotification**
368
- - **Tooltip**
369
- - **Dropdown**
370
- - **ProgressBar**
371
- - **Spinner**
464
+ * **Alert**
465
+ * **Modal**
466
+ * **ConfirmationModal**
467
+ * **ToastNotification**
468
+ * **Tooltip**
469
+ * **Dropdown**
470
+ * **ProgressBar**
471
+ * **Spinner**
372
472
 
373
473
  ## Complete reference for AI agents and developers:
374
474
 
375
- - [1-setup.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/1-setup.md)
376
- - [2-theming.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/2-theming.md)
377
- - [3-all-components.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/3-all-components.md)
378
- - [4-forms.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/4-forms.md)
379
- - [5-utility.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/5-utility.md)
380
- - [6-advance-components.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/6-advance-components.md)
475
+ * [1-setup.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/1-setup.md)
476
+ * [2-theming.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/2-theming.md)
477
+ * [3-all-components.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/3-all-components.md)
478
+ * [4-forms.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/4-forms.md)
479
+ * [5-utility.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/5-utility.md)
480
+ * [6-advance-components.md](https://github.com/safdar-azeem/vlite3/blob/main/docs/6-advance-components.md)
481
+
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,5 @@
1
+ import { __require as r } from "../node_modules/file-saver/dist/FileSaver.min.js";
2
+ var i = r();
3
+ export {
4
+ i as F
5
+ };
@@ -0,0 +1,4 @@
1
+ var e = { exports: {} };
2
+ export {
3
+ e as __module
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,7 @@
1
+ import { getDefaultExportFromCjs as r } from "./_commonjsHelpers.js";
2
+ import { __require as o } from "../node_modules/jsbarcode/bin/JsBarcode.js";
3
+ var e = o();
4
+ const s = /* @__PURE__ */ r(e);
5
+ export {
6
+ s as default
7
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var r = {};
2
+ export {
3
+ r as __exports
4
+ };
@@ -0,0 +1,8 @@
1
+ var o = typeof globalThis < "u" ? globalThis : typeof window < "u" ? window : typeof global < "u" ? global : typeof self < "u" ? self : {};
2
+ function l(e) {
3
+ return e && e.__esModule && Object.prototype.hasOwnProperty.call(e, "default") ? e.default : e;
4
+ }
5
+ export {
6
+ o as commonjsGlobal,
7
+ l as getDefaultExportFromCjs
8
+ };
@@ -0,0 +1,4 @@
1
+ var t = {};
2
+ export {
3
+ t as __exports
4
+ };
@@ -0,0 +1,4 @@
1
+ var a = {};
2
+ export {
3
+ a as __exports
4
+ };
@@ -0,0 +1,7 @@
1
+ import { getDefaultExportFromCjs as r } from "./_commonjsHelpers.js";
2
+ import { __require as o } from "../node_modules/qrcode/lib/browser.js";
3
+ var e = o();
4
+ const a = /* @__PURE__ */ r(e);
5
+ export {
6
+ a as default
7
+ };