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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/README.md +1 -1
  2. package/dist/mcp.d.mts +22 -9
  3. package/dist/mcp.d.ts +22 -9
  4. package/dist/mcp.mjs +160 -83
  5. package/docs/generated-docs/maz-avatar.doc.md +25 -25
  6. package/docs/generated-docs/maz-btn.doc.md +1 -1
  7. package/docs/generated-docs/maz-checkbox.doc.md +16 -17
  8. package/docs/generated-docs/maz-circular-progress-bar.doc.md +1 -1
  9. package/docs/generated-docs/maz-code-highlight.doc.md +11 -0
  10. package/docs/generated-docs/maz-date-picker.doc.md +41 -41
  11. package/docs/generated-docs/maz-drawer.doc.md +7 -8
  12. package/docs/generated-docs/maz-expand-animation.doc.md +4 -4
  13. package/docs/generated-docs/maz-fullscreen-loader.doc.md +5 -5
  14. package/docs/generated-docs/maz-gallery.doc.md +15 -15
  15. package/docs/generated-docs/maz-input-code.doc.md +16 -16
  16. package/docs/generated-docs/maz-input-phone-number.doc.md +42 -38
  17. package/docs/generated-docs/maz-input-price.doc.md +14 -14
  18. package/docs/generated-docs/maz-input-tags.doc.md +16 -16
  19. package/docs/generated-docs/maz-input.doc.md +33 -33
  20. package/docs/generated-docs/maz-lazy-img.doc.md +14 -14
  21. package/docs/generated-docs/maz-loading-bar.doc.md +4 -4
  22. package/docs/generated-docs/maz-pull-to-refresh.doc.md +10 -10
  23. package/docs/generated-docs/maz-radio-buttons.doc.md +17 -17
  24. package/docs/generated-docs/maz-radio.doc.md +16 -16
  25. package/docs/generated-docs/maz-reading-progress-bar.doc.md +4 -4
  26. package/docs/generated-docs/maz-sidebar-content.doc.md +5 -0
  27. package/docs/generated-docs/maz-sidebar-footer.doc.md +5 -0
  28. package/docs/generated-docs/maz-sidebar-group.doc.md +11 -0
  29. package/docs/generated-docs/maz-sidebar-header.doc.md +5 -0
  30. package/docs/generated-docs/maz-sidebar-menu-button.doc.md +27 -0
  31. package/docs/generated-docs/maz-sidebar-menu-item.doc.md +5 -0
  32. package/docs/generated-docs/maz-sidebar-menu-sub.doc.md +16 -0
  33. package/docs/generated-docs/maz-sidebar-menu.doc.md +5 -0
  34. package/docs/generated-docs/maz-sidebar-separator.doc.md +0 -0
  35. package/docs/generated-docs/maz-sidebar-trigger.doc.md +5 -0
  36. package/docs/generated-docs/maz-sidebar.doc.md +36 -0
  37. package/docs/generated-docs/maz-slider.doc.md +1 -1
  38. package/docs/generated-docs/maz-spinner.doc.md +4 -4
  39. package/docs/generated-docs/maz-switch.doc.md +14 -14
  40. package/docs/generated-docs/maz-table.doc.md +5 -5
  41. package/docs/generated-docs/maz-textarea.doc.md +25 -24
  42. package/docs/generated-docs/maz-ticker.doc.md +1 -1
  43. package/docs/generated-docs/maz-window-mockup.doc.md +23 -0
  44. package/docs/src/blog/v4.md +1 -1
  45. package/docs/src/blog/v5.md +5 -7
  46. package/docs/src/components/maz-btn.md +1 -1
  47. package/docs/src/components/maz-code-highlight.md +233 -0
  48. package/docs/src/components/maz-container.md +2 -2
  49. package/docs/src/components/maz-date-picker.md +1 -1
  50. package/docs/src/components/maz-dialog.md +46 -0
  51. package/docs/src/components/maz-icon.md +2 -2
  52. package/docs/src/components/maz-input-phone-number.md +106 -103
  53. package/docs/src/components/maz-sidebar.md +719 -0
  54. package/docs/src/components/maz-textarea.md +27 -1
  55. package/docs/src/components/maz-timeline.md +60 -0
  56. package/docs/src/components/maz-window-mockup.md +249 -0
  57. package/docs/src/directives/click-outside.md +8 -15
  58. package/docs/src/directives/fullscreen-img.md +1 -1
  59. package/docs/src/directives/lazy-img.md +5 -5
  60. package/docs/src/directives/tooltip.md +24 -1
  61. package/docs/src/directives/zoom-img.md +1 -1
  62. package/docs/src/ecosystem/eslint-config.md +95 -1
  63. package/docs/src/{guide/icons.md → ecosystem/icons/index.md} +1 -1
  64. package/docs/src/ecosystem/node/exec-promise.md +87 -0
  65. package/docs/src/ecosystem/node/index.md +53 -0
  66. package/docs/src/ecosystem/node/logger.md +146 -0
  67. package/docs/src/ecosystem/node/print-banner.md +93 -0
  68. package/docs/src/{guide → ecosystem}/nuxt.md +81 -47
  69. package/docs/src/{guide → ecosystem}/themes.md +153 -72
  70. package/docs/src/{guide → ecosystem}/translations.md +1 -1
  71. package/docs/src/ecosystem/utils/camel-case.md +31 -0
  72. package/docs/src/{helpers → ecosystem/utils}/capitalize.md +2 -3
  73. package/docs/src/ecosystem/utils/check-availability.md +79 -0
  74. package/docs/src/ecosystem/utils/cookie.md +80 -0
  75. package/docs/src/{helpers → ecosystem/utils}/currency.md +2 -2
  76. package/docs/src/{helpers → ecosystem/utils}/date.md +2 -2
  77. package/docs/src/ecosystem/utils/debounce-callback.md +38 -0
  78. package/docs/src/ecosystem/utils/debounce-id.md +69 -0
  79. package/docs/src/ecosystem/utils/debounce.md +65 -0
  80. package/docs/src/ecosystem/utils/fetch-locale-ip.md +33 -0
  81. package/docs/src/ecosystem/utils/format-json.md +33 -0
  82. package/docs/src/ecosystem/utils/format-phone-number.md +37 -0
  83. package/docs/src/ecosystem/utils/get-browser-locale.md +29 -0
  84. package/docs/src/ecosystem/utils/get-error-message.md +39 -0
  85. package/docs/src/ecosystem/utils/idle-timeout.md +90 -0
  86. package/docs/src/ecosystem/utils/index.md +60 -0
  87. package/docs/src/ecosystem/utils/is-client.md +32 -0
  88. package/docs/src/ecosystem/utils/is-equal.md +38 -0
  89. package/docs/src/ecosystem/utils/is-server.md +31 -0
  90. package/docs/src/ecosystem/utils/is-standalone-mode.md +43 -0
  91. package/docs/src/ecosystem/utils/kebab-case.md +36 -0
  92. package/docs/src/ecosystem/utils/normalize-string.md +77 -0
  93. package/docs/src/{helpers → ecosystem/utils}/number.md +2 -2
  94. package/docs/src/ecosystem/utils/pascal-case.md +35 -0
  95. package/docs/src/ecosystem/utils/script-loader.md +77 -0
  96. package/docs/src/ecosystem/utils/sleep.md +59 -0
  97. package/docs/src/ecosystem/utils/snake-case.md +36 -0
  98. package/docs/src/ecosystem/utils/swipe-handler.md +91 -0
  99. package/docs/src/ecosystem/utils/textarea-autogrow.md +41 -0
  100. package/docs/src/ecosystem/utils/throttle-id.md +48 -0
  101. package/docs/src/ecosystem/utils/throttle.md +57 -0
  102. package/docs/src/ecosystem/utils/truthy-filter.md +31 -0
  103. package/docs/src/ecosystem/utils/types/deep-key-of.md +48 -0
  104. package/docs/src/ecosystem/utils/types/deep-partial.md +42 -0
  105. package/docs/src/ecosystem/utils/types/deep-required.md +39 -0
  106. package/docs/src/ecosystem/utils/types/flatten-object-keys.md +44 -0
  107. package/docs/src/ecosystem/utils/types/generic-instance-type.md +42 -0
  108. package/docs/src/ecosystem/utils/types/infer-maybe-ref.md +35 -0
  109. package/docs/src/ecosystem/utils/upper-first.md +32 -0
  110. package/docs/src/ecosystem/utils/user-visibility.md +69 -0
  111. package/docs/src/guide/getting-started.md +15 -13
  112. package/docs/src/guide/global-defaults.md +101 -0
  113. package/docs/src/guide/maz-ui-provider.md +6 -3
  114. package/docs/src/guide/migration-v4.md +13 -9
  115. package/docs/src/guide/migration-v5.md +67 -12
  116. package/docs/src/guide/resolvers.md +7 -7
  117. package/docs/src/guide/tailwind.md +4 -0
  118. package/docs/src/guide/vue.md +4 -4
  119. package/docs/src/index.md +12 -12
  120. package/docs/src/plugins/aos.md +1 -1
  121. package/docs/src/plugins/wait.md +1 -1
  122. package/package.json +6 -5
  123. package/docs/src/helpers/camel-case.md +0 -14
  124. package/docs/src/helpers/check-availability.md +0 -14
  125. package/docs/src/helpers/debounce-callback.md +0 -14
  126. package/docs/src/helpers/debounce-id.md +0 -14
  127. package/docs/src/helpers/debounce.md +0 -14
  128. package/docs/src/helpers/is-client.md +0 -14
  129. package/docs/src/helpers/is-equal.md +0 -14
  130. package/docs/src/helpers/is-standalone-mode.md +0 -14
  131. package/docs/src/helpers/kebab-case.md +0 -14
  132. package/docs/src/helpers/normalize-string.md +0 -14
  133. package/docs/src/helpers/pascal-case.md +0 -14
  134. package/docs/src/helpers/script-loader.md +0 -14
  135. package/docs/src/helpers/sleep.md +0 -14
  136. package/docs/src/helpers/snake-case.md +0 -14
  137. package/docs/src/helpers/throttle-id.md +0 -14
  138. package/docs/src/helpers/throttle.md +0 -14
  139. /package/docs/src/{guide → ecosystem/icons}/icon-set.md +0 -0
  140. /package/docs/src/{guide → ecosystem}/mcp.md +0 -0
  141. /package/docs/src/{helpers → ecosystem/utils}/country-code-to-unicode-flag.md +0 -0
  142. /package/docs/src/{helpers → ecosystem/utils}/get-country-flag-url.md +0 -0
package/docs/generated-docs/maz-btn.doc.md CHANGED
@@ -6,7 +6,7 @@
6
6
  | **size** | Predifined sizes of the button | `MazSize` | No | `undefined` | `'xl' \| 'lg' \| 'md' \| 'sm' \| 'xs' \| 'mini'` |
7
7
  | **color** | The color of the button | `MazColor \| "surface"` | No | `undefined` | `'primary' \| 'secondary' \| 'info' \| 'success' \| 'warning' \| 'destructive' \| 'transparent' \| 'contrast' \| 'accent' \| 'surface'` |
8
8
  | **type** | The type of the button | `"submit" \| "reset" \| "button"` | No | `undefined` | `'submit' \| 'reset' \| 'button'` |
9
- | **rounded-size** | Size of the rounded | `"none" \| "sm" \| "md" \| "lg" \| "xl" \| "full"` | No | `md` | `'none' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full'` |
9
+ | **rounded-size** | Size of the rounded | `MazRoundedSize` | No | `md` | `'none' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full'` |
10
10
  | **outlined** | If true, the button have the "border" style | `boolean` | No | `false` | - |
11
11
  | **pastel** | If true, the button will have a pastel color | `boolean` | No | `false` | - |
12
12
  | **block** | If true, the button will have a full width | `boolean` | No | `false` | - |
package/docs/generated-docs/maz-checkbox.doc.md CHANGED
@@ -1,22 +1,21 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | --------------- | -------------------------------------------- | ------------------ | -------- | -------------- |
5
- | **style** | Style attribut of the component root element | `Native type` | No | `undefined` |
6
- | **class** | Class attribut of the component root element | `Native type` | No | `undefined` |
7
- | **model-value** | The model value of the checkbox | `T` | No | `undefined` |
8
- | **id** | The id of the checkbox | `string` | No | `undefined` |
9
- | **color** | The color of the checkbox | `MazColor` | No | `'primary'` |
10
- | **value** | The value of the checkbox when selected | `MazCheckboxValue` | No | `undefined` |
11
- | **name** | The name of the checkbox | `string` | No | `'m-checkbox'` |
12
- | **size** | The size of the checkbox | `MazSize` | No | `'md'` |
13
- | **label** | Text label | `string` | No | `undefined` |
14
- | **disabled** | If the checkbox is disabled | `boolean` | No | `false` |
15
- | **error** | Whether there is an error with the input. | `boolean` | No | `undefined` |
16
- | **success** | Whether the input is successful. | `boolean` | No | `undefined` |
17
- | **warning** | Whether there is a warning with the input. | `boolean` | No | `undefined` |
18
- | **hint** | The hint text to display below the input. | `string` | No | `undefined` |
19
- | **tabindex** | | `any` | No | `0` |
3
+ | Name | Description | Type | Required |
4
+ | --------------- | -------------------------------------------- | ------------------ | -------- |
5
+ | **style** | Style attribut of the component root element | `Native type` | No |
6
+ | **class** | Class attribut of the component root element | `Native type` | No |
7
+ | **model-value** | The model value of the checkbox | `T` | No |
8
+ | **id** | The id of the checkbox | `string` | No |
9
+ | **color** | The color of the checkbox | `MazColor` | No |
10
+ | **value** | The value of the checkbox when selected | `MazCheckboxValue` | No |
11
+ | **name** | The name of the checkbox | `string` | No |
12
+ | **size** | The size of the checkbox | `MazSize` | No |
13
+ | **label** | Text label | `string` | No |
14
+ | **disabled** | If the checkbox is disabled | `boolean` | No |
15
+ | **error** | Whether there is an error with the input. | `boolean` | No |
16
+ | **success** | Whether the input is successful. | `boolean` | No |
17
+ | **warning** | Whether there is a warning with the input. | `boolean` | No |
18
+ | **hint** | The hint text to display below the input. | `string` | No |
20
19
 
21
20
  ## Events
22
21
 
package/docs/generated-docs/maz-circular-progress-bar.doc.md CHANGED
@@ -3,7 +3,7 @@
3
3
  | Name | Description | Type | Required | Default | Possible values |
4
4
  | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | -------- | -------------------------------------------- | ------------------------------------ |
5
5
  | **percentage** | The percentage value of the progress bar | `number` | Yes | `undefined` | - |
6
- | **size** | The size of the progress bar | `string` | No | `10em' (equal 80px for a font-size of 16px)` | - |
6
+ | **size** | The size of the progress bar | `MazSizeUnit` | No | `10em' (equal 80px for a font-size of 16px)` | - |
7
7
  | **duration** | Duration of the animation in milliseconds | `number` | No | `1000` | - |
8
8
  | **delay** | Delay before the animation starts in milliseconds | `number` | No | `100` | - |
9
9
  | **color** | The color of the progress bar | `MazColor` | No | `undefined` | - |
package/docs/generated-docs/maz-code-highlight.doc.md ADDED
@@ -0,0 +1,11 @@
1
+ ## Props
2
+
3
+ | Name | Description | Type | Required | Default |
4
+ | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | -------- | ----------- |
5
+ | **code** | Source code to highlight | `string` | No | `undefined` |
6
+ | **language** | Language identifier for syntax highlighting (e.g. 'vue', 'ts', 'bash') | `string` | No | `undefined` |
7
+ | **theme** | Override the shiki theme name. Defaults to github-light/github-dark based on current color mode | `string` | No | `undefined` |
8
+ | **rounded** | Apply rounded corners on the highlighted code block. | `boolean` | No | `true` |
9
+ | **copyable** | Show the copy-to-clipboard button on hover. | `boolean` | No | `true` |
10
+ | **copy-value** | Value copied to the clipboard. Falls back to the resolved code when omitted. Useful when the displayed code differs from what should be copied (e.g. terminal prompt prefix). | `string` | No | `undefined` |
11
+ | **translations** | Custom translations for the component. Override either key independently. | `Partial<MazUiTranslationsNestedSchema['codeHighlight']>` | No | `undefined` |
package/docs/generated-docs/maz-date-picker.doc.md CHANGED
@@ -1,46 +1,46 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default | Possible values |
4
- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | -------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
5
- | **id** | The unique identifier of the component | `string` | No | `undefined` | - |
6
- | **style** | The inline style object for the component | `HTMLAttributes['style']` | No | `undefined` | - |
7
- | **class** | The CSS class(es) to apply to the component | `HTMLAttributes['class']` | No | `undefined` | - |
8
- | **input-props** | The props to apply to the input component | `MazInputProps` | No | `undefined` | - |
9
- | **model-value** | The value of the date picker component If an object is provided, the picker will be a range picker | `MazDatePickerValue` | No | `undefined` | - |
10
- | **format** | The format pattern for date display and parsing<br/>**Example:** `'YYYY-MM-DD', 'DD/MM/YYYY', 'YYYY-MM-DD HH:mm'` | `string` | No | `'YYYY-MM-DD'` | - |
11
- | **open** | `v-model:open` <br/>Controls whether the picker window is open | `boolean` | No | `false` | - |
12
- | **label** | The label text displayed above the input field | `string` | No | `undefined` | - |
13
- | **placeholder** | The placeholder text shown when no value is selected | `string` | No | `undefined` | - |
14
- | **input-date-format** | The Intl.DateTimeFormatOptions for styling the input date display | `Intl.DateTimeFormatOptions` | No | `() => ({ dateStyle: 'medium', timeStyle: 'short' })` | - |
15
- | **input-date-transformer** | Custom function to transform the formatted date display | `Function` | No | `undefined` | - |
16
- | **locale** | The locale string for date formatting and localization<br/>**Example:** `'en-US', 'fr-FR', 'de-DE'` | `string` | No | `undefined` | - |
17
- | **hide-header** | Controls whether the calendar header is hidden | `boolean` | No | `false` | - |
18
- | **disabled** | Controls whether the component is disabled | `boolean` | No | `false` | - |
19
- | **first-day-of-week** | The first day of the week in the calendar<br/>**Example:** `0 (Sunday), 1 (Monday), 6 (Saturday)` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6` | No | `0` | `0, 1, 2, 3, 4, 5, 6` |
20
- | **auto-close** | Controls whether the picker closes automatically after date selection | `boolean` | No | `false` | - |
21
- | **custom-element-selector** | CSS selector for a custom element that triggers the picker<br/>**Example:** `'#my-button', '.trigger-class'` | `string` | No | `undefined` | - |
22
- | **double** | Controls whether the picker displays two months side by side | `boolean` | No | `false` | - |
23
- | **inline** | Controls whether the picker is displayed inline without input field | `boolean` | No | `false` | - |
24
- | **color** | The color theme of the component | `MazColor` | No | `'primary'` | `primary, secondary, success, destructive, warning, info, accent, contrast` |
25
- | **picker-position** | The position where the picker popover should appear | `MazPopoverProps['position']` | No | `'auto'` | `top, bottom, left, right, top-end, bottom-end, left-end, right-end, top-start, bottom-start, left-start, right-start` |
26
- | **picker-prefer-position** | The preferred position of the picker popover | `MazPopoverProps['preferPosition']` | No | `'bottom-start'` | `top, bottom, left, right, top-end, bottom-end, left-end, right-end, top-start, bottom-start, left-start, right-start` |
27
- | **picker-fallback-position** | The fallback position of the picker popover | `MazPopoverProps['fallbackPosition']` | No | `'top-start'` | `top, bottom, left, right, top-end, bottom-end, left-end, right-end, top-start, bottom-start, left-start, right-start` |
28
- | **time** | Controls whether the picker includes a time selector | `boolean` | No | `false` | - |
29
- | **only-time** | Controls whether the picker shows only time selection (no date) | `boolean` | No | `false` | - |
30
- | **minute-interval** | The interval in minutes for the time picker minute selection | `number` | No | `5` | `1, 5, 10, 15, 30` |
31
- | **use-browser-locale** | Controls whether to automatically detect and use the browser's locale | `boolean` | No | `true` | - |
32
- | **fetch-local** | Controls whether to fetch locale data dynamically | `boolean` | No | `true` | - |
33
- | **shortcuts** | Array of predefined date range shortcuts or false to disable | `MazDatePickerShortcut[] \| false` | No | `true` | - |
34
- | **shortcut** | The identifier of the currently selected shortcut | `MazDatePickerShortcut['identifier']` | No | `undefined` | - |
35
- | **min-date** | The minimum selectable date in ISO format<br/>**Example:** `'2023-01-01'` | `string` | No | `undefined` | - |
36
- | **max-date** | The maximum selectable date in ISO format<br/>**Example:** `'2024-12-31'` | `string` | No | `undefined` | - |
37
- | **min-max-auto** | When minDate or maxDate are provided, if the current date is not between minDate and maxDate, the current date will be set to the minDate or maxDate | `boolean` | No | `true` | - |
38
- | **disabled-weekly** | Array of weekday numbers to disable (0 = Sunday, 6 = Saturday)<br/>**Example:** `[0, 6] to disable weekends` | `number[]` | No | `() => []` | - |
39
- | **disabled-dates** | Array of specific dates to disable in ISO format<br/>**Example:** `['2023-12-25', '2024-01-01']` | `string[]` | No | `() => []` | - |
40
- | **disabled-hours** | Array of hour numbers to disable in the time picker (0-23)<br/>**Example:** `[0, 1, 2, 22, 23] to disable night hours` | `number[]` | No | `() => []` | - |
41
- | **block** | Controls whether the input displays in full width | `boolean` | No | `false` | - |
42
- | **range** | Controls whether the picker operates in range selection mode | `boolean` | No | `false` | - |
43
- | **transition** | The transition name of the popover | `MazPopoverProps['transition']` | No | `'scale-fade'` | - |
3
+ | Name | Description | Type | Required | Default | Possible values |
4
+ | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | -------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
5
+ | **id** | The unique identifier of the component | `string` | No | `undefined` | - |
6
+ | **style** | The inline style object for the component | `HTMLAttributes['style']` | No | `undefined` | - |
7
+ | **class** | The CSS class(es) to apply to the component | `HTMLAttributes['class']` | No | `undefined` | - |
8
+ | **input-props** | The props to apply to the input component | `MazInputProps` | No | `undefined` | - |
9
+ | **model-value** | The value of the date picker component If an object is provided, the picker will be a range picker | `MazDatePickerValue` | No | `undefined` | - |
10
+ | **format** | The format pattern for date display and parsing<br/>**Example:** `'YYYY-MM-DD', 'DD/MM/YYYY', 'YYYY-MM-DD HH:mm'` | `string` | No | `YYYY-MM-DD` | - |
11
+ | **open** | `v-model:open` <br/>Controls whether the picker window is open | `boolean` | No | `false` | - |
12
+ | **label** | The label text displayed above the input field | `string` | No | `undefined` | - |
13
+ | **placeholder** | The placeholder text shown when no value is selected | `string` | No | `undefined` | - |
14
+ | **input-date-format** | The Intl.DateTimeFormatOptions for styling the input date display | `Intl.DateTimeFormatOptions` | No | `{ dateStyle: 'medium', timeStyle: 'short' }` | - |
15
+ | **input-date-transformer** | Custom function to transform the formatted date display | `Function` | No | `undefined` | - |
16
+ | **locale** | The locale string for date formatting and localization<br/>**Example:** `'en-US', 'fr-FR', 'de-DE'` | `string` | No | `undefined` | - |
17
+ | **hide-header** | Controls whether the calendar header is hidden | `boolean` | No | `false` | - |
18
+ | **disabled** | Controls whether the component is disabled | `boolean` | No | `false` | - |
19
+ | **first-day-of-week** | The first day of the week in the calendar<br/>**Example:** `0 (Sunday), 1 (Monday), 6 (Saturday)` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6` | No | `0` | `0, 1, 2, 3, 4, 5, 6` |
20
+ | **auto-close** | Controls whether the picker closes automatically after date selection | `boolean` | No | `false` | - |
21
+ | **custom-element-selector** | CSS selector for a custom element that triggers the picker<br/>**Example:** `'#my-button', '.trigger-class'` | `string` | No | `undefined` | - |
22
+ | **double** | Controls whether the picker displays two months side by side | `boolean` | No | `false` | - |
23
+ | **inline** | Controls whether the picker is displayed inline without input field | `boolean` | No | `false` | - |
24
+ | **color** | The color theme of the component | `MazColor` | No | `primary` | `primary, secondary, success, destructive, warning, info, accent, contrast` |
25
+ | **picker-position** | The position where the picker popover should appear | `MazPopoverProps['position']` | No | `auto` | `top, bottom, left, right, top-end, bottom-end, left-end, right-end, top-start, bottom-start, left-start, right-start` |
26
+ | **picker-prefer-position** | The preferred position of the picker popover | `MazPopoverProps['preferPosition']` | No | `bottom-start` | `top, bottom, left, right, top-end, bottom-end, left-end, right-end, top-start, bottom-start, left-start, right-start` |
27
+ | **picker-fallback-position** | The fallback position of the picker popover | `MazPopoverProps['fallbackPosition']` | No | `top-start` | `top, bottom, left, right, top-end, bottom-end, left-end, right-end, top-start, bottom-start, left-start, right-start` |
28
+ | **time** | Controls whether the picker includes a time selector | `boolean` | No | `false` | - |
29
+ | **only-time** | Controls whether the picker shows only time selection (no date) | `boolean` | No | `false` | - |
30
+ | **minute-interval** | The interval in minutes for the time picker minute selection | `number` | No | `5` | `1, 5, 10, 15, 30` |
31
+ | **use-browser-locale** | Controls whether to automatically detect and use the browser's locale | `boolean` | No | `true` | - |
32
+ | **fetch-local** | Controls whether to fetch locale data dynamically | `boolean` | No | `true` | - |
33
+ | **shortcuts** | Array of predefined date range shortcuts or false to disable | `MazDatePickerShortcut[] \| false` | No | `[predefined shortcuts array]` | - |
34
+ | **shortcut** | The identifier of the currently selected shortcut | `MazDatePickerShortcut['identifier']` | No | `undefined` | - |
35
+ | **min-date** | The minimum selectable date in ISO format<br/>**Example:** `'2023-01-01'` | `string` | No | `undefined` | - |
36
+ | **max-date** | The maximum selectable date in ISO format<br/>**Example:** `'2024-12-31'` | `string` | No | `undefined` | - |
37
+ | **min-max-auto** | When minDate or maxDate are provided, if the current date is not between minDate and maxDate, the current date will be set to the minDate or maxDate | `boolean` | No | `true` | - |
38
+ | **disabled-weekly** | Array of weekday numbers to disable (0 = Sunday, 6 = Saturday)<br/>**Example:** `[0, 6] to disable weekends` | `number[]` | No | `[]` | - |
39
+ | **disabled-dates** | Array of specific dates to disable in ISO format<br/>**Example:** `['2023-12-25', '2024-01-01']` | `string[]` | No | `[]` | - |
40
+ | **disabled-hours** | Array of hour numbers to disable in the time picker (0-23)<br/>**Example:** `[0, 1, 2, 22, 23] to disable night hours` | `number[]` | No | `[]` | - |
41
+ | **block** | Controls whether the input displays in full width | `boolean` | No | `false` | - |
42
+ | **range** | Controls whether the picker operates in range selection mode | `boolean` | No | `false` | - |
43
+ | **transition** | The transition name of the popover | `MazPopoverProps['transition']` | No | `scale-fade` | - |
44
44
 
45
45
  ## Events
46
46
 
package/docs/generated-docs/maz-drawer.doc.md CHANGED
@@ -1,13 +1,12 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default | Possible values |
4
- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | -------- | ----------- | ------------------------------- |
5
- | **title** | The title of the drawer | `string` | No | `undefined` | - |
6
- | **variant** | The edge from which the drawer slides in. `start` (= left in LTR, right in RTL) and `end` (= right in LTR, left in RTL) follow the document direction; `top` and `bottom` are physical. | `"start" \| "end" \| "top" \| "bottom"` | No | `'end'` | `start', 'end', 'top', 'bottom` |
7
- | **size** | The size of the drawer | `string` | No | `'30rem'` | - |
8
- | **backdrop-class** | The class of the backdrop | `string` | No | `undefined` | - |
9
- | **hide-close-button** | Disable the close button | `boolean` | No | `undefined` | - |
10
- | **no-close** | | `any` | No | `false` | - |
3
+ | Name | Description | Type | Required | Possible values |
4
+ | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | -------- | ------------------------------- |
5
+ | **title** | The title of the drawer | `string` | No | - |
6
+ | **variant** | The edge from which the drawer slides in. `start` (= left in LTR, right in RTL) and `end` (= right in LTR, left in RTL) follow the document direction; `top` and `bottom` are physical. | `"start" \| "end" \| "top" \| "bottom"` | No | `start', 'end', 'top', 'bottom` |
7
+ | **size** | The size of the drawer | `MazSizeUnit` | No | - |
8
+ | **backdrop-class** | The class of the backdrop | `string` | No | - |
9
+ | **hide-close-button** | Disable the close button | `boolean` | No | - |
11
10
 
12
11
  ## Events
13
12
 
package/docs/generated-docs/maz-expand-animation.doc.md CHANGED
@@ -1,9 +1,9 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | ------------------- | ----------------------------------------- | -------- | -------- | --------------- |
5
- | **duration** | Duration of the animation in milliseconds | `string` | No | `'300ms'` |
6
- | **timing-function** | Timing function of the animation | `string` | No | `'ease-in-out'` |
3
+ | Name | Description | Type | Required | Default |
4
+ | ------------------- | ----------------------------------------- | -------- | -------- | ------------- |
5
+ | **duration** | Duration of the animation in milliseconds | `string` | No | `300ms` |
6
+ | **timing-function** | Timing function of the animation | `string` | No | `ease-in-out` |
7
7
 
8
8
  ## Slots
9
9
 
package/docs/generated-docs/maz-fullscreen-loader.doc.md CHANGED
@@ -1,10 +1,10 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required |
4
- | --------------------- | ----------------------------------- | ---------- | -------- |
5
- | **color** | The color of the spinner | `MazColor` | No |
6
- | **size** | The size of the spinner | `string` | No |
7
- | **teleport-selector** | The selector to teleport the loader | `string` | No |
3
+ | Name | Description | Type | Required |
4
+ | --------------------- | ----------------------------------- | ------------- | -------- |
5
+ | **color** | The color of the spinner | `MazColor` | No |
6
+ | **size** | The size of the spinner | `MazSizeUnit` | No |
7
+ | **teleport-selector** | The selector to teleport the loader | `string` | No |
8
8
 
9
9
  ## Slots
10
10
 
package/docs/generated-docs/maz-gallery.doc.md CHANGED
@@ -1,17 +1,17 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | -------- | ------------------------ |
5
- | **images** | Array of string or object: `['https://via.placeholder.com/500', 'https://via.placeholder.com/600']` or `[{ slug: 'https://via.placeholder.com/500', alt: 'image descripton' }, { slug: 'https://via.placeholder.com/600', alt: 'image descripton' }]` | `MazGalleryImage[]` | No | `undefined` |
6
- | **displayed-count** | Images count shown (max: 5) | `number` | No | `5` |
7
- | **remaining** | Remove transparent layer with the remain count (ex: +2) | `boolean` | No | `true` |
8
- | **height** | Height of gallery - set to `false` to remove default height | `number \| string \| false` | No | `150` |
9
- | **width** | Width of gallery - set to `false` to remove default width | `number \| string \| false` | No | `100%` |
10
- | **radius** | Disable the border radius of the gallery | `boolean` | No | `false` |
11
- | **zoom** | Disable full size display when clicking on image | `boolean` | No | `false` |
12
- | **has-empty-layer** | Layer with photography icon when no images is provided | `boolean` | No | `true` |
13
- | **lazy** | Lazy load image - if false, images are directly loaded | `boolean` | No | `true` |
14
- | **blur** | Disable blur effect on image hover | `boolean` | No | `true` |
15
- | **scale** | Disable scale animation effect on image hover | `boolean` | No | `true` |
16
- | **separator-color** | Choose color of borders between images - Should be a CSS color or CSS variable - Ex: `#000` or `var(--maz-surface-300)` | `string` | No | `transparent` |
17
- | **background-color** | Choose background color of the gallery - Should be a CSS color or CSS variable - Ex: `#000` or `var(--maz-surface-300)` | `string` | No | `var(--maz-surface-300)` |
3
+ | Name | Description | Type | Required | Default |
4
+ | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | -------- | ------------- |
5
+ | **images** | Array of string or object: `['https://via.placeholder.com/500', 'https://via.placeholder.com/600']` or `[{ slug: 'https://via.placeholder.com/500', alt: 'image descripton' }, { slug: 'https://via.placeholder.com/600', alt: 'image descripton' }]` | `MazGalleryImage[]` | No | `undefined` |
6
+ | **displayed-count** | Images count shown (max: 5) | `number` | No | `5` |
7
+ | **remaining** | Remove transparent layer with the remain count (ex: +2) | `boolean` | No | `true` |
8
+ | **height** | Height of gallery - set to `false` to remove default height | `number \| string \| false` | No | `150` |
9
+ | **width** | Width of gallery - set to `false` to remove default width | `number \| string \| false` | No | `100%` |
10
+ | **radius** | Disable the border radius of the gallery | `boolean` | No | `false` |
11
+ | **zoom** | Disable full size display when clicking on image | `boolean` | No | `false` |
12
+ | **has-empty-layer** | Layer with photography icon when no images is provided | `boolean` | No | `true` |
13
+ | **lazy** | Lazy load image - if false, images are directly loaded | `boolean` | No | `true` |
14
+ | **blur** | Disable blur effect on image hover | `boolean` | No | `true` |
15
+ | **scale** | Disable scale animation effect on image hover | `boolean` | No | `true` |
16
+ | **separator-color** | Choose color of borders between images - Should be a CSS color or CSS variable - Ex: `#000` | `string` | No | `transparent` |
17
+ | **background-color** | Choose background color of the gallery - Should be a CSS color or CSS variable - Ex: `#000` | `string` | No | `undefined` |
package/docs/generated-docs/maz-input-code.doc.md CHANGED
@@ -1,21 +1,21 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default |
4
- | ---------------- | ------------------------------------------ | -------------------- | -------- | ----------- |
5
- | **style** | The style of the component. | `Native type` | No | `undefined` |
6
- | **class** | The class of the component. | `Native type` | No | `undefined` |
7
- | **model-value** | The value of the component (v-model). | `T` | No | `undefined` |
8
- | **code-length** | The length of the code. | `number` | No | `4` |
9
- | **type** | The type of the input field. | `"text" \| "number"` | No | `'text'` |
10
- | **accept-alpha** | Whether to accept alpha characters. | `boolean` | No | `false` |
11
- | **required** | Whether the input is required. | `boolean` | No | `false` |
12
- | **disabled** | Whether the input is disabled. | `boolean` | No | `false` |
13
- | **error** | Whether there is an error with the input. | `boolean` | No | `false` |
14
- | **success** | Whether the input is successful. | `boolean` | No | `false` |
15
- | **warning** | Whether there is a warning with the input. | `boolean` | No | `false` |
16
- | **size** | The size of the component. | `MazInputCodeSize` | No | `'md'` |
17
- | **color** | The color of the component. | `MazColor` | No | `'primary'` |
18
- | **hint** | The hint text to display below the input. | `string` | No | `undefined` |
3
+ | Name | Description | Type | Required |
4
+ | ---------------- | ------------------------------------------ | -------------------- | -------- |
5
+ | **style** | The style of the component. | `Native type` | No |
6
+ | **class** | The class of the component. | `Native type` | No |
7
+ | **model-value** | The value of the component (v-model). | `T` | No |
8
+ | **code-length** | The length of the code. | `number` | No |
9
+ | **type** | The type of the input field. | `"text" \| "number"` | No |
10
+ | **accept-alpha** | Whether to accept alpha characters. | `boolean` | No |
11
+ | **required** | Whether the input is required. | `boolean` | No |
12
+ | **disabled** | Whether the input is disabled. | `boolean` | No |
13
+ | **error** | Whether there is an error with the input. | `boolean` | No |
14
+ | **success** | Whether the input is successful. | `boolean` | No |
15
+ | **warning** | Whether there is a warning with the input. | `boolean` | No |
16
+ | **size** | The size of the component. | `MazInputCodeSize` | No |
17
+ | **color** | The color of the component. | `MazColor` | No |
18
+ | **hint** | The hint text to display below the input. | `string` | No |
19
19
 
20
20
  ## Events
21
21
 
package/docs/generated-docs/maz-input-phone-number.doc.md CHANGED
@@ -1,43 +1,47 @@
1
1
  ## Props
2
2
 
3
- | Name | Description | Type | Required | Default | Possible values |
4
- | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
5
- | **style** | Style attribut of the component root element | `HTMLAttributes['style']` | No | `undefined` | - |
6
- | **class** | Class attribut of the component root element | `HTMLAttributes['class']` | No | `undefined` | - |
7
- | **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` | - |
8
- | **country-code** | `v-model:country-code` <br/>The selected country code (e.g. "FR")<br/>**Example:** `"FR"` | `CountryCode \| undefined \| null` | No | `undefined` | - |
9
- | **id** | Unique identifier for the component<br/>**Example:** `"phone-input-1"` | `string` | No | `undefined` | - |
10
- | **placeholder** | Text displayed when the input is empty<br/>**Example:** `"Enter your phone number"` | `string` | No | `undefined` | - |
11
- | **label** | Label displayed above the input<br/>**Example:** `"Phone Number"` | `string` | No | `undefined` | - |
12
- | **preferred-countries** | List of country codes to place first in the select list<br/>**Example:** `["FR", "BE", "GE"]` | `CountryCode[]` | No | `undefined` | - |
13
- | **ignored-countries** | List of country codes to be removed from the select list<br/>**Example:** `["FR", "BE", "GE"]` | `CountryCode[]` | No | `undefined` | - |
14
- | **only-countries** | List of country codes to only have the countries selected in the select list<br/>**Example:** `["FR", "BE", "GE"]` | `CountryCode[]` | No | `undefined` | - |
15
- | **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}', }, }` | - |
16
- | **list-position** | Position where the list of countries will be opened | `MazPopoverProps['position']` | No | `'bottom-start'` | `top left, top right, bottom left, bottom right` |
17
- | **color** | Component color applied | `MazColor` | No | `'primary'` | `primary, secondary, accent, info, success, warning, destructive, contrast` |
18
- | **size** | Component size applied | `MazSize` | No | `'md'` | `xs, sm, md, lg, xl, mini` |
19
- | **hide-flags** | Remove flags in country list | `boolean` | No | `false` | - |
20
- | **disabled** | Make the input disabled | `boolean` | No | `false` | - |
21
- | **required** | Make the input required | `boolean` | No | `false` | - |
22
- | **example** | Show the phone number example | `boolean` | No | `true` | - |
23
- | **search** | Disable search input in country list | `boolean` | No | `true` | - |
24
- | **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` | - |
25
- | **use-browser-locale** | If true, the browser locale will be used | `boolean` | No | `true` | - |
26
- | **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` | - |
27
- | **hide-country-select** | Hide the country selector | `boolean` | No | `false` | - |
28
- | **show-code-in-list** | Show country calling code in the country list | `boolean` | No | `false` | - |
29
- | **custom-countries-list** | Replace country names | `Record<CountryCode, string>` | No | `undefined` | - |
30
- | **auto-format** | Disabled auto-format when phone is valid | `"blur" \| "typing" \| "disabled" \| false` | No | `'blur'` | - |
31
- | **country-locale** | Locale of country list<br/>**Example:** `"fr-FR"` | `string` | No | `undefined` | - |
32
- | **validation-error** | Disable validation error UI | `boolean` | No | `true` | - |
33
- | **validation-success** | Disable validation success UI | `boolean` | No | `true` | - |
34
- | **success** | Add success UI | `boolean` | No | `false` | - |
35
- | **error** | Add error UI | `boolean` | No | `false` | - |
36
- | **display-country-name** | Will replace the calling code by the country name in the country selector | `boolean` | No | `false` | - |
37
- | **block** | The input will be displayed in full width | `boolean` | No | `false` | - |
38
- | **orientation** | Orientation of the inputs in the component | `'row' \| 'col' \| 'responsive'` | No | `'responsive'` | `row, col, responsive` |
39
- | **country-select-attributes** | Meta attributes of the country input | `Record<string, unknown>` | No | `() => ({ name: 'country', autocomplete: 'off', style: { width: '14rem', }, })` | - |
40
- | **phone-input-attributes** | Meta attributes of the phone number input | `Record<string, unknown>` | No | `() => ({ name: 'phone', autocomplete: 'tel', inputmode: 'tel', })` | - |
3
+ | Name | Description | Type | Required | Default | Possible values |
4
+ | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
5
+ | **style** | Style attribut of the component root element | `HTMLAttributes['style']` | No | `undefined` | - |
6
+ | **class** | Class attribut of the component root element | `HTMLAttributes['class']` | No | `undefined` | - |
7
+ | **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` | - |
8
+ | **country-code** | `v-model:country-code` <br/>The selected country code (e.g. "FR")<br/>**Example:** `"FR"` | `CountryCode \| undefined \| null` | No | `undefined` | - |
9
+ | **id** | Unique identifier for the component<br/>**Example:** `"phone-input-1"` | `string` | No | `undefined` | - |
10
+ | **placeholder** | Text displayed when the input is empty<br/>**Example:** `"Enter your phone number"` | `string` | No | `undefined` | - |
11
+ | **top-label** | Static label displayed above the input field. Unlike the floating label, this remains fixed<br/>**Example:** `"User Information"` | `string` | No | `undefined` | - |
12
+ | **label** | Label displayed above the input<br/>**Example:** `"Phone Number"` | `string` | No | `undefined` | - |
13
+ | **preferred-countries** | List of country codes to place first in the select list<br/>**Example:** `["FR", "BE", "GE"]` | `CountryCode[]` | No | `undefined` | - |
14
+ | **ignored-countries** | List of country codes to be removed from the select list<br/>**Example:** `["FR", "BE", "GE"]` | `CountryCode[]` | No | `undefined` | - |
15
+ | **only-countries** | List of country codes to only have the countries selected in the select list<br/>**Example:** `["FR", "BE", "GE"]` | `CountryCode[]` | No | `undefined` | - |
16
+ | **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}', }, }` | - |
17
+ | **list-position** | Position where the list of countries will be opened | `MazPopoverProps['position']` | No | `bottom left` | `top left, top right, bottom left, bottom right` |
18
+ | **color** | Component color applied | `MazColor` | No | `primary` | `primary, secondary, accent, info, success, warning, destructive, contrast` |
19
+ | **size** | Component size applied | `MazSize` | No | `md` | `xs, sm, md, lg, xl, mini` |
20
+ | **hide-flags** | Remove flags in country list | `boolean` | No | `false` | - |
21
+ | **disabled** | Make the input disabled | `boolean` | No | `false` | - |
22
+ | **required** | Make the input required | `boolean` | No | `false` | - |
23
+ | **example** | Show the phone number example | `boolean` | No | `true` | - |
24
+ | **search** | Disable search input in country list | `boolean` | No | `true` | - |
25
+ | **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` | - |
26
+ | **use-browser-locale** | If true, the browser locale will be used | `boolean` | No | `true` | - |
27
+ | **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` | - |
28
+ | **hide-country-select** | Hide the country selector | `boolean` | No | `false` | - |
29
+ | **show-code-in-list** | Show country calling code in the country list | `boolean` | No | `false` | - |
30
+ | **custom-countries-list** | Replace country names | `Record<CountryCode, string>` | No | `undefined` | - |
31
+ | **auto-format** | Disabled auto-format when phone is valid | `"blur" \| "typing" \| "disabled" \| false` | No | `blur` | - |
32
+ | **country-locale** | Locale of country list<br/>**Example:** `"fr-FR"` | `string` | No | `undefined` | - |
33
+ | **validation-error** | Disable validation error UI | `boolean` | No | `true` | - |
34
+ | **validation-success** | Disable validation success UI | `boolean` | No | `true` | - |
35
+ | **success** | Add success UI | `boolean` | No | `false` | - |
36
+ | **error** | Add error UI | `boolean` | No | `false` | - |
37
+ | **warning** | Add warning UI | `boolean` | No | `false` | - |
38
+ | **display-country-name** | Will replace the calling code by the country name in the country selector | `boolean` | No | `false` | - |
39
+ | **block** | The input will be displayed in full width | `boolean` | No | `false` | - |
40
+ | **orientation** | Orientation of the inputs in the component | `'row' \| 'col' \| 'responsive'` | No | `responsive` | `row, col, responsive` |
41
+ | **country-select-attributes** | Meta attributes of the country input | `Record<string, unknown>` | No | `{ autocomplete: 'off', name: 'country' }` | - |
42
+ | **phone-input-attributes** | Meta attributes of the phone number input | `Record<string, unknown>` | No | `{ autocomplete: 'tel', name: 'phone', inputmode: 'tel' }` | - |
43
+ | **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` | - |
44
+ | **hint** | Alternative text that replaces the label when provided. Useful for contextual hints<br/>**Example:** `"This phone number is not valid"` | `string` | No | `undefined` | - |
41
45
 
42
46
  ## Events
43
47