@maz-ui/mcp 5.0.0-beta.5 → 5.0.0-beta.51

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 (164) 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 +30 -30
  6. package/docs/generated-docs/maz-bottom-sheet.doc.md +16 -13
  7. package/docs/generated-docs/maz-btn.doc.md +21 -19
  8. package/docs/generated-docs/maz-checkbox.doc.md +16 -17
  9. package/docs/generated-docs/maz-circular-progress-bar.doc.md +1 -1
  10. package/docs/generated-docs/maz-code-highlight.doc.md +11 -0
  11. package/docs/generated-docs/maz-container.doc.md +1 -0
  12. package/docs/generated-docs/maz-date-picker.doc.md +41 -41
  13. package/docs/generated-docs/maz-drawer.doc.md +7 -8
  14. package/docs/generated-docs/maz-dropdown.doc.md +3 -0
  15. package/docs/generated-docs/maz-expand-animation.doc.md +4 -4
  16. package/docs/generated-docs/maz-fullscreen-loader.doc.md +5 -5
  17. package/docs/generated-docs/maz-gallery.doc.md +15 -15
  18. package/docs/generated-docs/maz-input-code.doc.md +16 -16
  19. package/docs/generated-docs/maz-input-phone-number.doc.md +43 -42
  20. package/docs/generated-docs/maz-input-price.doc.md +14 -14
  21. package/docs/generated-docs/maz-input-tags.doc.md +16 -16
  22. package/docs/generated-docs/maz-input.doc.md +33 -33
  23. package/docs/generated-docs/maz-lazy-img.doc.md +14 -14
  24. package/docs/generated-docs/maz-loading-bar.doc.md +4 -4
  25. package/docs/generated-docs/maz-markdown-editor.doc.md +65 -0
  26. package/docs/generated-docs/maz-popover.doc.md +1 -1
  27. package/docs/generated-docs/maz-pull-to-refresh.doc.md +39 -20
  28. package/docs/generated-docs/maz-radio-buttons.doc.md +17 -17
  29. package/docs/generated-docs/maz-radio.doc.md +16 -16
  30. package/docs/generated-docs/maz-reading-progress-bar.doc.md +4 -4
  31. package/docs/generated-docs/maz-select-country.doc.md +27 -26
  32. package/docs/generated-docs/maz-sidebar-content.doc.md +5 -0
  33. package/docs/generated-docs/maz-sidebar-footer.doc.md +5 -0
  34. package/docs/generated-docs/maz-sidebar-group.doc.md +11 -0
  35. package/docs/generated-docs/maz-sidebar-header.doc.md +5 -0
  36. package/docs/generated-docs/maz-sidebar-menu-button.doc.md +27 -0
  37. package/docs/generated-docs/maz-sidebar-menu-item.doc.md +5 -0
  38. package/docs/generated-docs/maz-sidebar-menu-sub.doc.md +16 -0
  39. package/docs/generated-docs/maz-sidebar-menu.doc.md +5 -0
  40. package/docs/generated-docs/maz-sidebar-separator.doc.md +0 -0
  41. package/docs/generated-docs/maz-sidebar-trigger.doc.md +5 -0
  42. package/docs/generated-docs/maz-sidebar.doc.md +36 -0
  43. package/docs/generated-docs/maz-slider.doc.md +1 -1
  44. package/docs/generated-docs/maz-spinner.doc.md +4 -4
  45. package/docs/generated-docs/maz-switch.doc.md +14 -14
  46. package/docs/generated-docs/maz-table-virtualizer.doc.md +20 -0
  47. package/docs/generated-docs/maz-table.doc.md +43 -37
  48. package/docs/generated-docs/maz-tabs-bar.doc.md +20 -9
  49. package/docs/generated-docs/maz-tabs.doc.md +6 -3
  50. package/docs/generated-docs/maz-textarea.doc.md +27 -25
  51. package/docs/generated-docs/maz-ticker.doc.md +1 -1
  52. package/docs/generated-docs/maz-timeline.doc.md +4 -4
  53. package/docs/generated-docs/maz-window-mockup.doc.md +23 -0
  54. package/docs/src/blog/v4.md +1 -1
  55. package/docs/src/blog/v5.md +5 -7
  56. package/docs/src/components/maz-avatar.md +52 -4
  57. package/docs/src/components/maz-bottom-sheet.md +300 -169
  58. package/docs/src/components/maz-btn.md +1 -1
  59. package/docs/src/components/maz-checklist.md +10 -10
  60. package/docs/src/components/maz-code-highlight.md +233 -0
  61. package/docs/src/components/maz-date-picker.md +55 -1
  62. package/docs/src/components/maz-dialog.md +46 -0
  63. package/docs/src/components/maz-dropdown.md +32 -16
  64. package/docs/src/components/maz-icon.md +16 -5
  65. package/docs/src/components/maz-input-phone-number.md +30 -0
  66. package/docs/src/components/maz-lazy-img.md +64 -0
  67. package/docs/src/components/maz-markdown-editor.md +369 -0
  68. package/docs/src/components/maz-pull-to-refresh.md +176 -17
  69. package/docs/src/components/maz-select-country.md +138 -1
  70. package/docs/src/components/maz-sidebar.md +719 -0
  71. package/docs/src/components/maz-table.md +156 -1
  72. package/docs/src/components/maz-tabs.md +110 -3
  73. package/docs/src/components/maz-textarea.md +58 -0
  74. package/docs/src/components/maz-timeline.md +60 -0
  75. package/docs/src/components/maz-window-mockup.md +249 -0
  76. package/docs/src/composables/use-drag.md +239 -0
  77. package/docs/src/composables/use-form-validator.md +297 -16
  78. package/docs/src/composables/use-pull-to-refresh.md +79 -0
  79. package/docs/src/composables/use-swipe.md +26 -11
  80. package/docs/src/directives/click-outside.md +8 -15
  81. package/docs/src/directives/fullscreen-img.md +1 -1
  82. package/docs/src/directives/lazy-img.md +44 -11
  83. package/docs/src/directives/tooltip.md +24 -1
  84. package/docs/src/directives/zoom-img.md +1 -1
  85. package/docs/src/ecosystem/eslint-config.md +95 -1
  86. package/docs/src/{guide/icons.md → ecosystem/icons/index.md} +1 -1
  87. package/docs/src/ecosystem/node/exec-promise.md +87 -0
  88. package/docs/src/ecosystem/node/index.md +53 -0
  89. package/docs/src/ecosystem/node/logger.md +146 -0
  90. package/docs/src/ecosystem/node/print-banner.md +93 -0
  91. package/docs/src/{guide → ecosystem}/nuxt.md +102 -47
  92. package/docs/src/{guide → ecosystem}/themes.md +152 -71
  93. package/docs/src/{guide → ecosystem}/translations.md +1 -1
  94. package/docs/src/ecosystem/utils/camel-case.md +31 -0
  95. package/docs/src/{helpers → ecosystem/utils}/capitalize.md +2 -3
  96. package/docs/src/ecosystem/utils/check-availability.md +79 -0
  97. package/docs/src/ecosystem/utils/cookie.md +80 -0
  98. package/docs/src/ecosystem/utils/debounce-callback.md +38 -0
  99. package/docs/src/ecosystem/utils/debounce-id.md +69 -0
  100. package/docs/src/ecosystem/utils/debounce.md +65 -0
  101. package/docs/src/ecosystem/utils/fetch-locale-ip.md +33 -0
  102. package/docs/src/ecosystem/utils/format-json.md +33 -0
  103. package/docs/src/ecosystem/utils/format-phone-number.md +37 -0
  104. package/docs/src/ecosystem/utils/get-browser-locale.md +29 -0
  105. package/docs/src/ecosystem/utils/get-error-message.md +39 -0
  106. package/docs/src/ecosystem/utils/idle-timeout.md +90 -0
  107. package/docs/src/ecosystem/utils/index.md +60 -0
  108. package/docs/src/ecosystem/utils/is-client.md +32 -0
  109. package/docs/src/ecosystem/utils/is-equal.md +38 -0
  110. package/docs/src/ecosystem/utils/is-server.md +31 -0
  111. package/docs/src/ecosystem/utils/is-standalone-mode.md +43 -0
  112. package/docs/src/ecosystem/utils/kebab-case.md +36 -0
  113. package/docs/src/ecosystem/utils/normalize-string.md +77 -0
  114. package/docs/src/ecosystem/utils/pascal-case.md +35 -0
  115. package/docs/src/ecosystem/utils/script-loader.md +77 -0
  116. package/docs/src/ecosystem/utils/sleep.md +59 -0
  117. package/docs/src/ecosystem/utils/snake-case.md +36 -0
  118. package/docs/src/ecosystem/utils/swipe-handler.md +91 -0
  119. package/docs/src/ecosystem/utils/textarea-autogrow.md +41 -0
  120. package/docs/src/ecosystem/utils/throttle-id.md +48 -0
  121. package/docs/src/ecosystem/utils/throttle.md +57 -0
  122. package/docs/src/ecosystem/utils/truthy-filter.md +31 -0
  123. package/docs/src/ecosystem/utils/types/deep-key-of.md +48 -0
  124. package/docs/src/ecosystem/utils/types/deep-partial.md +42 -0
  125. package/docs/src/ecosystem/utils/types/deep-required.md +39 -0
  126. package/docs/src/ecosystem/utils/types/flatten-object-keys.md +44 -0
  127. package/docs/src/ecosystem/utils/types/generic-instance-type.md +42 -0
  128. package/docs/src/ecosystem/utils/types/infer-maybe-ref.md +35 -0
  129. package/docs/src/ecosystem/utils/upper-first.md +32 -0
  130. package/docs/src/ecosystem/utils/user-visibility.md +69 -0
  131. package/docs/src/guide/getting-started.md +15 -13
  132. package/docs/src/guide/global-defaults.md +102 -0
  133. package/docs/src/guide/maz-ui-provider.md +6 -3
  134. package/docs/src/guide/migration-v4.md +13 -9
  135. package/docs/src/guide/migration-v5.md +211 -15
  136. package/docs/src/guide/resolvers.md +8 -8
  137. package/docs/src/guide/tailwind.md +4 -0
  138. package/docs/src/guide/vue.md +4 -4
  139. package/docs/src/index.md +13 -13
  140. package/docs/src/plugins/aos.md +1 -1
  141. package/package.json +11 -10
  142. package/docs/src/helpers/camel-case.md +0 -14
  143. package/docs/src/helpers/check-availability.md +0 -14
  144. package/docs/src/helpers/debounce-callback.md +0 -14
  145. package/docs/src/helpers/debounce-id.md +0 -14
  146. package/docs/src/helpers/debounce.md +0 -14
  147. package/docs/src/helpers/is-client.md +0 -14
  148. package/docs/src/helpers/is-equal.md +0 -14
  149. package/docs/src/helpers/is-standalone-mode.md +0 -14
  150. package/docs/src/helpers/kebab-case.md +0 -14
  151. package/docs/src/helpers/normalize-string.md +0 -14
  152. package/docs/src/helpers/pascal-case.md +0 -14
  153. package/docs/src/helpers/script-loader.md +0 -14
  154. package/docs/src/helpers/sleep.md +0 -14
  155. package/docs/src/helpers/snake-case.md +0 -14
  156. package/docs/src/helpers/throttle-id.md +0 -14
  157. package/docs/src/helpers/throttle.md +0 -14
  158. /package/docs/src/{guide → ecosystem/icons}/icon-set.md +0 -0
  159. /package/docs/src/{guide → ecosystem}/mcp.md +0 -0
  160. /package/docs/src/{helpers → ecosystem/utils}/country-code-to-unicode-flag.md +0 -0
  161. /package/docs/src/{helpers → ecosystem/utils}/currency.md +0 -0
  162. /package/docs/src/{helpers → ecosystem/utils}/date.md +0 -0
  163. /package/docs/src/{helpers → ecosystem/utils}/get-country-flag-url.md +0 -0
  164. /package/docs/src/{helpers → ecosystem/utils}/number.md +0 -0
package/docs/generated-docs/maz-markdown-editor.doc.md ADDED
@@ -0,0 +1,65 @@
1
+ ## Props
2
+
3
+ | Name | Description | Type | Required | Default |
4
+ | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | -------- | ----------- |
5
+ | **style** | Style attribute of the component root element | `Native type` | No | `undefined` |
6
+ | **class** | Class attribute of the component root element | `Native type` | No | `undefined` |
7
+ | **model-value** | `v-model` <br/> | `string` | No | `undefined` |
8
+ | **id** | The id of the textarea | `string` | No | `undefined` |
9
+ | **name** | The name of the textarea | `string` | No | `undefined` |
10
+ | **label** | Static label displayed above the editor | `string` | No | `undefined` |
11
+ | **placeholder** | The placeholder of the textarea | `string` | No | `undefined` |
12
+ | **required** | If the editor is required | `boolean` | No | `undefined` |
13
+ | **disabled** | If the editor is disabled | `boolean` | No | `undefined` |
14
+ | **readonly** | If the editor is readonly | `boolean` | No | `undefined` |
15
+ | **error** | If the editor has an error | `boolean` | No | `undefined` |
16
+ | **success** | If the editor has a success | `boolean` | No | `undefined` |
17
+ | **warning** | If the editor has a warning | `boolean` | No | `undefined` |
18
+ | **color** | The color of the editor | `MazColor` | No | `undefined` |
19
+ | **rounded-size** | Size radius of the component's border | `MazRoundedSize` | No | `md` |
20
+ | **top-label** | Static label displayed above the editor. Unlike a floating label, this remains fixed | `string` | No | `undefined` |
21
+ | **assistive-text** | Helper text displayed below the editor to provide additional context or validation feedback<br/>**Example:** `"Markdown is supported"` | `string` | No | `undefined` |
22
+ | **toolbar** | Show the formatting toolbar. Pass `true` for the full toolbar, or an ordered array of action keys to display only a subset (and control their order). | `boolean \| MazMarkdownEditorToolbarAction[]` | No | `false` |
23
+ | **line-numbers** | Display line numbers in a gutter on the left of the editor | `boolean` | No | `false` |
24
+ | **shortcuts** | Enable keyboard shortcuts for the toolbar actions (e.g. Cmd/Ctrl+B for bold). | `boolean` | No | `true` |
25
+ | **sanitize** | Sanitize the rendered preview HTML with DOMPurify | `boolean` | No | `true` |
26
+ | **render-function** | Custom markdown renderer. Receives the raw markdown and returns an HTML string (sync or async). Falls back to `marked` when omitted. The result is still sanitized when `sanitize` is enabled. | `TSFunctionType` | No | `undefined` |
27
+ | **marked-options** | Options forwarded to `marked` when using the default renderer | `Record` | No | `undefined` |
28
+ | **rows** | Minimum number of visible rows of the editor textarea | `number` | No | `6` |
29
+ | **translations** | Custom translations for the component. Override any key independently. | `DeepPartial<MazUiTranslationsNestedSchema['markdownEditor']>` | No | `undefined` |
30
+
31
+ ## Events
32
+
33
+ | Event name | Properties | Description |
34
+ | ------------------ | ---------------------------------------------------- | --------------------------------------- |
35
+ | update:model-value | **value** `string \| undefined` - The markdown value | Emitted when the markdown value changes |
36
+ | input | **value** `string \| undefined` - The markdown value | Emitted when the markdown value changes |
37
+ | focus | **event** `FocusEvent` - The focus event | Emitted when the textarea is focused |
38
+ | blur | **event** `FocusEvent` - The blur event | Emitted when the textarea is blurred |
39
+ | change | **event** `Event` - The change event | Emitted when the textarea value changes |
40
+
41
+ ## Slots
42
+
43
+ | Name | Description | Bindings |
44
+ | ------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
45
+ | label | Replace the static label displayed above the editor | |
46
+ | toolbar | Replace the toolbar content (only rendered when the toolbar is enabled and not in preview mode) | **mode** `MazMarkdownEditorMode` - The current editor mode<br/>**wrap-selection** `Function` - Wrap the current selection with the given markers<br/>**prefix-lines** `Function` - Prefix every selected line with the given string<br/>**apply-heading** `Function` - Apply a heading of the given level to the selected lines<br/>**insert-link** `Function` - Insert a markdown link at the selection<br/>**insert-image** `Function` - Insert a markdown image at the selection<br/>**insert-code-block** `Function` - Insert a fenced code block at the selection<br/>**insert-table** `Function` - Insert a markdown table at the selection |
47
+ | empty-preview | Content displayed in the preview pane when there is nothing to render | |
48
+
49
+ ## Expose
50
+
51
+ ### textarea
52
+
53
+ > The underlying textarea element
54
+
55
+ ### mode
56
+
57
+ > The current editor mode (write / preview / split)
58
+
59
+ ### renderPreview
60
+
61
+ > Programmatically re-render the markdown preview
62
+
63
+ ### focus
64
+
65
+ > Focus the editor textarea
package/docs/generated-docs/maz-popover.doc.md CHANGED
@@ -14,7 +14,7 @@
14
14
  | **offset** | Distance between trigger and popover in pixels | `number` | No | `8` | - |
15
15
  | **delay** | Delay before showing/hiding in milliseconds | `number` | No | `0` | - |
16
16
  | **hover-delay** | Delay before closing on hover in milliseconds | `number` | No | `150` | - |
17
- | **transition** | CSS transition name for animations | `"scale-pop" \| "scale-fade" \| string` | No | `popover` | - |
17
+ | **transition** | **CSS transition name for animations** <br/> <br/>'scale-pop' \| 'scale-fade' for default transitions. 'scale-pop' is a pop effect, 'scale-fade' is a fade effect.<br/> | `"scale-pop" \| "scale-fade" \| string` | No | `scale-pop` | `scale-pop' \| 'scale-fade' \| string` |
18
18
  | **teleport-to** | Teleport target selector | `string` | No | `body` | - |
19
19
  | **overlay-class** | Additional CSS classes for the overlay wrapper | `Native type` | No | `undefined` | - |
20
20
  | **panel-class** | Additional CSS classes for the popover panel | `Native type` | No | `undefined` | - |
package/docs/generated-docs/maz-pull-to-refresh.doc.md CHANGED
@@ -1,31 +1,50 @@
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 | Default |
4
+ | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | -------- | ---------------------------------------- |
5
+ | **on-refresh** | Function called when the user releases after pulling far enough. The spinner stays visible until the returned promise settles. Without it, the component does nothing. | `TSFunctionType` | No | `undefined` |
6
+ | **distance** | Pull distance (in px, after resistance) required to trigger a refresh | `number` | No | `80` |
7
+ | **max-distance** | Maximum pull distance (in px), reached with a rubber band effect beyond `distance` | `number` | No | `distance * 1.6` |
8
+ | **resistance** | Ratio between the finger movement and the pull distance, between 0 and 1. Lower is stiffer. | `number` | No | `0.5` |
9
+ | **min-duration** | Minimum duration (in ms) of the refreshing state, so the feedback stays visible on fast refreshes | `number` | No | `400` |
10
+ | **container-selector** | CSS selector of the scroll container. By default, the closest scrollable ancestor of the component, or the window. The pull only starts when this container is scrolled to the top. | `string` | No | `undefined` |
11
+ | **header-class** | Class of the header that holds the indicator | `Native type` | No | `undefined` |
12
+ | **spinner-color** | Color of the progress ring and the spinner | `MazColor` | No | `primary` |
13
+ | **disabled** | Disable the pull to refresh | `boolean` | No | `false` |
14
+ | **standalone-mode** | Only enable the pull to refresh when the app runs as an installed PWA (standalone display mode), browsers already provide their own pull to refresh | `boolean` | No | `false` |
15
+ | **haptic** | Vibrate briefly when the pull reaches `distance` (devices supporting `navigator.vibrate`) | `boolean` | No | `true` |
16
+ | **translations** | Translations of the pull to refresh | `DeepPartial<MazUiTranslationsNestedSchema['pullToRefresh']>` | No | `Translations from @maz-ui/translations` |
17
+ | **offset** | | `number` | No | `undefined` |
13
18
 
14
19
  ## Events
15
20
 
16
- | Event name | Properties | Description |
17
- | ---------- | ---------- | ----------- |
18
- | loaded | |
19
- | start | |
20
- | error | |
21
- | finish | |
22
- | response | |
21
+ | Event name | Properties | Description |
22
+ | ---------- | ---------- | -------------------------------------------------------- |
23
+ | start | | Emitted when the refresh starts |
24
+ | loaded | | Emitted when `onRefresh` resolved |
25
+ | response | | Emitted with the value resolved by `onRefresh` |
26
+ | error | | Emitted when `onRefresh` threw or rejected |
27
+ | finish | | Emitted when the refresh ends, after `loaded` or `error` |
23
28
 
24
29
  ## Slots
25
30
 
26
31
  | Name | Description | Bindings |
27
32
  | ------------ | ----------- | -------- |
28
- | pull-before | | |
29
- | pull-ready | | |
30
- | pull-loading | | |
33
+ | pull-loading | | <br/> |
34
+ | pull-ready | | <br/> |
35
+ | pull-before | | <br/> |
31
36
  | default | | |
37
+
38
+ ## Expose
39
+
40
+ ### refresh
41
+
42
+ > Run the refresh programmatically (a "refresh" button for keyboard and mouse users)
43
+
44
+ ### isRefreshing
45
+
46
+ > `onRefresh` is running
47
+
48
+ ### progress
49
+
50
+ > Pull progress towards `distance`, from 0 to 1
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-select-country.doc.md CHANGED
@@ -1,31 +1,32 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default | Possible values |
4
- | ------------------------- | -------------------------------------------- | --------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------- | ------------------------------------ |
5
- | **style** | Style attribut of the component root element | `HTMLAttributes['style']` | No | `undefined` | - |
6
- | **class** | Class attribut of the component root element | `HTMLAttributes['class']` | No | `undefined` | - |
7
- | **id** | Id of the component | `string` | No | `undefined` | - |
8
- | **color** | Color of the component | `MazColor` | No | `primary` | - |
9
- | **size** | Size of the component | `MazSize` | No | `md` | - |
10
- | **preferred-codes** | Preferred countries to display | `Option['code'][]` | No | `undefined` | - |
11
- | **ignored-codes** | Ignored countries to display | `Option['code'][]` | No | `undefined` | - |
12
- | **only-codes** | Only countries to display | `Option['code'][]` | No | `undefined` | - |
13
- | **list-position** | Position of the list | `MazPopoverProps['position']` | No | `auto` | - |
14
- | **hide-flags** | Hide flags | `boolean` | No | `undefined` | - |
15
- | **search** | Display search input in options list | `boolean` | No | `true` | - |
16
- | **show-code-in-list** | Show code on list | `boolean` | No | `false` | - |
17
- | **locale** | Locale | `string` | No | `locale defined within the maz-ui plugin or browser locale or en-US` | - |
18
- | **success** | Success state | `boolean` | No | `undefined` | - |
19
- | **error** | Error state | `boolean` | No | `undefined` | - |
20
- | **warning** | Warning state | `boolean` | No | `undefined` | - |
21
- | **display-code** | | `boolean` | No | `undefined` | - |
22
- | **search-threshold** | Search threshold | `number` | No | `undefined` | - |
23
- | **translations** | Translations | `Partial<MazUiTranslationsNestedSchema['selectCountry']>` | No | `MazUiTranslationsNestedSchema['selectCountry']` | - |
24
- | **hint** | Hint message displayed | `string` | No | `undefined` | - |
25
- | **options** | Options | `Option[]` | No | `undefined` | - |
26
- | **display-names-options** | Display name type | `Intl.DisplayNamesOptions` | No | `{ type: 'region', languageDisplay: 'standard', fallback: 'code', style: 'long' }` | - |
27
- | **codes-type** | Codes type | `CodesType` | No | `defined by displayNamesOptions.type (if 'region', 'country' is used, otherwise 'iso')` | `iso' \| 'bcp' \| 'country' \| 'all` |
28
- | **open** | Open the select | `boolean` | No | `false` | - |
3
+ | Name | Description | Type | Required | Default | Possible values |
4
+ | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------- | ------------------------------------ |
5
+ | **style** | Style attribut of the component root element | `HTMLAttributes['style']` | No | `undefined` | - |
6
+ | **class** | Class attribut of the component root element | `HTMLAttributes['class']` | No | `undefined` | - |
7
+ | **id** | Id of the component | `string` | No | `undefined` | - |
8
+ | **color** | Color of the component | `MazColor` | No | `primary` | - |
9
+ | **size** | Size of the component | `MazSize` | No | `md` | - |
10
+ | **preferred-codes** | Preferred countries to display | `Option['code'][]` | No | `undefined` | - |
11
+ | **ignored-codes** | Ignored countries to display | `Option['code'][]` | No | `undefined` | - |
12
+ | **only-codes** | Only countries to display | `Option['code'][]` | No | `undefined` | - |
13
+ | **list-position** | Position of the list | `MazPopoverProps['position']` | No | `auto` | - |
14
+ | **hide-flags** | Hide flags | `boolean` | No | `undefined` | - |
15
+ | **flag-src** | Source of the flags, instead of the flagcdn.com CDN: - a URL template with the code, `{code}` (lowercase) or `{CODE}` (uppercase): `/flags/{code}.svg` - a function giving the image source of a code (URL or data URL), called when the flag becomes visible, or `undefined` to display the code in a badge Use `loadCountryFlag` from `maz-ui/country-flags` for the flags of `@maz-ui/icons`, without any request to a third party. Can be set for the whole app with the `defaults.global.flagSrc` option of the MazUi plugin. | `MazCountryFlagSrc` | No | `undefined (flags from flagcdn.com)` | - |
16
+ | **search** | Display search input in options list | `boolean` | No | `true` | - |
17
+ | **show-code-in-list** | Show code on list | `boolean` | No | `false` | - |
18
+ | **locale** | Locale | `string` | No | `locale defined within the maz-ui plugin or browser locale or en-US` | - |
19
+ | **success** | Success state | `boolean` | No | `undefined` | - |
20
+ | **error** | Error state | `boolean` | No | `undefined` | - |
21
+ | **warning** | Warning state | `boolean` | No | `undefined` | - |
22
+ | **display-code** | | `boolean` | No | `undefined` | - |
23
+ | **search-threshold** | Search threshold | `number` | No | `undefined` | - |
24
+ | **translations** | Translations | `Partial<MazUiTranslationsNestedSchema['selectCountry']>` | No | `MazUiTranslationsNestedSchema['selectCountry']` | - |
25
+ | **hint** | Hint message displayed | `string` | No | `undefined` | - |
26
+ | **options** | Options | `Option[]` | No | `undefined` | - |
27
+ | **display-names-options** | Display name type | `Intl.DisplayNamesOptions` | No | `{ type: 'region', languageDisplay: 'standard', fallback: 'code', style: 'long' }` | - |
28
+ | **codes-type** | Codes type | `CodesType` | No | `defined by displayNamesOptions.type (if 'region', 'country' is used, otherwise 'iso')` | `iso' \| 'bcp' \| 'country' \| 'all` |
29
+ | **open** | Open the select | `boolean` | No | `false` | - |
29
30
 
30
31
  ## Events
31
32
 
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` |