@maz-ui/mcp 5.0.0-beta.2 → 5.0.0-beta.25

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

@@ -0,0 +1,36 @@
+## Props
+
+| Name             | Description                                                                                                                                                                                                                                                                                     | Type                                         | Required | Default            |
+| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | -------- | ------------------ |
+| **id**           | Unique identifier for the sidebar (auto-generated if not provided)                                                                                                                                                                                                                              | `string`                                     | No       | `undefined`        |
+| **open**         | Whether the sidebar is open                                                                                                                                                                                                                                                                     | `boolean`                                    | No       | `undefined`        |
+| **side**         | Side of the sidebar                                                                                                                                                                                                                                                                             | `"start" \| "end"`                           | No       | `undefined`        |
+| **collapsible**  | How the sidebar collapses - offcanvas: completely hidden - icon: only icons visible - hover: only icons visible by default, expands on mouse hover or keyboard focus (transient visual state — does not update `v-model:open` nor the persistence cookie) - none: always fully visible          | `"offcanvas" \| "icon" \| "hover" \| "none"` | No       | `undefined`        |
+| **mode**         | How the sidebar affects layout - push: sidebar is in document flow - overlay: sidebar floats over content with a backdrop                                                                                                                                                                       | `"push" \| "overlay"`                        | No       | `undefined`        |
+| **width**        | Width of the expanded sidebar                                                                                                                                                                                                                                                                   | `string`                                     | No       | `undefined`        |
+| **icon-width**   | Width of the collapsed sidebar in icon mode                                                                                                                                                                                                                                                     | `string`                                     | No       | `undefined`        |
+| **tooltip-mode** | When descendant `MazSidebarMenuButton` components should display their tooltip. - `always`: tooltip shows on hover regardless of the sidebar state - `closed`: tooltip only shows on hover when the sidebar is collapsed Individual buttons can override this via their own `tooltipMode` prop. | `MazSidebarTooltipMode`                      | No       | `closed`           |
+| **persist**      | Persist the open/collapsed state in a cookie so it survives reloads. Restoration happens on client mount (SSR-safe). For zero-flash SSR, read the cookie server-side and forward it via `v-model:open`.                                                                                         | `boolean`                                    | No       | `true`             |
+| **persist-key**  | Cookie key used when `persist` is enabled. Set a unique key per sidebar instance if you mount several sidebars on the same site.                                                                                                                                                                | `string`                                     | No       | `maz-sidebar-open` |
+
+## Events
+
+| Event name  | Properties | Description                     |
+| ----------- | ---------- | ------------------------------- |
+| update:open |            | Emitted when open state changes |
+
+## Slots
+
+| Name    | Description | Bindings |
+| ------- | ----------- | -------- |
+| default |             |          |
+
+## Expose
+
+### toggle
+
+>
+
+### setOpen
+
+>

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

@@ -7,7 +7,7 @@
 | **min**         | min value of sliders                      | `number`                               | No       |
 | **max**         | max value of sliders                      | `number`                               | No       |
 | **step**        | step value for slider increments          | `number`                               | No       |
-| **size**        | height size of slider bar                 | `string`                               | No       |
+| **size**        | height size of slider bar                 | `MazSizeUnit`                          | No       |
 | **divider**     | remove div in different colors            | `boolean`                              | No       |
 | **log**         | become a logarithmic slider (exponential) | `boolean`                              | No       |
 | **color**       | main slider color                         | `MazColor`                             | No       |

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

@@ -1,6 +1,6 @@
 ## Props
 
-| Name      | Description              | Type       | Required | Default |
-| --------- | ------------------------ | ---------- | -------- | ------- |
-| **size**  | The size of the spinner  | `string`   | No       | `2em`   |
-| **color** | The color of the spinner | `MazColor` | No       | `theme` |
+| Name      | Description              | Type          | Required | Default |
+| --------- | ------------------------ | ------------- | -------- | ------- |
+| **size**  | The size of the spinner  | `MazSizeUnit` | No       | `2em`   |
+| **color** | The color of the spinner | `MazColor`    | No       | `theme` |

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.doc.md

@@ -5,12 +5,12 @@
 | **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`   |
+| **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'`                                 | -                            |
+| **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`                                  | -                            |
@@ -22,7 +22,7 @@
 | **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`                |
+| **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`                                     | -                            |
@@ -33,9 +33,9 @@
 | **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'`                              | -                            |
+| **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` |
+| **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`                                  | -                            |
 
 ## Events

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

@@ -1,29 +1,30 @@
 ## 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`     | -                                                                                     |
+| 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`        | -                                                                                     |
+| **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`      | -                                                                                     |
+| **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-btn.md

@@ -454,7 +454,7 @@ Check out how [MazIcon](./maz-icon.md) works, see all available icons and downlo
 
 :::
 
-### Use [@maz-ui/icons](./../guide/icons.md)
+### Use [@maz-ui/icons](./../ecosystem/icons/.md)
 
 ::: details View code
 

package/docs/src/components/maz-code-highlight.md

@@ -0,0 +1,233 @@
+---
+title: MazCodeHighlight
+description: MazCodeHighlight displays source code with syntax highlighting powered by shiki. It auto-detects dark/light mode, ships with a copy-to-clipboard button, a language badge, and supports lazy loading.
+---
+
+# {{ $frontmatter.title }}
+
+{{ $frontmatter.description }}
+
+<!--@include: ./../../.vitepress/mixins/getting-started.md-->
+
+## Installation requirement
+
+Install [`shiki`](https://shiki.style) in your project to enable highlighting:
+
+::: code-group
+
+```bash [pnpm]
+pnpm add shiki
+```
+
+```bash [npm]
+npm install shiki
+```
+
+```bash [yarn]
+yarn add shiki
+```
+
+:::
+
+If `shiki` is not installed, the component falls back to a plain `<pre><code>` block.
+
+## Basic usage
+
+<ComponentDemo>
+  <MazCodeHighlight code="const greeting = 'Hello, maz-ui!'" language="ts" />
+
+  <template #code>
+
+```vue
+<template>
+  <MazCodeHighlight code="const greeting = 'Hello, maz-ui!'" language="ts" />
+</template>
+
+<script lang="ts" setup>
+  import MazCodeHighlight from 'maz-ui/components/MazCodeHighlight'
+</script>
+```
+
+  </template>
+</ComponentDemo>
+
+## With slot
+
+The default slot text is used as source code when the `code` prop is not provided. This is useful for plain text blocks.
+
+<ComponentDemo>
+  <MazCodeHighlight language="bash">npm install maz-ui</MazCodeHighlight>
+
+  <template #code>
+
+```vue
+<template>
+  <MazCodeHighlight language="bash">npm install maz-ui</MazCodeHighlight>
+</template>
+
+<script lang="ts" setup>
+  import MazCodeHighlight from 'maz-ui/components/MazCodeHighlight'
+</script>
+```
+
+  </template>
+</ComponentDemo>
+
+## Languages
+
+Pass any valid [shiki language identifier](https://shiki.style/languages) to the `language` prop. The chosen language is also displayed as a small badge in the top-right corner (the badge fades out on hover when the copy button appears).
+
+<ComponentDemo>
+  <MazCodeHighlight language="vue" :code="vueExample" />
+
+  <template #code>
+
+```vue
+<template>
+  <MazCodeHighlight language="vue" :code="vueExample" />
+</template>
+
+<script lang="ts" setup>
+  import MazCodeHighlight from 'maz-ui/components/MazCodeHighlight'
+
+  const vueExample = `<script lang="ts" setup>
+  import { ref } from 'vue'
+  const count = ref(0)
+<\/script>
+
+<template>
+  <button @click="count++">Count: {{ count }}</button>
+</template>`
+</script>
+```
+
+  </template>
+</ComponentDemo>
+
+## Custom theme
+
+Override the auto-detected theme with any [shiki built-in theme](https://shiki.style/themes).
+
+<ComponentDemo>
+  <MazCodeHighlight code="console.log('dracula theme')" language="js" theme="dracula" />
+
+  <template #code>
+
+```vue
+<template>
+  <MazCodeHighlight code="console.log('dracula theme')" language="js" theme="dracula" />
+</template>
+
+<script lang="ts" setup>
+  import MazCodeHighlight from 'maz-ui/components/MazCodeHighlight'
+</script>
+```
+
+  </template>
+</ComponentDemo>
+
+## Copy to clipboard
+
+A copy button is displayed in the top-right corner on hover (or when focused via keyboard). Clicking it writes the resolved code to the clipboard and shows a check icon for ~1.5s.
+
+### Disable the copy button
+
+Set `:copyable="false"` to hide the button entirely.
+
+<ComponentDemo>
+  <MazCodeHighlight code="const noCopyButton = true" language="ts" :copyable="false" />
+
+  <template #code>
+
+```vue
+<template>
+  <MazCodeHighlight code="const noCopyButton = true" language="ts" :copyable="false" />
+</template>
+```
+
+  </template>
+</ComponentDemo>
+
+### Copy a different value than the displayed code
+
+Use `copyValue` when the displayed source differs from what should be copied — for example to strip a leading `$` prompt when rendering a shell command. This is the mechanism `MazWindowMockup` uses internally to keep the terminal prompt out of the clipboard.
+
+<ComponentDemo>
+  <MazCodeHighlight code="$ pnpm add maz-ui" copy-value="pnpm add maz-ui" language="bash" />
+
+  <template #code>
+
+```vue
+<template>
+  <MazCodeHighlight
+    code="$ pnpm add maz-ui"
+    copy-value="pnpm add maz-ui"
+    language="bash"
+  />
+</template>
+```
+
+  </template>
+</ComponentDemo>
+
+## Disable rounded corners
+
+Set `:rounded="false"` to render the highlighted block with squared corners — useful when embedding inside another container that already has its own border-radius (e.g. inside `MazWindowMockup`).
+
+<ComponentDemo>
+  <MazCodeHighlight code="// squared corners" language="ts" :rounded="false" />
+
+  <template #code>
+
+```vue
+<template>
+  <MazCodeHighlight code="// squared corners" language="ts" :rounded="false" />
+</template>
+```
+
+  </template>
+</ComponentDemo>
+
+## Custom translations
+
+The copy button's aria-label and tooltip come from the `@maz-ui/translations` package (`codeHighlight.copyToClipboard` / `codeHighlight.copiedToClipboard`). You can override either key per-instance with the `translations` prop without touching the global locale:
+
+<ComponentDemo>
+  <MazCodeHighlight
+    code="const hello = 'world'"
+    language="ts"
+    :translations="{ copyToClipboard: 'Copier le code', copiedToClipboard: 'Copié !' }"
+  />
+
+  <template #code>
+
+```vue
+<template>
+  <MazCodeHighlight
+    code="const hello = 'world'"
+    language="ts"
+    :translations="{
+      copyToClipboard: 'Copier le code',
+      copiedToClipboard: 'Copié !',
+    }"
+  />
+</template>
+```
+
+  </template>
+</ComponentDemo>
+
+For app-wide translations, set up the [maz-ui translations plugin](/translations) and the component will pick up your locale automatically.
+
+<script lang="ts" setup>
+  const vueExample = `<script lang="ts" setup>
+  import { ref } from 'vue'
+  const count = ref(0)
+<\/script>
+
+<template>
+  <button @click="count++">Count: {{ count }}</button>
+</template>`
+</script>
+
+<!--@include: ./../../.vitepress/generated-docs/maz-code-highlight.doc.md-->

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

@@ -301,7 +301,7 @@ Use the `header` slot to fully customize the header, or use `title`, `icon-start
 <ComponentDemo>
   <MazContainer
     title="Dashboard Overview"
-    start-icon="chart-bar"
+    start-icon="/chart-bar.svg"
     elevation
     :bordered="false"
     rounded-size="xl"
@@ -329,7 +329,7 @@ Use the `header` slot to fully customize the header, or use `title`, `icon-start
 <template>
   <MazContainer
     title="Dashboard Overview"
-    start-icon="chart-bar"
+    start-icon="/chart-bar.svg"
     elevation
     :bordered="false"
     rounded-size="xl"

package/docs/src/components/maz-date-picker.md

@@ -896,7 +896,7 @@ const disabledHours = [0, 1, 2, 11, 22, 23]
 
 ## Internationalization
 
-MazDatePicker supports full internationalization. **By default, it uses the locale from the [MazUiTranslations](../guide/translations.md) plugin**, but you can override it:
+MazDatePicker supports full internationalization. **By default, it uses the locale from the [MazUiTranslations](../ecosystem/translations.md) plugin**, but you can override it:
 
 <ComponentDemo>
   <div class="maz:grid maz:grid-cols-1 maz:mob-l:grid-cols-2 maz:gap-4">