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

package/docs/generated-docs/maz-switch.doc.md

@@ -1,19 +1,19 @@
 ## Props
 
-| Name            | Description                                  | Type          | Required | Default     |
-| --------------- | -------------------------------------------- | ------------- | -------- | ----------- |
-| **style**       | Style attribut of the component root element | `Native type` | No       | `undefined` |
-| **class**       | Class attribut of the component root element | `Native type` | No       | `undefined` |
-| **model-value** | The model value of the switch                | `boolean`     | No       | `false`     |
-| **id**          | The id of the switch                         | `string`      | No       | `undefined` |
-| **disabled**    | If the switch is disabled                    | `boolean`     | No       | `false`     |
-| **name**        | The name of the switch                       | `string`      | No       | `undefined` |
-| **label**       | Text label                                   | `string`      | No       | `undefined` |
-| **color**       | The color of the switch                      | `MazColor`    | No       | `'primary'` |
-| **error**       | Whether there is an error with the input.    | `boolean`     | No       | `undefined` |
-| **success**     | Whether the input is successful.             | `boolean`     | No       | `undefined` |
-| **warning**     | Whether there is a warning with the input.   | `boolean`     | No       | `undefined` |
-| **hint**        | The hint text to display below the input.    | `string`      | No       | `undefined` |
+| Name            | Description                                  | Type          | Required |
+| --------------- | -------------------------------------------- | ------------- | -------- |
+| **style**       | Style attribut of the component root element | `Native type` | No       |
+| **class**       | Class attribut of the component root element | `Native type` | No       |
+| **model-value** | The model value of the switch                | `boolean`     | No       |
+| **id**          | The id of the switch                         | `string`      | No       |
+| **disabled**    | If the switch is disabled                    | `boolean`     | No       |
+| **name**        | The name of the switch                       | `string`      | No       |
+| **label**       | Text label                                   | `string`      | No       |
+| **color**       | The color of the switch                      | `MazColor`    | No       |
+| **error**       | Whether there is an error with the input.    | `boolean`     | No       |
+| **success**     | Whether the input is successful.             | `boolean`     | No       |
+| **warning**     | Whether there is a warning with the input.   | `boolean`     | No       |
+| **hint**        | The hint text to display below the input.    | `string`      | No       |
 
 ## Events
 

package/docs/generated-docs/maz-table-virtualizer.doc.md

@@ -0,0 +1,20 @@
+## Props
+
+| Name               | Description                                                   | Type                  | Required |
+| ------------------ | ------------------------------------------------------------- | --------------------- | -------- |
+| **count**          | Total number of rows to virtualize.                           | `number`              | Yes      |
+| **scroll-element** | Scrollable viewport element the virtualizer observes.         | `HTMLElement \| null` | No       |
+| **estimate-size**  | Fixed per-row height used to place rows and size the spacers. | `number`              | No       |
+| **overscan**       | Rows rendered outside the viewport on each side.              | `number`              | No       |
+
+## Events
+
+| Event name | Properties | Description |
+| ---------- | ---------- | ----------- |
+| change     |            |
+
+## Slots
+
+| Name    | Description | Bindings |
+| ------- | ----------- | -------- |
+| default |             |          |

package/docs/generated-docs/maz-table.doc.md

@@ -1,42 +1,48 @@
 ## Props
 
-| Name                   | Description                                                                              | Type                                                  | Required | Default                                  | Possible values              |
-| ---------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------- | -------- | ---------------------------------------- | ---------------------------- |
-| **table-class**        | CSS class of the table element                                                           | `HTMLAttributes['class']`                             | No       | `undefined`                              | -                            |
-| **table-style**        | CSS style of the table element                                                           | `HTMLAttributes['style']`                             | No       | `undefined`                              | -                            |
-| **model-value**        | `v-model` <br/>List of selected rows                                                     | `(string \| boolean \| number)[]`                     | No       | `undefined`                              | -                            |
-| **size**               | Size of the table                                                                        | `MazSize`                                             | No       | `'md'`                                   | `xl, lg, md, sm, xs, mini`   |
-| **input-size**         | Size of the search inputs                                                                | `MazSize`                                             | No       | `undefined`                              | `xl, lg, md, sm, xs, mini`   |
-| **title**              | Title of the table                                                                       | `string`                                              | No       | `undefined`                              | -                            |
-| **headers**            | Headers of the table                                                                     | `MazTableHeader[]`                                    | No       | `undefined`                              | -                            |
-| **sortable**           | Enable sort feature on all columns                                                       | `boolean`                                             | No       | `false`                                  | -                            |
-| **headers-align**      | Align all headers                                                                        | `string`                                              | No       | `'left'`                                 | -                            |
-| **rows**               | Rows of the table                                                                        | `T[]`                                                 | No       | `undefined`                              | -                            |
-| **hoverable**          | Add hover effect on rows                                                                 | `boolean`                                             | No       | `false`                                  | -                            |
-| **search**             | Enable search feature in table header                                                    | `boolean`                                             | No       | `false`                                  | -                            |
-| **hide-search-in-row** | Disable search in rows - useful to filter data yourself or make search request to server | `boolean`                                             | No       | `false`                                  | -                            |
-| **hide-search-by**     | Disable search by column (remove select input "search by")                               | `boolean`                                             | No       | `false`                                  | -                            |
-| **search-query**       | `v-model:search-query` <br/>Search query in input                                        | `string`                                              | No       | `undefined`                              | -                            |
-| **background-odd**     | Add background color to odd rows                                                         | `boolean`                                             | No       | `false`                                  | -                            |
-| **background-even**    | Add background color to even rows                                                        | `boolean`                                             | No       | `false`                                  | -                            |
-| **elevation**          | Add shadow to the table                                                                  | `boolean`                                             | No       | `false`                                  | -                            |
-| **divider**            | add divider between rows                                                                 | `boolean`                                             | No       | `false`                                  | -                            |
-| **caption**            | Caption of the table                                                                     | `string`                                              | No       | `undefined`                              | -                            |
-| **caption-side**       | Caption side                                                                             | `string`                                              | No       | `'bottom'`                               | `top, bottom`                |
-| **pagination**         | Add pagination in table footer                                                           | `boolean`                                             | No       | `false`                                  | -                            |
-| **page**               | `v-model:page` <br/>Current page of pagination                                           | `number`                                              | No       | `1`                                      | -                            |
-| **page-size**          | `v-model:page-size` <br/>Number of items per page                                        | `number`                                              | No       | `20`                                     | -                            |
-| **total-pages**        | Total number of pages                                                                    | `number`                                              | No       | `undefined`                              | -                            |
-| **paginate-rows**      | Don't paginate rows - useful to make pagination request with your server                 | `boolean`                                             | No       | `true`                                   | -                            |
-| **total-items**        | Total number of items                                                                    | `number`                                              | No       | `undefined`                              | -                            |
-| **loading**            | Loading state                                                                            | `boolean`                                             | No       | `false`                                  | -                            |
-| **selectable**         | Enable selection of rows                                                                 | `boolean`                                             | No       | `false`                                  | -                            |
-| **selected-key**       | Enable selection of rows - key of the selected row                                       | `string`                                              | No       | `undefined`                              | -                            |
-| **table-layout**       | Table layout                                                                             | `string`                                              | No       | `undefined`                              | `auto, fixed`                |
-| **color**              | Color of the component                                                                   | `MazColor`                                            | No       | `'primary'`                              | -                            |
-| **translations**       | Translations of the table                                                                | `DeepPartial<MazUiTranslationsNestedSchema['table']>` | No       | `Translations from @maz-ui/translations` | -                            |
-| **rounded-size**       | Size radius of the component's border                                                    | `string`                                              | No       | `'md'`                                   | `none, sm, md, lg, xl, full` |
-| **scrollable**         | Enable scrollable on table                                                               | `boolean`                                             | No       | `false`                                  | -                            |
+| Name                     | Description                                                                                                                                                                                                                                                                                             | Type                                                  | Required | Default                                  | Possible values              |
+| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | -------- | ---------------------------------------- | ---------------------------- |
+| **table-class**          | CSS class of the table element                                                                                                                                                                                                                                                                          | `HTMLAttributes['class']`                             | No       | `undefined`                              | -                            |
+| **table-style**          | CSS style of the table element                                                                                                                                                                                                                                                                          | `HTMLAttributes['style']`                             | No       | `undefined`                              | -                            |
+| **model-value**          | `v-model` <br/>List of selected rows                                                                                                                                                                                                                                                                    | `(string \| boolean \| number)[]`                     | No       | `undefined`                              | -                            |
+| **size**                 | Size of the table                                                                                                                                                                                                                                                                                       | `MazSize`                                             | No       | `md`                                     | `xl, lg, md, sm, xs, mini`   |
+| **input-size**           | Size of the search inputs                                                                                                                                                                                                                                                                               | `MazSize`                                             | No       | `undefined`                              | `xl, lg, md, sm, xs, mini`   |
+| **title**                | Title of the table                                                                                                                                                                                                                                                                                      | `string`                                              | No       | `undefined`                              | -                            |
+| **headers**              | Headers of the table                                                                                                                                                                                                                                                                                    | `MazTableHeader[]`                                    | No       | `undefined`                              | -                            |
+| **sortable**             | Enable sort feature on all columns                                                                                                                                                                                                                                                                      | `boolean`                                             | No       | `false`                                  | -                            |
+| **headers-align**        | Align all headers                                                                                                                                                                                                                                                                                       | `string`                                              | No       | `left`                                   | -                            |
+| **rows**                 | Rows of the table                                                                                                                                                                                                                                                                                       | `T[]`                                                 | No       | `undefined`                              | -                            |
+| **hoverable**            | Add hover effect on rows                                                                                                                                                                                                                                                                                | `boolean`                                             | No       | `false`                                  | -                            |
+| **search**               | Enable search feature in table header                                                                                                                                                                                                                                                                   | `boolean`                                             | No       | `false`                                  | -                            |
+| **hide-search-in-row**   | Disable search in rows - useful to filter data yourself or make search request to server                                                                                                                                                                                                                | `boolean`                                             | No       | `false`                                  | -                            |
+| **hide-search-by**       | Disable search by column (remove select input "search by")                                                                                                                                                                                                                                              | `boolean`                                             | No       | `false`                                  | -                            |
+| **search-query**         | `v-model:search-query` <br/>Search query in input                                                                                                                                                                                                                                                       | `string`                                              | No       | `undefined`                              | -                            |
+| **background-odd**       | Add background color to odd rows                                                                                                                                                                                                                                                                        | `boolean`                                             | No       | `false`                                  | -                            |
+| **background-even**      | Add background color to even rows                                                                                                                                                                                                                                                                       | `boolean`                                             | No       | `false`                                  | -                            |
+| **elevation**            | Add shadow to the table                                                                                                                                                                                                                                                                                 | `boolean`                                             | No       | `false`                                  | -                            |
+| **divider**              | add divider between rows                                                                                                                                                                                                                                                                                | `boolean`                                             | No       | `false`                                  | -                            |
+| **caption**              | Caption of the table                                                                                                                                                                                                                                                                                    | `string`                                              | No       | `undefined`                              | -                            |
+| **caption-side**         | Caption side                                                                                                                                                                                                                                                                                            | `string`                                              | No       | `bottom`                                 | `top, bottom`                |
+| **pagination**           | Add pagination in table footer                                                                                                                                                                                                                                                                          | `boolean`                                             | No       | `false`                                  | -                            |
+| **page**                 | `v-model:page` <br/>Current page of pagination                                                                                                                                                                                                                                                          | `number`                                              | No       | `1`                                      | -                            |
+| **page-size**            | `v-model:page-size` <br/>Number of items per page                                                                                                                                                                                                                                                       | `number`                                              | No       | `20`                                     | -                            |
+| **total-pages**          | Total number of pages                                                                                                                                                                                                                                                                                   | `number`                                              | No       | `undefined`                              | -                            |
+| **paginate-rows**        | Don't paginate rows - useful to make pagination request with your server                                                                                                                                                                                                                                | `boolean`                                             | No       | `true`                                   | -                            |
+| **total-items**          | Total number of items                                                                                                                                                                                                                                                                                   | `number`                                              | No       | `undefined`                              | -                            |
+| **loading**              | Loading state                                                                                                                                                                                                                                                                                           | `boolean`                                             | No       | `false`                                  | -                            |
+| **selectable**           | Enable selection of rows                                                                                                                                                                                                                                                                                | `boolean`                                             | No       | `false`                                  | -                            |
+| **selected-key**         | Enable selection of rows - key of the selected row                                                                                                                                                                                                                                                      | `string`                                              | No       | `undefined`                              | -                            |
+| **table-layout**         | Table layout                                                                                                                                                                                                                                                                                            | `string`                                              | No       | `undefined`                              | `auto, fixed`                |
+| **color**                | Color of the component                                                                                                                                                                                                                                                                                  | `MazColor`                                            | No       | `primary`                                | -                            |
+| **translations**         | Translations of the table                                                                                                                                                                                                                                                                               | `DeepPartial<MazUiTranslationsNestedSchema['table']>` | No       | `Translations from @maz-ui/translations` | -                            |
+| **rounded-size**         | Size radius of the component's border                                                                                                                                                                                                                                                                   | `MazRoundedSize`                                      | No       | `md`                                     | `none, sm, md, lg, xl, full` |
+| **scrollable**           | Enable scrollable on table                                                                                                                                                                                                                                                                              | `boolean`                                             | No       | `false`                                  | -                            |
+| **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`                              | -                            |
+| **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`                                  | -                            |
+| **virtualized**          | Only render the rows visible in the viewport (plus an overscan) using `@tanstack/vue-virtual`. Keeps the table fast on thousands of rows. Requires `maxHeight` to bound the scroll viewport. Ignored when `animatedRows` is on or when a custom default slot is provided. Rows render client-side only. | `boolean`                                             | No       | `false`                                  | -                            |
+| **max-height**           | Max height of the scroll viewport (any CSS length, e.g. `'400px'`, `'70vh'`). Enables scrolling and, when `virtualized`, bounds the virtualized viewport.                                                                                                                                               | `string`                                              | No       | `undefined`                              | -                            |
+| **estimated-row-height** | Fixed row height in pixels used by the virtualizer to place rows and size the spacers. Set it to your real row height (virtualized rows should be uniform).                                                                                                                                             | `number`                                              | No       | `44`                                     | -                            |
+| **overscan**             | Number of rows rendered outside the viewport on each side when `virtualized`.                                                                                                                                                                                                                           | `number`                                              | No       | `10`                                     | -                            |
 
 ## Events
 

package/docs/generated-docs/maz-tabs-bar.doc.md

@@ -1,14 +1,25 @@
 ## Props
 
-| Name            | Description                                                                | Type               | Required | Default     |
-| --------------- | -------------------------------------------------------------------------- | ------------------ | -------- | ----------- |
-| **items**       | The items to display in the tabs bar                                       | `MazTabsBarItem[]` | Yes      | `undefined` |
-| **persistent**  | Will add a query param to the url to keep the selected tab on page refresh | `boolean`          | No       | `false`     |
-| **query-param** | The name of the query param to add to the url                              | `string`           | No       | `tab`       |
-| **block**       | Will make the tabs bar full width                                          | `boolean`          | No       | `false`     |
-| **elevation**   | Will remove the elevation                                                  | `boolean`          | No       | `false`     |
-| **auto-scroll** | Will add a scroll on the tabs bar to show selected element                 | `boolean`          | No       | `true`      |
-| **bordered**    | Will add a border to the tabs bar                                          | `boolean`          | No       | `true`      |
+| Name             | Description                                                                                                                                                                                                                                                   | Type                  | Required | Default     | Possible values                                                                                           |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | -------- | ----------- | --------------------------------------------------------------------------------------------------------- |
+| **items**        | The items to display in the tabs bar                                                                                                                                                                                                                          | `TSTypeOperator`      | Yes      | `undefined` | -                                                                                                         |
+| **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` | -                                                                                                         |
+| **size**         | Size of the tabs (forwarded to each MazBtn)                                                                                                                                                                                                                   | `MazSize`             | No       | `md`        | `'xl' \| 'lg' \| 'md' \| 'sm' \| 'xs' \| 'mini'`                                                          |
+| **rounded-size** | Size of the rounded applied to the bar, the indicator and each tab                                                                                                                                                                                            | `MazRoundedSize`      | No       | `md`        | `'none' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full'`                                                        |
+| **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'` |
+| **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`     | -                                                                                                         |
+| **persistent**   | Will add a query param to the url to keep the selected tab on page refresh                                                                                                                                                                                    | `boolean`             | No       | `false`     | -                                                                                                         |
+| **query-param**  | The name of the query param to add to the url                                                                                                                                                                                                                 | `string`              | No       | `tab`       | -                                                                                                         |
+| **block**        | Will make the tabs bar full width                                                                                                                                                                                                                             | `boolean`             | No       | `false`     | -                                                                                                         |
+| **elevation**    | Will remove the elevation                                                                                                                                                                                                                                     | `boolean`             | No       | `false`     | -                                                                                                         |
+| **auto-scroll**  | Will add a scroll on the tabs bar to show selected element                                                                                                                                                                                                    | `boolean`             | No       | `true`      | -                                                                                                         |
+| **bordered**     | Will add a border to the tabs bar                                                                                                                                                                                                                             | `boolean`             | No       | `true`      | -                                                                                                         |
+
+## Events
+
+| Event name         | Properties                                                                              | Description                                               |
+| ------------------ | --------------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| update:model-value | **value** `MazTabsBarItemValue` - item value when provided, otherwise the 1-based index | Emitted when the selected tab changes (standalone usage). |
 
 ## Slots
 

package/docs/generated-docs/maz-tabs.doc.md

@@ -1,8 +1,11 @@
 ## Props
 
-| Name            | Description                 | Type     | Required |
-| --------------- | --------------------------- | -------- | -------- |
-| **model-value** | The the selected tab number | `number` | No       |
+| Name             | Description                                                     | Type             | Required | Possible values                                                                                           |
+| ---------------- | --------------------------------------------------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------- |
+| **model-value**  | The the selected tab number                                     | `number`         | No       | -                                                                                                         |
+| **size**         | Size of the tabs, forwarded to MazTabsBar (and each tab button) | `MazSize`        | No       | `'xl' \| 'lg' \| 'md' \| 'sm' \| 'xs' \| 'mini'`                                                          |
+| **rounded-size** | Size of the rounded, forwarded to MazTabsBar                    | `MazRoundedSize` | No       | `'none' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full'`                                                        |
+| **color**        | Color of the active tab indicator, forwarded to MazTabsBar      | `MazColor`       | No       | `'primary' \| 'secondary' \| 'accent' \| 'info' \| 'success' \| 'warning' \| 'destructive' \| 'contrast'` |
 
 ## Events
 

package/docs/generated-docs/maz-textarea.doc.md

@@ -1,30 +1,32 @@
 ## Props
 
-| Name               | Description                                                                                                                                        | Type                                                                                  | Required | Default         | Possible values                                                                       |
-| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | -------- | --------------- | ------------------------------------------------------------------------------------- |
-| **style**          | Style attribut of the component root element                                                                                                       | `Native type`                                                                         | No       | `undefined`     | -                                                                                     |
-| **class**          | Class attribut of the component root element                                                                                                       | `Native type`                                                                         | No       | `undefined`     | -                                                                                     |
-| **model-value**    | `v-model` <br/>                                                                                                                                    | `T`                                                                                   | No       | `undefined`     | -                                                                                     |
-| **id**             | The id of the textarea                                                                                                                             | `string`                                                                              | No       | `undefined`     | -                                                                                     |
-| **name**           | The name of the textarea                                                                                                                           | `string`                                                                              | No       | `'MazTextarea'` | -                                                                                     |
-| **label**          | The label of the textarea                                                                                                                          | `string`                                                                              | No       | `undefined`     | -                                                                                     |
-| **placeholder**    | The placeholder of the textarea                                                                                                                    | `string`                                                                              | No       | `undefined`     | -                                                                                     |
-| **required**       | If the textarea is required                                                                                                                        | `boolean`                                                                             | No       | `false`         | -                                                                                     |
-| **disabled**       | If the textarea is disabled                                                                                                                        | `boolean`                                                                             | No       | `false`         | -                                                                                     |
-| **readonly**       | If the textarea is readonly                                                                                                                        | `boolean`                                                                             | No       | `false`         | -                                                                                     |
-| **error**          | If the textarea has an error                                                                                                                       | `boolean`                                                                             | No       | `false`         | -                                                                                     |
-| **success**        | If the textarea has a success                                                                                                                      | `boolean`                                                                             | No       | `false`         | -                                                                                     |
-| **warning**        | If the textarea has a warning                                                                                                                      | `boolean`                                                                             | No       | `false`         | -                                                                                     |
-| **hint**           | The hint of the textarea                                                                                                                           | `string`                                                                              | No       | `undefined`     | -                                                                                     |
-| **color**          | The color of the textarea                                                                                                                          | `MazColor`                                                                            | No       | `'primary'`     | -                                                                                     |
-| **rounded-size**   | Size radius of the component's border                                                                                                              | `"none" \| "sm" \| "md" \| "lg" \| "xl" \| "full"`                                    | No       | `'md'`          | `'none' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full'`                                    |
-| **padding**        | If the textarea has a padding                                                                                                                      | `boolean`                                                                             | No       | `true`          | -                                                                                     |
-| **transparent**    | If the textarea has a transparent background                                                                                                       | `boolean`                                                                             | No       | `false`         | -                                                                                     |
-| **border**         | If the textarea has no border                                                                                                                      | `boolean`                                                                             | No       | `true`          | -                                                                                     |
-| **autogrow**       | If the textarea should autogrow based on its content                                                                                               | `boolean`                                                                             | No       | `true`          | -                                                                                     |
-| **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'` |
-| **top-label**      | Static label displayed above the textarea. Unlike the floating label, this remains fixed                                                           | `string`                                                                              | No       | `undefined`     | -                                                                                     |
-| **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`     | -                                                                                     |
+| Name               | Description                                                                                                                                                                    | Type                                                                                  | Required | Default     | Possible values                                                                       |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- | -------- | ----------- | ------------------------------------------------------------------------------------- |
+| **style**          | Style attribut of the component root element                                                                                                                                   | `Native type`                                                                         | No       | `undefined` | -                                                                                     |
+| **class**          | Class attribut of the component root element                                                                                                                                   | `Native type`                                                                         | No       | `undefined` | -                                                                                     |
+| **model-value**    | `v-model` <br/>                                                                                                                                                                | `T`                                                                                   | No       | `undefined` | -                                                                                     |
+| **id**             | The id of the textarea                                                                                                                                                         | `string`                                                                              | No       | `undefined` | -                                                                                     |
+| **name**           | The name of the textarea                                                                                                                                                       | `string`                                                                              | No       | `undefined` | -                                                                                     |
+| **label**          | The label of the textarea                                                                                                                                                      | `string`                                                                              | No       | `undefined` | -                                                                                     |
+| **placeholder**    | The placeholder of the textarea                                                                                                                                                | `string`                                                                              | No       | `undefined` | -                                                                                     |
+| **required**       | If the textarea is required                                                                                                                                                    | `boolean`                                                                             | No       | `undefined` | -                                                                                     |
+| **disabled**       | If the textarea is disabled                                                                                                                                                    | `boolean`                                                                             | No       | `undefined` | -                                                                                     |
+| **readonly**       | If the textarea is readonly                                                                                                                                                    | `boolean`                                                                             | No       | `undefined` | -                                                                                     |
+| **error**          | If the textarea has an error                                                                                                                                                   | `boolean`                                                                             | No       | `undefined` | -                                                                                     |
+| **success**        | If the textarea has a success                                                                                                                                                  | `boolean`                                                                             | No       | `undefined` | -                                                                                     |
+| **warning**        | If the textarea has a warning                                                                                                                                                  | `boolean`                                                                             | No       | `undefined` | -                                                                                     |
+| **hint**           | The hint of the textarea                                                                                                                                                       | `string`                                                                              | No       | `undefined` | -                                                                                     |
+| **color**          | The color of the textarea                                                                                                                                                      | `MazColor`                                                                            | No       | `undefined` | -                                                                                     |
+| **rounded-size**   | Size radius of the component's border                                                                                                                                          | `MazRoundedSize`                                                                      | No       | `md`        | -                                                                                     |
+| **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`                                                            |
+| **padding**        | If the textarea has a padding                                                                                                                                                  | `boolean`                                                                             | No       | `true`      | -                                                                                     |
+| **transparent**    | If the textarea has a transparent background                                                                                                                                   | `boolean`                                                                             | No       | `false`     | -                                                                                     |
+| **border**         | If the textarea has no border                                                                                                                                                  | `boolean`                                                                             | No       | `false`     | -                                                                                     |
+| **autogrow**       | If the textarea should autogrow based on its content                                                                                                                           | `boolean`                                                                             | No       | `true`      | -                                                                                     |
+| **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`         | -                                                                                     |
+| **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'` |
+| **top-label**      | Static label displayed above the textarea. Unlike the floating label, this remains fixed                                                                                       | `string`                                                                              | No       | `undefined` | -                                                                                     |
+| **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` | -                                                                                     |
 
 ## Events
 

package/docs/generated-docs/maz-ticker.doc.md

@@ -11,7 +11,7 @@
 | **pause-on-focus**            | Pause animation when a child element receives focus                              | `boolean`                                                                                            | No       | `false`      | -                            |
 | **paused**                    | Programmatic pause control - takes precedence over pauseOnHover and pauseOnFocus | `boolean`                                                                                            | No       | `false`      | -                            |
 | **overlay**                   | Show gradient overlays on edges to fade content in/out                           | `boolean`                                                                                            | No       | `true`       | -                            |
-| **overlay-size**              | Size of the gradient overlay zones (CSS value)                                   | `string`                                                                                             | No       | `33%`        | -                            |
+| **overlay-size**              | Size of the gradient overlay zones (CSS value)                                   | `MazSizeUnit`                                                                                        | No       | `33%`        | -                            |
 | **animation-timing-function** | CSS animation timing function                                                    | `string`                                                                                             | No       | `linear`     | -                            |
 
 ## Slots

package/docs/generated-docs/maz-timeline.doc.md

@@ -16,10 +16,10 @@
 
 ## Events
 
-| Event name        | Properties                                        | Description                              |
-| ----------------- | ------------------------------------------------- | ---------------------------------------- |
-| update:modelValue | **value** `mixed` - The new active step index     | Emitted when the active step changes     |
-| click-step        | **payload** `mixed` - The step data and its index | Emitted when a clickable step is clicked |
+| Event name         | Properties                                        | Description                              |
+| ------------------ | ------------------------------------------------- | ---------------------------------------- |
+| update:model-value | **value** `mixed` - The new active step index     | Emitted when the active step changes     |
+| click-step         | **payload** `mixed` - The step data and its index | Emitted when a clickable step is clicked |
 
 ## Slots
 

package/docs/generated-docs/maz-window-mockup.doc.md

@@ -0,0 +1,23 @@
+## Props
+
+| Name              | Description                                                                                       | Type                                                     | Required | Default     | Possible values                     |
+| ----------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | -------- | ----------- | ----------------------------------- |
+| **id**            | Stable id used to scope the empty-state SVG pattern. Auto-generated if not provided.              | `string`                                                 | No       | `undefined` | -                                   |
+| **variant**       | Window style variant                                                                              | `MazWindowMockupVariant`                                 | No       | `browser`   | `browser' \| 'terminal' \| 'editor` |
+| **url**           | URL to display in the browser address bar (browser variant only)                                  | `string`                                                 | No       | `localhost` | -                                   |
+| **filename**      | Filename to display in the editor tab (editor variant only)                                       | `string`                                                 | No       | `index.vue` | -                                   |
+| **title**         | Title to display in the terminal title bar (terminal variant only)                                | `string`                                                 | No       | `zsh`       | -                                   |
+| **min-height**    | Minimum height of the content area as a CSS value (e.g. '200px')                                  | `string`                                                 | No       | `undefined` | -                                   |
+| **code**          | Source code to display using MazCodeHighlight. Takes priority over the default slot.              | `string`                                                 | No       | `undefined` | -                                   |
+| **language**      | Language identifier for syntax highlighting (e.g. 'vue', 'ts', 'bash')                            | `string`                                                 | No       | `undefined` | -                                   |
+| **label**         | Label displayed inside the empty-state placeholder when no code and no slot content are provided. | `string`                                                 | No       | `undefined` | -                                   |
+| **hide-prompt**   | Whether to hide the terminal prompt prefix (no-op on non-terminal variants)                       | `boolean`                                                | No       | `false`     | -                                   |
+| **prompt**        | Prefix to display before the code in the terminal (terminal variant only)                         | `string`                                                 | No       | `$`         | -                                   |
+| **hide-url-copy** | Hide the copy-to-clipboard button next to the URL bar (browser variant only).                     | `boolean`                                                | No       | `false`     | -                                   |
+| **translations**  | Custom translations for the component. Override either key independently.                         | `Partial<MazUiTranslationsNestedSchema['windowMockup']>` | No       | `undefined` | -                                   |
+
+## Slots
+
+| Name    | Description                                                            | Bindings |
+| ------- | ---------------------------------------------------------------------- | -------- |
+| default | Free content (image, interface, etc.) shown when code prop is not set. |          |

package/docs/src/blog/v4.md

@@ -236,7 +236,7 @@ export default defineNuxtConfig({
 To help with migration from v3 to v4:
 
 - **[Complete Migration Guide](../guide/migration-v4.md)** - Step-by-step migration instructions
-- **[MCP Integration](../guide/mcp.md)** - Connect AI agents for migration assistance
+- **[MCP Integration](../ecosystem/mcp.md)** - Connect AI agents for migration assistance
 - **[Interactive Examples](../index.md)** - Live demonstrations of new features
 - **[Community Support](https://github.com/LouisMazel/maz-ui/discussions)** - Get help from the community
 

package/docs/src/blog/v5.md

@@ -90,22 +90,20 @@ npx @maz-ui/upgrade ./ --dry-run
 npx @maz-ui/upgrade ./
 ```
 
-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.
-
-It respects your `.gitignore`, walks `.vue`/`.css`/`.ts`/`.tsx`/`.cts`/`.mts`/`.js`/`.jsx`/`.cjs`/`.mjs` and `package.json`, and skips the usual build dirs.
+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)
 
 ### `@maz-ui/mcp` — for everything else
 
 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.
 
-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.
+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.
 
 ```bash
 # Claude Code
 claude mcp add maz-ui npx @maz-ui/mcp --scope project
 ```
 
-Cursor, Windsurf, VS Code Copilot, Cline and Claude Desktop are all in the [MCP guide](/guide/mcp).
+Cursor, Windsurf, VS Code Copilot, Cline and Claude Desktop are all in the [MCP guide](/ecosystem/mcp).
 
 ### The full guide
 
@@ -157,11 +155,11 @@ export default defineNuxtConfig({
 ## Essential Links
 
 - **[v5 Migration Guide](/guide/migration-v5)** — every breaking change, the upgrade CLI, the MCP flow
-- **[Theming](/guide/themes)** — preset authoring, `scales` and `components` blocks, runtime switching
+- **[Theming](/ecosystem/themes)** — preset authoring, `scales` and `components` blocks, runtime switching
 - **[Browser Support](/guide/browser-support)** — minimum versions and the features they enable
 - **[Tailwind integration](/guide/tailwind)** — for consumers who ship their own Tailwind setup
 - **[`@maz-ui/upgrade` README](https://github.com/LouisMazel/maz-ui/tree/master/packages/upgrade)** — full transform list and CLI reference
-- **[Model Context Protocol (MCP)](/guide/mcp)** — connect AI assistants to the Maz-UI docs
+- **[Model Context Protocol (MCP)](/ecosystem/mcp)** — connect AI assistants to the Maz-UI docs
 - **[GitHub Repository](https://github.com/LouisMazel/maz-ui)** — source code & issues
 - **[Changelog](https://github.com/LouisMazel/maz-ui/blob/master/CHANGELOG.md)** — detailed release notes
 

package/docs/src/components/maz-avatar.md

@@ -15,7 +15,7 @@ This component uses [vLazyImg](./../directives/lazy-img.md) directive
 
 ## Basic usage
 
-<MazAvatar :lazy="false" src="https://api.dicebear.com/7.x/big-smile/svg?backgroundColor=1d90ff&scale=80" />
+<MazAvatar src="https://api.dicebear.com/7.x/big-smile/svg?backgroundColor=1d90ff&scale=80" />
 
 ```vue
 <script lang="ts" setup>
@@ -87,7 +87,6 @@ function clicked() { console.log('clicked') }
     target="_blank"
     rounded-size="none"
     clickable
-    no-size
   >
     <template #icon>
       <MazIcon icon="/eye.svg" />
@@ -108,12 +107,43 @@ function clicked() { console.log('clicked') }
 </template>
 ```
 
+## Initials from caption
+
+When no `src` is provided, `MazAvatar` displays initials generated from the `caption`. The `letter-count` prop (default `2`) controls how many letters are displayed:
+
+- **Single word**: the first `letter-count` characters of the word are used.
+- **Multiple words**: the first letter of each of the first `letter-count` words is used.
+
+Initials are always uppercased.
+
+<div class="flex gap-05 items-center flex-wrap">
+  <MazAvatar caption="admin" size="3rem" />
+  <MazAvatar caption="admin" :letter-count="3" size="3rem" />
+  <MazAvatar caption="Louis Mazel" size="3rem" />
+  <MazAvatar caption="Jean Claude Dus" :letter-count="3" size="3rem" />
+</div>
+
+```vue
+<template>
+  <!-- "AD" -->
+  <MazAvatar caption="admin" />
+  <!-- "ADM" -->
+  <MazAvatar caption="admin" :letter-count="3" />
+  <!-- "LM" -->
+  <MazAvatar caption="Louis Mazel" />
+  <!-- "JCD" -->
+  <MazAvatar caption="Jean Claude Dus" :letter-count="3" />
+</template>
+```
+
 ## On Error
 
-<MazAvatar @error="error" />
+When no `src` (and no `caption`) is provided, or when the image fails to load, `MazAvatar` displays the default `no-image` placeholder.
+
+<MazAvatar @error="error" src="https://broken-link-image-src.example" />
 
 ```html
-<MazAvatar @error="error" />
+<MazAvatar @error="error" src="https://broken-link-image-src.example" />
 ```
 
 ## Fallback image loaded on error
@@ -171,6 +201,24 @@ These modes are native use an `HTMLImageElement` with the `loading` attribute. (
 <MazAvatar loading="eager" src="https://api.dicebear.com/7.x/big-smile/svg?backgroundColor=1d90ff&scale=80&seed=123" />
 ```
 
+## Image height full
+
+By default the image fills the avatar **width** (`width: 100%`). Enable `image-height-full` to make the image fill the **height** instead: it keeps its aspect ratio, fills 100% of the height and overflows/crops horizontally. This is ideal for wide images or SVGs (like flags) that must cover the whole avatar.
+
+<div class="flex gap-05 items-center flex-wrap">
+  <MazAvatar class="vp-raw" size="4rem" src="https://placedog.net/300/200?id=7" />
+  <MazAvatar class="vp-raw" size="4rem" image-height-full src="https://placedog.net/300/200?id=7" />
+</div>
+
+```vue
+<template>
+  <!-- default: width 100% -->
+  <MazAvatar src="https://placedog.net/300/200" />
+  <!-- height 100%, cropped on the sides -->
+  <MazAvatar image-height-full src="https://placedog.net/300/200" />
+</template>
+```
+
 <script lang="ts" setup>
   const clicked = () => { console.log('clicked') }
   const error = (el) => { console.error('error', el) }