@maz-ui/mcp 5.0.0-beta.3 → 5.0.0-beta.31

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 (151) 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-btn.doc.md +3 -2
  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-container.doc.md +1 -0
  11. package/docs/generated-docs/maz-date-picker.doc.md +41 -41
  12. package/docs/generated-docs/maz-drawer.doc.md +7 -8
  13. package/docs/generated-docs/maz-dropdown.doc.md +3 -0
  14. package/docs/generated-docs/maz-expand-animation.doc.md +4 -4
  15. package/docs/generated-docs/maz-fullscreen-loader.doc.md +5 -5
  16. package/docs/generated-docs/maz-gallery.doc.md +15 -15
  17. package/docs/generated-docs/maz-input-code.doc.md +16 -16
  18. package/docs/generated-docs/maz-input-phone-number.doc.md +42 -38
  19. package/docs/generated-docs/maz-input-price.doc.md +14 -14
  20. package/docs/generated-docs/maz-input-tags.doc.md +16 -16
  21. package/docs/generated-docs/maz-input.doc.md +33 -33
  22. package/docs/generated-docs/maz-lazy-img.doc.md +14 -14
  23. package/docs/generated-docs/maz-loading-bar.doc.md +4 -4
  24. package/docs/generated-docs/maz-markdown-editor.doc.md +65 -0
  25. package/docs/generated-docs/maz-popover.doc.md +1 -1
  26. package/docs/generated-docs/maz-pull-to-refresh.doc.md +10 -10
  27. package/docs/generated-docs/maz-radio-buttons.doc.md +17 -17
  28. package/docs/generated-docs/maz-radio.doc.md +16 -16
  29. package/docs/generated-docs/maz-reading-progress-bar.doc.md +4 -4
  30. package/docs/generated-docs/maz-sidebar-content.doc.md +5 -0
  31. package/docs/generated-docs/maz-sidebar-footer.doc.md +5 -0
  32. package/docs/generated-docs/maz-sidebar-group.doc.md +11 -0
  33. package/docs/generated-docs/maz-sidebar-header.doc.md +5 -0
  34. package/docs/generated-docs/maz-sidebar-menu-button.doc.md +27 -0
  35. package/docs/generated-docs/maz-sidebar-menu-item.doc.md +5 -0
  36. package/docs/generated-docs/maz-sidebar-menu-sub.doc.md +16 -0
  37. package/docs/generated-docs/maz-sidebar-menu.doc.md +5 -0
  38. package/docs/generated-docs/maz-sidebar-separator.doc.md +0 -0
  39. package/docs/generated-docs/maz-sidebar-trigger.doc.md +5 -0
  40. package/docs/generated-docs/maz-sidebar.doc.md +36 -0
  41. package/docs/generated-docs/maz-slider.doc.md +1 -1
  42. package/docs/generated-docs/maz-spinner.doc.md +4 -4
  43. package/docs/generated-docs/maz-switch.doc.md +14 -14
  44. package/docs/generated-docs/maz-table.doc.md +5 -5
  45. package/docs/generated-docs/maz-textarea.doc.md +25 -24
  46. package/docs/generated-docs/maz-ticker.doc.md +1 -1
  47. package/docs/generated-docs/maz-timeline.doc.md +4 -4
  48. package/docs/generated-docs/maz-window-mockup.doc.md +23 -0
  49. package/docs/src/blog/v4.md +1 -1
  50. package/docs/src/blog/v5.md +5 -7
  51. package/docs/src/components/maz-avatar.md +29 -0
  52. package/docs/src/components/maz-btn.md +1 -1
  53. package/docs/src/components/maz-code-highlight.md +233 -0
  54. package/docs/src/components/maz-container.md +2 -2
  55. package/docs/src/components/maz-date-picker.md +1 -1
  56. package/docs/src/components/maz-dialog.md +46 -0
  57. package/docs/src/components/maz-dropdown.md +32 -16
  58. package/docs/src/components/maz-icon.md +2 -2
  59. package/docs/src/components/maz-input-phone-number.md +106 -103
  60. package/docs/src/components/maz-markdown-editor.md +369 -0
  61. package/docs/src/components/maz-sidebar.md +719 -0
  62. package/docs/src/components/maz-textarea.md +27 -1
  63. package/docs/src/components/maz-timeline.md +60 -0
  64. package/docs/src/components/maz-window-mockup.md +249 -0
  65. package/docs/src/composables/use-form-validator.md +50 -11
  66. package/docs/src/directives/click-outside.md +8 -15
  67. package/docs/src/directives/fullscreen-img.md +1 -1
  68. package/docs/src/directives/lazy-img.md +5 -5
  69. package/docs/src/directives/tooltip.md +24 -1
  70. package/docs/src/directives/zoom-img.md +1 -1
  71. package/docs/src/ecosystem/eslint-config.md +95 -1
  72. package/docs/src/{guide/icons.md → ecosystem/icons/index.md} +1 -1
  73. package/docs/src/ecosystem/node/exec-promise.md +87 -0
  74. package/docs/src/ecosystem/node/index.md +53 -0
  75. package/docs/src/ecosystem/node/logger.md +146 -0
  76. package/docs/src/ecosystem/node/print-banner.md +93 -0
  77. package/docs/src/{guide → ecosystem}/nuxt.md +81 -47
  78. package/docs/src/{guide → ecosystem}/themes.md +153 -72
  79. package/docs/src/{guide → ecosystem}/translations.md +1 -1
  80. package/docs/src/ecosystem/utils/camel-case.md +31 -0
  81. package/docs/src/{helpers → ecosystem/utils}/capitalize.md +2 -3
  82. package/docs/src/ecosystem/utils/check-availability.md +79 -0
  83. package/docs/src/ecosystem/utils/cookie.md +80 -0
  84. package/docs/src/{helpers → ecosystem/utils}/currency.md +2 -2
  85. package/docs/src/{helpers → ecosystem/utils}/date.md +2 -2
  86. package/docs/src/ecosystem/utils/debounce-callback.md +38 -0
  87. package/docs/src/ecosystem/utils/debounce-id.md +69 -0
  88. package/docs/src/ecosystem/utils/debounce.md +65 -0
  89. package/docs/src/ecosystem/utils/fetch-locale-ip.md +33 -0
  90. package/docs/src/ecosystem/utils/format-json.md +33 -0
  91. package/docs/src/ecosystem/utils/format-phone-number.md +37 -0
  92. package/docs/src/ecosystem/utils/get-browser-locale.md +29 -0
  93. package/docs/src/ecosystem/utils/get-error-message.md +39 -0
  94. package/docs/src/ecosystem/utils/idle-timeout.md +90 -0
  95. package/docs/src/ecosystem/utils/index.md +60 -0
  96. package/docs/src/ecosystem/utils/is-client.md +32 -0
  97. package/docs/src/ecosystem/utils/is-equal.md +38 -0
  98. package/docs/src/ecosystem/utils/is-server.md +31 -0
  99. package/docs/src/ecosystem/utils/is-standalone-mode.md +43 -0
  100. package/docs/src/ecosystem/utils/kebab-case.md +36 -0
  101. package/docs/src/ecosystem/utils/normalize-string.md +77 -0
  102. package/docs/src/{helpers → ecosystem/utils}/number.md +2 -2
  103. package/docs/src/ecosystem/utils/pascal-case.md +35 -0
  104. package/docs/src/ecosystem/utils/script-loader.md +77 -0
  105. package/docs/src/ecosystem/utils/sleep.md +59 -0
  106. package/docs/src/ecosystem/utils/snake-case.md +36 -0
  107. package/docs/src/ecosystem/utils/swipe-handler.md +91 -0
  108. package/docs/src/ecosystem/utils/textarea-autogrow.md +41 -0
  109. package/docs/src/ecosystem/utils/throttle-id.md +48 -0
  110. package/docs/src/ecosystem/utils/throttle.md +57 -0
  111. package/docs/src/ecosystem/utils/truthy-filter.md +31 -0
  112. package/docs/src/ecosystem/utils/types/deep-key-of.md +48 -0
  113. package/docs/src/ecosystem/utils/types/deep-partial.md +42 -0
  114. package/docs/src/ecosystem/utils/types/deep-required.md +39 -0
  115. package/docs/src/ecosystem/utils/types/flatten-object-keys.md +44 -0
  116. package/docs/src/ecosystem/utils/types/generic-instance-type.md +42 -0
  117. package/docs/src/ecosystem/utils/types/infer-maybe-ref.md +35 -0
  118. package/docs/src/ecosystem/utils/upper-first.md +32 -0
  119. package/docs/src/ecosystem/utils/user-visibility.md +69 -0
  120. package/docs/src/guide/getting-started.md +15 -13
  121. package/docs/src/guide/global-defaults.md +101 -0
  122. package/docs/src/guide/maz-ui-provider.md +6 -3
  123. package/docs/src/guide/migration-v4.md +13 -9
  124. package/docs/src/guide/migration-v5.md +112 -13
  125. package/docs/src/guide/resolvers.md +7 -7
  126. package/docs/src/guide/tailwind.md +4 -0
  127. package/docs/src/guide/vue.md +4 -4
  128. package/docs/src/index.md +12 -12
  129. package/docs/src/plugins/aos.md +1 -1
  130. package/docs/src/plugins/wait.md +1 -1
  131. package/package.json +8 -7
  132. package/docs/src/helpers/camel-case.md +0 -14
  133. package/docs/src/helpers/check-availability.md +0 -14
  134. package/docs/src/helpers/debounce-callback.md +0 -14
  135. package/docs/src/helpers/debounce-id.md +0 -14
  136. package/docs/src/helpers/debounce.md +0 -14
  137. package/docs/src/helpers/is-client.md +0 -14
  138. package/docs/src/helpers/is-equal.md +0 -14
  139. package/docs/src/helpers/is-standalone-mode.md +0 -14
  140. package/docs/src/helpers/kebab-case.md +0 -14
  141. package/docs/src/helpers/normalize-string.md +0 -14
  142. package/docs/src/helpers/pascal-case.md +0 -14
  143. package/docs/src/helpers/script-loader.md +0 -14
  144. package/docs/src/helpers/sleep.md +0 -14
  145. package/docs/src/helpers/snake-case.md +0 -14
  146. package/docs/src/helpers/throttle-id.md +0 -14
  147. package/docs/src/helpers/throttle.md +0 -14
  148. /package/docs/src/{guide → ecosystem/icons}/icon-set.md +0 -0
  149. /package/docs/src/{guide → ecosystem}/mcp.md +0 -0
  150. /package/docs/src/{helpers → ecosystem/utils}/country-code-to-unicode-flag.md +0 -0
  151. /package/docs/src/{helpers → ecosystem/utils}/get-country-flag-url.md +0 -0
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
 
package/docs/generated-docs/maz-table.doc.md CHANGED
@@ -5,12 +5,12 @@
5
5
  | **table-class** | CSS class of the table element | `HTMLAttributes['class']` | No | `undefined` | - |
6
6
  | **table-style** | CSS style of the table element | `HTMLAttributes['style']` | No | `undefined` | - |
7
7
  | **model-value** | `v-model` <br/>List of selected rows | `(string \| boolean \| number)[]` | No | `undefined` | - |
8
- | **size** | Size of the table | `MazSize` | No | `'md'` | `xl, lg, md, sm, xs, mini` |
8
+ | **size** | Size of the table | `MazSize` | No | `md` | `xl, lg, md, sm, xs, mini` |
9
9
  | **input-size** | Size of the search inputs | `MazSize` | No | `undefined` | `xl, lg, md, sm, xs, mini` |
10
10
  | **title** | Title of the table | `string` | No | `undefined` | - |
11
11
  | **headers** | Headers of the table | `MazTableHeader[]` | No | `undefined` | - |
12
12
  | **sortable** | Enable sort feature on all columns | `boolean` | No | `false` | - |
13
- | **headers-align** | Align all headers | `string` | No | `'left'` | - |
13
+ | **headers-align** | Align all headers | `string` | No | `left` | - |
14
14
  | **rows** | Rows of the table | `T[]` | No | `undefined` | - |
15
15
  | **hoverable** | Add hover effect on rows | `boolean` | No | `false` | - |
16
16
  | **search** | Enable search feature in table header | `boolean` | No | `false` | - |
@@ -22,7 +22,7 @@
22
22
  | **elevation** | Add shadow to the table | `boolean` | No | `false` | - |
23
23
  | **divider** | add divider between rows | `boolean` | No | `false` | - |
24
24
  | **caption** | Caption of the table | `string` | No | `undefined` | - |
25
- | **caption-side** | Caption side | `string` | No | `'bottom'` | `top, bottom` |
25
+ | **caption-side** | Caption side | `string` | No | `bottom` | `top, bottom` |
26
26
  | **pagination** | Add pagination in table footer | `boolean` | No | `false` | - |
27
27
  | **page** | `v-model:page` <br/>Current page of pagination | `number` | No | `1` | - |
28
28
  | **page-size** | `v-model:page-size` <br/>Number of items per page | `number` | No | `20` | - |
@@ -33,9 +33,9 @@
33
33
  | **selectable** | Enable selection of rows | `boolean` | No | `false` | - |
34
34
  | **selected-key** | Enable selection of rows - key of the selected row | `string` | No | `undefined` | - |
35
35
  | **table-layout** | Table layout | `string` | No | `undefined` | `auto, fixed` |
36
- | **color** | Color of the component | `MazColor` | No | `'primary'` | - |
36
+ | **color** | Color of the component | `MazColor` | No | `primary` | - |
37
37
  | **translations** | Translations of the table | `DeepPartial<MazUiTranslationsNestedSchema['table']>` | No | `Translations from @maz-ui/translations` | - |
38
- | **rounded-size** | Size radius of the component's border | `string` | No | `'md'` | `none, sm, md, lg, xl, full` |
38
+ | **rounded-size** | Size radius of the component's border | `MazRoundedSize` | No | `md` | `none, sm, md, lg, xl, full` |
39
39
  | **scrollable** | Enable scrollable on table | `boolean` | No | `false` | - |
40
40
 
41
41
  ## Events
package/docs/generated-docs/maz-textarea.doc.md CHANGED
@@ -1,29 +1,30 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default | Possible values |
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/> | `T` | No | `undefined` | - |
8
- | **id** | The id of the textarea | `string` | No | `undefined` | - |
9
- | **name** | The name of the textarea | `string` | No | `'MazTextarea'` | - |
10
- | **label** | The label of the textarea | `string` | No | `undefined` | - |
11
- | **placeholder** | The placeholder of the textarea | `string` | No | `undefined` | - |
12
- | **required** | If the textarea is required | `boolean` | No | `false` | - |
13
- | **disabled** | If the textarea is disabled | `boolean` | No | `false` | - |
14
- | **readonly** | If the textarea is readonly | `boolean` | No | `false` | - |
15
- | **error** | If the textarea has an error | `boolean` | No | `false` | - |
16
- | **success** | If the textarea has a success | `boolean` | No | `false` | - |
17
- | **warning** | If the textarea has a warning | `boolean` | No | `false` | - |
18
- | **hint** | The hint of the textarea | `string` | No | `undefined` | - |
19
- | **color** | The color of the textarea | `MazColor` | No | `'primary'` | - |
20
- | **rounded-size** | Size radius of the component's border | `"none" \| "sm" \| "md" \| "lg" \| "xl" \| "full"` | No | `'md'` | `'none' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full'` |
21
- | **padding** | If the textarea has a padding | `boolean` | No | `true` | - |
22
- | **transparent** | If the textarea has a transparent background | `boolean` | No | `false` | - |
23
- | **border** | If the textarea has no border | `boolean` | No | `true` | - |
24
- | **autogrow** | If the textarea should autogrow based on its content | `boolean` | No | `true` | - |
25
- | **append-justify** | The alignment of the append slot | `"start" \| "end" \| "center" \| "space-between" \| "space-around" \| "space-evenly"` | No | `'end'` | `'start' \| 'end' \| 'center' \| 'space-between' \| 'space-around' \| 'space-evenly'` |
26
- | **top-label** | Static label displayed above the textarea. Unlike the floating label, this remains fixed | `string` | No | `undefined` | - |
3
+ | Name | Description | Type | Required | Default | Possible values |
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/> | `T` | No | `undefined` | - |
8
+ | **id** | The id of the textarea | `string` | No | `undefined` | - |
9
+ | **name** | The name of the textarea | `string` | No | `undefined` | - |
10
+ | **label** | The label of the textarea | `string` | No | `undefined` | - |
11
+ | **placeholder** | The placeholder of the textarea | `string` | No | `undefined` | - |
12
+ | **required** | If the textarea is required | `boolean` | No | `undefined` | - |
13
+ | **disabled** | If the textarea is disabled | `boolean` | No | `undefined` | - |
14
+ | **readonly** | If the textarea is readonly | `boolean` | No | `undefined` | - |
15
+ | **error** | If the textarea has an error | `boolean` | No | `undefined` | - |
16
+ | **success** | If the textarea has a success | `boolean` | No | `undefined` | - |
17
+ | **warning** | If the textarea has a warning | `boolean` | No | `undefined` | - |
18
+ | **hint** | The hint of the textarea | `string` | No | `undefined` | - |
19
+ | **color** | The color of the textarea | `MazColor` | No | `undefined` | - |
20
+ | **rounded-size** | Size radius of the component's border | `MazRoundedSize` | No | `md` | - |
21
+ | **padding** | If the textarea has a padding | `boolean` | No | `true` | - |
22
+ | **transparent** | If the textarea has a transparent background | `boolean` | No | `false` | - |
23
+ | **border** | If the textarea has no border | `boolean` | No | `false` | - |
24
+ | **autogrow** | If the textarea should autogrow based on its content | `boolean` | No | `true` | - |
25
+ | **append-justify** | The alignment of the append slot | `"start" \| "end" \| "center" \| "space-between" \| "space-around" \| "space-evenly"` | No | `end` | `'start' \| 'end' \| 'center' \| 'space-between' \| 'space-around' \| 'space-evenly'` |
26
+ | **top-label** | Static label displayed above the textarea. Unlike the floating label, this remains fixed | `string` | No | `undefined` | - |
27
+ | **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` | - |
27
28
 
28
29
  ## Events
29
30
 
package/docs/generated-docs/maz-ticker.doc.md CHANGED
@@ -11,7 +11,7 @@
11
11
  | **pause-on-focus** | Pause animation when a child element receives focus | `boolean` | No | `false` | - |
12
12
  | **paused** | Programmatic pause control - takes precedence over pauseOnHover and pauseOnFocus | `boolean` | No | `false` | - |
13
13
  | **overlay** | Show gradient overlays on edges to fade content in/out | `boolean` | No | `true` | - |
14
- | **overlay-size** | Size of the gradient overlay zones (CSS value) | `string` | No | `33%` | - |
14
+ | **overlay-size** | Size of the gradient overlay zones (CSS value) | `MazSizeUnit` | No | `33%` | - |
15
15
  | **animation-timing-function** | CSS animation timing function | `string` | No | `linear` | - |
16
16
 
17
17
  ## Slots
package/docs/generated-docs/maz-timeline.doc.md CHANGED
@@ -16,10 +16,10 @@
16
16
 
17
17
  ## Events
18
18
 
19
- | Event name | Properties | Description |
20
- | ----------------- | ------------------------------------------------- | ---------------------------------------- |
21
- | update:modelValue | **value** `mixed` - The new active step index | Emitted when the active step changes |
22
- | click-step | **payload** `mixed` - The step data and its index | Emitted when a clickable step is clicked |
19
+ | Event name | Properties | Description |
20
+ | ------------------ | ------------------------------------------------- | ---------------------------------------- |
21
+ | update:model-value | **value** `mixed` - The new active step index | Emitted when the active step changes |
22
+ | click-step | **payload** `mixed` - The step data and its index | Emitted when a clickable step is clicked |
23
23
 
24
24
  ## Slots
25
25
 
package/docs/generated-docs/maz-window-mockup.doc.md ADDED
@@ -0,0 +1,23 @@
1
+ ## Props
2
+
3
+ | Name | Description | Type | Required | Default | Possible values |
4
+ | ----------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | -------- | ----------- | ----------------------------------- |
5
+ | **id** | Stable id used to scope the empty-state SVG pattern. Auto-generated if not provided. | `string` | No | `undefined` | - |
6
+ | **variant** | Window style variant | `MazWindowMockupVariant` | No | `browser` | `browser' \| 'terminal' \| 'editor` |
7
+ | **url** | URL to display in the browser address bar (browser variant only) | `string` | No | `localhost` | - |
8
+ | **filename** | Filename to display in the editor tab (editor variant only) | `string` | No | `index.vue` | - |
9
+ | **title** | Title to display in the terminal title bar (terminal variant only) | `string` | No | `zsh` | - |
10
+ | **min-height** | Minimum height of the content area as a CSS value (e.g. '200px') | `string` | No | `undefined` | - |
11
+ | **code** | Source code to display using MazCodeHighlight. Takes priority over the default slot. | `string` | No | `undefined` | - |
12
+ | **language** | Language identifier for syntax highlighting (e.g. 'vue', 'ts', 'bash') | `string` | No | `undefined` | - |
13
+ | **label** | Label displayed inside the empty-state placeholder when no code and no slot content are provided. | `string` | No | `undefined` | - |
14
+ | **hide-prompt** | Whether to hide the terminal prompt prefix (no-op on non-terminal variants) | `boolean` | No | `false` | - |
15
+ | **prompt** | Prefix to display before the code in the terminal (terminal variant only) | `string` | No | `$` | - |
16
+ | **hide-url-copy** | Hide the copy-to-clipboard button next to the URL bar (browser variant only). | `boolean` | No | `false` | - |
17
+ | **translations** | Custom translations for the component. Override either key independently. | `Partial<MazUiTranslationsNestedSchema['windowMockup']>` | No | `undefined` | - |
18
+
19
+ ## Slots
20
+
21
+ | Name | Description | Bindings |
22
+ | ------- | ---------------------------------------------------------------------- | -------- |
23
+ | default | Free content (image, interface, etc.) shown when code prop is not set. | |
package/docs/src/blog/v4.md CHANGED
@@ -236,7 +236,7 @@ export default defineNuxtConfig({
236
236
  To help with migration from v3 to v4:
237
237
 
238
238
  - **[Complete Migration Guide](../guide/migration-v4.md)** - Step-by-step migration instructions
239
- - **[MCP Integration](../guide/mcp.md)** - Connect AI agents for migration assistance
239
+ - **[MCP Integration](../ecosystem/mcp.md)** - Connect AI agents for migration assistance
240
240
  - **[Interactive Examples](../index.md)** - Live demonstrations of new features
241
241
  - **[Community Support](https://github.com/LouisMazel/maz-ui/discussions)** - Get help from the community
242
242
 
package/docs/src/blog/v5.md CHANGED
@@ -90,22 +90,20 @@ npx @maz-ui/upgrade ./ --dry-run
90
90
  npx @maz-ui/upgrade ./
91
91
  ```
92
92
 
93
- It rewrites the mechanical part: CSS subpath imports, `left-icon`/`right-icon` → `start-icon`/`end-icon` (props, slots, classes), `footer-align` / `variant` direction values, `color="background"` → `color="surface"`, `rounded-size="base"` → `rounded-size="md"`, `--maz-background` / `--maz-border` CSS vars, `hsl(var(--maz-X))` collapse, Nuxt `injectMainCss` → `injectCss`, theme `strategy: 'hybrid'` → `'runtime'`, dropped theme options, and `colors.{light,dark}.background` / `.border` keys in custom presets. It also bumps every `maz-ui` / `@maz-ui/*` entry in your `package.json` files to `^5.0.0` and runs the right `pnpm`/`yarn`/`bun`/`npm install` for you.
94
-
95
- It respects your `.gitignore`, walks `.vue`/`.css`/`.ts`/`.tsx`/`.cts`/`.mts`/`.js`/`.jsx`/`.cjs`/`.mjs` and `package.json`, and skips the usual build dirs.
93
+ It handles the mechanical part of the migration (CSS subpath imports, prop renames, CSS var renames, Nuxt config keys, custom preset color keys, and `package.json` version bumps)
96
94
 
97
95
  ### `@maz-ui/mcp` — for everything else
98
96
 
99
97
  A few changes need a human eye: `MazIcon` API (needs your original asset paths), `MazBadge` numeric size mapping, `foundation.radius` → `scales.rounded.md` reshape, and `MazChart` `update-mode` default.
100
98
 
101
- The [`@maz-ui/mcp`](/guide/mcp) server exposes the migration guide and every other Maz-UI doc to your AI assistant. Connect it once, then walk the guide section by section against your codebase — there's a [step-by-step flow](/guide/migration-v5#migrate-with-the-maz-ui-mcp-server) ready to copy-paste.
99
+ The [`@maz-ui/mcp`](/ecosystem/mcp) server exposes the migration guide and every other Maz-UI doc to your AI assistant. Connect it once, then walk the guide section by section against your codebase — there's a [step-by-step flow](/guide/migration-v5#migrate-with-the-maz-ui-mcp-server) ready to copy-paste.
102
100
 
103
101
  ```bash
104
102
  # Claude Code
105
103
  claude mcp add maz-ui npx @maz-ui/mcp --scope project
106
104
  ```
107
105
 
108
- Cursor, Windsurf, VS Code Copilot, Cline and Claude Desktop are all in the [MCP guide](/guide/mcp).
106
+ Cursor, Windsurf, VS Code Copilot, Cline and Claude Desktop are all in the [MCP guide](/ecosystem/mcp).
109
107
 
110
108
  ### The full guide
111
109
 
@@ -157,11 +155,11 @@ export default defineNuxtConfig({
157
155
  ## Essential Links
158
156
 
159
157
  - **[v5 Migration Guide](/guide/migration-v5)** — every breaking change, the upgrade CLI, the MCP flow
160
- - **[Theming](/guide/themes)** — preset authoring, `scales` and `components` blocks, runtime switching
158
+ - **[Theming](/ecosystem/themes)** — preset authoring, `scales` and `components` blocks, runtime switching
161
159
  - **[Browser Support](/guide/browser-support)** — minimum versions and the features they enable
162
160
  - **[Tailwind integration](/guide/tailwind)** — for consumers who ship their own Tailwind setup
163
161
  - **[`@maz-ui/upgrade` README](https://github.com/LouisMazel/maz-ui/tree/master/packages/upgrade)** — full transform list and CLI reference
164
- - **[Model Context Protocol (MCP)](/guide/mcp)** — connect AI assistants to the Maz-UI docs
162
+ - **[Model Context Protocol (MCP)](/ecosystem/mcp)** — connect AI assistants to the Maz-UI docs
165
163
  - **[GitHub Repository](https://github.com/LouisMazel/maz-ui)** — source code & issues
166
164
  - **[Changelog](https://github.com/LouisMazel/maz-ui/blob/master/CHANGELOG.md)** — detailed release notes
167
165
 
package/docs/src/components/maz-avatar.md CHANGED
@@ -108,6 +108,35 @@ function clicked() { console.log('clicked') }
108
108
  </template>
109
109
  ```
110
110
 
111
+ ## Initials from caption
112
+
113
+ When no `src` is provided, `MazAvatar` displays initials generated from the `caption`. The `letter-count` prop (default `2`) controls how many letters are displayed:
114
+
115
+ - **Single word**: the first `letter-count` characters of the word are used.
116
+ - **Multiple words**: the first letter of each of the first `letter-count` words is used.
117
+
118
+ Initials are always uppercased.
119
+
120
+ <div class="flex gap-05 items-center flex-wrap">
121
+ <MazAvatar caption="admin" size="3rem" />
122
+ <MazAvatar caption="admin" :letter-count="3" size="3rem" />
123
+ <MazAvatar caption="Louis Mazel" size="3rem" />
124
+ <MazAvatar caption="Jean Claude Dus" :letter-count="3" size="3rem" />
125
+ </div>
126
+
127
+ ```vue
128
+ <template>
129
+ <!-- "AD" -->
130
+ <MazAvatar caption="admin" />
131
+ <!-- "ADM" -->
132
+ <MazAvatar caption="admin" :letter-count="3" />
133
+ <!-- "LM" -->
134
+ <MazAvatar caption="Louis Mazel" />
135
+ <!-- "JCD" -->
136
+ <MazAvatar caption="Jean Claude Dus" :letter-count="3" />
137
+ </template>
138
+ ```
139
+
111
140
  ## On Error
112
141
 
113
142
  <MazAvatar @error="error" />