maz-ui 5.1.0-beta.0 → 5.1.0

package/docs/components/maz-fullscreen-loader.md

@@ -1,13 +1,13 @@
 ---
 title: "MazFullscreenLoader"
-description: "MazFullscreenLoader is a standalone component"
+description: "MazFullscreenLoader covers the whole page with a backdrop and a spinner to block the interface during a global loading"
 package: "maz-ui"
 url: "https://maz-ui.com/components/maz-fullscreen-loader"
 ---
 
 # MazFullscreenLoader
 
-> MazFullscreenLoader is a standalone component
+> MazFullscreenLoader covers the whole page with a backdrop and a spinner to block the interface during a global loading
 
 - Package: `maz-ui`
 - Import: `import MazFullscreenLoader from 'maz-ui/components/MazFullscreenLoader'`

package/docs/components/maz-input-number.md

@@ -61,7 +61,7 @@ You can remove the buttons with the props `hide-buttons`
 - `size` (`"xs" | "sm" | "md" | "lg" | "xl" | "mini"`, default: `'md'`): The size of the input number component.
 - `hide-buttons` (`boolean`, default: `false`): Whether to hide the increment and decrement buttons or not.
 - `text-center` (`boolean`, default: `true`): Whether to center the text inside the input or not.
-- `inputmode` (`"none" | "text" | "search" | "url" | "email" | "tel" | "numeric" | "decimal"`, default: `"numeric"`): The inputmode attribute for the input.
+- `inputmode` (`"text" | "none" | "search" | "url" | "email" | "tel" | "numeric" | "decimal"`, default: `"numeric"`): The inputmode attribute for the input.
 - `block` (`boolean`): The input will be displayed in full width.
 - `error` (`boolean`, default: `false`): Will display the input in error state.
 - `hint` (`string`): The hint text to display below the input.

package/docs/components/maz-input-phone-number.md

@@ -518,7 +518,7 @@ interface MazInputPhoneNumberData {
 - `block` (`boolean`, default: `false`): The input will be displayed in full width.
 - `orientation` (`"row" | "col" | "responsive"`, default: `"responsive"`): Orientation of the inputs in the component.
 - `country-select-attributes` (`Record<string, unknown>`, default: `{ name: "country", autocomplete: "off", style: { width: "14rem", }, }`): Meta attributes of the country input.
-- `phone-input-attributes` (`(Record<string, unknown> & { name: string; inputmode: "none" | "text" | "search" | "url" | "email" | "tel" | "numeric" | "decimal" | undefined; autocomplete: string; })`, default: `{ name: "phone", autocomplete: "tel", inputmode: "tel", }`): Meta attributes of the phone number input.
+- `phone-input-attributes` (`(Record<string, unknown> & { name: string; inputmode: "text" | "none" | "search" | "url" | "email" | "tel" | "numeric" | "decimal" | undefined; autocomplete: string; })`, default: `{ name: "phone", autocomplete: "tel", inputmode: "tel", }`): Meta attributes of the phone number input.
 - `assistive-text` (`string`): Helper text displayed below the input to provide additional context or validation feedback.
 - `hint` (`string`): Alternative text that replaces the label when provided. Useful for contextual hints.
 

package/docs/components/maz-input.md

@@ -305,7 +305,7 @@ Use the attribute `rounded-size` with a value in `'none' | 'sm' | 'md' | 'lg' |
 - `hint` (`string`): Alternative text that replaces the label when provided. Useful for contextual hints.
 - `input-classes` (`string`): Additional CSS classes to apply specifically to the input wrapper element.
 - `border` (`boolean`, default: `true`): Controls whether the input has a visible border. Set to false for borderless inputs.
-- `inputmode` (`"none" | "text" | "search" | "url" | "email" | "tel" | "numeric" | "decimal"`, default: `"text"`): HTML inputmode attribute that provides hints for virtual keyboards on mobile devices.
+- `inputmode` (`"text" | "none" | "search" | "url" | "email" | "tel" | "numeric" | "decimal"`, default: `"text"`): HTML inputmode attribute that provides hints for virtual keyboards on mobile devices.
 - `size` (`"xs" | "sm" | "md" | "lg" | "xl" | "mini"`): Controls the height and text size of the input component.
 - `debounce` (`number | boolean`, default: `false`): Enables input debouncing to limit the frequency of value updates. When true, uses 500ms delay. When a number, uses that value as delay in milliseconds.
 - `auto-focus` (`boolean`, default: `false`): Automatically focuses the input when the component mounts.

package/docs/components/maz-loading-bar.md

@@ -1,13 +1,13 @@
 ---
 title: "MazLoadingBar"
-description: "MazLoadingBar is a standalone component"
+description: "MazLoadingBar is an indeterminate progress bar to show that something is loading, typically at the top of a page or a container"
 package: "maz-ui"
 url: "https://maz-ui.com/components/maz-loading-bar"
 ---
 
 # MazLoadingBar
 
-> MazLoadingBar is a standalone component
+> MazLoadingBar is an indeterminate progress bar to show that something is loading, typically at the top of a page or a container
 
 - Package: `maz-ui`
 - Import: `import MazLoadingBar from 'maz-ui/components/MazLoadingBar'`

package/docs/components/maz-pagination.md

@@ -1,13 +1,13 @@
 ---
 title: "MazPagination"
-description: "MazPagination is a standalone component"
+description: "MazPagination lets users navigate between the pages of a list or a table, with first, previous, next and last buttons and the current page in v-model"
 package: "maz-ui"
 url: "https://maz-ui.com/components/maz-pagination"
 ---
 
 # MazPagination
 
-> MazPagination is a standalone component
+> MazPagination lets users navigate between the pages of a list or a table, with first, previous, next and last buttons and the current page in v-model
 
 - Package: `maz-ui`
 - Import: `import MazPagination from 'maz-ui/components/MazPagination'`

package/docs/components/maz-pull-to-refresh.md

@@ -202,9 +202,9 @@ Need a different indicator, or a gesture on an element without wrapping it? Use
 
 ### Events
 
+- `@start`: Emitted when the refresh starts
 - `@loaded`: Emitted when `onRefresh` resolved
 - `@error` (payload: `error: unknown`): Emitted when `onRefresh` threw or rejected
-- `@start`: Emitted when the refresh starts
 - `@response` (payload: `response: unknown`): Emitted with the value resolved by `onRefresh`
 - `@finish`: Emitted when the refresh ends, after `loaded` or `error`
 

package/docs/components/maz-radio.md

@@ -1,13 +1,13 @@
 ---
 title: "MazRadio"
-description: "MazRadio is a standalone component"
+description: "MazRadio is a radio input with a label, colors and sizes to pick one value among several options; see MazRadioButtons for a ready-made group"
 package: "maz-ui"
 url: "https://maz-ui.com/components/maz-radio"
 ---
 
 # MazRadio
 
-> MazRadio is a standalone component
+> MazRadio is a radio input with a label, colors and sizes to pick one value among several options; see MazRadioButtons for a ready-made group
 
 - Package: `maz-ui`
 - Import: `import MazRadio from 'maz-ui/components/MazRadio'`

package/docs/components/maz-select-country.md

@@ -479,10 +479,10 @@ This ensures consistent internationalization across your application while provi
 - `codes-type` (`CodesType`, default: `defined by displayNamesOptions.type (if 'region', 'country' is used, otherwise 'iso')`): Codes type. Values: `'iso'`, `'bcp'`, `'country'`, `'all'` (non exhaustive).
 - `open` (`boolean`, default: `false`): Open the select.
 - `model-value` (`Option["code"]`, `v-model`): The value of the select.
-- `disabled` (`boolean`): Disable the component.
 - `block` (`boolean`): The input will be displayed in full width.
-- `placeholder` (`string`): The placeholder of the select.
+- `disabled` (`boolean`): Disable the component.
 - `required` (`boolean`): Make the input required in the form.
+- `placeholder` (`string`): The placeholder of the select.
 - `label` (`string`): The label of the select.
 - `search-function` (`((query: string, options: Option[]) => Option[] | undefined)`): Replace the default search function to provide a custom search function.
 - `transition` (`string`, default: `'scale-fade'`): The transition name of the panel list options.

package/docs/components/maz-sidebar-content.md

@@ -1,12 +1,12 @@
 ---
 title: "MazSidebarContent"
-description: "MazSidebarContent component."
+description: "Scrollable main area of MazSidebar that holds the groups and the menus."
 package: "maz-ui"
 ---
 
 # MazSidebarContent
 
-> MazSidebarContent component.
+> Scrollable main area of MazSidebar that holds the groups and the menus.
 
 - Package: `maz-ui`
 - Import: `import MazSidebarContent from 'maz-ui/components/MazSidebarContent'`

package/docs/components/maz-sidebar-footer.md

@@ -1,12 +1,12 @@
 ---
 title: "MazSidebarFooter"
-description: "MazSidebarFooter component."
+description: "Bottom area of MazSidebar, for the user menu or secondary actions."
 package: "maz-ui"
 ---
 
 # MazSidebarFooter
 
-> MazSidebarFooter component.
+> Bottom area of MazSidebar, for the user menu or secondary actions.
 
 - Package: `maz-ui`
 - Import: `import MazSidebarFooter from 'maz-ui/components/MazSidebarFooter'`

package/docs/components/maz-sidebar-group.md

@@ -1,12 +1,12 @@
 ---
 title: "MazSidebarGroup"
-description: "MazSidebarGroup is a building block of MazSidebar."
+description: "Titled and optionally collapsible section of MazSidebar that groups menus."
 package: "maz-ui"
 ---
 
 # MazSidebarGroup
 
-> MazSidebarGroup is a building block of MazSidebar.
+> Titled and optionally collapsible section of MazSidebar that groups menus.
 
 - Package: `maz-ui`
 - Import: `import MazSidebarGroup from 'maz-ui/components/MazSidebarGroup'`

package/docs/components/maz-sidebar-header.md

@@ -1,12 +1,12 @@
 ---
 title: "MazSidebarHeader"
-description: "MazSidebarHeader component."
+description: "Top area of MazSidebar, for the logo, the name of the app or a workspace switcher."
 package: "maz-ui"
 ---
 
 # MazSidebarHeader
 
-> MazSidebarHeader component.
+> Top area of MazSidebar, for the logo, the name of the app or a workspace switcher.
 
 - Package: `maz-ui`
 - Import: `import MazSidebarHeader from 'maz-ui/components/MazSidebarHeader'`

package/docs/components/maz-sidebar-menu-button.md

@@ -1,12 +1,12 @@
 ---
 title: "MazSidebarMenuButton"
-description: "MazSidebarMenuButton is a building block of MazSidebar."
+description: "Navigation button or link of a MazSidebar menu item, with icon, label, badge, and a tooltip when the sidebar is collapsed."
 package: "maz-ui"
 ---
 
 # MazSidebarMenuButton
 
-> MazSidebarMenuButton is a building block of MazSidebar.
+> Navigation button or link of a MazSidebar menu item, with icon, label, badge, and a tooltip when the sidebar is collapsed.
 
 - Package: `maz-ui`
 - Import: `import MazSidebarMenuButton from 'maz-ui/components/MazSidebarMenuButton'`

package/docs/components/maz-sidebar-menu-item.md

@@ -1,12 +1,12 @@
 ---
 title: "MazSidebarMenuItem"
-description: "MazSidebarMenuItem component."
+description: "Item of a MazSidebarMenu: wraps a MazSidebarMenuButton and its optional MazSidebarMenuSub."
 package: "maz-ui"
 ---
 
 # MazSidebarMenuItem
 
-> MazSidebarMenuItem component.
+> Item of a MazSidebarMenu: wraps a MazSidebarMenuButton and its optional MazSidebarMenuSub.
 
 - Package: `maz-ui`
 - Import: `import MazSidebarMenuItem from 'maz-ui/components/MazSidebarMenuItem'`

package/docs/components/maz-sidebar-menu-sub.md

@@ -1,12 +1,12 @@
 ---
 title: "MazSidebarMenuSub"
-description: "MazSidebarMenuSub is a building block of MazSidebar."
+description: "Nested submenu of a MazSidebar menu item."
 package: "maz-ui"
 ---
 
 # MazSidebarMenuSub
 
-> MazSidebarMenuSub is a building block of MazSidebar.
+> Nested submenu of a MazSidebar menu item.
 
 - Package: `maz-ui`
 - Import: `import MazSidebarMenuSub from 'maz-ui/components/MazSidebarMenuSub'`

package/docs/components/maz-sidebar-menu.md

@@ -1,12 +1,12 @@
 ---
 title: "MazSidebarMenu"
-description: "MazSidebarMenu component."
+description: "List of navigation items of MazSidebar."
 package: "maz-ui"
 ---
 
 # MazSidebarMenu
 
-> MazSidebarMenu component.
+> List of navigation items of MazSidebar.
 
 - Package: `maz-ui`
 - Import: `import MazSidebarMenu from 'maz-ui/components/MazSidebarMenu'`

package/docs/components/maz-sidebar-separator.md

@@ -1,12 +1,12 @@
 ---
 title: "MazSidebarSeparator"
-description: "MazSidebarSeparator component."
+description: "Divider between the sections of MazSidebar."
 package: "maz-ui"
 ---
 
 # MazSidebarSeparator
 
-> MazSidebarSeparator component.
+> Divider between the sections of MazSidebar.
 
 - Package: `maz-ui`
 - Import: `import MazSidebarSeparator from 'maz-ui/components/MazSidebarSeparator'`

package/docs/components/maz-sidebar-trigger.md

@@ -1,12 +1,12 @@
 ---
 title: "MazSidebarTrigger"
-description: "MazSidebarTrigger component."
+description: "Button that opens, closes or collapses MazSidebar."
 package: "maz-ui"
 ---
 
 # MazSidebarTrigger
 
-> MazSidebarTrigger component.
+> Button that opens, closes or collapses MazSidebar.
 
 - Package: `maz-ui`
 - Import: `import MazSidebarTrigger from 'maz-ui/components/MazSidebarTrigger'`

package/docs/components/maz-spinner.md

@@ -1,13 +1,13 @@
 ---
 title: "MazSpinner"
-description: "MazSpinner is a standalone component that replaces the standard html input checkbox. Color options are available."
+description: "MazSpinner is an animated loading indicator with the colors and sizes of the theme, to show that a content or an action is loading"
 package: "maz-ui"
 url: "https://maz-ui.com/components/maz-spinner"
 ---
 
 # MazSpinner
 
-> MazSpinner is a standalone component that replaces the standard html input checkbox. Color options are available.
+> MazSpinner is an animated loading indicator with the colors and sizes of the theme, to show that a content or an action is loading
 
 - Package: `maz-ui`
 - Import: `import MazSpinner from 'maz-ui/components/MazSpinner'`

package/docs/components/maz-stepper.md

@@ -299,3 +299,8 @@ Each step header is a button exposing the current step (`aria-current="step"`) a
 ### Slots
 
 - `#point` Bindings: `step: number`.
+- `#icon-{step}`: One slot per `step`: `#icon-<step>`.
+- `#title-{step}`: One slot per `step`: `#title-<step>`.
+- `#subtitle-{step}`: One slot per `step`: `#subtitle-<step>`.
+- `#title-info-{step}`: One slot per `step`: `#title-info-<step>`.
+- `#content-{step}`: One slot per `step`: `#content-<step>`.

package/docs/components/maz-table-cell.md

@@ -1,12 +1,12 @@
 ---
 title: "MazTableCell"
-description: "MazTableCell is a building block of MazTable."
+description: "Cell of a MazTableRow, with the size and padding of MazTable."
 package: "maz-ui"
 ---
 
 # MazTableCell
 
-> MazTableCell is a building block of MazTable.
+> Cell of a MazTableRow, with the size and padding of MazTable.
 
 - Package: `maz-ui`
 - Import: `import MazTableCell from 'maz-ui/components/MazTableCell'`

package/docs/components/maz-table-row.md

@@ -1,12 +1,12 @@
 ---
 title: "MazTableRow"
-description: "MazTableRow is a building block of MazTable."
+description: "Row of MazTable, when you write the rows by hand in its default slot."
 package: "maz-ui"
 ---
 
 # MazTableRow
 
-> MazTableRow is a building block of MazTable.
+> Row of MazTable, when you write the rows by hand in its default slot.
 
 - Package: `maz-ui`
 - Import: `import MazTableRow from 'maz-ui/components/MazTableRow'`

package/docs/components/maz-table-title.md

@@ -1,12 +1,12 @@
 ---
 title: "MazTableTitle"
-description: "MazTableTitle is a building block of MazTable."
+description: "Header cell of MazTable, when you write the header by hand."
 package: "maz-ui"
 ---
 
 # MazTableTitle
 
-> MazTableTitle is a building block of MazTable.
+> Header cell of MazTable, when you write the header by hand.
 
 - Package: `maz-ui`
 - Import: `import MazTableTitle from 'maz-ui/components/MazTableTitle'`

package/docs/components/maz-table-virtualizer.md

@@ -1,12 +1,12 @@
 ---
 title: "MazTableVirtualizer"
-description: "MazTableVirtualizer component."
+description: "Renderless provider loaded on demand by MazTable to virtualize long lists of rows."
 package: "maz-ui"
 ---
 
 # MazTableVirtualizer
 
-> MazTableVirtualizer component.
+> Renderless provider loaded on demand by MazTable to virtualize long lists of rows.
 
 - Package: `maz-ui`
 - Import: `import MazTableVirtualizer from 'maz-ui/components/MazTableVirtualizer'`

package/docs/components/maz-tabs-bar.md

@@ -1,12 +1,12 @@
 ---
 title: "MazTabsBar"
-description: "MazTabsBar is a building block of MazTabs."
+description: "Bar of tab buttons of MazTabs."
 package: "maz-ui"
 ---
 
 # MazTabsBar
 
-> MazTabsBar is a building block of MazTabs.
+> Bar of tab buttons of MazTabs.
 
 - Package: `maz-ui`
 - Import: `import MazTabsBar from 'maz-ui/components/MazTabsBar'`

package/docs/components/maz-tabs-content-item.md

@@ -1,12 +1,12 @@
 ---
 title: "MazTabsContentItem"
-description: "MazTabsContentItem is a building block of MazTabs."
+description: "Panel of MazTabs displayed when its tab is active."
 package: "maz-ui"
 ---
 
 # MazTabsContentItem
 
-> MazTabsContentItem is a building block of MazTabs.
+> Panel of MazTabs displayed when its tab is active.
 
 - Package: `maz-ui`
 - Import: `import MazTabsContentItem from 'maz-ui/components/MazTabsContentItem'`

package/docs/components/maz-tabs-content.md

@@ -1,12 +1,12 @@
 ---
 title: "MazTabsContent"
-description: "MazTabsContent is a building block of MazTabs."
+description: "Container of the tab panels of MazTabs."
 package: "maz-ui"
 ---
 
 # MazTabsContent
 
-> MazTabsContent is a building block of MazTabs.
+> Container of the tab panels of MazTabs.
 
 - Package: `maz-ui`
 - Import: `import MazTabsContent from 'maz-ui/components/MazTabsContent'`

package/docs/components/maz-ui-provider.md

@@ -1,12 +1,12 @@
 ---
 title: "MazUiProvider"
-description: "MazUiProvider component."
+description: "Component alternative to the MazUi plugin: provides the theme, the translations and the default props of maz-ui to its subtree (lazy loaded pages, scoped themes)."
 package: "maz-ui"
 ---
 
 # MazUiProvider
 
-> MazUiProvider component.
+> Component alternative to the MazUi plugin: provides the theme, the translations and the default props of maz-ui to its subtree (lazy loaded pages, scoped themes).
 
 - Package: `maz-ui`
 - Import: `import MazUiProvider from 'maz-ui/components/MazUiProvider'`

package/docs/composables/use-aos.md

@@ -1,13 +1,13 @@
 ---
 title: "useAos"
-description: "Vue composable for handling aos plugin in your components"
+description: "Vue composable to access the AOS plugin instance (animations on scroll) in your components, to refresh or trigger the animations"
 package: "maz-ui"
 url: "https://maz-ui.com/composables/use-aos"
 ---
 
 # useAos
 
-> Vue composable for handling aos plugin in your components
+> Vue composable to access the AOS plugin instance (animations on scroll) in your components, to refresh or trigger the animations
 
 - Package: `maz-ui`
 - Import: `import { useAos } from 'maz-ui/composables/useAos'`

package/docs/composables/use-breakpoints.md

@@ -1,11 +1,11 @@
 ---
-title: "useWindowSize"
+title: "useBreakpoints"
 description: "This composable extends the functionality of the useWindowSize composable to manage responsive breakpoints"
 package: "maz-ui"
 url: "https://maz-ui.com/composables/use-breakpoints"
 ---
 
-# useWindowSize
+# useBreakpoints
 
 > This composable extends the functionality of the useWindowSize composable to manage responsive breakpoints
 

package/docs/composables/use-toast.md

@@ -1,13 +1,13 @@
 ---
 title: "useToast"
-description: "Vue composable for handling toast plugin in your components"
+description: "Vue composable to display toast notifications (info, success, warning, error, with actions and buttons) from your components, through the toast plugin"
 package: "maz-ui"
 url: "https://maz-ui.com/composables/use-toast"
 ---
 
 # useToast
 
-> Vue composable for handling toast plugin in your components
+> Vue composable to display toast notifications (info, success, warning, error, with actions and buttons) from your components, through the toast plugin
 
 - Package: `maz-ui`
 - Import: `import { useToast } from 'maz-ui/composables/useToast'`

package/docs/composables/use-user-visibility.md

@@ -1,13 +1,13 @@
 ---
-title: "user-visibility"
-description: "Plugin to see and manage the user page visibility"
+title: "useUserVisibility"
+description: "Vue composable to know whether the user is looking at the page (Page Visibility API), with an optional delay before considering them away"
 package: "maz-ui"
 url: "https://maz-ui.com/composables/use-user-visibility"
 ---
 
-# user-visibility
+# useUserVisibility
 
-> Plugin to see and manage the user page visibility
+> Vue composable to know whether the user is looking at the page (Page Visibility API), with an optional delay before considering them away
 
 - Package: `maz-ui`
 - Import: `import { useUserVisibility } from 'maz-ui/composables/useUserVisibility'`

package/docs/composables/use-wait.md

@@ -1,13 +1,13 @@
 ---
 title: "useWait"
-description: "Vue composable for handling wait plugins"
+description: "Vue composable to manage loading states (start, stop, check) in your components, through the wait plugin and the MazFullscreenLoader"
 package: "maz-ui"
 url: "https://maz-ui.com/composables/use-wait"
 ---
 
 # useWait
 
-> Vue composable for handling wait plugins
+> Vue composable to manage loading states (start, stop, check) in your components, through the wait plugin and the MazFullscreenLoader
 
 - Package: `maz-ui`
 - Import: `import { useWait } from 'maz-ui/composables/useWait'`

package/docs/directives/fullscreen-img.md

@@ -1,13 +1,13 @@
 ---
-title: "v-fullscreen-img"
-description: "Displays images fullscreen on click"
+title: "vFullscreenImg"
+description: "vFullscreenImg is a Vue directive that opens an image in fullscreen on click, with zoom and navigation between the images of a group"
 package: "maz-ui"
 url: "https://maz-ui.com/directives/fullscreen-img"
 ---
 
-# v-fullscreen-img
+# vFullscreenImg
 
-> Displays images fullscreen on click
+> vFullscreenImg is a Vue directive that opens an image in fullscreen on click, with zoom and navigation between the images of a group
 
 - Package: `maz-ui`
 - Import: `import { vFullscreenImg } from 'maz-ui/directives/vFullscreenImg'`

package/docs/ecosystem/icons/icon-set.md

@@ -1,13 +1,13 @@
 ---
-title: "IconSet"
-description: ""
+title: "Icon Set"
+description: "Search and copy the 860+ icons of @maz-ui/icons, with the naming convention and the static, lazy and raw imports of each icon"
 package: "@maz-ui/icons"
 url: "https://maz-ui.com/ecosystem/icons/icon-set"
 ---
 
-# IconSet
+# Icon Set
 
-> 
+> Search and copy the 860+ icons of @maz-ui/icons, with the naming convention and the static, lazy and raw imports of each icon
 
 - Package: `@maz-ui/icons`
 - Web: https://maz-ui.com/ecosystem/icons/icon-set

package/docs/ecosystem/icons/index.md

@@ -1,13 +1,13 @@
 ---
-title: "Icons"
-description: ""
+title: "@maz-ui/icons"
+description: "The @maz-ui/icons package provides 860+ SVG icons (interface icons, brand logos, country flags) as tree-shakable Vue components, lazy components or raw SVG strings"
 package: "@maz-ui/icons"
 url: "https://maz-ui.com/ecosystem/icons/"
 ---
 
-# Icons
+# @maz-ui/icons
 
-> 
+> The @maz-ui/icons package provides 860+ SVG icons (interface icons, brand logos, country flags) as tree-shakable Vue components, lazy components or raw SVG strings
 
 - Package: `@maz-ui/icons`
 - Import: `import { MazCheck } from '@maz-ui/icons/static/MazCheck'` or `import { MazIconsResolver } from '@maz-ui/icons/resolvers'`

package/docs/ecosystem/mcp.md

@@ -23,7 +23,7 @@ It registers the server and writes the maz-ui rules for the agents of your proje
 | `search_docs` | Find what maz-ui provides for a need, described in plain words ("user avatar with initials", "confirm before delete", "debounce search") or by name. Understands the vocabulary of other libraries ("modal", "snackbar", "combobox") |
 | `get_component_api` | Exact API of up to 10 components: props with types, defaults and accepted values, `v-model`, events with payload, slots with bindings, exposed methods |
 | `find_icons` | Icons of `@maz-ui/icons` by meaning ("delete", "settings", "france flag") with their imports |
-| `get_theme_tokens` | Every Tailwind class and CSS variable of the maz-ui theme: colors, radius, shadows, spacing, breakpoints, fonts, z-index, utilities |
+| `get_theme_tokens` | The theme of your project (preset values, `@theme` tokens, variants, utilities, read from your files) and every Tailwind class and CSS variable of the maz-ui theme: colors, radius, shadows, spacing, breakpoints, fonts, z-index, utilities |
 | `get_doc` | Any documentation page by id or name (`components/maz-btn`, `useToast`, `guide/tailwind`), whole or by sections |
 | `list_docs` | Catalog of the components, composables, directives, plugins, helpers, packages and guides |
 | `get_setup_guide` | Installation steps for Vue or Nuxt, with or without Tailwind |

package/docs/ecosystem/nuxt.md

@@ -447,17 +447,21 @@ const agents = {
   rules: false,
   // 'claude' | 'agents-md' | 'cursor' | 'vscode' (default: the detected agents)
   targets: ['claude', 'agents-md'],
+  // Folder where the files are written, relative to the Nuxt app (default: the root of the workspace)
+  dir: '../..',
 }
 // agents: true enables mcp and rules, agents: false disables everything
 ```
 
+In a monorepo, the files are written at the **root of the workspace** (`workspaceDir` of Nuxt), where your agents start, not in the Nuxt app: a single `.mcp.json` serves every app. Set `dir` to choose another folder.
+
 The module runs in development only (never in CI nor in tests), only for the agents it detects in the project (`.claude/`, `CLAUDE.md`, `.mcp.json`, `.cursor/`, `.vscode/mcp.json`, `.github/copilot-instructions.md`, `AGENTS.md`, `.codex/`, `.windsurf/`...), and keeps the files up to date when you upgrade maz-ui:
 
 - `.mcp.json`, `.cursor/mcp.json`, `.vscode/mcp.json`: a `maz-ui` server entry, added only when no maz-ui MCP server is already registered
 - with `rules: true`, `.claude/rules/maz-ui.md`: a Claude Code rule (skipped when Claude reads `AGENTS.md`, i.e. without `CLAUDE.md`)
 - with `rules: true`, `AGENTS.md`: a section delimited by `<!-- BEGIN:maz-ui -->` and `<!-- END:maz-ui -->`, read by Codex, Cursor, Copilot, Windsurf...
 
-It never overwrites a file it does not own: your `CLAUDE.md`, your own rules and the other MCP servers are left untouched. Commit the generated files to share them with your team. See the [AI agents guide](../guide/ai-agents.md) for details.
+It never overwrites a file it does not own: your `CLAUDE.md`, your own rules and the other MCP servers are left untouched, and an existing `maz-ui` server entry (for example pinned to a version) is kept as is. Commit the generated files to share them with your team (check that `.claude/` is not in your `.gitignore`). See the [AI agents guide](../guide/ai-agents.md) for details.
 
 ## Advanced Theming