@quidgest/ui 0.19.0 → 0.20.1

package/dist/json/api.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.19.0",
+  "version": "0.20.1",
   "components": [
     {
       "name": "QAccordion",
@@ -123,7 +123,7 @@
       "examples": [
         {
           "title": "Default",
-          "description": "Default behaviour of the accordion.",
+          "description": "Default behavior of the accordion.",
           "code": "<q-accordion v-bind=\"args\">\n\t\t  <q-accordion-item title=\"Section 1\" value=\"1\">\n\t\t\tContent for section 1\n\t\t  </q-accordion-item>\n\t\t  <q-accordion-item title=\"Section 2\" value=\"2\">\n\t\t\tContent for section 2\n\t\t  </q-accordion-item>\n\t\t  <q-accordion-item title=\"Section 3\" value=\"3\">\n\t\t\tContent for section 3\n\t\t  </q-accordion-item>\n\t\t</q-accordion>"
         },
         {
@@ -1008,32 +1008,32 @@
       "examples": [
         {
           "title": "Default",
-          "description": "Default behaviour of the card.",
+          "description": "Default behavior of the card.",
           "code": "<q-card v-bind=\"args\">\n\t\t\t\t<q-text-field label=\"Text input\"/>\n\t\t\t</q-card>"
         },
         {
           "title": "Clickable",
-          "description": "Default behaviour of a clickable card.",
+          "description": "Default behavior of a clickable card.",
           "code": "<q-card v-bind=\"args\" @click=\"onClick\">\n\t\t\t\t\t{{ args.subtitle }}\n\t\t\t\t</q-card>"
         },
         {
           "title": "Link",
-          "description": "Default behaviour of a card with a link/url.",
+          "description": "Default behavior of a card with a link/url.",
           "code": "<q-card v-bind=\"args\">\n\t\t\t\t{{ args.subtitle }}\n\t\t\t</q-card>"
         },
         {
           "title": "Loading",
-          "description": "Default behaviour of a loading card.",
+          "description": "Default behavior of a loading card.",
           "code": "<q-card v-bind=\"args\">\n\t\t\t\t<q-text-field label=\"Text input\"/>\n\t\t\t</q-card>"
         },
         {
           "title": "Borderless",
-          "description": "Default behaviour of a borderless card.",
+          "description": "Default behavior of a borderless card.",
           "code": "<q-card v-bind=\"args\">\n\t\t\t\t<q-text-field label=\"Text input\"/>\n\t\t\t</q-card>"
         },
         {
           "title": "Elevation",
-          "description": "Default behaviour of a card with elevation.",
+          "description": "Default behavior of a card with elevation.",
           "code": "<div style=\"display: flex; gap: 1rem;\">\n\t\t\t\t<q-card v-bind=\"args\" title=\"Elevated Low\" elevation=\"low\">\n\t\t\t\t\tSome quick example text to build on the card title.\n\t\t\t\t</q-card>\n\t\t\t\t<q-card v-bind=\"args\" title=\"Elevated Medium\" elevation=\"medium\">\n\t\t\t\t\tSome quick example text to build on the card title.\n\t\t\t\t</q-card>\n\t\t\t\t<q-card v-bind=\"args\" title=\"Elevated High\" elevation=\"high\">\n\t\t\t\t\tSome quick example text to build on the card title.\n\t\t\t\t</q-card>\n\t\t\t</div>"
         },
         {
@@ -1689,22 +1689,22 @@
       "examples": [
         {
           "title": "Default",
-          "description": "Default behaviour of the collapsible.",
+          "description": "Default behavior of the collapsible.",
           "code": "<q-collapsible v-bind=\"args\">\n\t\t\t\t<q-text-field label=\"Text input\"/>\n\t\t\t</q-collapsible>"
         },
         {
           "title": "Starts Expanded",
-          "description": "Behaviour of a collapsible that starts expanded.",
+          "description": "Behavior of a collapsible that starts expanded.",
           "code": "<q-collapsible v-bind=\"args\">\n\t\t\t\t<q-text-field label=\"Text input\"/>\n\t\t\t</q-collapsible>"
         },
         {
           "title": "Subtitle",
-          "description": "Behaviour of the collapsible with a title.",
+          "description": "Behavior of the collapsible with a title.",
           "code": "<q-collapsible v-bind=\"args\">\n\t\t\t\t<q-text-field label=\"Text input\"/>\n\t\t\t</q-collapsible>"
         },
         {
           "title": "Required",
-          "description": "Behaviour of the collapsible when there are required fields inside.",
+          "description": "Behavior of the collapsible when there are required fields inside.",
           "code": "<q-collapsible v-bind=\"args\">\n\t\t\t\t<q-text-field label=\"Text input\" required/>\n\t\t\t</q-collapsible>"
         },
         {
@@ -2919,7 +2919,7 @@
       "examples": [
         {
           "title": "Default",
-          "description": "Default behaviour of the dialog.",
+          "description": "Default behavior of the dialog.",
           "code": "<q-button label=\"Click me\" @click=\"args.modelValue = true\" />\n\t\t\t<q-dialog v-model=\"args.modelValue\" v-bind=\"args\" />"
         },
         {
@@ -2939,7 +2939,7 @@
         },
         {
           "title": "Custom Buttons",
-          "description": "Custom buttons on the dialog allow the user to customize its look and behaviour.",
+          "description": "Custom buttons on the dialog allow the user to customize its look and behavior.",
           "code": "<QDialog :text=\"What shall we do?\" :icon=\"{\n\t\t\ticon: 'help-circle-outline'\n\t\t}\" :buttons=\"[\n\t\t\t{\n\t\t\t\tid: 'scroll-btn',\n\t\t\t\ticon: {\n\t\t\t\t\ticon: 'arrow-up'\n\t\t\t\t},\n\t\t\t\taction: () => {\n\t\t\t\t\twindow.scrollTo({ top: 0, behavior: 'smooth' })\n\t\t\t\t},\n\t\t\t\tprops: {\n\t\t\t\t\tlabel: 'Scroll to Top',\n\t\t\t\t\tvariant: 'bold'\n\t\t\t\t}\n\t\t\t},\n\t\t\t{\n\t\t\t\tid: 'refresh-btn',\n\t\t\t\ticon: {\n\t\t\t\t\ticon: 'refresh'\n\t\t\t\t},\n\t\t\t\taction: () => {\n\t\t\t\t\tlocation.reload()\n\t\t\t\t},\n\t\t\t\tprops: {\n\t\t\t\t\tlabel: 'Refresh the page!',\n\t\t\t\t\tvariant: 'bold',\n\t\t\t\t\tcolor: 'danger'\n\t\t\t\t}\n\t\t\t},\n\t\t\t{\n\t\t\t\tid: 'cancel-btn',\n\t\t\t\ticon: {\n\t\t\t\t\ticon: 'cancel'\n\t\t\t\t},\n\t\t\t\tprops: {\n\t\t\t\t\tlabel: 'Cancel'\n\t\t\t\t}\n\t\t\t}\n\t\t]\" />"
         },
         {
@@ -3857,6 +3857,269 @@
         }
       ]
     },
+    {
+      "name": "QGauge",
+      "description": "A gauge displays a KPI within a bounded scale and can highlight semantic performance ranges.",
+      "meta": {
+        "props": [
+          {
+            "name": "modelValue",
+            "type": {
+              "kind": "primitive",
+              "name": "number"
+            },
+            "description": "",
+            "required": false
+          },
+          {
+            "name": "id",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The component unique identifier.",
+            "required": false,
+            "category": "Identification"
+          },
+          {
+            "name": "min",
+            "type": {
+              "kind": "primitive",
+              "name": "number"
+            },
+            "description": "Lowest value represented by the scale.",
+            "default": "0",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "max",
+            "type": {
+              "kind": "primitive",
+              "name": "number"
+            },
+            "description": "Highest value represented by the scale.",
+            "default": "100",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "ranges",
+            "type": {
+              "kind": "array",
+              "elementType": {
+                "name": "object",
+                "value": {}
+              }
+            },
+            "description": "Colored intervals displayed over the neutral gauge track.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "ticks",
+            "type": {
+              "kind": "array",
+              "elementType": {
+                "name": "number"
+              }
+            },
+            "description": "Explicit values to label on the scale. Overrides tickCount.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "tickCount",
+            "type": {
+              "kind": "primitive",
+              "name": "number"
+            },
+            "description": "Number of evenly spaced scale labels generated when ticks is omitted.",
+            "default": "5",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "label",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "KPI title displayed above the gauge.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "valueLabel",
+            "type": {
+              "kind": "union",
+              "types": [
+                {
+                  "name": "string"
+                },
+                {
+                  "name": "other",
+                  "value": "(value: number, min: number, max: number): string"
+                }
+              ]
+            },
+            "description": "Text or formatter used as the fallback display and as the current-value part\nof `aria-valuetext`. Set this when the `value` slot changes how the value\nshould be announced, because slot markup cannot be inferred reliably for\naccessibility. When provided, it is treated as complete current-value text,\nso the unit is not appended there automatically.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "target",
+            "type": {
+              "kind": "primitive",
+              "name": "number"
+            },
+            "description": "Target value highlighted on the gauge track.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "targetComparison",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "at-least",
+                "at-most"
+              ]
+            },
+            "description": "Target comparison mode. Use `at-least` when values should reach or exceed\nthe target, and `at-most` when values should stay at or below it.",
+            "default": "at-least",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "targetLabel",
+            "type": {
+              "kind": "union",
+              "types": [
+                {
+                  "name": "string"
+                },
+                {
+                  "name": "other",
+                  "value": "(target: number, min: number, max: number): string"
+                }
+              ]
+            },
+            "description": "Text or formatter used to describe the target value.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "showTargetValue",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "Whether the target value label is displayed next to the target marker.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "showLegend",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "Whether the legend is displayed below the gauge.",
+            "default": "true",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "showTargetLegend",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "Whether target status items are included in the legend when a target marker\nis visible. The legend itself must also be enabled with `showLegend`.",
+            "default": "true",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "unit",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Unit displayed next to the current value.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "secondaryLabel",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Supporting information displayed below the current value.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "texts",
+            "type": {
+              "kind": "object",
+              "fields": {}
+            },
+            "description": "Custom text configurations.",
+            "default": "DEFAULT_TEXTS",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "tickFormatter",
+            "type": {
+              "kind": "unknown",
+              "raw": "((value: number) => string) | undefined"
+            },
+            "description": "Formatter used for scale labels.",
+            "required": false,
+            "category": "Configuration"
+          }
+        ],
+        "events": [
+          {
+            "name": "update:modelValue",
+            "description": "",
+            "type": "[value: number]"
+          }
+        ],
+        "slots": [
+          {
+            "name": "value",
+            "description": "Custom markup for the visible current value. Also set `valueLabel` when the\nslot changes how the value should be announced, because slot content does\nnot replace `aria-valuetext`."
+          }
+        ]
+      },
+      "examples": [
+        {
+          "title": "Default",
+          "description": "The default gauge uses semantic ranges and supporting KPI information.",
+          "code": "<QGauge :model-value=\"76\" :label=\"Delivery performance\" :target=\"80\" :target-label=\"Target 80%\" :show-target-value=\"true\" :unit=\"%\" :secondary-label=\"+4.2% from last month\" />"
+        },
+        {
+          "title": "Lower Is Better",
+          "description": "Range order and colors can represent metrics where lower values are better.",
+          "code": "<QGauge :model-value=\"18\" :label=\"Average response time\" :max=\"60\" :target=\"20\" :target-comparison=\"at-most\" :target-label=\"Target 20 min\" :show-target-value=\"true\" :unit=\"min\" :secondary-label=\"-3 min from last month\" :ranges=\"[\n\t\t\t{ from: 0, to: 20, color: 'success', label: 'On target' },\n\t\t\t{ from: 20, to: 40, color: 'warning', label: 'Attention' },\n\t\t\t{ from: 40, to: 60, color: 'danger', label: 'Critical' }\n\t\t]\" />"
+        },
+        {
+          "title": "Explicit Ticks",
+          "description": "Explicit ticks and formatters support domain-specific values.",
+          "code": "<QGauge :model-value=\"10.6\" :label=\"Revenue\" :max=\"21\" :target=\"15\" :target-label=\"Target 15M\" :show-target-value=\"true\" :unit=\"Dollars\" :ticks=\"0,3,6,9,12,15,18,21\" :value-label=\"(value: number) => `${value.toFixed(1)}M`\" :tick-formatter=\"(value: number) => (value === 0 ? '0' : `${value}M`)\" :ranges=\"[\n\t\t\t{ from: 0, to: 6, color: 'danger', label: 'Below target' },\n\t\t\t{ from: 6, to: 15, color: 'warning', label: 'Approaching target' },\n\t\t\t{ from: 15, to: 21, color: 'success', label: 'On target' }\n\t\t]\" />"
+        },
+        {
+          "title": "Responsive Composition",
+          "description": "Gauges remain responsive when composed into a KPI dashboard owned by the consumer.",
+          "code": "<div class=\"q-gauge-story-grid\">\n\t\t\t\t<q-gauge\n\t\t\t\t\tv-for=\"item in items\"\n\t\t\t\t\t:key=\"item.label\"\n\t\t\t\t\t:model-value=\"item.value\"\n\t\t\t\t\t:label=\"item.label\"\n\t\t\t\t\t:target=\"item.target\"\n\t\t\t\t\t:unit=\"item.unit\"\n\t\t\t\t\t:ranges=\"performanceRanges\"\n\t\t\t\t\t:show-legend=\"false\"\n\t\t\t\t/>\n\t\t\t</div>"
+        }
+      ]
+    },
     {
       "name": "QIcon",
       "description": "Displays an icon. Note: This Storybook includes a Material Design Icons v7.3.67 SVG bundle for demonstration purposes. For the complete list of available icons, visit the official [Material Design Icons](https://pictogrammers.com/library/mdi/) page.",
@@ -5633,69 +5896,1124 @@
       ]
     },
     {
-      "name": "QPopover",
-      "description": "A floating container that displays contextual content, triggered by a button.",
+      "name": "QPhoneField",
+      "description": "Collects and formats international telephone numbers while keeping the country calling code and national number visually distinct. Strict validation uses the `libphonenumber-js/max` metadata, while flags use the complete 3:2 stylesheet from `country-flag-icons`. Restricting `countries` filters runtime options but does not reduce either dependency's bundle contribution.",
       "meta": {
         "props": [
           {
             "name": "modelValue",
             "type": {
               "kind": "primitive",
-              "name": "boolean"
+              "name": "string"
             },
             "description": "",
             "required": false
           },
           {
-            "name": "id",
+            "name": "country",
             "type": {
-              "kind": "primitive",
-              "name": "string"
+              "kind": "enum",
+              "values": [
+                "AM",
+                "PM",
+                "AC",
+                "AD",
+                "AE",
+                "AF",
+                "AG",
+                "AI",
+                "AL",
+                "AO",
+                "AR",
+                "AS",
+                "AT",
+                "AU",
+                "AW",
+                "AX",
+                "AZ",
+                "BA",
+                "BB",
+                "BD",
+                "BE",
+                "BF",
+                "BG",
+                "BH",
+                "BI",
+                "BJ",
+                "BL",
+                "BM",
+                "BN",
+                "BO",
+                "BQ",
+                "BR",
+                "BS",
+                "BT",
+                "BW",
+                "BY",
+                "BZ",
+                "CA",
+                "CC",
+                "CD",
+                "CF",
+                "CG",
+                "CH",
+                "CI",
+                "CK",
+                "CL",
+                "CM",
+                "CN",
+                "CO",
+                "CR",
+                "CU",
+                "CV",
+                "CW",
+                "CX",
+                "CY",
+                "CZ",
+                "DE",
+                "DJ",
+                "DK",
+                "DM",
+                "DO",
+                "DZ",
+                "EC",
+                "EE",
+                "EG",
+                "EH",
+                "ER",
+                "ES",
+                "ET",
+                "FI",
+                "FJ",
+                "FK",
+                "FM",
+                "FO",
+                "FR",
+                "GA",
+                "GB",
+                "GD",
+                "GE",
+                "GF",
+                "GG",
+                "GH",
+                "GI",
+                "GL",
+                "GM",
+                "GN",
+                "GP",
+                "GQ",
+                "GR",
+                "GT",
+                "GU",
+                "GW",
+                "GY",
+                "HK",
+                "HN",
+                "HR",
+                "HT",
+                "HU",
+                "ID",
+                "IE",
+                "IL",
+                "IM",
+                "IN",
+                "IO",
+                "IQ",
+                "IR",
+                "IS",
+                "IT",
+                "JE",
+                "JM",
+                "JO",
+                "JP",
+                "KE",
+                "KG",
+                "KH",
+                "KI",
+                "KM",
+                "KN",
+                "KP",
+                "KR",
+                "KW",
+                "KY",
+                "KZ",
+                "LA",
+                "LB",
+                "LC",
+                "LI",
+                "LK",
+                "LR",
+                "LS",
+                "LT",
+                "LU",
+                "LV",
+                "LY",
+                "MA",
+                "MC",
+                "MD",
+                "ME",
+                "MF",
+                "MG",
+                "MH",
+                "MK",
+                "ML",
+                "MM",
+                "MN",
+                "MO",
+                "MP",
+                "MQ",
+                "MR",
+                "MS",
+                "MT",
+                "MU",
+                "MV",
+                "MW",
+                "MX",
+                "MY",
+                "MZ",
+                "NA",
+                "NC",
+                "NE",
+                "NF",
+                "NG",
+                "NI",
+                "NL",
+                "NO",
+                "NP",
+                "NR",
+                "NU",
+                "NZ",
+                "OM",
+                "PA",
+                "PE",
+                "PF",
+                "PG",
+                "PH",
+                "PK",
+                "PL",
+                "PR",
+                "PS",
+                "PT",
+                "PW",
+                "PY",
+                "QA",
+                "RE",
+                "RO",
+                "RS",
+                "RU",
+                "RW",
+                "SA",
+                "SB",
+                "SC",
+                "SD",
+                "SE",
+                "SG",
+                "SH",
+                "SI",
+                "SJ",
+                "SK",
+                "SL",
+                "SM",
+                "SN",
+                "SO",
+                "SR",
+                "SS",
+                "ST",
+                "SV",
+                "SX",
+                "SY",
+                "SZ",
+                "TA",
+                "TC",
+                "TD",
+                "TG",
+                "TH",
+                "TJ",
+                "TK",
+                "TL",
+                "TM",
+                "TN",
+                "TO",
+                "TR",
+                "TT",
+                "TV",
+                "TW",
+                "TZ",
+                "UA",
+                "UG",
+                "US",
+                "UY",
+                "UZ",
+                "VA",
+                "VC",
+                "VE",
+                "VG",
+                "VI",
+                "VN",
+                "VU",
+                "WF",
+                "WS",
+                "XK",
+                "YE",
+                "YT",
+                "ZA",
+                "ZM",
+                "ZW"
+              ]
             },
-            "description": "The component unique identifier.",
-            "required": false,
-            "category": "Identification"
+            "description": "",
+            "required": false
           },
           {
-            "name": "anchor",
+            "name": "open",
             "type": {
-              "kind": "union",
-              "types": [
-                {
-                  "name": "string"
-                },
-                {
-                  "name": "object",
-                  "value": {}
-                }
-              ]
+              "kind": "primitive",
+              "name": "boolean"
             },
-            "description": "The DOM element the popover should be anchored to.",
-            "required": true,
-            "category": "Identification"
+            "description": "",
+            "required": false
           },
           {
-            "name": "text",
+            "name": "id",
             "type": {
               "kind": "primitive",
               "name": "string"
             },
-            "description": "The text of the popover.",
+            "description": "The component unique identifier.",
             "required": false,
-            "category": "Content"
+            "category": "Identification"
           },
           {
-            "name": "title",
+            "name": "label",
             "type": {
               "kind": "primitive",
               "name": "string"
             },
-            "description": "The title of the popover.",
+            "description": "The label of the input.",
             "required": false,
             "category": "Content"
           },
           {
-            "name": "headingLevel",
+            "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": "for",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The form field associated with the label.",
+            "required": false,
+            "category": "Accessibility"
+          },
+          {
+            "name": "labelPosition",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "right",
+                "left",
+                "center",
+                "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",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "size",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "medium",
+                "small",
+                "large",
+                "block",
+                "xlarge",
+                "xxlarge",
+                "mini"
+              ]
+            },
+            "description": "The size category of the field.",
+            "required": false,
+            "category": "Presentation"
+          },
+          {
+            "name": "readonly",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "Whether the input is readonly.",
+            "required": false,
+            "category": "State"
+          },
+          {
+            "name": "disabled",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "Whether the input is disabled.",
+            "required": false,
+            "category": "State"
+          },
+          {
+            "name": "invalid",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "Whether the input is invalid.",
+            "required": false,
+            "category": "State"
+          },
+          {
+            "name": "placeholder",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "Overrides the placeholder for the national number input. When omitted, the component\ndisplays zeros using the telephone format of the selected country.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "defaultCountry",
+            "type": {
+              "kind": "enum",
+              "values": [
+                "AM",
+                "PM",
+                "AC",
+                "AD",
+                "AE",
+                "AF",
+                "AG",
+                "AI",
+                "AL",
+                "AO",
+                "AR",
+                "AS",
+                "AT",
+                "AU",
+                "AW",
+                "AX",
+                "AZ",
+                "BA",
+                "BB",
+                "BD",
+                "BE",
+                "BF",
+                "BG",
+                "BH",
+                "BI",
+                "BJ",
+                "BL",
+                "BM",
+                "BN",
+                "BO",
+                "BQ",
+                "BR",
+                "BS",
+                "BT",
+                "BW",
+                "BY",
+                "BZ",
+                "CA",
+                "CC",
+                "CD",
+                "CF",
+                "CG",
+                "CH",
+                "CI",
+                "CK",
+                "CL",
+                "CM",
+                "CN",
+                "CO",
+                "CR",
+                "CU",
+                "CV",
+                "CW",
+                "CX",
+                "CY",
+                "CZ",
+                "DE",
+                "DJ",
+                "DK",
+                "DM",
+                "DO",
+                "DZ",
+                "EC",
+                "EE",
+                "EG",
+                "EH",
+                "ER",
+                "ES",
+                "ET",
+                "FI",
+                "FJ",
+                "FK",
+                "FM",
+                "FO",
+                "FR",
+                "GA",
+                "GB",
+                "GD",
+                "GE",
+                "GF",
+                "GG",
+                "GH",
+                "GI",
+                "GL",
+                "GM",
+                "GN",
+                "GP",
+                "GQ",
+                "GR",
+                "GT",
+                "GU",
+                "GW",
+                "GY",
+                "HK",
+                "HN",
+                "HR",
+                "HT",
+                "HU",
+                "ID",
+                "IE",
+                "IL",
+                "IM",
+                "IN",
+                "IO",
+                "IQ",
+                "IR",
+                "IS",
+                "IT",
+                "JE",
+                "JM",
+                "JO",
+                "JP",
+                "KE",
+                "KG",
+                "KH",
+                "KI",
+                "KM",
+                "KN",
+                "KP",
+                "KR",
+                "KW",
+                "KY",
+                "KZ",
+                "LA",
+                "LB",
+                "LC",
+                "LI",
+                "LK",
+                "LR",
+                "LS",
+                "LT",
+                "LU",
+                "LV",
+                "LY",
+                "MA",
+                "MC",
+                "MD",
+                "ME",
+                "MF",
+                "MG",
+                "MH",
+                "MK",
+                "ML",
+                "MM",
+                "MN",
+                "MO",
+                "MP",
+                "MQ",
+                "MR",
+                "MS",
+                "MT",
+                "MU",
+                "MV",
+                "MW",
+                "MX",
+                "MY",
+                "MZ",
+                "NA",
+                "NC",
+                "NE",
+                "NF",
+                "NG",
+                "NI",
+                "NL",
+                "NO",
+                "NP",
+                "NR",
+                "NU",
+                "NZ",
+                "OM",
+                "PA",
+                "PE",
+                "PF",
+                "PG",
+                "PH",
+                "PK",
+                "PL",
+                "PR",
+                "PS",
+                "PT",
+                "PW",
+                "PY",
+                "QA",
+                "RE",
+                "RO",
+                "RS",
+                "RU",
+                "RW",
+                "SA",
+                "SB",
+                "SC",
+                "SD",
+                "SE",
+                "SG",
+                "SH",
+                "SI",
+                "SJ",
+                "SK",
+                "SL",
+                "SM",
+                "SN",
+                "SO",
+                "SR",
+                "SS",
+                "ST",
+                "SV",
+                "SX",
+                "SY",
+                "SZ",
+                "TA",
+                "TC",
+                "TD",
+                "TG",
+                "TH",
+                "TJ",
+                "TK",
+                "TL",
+                "TM",
+                "TN",
+                "TO",
+                "TR",
+                "TT",
+                "TV",
+                "TW",
+                "TZ",
+                "UA",
+                "UG",
+                "US",
+                "UY",
+                "UZ",
+                "VA",
+                "VC",
+                "VE",
+                "VG",
+                "VI",
+                "VN",
+                "VU",
+                "WF",
+                "WS",
+                "XK",
+                "YE",
+                "YT",
+                "ZA",
+                "ZM",
+                "ZW"
+              ]
+            },
+            "description": "The fallback country used when no country can be derived from `modelValue` and no\ncontrolled `country` is provided. Its precedence is after `country` and before\n`locale` and the first available country.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "countries",
+            "type": {
+              "kind": "array",
+              "elementType": {
+                "name": "enum",
+                "value": [
+                  "AM",
+                  "PM",
+                  "AC",
+                  "AD",
+                  "AE",
+                  "AF",
+                  "AG",
+                  "AI",
+                  "AL",
+                  "AO",
+                  "AR",
+                  "AS",
+                  "AT",
+                  "AU",
+                  "AW",
+                  "AX",
+                  "AZ",
+                  "BA",
+                  "BB",
+                  "BD",
+                  "BE",
+                  "BF",
+                  "BG",
+                  "BH",
+                  "BI",
+                  "BJ",
+                  "BL",
+                  "BM",
+                  "BN",
+                  "BO",
+                  "BQ",
+                  "BR",
+                  "BS",
+                  "BT",
+                  "BW",
+                  "BY",
+                  "BZ",
+                  "CA",
+                  "CC",
+                  "CD",
+                  "CF",
+                  "CG",
+                  "CH",
+                  "CI",
+                  "CK",
+                  "CL",
+                  "CM",
+                  "CN",
+                  "CO",
+                  "CR",
+                  "CU",
+                  "CV",
+                  "CW",
+                  "CX",
+                  "CY",
+                  "CZ",
+                  "DE",
+                  "DJ",
+                  "DK",
+                  "DM",
+                  "DO",
+                  "DZ",
+                  "EC",
+                  "EE",
+                  "EG",
+                  "EH",
+                  "ER",
+                  "ES",
+                  "ET",
+                  "FI",
+                  "FJ",
+                  "FK",
+                  "FM",
+                  "FO",
+                  "FR",
+                  "GA",
+                  "GB",
+                  "GD",
+                  "GE",
+                  "GF",
+                  "GG",
+                  "GH",
+                  "GI",
+                  "GL",
+                  "GM",
+                  "GN",
+                  "GP",
+                  "GQ",
+                  "GR",
+                  "GT",
+                  "GU",
+                  "GW",
+                  "GY",
+                  "HK",
+                  "HN",
+                  "HR",
+                  "HT",
+                  "HU",
+                  "ID",
+                  "IE",
+                  "IL",
+                  "IM",
+                  "IN",
+                  "IO",
+                  "IQ",
+                  "IR",
+                  "IS",
+                  "IT",
+                  "JE",
+                  "JM",
+                  "JO",
+                  "JP",
+                  "KE",
+                  "KG",
+                  "KH",
+                  "KI",
+                  "KM",
+                  "KN",
+                  "KP",
+                  "KR",
+                  "KW",
+                  "KY",
+                  "KZ",
+                  "LA",
+                  "LB",
+                  "LC",
+                  "LI",
+                  "LK",
+                  "LR",
+                  "LS",
+                  "LT",
+                  "LU",
+                  "LV",
+                  "LY",
+                  "MA",
+                  "MC",
+                  "MD",
+                  "ME",
+                  "MF",
+                  "MG",
+                  "MH",
+                  "MK",
+                  "ML",
+                  "MM",
+                  "MN",
+                  "MO",
+                  "MP",
+                  "MQ",
+                  "MR",
+                  "MS",
+                  "MT",
+                  "MU",
+                  "MV",
+                  "MW",
+                  "MX",
+                  "MY",
+                  "MZ",
+                  "NA",
+                  "NC",
+                  "NE",
+                  "NF",
+                  "NG",
+                  "NI",
+                  "NL",
+                  "NO",
+                  "NP",
+                  "NR",
+                  "NU",
+                  "NZ",
+                  "OM",
+                  "PA",
+                  "PE",
+                  "PF",
+                  "PG",
+                  "PH",
+                  "PK",
+                  "PL",
+                  "PR",
+                  "PS",
+                  "PT",
+                  "PW",
+                  "PY",
+                  "QA",
+                  "RE",
+                  "RO",
+                  "RS",
+                  "RU",
+                  "RW",
+                  "SA",
+                  "SB",
+                  "SC",
+                  "SD",
+                  "SE",
+                  "SG",
+                  "SH",
+                  "SI",
+                  "SJ",
+                  "SK",
+                  "SL",
+                  "SM",
+                  "SN",
+                  "SO",
+                  "SR",
+                  "SS",
+                  "ST",
+                  "SV",
+                  "SX",
+                  "SY",
+                  "SZ",
+                  "TA",
+                  "TC",
+                  "TD",
+                  "TG",
+                  "TH",
+                  "TJ",
+                  "TK",
+                  "TL",
+                  "TM",
+                  "TN",
+                  "TO",
+                  "TR",
+                  "TT",
+                  "TV",
+                  "TW",
+                  "TZ",
+                  "UA",
+                  "UG",
+                  "US",
+                  "UY",
+                  "UZ",
+                  "VA",
+                  "VC",
+                  "VE",
+                  "VG",
+                  "VI",
+                  "VN",
+                  "VU",
+                  "WF",
+                  "WS",
+                  "XK",
+                  "YE",
+                  "YT",
+                  "ZA",
+                  "ZM",
+                  "ZW"
+                ]
+              }
+            },
+            "description": "The countries available for selection, in display order.\nAll supported countries are shown when this property is omitted.\nValid non-geographic numbers (for example, `+800`) are accepted only when this\nproperty is omitted because they do not map to a selectable country.\nThis filters the options at runtime; it does not reduce the bundled flag stylesheet.",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "locale",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The locale used to display, sort, and search country names. Its region is also used\nas a fallback country after `country` and `defaultCountry`. When omitted, `en-US`\nis used for deterministic server rendering.",
+            "default": "en-US",
+            "required": false,
+            "category": "Configuration"
+          },
+          {
+            "name": "clearable",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "Whether the value of the field can be cleared.",
+            "required": false,
+            "category": "Behavior"
+          },
+          {
+            "name": "autoValidate",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "Whether the component automatically displays validation feedback after blur.\nDisable this property when validation is managed externally through `invalid`.",
+            "default": "true",
+            "required": false,
+            "category": "Behavior"
+          },
+          {
+            "name": "inline",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "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": [
+          {
+            "name": "update:modelValue",
+            "description": "",
+            "type": "[value: string]"
+          },
+          {
+            "name": "update:open",
+            "description": "",
+            "type": "[value: boolean]"
+          },
+          {
+            "name": "click:clear",
+            "description": "",
+            "type": "[event: Event]"
+          },
+          {
+            "name": "update:country",
+            "description": "",
+            "type": "[value: CountryCode | undefined]"
+          },
+          {
+            "name": "validity-change",
+            "description": "",
+            "type": "[validity: QPhoneFieldValidity]"
+          }
+        ],
+        "slots": [
+          {
+            "name": "label.prepend",
+            "description": "Content before the field label."
+          },
+          {
+            "name": "label.append",
+            "description": "Content after the field label."
+          },
+          {
+            "name": "append",
+            "description": "Content after the telephone input and before the clear button."
+          },
+          {
+            "name": "extras",
+            "description": "Supporting or validation content associated with the input through `aria-describedby`.\nApply `validationId` to a more specific descendant only when an additional association\nis needed; the component always provides a wrapper with this ID."
+          }
+        ]
+      },
+      "examples": [
+        {
+          "title": "Default",
+          "description": "Uses the default `en-US` locale and emits a complete international value.",
+          "code": "<QPhoneField :label=\"Phone number\" :clearable=\"true\" :size=\"large\" />"
+        },
+        {
+          "title": "International Value",
+          "description": "Derives the country, flag, calling code, and national presentation from an E.164 value.",
+          "code": "<QPhoneField :model-value=\"+442079460018\" />"
+        },
+        {
+          "title": "Restricted Countries",
+          "description": "Restricts and orders the countries shown in the searchable selector. This is a runtime filter; the component still includes the complete flag stylesheet.",
+          "code": "<QPhoneField :countries=\"['PT', 'ES', 'FR', 'GB']\" :model-value=\"+351912345678\" />"
+        },
+        {
+          "title": "Paste Detection",
+          "description": "Paste a number beginning with `+` or `00` to update the country automatically.",
+          "code": "<QPhoneField :label=\"Paste an international number\" />"
+        },
+        {
+          "title": "Required Validation",
+          "description": "Shows the built-in validation message after the required field loses focus.",
+          "code": "<QPhoneField :required=\"true\" :clearable=\"false\" />"
+        },
+        {
+          "title": "External Validation",
+          "description": "Keeps the required semantics while delegating validation feedback to the application.",
+          "code": "<QPhoneField :required=\"true\" :auto-validate=\"false\" :clearable=\"false\" />"
+        },
+        {
+          "title": "Readonly",
+          "description": "Prevents editing and country selection while retaining the formatted value.",
+          "code": "<QPhoneField :model-value=\"+351912345678\" :readonly=\"true\" />"
+        },
+        {
+          "title": "Disabled",
+          "description": "Disables all interaction with the field.",
+          "code": "<QPhoneField :model-value=\"+351912345678\" :disabled=\"true\" />"
+        },
+        {
+          "title": "Invalid",
+          "description": "Combines an application-provided invalid state with the component validation styling.",
+          "code": "<QPhoneField :model-value=\"+35191\" :invalid=\"true\" />"
+        }
+      ]
+    },
+    {
+      "name": "QPopover",
+      "description": "A floating container that displays contextual content, triggered by a button.",
+      "meta": {
+        "props": [
+          {
+            "name": "modelValue",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "",
+            "required": false
+          },
+          {
+            "name": "id",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The component unique identifier.",
+            "required": false,
+            "category": "Identification"
+          },
+          {
+            "name": "anchor",
+            "type": {
+              "kind": "union",
+              "types": [
+                {
+                  "name": "string"
+                },
+                {
+                  "name": "object",
+                  "value": {}
+                }
+              ]
+            },
+            "description": "The DOM element the popover should be anchored to.",
+            "required": true,
+            "category": "Identification"
+          },
+          {
+            "name": "text",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The text of the popover.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "title",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The title of the popover.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "name": "headingLevel",
             "type": {
               "kind": "primitive",
               "name": "number"
@@ -6441,6 +7759,15 @@
             "description": "",
             "required": false
           },
+          {
+            "name": "open",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "",
+            "required": false
+          },
           {
             "name": "id",
             "type": {
@@ -6592,6 +7919,39 @@
             "required": false,
             "category": "Behavior"
           },
+          {
+            "name": "overlayAnchor",
+            "type": {
+              "kind": "union",
+              "types": [
+                {
+                  "name": "other",
+                  "value": "null"
+                },
+                {
+                  "name": "string"
+                },
+                {
+                  "name": "object",
+                  "value": {}
+                }
+              ]
+            },
+            "description": "An alternative element used to anchor and size the options overlay.",
+            "required": false,
+            "category": "Identification"
+          },
+          {
+            "name": "selectOnTab",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "Whether pressing Tab while an option is focused selects it before focus moves away.",
+            "default": "true",
+            "required": false,
+            "category": "Behavior"
+          },
           {
             "name": "multiple",
             "type": {
@@ -6683,6 +8043,11 @@
             "description": "",
             "type": "[value: any]"
           },
+          {
+            "name": "update:open",
+            "description": "",
+            "type": "[value: boolean]"
+          },
           {
             "name": "before-show",
             "description": "",
@@ -6709,6 +8074,10 @@
             "name": "prepend",
             "description": ""
           },
+          {
+            "name": "value",
+            "description": ""
+          },
           {
             "name": "append",
             "description": ""
@@ -7588,9 +8957,9 @@
             "type": {
               "kind": "enum",
               "values": [
+                "off",
                 "soft",
-                "hard",
-                "off"
+                "hard"
               ]
             },
             "description": "Whether the text of the text area field can be wrapped and how.",