@quidgest/ui 0.27.1 → 0.28.0

package/dist/json/api.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.27.1",
+  "version": "0.28.0",
   "components": [
     {
       "name": "QAccordion",
@@ -104,6 +104,28 @@
             "description": "If true, allows multiple collapsible sections to be expanded simultaneously.",
             "required": false,
             "category": "Behavior"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icons for the sections. They reach every section through the defaults cascade,\nunless a section sets its own `icons`.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible strings for the sections. They reach every section through the defaults cascade,\nunless a section sets its own `texts`.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
           }
         ],
         "events": [
@@ -143,6 +165,195 @@
         }
       ]
     },
+    {
+      "name": "QAlert",
+      "description": "Alerts show persistent feedback inside the page, such as a summary of form errors or a notice next to related content. They stay in the document flow until removed. For short-lived notifications that float over the page, use a toast instead. The colors `info`, `success`, `warning` and `danger` set a severity: a default icon, a prefix that screen readers announce before the message (for example \"Warning:\"), and the live region role. Warnings and errors use `role=\"alert\"`, which interrupts the user. Other alerts use `role=\"status\"`, which waits until the user is idle.",
+      "meta": {
+        "props": [
+          {
+            "name": "id",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The component unique identifier.",
+            "required": false,
+            "category": "Identification"
+          },
+          {
+            "name": "title",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The title of the alert, shown above the message.\nWithout a title, the alert is a single-row banner.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "headingLevel",
+            "type": {
+              "kind": "primitive",
+              "name": "number"
+            },
+            "description": "The heading level of the title, so screen reader users can find the alert by its\nheading. Choose the level that fits the page's heading outline. A value outside\n1–6 renders the title as a plain `div`.",
+            "default": "2",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "text",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The message of the alert.\nUse the default slot instead for rich content, such as links or a list of errors.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "color",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The color of the alert.\nCan be chosen from utility colors like 'success' or 'danger',\nor specified using CSS color codes.\n`info`, `success`, `warning` and `danger` also set the severity: the icon from `icons`,\nthe text screen readers announce before the message, and the default `live` value.\nOther colors show no icon unless one is passed in the `icon` slot.",
+            "default": "info",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "variant",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "tonal",
+                "bold",
+                "outlined"
+              ]
+            },
+            "description": "Specifies the visual style of the alert.",
+            "default": "tonal",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "dismissible",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "Whether the alert shows a dismiss button.\nPressing it emits `dismiss`. The alert stays on the page until you remove it.\nWhen the alert is removed while it has focus, focus moves to the next focusable\nelement on the page, or the previous one when nothing follows. To send focus\nelsewhere, move it in the `dismiss` handler.",
+            "required": false,
+            "category": "Behavior"
+          },
+          {
+            "name": "live",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "assertive",
+                "polite",
+                "off"
+              ]
+            },
+            "description": "How screen readers announce the alert.\n`assertive` (`role=\"alert\"`) interrupts the user, `polite` (`role=\"status\"`) waits\nuntil they are idle, and `off` sets no live region.\nDefaults to `assertive` for `warning` and `danger` and to `polite` for any other color.\nScreen readers only announce content that appears after the page loads, and many\nskip a `polite` alert that appears together with its message. Use `assertive` when\nthe message must be heard, and `off` for notices that are part of the page from the start.",
+            "required": false,
+            "category": "Accessibility"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Custom icon configurations: the severity icons and the dismiss icon.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Custom text configurations: the severity texts read before the message,\nand the label of the dismiss button.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          }
+        ],
+        "events": [
+          {
+            "name": "dismiss",
+            "description": "",
+            "type": "[]"
+          }
+        ],
+        "slots": [
+          {
+            "name": "icon",
+            "description": "Replaces the severity icon, or adds an icon to an alert in another color.\nThe icon is decorative and hidden from screen readers, so anything it conveys\nmust also be in the message."
+          },
+          {
+            "name": "default",
+            "description": "The message, for content that `text` cannot hold, such as links or a list of errors."
+          },
+          {
+            "name": "actions",
+            "description": "Buttons or links that act on the alert.\nOn a `bold` alert, a `QButton` here defaults to the `bold` variant in the alert's\non-color, which stands out from the fill. A button that sets its own `color`\nmust contrast with the fill: the theme's primary nearly disappears on a bold\n`danger` alert. For a quieter second action, use `variant=\"bold\"` with the\nalert's own `color`, so the button blends into the fill and only its text shows."
+          }
+        ]
+      },
+      "examples": [
+        {
+          "title": "With Title",
+          "description": "A title stacks the message below it. The title is a level 2 heading by default, so screen reader users can find the alert by its heading. Set `headingLevel` to fit the page's heading outline.",
+          "code": "<QAlert title=\"Unsaved changes\" text=\"Save the record before leaving this page, or your changes will be lost.\" />"
+        },
+        {
+          "title": "Severities",
+          "description": "Each severity color has its own icon and screen reader prefix. Warnings and errors interrupt screen reader users, so keep them for messages that need immediate attention.",
+          "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t<q-alert\n\t\t\t\t\tv-for=\"alert in alerts\"\n\t\t\t\t\t:key=\"alert.color\"\n\t\t\t\t\tv-bind=\"args\"\n\t\t\t\t\t:color=\"alert.color\"\n\t\t\t\t\t:text=\"alert.text\" />\n\t\t\t</div>"
+        },
+        {
+          "title": "Variants",
+          "description": "`tonal` (default), `bold` and `outlined`.",
+          "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t<q-alert\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\tv-bind=\"args\"\n\t\t\t\t\t:variant=\"variant\" />\n\t\t\t</div>"
+        },
+        {
+          "title": "Custom Color",
+          "description": "Any CSS color works too. Colors other than the four severities have no default icon, no screen reader prefix, and use `role=\"status\"`. Pass an icon in the `icon` slot to show one. The slot also replaces the icon of a severity alert.",
+          "code": "<q-alert v-bind=\"args\">\n\t\t\t\t<template #icon>\n\t\t\t\t\t<q-icon icon=\"information-outline\" />\n\t\t\t\t</template>\n\t\t\t</q-alert>"
+        },
+        {
+          "title": "Rich Content",
+          "description": "The default slot takes rich content, such as a list of errors that link to their fields.",
+          "code": "<q-alert v-bind=\"args\">\n\t\t\t\t<ul style=\"margin: 0; padding-inline-start: 1.25rem;\">\n\t\t\t\t\t<li><a href=\"#name\">Enter a name</a></li>\n\t\t\t\t\t<li><a href=\"#email\">Enter a valid email address</a></li>\n\t\t\t\t</ul>\n\t\t\t</q-alert>"
+        },
+        {
+          "title": "Actions",
+          "description": "The `actions` slot holds buttons or links that act on the alert. In a banner they share the row with the message and wrap below it when space runs out.",
+          "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t<q-alert v-bind=\"args\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Delete\" variant=\"bold\" color=\"danger\" />\n\t\t\t\t\t\t<q-button label=\"Cancel\" variant=\"outlined\" color=\"warning\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t\t<q-alert v-bind=\"args\" title=\"Delete record\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Delete\" variant=\"bold\" color=\"danger\" />\n\t\t\t\t\t\t<q-button label=\"Cancel\" variant=\"outlined\" color=\"warning\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t</div>"
+        },
+        {
+          "title": "Actions On Bold",
+          "description": "On a `bold` alert, the theme's default button color can disappear into the fill. A `QButton` in the `actions` slot therefore defaults to the `bold` variant in the alert's on-color (Undo, Try again). For a quieter second action, give the button the alert's own `color` with `variant=\"bold\"`: it blends into the fill and only its text shows (View trash). A button that sets another color must contrast with the fill.",
+          "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t<q-alert v-bind=\"args\" color=\"success\" text=\"The record was deleted.\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Undo\" />\n\t\t\t\t\t\t<q-button label=\"View trash\" variant=\"bold\" color=\"success\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t\t<q-alert v-bind=\"args\" color=\"danger\" text=\"The record could not be saved.\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Try again\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t\t<q-alert\n\t\t\t\t\tv-bind=\"args\"\n\t\t\t\t\tcolor=\"warning\"\n\t\t\t\t\ttitle=\"Delete record\"\n\t\t\t\t\ttext=\"Do you wish to delete this record?\">\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button label=\"Delete\" />\n\t\t\t\t\t\t<q-button label=\"Cancel\" variant=\"bold\" color=\"warning\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t</div>"
+        },
+        {
+          "title": "Dismissible",
+          "description": "`dismissible` adds a dismiss button that emits `dismiss`. The alert stays until you remove it. When it leaves the page with focus inside it, focus moves to the next focusable element, or the previous one when nothing follows, so keyboard and screen reader users keep their place. Inside a dialog or popover, focus stays in it, and the dialog itself takes focus when nothing else in it can. To send focus elsewhere, move it in the `dismiss` handler.",
+          "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem; align-items: start;\">\n\t\t\t\t<q-button\n\t\t\t\t\tlabel=\"Show the alert\"\n\t\t\t\t\t:disabled=\"visible\"\n\t\t\t\t\t@click=\"visible = true\" />\n\t\t\t\t<q-alert\n\t\t\t\t\tv-if=\"visible\"\n\t\t\t\t\tv-bind=\"args\"\n\t\t\t\t\tstyle=\"align-self: stretch;\"\n\t\t\t\t\t@dismiss=\"visible = false\" />\n\t\t\t\t<q-button label=\"Next field\" />\n\t\t\t</div>"
+        },
+        {
+          "title": "Dismissible Bold",
+          "description": "`bold` alerts paint the dismiss button's focus ring in the alert's text color, so it stays visible on the solid fill.",
+          "code": "<QAlert color=\"danger\" variant=\"bold\" :dismissible=\"true\" title=\"The record could not be saved\" text=\"The server did not respond. Try again in a few minutes.\" />"
+        }
+      ]
+    },
     {
       "name": "QAvatar",
       "description": "Avatars visually represent users or entities. They can display an image, initials, or fallback content, and support customization for size, shape, and colors.",
@@ -592,7 +803,7 @@
               "kind": "object",
               "fields": {}
             },
-            "description": "Custom icons for the default separator and the collapsed-items control.",
+            "description": "Custom icons for the default separator and the collapsed-items control.\nPass every key, or omit the prop to keep the defaults.",
             "default": "DEFAULT_ICONS",
             "required": false,
             "category": "Configuration"
@@ -603,7 +814,7 @@
               "kind": "object",
               "fields": {}
             },
-            "description": "Custom accessible strings.",
+            "description": "Custom accessible strings.\nPass every key, or omit the prop to keep the defaults.",
             "default": "DEFAULT_TEXTS",
             "required": false,
             "category": "Configuration"
@@ -669,16 +880,63 @@
             "required": false,
             "category": "Content"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the button.\nThe popover title is the button label.\n\nWith help, the root element is a `display: contents` wrapper around the button\n(and the help), not the button itself, so:\n- Anchor popovers, tooltips, and measurements to the inner `button`, not to the\n  component's `$el`, which has no box.\n- Do not toggle `help` on a focused button: the button is remounted and loses focus.\n- Direct-child selectors such as those of `QButtonGroup` no longer match the button,\n  so `QToggleGroupItem` does not accept help.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QButtonProps.help} is presented. Defaults to a popover.\n\n`subtext` renders the help under the button only in block flow. In a flex row\n(such as a dialog footer) or in an inline run it becomes a sibling beside the\nbutton, or breaks the line, so prefer `popover` or `tooltip` there.",
+            "default": "popover",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "variant",
             "type": {
               "kind": "enum",
               "values": [
                 "tonal",
+                "text",
                 "bold",
                 "outlined",
-                "ghost",
-                "text"
+                "ghost"
               ]
             },
             "description": "Specifies the visual style of the button.",
@@ -697,6 +955,16 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "surface",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The color the button sits on, when it is not the theme background: a utility color\nlike 'primary', or a CSS color code. The label color of the `tonal`, `outlined`,\n`ghost` and `text` variants, and the hover color, are measured against it, so the\nbutton stays readable on a colored banner. Defaults to the theme background.",
+            "required": false,
+            "category": "Presentation"
+          },
           {
             "name": "borderless",
             "type": {
@@ -836,6 +1104,21 @@
           "description": "The default button, suitable for most situations. Displays a label provided by the `label` prop.",
           "code": "<QButton label=\"Button\" />"
         },
+        {
+          "title": "Popover",
+          "description": "Help shown in a popover beside the button. The popover title is the button label.",
+          "code": "<QButton label=\"Button\" help=\"Saves the current record\" />"
+        },
+        {
+          "title": "Tooltip",
+          "description": "Help is a tooltip on the button.",
+          "code": "<QButton label=\"Button\" help=\"Saves the current record\" help-display=\"tooltip\" />"
+        },
+        {
+          "title": "Subtext",
+          "description": "Help rendered under the button.",
+          "code": "<QButton label=\"Button\" help=\"Saves the current record\" help-display=\"subtext\" />"
+        },
         {
           "title": "Icons",
           "description": "Displays an icon alongside the button label.",
@@ -856,6 +1139,11 @@
           "description": "Use the primary button once per page to represent the preferred user action.",
           "code": "<div style=\"display: flex; flex-direction: column; align-items: start; gap: .5rem\">\n\t\t\t\t<div\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\tstyle=\"display: flex; align-items: start; gap: .5rem\">\n\t\t\t\t\t<q-button\n\t\t\t\t\t\tv-for=\"color in colors\"\n\t\t\t\t\t\t:key=\"color\"\n\t\t\t\t\t\t:variant\n\t\t\t\t\t\t:color\n\t\t\t\t\t\t:label=\"color\"\n\t\t\t\t\t\tv-bind=args />\n\t\t\t\t</div>\n\t\t\t</div>"
         },
+        {
+          "title": "Surface",
+          "description": "On a colored banner, set `surface` to the banner's color. The label and the hover are then measured against the banner instead of the page, so they stay readable.",
+          "code": "<div style=\"display: flex; gap: .5rem; padding: 1rem; border-radius: var(--q-border-radius); background-color: var(--q-theme-primary)\">\n\t\t\t\t<q-button\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\t:variant\n\t\t\t\t\tcolor=\"background\"\n\t\t\t\t\tsurface=\"primary\"\n\t\t\t\t\t:label=\"variant\" />\n\t\t\t</div>"
+        },
         {
           "title": "Disabled",
           "description": "Cannot be clicked.",
@@ -1465,6 +1753,16 @@
             "required": false,
             "category": "Identification"
           },
+          {
+            "name": "required",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "If set to true, an asterisk (*) is displayed\nto indicate that the associated field is required.\n\nThe asterisk is decorative (`aria-hidden`). Required state for assistive\ntech should come from the associated control (e.g. native `required` on inputs).",
+            "required": false,
+            "category": "State"
+          },
           {
             "name": "label",
             "type": {
@@ -1476,52 +1774,71 @@
             "category": "Content"
           },
           {
-            "name": "required",
+            "name": "for",
             "type": {
               "kind": "primitive",
-              "name": "boolean"
+              "name": "string"
             },
-            "description": "If set to true, an asterisk (*) is displayed\nto indicate that the associated field is required.\n\nThe asterisk is decorative (`aria-hidden`). Required state for assistive\ntech should come from the associated control (e.g. native `required` on inputs).",
+            "description": "The form field associated with the label.",
             "required": false,
-            "category": "State"
+            "category": "Accessibility"
           },
           {
-            "name": "for",
+            "name": "help",
             "type": {
               "kind": "primitive",
               "name": "string"
             },
-            "description": "The form field associated with the label.",
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
             "required": false,
-            "category": "Accessibility"
+            "category": "Content"
           },
           {
-            "name": "labelPosition",
+            "name": "helpDisplay",
             "type": {
               "kind": "enum",
               "values": [
-                "right",
-                "left",
-                "center",
-                "topleft",
-                "topright"
+                "popover",
+                "tooltip",
+                "subtext"
               ]
             },
-            "description": "Position of the label relative to the input field.\n- 'left': Label appears to the left of the input\n- 'center': Label appears above the input, centered\n- 'right': Label appears to the right of the input\n- 'topleft': Label appears above the input, aligned to the left\n- 'topright': Label appears above the input, aligned to the right",
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "labelPlacement",
             "type": {
               "kind": "enum",
               "values": [
-                "right",
-                "left"
+                "start",
+                "end"
               ]
             },
-            "description": "The placement of the label shown.",
-            "default": "right",
+            "description": "Where the label sits relative to the checkbox. Same values as `QRadioButton`.\n- 'end': Label follows the box\n- 'start': Label precedes the box",
+            "default": "end",
             "required": false,
             "category": "Presentation"
           },
@@ -1531,7 +1848,7 @@
               "kind": "primitive",
               "name": "string"
             },
-            "description": "Applies specified color to the control.",
+            "description": "The color of the checkbox.\nCan be chosen from utility colors like 'success' or 'danger',\nor specified using CSS color codes.",
             "default": "primary",
             "required": false,
             "category": "Presentation"
@@ -1580,17 +1897,6 @@
             "required": false,
             "category": "State"
           },
-          {
-            "name": "icons",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom icon configurations.",
-            "default": "DEFAULT_ICONS",
-            "required": false,
-            "category": "Configuration"
-          },
           {
             "name": "hasFocusOutline",
             "type": {
@@ -1621,6 +1927,14 @@
           }
         ],
         "slots": [
+          {
+            "name": "label.prepend",
+            "description": ""
+          },
+          {
+            "name": "label.append",
+            "description": ""
+          },
           {
             "name": "extras",
             "description": ""
@@ -1633,10 +1947,15 @@
           "description": "A default checkbox.",
           "code": "<QCheckbox label=\"Accept terms and conditions\" />"
         },
+        {
+          "title": "Help",
+          "description": "Help shown in a popover.",
+          "code": "<QCheckbox label=\"Accept terms and conditions\" help=\"Required to create the account\" />"
+        },
         {
           "title": "Label Placement",
           "description": "A checkbox with a label positioned on the left side. Useful for layouts that require labels on the opposite side of the control.",
-          "code": "<QCheckbox label=\"Accept terms and conditions\" label-placement=\"left\" />"
+          "code": "<QCheckbox label=\"Accept terms and conditions\" label-placement=\"start\" />"
         },
         {
           "title": "Readonly",
@@ -1651,7 +1970,7 @@
         {
           "title": "Colors",
           "description": "A demonstration of checkboxes with various color themes. Each checkbox displays a different color to signify distinct states or categories.",
-          "code": "<div style=\"display: flex; gap: 2rem\">\n\t\t\t\t<q-checkbox model-value label=\"Primary Color\" color=\"primary\" />\n\t\t\t\t<q-checkbox model-value label=\"Info Color\" color=\"info\" />\n\t\t\t\t<q-checkbox model-value label=\"Success Color\" color=\"success\" />\n\t\t\t\t<q-checkbox model-value label=\"Warning Color\" color=\"warning\" />\n\t\t\t\t<q-checkbox model-value label=\"Danger Color\" color=\"danger\" />\n\t\t\t</div>"
+          "code": "<div style=\"display: flex; gap: 2rem\">\n\t\t\t\t<q-checkbox model-value label=\"Primary Color\" color=\"primary\" />\n\t\t\t\t<q-checkbox model-value label=\"Info Color\" color=\"info\" />\n\t\t\t\t<q-checkbox model-value label=\"Success Color\" color=\"success\" />\n\t\t\t\t<q-checkbox model-value label=\"Warning Color\" color=\"warning\" />\n\t\t\t\t<q-checkbox model-value label=\"Danger Color\" color=\"danger\" />\n\t\t\t\t<q-checkbox model-value label=\"Custom Color\" color=\"#cc00cc\" />\n\t\t\t</div>"
         },
         {
           "title": "Size",
@@ -1661,12 +1980,12 @@
         {
           "title": "Icons",
           "description": "A checkbox with custom icons for the checked and indeterminate states. This allows for a more personalized or context-specific design.",
-          "code": "<QCheckbox :model-value=\"true\" label=\"Diferent icon\" :icons=\"{\n\t\t\tchecked: { icon: 'skip-next' },\n\t\t\tindeterminate: { icon: 'skip-next' }\n\t\t}\" />"
+          "code": "<QCheckbox :model-value=\"true\" label=\"Diferent icon\" :icons=\"{\n\t\t\thelp: { icon: 'help' },\n\t\t\tchecked: { icon: 'skip-next' },\n\t\t\tindeterminate: { icon: 'skip-next' }\n\t\t}\" />"
         },
         {
           "title": "Indeterminate",
           "description": "A parent-child checkbox hierarchy with an indeterminate state. The parent checkbox reflects the state of its children, useful for managing lists of options.",
-          "code": "<div>\n\t\t\t\t<q-checkbox v-model=\"model\" :indeterminate=\"child01 || child02 || child03\" label-placement=\"right\" label=\"Parent Option\" @update:model-value=\"onUpdateModelValue\" />\n\t\t\t\t<div\n\t\t\t\t\tstyle=\"margin-left: 1.5rem; display: flex; gap: .5rem; flex-direction: column; margin-top: .5rem\">\n\t\t\t\t\t<q-checkbox v-model=\"child01\" label=\"Child 1\" @update:model-value=\"onChildUpdateModelValue\"/>\n\t\t\t\t\t<q-checkbox v-model=\"child02\" label=\"Child 2\" @update:model-value=\"onChildUpdateModelValue\"/>\n\t\t\t\t\t<q-checkbox v-model=\"child03\" label=\"Child 3\" @update:model-value=\"onChildUpdateModelValue\"/>\n\t\t\t\t</div>\n\t\t\t</div>"
+          "code": "<div>\n\t\t\t\t<q-checkbox v-model=\"model\" :indeterminate=\"child01 || child02 || child03\" label-placement=\"end\" label=\"Parent Option\" @update:model-value=\"onUpdateModelValue\" />\n\t\t\t\t<div\n\t\t\t\t\tstyle=\"margin-left: 1.5rem; display: flex; gap: .5rem; flex-direction: column; margin-top: .5rem\">\n\t\t\t\t\t<q-checkbox v-model=\"child01\" label=\"Child 1\" @update:model-value=\"onChildUpdateModelValue\"/>\n\t\t\t\t\t<q-checkbox v-model=\"child02\" label=\"Child 2\" @update:model-value=\"onChildUpdateModelValue\"/>\n\t\t\t\t\t<q-checkbox v-model=\"child03\" label=\"Child 3\" @update:model-value=\"onChildUpdateModelValue\"/>\n\t\t\t\t</div>\n\t\t\t</div>"
         },
         {
           "title": "Extras",
@@ -1910,6 +2229,52 @@
             "required": false,
             "category": "Identification"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "placeholder",
             "type": {
@@ -1978,17 +2343,6 @@
             "description": "If set to true, an asterisk (*) is displayed\nto indicate that the field is required.",
             "required": false,
             "category": "State"
-          },
-          {
-            "name": "texts",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom text configurations.",
-            "default": "DEFAULT_TEXTS",
-            "required": false,
-            "category": "Configuration"
           }
         ],
         "events": [
@@ -2096,6 +2450,38 @@
             "required": false,
             "category": "Identification"
           },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the text field, the clear button, and the list.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the help and clear button labels.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the strings of the text field and the clear button.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "required",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "If set to true, an asterisk (*) is displayed\nto indicate that the associated field is required.\n\nThe asterisk is decorative (`aria-hidden`). Required state for assistive\ntech should come from the associated control (e.g. native `required` on inputs).\nIf set to true, an asterisk (*) is displayed\nto indicate that the field is required.",
+            "required": false,
+            "category": "State"
+          },
           {
             "name": "size",
             "type": {
@@ -2124,17 +2510,6 @@
             "required": false,
             "category": "State"
           },
-          {
-            "name": "texts",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom text configurations.",
-            "default": "DEFAULT_TEXTS",
-            "required": false,
-            "category": "Configuration"
-          },
           {
             "name": "label",
             "type": {
@@ -2146,33 +2521,37 @@
             "category": "Content"
           },
           {
-            "name": "required",
+            "name": "help",
             "type": {
               "kind": "primitive",
-              "name": "boolean"
+              "name": "string"
             },
-            "description": "If set to true, an asterisk (*) is displayed\nto indicate that the associated field is required.\n\nThe asterisk is decorative (`aria-hidden`). Required state for assistive\ntech should come from the associated control (e.g. native `required` on inputs).\nIf set to true, an asterisk (*) is displayed\nto indicate that the field is required.",
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
             "required": false,
-            "category": "State"
+            "category": "Content"
           },
           {
-            "name": "for",
+            "name": "helpDisplay",
             "type": {
-              "kind": "primitive",
-              "name": "string"
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
             },
-            "description": "The form field associated with the label.",
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
             "required": false,
-            "category": "Accessibility"
+            "category": "Presentation"
           },
           {
             "name": "labelPosition",
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -2181,6 +2560,16 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "for",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The form field associated with the label.",
+            "required": false,
+            "category": "Accessibility"
+          },
           {
             "name": "readonly",
             "type": {
@@ -2337,17 +2726,6 @@
             "description": "The value to be used in comparisons,\nused to check if the field has a selected item.",
             "required": false,
             "category": "Configuration"
-          },
-          {
-            "name": "icons",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom icon configurations.",
-            "default": "DEFAULT_ICONS",
-            "required": false,
-            "category": "Configuration"
           }
         ],
         "events": [
@@ -2534,9 +2912,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -2545,6 +2923,52 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the text fields and the clear button.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the strings of the text fields and the clear button.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "size",
             "type": {
@@ -2644,28 +3068,6 @@
             "description": "Enable selecting a range of two dates.",
             "required": false,
             "category": "Configuration"
-          },
-          {
-            "name": "icons",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom icon configurations.",
-            "default": "DEFAULT_ICONS",
-            "required": false,
-            "category": "Configuration"
-          },
-          {
-            "name": "texts",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom text configurations.",
-            "default": "DEFAULT_TEXTS",
-            "required": false,
-            "category": "Configuration"
           }
         ],
         "events": [
@@ -3024,7 +3426,7 @@
               "kind": "object",
               "fields": {}
             },
-            "description": "Custom icon configurations.",
+            "description": "Custom icon configurations. Includes the icons of the prompt input.\nPass every key, or omit the prop to keep the defaults.",
             "default": "DEFAULT_ICONS",
             "required": false,
             "category": "Configuration"
@@ -3035,7 +3437,7 @@
               "kind": "object",
               "fields": {}
             },
-            "description": "Custom text configurations.",
+            "description": "Custom text configurations. Includes the strings of the prompt input.\nPass every key, or omit the prop to keep the defaults.",
             "default": "DEFAULT_TEXTS",
             "required": false,
             "category": "Configuration"
@@ -3182,6 +3584,11 @@
       "meta": {
         "props": [],
         "events": [
+          {
+            "name": "dismiss",
+            "description": "",
+            "type": "[event: KeyboardEvent | QPointerDownOutsideEvent | QFocusOutsideEvent]"
+          },
           {
             "name": "escape-key-down",
             "description": "",
@@ -3201,11 +3608,6 @@
             "name": "interact-outside",
             "description": "",
             "type": "[event: QPointerDownOutsideEvent | QFocusOutsideEvent]"
-          },
-          {
-            "name": "dismiss",
-            "description": "",
-            "type": "[event: KeyboardEvent | QPointerDownOutsideEvent | QFocusOutsideEvent]"
           }
         ],
         "slots": [
@@ -3428,16 +3830,16 @@
               "values": [
                 "top",
                 "bottom",
-                "right",
                 "left",
+                "right",
                 "top-start",
                 "top-end",
                 "bottom-start",
                 "bottom-end",
-                "right-start",
-                "right-end",
                 "left-start",
-                "left-end"
+                "left-end",
+                "right-start",
+                "right-end"
               ]
             },
             "description": "The placement of the dropdown menu.",
@@ -3488,23 +3890,13 @@
             "required": false,
             "category": "Behavior"
           },
-          {
-            "name": "depth",
-            "type": {
-              "kind": "primitive",
-              "name": "number"
-            },
-            "description": "Depth for recursive nesting.",
-            "required": false,
-            "category": "Behavior"
-          },
           {
             "name": "icons",
             "type": {
               "kind": "object",
               "fields": {}
             },
-            "description": "Custom icon configurations.",
+            "description": "Custom icon configurations. Includes the icons of the list.\nPass every key, or omit the prop to keep the defaults.",
             "required": false,
             "category": "Configuration"
           }
@@ -3627,9 +4019,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -3639,6 +4031,53 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
+            "default": "popover",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "size",
             "type": {
@@ -3782,9 +4221,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -3793,6 +4232,52 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "size",
             "type": {
@@ -3861,28 +4346,6 @@
             "description": "Specifies the accepted file types.",
             "required": false,
             "category": "Behavior"
-          },
-          {
-            "name": "icons",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom icon configurations.",
-            "default": "DEFAULT_ICONS",
-            "required": false,
-            "category": "Configuration"
-          },
-          {
-            "name": "texts",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom text configurations.",
-            "default": "DEFAULT_TEXTS",
-            "required": false,
-            "category": "Configuration"
           }
         ],
         "events": [
@@ -4435,9 +4898,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -4446,6 +4909,50 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "size",
             "type": {
@@ -4662,9 +5169,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -4893,6 +5400,17 @@
             "default": "label",
             "required": false,
             "category": "Configuration"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Custom icon configurations, used by every item. Includes the check mark and description icons.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
           }
         ],
         "events": [
@@ -5044,9 +5562,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -5177,9 +5695,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -5189,6 +5707,52 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "size",
             "type": {
@@ -5284,28 +5848,6 @@
             "default": "12",
             "required": false,
             "category": "Presentation"
-          },
-          {
-            "name": "icons",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom icon configurations.",
-            "default": "DEFAULT_ICONS",
-            "required": false,
-            "category": "Configuration"
-          },
-          {
-            "name": "texts",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom text configurations.",
-            "default": "DEFAULT_TEXTS",
-            "required": false,
-            "category": "Configuration"
           }
         ],
         "events": [
@@ -5762,16 +6304,16 @@
               "values": [
                 "top",
                 "bottom",
-                "right",
                 "left",
+                "right",
                 "top-start",
                 "top-end",
                 "bottom-start",
                 "bottom-end",
-                "right-start",
-                "right-end",
                 "left-start",
-                "left-end"
+                "left-end",
+                "right-start",
+                "right-end"
               ]
             },
             "description": "The placement of the overlay.",
@@ -6044,6 +6586,27 @@
             "required": false,
             "category": "Identification"
           },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the clear button and the help button.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "required",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "If set to true, an asterisk (*) is displayed\nto indicate that the associated field is required.\n\nThe asterisk is decorative (`aria-hidden`). Required state for assistive\ntech should come from the associated control (e.g. native `required` on inputs).\nIf set to true, an asterisk (*) is displayed\nto indicate that the field is required.",
+            "required": false,
+            "category": "State"
+          },
           {
             "name": "size",
             "type": {
@@ -6083,33 +6646,37 @@
             "category": "Content"
           },
           {
-            "name": "required",
+            "name": "help",
             "type": {
               "kind": "primitive",
-              "name": "boolean"
+              "name": "string"
             },
-            "description": "If set to true, an asterisk (*) is displayed\nto indicate that the associated field is required.\n\nThe asterisk is decorative (`aria-hidden`). Required state for assistive\ntech should come from the associated control (e.g. native `required` on inputs).\nIf set to true, an asterisk (*) is displayed\nto indicate that the field is required.",
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
             "required": false,
-            "category": "State"
+            "category": "Content"
           },
           {
-            "name": "for",
+            "name": "helpDisplay",
             "type": {
-              "kind": "primitive",
-              "name": "string"
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
             },
-            "description": "The form field associated with the label.",
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
             "required": false,
-            "category": "Accessibility"
+            "category": "Presentation"
           },
           {
             "name": "labelPosition",
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -6118,6 +6685,16 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "for",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The form field associated with the label.",
+            "required": false,
+            "category": "Accessibility"
+          },
           {
             "name": "readonly",
             "type": {
@@ -6204,24 +6781,13 @@
             "required": false,
             "category": "Configuration"
           },
-          {
-            "name": "icons",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom icon configurations.",
-            "default": "DEFAULT_ICONS",
-            "required": false,
-            "category": "Configuration"
-          },
           {
             "name": "texts",
             "type": {
               "kind": "object",
               "fields": {}
             },
-            "description": "Custom text configurations for the visibility toggle.",
+            "description": "Custom text configurations. Includes the visibility toggle and the help button label.\nPass every key, or omit the prop to keep the defaults.",
             "default": "DEFAULT_TEXTS",
             "required": false,
             "category": "Configuration"
@@ -6628,9 +7194,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -6639,6 +7205,52 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the country selector and the clear button.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the texts of the country selector and the clear button.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "size",
             "type": {
@@ -7253,17 +7865,6 @@
             "description": "Whether to disable teleporting the country selector overlay.",
             "required": false,
             "category": "Behavior"
-          },
-          {
-            "name": "texts",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom text configurations.",
-            "default": "DEFAULT_TEXTS",
-            "required": false,
-            "category": "Configuration"
           }
         ],
         "events": [
@@ -7451,16 +8052,16 @@
               "values": [
                 "top",
                 "bottom",
-                "right",
                 "left",
+                "right",
                 "top-start",
                 "top-end",
                 "bottom-start",
                 "bottom-end",
-                "right-start",
-                "right-end",
                 "left-start",
-                "left-end"
+                "left-end",
+                "right-start",
+                "right-end"
               ]
             },
             "description": "The placement of the popover.",
@@ -7976,6 +8577,36 @@
             "required": false,
             "category": "Identification"
           },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "required",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "If set to true, an asterisk (*) is displayed\nto indicate that the associated field is required.\n\nThe asterisk is decorative (`aria-hidden`). Required state for assistive\ntech should come from the associated control (e.g. native `required` on inputs).\nIf set to true, an asterisk (*) is displayed\nto indicate that the field is required.",
+            "required": false,
+            "category": "State"
+          },
           {
             "name": "disabled",
             "type": {
@@ -7997,33 +8628,37 @@
             "category": "Content"
           },
           {
-            "name": "required",
+            "name": "help",
             "type": {
               "kind": "primitive",
-              "name": "boolean"
+              "name": "string"
             },
-            "description": "If set to true, an asterisk (*) is displayed\nto indicate that the associated field is required.\n\nThe asterisk is decorative (`aria-hidden`). Required state for assistive\ntech should come from the associated control (e.g. native `required` on inputs).\nIf set to true, an asterisk (*) is displayed\nto indicate that the field is required.",
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
             "required": false,
-            "category": "State"
+            "category": "Content"
           },
           {
-            "name": "for",
+            "name": "helpDisplay",
             "type": {
-              "kind": "primitive",
-              "name": "string"
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
             },
-            "description": "The form field associated with the label.",
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
             "required": false,
-            "category": "Accessibility"
+            "category": "Presentation"
           },
           {
             "name": "labelPosition",
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -8033,6 +8668,16 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "for",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The form field associated with the label.",
+            "required": false,
+            "category": "Accessibility"
+          },
           {
             "name": "readonly",
             "type": {
@@ -8166,7 +8811,7 @@
         {
           "title": "Colors",
           "description": "A demonstration of radio buttons with different color themes.",
-          "code": "<q-radio-group v-bind=\"args\">\n\t\t\t\t<q-radio-button label=\"Primary\" value=\"primary\" color=\"primary\" />\n\t\t\t\t<q-radio-button label=\"Info\" value=\"info\" color=\"info\" />\n\t\t\t\t<q-radio-button label=\"Success\" value=\"success\" color=\"success\" />\n\t\t\t\t<q-radio-button label=\"Warning\" value=\"warning\" color=\"warning\" />\n\t\t\t\t<q-radio-button label=\"Danger\" value=\"danger\" color=\"danger\" />\n\t\t\t</q-radio-group>"
+          "code": "<q-radio-group v-bind=\"args\">\n\t\t\t\t<q-radio-button label=\"Primary\" value=\"primary\" color=\"primary\" />\n\t\t\t\t<q-radio-button label=\"Info\" value=\"info\" color=\"info\" />\n\t\t\t\t<q-radio-button label=\"Success\" value=\"success\" color=\"success\" />\n\t\t\t\t<q-radio-button label=\"Warning\" value=\"warning\" color=\"warning\" />\n\t\t\t\t<q-radio-button label=\"Danger\" value=\"danger\" color=\"danger\" />\n\t\t\t\t<q-radio-button label=\"Custom\" value=\"custom\" color=\"#cc00cc\" />\n\t\t\t</q-radio-group>"
         },
         {
           "title": "Size",
@@ -8286,6 +8931,31 @@
             "required": false,
             "category": "Content"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nHelp needs a `title`, which labels the popover and anchors the tooltip. Without a title,\nno help is shown, whatever the display.\n\nTooltip and popover help is also exposed to assistive tech on the section, as its\ndescription. The section is a named group, labeled by its title.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QSectionProps.help} is presented. Defaults to a popover.\n\nA tooltip opens on hover, or on focus inside the title, which only happens when a\n`title.append` control takes focus. On a section it is therefore pointer-only for sighted\nusers, and `popover` or `subtext` suit keyboard users better. Screen readers get the help\nas the section's description in every display.",
+            "default": "popover",
+            "required": false,
+            "category": "Presentation"
+          },
           {
             "name": "borderless",
             "type": {
@@ -8322,6 +8992,28 @@
             "description": "If true, the section spans the full width of its container.",
             "required": false,
             "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
           }
         ],
         "events": [],
@@ -8346,6 +9038,21 @@
           "description": "A basic group box with a title and example content.",
           "code": "<q-section v-bind=\"args\">\n\t\t\t\t<span>Example of a group box</span>\n\t\t\t</q-section>"
         },
+        {
+          "title": "Popover",
+          "description": "Help shown in a popover on the title.",
+          "code": "<q-section v-bind=\"args\">\n\t\t\t\t<span>Example of a group box</span>\n\t\t\t</q-section>"
+        },
+        {
+          "title": "Tooltip",
+          "description": "Help shown in a tooltip on the title.",
+          "code": "<q-section v-bind=\"args\">\n\t\t\t\t<span>Example of a group box</span>\n\t\t\t</q-section>"
+        },
+        {
+          "title": "Subtext",
+          "description": "Help rendered under the title.",
+          "code": "<q-section v-bind=\"args\">\n\t\t\t\t<span>Example of a group box</span>\n\t\t\t</q-section>"
+        },
         {
           "title": "No Title",
           "description": "A group box without a title.",
@@ -8446,9 +9153,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -8457,6 +9164,52 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the icons of the badges and the list.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the badges' remove label and the clear button strings.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "size",
             "type": {
@@ -8632,40 +9385,18 @@
               "name": "string"
             },
             "description": "Property on each item that contains its value.",
-            "default": "key",
-            "required": false,
-            "category": "Configuration"
-          },
-          {
-            "name": "itemLabel",
-            "type": {
-              "kind": "primitive",
-              "name": "string"
-            },
-            "description": "Property on each item that contains its title.",
-            "default": "label",
-            "required": false,
-            "category": "Configuration"
-          },
-          {
-            "name": "icons",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom icon configurations.",
-            "default": "DEFAULT_ICONS",
+            "default": "key",
             "required": false,
             "category": "Configuration"
           },
           {
-            "name": "texts",
+            "name": "itemLabel",
             "type": {
-              "kind": "object",
-              "fields": {}
+              "kind": "primitive",
+              "name": "string"
             },
-            "description": "Custom text configurations.",
-            "default": "DEFAULT_TEXTS",
+            "description": "Property on each item that contains its title.",
+            "default": "label",
             "required": false,
             "category": "Configuration"
           }
@@ -8845,8 +9576,8 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
-                "left"
+                "left",
+                "right"
               ]
             },
             "description": "Position of the sidebar on the screen. Can be either 'left' or 'right'.",
@@ -9157,7 +9888,7 @@
               "kind": "object",
               "fields": {}
             },
-            "description": "Custom icons for the previous/next navigation buttons and the\n`completed`/`current` status badges.",
+            "description": "Custom icons for the previous/next navigation buttons, the\n`completed`/`current` status badges, and the overflow scroll arrows.\nPass every key, or omit the prop to keep the defaults.",
             "default": "DEFAULT_ICONS",
             "required": false,
             "category": "Configuration"
@@ -9168,7 +9899,7 @@
               "kind": "object",
               "fields": {}
             },
-            "description": "Custom accessible strings.",
+            "description": "Custom accessible strings. Includes the step buttons, the status badges, and the overflow scroll arrows.\nPass every key, or omit the prop to keep the defaults.",
             "default": "DEFAULT_TEXTS",
             "required": false,
             "category": "Configuration"
@@ -9206,6 +9937,11 @@
         ]
       },
       "examples": [
+        {
+          "title": "Subtext Help",
+          "description": "Subtext help at the top of the step content. The header caption stays.",
+          "code": "<q-steps v-model=\"step\" v-bind=\"args\">\n\t\t\t\tStep content\n\t\t\t</q-steps>"
+        },
         {
           "title": "Default",
           "description": "Default horizontal steps with the circle variant.",
@@ -9303,41 +10039,86 @@
             "category": "Identification"
           },
           {
-            "name": "label",
+            "name": "required",
             "type": {
               "kind": "primitive",
-              "name": "string"
+              "name": "boolean"
             },
-            "description": "The label of the input.",
+            "description": "If set to true, an asterisk (*) is displayed\nto indicate that the associated field is required.\n\nThe asterisk is decorative (`aria-hidden`). Required state for assistive\ntech should come from the associated control (e.g. native `required` on inputs).",
             "required": false,
-            "category": "Content"
+            "category": "State"
           },
           {
-            "name": "required",
+            "name": "label",
             "type": {
               "kind": "primitive",
-              "name": "boolean"
+              "name": "string"
             },
-            "description": "If set to true, an asterisk (*) is displayed\nto indicate that the associated field is required.\n\nThe asterisk is decorative (`aria-hidden`). Required state for assistive\ntech should come from the associated control (e.g. native `required` on inputs).",
+            "description": "The label of the input.",
             "required": false,
-            "category": "State"
+            "category": "Content"
           },
           {
             "name": "labelPosition",
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
             },
             "description": "Position of the label relative to the input field.\n- 'left': Label appears to the left of the input\n- 'center': Label appears above the input, centered\n- 'right': Label appears to the right of the input\n- 'topleft': Label appears above the input, aligned to the left\n- 'topright': Label appears above the input, aligned to the right",
+            "default": "left",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "trueLabel",
             "type": {
@@ -9559,6 +10340,28 @@
             "description": "If true, disables all nested tabs via defaults cascade.",
             "required": false,
             "category": "State"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icons for the tab strip. Includes the overflow navigation chevrons.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible strings for the tab strip. Includes the overflow back/forward labels and\nthe strings of the nested tabs, which receive them through the defaults cascade\nunless a tab sets its own `texts`.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
           }
         ],
         "events": [
@@ -9576,6 +10379,11 @@
         ]
       },
       "examples": [
+        {
+          "title": "Subtext Help",
+          "description": "Subtext help at the top of a panel. The tab button stays the label.",
+          "code": "<q-tabs v-bind=\"args\">\n\t\t\t\t<q-tab title=\"Details\" value=\"details\" help=\"Shown for this tab\">\n\t\t\t\t\tContent for the details tab.\n\t\t\t\t</q-tab>\n\t\t\t\t<q-tab title=\"History\" value=\"history\">\n\t\t\t\t\tContent for the history tab.\n\t\t\t\t</q-tab>\n\t\t\t</q-tabs>"
+        },
         {
           "title": "Default",
           "description": "Default horizontal tabs.",
@@ -9692,9 +10500,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -9703,6 +10511,50 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "size",
             "type": {
@@ -9976,9 +10828,9 @@
             "type": {
               "kind": "enum",
               "values": [
-                "right",
                 "left",
                 "center",
+                "right",
                 "topleft",
                 "topright"
               ]
@@ -9987,6 +10839,52 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the control.\nTooltip help anchors to the control. Without a label, a popover is a button beside the control.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QFieldHelpProps.help} is presented. Defaults to a popover.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.\nCustom icon configurations. Includes the help and clear button icons.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_ICONS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.\nCustom text configurations. Includes the help and clear button labels.\nPass every key, or omit the prop to keep the defaults.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "size",
             "type": {
@@ -10075,16 +10973,6 @@
             "default": "text",
             "required": false,
             "category": "Behavior"
-          },
-          {
-            "name": "texts",
-            "type": {
-              "kind": "object",
-              "fields": {}
-            },
-            "description": "Custom text configurations.",
-            "required": false,
-            "category": "Configuration"
           }
         ],
         "events": [
@@ -10128,6 +11016,26 @@
           "description": "Displays a text field.",
           "code": "<QTextField  />"
         },
+        {
+          "title": "Popover",
+          "description": "Help shown in a popover. The popover title is the field label.",
+          "code": "<QTextField help=\"Shown on the invoice\" />"
+        },
+        {
+          "title": "Tooltip",
+          "description": "Help is a tooltip on the control.",
+          "code": "<QTextField help=\"Shown on the invoice\" help-display=\"tooltip\" />"
+        },
+        {
+          "title": "Subtext",
+          "description": "Help rendered under the control.",
+          "code": "<QTextField help=\"Shown on the invoice\" help-display=\"subtext\" />"
+        },
+        {
+          "title": "Tooltip Without Label",
+          "description": "With no visible label, help is a tooltip on the control and there is no help button. `aria-label` is not a `QTextField` prop, so it stays on the template node to name the input.",
+          "code": "<QTextField label=\"\" help=\"Shown on the invoice\" help-display=\"tooltip\" />"
+        },
         {
           "title": "Placeholder",
           "description": "Provides a hint or example text inside the field.",
@@ -10225,7 +11133,7 @@
     },
     {
       "name": "QToast",
-      "description": "Toasts are commonly used to display quick feedback messages to the user, without removing focus from the main page.",
+      "description": "Toasts are commonly used to display quick feedback messages to the user, without removing focus from the main page. Show toasts with `useToast` and a `QToaster`, which announces each one to screen readers. A toast used on its own takes `role=\"alert\"` for warnings and errors and `role=\"status\"` otherwise, but many screen readers skip a `status` toast that appears together with its message.",
       "meta": {
         "props": [
           {
@@ -10274,7 +11182,7 @@
               "kind": "primitive",
               "name": "string"
             },
-            "description": "The color of the toast.\nCan be chosen from utility colors like 'success' or 'danger',\nor specified using CSS color codes.",
+            "description": "The color of the toast.\nCan be chosen from utility colors like 'success' or 'danger',\nor specified using CSS color codes.\n`info`, `success`, `warning` and `danger` also set the severity: the icon from `icons`,\nthe text screen readers announce before the message, and the default `live` value.\nOther colors show no icon unless one is passed in the `icon` slot.",
             "default": "info",
             "required": false,
             "category": "Presentation"
@@ -10321,13 +11229,27 @@
             "required": false,
             "category": "Behavior"
           },
+          {
+            "name": "live",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "assertive",
+                "polite",
+                "off"
+              ]
+            },
+            "description": "How screen readers announce the toast.\n`assertive` interrupts the user, `polite` waits until they are idle, and `off`\ndoes not announce it. Defaults to `assertive` for `warning` and `danger` and to\n`polite` for any other color.\nA toast shown by `QToaster` is announced through the toaster's live regions, which\nread the severity text, the `title` and the `text`. A toast used on its own gets\n`role=\"alert\"` or `role=\"status\"` instead, and many screen readers skip a `polite`\ntoast that appears together with its message. Show toasts with `useToast` so they\nare heard.",
+            "required": false,
+            "category": "Accessibility"
+          },
           {
             "name": "icons",
             "type": {
               "kind": "object",
               "fields": {}
             },
-            "description": "Custom icon configurations.",
+            "description": "Custom icon configurations: the severity icons and the dismiss icon.\nPass every key, or omit the prop to keep the defaults.",
             "default": "DEFAULT_ICONS",
             "required": false,
             "category": "Configuration"
@@ -10338,7 +11260,7 @@
               "kind": "object",
               "fields": {}
             },
-            "description": "Custom text configurations.",
+            "description": "Custom text configurations: the severity texts read before the message,\nand the label of the dismiss button.\nPass every key, or omit the prop to keep the defaults.",
             "default": "DEFAULT_TEXTS",
             "required": false,
             "category": "Configuration"
@@ -10362,6 +11284,10 @@
           }
         ],
         "slots": [
+          {
+            "name": "icon",
+            "description": ""
+          },
           {
             "name": "title.prepend",
             "description": ""
@@ -10403,9 +11329,14 @@
         },
         {
           "title": "Colors",
-          "description": "Any color can be applied to the toast. Supports semantic colors (success, danger, info, ...) or css colors (#033, rgba(255, 0, 0, 0.5), ...) Defaults to info.",
+          "description": "Any color can be applied to the toast. Supports semantic colors (success, danger, info, ...) or css colors (#033, rgba(255, 0, 0, 0.5), ...) Defaults to info. `info`, `success`, `warning` and `danger` show a matching icon.",
           "code": "<div style=\"display: flex; flex-direction: column; gap: 1rem;\">\n\t\t\t\t<q-toast\n\t\t\t\t\tv-for=\"(_, idx) in colors\"\n\t\t\t\t\t:key=\"colors[idx]\"\n\t\t\t\t\t:color=\"colors[idx]\"\n\t\t\t\t\t:text=\"texts[idx]\" />\n\t\t\t</div>"
         },
+        {
+          "title": "Custom Icon",
+          "description": "The `icon` slot replaces the icon of a severity color, or adds one to a toast in another color. The icon is decorative and hidden from screen readers, so anything it conveys must also be in the message. Toasts from `useToast` take no slots, so they show only the severity icons from `icons`.",
+          "code": "<q-toast v-bind=\"args\">\n\t\t\t\t<template #icon>\n\t\t\t\t\t<q-icon icon=\"information-outline\" />\n\t\t\t\t</template>\n\t\t\t</q-toast>"
+        },
         {
           "title": "Bold",
           "description": "Displays the toast with a bold background color.",
@@ -10423,8 +11354,8 @@
         },
         {
           "title": "Header Slots",
-          "description": "The toast header is also customizable through the `title.append` and `title.prepend` slots.",
-          "code": "<q-toast\n\t\t\t\t:color=\"toastColor\"\n\t\t\t\tv-bind=\"args\">\n\t\t\t\t<template #[\\"
+          "description": "The toast header is also customizable through the `title.append` and `title.prepend` slots. For an icon, use the `icon` slot instead.",
+          "code": "<q-toast v-bind=\"args\">\n\t\t\t\t<template #[\\"
         }
       ]
     },
@@ -10462,16 +11393,60 @@
             "required": false,
             "category": "Content"
           },
+          {
+            "name": "help",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Help text. Plain text only. One display at a time.\n\nTooltip and popover help is also exposed to assistive tech on the button.\nThe popover title is the button label.\n\nWith help, the root element is a `display: contents` wrapper around the button\n(and the help), not the button itself, so:\n- Anchor popovers, tooltips, and measurements to the inner `button`, not to the\n  component's `$el`, which has no box.\n- Do not toggle `help` on a focused button: the button is remounted and loses focus.\n- Direct-child selectors such as those of `QButtonGroup` no longer match the button,\n  so `QToggleGroupItem` does not accept help.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "helpDisplay",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "popover",
+                "tooltip",
+                "subtext"
+              ]
+            },
+            "description": "How {@link QButtonProps.help} is presented. Defaults to a popover.\n\n`subtext` renders the help under the button only in block flow. In a flex row\n(such as a dialog footer) or in an inline run it becomes a sibling beside the\nbutton, or breaks the line, so prefer `popover` or `tooltip` there.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "icons",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Icon overrides. Includes the help popover icon, `help`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Accessible text overrides. Includes the help button label, `showHelp`.\nPass every key, or omit the prop to keep the defaults.",
+            "required": false,
+            "category": "Configuration"
+          },
           {
             "name": "variant",
             "type": {
               "kind": "enum",
               "values": [
                 "tonal",
+                "text",
                 "bold",
                 "outlined",
-                "ghost",
-                "text"
+                "ghost"
               ]
             },
             "description": "Specifies the visual style of the button.",
@@ -10488,6 +11463,16 @@
             "required": false,
             "category": "Presentation"
           },
+          {
+            "name": "surface",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The color the button sits on, when it is not the theme background: a utility color\nlike 'primary', or a CSS color code. The label color of the `tonal`, `outlined`,\n`ghost` and `text` variants, and the hover color, are measured against it, so the\nbutton stays readable on a colored banner. Defaults to the theme background.",
+            "required": false,
+            "category": "Presentation"
+          },
           {
             "name": "borderless",
             "type": {
@@ -10620,6 +11605,11 @@
           "title": "Default",
           "description": "",
           "code": "<q-toggle v-bind=\"args\" aria-label=\"Underline\">\n\t\t  <q-icon icon=\"format-underline\" />\n\t\t</q-toggle>"
+        },
+        {
+          "title": "Colors",
+          "description": "A pressed toggle uses its own `color`: a tonal fill and a label that clears 4.5:1 on it.",
+          "code": "<div style=\"display: flex; gap: 0.5rem;\">\n\t\t  <q-toggle\n\t\t    v-for=\"color in colors\"\n\t\t    :key=\"color\"\n\t\t    :model-value=\"true\"\n\t\t    :color=\"color\"\n\t\t    :aria-label=\"'Underline in ' + color\">\n\t\t    <q-icon icon=\"format-underline\" />\n\t\t  </q-toggle>\n\t\t</div>"
         }
       ]
     },
@@ -10890,16 +11880,16 @@
               "values": [
                 "top",
                 "bottom",
-                "right",
                 "left",
+                "right",
                 "top-start",
                 "top-end",
                 "bottom-start",
                 "bottom-end",
-                "right-start",
-                "right-end",
                 "left-start",
-                "left-end"
+                "left-end",
+                "right-start",
+                "right-end"
               ]
             },
             "description": "The placement of the tooltip.",