@quidgest/ui 0.19.0 → 0.20.0

package/dist/json/api.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.19.0",
+  "version": "0.20.0",
   "components": [
     {
       "name": "QAccordion",
@@ -5632,6 +5632,1061 @@
         }
       ]
     },
+    {
+      "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": "string"
+            },
+            "description": "",
+            "required": false
+          },
+          {
+            "name": "country",
+            "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": "",
+            "required": false
+          },
+          {
+            "name": "open",
+            "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": "label",
+            "type": {
+              "kind": "primitive",
+              "name": "string"
+            },
+            "description": "The label of the input.",
+            "required": false,
+            "category": "Content"
+          },
+          {
+            "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.",
@@ -6441,6 +7496,15 @@
             "description": "",
             "required": false
           },
+          {
+            "name": "open",
+            "type": {
+              "kind": "primitive",
+              "name": "boolean"
+            },
+            "description": "",
+            "required": false
+          },
           {
             "name": "id",
             "type": {
@@ -6592,6 +7656,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 +7780,11 @@
             "description": "",
             "type": "[value: any]"
           },
+          {
+            "name": "update:open",
+            "description": "",
+            "type": "[value: boolean]"
+          },
           {
             "name": "before-show",
             "description": "",
@@ -6709,6 +7811,10 @@
             "name": "prepend",
             "description": ""
           },
+          {
+            "name": "value",
+            "description": ""
+          },
           {
             "name": "append",
             "description": ""
@@ -7588,9 +8694,9 @@
             "type": {
               "kind": "enum",
               "values": [
+                "off",
                 "soft",
-                "hard",
-                "off"
+                "hard"
               ]
             },
             "description": "Whether the text of the text area field can be wrapped and how.",