@maz-ui/mcp 5.0.0-beta.3 → 5.0.0-beta.31

package/docs/generated-docs/maz-input-phone-number.doc.md

@@ -1,43 +1,47 @@
 ## Props
 
-| Name                          | Description                                                                                                                       | Type                                                         | Required | Default                                                                                                                                                                                                                           | Possible values                                                             |
-| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
-| **style**                     | Style attribut of the component root element                                                                                      | `HTMLAttributes['style']`                                    | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **class**                     | Class attribut of the component root element                                                                                      | `HTMLAttributes['class']`                                    | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **model-value**               | `v-model` <br/>The current value of the input field in international format (e.g. +33612345678)<br/>**Example:** `"+33612345678"` | `string \| undefined \| null`                                | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **country-code**              | `v-model:country-code` <br/>The selected country code (e.g. "FR")<br/>**Example:** `"FR"`                                         | `CountryCode \| undefined \| null`                           | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **id**                        | Unique identifier for the component<br/>**Example:** `"phone-input-1"`                                                            | `string`                                                     | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **placeholder**               | Text displayed when the input is empty<br/>**Example:** `"Enter your phone number"`                                               | `string`                                                     | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **label**                     | Label displayed above the input<br/>**Example:** `"Phone Number"`                                                                 | `string`                                                     | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **preferred-countries**       | List of country codes to place first in the select list<br/>**Example:** `["FR", "BE", "GE"]`                                     | `CountryCode[]`                                              | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **ignored-countries**         | List of country codes to be removed from the select list<br/>**Example:** `["FR", "BE", "GE"]`                                    | `CountryCode[]`                                              | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **only-countries**            | List of country codes to only have the countries selected in the select list<br/>**Example:** `["FR", "BE", "GE"]`                | `CountryCode[]`                                              | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **translations**              | Locale strings of the component The default values are the translations of the MazUiTranslations plugin                           | `Partial<MazUiTranslationsNestedSchema['inputPhoneNumber']>` | No       | `{   countrySelect: {     error: 'Choose country',     placeholder: 'Country code',     searchPlaceholder: 'Search the country',   },   phoneInput: {     placeholder: 'Phone number',     example: 'Example: {example}',   }, }` | -                                                                           |
-| **list-position**             | Position where the list of countries will be opened                                                                               | `MazPopoverProps['position']`                                | No       | `'bottom-start'`                                                                                                                                                                                                                  | `top left, top right, bottom left, bottom right`                            |
-| **color**                     | Component color applied                                                                                                           | `MazColor`                                                   | No       | `'primary'`                                                                                                                                                                                                                       | `primary, secondary, accent, info, success, warning, destructive, contrast` |
-| **size**                      | Component size applied                                                                                                            | `MazSize`                                                    | No       | `'md'`                                                                                                                                                                                                                            | `xs, sm, md, lg, xl, mini`                                                  |
-| **hide-flags**                | Remove flags in country list                                                                                                      | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
-| **disabled**                  | Make the input disabled                                                                                                           | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
-| **required**                  | Make the input required                                                                                                           | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
-| **example**                   | Show the phone number example                                                                                                     | `boolean`                                                    | No       | `true`                                                                                                                                                                                                                            | -                                                                           |
-| **search**                    | Disable search input in country list                                                                                              | `boolean`                                                    | No       | `true`                                                                                                                                                                                                                            | -                                                                           |
-| **search-threshold**          | Threshold of the search input in country list where 1 is a perfect match and 0 is a match with any character                      | `number`                                                     | No       | `0.75`                                                                                                                                                                                                                            | -                                                                           |
-| **use-browser-locale**        | If true, the browser locale will be used                                                                                          | `boolean`                                                    | No       | `true`                                                                                                                                                                                                                            | -                                                                           |
-| **fetch-country**             | The component will make a request (https://ipwho.is) to get the location of the user and use it to set the default country code   | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
-| **hide-country-select**       | Hide the country selector                                                                                                         | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
-| **show-code-in-list**         | Show country calling code in the country list                                                                                     | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
-| **custom-countries-list**     | Replace country names                                                                                                             | `Record<CountryCode, string>`                                | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **auto-format**               | Disabled auto-format when phone is valid                                                                                          | `"blur" \| "typing" \| "disabled" \| false`                  | No       | `'blur'`                                                                                                                                                                                                                          | -                                                                           |
-| **country-locale**            | Locale of country list<br/>**Example:** `"fr-FR"`                                                                                 | `string`                                                     | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
-| **validation-error**          | Disable validation error UI                                                                                                       | `boolean`                                                    | No       | `true`                                                                                                                                                                                                                            | -                                                                           |
-| **validation-success**        | Disable validation success UI                                                                                                     | `boolean`                                                    | No       | `true`                                                                                                                                                                                                                            | -                                                                           |
-| **success**                   | Add success UI                                                                                                                    | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
-| **error**                     | Add error UI                                                                                                                      | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
-| **display-country-name**      | Will replace the calling code by the country name in the country selector                                                         | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
-| **block**                     | The input will be displayed in full width                                                                                         | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
-| **orientation**               | Orientation of the inputs in the component                                                                                        | `'row' \| 'col' \| 'responsive'`                             | No       | `'responsive'`                                                                                                                                                                                                                    | `row, col, responsive`                                                      |
-| **country-select-attributes** | Meta attributes of the country input                                                                                              | `Record<string, unknown>`                                    | No       | `() => ({   name: 'country',   autocomplete: 'off',   style: {     width: '14rem',   }, })`                                                                                                                                       | -                                                                           |
-| **phone-input-attributes**    | Meta attributes of the phone number input                                                                                         | `Record<string, unknown>`                                    | No       | `() => ({   name: 'phone',   autocomplete: 'tel',   inputmode: 'tel', })`                                                                                                                                                         | -                                                                           |
+| Name                          | Description                                                                                                                                        | Type                                                         | Required | Default                                                                                                                                                                                                                           | Possible values                                                             |
+| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| **style**                     | Style attribut of the component root element                                                                                                       | `HTMLAttributes['style']`                                    | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **class**                     | Class attribut of the component root element                                                                                                       | `HTMLAttributes['class']`                                    | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **model-value**               | `v-model` <br/>The current value of the input field in international format (e.g. +33612345678)<br/>**Example:** `"+33612345678"`                  | `string \| undefined \| null`                                | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **country-code**              | `v-model:country-code` <br/>The selected country code (e.g. "FR")<br/>**Example:** `"FR"`                                                          | `CountryCode \| undefined \| null`                           | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **id**                        | Unique identifier for the component<br/>**Example:** `"phone-input-1"`                                                                             | `string`                                                     | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **placeholder**               | Text displayed when the input is empty<br/>**Example:** `"Enter your phone number"`                                                                | `string`                                                     | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **top-label**                 | Static label displayed above the input field. Unlike the floating label, this remains fixed<br/>**Example:** `"User Information"`                  | `string`                                                     | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **label**                     | Label displayed above the input<br/>**Example:** `"Phone Number"`                                                                                  | `string`                                                     | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **preferred-countries**       | List of country codes to place first in the select list<br/>**Example:** `["FR", "BE", "GE"]`                                                      | `CountryCode[]`                                              | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **ignored-countries**         | List of country codes to be removed from the select list<br/>**Example:** `["FR", "BE", "GE"]`                                                     | `CountryCode[]`                                              | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **only-countries**            | List of country codes to only have the countries selected in the select list<br/>**Example:** `["FR", "BE", "GE"]`                                 | `CountryCode[]`                                              | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **translations**              | Locale strings of the component The default values are the translations of the MazUiTranslations plugin                                            | `Partial<MazUiTranslationsNestedSchema['inputPhoneNumber']>` | No       | `{   countrySelect: {     error: 'Choose country',     placeholder: 'Country code',     searchPlaceholder: 'Search the country',   },   phoneInput: {     placeholder: 'Phone number',     example: 'Example: {example}',   }, }` | -                                                                           |
+| **list-position**             | Position where the list of countries will be opened                                                                                                | `MazPopoverProps['position']`                                | No       | `bottom left`                                                                                                                                                                                                                     | `top left, top right, bottom left, bottom right`                            |
+| **color**                     | Component color applied                                                                                                                            | `MazColor`                                                   | No       | `primary`                                                                                                                                                                                                                         | `primary, secondary, accent, info, success, warning, destructive, contrast` |
+| **size**                      | Component size applied                                                                                                                             | `MazSize`                                                    | No       | `md`                                                                                                                                                                                                                              | `xs, sm, md, lg, xl, mini`                                                  |
+| **hide-flags**                | Remove flags in country list                                                                                                                       | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **disabled**                  | Make the input disabled                                                                                                                            | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **required**                  | Make the input required                                                                                                                            | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **example**                   | Show the phone number example                                                                                                                      | `boolean`                                                    | No       | `true`                                                                                                                                                                                                                            | -                                                                           |
+| **search**                    | Disable search input in country list                                                                                                               | `boolean`                                                    | No       | `true`                                                                                                                                                                                                                            | -                                                                           |
+| **search-threshold**          | Threshold of the search input in country list where 1 is a perfect match and 0 is a match with any character                                       | `number`                                                     | No       | `0.75`                                                                                                                                                                                                                            | -                                                                           |
+| **use-browser-locale**        | If true, the browser locale will be used                                                                                                           | `boolean`                                                    | No       | `true`                                                                                                                                                                                                                            | -                                                                           |
+| **fetch-country**             | The component will make a request (https://ipwho.is) to get the location of the user and use it to set the default country code                    | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **hide-country-select**       | Hide the country selector                                                                                                                          | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **show-code-in-list**         | Show country calling code in the country list                                                                                                      | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **custom-countries-list**     | Replace country names                                                                                                                              | `Record<CountryCode, string>`                                | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **auto-format**               | Disabled auto-format when phone is valid                                                                                                           | `"blur" \| "typing" \| "disabled" \| false`                  | No       | `blur`                                                                                                                                                                                                                            | -                                                                           |
+| **country-locale**            | Locale of country list<br/>**Example:** `"fr-FR"`                                                                                                  | `string`                                                     | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
+| **validation-error**          | Disable validation error UI                                                                                                                        | `boolean`                                                    | No       | `true`                                                                                                                                                                                                                            | -                                                                           |
+| **validation-success**        | Disable validation success UI                                                                                                                      | `boolean`                                                    | No       | `true`                                                                                                                                                                                                                            | -                                                                           |
+| **success**                   | Add success UI                                                                                                                                     | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **error**                     | Add error UI                                                                                                                                       | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **warning**                   | Add warning UI                                                                                                                                     | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **display-country-name**      | Will replace the calling code by the country name in the country selector                                                                          | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **block**                     | The input will be displayed in full width                                                                                                          | `boolean`                                                    | No       | `false`                                                                                                                                                                                                                           | -                                                                           |
+| **orientation**               | Orientation of the inputs in the component                                                                                                         | `'row' \| 'col' \| 'responsive'`                             | No       | `responsive`                                                                                                                                                                                                                      | `row, col, responsive`                                                      |
+| **country-select-attributes** | Meta attributes of the country input                                                                                                               | `Record<string, unknown>`                                    | No       | `{ autocomplete: 'off', name: 'country' }`                                                                                                                                                                                        | -                                                                           |
+| **phone-input-attributes**    | Meta attributes of the phone number input                                                                                                          | `Record<string, unknown>`                                    | No       | `{ autocomplete: 'tel', name: 'phone', inputmode: 'tel' }`                                                                                                                                                                        | -                                                                           |
+| **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`                                                                                                                                                                                                                       | -                                                                           |
+| **hint**                      | Alternative text that replaces the label when provided. Useful for contextual hints<br/>**Example:** `"This phone number is not valid"`            | `string`                                                     | No       | `undefined`                                                                                                                                                                                                                       | -                                                                           |
 
 ## Events
 

package/docs/generated-docs/maz-input-price.doc.md

@@ -1,19 +1,19 @@
 ## Props
 
-| Name                 | Description                                                                  | Type      | Required | Default                    |
-| -------------------- | ---------------------------------------------------------------------------- | --------- | -------- | -------------------------- |
-| **model-value**      | `v-model` <br/>                                                              | `number`  | No       | `undefined`                |
-| **currency**         | The currency to use                                                          | `string`  | No       | `'EUR'`                    |
-| **locale**           | The locale to use                                                            | `string`  | No       | `'fr-FR'`                  |
-| **min**              | The minimum value that the input can accept                                  | `number`  | No       | `Number.NEGATIVE_INFINITY` |
-| **max**              | The maximum value that the input can accept                                  | `number`  | No       | `Number.POSITIVE_INFINITY` |
-| **no-icon**          | The input will be displayed without icon                                     | `boolean` | No       | `false`                    |
-| **block**            | The input will be displayed in full width                                    | `boolean` | No       | `undefined`                |
-| **error**            | Will display the input in error state.                                       | `boolean` | No       | `undefined`                |
-| **hint**             | The hint text to display below the input.                                    | `string`  | No       | `undefined`                |
-| **success**          | Will display the input in success state.                                     | `boolean` | No       | `undefined`                |
-| **warning**          | Will display the input in warning state.                                     | `boolean` | No       | `undefined`                |
-| **currency-options** | Options for the currency helper - [see](https://maz-ui.com/helpers/currency) | `Omit`    | No       | `undefined`                |
+| Name                 | Description                                                                  | Type      | Required |
+| -------------------- | ---------------------------------------------------------------------------- | --------- | -------- |
+| **model-value**      | `v-model` <br/>                                                              | `number`  | No       |
+| **currency**         | The currency to use                                                          | `string`  | No       |
+| **locale**           | The locale to use                                                            | `string`  | No       |
+| **min**              | The minimum value that the input can accept                                  | `number`  | No       |
+| **max**              | The maximum value that the input can accept                                  | `number`  | No       |
+| **no-icon**          | The input will be displayed without icon                                     | `boolean` | No       |
+| **block**            | The input will be displayed in full width                                    | `boolean` | No       |
+| **error**            | Will display the input in error state.                                       | `boolean` | No       |
+| **hint**             | The hint text to display below the input.                                    | `string`  | No       |
+| **success**          | Will display the input in success state.                                     | `boolean` | No       |
+| **warning**          | Will display the input in warning state.                                     | `boolean` | No       |
+| **currency-options** | Options for the currency helper - [see](https://maz-ui.com/helpers/currency) | `Omit`    | No       |
 
 ## Events
 

package/docs/generated-docs/maz-input-tags.doc.md

@@ -1,21 +1,21 @@
 ## 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**      | `v-model` <br/>                              | `TSParenthesizedType[]` | No       | `undefined` |
-| **placeholder**      | The placeholder of the input                 | `string`                | No       | `undefined` |
-| **label**            | The label of the input                       | `string`                | No       | `undefined` |
-| **disabled**         | Disable the input                            | `boolean`               | No       | `false`     |
-| **error**            | Display the input with error style           | `boolean`               | No       | `false`     |
-| **success**          | Display the input with success style         | `boolean`               | No       | `false`     |
-| **warning**          | Display the input with warning style         | `boolean`               | No       | `false`     |
-| **size**             | The size of the input                        | `MazSize`               | No       | `'md'`      |
-| **color**            | The color of the input                       | `MazColor`              | No       | `'primary'` |
-| **block**            | The input will be displayed in full width    | `boolean`               | No       | `undefined` |
-| **add-tags-on-blur** | Add tags on blur                             | `boolean`               | No       | `true`      |
-| **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**      | `v-model` <br/>                              | `TSParenthesizedType[]` | No       |
+| **placeholder**      | The placeholder of the input                 | `string`                | No       |
+| **label**            | The label of the input                       | `string`                | No       |
+| **disabled**         | Disable the input                            | `boolean`               | No       |
+| **error**            | Display the input with error style           | `boolean`               | No       |
+| **success**          | Display the input with success style         | `boolean`               | No       |
+| **warning**          | Display the input with warning style         | `boolean`               | No       |
+| **size**             | The size of the input                        | `MazSize`               | No       |
+| **color**            | The color of the input                       | `MazColor`              | No       |
+| **block**            | The input will be displayed in full width    | `boolean`               | No       |
+| **add-tags-on-blur** | Add tags on blur                             | `boolean`               | No       |
+| **hint**             | The hint text to display below the input.    | `string`                | No       |
 
 ## Events
 

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

@@ -1,38 +1,38 @@
 ## Props
 
-| Name               | Description                                                                                                                                                                                                                                                    | Type                                               | Required | Default     | Possible values                                                                            |
-| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | -------- | ----------- | ------------------------------------------------------------------------------------------ |
-| **style**          | Inline styles to apply to the component root element                                                                                                                                                                                                           | `HTMLAttributes['style']`                          | No       | `undefined` | -                                                                                          |
-| **class**          | CSS classes to apply to the component root element                                                                                                                                                                                                             | `HTMLAttributes['class']`                          | No       | `undefined` | -                                                                                          |
-| **model-value**    | `v-model` <br/>The current value of the input field. This prop is used for two-way data binding with v-model<br/>**Example:** `<MazInput v-model="inputValue" />`                                                                                              | `T`                                                | No       | `undefined` | -                                                                                          |
-| **placeholder**    | Text displayed when the input is empty to guide the user<br/>**Example:** `"Enter your email address"`                                                                                                                                                         | `string`                                           | No       | `undefined` | -                                                                                          |
-| **label**          | Floating label that appears inside the input and moves up when focused or filled. Provides better UX than traditional placeholders<br/>**Example:** `"Email Address"`                                                                                          | `string`                                           | No       | `undefined` | -                                                                                          |
-| **top-label**      | Static label displayed above the input field. Unlike the floating label, this remains fixed<br/>**Example:** `"User Information"`                                                                                                                              | `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` | -                                                                                          |
-| **color**          | Theme color that affects the border and focus states of the input<br/>**Example:** `"primary"`                                                                                                                                                                 | `MazColor`                                         | No       | `'primary'` | `primary, secondary, accent, info, success, warning, destructive, contrast`                |
-| **type**           | HTML input type attribute that determines the input behavior and validation<br/>**Example:** `"email"`                                                                                                                                                         | `InputHTMLAttributes['type']`                      | No       | `'text'`    | `text, password, email, number, tel, url, search, date, time, datetime-local, month, week` |
-| **required**       | Makes the input field mandatory for form submission<br/>**Example:** `true`                                                                                                                                                                                    | `boolean`                                          | No       | `false`     | -                                                                                          |
-| **disabled**       | Disables the input field, preventing user interaction and form submission<br/>**Example:** `false`                                                                                                                                                             | `boolean`                                          | No       | `false`     | -                                                                                          |
-| **readonly**       | Makes the input field read-only, allowing selection but preventing modification<br/>**Example:** `false`                                                                                                                                                       | `boolean`                                          | No       | `undefined` | -                                                                                          |
-| **id**             | Unique identifier for the input element, used for form labels and accessibility<br/>**Example:** `"user-email"`                                                                                                                                                | `string`                                           | No       | `undefined` | -                                                                                          |
-| **error**          | Applies error styling (red border and text) to indicate validation failure<br/>**Example:** `true`                                                                                                                                                             | `boolean`                                          | No       | `false`     | -                                                                                          |
-| **success**        | Applies success styling (green border and text) to indicate successful validation<br/>**Example:** `true`                                                                                                                                                      | `boolean`                                          | No       | `false`     | -                                                                                          |
-| **warning**        | Applies warning styling (orange border and text) to indicate potential issues<br/>**Example:** `true`                                                                                                                                                          | `boolean`                                          | No       | `false`     | -                                                                                          |
-| **hint**           | Alternative text that replaces the label when provided. Useful for contextual hints<br/>**Example:** `"Optional field"`                                                                                                                                        | `string`                                           | No       | `undefined` | -                                                                                          |
-| **input-classes**  | Additional CSS classes to apply specifically to the input wrapper element<br/>**Example:** `"custom-input-wrapper"`                                                                                                                                            | `string`                                           | No       | `undefined` | -                                                                                          |
-| **border**         | Controls whether the input has a visible border. Set to false for borderless inputs<br/>**Example:** `true`                                                                                                                                                    | `boolean`                                          | No       | `true`      | -                                                                                          |
-| **inputmode**      | HTML inputmode attribute that provides hints for virtual keyboards on mobile devices<br/>**Example:** `"numeric"`                                                                                                                                              | `InputHTMLAttributes['inputmode']`                 | No       | `'text'`    | `text, numeric, decimal, tel, search, email, url`                                          |
-| **size**           | Controls the height and text size of the input component<br/>**Example:** `"md"`                                                                                                                                                                               | `MazSize`                                          | No       | `'md'`      | `xs, sm, md, lg, xl, mini`                                                                 |
-| **debounce**       | Enables input debouncing to limit the frequency of value updates. When true, uses 500ms delay. When a number, uses that value as delay in milliseconds<br/>**Example:** `true`                                                                                 | `boolean \| number`                                | No       | `false`     | -                                                                                          |
-| **auto-focus**     | Automatically focuses the input when the component mounts<br/>**Example:** `false`                                                                                                                                                                             | `boolean`                                          | No       | `false`     | -                                                                                          |
-| **border-active**  | When true, shows the colored border immediately instead of only on focus<br/>**Example:** `false`                                                                                                                                                              | `boolean`                                          | No       | `false`     | -                                                                                          |
-| **start-icon**     | Icon displayed on the inline-start edge of the input (left in LTR, right in RTL). Accepts a bare value (Vue component, raw SVG string, URL or `data:` URI) or a full `MazIconProps` object for fine-grained control (size, title, svgAttributes, fallback, …). | `MazIconLike`                                      | No       | `undefined` | -                                                                                          |
-| **end-icon**       | Icon displayed on the inline-end edge of the input (right in LTR, left in RTL). Accepts a bare value or a full `MazIconProps` object.                                                                                                                          | `MazIconLike`                                      | No       | `undefined` | -                                                                                          |
-| **rounded-size**   | Controls the border radius of the input component<br/>**Example:** `"lg"`                                                                                                                                                                                      | `'none' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full'` | No       | `'md'`      | `none, sm, md, lg, xl, full`                                                               |
-| **block**          | Makes the input expand to the full width of its container<br/>**Example:** `false`                                                                                                                                                                             | `boolean`                                          | No       | `undefined` | -                                                                                          |
-| **name**           | The name of the input field. Used for form submission and validation<br/>**Example:** `"email"`                                                                                                                                                                | `string`                                           | No       | `undefined` | -                                                                                          |
-| **autocomplete**   | The autocomplete attribute for the input field. Used for form submission and validation<br/>**Example:** `"email"`                                                                                                                                             | `string`                                           | No       | `undefined` | -                                                                                          |
-| **loading**        | Loading state for the input field. Used to show a loading spinner                                                                                                                                                                                              | `boolean`                                          | No       | `false`     | -                                                                                          |
+| Name               | Description                                                                                                                                                                                                                                                    | Type                               | Required | Default     | Possible values                                                                            |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | -------- | ----------- | ------------------------------------------------------------------------------------------ |
+| **style**          | Inline styles to apply to the component root element                                                                                                                                                                                                           | `HTMLAttributes['style']`          | No       | `undefined` | -                                                                                          |
+| **class**          | CSS classes to apply to the component root element                                                                                                                                                                                                             | `HTMLAttributes['class']`          | No       | `undefined` | -                                                                                          |
+| **model-value**    | `v-model` <br/>The current value of the input field. This prop is used for two-way data binding with v-model<br/>**Example:** `<MazInput v-model="inputValue" />`                                                                                              | `T`                                | No       | `undefined` | -                                                                                          |
+| **placeholder**    | Text displayed when the input is empty to guide the user<br/>**Example:** `"Enter your email address"`                                                                                                                                                         | `string`                           | No       | `undefined` | -                                                                                          |
+| **label**          | Floating label that appears inside the input and moves up when focused or filled. Provides better UX than traditional placeholders<br/>**Example:** `"Email Address"`                                                                                          | `string`                           | No       | `undefined` | -                                                                                          |
+| **top-label**      | Static label displayed above the input field. Unlike the floating label, this remains fixed<br/>**Example:** `"User Information"`                                                                                                                              | `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` | -                                                                                          |
+| **color**          | Theme color that affects the border and focus states of the input<br/>**Example:** `"primary"`                                                                                                                                                                 | `MazColor`                         | No       | `undefined` | `primary, secondary, accent, info, success, warning, destructive, contrast`                |
+| **type**           | HTML input type attribute that determines the input behavior and validation<br/>**Example:** `"email"`                                                                                                                                                         | `InputHTMLAttributes['type']`      | No       | `undefined` | `text, password, email, number, tel, url, search, date, time, datetime-local, month, week` |
+| **required**       | Makes the input field mandatory for form submission<br/>**Example:** `true`                                                                                                                                                                                    | `boolean`                          | No       | `undefined` | -                                                                                          |
+| **disabled**       | Disables the input field, preventing user interaction and form submission<br/>**Example:** `false`                                                                                                                                                             | `boolean`                          | No       | `undefined` | -                                                                                          |
+| **readonly**       | Makes the input field read-only, allowing selection but preventing modification<br/>**Example:** `false`                                                                                                                                                       | `boolean`                          | No       | `undefined` | -                                                                                          |
+| **id**             | Unique identifier for the input element, used for form labels and accessibility<br/>**Example:** `"user-email"`                                                                                                                                                | `string`                           | No       | `undefined` | -                                                                                          |
+| **error**          | Applies error styling (red border and text) to indicate validation failure<br/>**Example:** `true`                                                                                                                                                             | `boolean`                          | No       | `undefined` | -                                                                                          |
+| **success**        | Applies success styling (green border and text) to indicate successful validation<br/>**Example:** `true`                                                                                                                                                      | `boolean`                          | No       | `undefined` | -                                                                                          |
+| **warning**        | Applies warning styling (orange border and text) to indicate potential issues<br/>**Example:** `true`                                                                                                                                                          | `boolean`                          | No       | `undefined` | -                                                                                          |
+| **hint**           | Alternative text that replaces the label when provided. Useful for contextual hints<br/>**Example:** `"Optional field"`                                                                                                                                        | `string`                           | No       | `undefined` | -                                                                                          |
+| **input-classes**  | Additional CSS classes to apply specifically to the input wrapper element<br/>**Example:** `"custom-input-wrapper"`                                                                                                                                            | `string`                           | No       | `undefined` | -                                                                                          |
+| **border**         | Controls whether the input has a visible border. Set to false for borderless inputs<br/>**Example:** `true`                                                                                                                                                    | `boolean`                          | No       | `undefined` | -                                                                                          |
+| **inputmode**      | HTML inputmode attribute that provides hints for virtual keyboards on mobile devices<br/>**Example:** `"numeric"`                                                                                                                                              | `InputHTMLAttributes['inputmode']` | No       | `undefined` | `text, numeric, decimal, tel, search, email, url`                                          |
+| **size**           | Controls the height and text size of the input component<br/>**Example:** `"md"`                                                                                                                                                                               | `MazSize`                          | No       | `undefined` | `xs, sm, md, lg, xl, mini`                                                                 |
+| **debounce**       | Enables input debouncing to limit the frequency of value updates. When true, uses 500ms delay. When a number, uses that value as delay in milliseconds<br/>**Example:** `true`                                                                                 | `boolean \| number`                | No       | `undefined` | -                                                                                          |
+| **auto-focus**     | Automatically focuses the input when the component mounts<br/>**Example:** `false`                                                                                                                                                                             | `boolean`                          | No       | `undefined` | -                                                                                          |
+| **border-active**  | When true, shows the colored border immediately instead of only on focus<br/>**Example:** `false`                                                                                                                                                              | `boolean`                          | No       | `undefined` | -                                                                                          |
+| **start-icon**     | Icon displayed on the inline-start edge of the input (left in LTR, right in RTL). Accepts a bare value (Vue component, raw SVG string, URL or `data:` URI) or a full `MazIconProps` object for fine-grained control (size, title, svgAttributes, fallback, …). | `MazIconLike`                      | No       | `undefined` | -                                                                                          |
+| **end-icon**       | Icon displayed on the inline-end edge of the input (right in LTR, left in RTL). Accepts a bare value or a full `MazIconProps` object.                                                                                                                          | `MazIconLike`                      | No       | `undefined` | -                                                                                          |
+| **rounded-size**   | Controls the border radius of the input component<br/>**Example:** `"lg"`                                                                                                                                                                                      | `MazRoundedSize`                   | No       | `md`        | `none, sm, md, lg, xl, full`                                                               |
+| **block**          | Makes the input expand to the full width of its container<br/>**Example:** `false`                                                                                                                                                                             | `boolean`                          | No       | `undefined` | -                                                                                          |
+| **name**           | The name of the input field. Used for form submission and validation<br/>**Example:** `"email"`                                                                                                                                                                | `string`                           | No       | `undefined` | -                                                                                          |
+| **autocomplete**   | The autocomplete attribute for the input field. Used for form submission and validation<br/>**Example:** `"email"`                                                                                                                                             | `string`                           | No       | `undefined` | -                                                                                          |
+| **loading**        | Loading state for the input field. Used to show a loading spinner                                                                                                                                                                                              | `boolean`                          | No       | `false`     | -                                                                                          |
 
 ## Events
 

package/docs/generated-docs/maz-lazy-img.doc.md

@@ -1,19 +1,19 @@
 ## Props
 
-| Name                  | Description                                          | Type                      | Required | Default     |
-| --------------------- | ---------------------------------------------------- | ------------------------- | -------- | ----------- |
-| **style**             | The style of the component                           | `Native type`             | No       | `undefined` |
-| **class**             | The class of the component                           | `Native type`             | No       | `undefined` |
-| **src**               | The source of the image                              | `string \| Image \| null` | No       | `undefined` |
-| **alt**               | The alt of the image                                 | `string`                  | No       | `undefined` |
-| **hide-loader**       | Remove the loader                                    | `boolean`                 | No       | `undefined` |
-| **observer-once**     | Remove the observer once the image is loaded         | `boolean`                 | No       | `true`      |
-| **load-once**         | Remove the observer once the image is loaded         | `boolean`                 | No       | `undefined` |
-| **image-height-full** | Make the image height full                           | `boolean`                 | No       | `undefined` |
-| **observer-options**  | The options of the observer                          | `Native type`             | No       | `undefined` |
-| **fallback-src**      | The fallback src to replace the src on loading error | `string`                  | No       | `undefined` |
-| **img-class**         | The classes of the image element                     | `Native type`             | No       | `undefined` |
-| **block**             | The image will be displayed in full width            | `boolean`                 | No       | `undefined` |
+| Name                  | Description                                          | Type                      | Required |
+| --------------------- | ---------------------------------------------------- | ------------------------- | -------- |
+| **style**             | The style of the component                           | `Native type`             | No       |
+| **class**             | The class of the component                           | `Native type`             | No       |
+| **src**               | The source of the image                              | `string \| Image \| null` | No       |
+| **alt**               | The alt of the image                                 | `string`                  | No       |
+| **hide-loader**       | Remove the loader                                    | `boolean`                 | No       |
+| **observer-once**     | Remove the observer once the image is loaded         | `boolean`                 | No       |
+| **load-once**         | Remove the observer once the image is loaded         | `boolean`                 | No       |
+| **image-height-full** | Make the image height full                           | `boolean`                 | No       |
+| **observer-options**  | The options of the observer                          | `Native type`             | No       |
+| **fallback-src**      | The fallback src to replace the src on loading error | `string`                  | No       |
+| **img-class**         | The classes of the image element                     | `Native type`             | No       |
+| **block**             | The image will be displayed in full width            | `boolean`                 | No       |
 
 ## Events
 

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

@@ -1,6 +1,6 @@
 ## Props
 
-| Name       | Description                  | Type       | Required | Default      |
-| ---------- | ---------------------------- | ---------- | -------- | ------------ |
-| **color**  | The color of the component.  | `MazColor` | No       | `'primary'`  |
-| **height** | The height of the component. | `string`   | No       | `'0.125rem'` |
+| Name       | Description                  | Type       | Required |
+| ---------- | ---------------------------- | ---------- | -------- |
+| **color**  | The color of the component.  | `MazColor` | No       |
+| **height** | The height of the component. | `string`   | No       |

package/docs/generated-docs/maz-markdown-editor.doc.md

@@ -0,0 +1,65 @@
+## Props
+
+| Name                | Description                                                                                                                                                                                    | Type                                                           | Required | Default     |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | -------- | ----------- |
+| **style**           | Style attribute of the component root element                                                                                                                                                  | `Native type`                                                  | No       | `undefined` |
+| **class**           | Class attribute of the component root element                                                                                                                                                  | `Native type`                                                  | No       | `undefined` |
+| **model-value**     | `v-model` <br/>                                                                                                                                                                                | `string`                                                       | No       | `undefined` |
+| **id**              | The id of the textarea                                                                                                                                                                         | `string`                                                       | No       | `undefined` |
+| **name**            | The name of the textarea                                                                                                                                                                       | `string`                                                       | No       | `undefined` |
+| **label**           | Static label displayed above the editor                                                                                                                                                        | `string`                                                       | No       | `undefined` |
+| **placeholder**     | The placeholder of the textarea                                                                                                                                                                | `string`                                                       | No       | `undefined` |
+| **required**        | If the editor is required                                                                                                                                                                      | `boolean`                                                      | No       | `undefined` |
+| **disabled**        | If the editor is disabled                                                                                                                                                                      | `boolean`                                                      | No       | `undefined` |
+| **readonly**        | If the editor is readonly                                                                                                                                                                      | `boolean`                                                      | No       | `undefined` |
+| **error**           | If the editor has an error                                                                                                                                                                     | `boolean`                                                      | No       | `undefined` |
+| **success**         | If the editor has a success                                                                                                                                                                    | `boolean`                                                      | No       | `undefined` |
+| **warning**         | If the editor has a warning                                                                                                                                                                    | `boolean`                                                      | No       | `undefined` |
+| **color**           | The color of the editor                                                                                                                                                                        | `MazColor`                                                     | No       | `undefined` |
+| **rounded-size**    | Size radius of the component's border                                                                                                                                                          | `MazRoundedSize`                                               | No       | `md`        |
+| **top-label**       | Static label displayed above the editor. Unlike a floating label, this remains fixed                                                                                                           | `string`                                                       | No       | `undefined` |
+| **assistive-text**  | Helper text displayed below the editor to provide additional context or validation feedback<br/>**Example:** `"Markdown is supported"`                                                         | `string`                                                       | No       | `undefined` |
+| **toolbar**         | Show the formatting toolbar. Pass `true` for the full toolbar, or an ordered array of action keys to display only a subset (and control their order).                                          | `boolean \| MazMarkdownEditorToolbarAction[]`                  | No       | `false`     |
+| **line-numbers**    | Display line numbers in a gutter on the left of the editor                                                                                                                                     | `boolean`                                                      | No       | `false`     |
+| **shortcuts**       | Enable keyboard shortcuts for the toolbar actions (e.g. Cmd/Ctrl+B for bold).                                                                                                                  | `boolean`                                                      | No       | `true`      |
+| **sanitize**        | Sanitize the rendered preview HTML with DOMPurify                                                                                                                                              | `boolean`                                                      | No       | `true`      |
+| **render-function** | Custom markdown renderer. Receives the raw markdown and returns an HTML string (sync or async). Falls back to `marked` when omitted. The result is still sanitized when `sanitize` is enabled. | `TSFunctionType`                                               | No       | `undefined` |
+| **marked-options**  | Options forwarded to `marked` when using the default renderer                                                                                                                                  | `Record`                                                       | No       | `undefined` |
+| **rows**            | Minimum number of visible rows of the editor textarea                                                                                                                                          | `number`                                                       | No       | `6`         |
+| **translations**    | Custom translations for the component. Override any key independently.                                                                                                                         | `DeepPartial<MazUiTranslationsNestedSchema['markdownEditor']>` | No       | `undefined` |
+
+## Events
+
+| Event name         | Properties                                           | Description                             |
+| ------------------ | ---------------------------------------------------- | --------------------------------------- |
+| update:model-value | **value** `string \| undefined` - The markdown value | Emitted when the markdown value changes |
+| input              | **value** `string \| undefined` - The markdown value | Emitted when the markdown value changes |
+| focus              | **event** `FocusEvent` - The focus event             | Emitted when the textarea is focused    |
+| blur               | **event** `FocusEvent` - The blur event              | Emitted when the textarea is blurred    |
+| change             | **event** `Event` - The change event                 | Emitted when the textarea value changes |
+
+## Slots
+
+| Name          | Description                                                                                     | Bindings                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| ------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| label         | Replace the static label displayed above the editor                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| toolbar       | Replace the toolbar content (only rendered when the toolbar is enabled and not in preview mode) | **mode** `MazMarkdownEditorMode` - The current editor mode<br/>**wrap-selection** `Function` - Wrap the current selection with the given markers<br/>**prefix-lines** `Function` - Prefix every selected line with the given string<br/>**apply-heading** `Function` - Apply a heading of the given level to the selected lines<br/>**insert-link** `Function` - Insert a markdown link at the selection<br/>**insert-image** `Function` - Insert a markdown image at the selection<br/>**insert-code-block** `Function` - Insert a fenced code block at the selection<br/>**insert-table** `Function` - Insert a markdown table at the selection |
+| empty-preview | Content displayed in the preview pane when there is nothing to render                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+
+## Expose
+
+### textarea
+
+> The underlying textarea element
+
+### mode
+
+> The current editor mode (write / preview / split)
+
+### renderPreview
+
+> Programmatically re-render the markdown preview
+
+### focus
+
+> Focus the editor textarea

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

@@ -14,7 +14,7 @@
 | **offset**                 | Distance between trigger and popover in pixels                                                                                                                                                                                                                                                                                        | `number`                                | No       | `8`            | -                                                                                                                            |
 | **delay**                  | Delay before showing/hiding in milliseconds                                                                                                                                                                                                                                                                                           | `number`                                | No       | `0`            | -                                                                                                                            |
 | **hover-delay**            | Delay before closing on hover in milliseconds                                                                                                                                                                                                                                                                                         | `number`                                | No       | `150`          | -                                                                                                                            |
-| **transition**             | CSS transition name for animations                                                                                                                                                                                                                                                                                                    | `"scale-pop" \| "scale-fade" \| string` | No       | `popover`      | -                                                                                                                            |
+| **transition**             | **CSS transition name for animations** <br/> <br/>'scale-pop' \| 'scale-fade' for default transitions. 'scale-pop' is a pop effect, 'scale-fade' is a fade effect.<br/>                                                                                                                                                               | `"scale-pop" \| "scale-fade" \| string` | No       | `scale-pop`    | `scale-pop' \| 'scale-fade' \| string`                                                                                       |
 | **teleport-to**            | Teleport target selector                                                                                                                                                                                                                                                                                                              | `string`                                | No       | `body`         | -                                                                                                                            |
 | **overlay-class**          | Additional CSS classes for the overlay wrapper                                                                                                                                                                                                                                                                                        | `Native type`                           | No       | `undefined`    | -                                                                                                                            |
 | **panel-class**            | Additional CSS classes for the popover panel                                                                                                                                                                                                                                                                                          | `Native type`                           | No       | `undefined`    | -                                                                                                                            |

package/docs/generated-docs/maz-pull-to-refresh.doc.md

@@ -1,15 +1,15 @@
 ## Props
 
-| Name                   | Description | Type             | Required | Default      |
-| ---------------------- | ----------- | ---------------- | -------- | ------------ |
-| **distance**           |             | `number`         | No       | `100`        |
-| **offset**             |             | `number`         | No       | `0`          |
-| **on-click**           |             | `TSFunctionType` | No       | `undefined`  |
-| **container-selector** |             | `string`         | No       | `undefined`  |
-| **header-class**       |             | `string`         | No       | `undefined`  |
-| **spinner-color**      |             | `MazColor`       | No       | `'contrast'` |
-| **disabled**           |             | `boolean`        | No       | `false`      |
-| **standalone-mode**    |             | `boolean`        | No       | `false`      |
+| Name                   | Description | Type             | Required |
+| ---------------------- | ----------- | ---------------- | -------- |
+| **distance**           |             | `number`         | No       |
+| **offset**             |             | `number`         | No       |
+| **on-click**           |             | `TSFunctionType` | No       |
+| **container-selector** |             | `string`         | No       |
+| **header-class**       |             | `string`         | No       |
+| **spinner-color**      |             | `MazColor`       | No       |
+| **disabled**           |             | `boolean`        | No       |
+| **standalone-mode**    |             | `boolean`        | No       |
 
 ## Events