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

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-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">

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

@@ -103,10 +103,56 @@ For long content, you can enable scrolling in content part (Header and footer sl
   </template>
 </ComponentDemo>
 
+## Width
+
+On tablet and up, the dialog is sized by two CSS variables coming from the active theme preset (`components.dialog`):
+
+- `--maz-dialog-max-width` (default `38rem`)
+- `--maz-dialog-min-width` (default `32rem`)
+
+You can set these defaults globally per preset — see [the theme `components.dialog` documentation](./../ecosystem/themes.md#dialog-sizing). To change the width of a single dialog, pass the `max-width` / `min-width` props — they always override the preset:
+
+<ComponentDemo>
+  <MazBtn @click="widthOpened = true">Open Wide Dialog</MazBtn>
+
+  <MazDialog v-model="widthOpened" title="Custom width" max-width="50rem" min-width="40rem">
+    <p>
+      This dialog overrides the preset width through props.
+    </p>
+    <template #footer="{ close }">
+      <MazBtn @click="close">
+        Confirm
+      </MazBtn>
+    </template>
+  </MazDialog>
+
+<template #code>
+
+```vue
+<template>
+  <MazDialog
+    v-model="isOpen"
+    title="Custom width"
+    max-width="50rem"
+    min-width="40rem"
+  >
+    <p>This dialog overrides the preset width through props.</p>
+  </MazDialog>
+</template>
+```
+
+  </template>
+</ComponentDemo>
+
+::: tip
+The default widths are expressed in `rem`, so they scale with the preset's `base-font-size`. Presets with a larger base size (e.g. `ocean` at `16px`) ship rem values adjusted to keep the rendered pixel width consistent across presets.
+:::
+
 <!--@include: ./../../.vitepress/generated-docs/maz-dialog.doc.md-->
 
 <script setup>
   import { ref } from 'vue'
   const isOpen = ref(false)
   const scollableOpened = ref(false)
+  const widthOpened = ref(false)
 </script>

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

@@ -8,7 +8,7 @@ description: A flexible icon component that accepts Vue components, raw SVG stri
 {{ $frontmatter.description }}
 
 ::: tip
-Download the bundled [icons pack](#all-bundled-icons) or use [`@maz-ui/icons`](../guide/icons.md) for the full set.
+Download the bundled [icons pack](#all-bundled-icons) or use [`@maz-ui/icons`](../ecosystem/icons/.md) for the full set.
 :::
 
 ## How it works
@@ -220,7 +220,7 @@ This pack is the Heroicons set plus a few additions specific to maz-ui.
   Download pack
 </MazBtn>
 
-Source: [Heroicons](https://heroicons.com/) — see also the [icon set page](./../guide/icon-set.md).
+Source: [Heroicons](https://heroicons.com/) — see also the [icon set page](./../ecosystem/icons/icon-set.md).
 
 <div class="flex items-start flex-wrap gap-05">
   <div v-for="({ component, name }, i) in iconsList" :key="i" class="flex flex-col flex-center maz:p-2 maz:rounded-md maz:border">