@maz-ui/mcp 5.0.0-beta.4 → 5.0.0-beta.41

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 (157) 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-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 +39 -37
  45. package/docs/generated-docs/maz-tabs-bar.doc.md +20 -9
  46. package/docs/generated-docs/maz-tabs.doc.md +6 -3
  47. package/docs/generated-docs/maz-textarea.doc.md +27 -25
  48. package/docs/generated-docs/maz-ticker.doc.md +1 -1
  49. package/docs/generated-docs/maz-timeline.doc.md +4 -4
  50. package/docs/generated-docs/maz-window-mockup.doc.md +23 -0
  51. package/docs/src/blog/v4.md +1 -1
  52. package/docs/src/blog/v5.md +5 -7
  53. package/docs/src/components/maz-avatar.md +52 -4
  54. package/docs/src/components/maz-bottom-sheet.md +300 -169
  55. package/docs/src/components/maz-btn.md +1 -1
  56. package/docs/src/components/maz-code-highlight.md +233 -0
  57. package/docs/src/components/maz-date-picker.md +1 -1
  58. package/docs/src/components/maz-dialog.md +46 -0
  59. package/docs/src/components/maz-dropdown.md +32 -16
  60. package/docs/src/components/maz-icon.md +2 -2
  61. package/docs/src/components/maz-lazy-img.md +64 -0
  62. package/docs/src/components/maz-markdown-editor.md +369 -0
  63. package/docs/src/components/maz-pull-to-refresh.md +1 -1
  64. package/docs/src/components/maz-sidebar.md +719 -0
  65. package/docs/src/components/maz-table.md +74 -0
  66. package/docs/src/components/maz-tabs.md +110 -3
  67. package/docs/src/components/maz-textarea.md +58 -0
  68. package/docs/src/components/maz-timeline.md +60 -0
  69. package/docs/src/components/maz-window-mockup.md +249 -0
  70. package/docs/src/composables/use-drag.md +239 -0
  71. package/docs/src/composables/use-form-validator.md +50 -11
  72. package/docs/src/composables/use-swipe.md +26 -11
  73. package/docs/src/directives/click-outside.md +8 -15
  74. package/docs/src/directives/fullscreen-img.md +1 -1
  75. package/docs/src/directives/lazy-img.md +44 -11
  76. package/docs/src/directives/tooltip.md +24 -1
  77. package/docs/src/directives/zoom-img.md +1 -1
  78. package/docs/src/ecosystem/eslint-config.md +95 -1
  79. package/docs/src/{guide/icons.md → ecosystem/icons/index.md} +1 -1
  80. package/docs/src/ecosystem/node/exec-promise.md +87 -0
  81. package/docs/src/ecosystem/node/index.md +53 -0
  82. package/docs/src/ecosystem/node/logger.md +146 -0
  83. package/docs/src/ecosystem/node/print-banner.md +93 -0
  84. package/docs/src/{guide → ecosystem}/nuxt.md +81 -47
  85. package/docs/src/{guide → ecosystem}/themes.md +152 -71
  86. package/docs/src/{guide → ecosystem}/translations.md +1 -1
  87. package/docs/src/ecosystem/utils/camel-case.md +31 -0
  88. package/docs/src/{helpers → ecosystem/utils}/capitalize.md +2 -3
  89. package/docs/src/ecosystem/utils/check-availability.md +79 -0
  90. package/docs/src/ecosystem/utils/cookie.md +80 -0
  91. package/docs/src/ecosystem/utils/debounce-callback.md +38 -0
  92. package/docs/src/ecosystem/utils/debounce-id.md +69 -0
  93. package/docs/src/ecosystem/utils/debounce.md +65 -0
  94. package/docs/src/ecosystem/utils/fetch-locale-ip.md +33 -0
  95. package/docs/src/ecosystem/utils/format-json.md +33 -0
  96. package/docs/src/ecosystem/utils/format-phone-number.md +37 -0
  97. package/docs/src/ecosystem/utils/get-browser-locale.md +29 -0
  98. package/docs/src/ecosystem/utils/get-error-message.md +39 -0
  99. package/docs/src/ecosystem/utils/idle-timeout.md +90 -0
  100. package/docs/src/ecosystem/utils/index.md +60 -0
  101. package/docs/src/ecosystem/utils/is-client.md +32 -0
  102. package/docs/src/ecosystem/utils/is-equal.md +38 -0
  103. package/docs/src/ecosystem/utils/is-server.md +31 -0
  104. package/docs/src/ecosystem/utils/is-standalone-mode.md +43 -0
  105. package/docs/src/ecosystem/utils/kebab-case.md +36 -0
  106. package/docs/src/ecosystem/utils/normalize-string.md +77 -0
  107. package/docs/src/ecosystem/utils/pascal-case.md +35 -0
  108. package/docs/src/ecosystem/utils/script-loader.md +77 -0
  109. package/docs/src/ecosystem/utils/sleep.md +59 -0
  110. package/docs/src/ecosystem/utils/snake-case.md +36 -0
  111. package/docs/src/ecosystem/utils/swipe-handler.md +91 -0
  112. package/docs/src/ecosystem/utils/textarea-autogrow.md +41 -0
  113. package/docs/src/ecosystem/utils/throttle-id.md +48 -0
  114. package/docs/src/ecosystem/utils/throttle.md +57 -0
  115. package/docs/src/ecosystem/utils/truthy-filter.md +31 -0
  116. package/docs/src/ecosystem/utils/types/deep-key-of.md +48 -0
  117. package/docs/src/ecosystem/utils/types/deep-partial.md +42 -0
  118. package/docs/src/ecosystem/utils/types/deep-required.md +39 -0
  119. package/docs/src/ecosystem/utils/types/flatten-object-keys.md +44 -0
  120. package/docs/src/ecosystem/utils/types/generic-instance-type.md +42 -0
  121. package/docs/src/ecosystem/utils/types/infer-maybe-ref.md +35 -0
  122. package/docs/src/ecosystem/utils/upper-first.md +32 -0
  123. package/docs/src/ecosystem/utils/user-visibility.md +69 -0
  124. package/docs/src/guide/getting-started.md +15 -13
  125. package/docs/src/guide/global-defaults.md +101 -0
  126. package/docs/src/guide/maz-ui-provider.md +6 -3
  127. package/docs/src/guide/migration-v4.md +13 -9
  128. package/docs/src/guide/migration-v5.md +112 -13
  129. package/docs/src/guide/resolvers.md +7 -7
  130. package/docs/src/guide/tailwind.md +4 -0
  131. package/docs/src/guide/vue.md +4 -4
  132. package/docs/src/index.md +12 -12
  133. package/docs/src/plugins/aos.md +1 -1
  134. package/package.json +8 -7
  135. package/docs/src/helpers/camel-case.md +0 -14
  136. package/docs/src/helpers/check-availability.md +0 -14
  137. package/docs/src/helpers/debounce-callback.md +0 -14
  138. package/docs/src/helpers/debounce-id.md +0 -14
  139. package/docs/src/helpers/debounce.md +0 -14
  140. package/docs/src/helpers/is-client.md +0 -14
  141. package/docs/src/helpers/is-equal.md +0 -14
  142. package/docs/src/helpers/is-standalone-mode.md +0 -14
  143. package/docs/src/helpers/kebab-case.md +0 -14
  144. package/docs/src/helpers/normalize-string.md +0 -14
  145. package/docs/src/helpers/pascal-case.md +0 -14
  146. package/docs/src/helpers/script-loader.md +0 -14
  147. package/docs/src/helpers/sleep.md +0 -14
  148. package/docs/src/helpers/snake-case.md +0 -14
  149. package/docs/src/helpers/throttle-id.md +0 -14
  150. package/docs/src/helpers/throttle.md +0 -14
  151. /package/docs/src/{guide → ecosystem/icons}/icon-set.md +0 -0
  152. /package/docs/src/{guide → ecosystem}/mcp.md +0 -0
  153. /package/docs/src/{helpers → ecosystem/utils}/country-code-to-unicode-flag.md +0 -0
  154. /package/docs/src/{helpers → ecosystem/utils}/currency.md +0 -0
  155. /package/docs/src/{helpers → ecosystem/utils}/date.md +0 -0
  156. /package/docs/src/{helpers → ecosystem/utils}/get-country-flag-url.md +0 -0
  157. /package/docs/src/{helpers → ecosystem/utils}/number.md +0 -0
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
@@ -1,42 +1,44 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default | Possible values |
4
- | ---------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------- | -------- | ---------------------------------------- | ---------------------------- |
5
- | **table-class** | CSS class of the table element | `HTMLAttributes['class']` | No | `undefined` | - |
6
- | **table-style** | CSS style of the table element | `HTMLAttributes['style']` | No | `undefined` | - |
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` |
9
- | **input-size** | Size of the search inputs | `MazSize` | No | `undefined` | `xl, lg, md, sm, xs, mini` |
10
- | **title** | Title of the table | `string` | No | `undefined` | - |
11
- | **headers** | Headers of the table | `MazTableHeader[]` | No | `undefined` | - |
12
- | **sortable** | Enable sort feature on all columns | `boolean` | No | `false` | - |
13
- | **headers-align** | Align all headers | `string` | No | `'left'` | - |
14
- | **rows** | Rows of the table | `T[]` | No | `undefined` | - |
15
- | **hoverable** | Add hover effect on rows | `boolean` | No | `false` | - |
16
- | **search** | Enable search feature in table header | `boolean` | No | `false` | - |
17
- | **hide-search-in-row** | Disable search in rows - useful to filter data yourself or make search request to server | `boolean` | No | `false` | - |
18
- | **hide-search-by** | Disable search by column (remove select input "search by") | `boolean` | No | `false` | - |
19
- | **search-query** | `v-model:search-query` <br/>Search query in input | `string` | No | `undefined` | - |
20
- | **background-odd** | Add background color to odd rows | `boolean` | No | `false` | - |
21
- | **background-even** | Add background color to even rows | `boolean` | No | `false` | - |
22
- | **elevation** | Add shadow to the table | `boolean` | No | `false` | - |
23
- | **divider** | add divider between rows | `boolean` | No | `false` | - |
24
- | **caption** | Caption of the table | `string` | No | `undefined` | - |
25
- | **caption-side** | Caption side | `string` | No | `'bottom'` | `top, bottom` |
26
- | **pagination** | Add pagination in table footer | `boolean` | No | `false` | - |
27
- | **page** | `v-model:page` <br/>Current page of pagination | `number` | No | `1` | - |
28
- | **page-size** | `v-model:page-size` <br/>Number of items per page | `number` | No | `20` | - |
29
- | **total-pages** | Total number of pages | `number` | No | `undefined` | - |
30
- | **paginate-rows** | Don't paginate rows - useful to make pagination request with your server | `boolean` | No | `true` | - |
31
- | **total-items** | Total number of items | `number` | No | `undefined` | - |
32
- | **loading** | Loading state | `boolean` | No | `false` | - |
33
- | **selectable** | Enable selection of rows | `boolean` | No | `false` | - |
34
- | **selected-key** | Enable selection of rows - key of the selected row | `string` | No | `undefined` | - |
35
- | **table-layout** | Table layout | `string` | No | `undefined` | `auto, fixed` |
36
- | **color** | Color of the component | `MazColor` | No | `'primary'` | - |
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` |
39
- | **scrollable** | Enable scrollable on table | `boolean` | No | `false` | - |
3
+ | Name | Description | Type | Required | Default | Possible values |
4
+ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | -------- | ---------------------------------------- | ---------------------------- |
5
+ | **table-class** | CSS class of the table element | `HTMLAttributes['class']` | No | `undefined` | - |
6
+ | **table-style** | CSS style of the table element | `HTMLAttributes['style']` | No | `undefined` | - |
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` |
9
+ | **input-size** | Size of the search inputs | `MazSize` | No | `undefined` | `xl, lg, md, sm, xs, mini` |
10
+ | **title** | Title of the table | `string` | No | `undefined` | - |
11
+ | **headers** | Headers of the table | `MazTableHeader[]` | No | `undefined` | - |
12
+ | **sortable** | Enable sort feature on all columns | `boolean` | No | `false` | - |
13
+ | **headers-align** | Align all headers | `string` | No | `left` | - |
14
+ | **rows** | Rows of the table | `T[]` | No | `undefined` | - |
15
+ | **hoverable** | Add hover effect on rows | `boolean` | No | `false` | - |
16
+ | **search** | Enable search feature in table header | `boolean` | No | `false` | - |
17
+ | **hide-search-in-row** | Disable search in rows - useful to filter data yourself or make search request to server | `boolean` | No | `false` | - |
18
+ | **hide-search-by** | Disable search by column (remove select input "search by") | `boolean` | No | `false` | - |
19
+ | **search-query** | `v-model:search-query` <br/>Search query in input | `string` | No | `undefined` | - |
20
+ | **background-odd** | Add background color to odd rows | `boolean` | No | `false` | - |
21
+ | **background-even** | Add background color to even rows | `boolean` | No | `false` | - |
22
+ | **elevation** | Add shadow to the table | `boolean` | No | `false` | - |
23
+ | **divider** | add divider between rows | `boolean` | No | `false` | - |
24
+ | **caption** | Caption of the table | `string` | No | `undefined` | - |
25
+ | **caption-side** | Caption side | `string` | No | `bottom` | `top, bottom` |
26
+ | **pagination** | Add pagination in table footer | `boolean` | No | `false` | - |
27
+ | **page** | `v-model:page` <br/>Current page of pagination | `number` | No | `1` | - |
28
+ | **page-size** | `v-model:page-size` <br/>Number of items per page | `number` | No | `20` | - |
29
+ | **total-pages** | Total number of pages | `number` | No | `undefined` | - |
30
+ | **paginate-rows** | Don't paginate rows - useful to make pagination request with your server | `boolean` | No | `true` | - |
31
+ | **total-items** | Total number of items | `number` | No | `undefined` | - |
32
+ | **loading** | Loading state | `boolean` | No | `false` | - |
33
+ | **selectable** | Enable selection of rows | `boolean` | No | `false` | - |
34
+ | **selected-key** | Enable selection of rows - key of the selected row | `string` | No | `undefined` | - |
35
+ | **table-layout** | Table layout | `string` | No | `undefined` | `auto, fixed` |
36
+ | **color** | Color of the component | `MazColor` | No | `primary` | - |
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 | `MazRoundedSize` | No | `md` | `none, sm, md, lg, xl, full` |
39
+ | **scrollable** | Enable scrollable on table | `boolean` | No | `false` | - |
40
+ | **row-key** | Field name used as a stable key for each row (e.g. an id). Gives every row a stable identity so reordering is tracked correctly - required for `animatedRows` to look right. Falls back to the row index when not provided. | `string` | No | `undefined` | - |
41
+ | **animated-rows** | Animate row reordering with a FLIP transition (rows slide to their new position). Provide a stable `rowKey` for meaningful results. Respects `prefers-reduced-motion`. | `boolean` | No | `false` | - |
40
42
 
41
43
  ## Events
42
44
 
package/docs/generated-docs/maz-tabs-bar.doc.md CHANGED
@@ -1,14 +1,25 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | --------------- | -------------------------------------------------------------------------- | ------------------ | -------- | ----------- |
5
- | **items** | The items to display in the tabs bar | `MazTabsBarItem[]` | Yes | `undefined` |
6
- | **persistent** | Will add a query param to the url to keep the selected tab on page refresh | `boolean` | No | `false` |
7
- | **query-param** | The name of the query param to add to the url | `string` | No | `tab` |
8
- | **block** | Will make the tabs bar full width | `boolean` | No | `false` |
9
- | **elevation** | Will remove the elevation | `boolean` | No | `false` |
10
- | **auto-scroll** | Will add a scroll on the tabs bar to show selected element | `boolean` | No | `true` |
11
- | **bordered** | Will add a border to the tabs bar | `boolean` | No | `true` |
3
+ | Name | Description | Type | Required | Default | Possible values |
4
+ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | -------- | ----------- | --------------------------------------------------------------------------------------------------------- |
5
+ | **items** | The items to display in the tabs bar | `TSTypeOperator` | Yes | `undefined` | - |
6
+ | **model-value** | `v-model` <br/>Selected tab (standalone usage, without MazTabs). Holds the item `value` when provided, otherwise the 1-based index. Pass items `as const` (or with literal `value`) to infer a union type. | `MazTabsBarItemValue` | No | `undefined` | - |
7
+ | **size** | Size of the tabs (forwarded to each MazBtn) | `MazSize` | No | `md` | `'xl' \| 'lg' \| 'md' \| 'sm' \| 'xs' \| 'mini'` |
8
+ | **rounded-size** | Size of the rounded applied to the bar, the indicator and each tab | `MazRoundedSize` | No | `md` | `'none' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full'` |
9
+ | **color** | Color of the active tab indicator. When omitted, the default neutral indicator is used. | `MazColor` | No | `undefined` | `'primary' \| 'secondary' \| 'accent' \| 'info' \| 'success' \| 'warning' \| 'destructive' \| 'contrast'` |
10
+ | **standalone** | Force the standalone mode: the tabs bar ignores any surrounding `MazTabs` (selection, size, rounded-size and color are no longer inherited) and is driven only by its own `v-model`. Useful for a nested switcher inside a page already wrapped by `MazTabs`. | `boolean` | No | `false` | - |
11
+ | **persistent** | Will add a query param to the url to keep the selected tab on page refresh | `boolean` | No | `false` | - |
12
+ | **query-param** | The name of the query param to add to the url | `string` | No | `tab` | - |
13
+ | **block** | Will make the tabs bar full width | `boolean` | No | `false` | - |
14
+ | **elevation** | Will remove the elevation | `boolean` | No | `false` | - |
15
+ | **auto-scroll** | Will add a scroll on the tabs bar to show selected element | `boolean` | No | `true` | - |
16
+ | **bordered** | Will add a border to the tabs bar | `boolean` | No | `true` | - |
17
+
18
+ ## Events
19
+
20
+ | Event name | Properties | Description |
21
+ | ------------------ | --------------------------------------------------------------------------------------- | --------------------------------------------------------- |
22
+ | update:model-value | **value** `MazTabsBarItemValue` - item value when provided, otherwise the 1-based index | Emitted when the selected tab changes (standalone usage). |
12
23
 
13
24
  ## Slots
14
25
 
package/docs/generated-docs/maz-tabs.doc.md CHANGED
@@ -1,8 +1,11 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required |
4
- | --------------- | --------------------------- | -------- | -------- |
5
- | **model-value** | The the selected tab number | `number` | No |
3
+ | Name | Description | Type | Required | Possible values |
4
+ | ---------------- | --------------------------------------------------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------- |
5
+ | **model-value** | The the selected tab number | `number` | No | - |
6
+ | **size** | Size of the tabs, forwarded to MazTabsBar (and each tab button) | `MazSize` | No | `'xl' \| 'lg' \| 'md' \| 'sm' \| 'xs' \| 'mini'` |
7
+ | **rounded-size** | Size of the rounded, forwarded to MazTabsBar | `MazRoundedSize` | No | `'none' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full'` |
8
+ | **color** | Color of the active tab indicator, forwarded to MazTabsBar | `MazColor` | No | `'primary' \| 'secondary' \| 'accent' \| 'info' \| 'success' \| 'warning' \| 'destructive' \| 'contrast'` |
6
9
 
7
10
  ## Events
8
11
 
package/docs/generated-docs/maz-textarea.doc.md CHANGED
@@ -1,30 +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 | `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` | - |
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` | - |
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
+ | **size** | Controls the padding (height) and text size of the textarea, mirroring MazInput sizes. Combined with `minRows`, e.g. `size="md" :min-rows="1"` matches a regular input height. | `MazSize` | No | `md` | `mini, xs, sm, md, lg, xl` |
22
+ | **padding** | If the textarea has a padding | `boolean` | No | `true` | - |
23
+ | **transparent** | If the textarea has a transparent background | `boolean` | No | `false` | - |
24
+ | **border** | If the textarea has no border | `boolean` | No | `false` | - |
25
+ | **autogrow** | If the textarea should autogrow based on its content | `boolean` | No | `true` | - |
26
+ | **min-rows** | Minimum number of rows displayed by the textarea (initial/minimum height). With autogrow enabled, the textarea still grows beyond this with its content. | `number` | No | `3` | - |
27
+ | **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'` |
28
+ | **top-label** | Static label displayed above the textarea. Unlike the floating label, this remains fixed | `string` | No | `undefined` | - |
29
+ | **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` | - |
28
30
 
29
31
  ## Events
30
32
 
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