@maz-ui/mcp 5.0.0-beta.2 → 5.0.0-beta.24

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 (142) hide show
  1. package/README.md +1 -1
  2. package/dist/mcp.d.mts +22 -9
  3. package/dist/mcp.d.ts +22 -9
  4. package/dist/mcp.mjs +160 -83
  5. package/docs/generated-docs/maz-avatar.doc.md +25 -25
  6. package/docs/generated-docs/maz-btn.doc.md +1 -1
  7. package/docs/generated-docs/maz-checkbox.doc.md +16 -17
  8. package/docs/generated-docs/maz-circular-progress-bar.doc.md +1 -1
  9. package/docs/generated-docs/maz-code-highlight.doc.md +11 -0
  10. package/docs/generated-docs/maz-date-picker.doc.md +41 -41
  11. package/docs/generated-docs/maz-drawer.doc.md +7 -8
  12. package/docs/generated-docs/maz-expand-animation.doc.md +4 -4
  13. package/docs/generated-docs/maz-fullscreen-loader.doc.md +5 -5
  14. package/docs/generated-docs/maz-gallery.doc.md +15 -15
  15. package/docs/generated-docs/maz-input-code.doc.md +16 -16
  16. package/docs/generated-docs/maz-input-phone-number.doc.md +42 -38
  17. package/docs/generated-docs/maz-input-price.doc.md +14 -14
  18. package/docs/generated-docs/maz-input-tags.doc.md +16 -16
  19. package/docs/generated-docs/maz-input.doc.md +33 -33
  20. package/docs/generated-docs/maz-lazy-img.doc.md +14 -14
  21. package/docs/generated-docs/maz-loading-bar.doc.md +4 -4
  22. package/docs/generated-docs/maz-pull-to-refresh.doc.md +10 -10
  23. package/docs/generated-docs/maz-radio-buttons.doc.md +17 -17
  24. package/docs/generated-docs/maz-radio.doc.md +16 -16
  25. package/docs/generated-docs/maz-reading-progress-bar.doc.md +4 -4
  26. package/docs/generated-docs/maz-sidebar-content.doc.md +5 -0
  27. package/docs/generated-docs/maz-sidebar-footer.doc.md +5 -0
  28. package/docs/generated-docs/maz-sidebar-group.doc.md +11 -0
  29. package/docs/generated-docs/maz-sidebar-header.doc.md +5 -0
  30. package/docs/generated-docs/maz-sidebar-menu-button.doc.md +27 -0
  31. package/docs/generated-docs/maz-sidebar-menu-item.doc.md +5 -0
  32. package/docs/generated-docs/maz-sidebar-menu-sub.doc.md +16 -0
  33. package/docs/generated-docs/maz-sidebar-menu.doc.md +5 -0
  34. package/docs/generated-docs/maz-sidebar-separator.doc.md +0 -0
  35. package/docs/generated-docs/maz-sidebar-trigger.doc.md +5 -0
  36. package/docs/generated-docs/maz-sidebar.doc.md +36 -0
  37. package/docs/generated-docs/maz-slider.doc.md +1 -1
  38. package/docs/generated-docs/maz-spinner.doc.md +4 -4
  39. package/docs/generated-docs/maz-switch.doc.md +14 -14
  40. package/docs/generated-docs/maz-table.doc.md +5 -5
  41. package/docs/generated-docs/maz-textarea.doc.md +25 -24
  42. package/docs/generated-docs/maz-ticker.doc.md +1 -1
  43. package/docs/generated-docs/maz-window-mockup.doc.md +23 -0
  44. package/docs/src/blog/v4.md +1 -1
  45. package/docs/src/blog/v5.md +5 -7
  46. package/docs/src/components/maz-btn.md +1 -1
  47. package/docs/src/components/maz-code-highlight.md +233 -0
  48. package/docs/src/components/maz-container.md +2 -2
  49. package/docs/src/components/maz-date-picker.md +1 -1
  50. package/docs/src/components/maz-dialog.md +46 -0
  51. package/docs/src/components/maz-icon.md +2 -2
  52. package/docs/src/components/maz-input-phone-number.md +106 -103
  53. package/docs/src/components/maz-sidebar.md +719 -0
  54. package/docs/src/components/maz-textarea.md +27 -1
  55. package/docs/src/components/maz-timeline.md +60 -0
  56. package/docs/src/components/maz-window-mockup.md +249 -0
  57. package/docs/src/directives/click-outside.md +8 -15
  58. package/docs/src/directives/fullscreen-img.md +1 -1
  59. package/docs/src/directives/lazy-img.md +5 -5
  60. package/docs/src/directives/tooltip.md +24 -1
  61. package/docs/src/directives/zoom-img.md +1 -1
  62. package/docs/src/ecosystem/eslint-config.md +95 -1
  63. package/docs/src/{guide/icons.md → ecosystem/icons/index.md} +1 -1
  64. package/docs/src/ecosystem/node/exec-promise.md +87 -0
  65. package/docs/src/ecosystem/node/index.md +53 -0
  66. package/docs/src/ecosystem/node/logger.md +146 -0
  67. package/docs/src/ecosystem/node/print-banner.md +93 -0
  68. package/docs/src/{guide → ecosystem}/nuxt.md +81 -47
  69. package/docs/src/{guide → ecosystem}/themes.md +153 -72
  70. package/docs/src/{guide → ecosystem}/translations.md +1 -1
  71. package/docs/src/ecosystem/utils/camel-case.md +31 -0
  72. package/docs/src/{helpers → ecosystem/utils}/capitalize.md +2 -3
  73. package/docs/src/ecosystem/utils/check-availability.md +79 -0
  74. package/docs/src/ecosystem/utils/cookie.md +80 -0
  75. package/docs/src/{helpers → ecosystem/utils}/currency.md +2 -2
  76. package/docs/src/{helpers → ecosystem/utils}/date.md +2 -2
  77. package/docs/src/ecosystem/utils/debounce-callback.md +38 -0
  78. package/docs/src/ecosystem/utils/debounce-id.md +69 -0
  79. package/docs/src/ecosystem/utils/debounce.md +65 -0
  80. package/docs/src/ecosystem/utils/fetch-locale-ip.md +33 -0
  81. package/docs/src/ecosystem/utils/format-json.md +33 -0
  82. package/docs/src/ecosystem/utils/format-phone-number.md +37 -0
  83. package/docs/src/ecosystem/utils/get-browser-locale.md +29 -0
  84. package/docs/src/ecosystem/utils/get-error-message.md +39 -0
  85. package/docs/src/ecosystem/utils/idle-timeout.md +90 -0
  86. package/docs/src/ecosystem/utils/index.md +60 -0
  87. package/docs/src/ecosystem/utils/is-client.md +32 -0
  88. package/docs/src/ecosystem/utils/is-equal.md +38 -0
  89. package/docs/src/ecosystem/utils/is-server.md +31 -0
  90. package/docs/src/ecosystem/utils/is-standalone-mode.md +43 -0
  91. package/docs/src/ecosystem/utils/kebab-case.md +36 -0
  92. package/docs/src/ecosystem/utils/normalize-string.md +77 -0
  93. package/docs/src/{helpers → ecosystem/utils}/number.md +2 -2
  94. package/docs/src/ecosystem/utils/pascal-case.md +35 -0
  95. package/docs/src/ecosystem/utils/script-loader.md +77 -0
  96. package/docs/src/ecosystem/utils/sleep.md +59 -0
  97. package/docs/src/ecosystem/utils/snake-case.md +36 -0
  98. package/docs/src/ecosystem/utils/swipe-handler.md +91 -0
  99. package/docs/src/ecosystem/utils/textarea-autogrow.md +41 -0
  100. package/docs/src/ecosystem/utils/throttle-id.md +48 -0
  101. package/docs/src/ecosystem/utils/throttle.md +57 -0
  102. package/docs/src/ecosystem/utils/truthy-filter.md +31 -0
  103. package/docs/src/ecosystem/utils/types/deep-key-of.md +48 -0
  104. package/docs/src/ecosystem/utils/types/deep-partial.md +42 -0
  105. package/docs/src/ecosystem/utils/types/deep-required.md +39 -0
  106. package/docs/src/ecosystem/utils/types/flatten-object-keys.md +44 -0
  107. package/docs/src/ecosystem/utils/types/generic-instance-type.md +42 -0
  108. package/docs/src/ecosystem/utils/types/infer-maybe-ref.md +35 -0
  109. package/docs/src/ecosystem/utils/upper-first.md +32 -0
  110. package/docs/src/ecosystem/utils/user-visibility.md +69 -0
  111. package/docs/src/guide/getting-started.md +15 -13
  112. package/docs/src/guide/global-defaults.md +101 -0
  113. package/docs/src/guide/maz-ui-provider.md +6 -3
  114. package/docs/src/guide/migration-v4.md +13 -9
  115. package/docs/src/guide/migration-v5.md +67 -12
  116. package/docs/src/guide/resolvers.md +7 -7
  117. package/docs/src/guide/tailwind.md +4 -0
  118. package/docs/src/guide/vue.md +4 -4
  119. package/docs/src/index.md +12 -12
  120. package/docs/src/plugins/aos.md +1 -1
  121. package/docs/src/plugins/wait.md +1 -1
  122. package/package.json +6 -5
  123. package/docs/src/helpers/camel-case.md +0 -14
  124. package/docs/src/helpers/check-availability.md +0 -14
  125. package/docs/src/helpers/debounce-callback.md +0 -14
  126. package/docs/src/helpers/debounce-id.md +0 -14
  127. package/docs/src/helpers/debounce.md +0 -14
  128. package/docs/src/helpers/is-client.md +0 -14
  129. package/docs/src/helpers/is-equal.md +0 -14
  130. package/docs/src/helpers/is-standalone-mode.md +0 -14
  131. package/docs/src/helpers/kebab-case.md +0 -14
  132. package/docs/src/helpers/normalize-string.md +0 -14
  133. package/docs/src/helpers/pascal-case.md +0 -14
  134. package/docs/src/helpers/script-loader.md +0 -14
  135. package/docs/src/helpers/sleep.md +0 -14
  136. package/docs/src/helpers/snake-case.md +0 -14
  137. package/docs/src/helpers/throttle-id.md +0 -14
  138. package/docs/src/helpers/throttle.md +0 -14
  139. /package/docs/src/{guide → ecosystem/icons}/icon-set.md +0 -0
  140. /package/docs/src/{guide → ecosystem}/mcp.md +0 -0
  141. /package/docs/src/{helpers → ecosystem/utils}/country-code-to-unicode-flag.md +0 -0
  142. /package/docs/src/{helpers → ecosystem/utils}/get-country-flag-url.md +0 -0
package/docs/generated-docs/maz-input-price.doc.md CHANGED
@@ -1,19 +1,19 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | -------------------- | ---------------------------------------------------------------------------- | --------- | -------- | -------------------------- |
5
- | **model-value** | `v-model` <br/> | `number` | No | `undefined` |
6
- | **currency** | The currency to use | `string` | No | `'EUR'` |
7
- | **locale** | The locale to use | `string` | No | `'fr-FR'` |
8
- | **min** | The minimum value that the input can accept | `number` | No | `Number.NEGATIVE_INFINITY` |
9
- | **max** | The maximum value that the input can accept | `number` | No | `Number.POSITIVE_INFINITY` |
10
- | **no-icon** | The input will be displayed without icon | `boolean` | No | `false` |
11
- | **block** | The input will be displayed in full width | `boolean` | No | `undefined` |
12
- | **error** | Will display the input in error state. | `boolean` | No | `undefined` |
13
- | **hint** | The hint text to display below the input. | `string` | No | `undefined` |
14
- | **success** | Will display the input in success state. | `boolean` | No | `undefined` |
15
- | **warning** | Will display the input in warning state. | `boolean` | No | `undefined` |
16
- | **currency-options** | Options for the currency helper - [see](https://maz-ui.com/helpers/currency) | `Omit` | No | `undefined` |
3
+ | Name | Description | Type | Required |
4
+ | -------------------- | ---------------------------------------------------------------------------- | --------- | -------- |
5
+ | **model-value** | `v-model` <br/> | `number` | No |
6
+ | **currency** | The currency to use | `string` | No |
7
+ | **locale** | The locale to use | `string` | No |
8
+ | **min** | The minimum value that the input can accept | `number` | No |
9
+ | **max** | The maximum value that the input can accept | `number` | No |
10
+ | **no-icon** | The input will be displayed without icon | `boolean` | No |
11
+ | **block** | The input will be displayed in full width | `boolean` | No |
12
+ | **error** | Will display the input in error state. | `boolean` | No |
13
+ | **hint** | The hint text to display below the input. | `string` | No |
14
+ | **success** | Will display the input in success state. | `boolean` | No |
15
+ | **warning** | Will display the input in warning state. | `boolean` | No |
16
+ | **currency-options** | Options for the currency helper - [see](https://maz-ui.com/helpers/currency) | `Omit` | No |
17
17
 
18
18
  ## Events
19
19
 
package/docs/generated-docs/maz-input-tags.doc.md CHANGED
@@ -1,21 +1,21 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | -------------------- | -------------------------------------------- | ----------------------- | -------- | ----------- |
5
- | **style** | Style attribut of the component root element | `Native type` | No | `undefined` |
6
- | **class** | Class attribut of the component root element | `Native type` | No | `undefined` |
7
- | **model-value** | `v-model` <br/> | `TSParenthesizedType[]` | No | `undefined` |
8
- | **placeholder** | The placeholder of the input | `string` | No | `undefined` |
9
- | **label** | The label of the input | `string` | No | `undefined` |
10
- | **disabled** | Disable the input | `boolean` | No | `false` |
11
- | **error** | Display the input with error style | `boolean` | No | `false` |
12
- | **success** | Display the input with success style | `boolean` | No | `false` |
13
- | **warning** | Display the input with warning style | `boolean` | No | `false` |
14
- | **size** | The size of the input | `MazSize` | No | `'md'` |
15
- | **color** | The color of the input | `MazColor` | No | `'primary'` |
16
- | **block** | The input will be displayed in full width | `boolean` | No | `undefined` |
17
- | **add-tags-on-blur** | Add tags on blur | `boolean` | No | `true` |
18
- | **hint** | The hint text to display below the input. | `string` | No | `undefined` |
3
+ | Name | Description | Type | Required |
4
+ | -------------------- | -------------------------------------------- | ----------------------- | -------- |
5
+ | **style** | Style attribut of the component root element | `Native type` | No |
6
+ | **class** | Class attribut of the component root element | `Native type` | No |
7
+ | **model-value** | `v-model` <br/> | `TSParenthesizedType[]` | No |
8
+ | **placeholder** | The placeholder of the input | `string` | No |
9
+ | **label** | The label of the input | `string` | No |
10
+ | **disabled** | Disable the input | `boolean` | No |
11
+ | **error** | Display the input with error style | `boolean` | No |
12
+ | **success** | Display the input with success style | `boolean` | No |
13
+ | **warning** | Display the input with warning style | `boolean` | No |
14
+ | **size** | The size of the input | `MazSize` | No |
15
+ | **color** | The color of the input | `MazColor` | No |
16
+ | **block** | The input will be displayed in full width | `boolean` | No |
17
+ | **add-tags-on-blur** | Add tags on blur | `boolean` | No |
18
+ | **hint** | The hint text to display below the input. | `string` | No |
19
19
 
20
20
  ## Events
21
21
 
package/docs/generated-docs/maz-input.doc.md CHANGED
@@ -1,38 +1,38 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default | Possible values |
4
- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | -------- | ----------- | ------------------------------------------------------------------------------------------ |
5
- | **style** | Inline styles to apply to the component root element | `HTMLAttributes['style']` | No | `undefined` | - |
6
- | **class** | CSS classes to apply to the component root element | `HTMLAttributes['class']` | No | `undefined` | - |
7
- | **model-value** | `v-model` <br/>The current value of the input field. This prop is used for two-way data binding with v-model<br/>**Example:** `<MazInput v-model="inputValue" />` | `T` | No | `undefined` | - |
8
- | **placeholder** | Text displayed when the input is empty to guide the user<br/>**Example:** `"Enter your email address"` | `string` | No | `undefined` | - |
9
- | **label** | Floating label that appears inside the input and moves up when focused or filled. Provides better UX than traditional placeholders<br/>**Example:** `"Email Address"` | `string` | No | `undefined` | - |
10
- | **top-label** | Static label displayed above the input field. Unlike the floating label, this remains fixed<br/>**Example:** `"User Information"` | `string` | No | `undefined` | - |
11
- | **assistive-text** | Helper text displayed below the input to provide additional context or validation feedback<br/>**Example:** `"Must contain at least 8 characters"` | `string` | No | `undefined` | - |
12
- | **color** | Theme color that affects the border and focus states of the input<br/>**Example:** `"primary"` | `MazColor` | No | `'primary'` | `primary, secondary, accent, info, success, warning, destructive, contrast` |
13
- | **type** | HTML input type attribute that determines the input behavior and validation<br/>**Example:** `"email"` | `InputHTMLAttributes['type']` | No | `'text'` | `text, password, email, number, tel, url, search, date, time, datetime-local, month, week` |
14
- | **required** | Makes the input field mandatory for form submission<br/>**Example:** `true` | `boolean` | No | `false` | - |
15
- | **disabled** | Disables the input field, preventing user interaction and form submission<br/>**Example:** `false` | `boolean` | No | `false` | - |
16
- | **readonly** | Makes the input field read-only, allowing selection but preventing modification<br/>**Example:** `false` | `boolean` | No | `undefined` | - |
17
- | **id** | Unique identifier for the input element, used for form labels and accessibility<br/>**Example:** `"user-email"` | `string` | No | `undefined` | - |
18
- | **error** | Applies error styling (red border and text) to indicate validation failure<br/>**Example:** `true` | `boolean` | No | `false` | - |
19
- | **success** | Applies success styling (green border and text) to indicate successful validation<br/>**Example:** `true` | `boolean` | No | `false` | - |
20
- | **warning** | Applies warning styling (orange border and text) to indicate potential issues<br/>**Example:** `true` | `boolean` | No | `false` | - |
21
- | **hint** | Alternative text that replaces the label when provided. Useful for contextual hints<br/>**Example:** `"Optional field"` | `string` | No | `undefined` | - |
22
- | **input-classes** | Additional CSS classes to apply specifically to the input wrapper element<br/>**Example:** `"custom-input-wrapper"` | `string` | No | `undefined` | - |
23
- | **border** | Controls whether the input has a visible border. Set to false for borderless inputs<br/>**Example:** `true` | `boolean` | No | `true` | - |
24
- | **inputmode** | HTML inputmode attribute that provides hints for virtual keyboards on mobile devices<br/>**Example:** `"numeric"` | `InputHTMLAttributes['inputmode']` | No | `'text'` | `text, numeric, decimal, tel, search, email, url` |
25
- | **size** | Controls the height and text size of the input component<br/>**Example:** `"md"` | `MazSize` | No | `'md'` | `xs, sm, md, lg, xl, mini` |
26
- | **debounce** | Enables input debouncing to limit the frequency of value updates. When true, uses 500ms delay. When a number, uses that value as delay in milliseconds<br/>**Example:** `true` | `boolean \| number` | No | `false` | - |
27
- | **auto-focus** | Automatically focuses the input when the component mounts<br/>**Example:** `false` | `boolean` | No | `false` | - |
28
- | **border-active** | When true, shows the colored border immediately instead of only on focus<br/>**Example:** `false` | `boolean` | No | `false` | - |
29
- | **start-icon** | Icon displayed on the inline-start edge of the input (left in LTR, right in RTL). Accepts a bare value (Vue component, raw SVG string, URL or `data:` URI) or a full `MazIconProps` object for fine-grained control (size, title, svgAttributes, fallback, …). | `MazIconLike` | No | `undefined` | - |
30
- | **end-icon** | Icon displayed on the inline-end edge of the input (right in LTR, left in RTL). Accepts a bare value or a full `MazIconProps` object. | `MazIconLike` | No | `undefined` | - |
31
- | **rounded-size** | Controls the border radius of the input component<br/>**Example:** `"lg"` | `'none' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full'` | No | `'md'` | `none, sm, md, lg, xl, full` |
32
- | **block** | Makes the input expand to the full width of its container<br/>**Example:** `false` | `boolean` | No | `undefined` | - |
33
- | **name** | The name of the input field. Used for form submission and validation<br/>**Example:** `"email"` | `string` | No | `undefined` | - |
34
- | **autocomplete** | The autocomplete attribute for the input field. Used for form submission and validation<br/>**Example:** `"email"` | `string` | No | `undefined` | - |
35
- | **loading** | Loading state for the input field. Used to show a loading spinner | `boolean` | No | `false` | - |
3
+ | Name | Description | Type | Required | Default | Possible values |
4
+ | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | -------- | ----------- | ------------------------------------------------------------------------------------------ |
5
+ | **style** | Inline styles to apply to the component root element | `HTMLAttributes['style']` | No | `undefined` | - |
6
+ | **class** | CSS classes to apply to the component root element | `HTMLAttributes['class']` | No | `undefined` | - |
7
+ | **model-value** | `v-model` <br/>The current value of the input field. This prop is used for two-way data binding with v-model<br/>**Example:** `<MazInput v-model="inputValue" />` | `T` | No | `undefined` | - |
8
+ | **placeholder** | Text displayed when the input is empty to guide the user<br/>**Example:** `"Enter your email address"` | `string` | No | `undefined` | - |
9
+ | **label** | Floating label that appears inside the input and moves up when focused or filled. Provides better UX than traditional placeholders<br/>**Example:** `"Email Address"` | `string` | No | `undefined` | - |
10
+ | **top-label** | Static label displayed above the input field. Unlike the floating label, this remains fixed<br/>**Example:** `"User Information"` | `string` | No | `undefined` | - |
11
+ | **assistive-text** | Helper text displayed below the input to provide additional context or validation feedback<br/>**Example:** `"Must contain at least 8 characters"` | `string` | No | `undefined` | - |
12
+ | **color** | Theme color that affects the border and focus states of the input<br/>**Example:** `"primary"` | `MazColor` | No | `undefined` | `primary, secondary, accent, info, success, warning, destructive, contrast` |
13
+ | **type** | HTML input type attribute that determines the input behavior and validation<br/>**Example:** `"email"` | `InputHTMLAttributes['type']` | No | `undefined` | `text, password, email, number, tel, url, search, date, time, datetime-local, month, week` |
14
+ | **required** | Makes the input field mandatory for form submission<br/>**Example:** `true` | `boolean` | No | `undefined` | - |
15
+ | **disabled** | Disables the input field, preventing user interaction and form submission<br/>**Example:** `false` | `boolean` | No | `undefined` | - |
16
+ | **readonly** | Makes the input field read-only, allowing selection but preventing modification<br/>**Example:** `false` | `boolean` | No | `undefined` | - |
17
+ | **id** | Unique identifier for the input element, used for form labels and accessibility<br/>**Example:** `"user-email"` | `string` | No | `undefined` | - |
18
+ | **error** | Applies error styling (red border and text) to indicate validation failure<br/>**Example:** `true` | `boolean` | No | `undefined` | - |
19
+ | **success** | Applies success styling (green border and text) to indicate successful validation<br/>**Example:** `true` | `boolean` | No | `undefined` | - |
20
+ | **warning** | Applies warning styling (orange border and text) to indicate potential issues<br/>**Example:** `true` | `boolean` | No | `undefined` | - |
21
+ | **hint** | Alternative text that replaces the label when provided. Useful for contextual hints<br/>**Example:** `"Optional field"` | `string` | No | `undefined` | - |
22
+ | **input-classes** | Additional CSS classes to apply specifically to the input wrapper element<br/>**Example:** `"custom-input-wrapper"` | `string` | No | `undefined` | - |
23
+ | **border** | Controls whether the input has a visible border. Set to false for borderless inputs<br/>**Example:** `true` | `boolean` | No | `undefined` | - |
24
+ | **inputmode** | HTML inputmode attribute that provides hints for virtual keyboards on mobile devices<br/>**Example:** `"numeric"` | `InputHTMLAttributes['inputmode']` | No | `undefined` | `text, numeric, decimal, tel, search, email, url` |
25
+ | **size** | Controls the height and text size of the input component<br/>**Example:** `"md"` | `MazSize` | No | `undefined` | `xs, sm, md, lg, xl, mini` |
26
+ | **debounce** | Enables input debouncing to limit the frequency of value updates. When true, uses 500ms delay. When a number, uses that value as delay in milliseconds<br/>**Example:** `true` | `boolean \| number` | No | `undefined` | - |
27
+ | **auto-focus** | Automatically focuses the input when the component mounts<br/>**Example:** `false` | `boolean` | No | `undefined` | - |
28
+ | **border-active** | When true, shows the colored border immediately instead of only on focus<br/>**Example:** `false` | `boolean` | No | `undefined` | - |
29
+ | **start-icon** | Icon displayed on the inline-start edge of the input (left in LTR, right in RTL). Accepts a bare value (Vue component, raw SVG string, URL or `data:` URI) or a full `MazIconProps` object for fine-grained control (size, title, svgAttributes, fallback, …). | `MazIconLike` | No | `undefined` | - |
30
+ | **end-icon** | Icon displayed on the inline-end edge of the input (right in LTR, left in RTL). Accepts a bare value or a full `MazIconProps` object. | `MazIconLike` | No | `undefined` | - |
31
+ | **rounded-size** | Controls the border radius of the input component<br/>**Example:** `"lg"` | `MazRoundedSize` | No | `md` | `none, sm, md, lg, xl, full` |
32
+ | **block** | Makes the input expand to the full width of its container<br/>**Example:** `false` | `boolean` | No | `undefined` | - |
33
+ | **name** | The name of the input field. Used for form submission and validation<br/>**Example:** `"email"` | `string` | No | `undefined` | - |
34
+ | **autocomplete** | The autocomplete attribute for the input field. Used for form submission and validation<br/>**Example:** `"email"` | `string` | No | `undefined` | - |
35
+ | **loading** | Loading state for the input field. Used to show a loading spinner | `boolean` | No | `false` | - |
36
36
 
37
37
  ## Events
38
38
 
package/docs/generated-docs/maz-lazy-img.doc.md CHANGED
@@ -1,19 +1,19 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | --------------------- | ---------------------------------------------------- | ------------------------- | -------- | ----------- |
5
- | **style** | The style of the component | `Native type` | No | `undefined` |
6
- | **class** | The class of the component | `Native type` | No | `undefined` |
7
- | **src** | The source of the image | `string \| Image \| null` | No | `undefined` |
8
- | **alt** | The alt of the image | `string` | No | `undefined` |
9
- | **hide-loader** | Remove the loader | `boolean` | No | `undefined` |
10
- | **observer-once** | Remove the observer once the image is loaded | `boolean` | No | `true` |
11
- | **load-once** | Remove the observer once the image is loaded | `boolean` | No | `undefined` |
12
- | **image-height-full** | Make the image height full | `boolean` | No | `undefined` |
13
- | **observer-options** | The options of the observer | `Native type` | No | `undefined` |
14
- | **fallback-src** | The fallback src to replace the src on loading error | `string` | No | `undefined` |
15
- | **img-class** | The classes of the image element | `Native type` | No | `undefined` |
16
- | **block** | The image will be displayed in full width | `boolean` | No | `undefined` |
3
+ | Name | Description | Type | Required |
4
+ | --------------------- | ---------------------------------------------------- | ------------------------- | -------- |
5
+ | **style** | The style of the component | `Native type` | No |
6
+ | **class** | The class of the component | `Native type` | No |
7
+ | **src** | The source of the image | `string \| Image \| null` | No |
8
+ | **alt** | The alt of the image | `string` | No |
9
+ | **hide-loader** | Remove the loader | `boolean` | No |
10
+ | **observer-once** | Remove the observer once the image is loaded | `boolean` | No |
11
+ | **load-once** | Remove the observer once the image is loaded | `boolean` | No |
12
+ | **image-height-full** | Make the image height full | `boolean` | No |
13
+ | **observer-options** | The options of the observer | `Native type` | No |
14
+ | **fallback-src** | The fallback src to replace the src on loading error | `string` | No |
15
+ | **img-class** | The classes of the image element | `Native type` | No |
16
+ | **block** | The image will be displayed in full width | `boolean` | No |
17
17
 
18
18
  ## Events
19
19
 
package/docs/generated-docs/maz-loading-bar.doc.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | ---------- | ---------------------------- | ---------- | -------- | ------------ |
5
- | **color** | The color of the component. | `MazColor` | No | `'primary'` |
6
- | **height** | The height of the component. | `string` | No | `'0.125rem'` |
3
+ | Name | Description | Type | Required |
4
+ | ---------- | ---------------------------- | ---------- | -------- |
5
+ | **color** | The color of the component. | `MazColor` | No |
6
+ | **height** | The height of the component. | `string` | No |
package/docs/generated-docs/maz-pull-to-refresh.doc.md CHANGED
@@ -1,15 +1,15 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | ---------------------- | ----------- | ---------------- | -------- | ------------ |
5
- | **distance** | | `number` | No | `100` |
6
- | **offset** | | `number` | No | `0` |
7
- | **on-click** | | `TSFunctionType` | No | `undefined` |
8
- | **container-selector** | | `string` | No | `undefined` |
9
- | **header-class** | | `string` | No | `undefined` |
10
- | **spinner-color** | | `MazColor` | No | `'contrast'` |
11
- | **disabled** | | `boolean` | No | `false` |
12
- | **standalone-mode** | | `boolean` | No | `false` |
3
+ | Name | Description | Type | Required |
4
+ | ---------------------- | ----------- | ---------------- | -------- |
5
+ | **distance** | | `number` | No |
6
+ | **offset** | | `number` | No |
7
+ | **on-click** | | `TSFunctionType` | No |
8
+ | **container-selector** | | `string` | No |
9
+ | **header-class** | | `string` | No |
10
+ | **spinner-color** | | `MazColor` | No |
11
+ | **disabled** | | `boolean` | No |
12
+ | **standalone-mode** | | `boolean` | No |
13
13
 
14
14
  ## Events
15
15
 
package/docs/generated-docs/maz-radio-buttons.doc.md CHANGED
@@ -1,22 +1,22 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default | Possible values |
4
- | --------------- | --------------------------------------------- | ----------------------- | -------- | ------------------- | --------------- |
5
- | **model-value** | `v-model` <br/> | `T` | No | `undefined` | - |
6
- | **options** | The options to display | `Option[]` | Yes | `undefined` | - |
7
- | **name** | The name of the radio group | `string` | No | `'MazButtonsRadio'` | - |
8
- | **color** | The color of the selected radio buttons | `MazColor \| "surface"` | No | `'primary'` | - |
9
- | **elevation** | Add elevation to the radio buttons | `boolean` | No | `false` | - |
10
- | **orientation** | The orientation of the radio buttons | `"row" \| "col"` | No | `'row'` | `row' \| 'col` |
11
- | **wrap** | Disable the wrap of the radio buttons | `boolean` | No | `true` | - |
12
- | **equal-size** | Make all radio buttons the same size | `boolean` | No | `false` | - |
13
- | **selector** | Display a selector icon | `boolean` | No | `false` | - |
14
- | **block** | The component will be displayed in full width | `boolean` | No | `false` | - |
15
- | **error** | Whether there is an error with the input. | `boolean` | No | `undefined` | - |
16
- | **success** | Whether the input is successful. | `boolean` | No | `undefined` | - |
17
- | **warning** | Whether there is a warning with the input. | `boolean` | No | `undefined` | - |
18
- | **hint** | The hint text to display below the input. | `string` | No | `undefined` | - |
19
- | **size** | The size of the radio buttons | `MazSize` | No | `'md'` | - |
3
+ | Name | Description | Type | Required | Default | Possible values |
4
+ | --------------- | --------------------------------------------- | ----------------------- | -------- | ----------- | --------------- |
5
+ | **model-value** | `v-model` <br/> | `T` | No | `undefined` | - |
6
+ | **options** | The options to display | `Option[]` | Yes | `undefined` | - |
7
+ | **name** | The name of the radio group | `string` | No | `undefined` | - |
8
+ | **color** | The color of the selected radio buttons | `MazColor \| "surface"` | No | `undefined` | - |
9
+ | **elevation** | Add elevation to the radio buttons | `boolean` | No | `undefined` | - |
10
+ | **orientation** | The orientation of the radio buttons | `"row" \| "col"` | No | `row` | `row' \| 'col` |
11
+ | **wrap** | Disable the wrap of the radio buttons | `boolean` | No | `undefined` | - |
12
+ | **equal-size** | Make all radio buttons the same size | `boolean` | No | `undefined` | - |
13
+ | **selector** | Display a selector icon | `boolean` | No | `undefined` | - |
14
+ | **block** | The component will be displayed in full width | `boolean` | No | `undefined` | - |
15
+ | **error** | Whether there is an error with the input. | `boolean` | No | `undefined` | - |
16
+ | **success** | Whether the input is successful. | `boolean` | No | `undefined` | - |
17
+ | **warning** | Whether there is a warning with the input. | `boolean` | No | `undefined` | - |
18
+ | **hint** | The hint text to display below the input. | `string` | No | `undefined` | - |
19
+ | **size** | The size of the radio buttons | `MazSize` | No | `md` | - |
20
20
 
21
21
  ## Events
22
22
 
package/docs/generated-docs/maz-radio.doc.md CHANGED
@@ -1,21 +1,21 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | --------------- | -------------------------------------------- | ------------- | -------- | ----------- |
5
- | **style** | Style attribut of the component root element | `Native type` | No | `undefined` |
6
- | **class** | Class attribut of the component root element | `Native type` | No | `undefined` |
7
- | **id** | The id of the radio | `string` | No | `undefined` |
8
- | **model-value** | `v-model` <br/> | `T` | No | `undefined` |
9
- | **value** | The value of the radio | `T` | Yes | `undefined` |
10
- | **name** | The name of the radio | `string` | Yes | `undefined` |
11
- | **label** | The label of the radio | `string` | No | `undefined` |
12
- | **color** | The color of the radio | `MazColor` | No | `'primary'` |
13
- | **size** | The size of the radio | `MazSize` | No | `'md'` |
14
- | **disabled** | The disabled state of the radio | `boolean` | No | `false` |
15
- | **error** | Whether there is an error with the input. | `boolean` | No | `undefined` |
16
- | **success** | Whether the input is successful. | `boolean` | No | `undefined` |
17
- | **warning** | Whether there is a warning with the input. | `boolean` | No | `undefined` |
18
- | **hint** | The hint text to display below the input. | `string` | No | `undefined` |
3
+ | Name | Description | Type | Required |
4
+ | --------------- | -------------------------------------------- | ------------- | -------- |
5
+ | **style** | Style attribut of the component root element | `Native type` | No |
6
+ | **class** | Class attribut of the component root element | `Native type` | No |
7
+ | **id** | The id of the radio | `string` | No |
8
+ | **model-value** | `v-model` <br/> | `T` | No |
9
+ | **value** | The value of the radio | `T` | Yes |
10
+ | **name** | The name of the radio | `string` | Yes |
11
+ | **label** | The label of the radio | `string` | No |
12
+ | **color** | The color of the radio | `MazColor` | No |
13
+ | **size** | The size of the radio | `MazSize` | No |
14
+ | **disabled** | The disabled state of the radio | `boolean` | No |
15
+ | **error** | Whether there is an error with the input. | `boolean` | No |
16
+ | **success** | Whether the input is successful. | `boolean` | No |
17
+ | **warning** | Whether there is a warning with the input. | `boolean` | No |
18
+ | **hint** | The hint text to display below the input. | `string` | No |
19
19
 
20
20
  ## Events
21
21
 
package/docs/generated-docs/maz-reading-progress-bar.doc.md CHANGED
@@ -2,10 +2,10 @@
2
2
 
3
3
  | Name | Description | Type | Required | Default |
4
4
  | --------------------- | ----------------------------------------------------------------------------------------- | ------------- | -------- | ----------- |
5
- | **height** | Height of the progress bar | `string` | No | `'4px'` |
6
- | **color** | Color of the progress bar | `MazColor` | No | `'primary'` |
7
- | **teleport-selector** | Selector of the element to teleport the progress bar | `string` | No | `'body'` |
8
- | **content-selector** | Selector of the element to get the height | `string` | No | `'body'` |
5
+ | **height** | Height of the progress bar | `string` | No | `4px` |
6
+ | **color** | Color of the progress bar | `MazColor` | No | `primary` |
7
+ | **teleport-selector** | Selector of the element to teleport the progress bar | `string` | No | `body` |
8
+ | **content-selector** | Selector of the element to get the height | `string` | No | `body` |
9
9
  | **offset** | Offset of the progress bar | `number` | No | `0` |
10
10
  | **bar-class** | Class of the progress bar | `Native type` | No | `undefined` |
11
11
  | **distance** | Instead of using the height of the content with a selector, you can set a scroll distance | `number` | No | `undefined` |
package/docs/generated-docs/maz-sidebar-content.doc.md ADDED
@@ -0,0 +1,5 @@
1
+ ## Slots
2
+
3
+ | Name | Description | Bindings |
4
+ | ------- | ----------- | -------- |
5
+ | default | | |
package/docs/generated-docs/maz-sidebar-footer.doc.md ADDED
@@ -0,0 +1,5 @@
1
+ ## Slots
2
+
3
+ | Name | Description | Bindings |
4
+ | ------- | ----------- | -------- |
5
+ | default | | |
package/docs/generated-docs/maz-sidebar-group.doc.md ADDED
@@ -0,0 +1,11 @@
1
+ ## Props
2
+
3
+ | Name | Description | Type | Required |
4
+ | --------- | ---------------------------- | -------- | -------- |
5
+ | **label** | Optional label for the group | `string` | No |
6
+
7
+ ## Slots
8
+
9
+ | Name | Description | Bindings |
10
+ | ------- | ----------- | -------- |
11
+ | default | | |
package/docs/generated-docs/maz-sidebar-header.doc.md ADDED
@@ -0,0 +1,5 @@
1
+ ## Slots
2
+
3
+ | Name | Description | Bindings |
4
+ | ------- | ----------- | -------- |
5
+ | default | | |
package/docs/generated-docs/maz-sidebar-menu-button.doc.md ADDED
@@ -0,0 +1,27 @@
1
+ ## Props
2
+
3
+ | Name | Description | Type | Required |
4
+ | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | -------- |
5
+ | **to** | Route for router-link navigation | `string \| Record` | No |
6
+ | **href** | URL for anchor navigation | `string` | No |
7
+ | **icon** | Icon to display before the label. Accepts a bare icon value (Vue component, raw SVG string, URL) or a full `MazIconProps` object for fine-grained control (size, title, fallback, …). | `MazIconLike` | No |
8
+ | **label** | Label text | `string` | No |
9
+ | **badge** | Badge content. Pass a `string`/`number` for a simple primary badge, or a full `MazBadgeProps` object (with optional `text`) to customise color, size, outlined, … | `MazSidebarMenuButtonBadge` | No |
10
+ | **tooltip** | Tooltip text. When provided, shows a tooltip on hover via the `v-tooltip` directive. | `string` | No |
11
+ | **tooltip-mode** | Controls when the tooltip should be displayed. - `always`: tooltip shows on hover regardless of the sidebar state - `closed`: tooltip only shows on hover when the sidebar is collapsed Overrides the parent `MazSidebar`'s `tooltipMode`. Falls back to the sidebar value (which defaults to `always`) when not provided. | `MazSidebarTooltipMode` | No |
12
+ | **active** | Whether the item is active (highlights with `aria-current="page"`) | `boolean` | No |
13
+ | **disabled** | Whether the item is disabled | `boolean` | No |
14
+ | **size** | Size of the button | `"sm" \| "md" \| "lg"` | No |
15
+
16
+ ## Events
17
+
18
+ | Event name | Properties | Description |
19
+ | ---------- | ---------- | ----------- |
20
+ | click | |
21
+
22
+ ## Slots
23
+
24
+ | Name | Description | Bindings |
25
+ | ------- | ----------- | -------- |
26
+ | icon | | |
27
+ | default | | |
package/docs/generated-docs/maz-sidebar-menu-item.doc.md ADDED
@@ -0,0 +1,5 @@
1
+ ## Slots
2
+
3
+ | Name | Description | Bindings |
4
+ | ------- | ----------- | -------- |
5
+ | default | | |
package/docs/generated-docs/maz-sidebar-menu-sub.doc.md ADDED
@@ -0,0 +1,16 @@
1
+ ## Props
2
+
3
+ | Name | Description | Type | Required |
4
+ | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | -------- |
5
+ | **label** | Label for the sub-menu trigger button | `string` | No |
6
+ | **icon** | Icon to display before the label. Accepts a bare icon value (Vue component, raw SVG string, URL) or a full `MazIconProps` object for fine-grained control. | `MazIconLike` | No |
7
+ | **default-open** | Whether the sub-menu is open by default | `boolean` | No |
8
+
9
+ ## Slots
10
+
11
+ | Name | Description | Bindings |
12
+ | ------- | ----------- | -------- |
13
+ | icon | | |
14
+ | label | | |
15
+ | chevron | | |
16
+ | default | | |
package/docs/generated-docs/maz-sidebar-menu.doc.md ADDED
@@ -0,0 +1,5 @@
1
+ ## Slots
2
+
3
+ | Name | Description | Bindings |
4
+ | ------- | ----------- | -------- |
5
+ | default | | |
package/docs/generated-docs/maz-sidebar-trigger.doc.md ADDED
@@ -0,0 +1,5 @@
1
+ ## Slots
2
+
3
+ | Name | Description | Bindings |
4
+ | ------- | ----------- | -------- |
5
+ | default | | |
package/docs/generated-docs/maz-sidebar.doc.md ADDED
@@ -0,0 +1,36 @@
1
+ ## Props
2
+
3
+ | Name | Description | Type | Required | Default |
4
+ | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | -------- | ------------------ |
5
+ | **id** | Unique identifier for the sidebar (auto-generated if not provided) | `string` | No | `undefined` |
6
+ | **open** | Whether the sidebar is open | `boolean` | No | `undefined` |
7
+ | **side** | Side of the sidebar | `"start" \| "end"` | No | `undefined` |
8
+ | **collapsible** | How the sidebar collapses - offcanvas: completely hidden - icon: only icons visible - hover: only icons visible by default, expands on mouse hover or keyboard focus (transient visual state — does not update `v-model:open` nor the persistence cookie) - none: always fully visible | `"offcanvas" \| "icon" \| "hover" \| "none"` | No | `undefined` |
9
+ | **mode** | How the sidebar affects layout - push: sidebar is in document flow - overlay: sidebar floats over content with a backdrop | `"push" \| "overlay"` | No | `undefined` |
10
+ | **width** | Width of the expanded sidebar | `string` | No | `undefined` |
11
+ | **icon-width** | Width of the collapsed sidebar in icon mode | `string` | No | `undefined` |
12
+ | **tooltip-mode** | When descendant `MazSidebarMenuButton` components should display their tooltip. - `always`: tooltip shows on hover regardless of the sidebar state - `closed`: tooltip only shows on hover when the sidebar is collapsed Individual buttons can override this via their own `tooltipMode` prop. | `MazSidebarTooltipMode` | No | `closed` |
13
+ | **persist** | Persist the open/collapsed state in a cookie so it survives reloads. Restoration happens on client mount (SSR-safe). For zero-flash SSR, read the cookie server-side and forward it via `v-model:open`. | `boolean` | No | `true` |
14
+ | **persist-key** | Cookie key used when `persist` is enabled. Set a unique key per sidebar instance if you mount several sidebars on the same site. | `string` | No | `maz-sidebar-open` |
15
+
16
+ ## Events
17
+
18
+ | Event name | Properties | Description |
19
+ | ----------- | ---------- | ------------------------------- |
20
+ | update:open | | Emitted when open state changes |
21
+
22
+ ## Slots
23
+
24
+ | Name | Description | Bindings |
25
+ | ------- | ----------- | -------- |
26
+ | default | | |
27
+
28
+ ## Expose
29
+
30
+ ### toggle
31
+
32
+ >
33
+
34
+ ### setOpen
35
+
36
+ >
package/docs/generated-docs/maz-slider.doc.md CHANGED
@@ -7,7 +7,7 @@
7
7
  | **min** | min value of sliders | `number` | No |
8
8
  | **max** | max value of sliders | `number` | No |
9
9
  | **step** | step value for slider increments | `number` | No |
10
- | **size** | height size of slider bar | `string` | No |
10
+ | **size** | height size of slider bar | `MazSizeUnit` | No |
11
11
  | **divider** | remove div in different colors | `boolean` | No |
12
12
  | **log** | become a logarithmic slider (exponential) | `boolean` | No |
13
13
  | **color** | main slider color | `MazColor` | No |
package/docs/generated-docs/maz-spinner.doc.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | --------- | ------------------------ | ---------- | -------- | ------- |
5
- | **size** | The size of the spinner | `string` | No | `2em` |
6
- | **color** | The color of the spinner | `MazColor` | No | `theme` |
3
+ | Name | Description | Type | Required | Default |
4
+ | --------- | ------------------------ | ------------- | -------- | ------- |
5
+ | **size** | The size of the spinner | `MazSizeUnit` | No | `2em` |
6
+ | **color** | The color of the spinner | `MazColor` | No | `theme` |
package/docs/generated-docs/maz-switch.doc.md CHANGED
@@ -1,19 +1,19 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | --------------- | -------------------------------------------- | ------------- | -------- | ----------- |
5
- | **style** | Style attribut of the component root element | `Native type` | No | `undefined` |
6
- | **class** | Class attribut of the component root element | `Native type` | No | `undefined` |
7
- | **model-value** | The model value of the switch | `boolean` | No | `false` |
8
- | **id** | The id of the switch | `string` | No | `undefined` |
9
- | **disabled** | If the switch is disabled | `boolean` | No | `false` |
10
- | **name** | The name of the switch | `string` | No | `undefined` |
11
- | **label** | Text label | `string` | No | `undefined` |
12
- | **color** | The color of the switch | `MazColor` | No | `'primary'` |
13
- | **error** | Whether there is an error with the input. | `boolean` | No | `undefined` |
14
- | **success** | Whether the input is successful. | `boolean` | No | `undefined` |
15
- | **warning** | Whether there is a warning with the input. | `boolean` | No | `undefined` |
16
- | **hint** | The hint text to display below the input. | `string` | No | `undefined` |
3
+ | Name | Description | Type | Required |
4
+ | --------------- | -------------------------------------------- | ------------- | -------- |
5
+ | **style** | Style attribut of the component root element | `Native type` | No |
6
+ | **class** | Class attribut of the component root element | `Native type` | No |
7
+ | **model-value** | The model value of the switch | `boolean` | No |
8
+ | **id** | The id of the switch | `string` | No |
9
+ | **disabled** | If the switch is disabled | `boolean` | No |
10
+ | **name** | The name of the switch | `string` | No |
11
+ | **label** | Text label | `string` | No |
12
+ | **color** | The color of the switch | `MazColor` | No |
13
+ | **error** | Whether there is an error with the input. | `boolean` | No |
14
+ | **success** | Whether the input is successful. | `boolean` | No |
15
+ | **warning** | Whether there is a warning with the input. | `boolean` | No |
16
+ | **hint** | The hint text to display below the input. | `string` | No |
17
17
 
18
18
  ## Events
19
19