@longline/aqua-ui 1.0.187 → 1.0.188

package/formatters/Country/Countries.d.ts

@@ -0,0 +1,2 @@
+declare const Countries: Record<string, string[]>;
+export { Countries };

package/formatters/Country/Countries.js

@@ -0,0 +1,262 @@
+var Countries = {
+    "AC": ["Ascension Island"],
+    "AD": ["Andorra", "Andorran"],
+    "AE": ["United Arab Emirates", "UAE", "Emirati"],
+    "AF": ["Afghanistan", "Afghan"],
+    "AG": ["Antigua and Barbuda", "Antiguan, Barbudan"],
+    "AI": ["Anguilla", "Anguillian"],
+    "AL": ["Albania", "Albanian"],
+    "AM": ["Armenia", "Armenian"],
+    "AN": ["Netherlands Antilles"],
+    "AO": ["Angola", "Angolan"],
+    "AQ": ["Antarctica", "Antarctican"],
+    "AR": ["Argentina", "Argentine"],
+    "AS": ["American Samoa", "American Samoan"],
+    "AT": ["Austria", "Austrian"],
+    "AU": ["Australia", "Australian"],
+    "AW": ["Aruba", "Aruban"],
+    "AX": ["Åland Islands", "Ålandish"],
+    "AZ": ["Azerbaijan", "Azerbaijani"],
+    "BA": ["Bosnia and Herzegovina", "Bosnian, Herzegovinian"],
+    "BB": ["Barbados", "Barbadian"],
+    "BD": ["Bangladesh", "Bangladeshi"],
+    "BE": ["Belgium", "Belgian"],
+    "BF": ["Burkina Faso", "Burkinabe"],
+    "BG": ["Bulgaria", "Bulgarian"],
+    "BH": ["Bahrain", "Bahraini"],
+    "BI": ["Burundi", "Burundian"],
+    "BJ": ["Benin", "Beninese"],
+    "BL": ["Saint Barthélemy", "Barthélemois", "Saint Barth"],
+    "BM": ["Bermuda", "Bermudian"],
+    "BN": ["Brunei Darussalam", "Bruneian"],
+    "BO": ["Bolivia, Plurinational State of", "Bolivian"],
+    "BR": ["Brazil", "Brazilian"],
+    "BS": ["Bahamas", "Bahamian"],
+    "BT": ["Bhutan", "Bhutanese"],
+    "BQ": ["Caribbean Netherlands"],
+    "BV": ["Bouvet Island"],
+    "BW": ["Botswana", "Motswana"],
+    "BY": ["Belarus", "Belarusian"],
+    "BZ": ["Belize", "Belizean"],
+    "CA": ["Canada", "Canadian"],
+    "CC": ["Cocos (Keeling) Islands", "Cocos Islander"],
+    "CD": ["Congo, The Democratic Republic of the"],
+    "CF": ["Central African Republic", "Central African"],
+    "CG": ["Congo"],
+    "CH": ["Switzerland", "Swiss"],
+    "CI": ["Cote D'Ivoire", "Côte d'Ivoire", "Ivorian"],
+    "CK": ["Cook Islands", "Cook Islander"],
+    "CL": ["Chile", "Chilean"],
+    "CM": ["Cameroon", "Cameroonian"],
+    "CN": ["China", "Chinese"],
+    "CO": ["Colombia", "Colombian"],
+    "CP": ["Clipperton Island"],
+    "CR": ["Costa Rica", "Costa Rican"],
+    "CU": ["Cuba", "Cuban"],
+    "CV": ["Cape Verde", "Cape Verdian"],
+    "CW": ["Curaçao", "Curaçaoan"],
+    "CX": ["Christmas Island", "Christmas Islander"],
+    "CY": ["Cyprus", "Cypriot"],
+    "CZ": ["Czechia", "Czech Republic", "Czech"],
+    "DE": ["Germany", "German"],
+    "DG": ["Diego Garcia"],
+    "DJ": ["Djibouti"],
+    "DK": ["Denmark", "Danish"],
+    "DM": ["Dominica"],
+    "DO": ["Dominican Republic"],
+    "DZ": ["Algeria", "Algerian"],
+    "EA": ["Ceuta, Melilla"],
+    "EC": ["Ecuador", "Ecuadorean"],
+    "EE": ["Estonia", "Estonian"],
+    "EG": ["Egypt", "Egyptian"],
+    "EH": ["Western Sahara", "Sahrawi"],
+    "ER": ["Eritrea", "Eritrean"],
+    "ES": ["Spain", "Spanish"],
+    "ET": ["Ethiopia", "Ethiopian"],
+    "EU": ["European Union"],
+    "FI": ["Finland", "Finnish"],
+    "FJ": ["Fiji", "Fijian"],
+    "FK": ["Falkland Islands (Malvinas)", "Falkland Islander"],
+    "FM": ["Micronesia, Federated States of", "Micronesian"],
+    "FO": ["Faroe Islands", "Faroese"],
+    "FR": ["France", "French"],
+    "GA": ["Gabon", "Gabonese"],
+    "GB": ["United Kingdom", "UK", "British"],
+    "GD": ["Grenada", "Grenadian"],
+    "GE": ["Georgia", "Georgian"],
+    "GF": ["French Guiana", "Guianan"],
+    "GG": ["Guernsey"],
+    "GH": ["Ghana", "Ghanaian"],
+    "GI": ["Gibraltar"],
+    "GL": ["Greenland", "Greenlandic"],
+    "GM": ["Gambia", "Gambian"],
+    "GN": ["Guinea", "Guinean"],
+    "GP": ["Guadeloupe", "Guadeloupian"],
+    "GQ": ["Equatorial Guinea", "Equatorial Guinean"],
+    "GR": ["Greece", "Greek"],
+    "GS": ["South Georgia and the South Sandwich Islands", "South Georgian South Sandwich Islander"],
+    "GT": ["Guatemala", "Guatemalan"],
+    "GU": ["Guam", "Guamanian"],
+    "GW": ["Guinea-Bissau", "Guinea-Bissauan"],
+    "GY": ["Guyana", "Guyanese"],
+    "HK": ["Hong Kong", "Hong Konger"],
+    "HM": ["Heard Island and Mcdonald Islands", "Heard and McDonald Islander"],
+    "HN": ["Honduras", "Honduran"],
+    "HR": ["Croatia", "Croatian"],
+    "HT": ["Haiti", "Haitian"],
+    "HU": ["Hungary", "Hungarian"],
+    "IC": ["Canary Islands", "Canarian"],
+    "ID": ["Indonesia", "Indonesian"],
+    "IE": ["Ireland", "Irish"],
+    "IL": ["Israel", "Israeli"],
+    "IM": ["Isle of Man", "Manx"],
+    "IN": ["India", "Indian"],
+    "IO": ["British Indian Ocean Territory"],
+    "IQ": ["Iraq", "Iraqi"],
+    "IR": ["Iran, Islamic Republic Of", "Iranian"],
+    "IS": ["Iceland", "Icelander"],
+    "IT": ["Italy", "Italian"],
+    "JE": ["Jersey"],
+    "JM": ["Jamaica", "Jamaican"],
+    "JO": ["Jordan", "Jordanian"],
+    "JP": ["Japan", "Japanese"],
+    "KE": ["Kenya", "Kenyan"],
+    "KG": ["Kyrgyzstan", "Kirghiz"],
+    "KH": ["Cambodia", "Cambodian"],
+    "KI": ["Kiribati", "I-Kiribati"],
+    "KM": ["Comoros", "Comoran"],
+    "KN": ["Saint Kitts and Nevis", "Kittitian or Nevisian"],
+    "KP": ["Korea, Democratic People's Republic of", "North Korea", "North Korean", "DPRK"],
+    "KR": ["Korea, Republic of", "South Korea", "South Korean"],
+    "KW": ["Kuwait", "Kuwaiti"],
+    "KY": ["Cayman Islands", "Caymanian"],
+    "KZ": ["Kazakhstan", "Kazakhstani"],
+    "LA": ["Lao People's Democratic Republic", "Laos", "Laotian"],
+    "LB": ["Lebanon", "Lebanese"],
+    "LC": ["Saint Lucia", "Saint Lucian"],
+    "LI": ["Liechtenstein", "Liechtensteiner"],
+    "LK": ["Sri Lanka", "Sri Lankan"],
+    "LR": ["Liberia", "Liberian"],
+    "LS": ["Lesotho", "Mosotho"],
+    "LT": ["Lithuania", "Lithuanian"],
+    "LU": ["Luxembourg", "Luxembourger"],
+    "LV": ["Latvia", "Latvian"],
+    "LY": ["Libyan Arab Jamahiriya", "Libya", "Libyan"],
+    "MA": ["Morocco", "Moroccan"],
+    "MC": ["Monaco", "Monegasque"],
+    "MD": ["Moldova, Republic of", "Moldovan"],
+    "ME": ["Montenegro", "Montenegrin"],
+    "MF": ["Saint Martin", "Saint-Martinois"],
+    "MG": ["Madagascar", "Malagasy"],
+    "MH": ["Marshall Islands", "Marshallese"],
+    "MK": ["Republic of North Macedonia", "North Macedonia", "Macedonia, The Former Yugoslav Republic of", "Macedonian"],
+    "ML": ["Mali", "Malian"],
+    "MM": ["Myanmar", "Burma", "Burmese"],
+    "MN": ["Mongolia", "Mongolian"],
+    "MO": ["Macao", "Macau", "Macanese"],
+    "MP": ["Northern Mariana Islands"],
+    "MQ": ["Martinique"],
+    "MR": ["Mauritania", "Mauritanian"],
+    "MS": ["Montserrat", "Montserratian"],
+    "MT": ["Malta", "Maltese"],
+    "MU": ["Mauritius", "Mauritian"],
+    "MV": ["Maldives", "Maldivan"],
+    "MW": ["Malawi", "Malawian"],
+    "MX": ["Mexico", "Mexican"],
+    "MY": ["Malaysia", "Malaysian"],
+    "MZ": ["Mozambique", "Mozambican"],
+    "NA": ["Namibia", "Namibian"],
+    "NC": ["New Caledonia", "New Caledonian"],
+    "NE": ["Niger", "Nigerien"],
+    "NF": ["Norfolk Island", "Norfolk Islander"],
+    "NG": ["Nigeria", "Nigerian"],
+    "NI": ["Nicaragua", "Nicaraguan"],
+    "NL": ["Netherlands", "Dutch"],
+    "NO": ["Norway", "Norwegian"],
+    "NP": ["Nepal", "Nepalese"],
+    "NR": ["Nauru", "Nauruan"],
+    "NU": ["Niue", "Niuean"],
+    "NZ": ["New Zealand", "New Zealander"],
+    "OM": ["Oman", "Omani"],
+    "PA": ["Panama", "Panamanian"],
+    "PE": ["Peru", "Peruvian"],
+    "PF": ["French Polynesia", "French Polynesian"],
+    "PG": ["Papua New Guinea", "Papua New Guinean"],
+    "PH": ["Philippines", "Filipino"],
+    "PK": ["Pakistan", "Pakistani"],
+    "PL": ["Poland", "Polish"],
+    "PM": ["Saint Pierre and Miquelon"],
+    "PN": ["Pitcairn", "Pitcairn Islands", "Pitcairn Islander"],
+    "PR": ["Puerto Rico", "Puerto Rican"],
+    "PS": ["Palestinian Territory, Occupied", "Palestine", "Palestinian"],
+    "PT": ["Portugal", "Portuguese"],
+    "PW": ["Palau", "Palauan"],
+    "PY": ["Paraguay", "Paraguayan"],
+    "QA": ["Qatar", "Qatari"],
+    "RE": ["Reunion", "Réunion"],
+    "RO": ["Romania", "Romanian"],
+    "RS": ["Serbia", "Serbian"],
+    "RU": ["Russian Federation", "Russia", "Russian"],
+    "RW": ["Rwanda", "Rwandan"],
+    "SA": ["Saudi Arabia", "Saudi Arabian"],
+    "SB": ["Solomon Islands", "Solomon Islander"],
+    "SC": ["Seychelles", "Seychellois"],
+    "SD": ["Sudan", "Sudanese"],
+    "SE": ["Sweden", "Swedish"],
+    "SG": ["Singapore", "Singaporean"],
+    "SH": ["Saint Helena", "Saint Helenian"],
+    "SI": ["Slovenia", "Slovene"],
+    "SJ": ["Svalbard and Jan Mayen"],
+    "SK": ["Slovakia", "Slovak"],
+    "SL": ["Sierra Leone", "Sierra Leonean"],
+    "SM": ["San Marino", "Sammarinese"],
+    "SN": ["Senegal", "Senegalese"],
+    "SO": ["Somalia", "Somali"],
+    "SR": ["Suriname", "Surinamer"],
+    "SS": ["Republic of South Sudan", "South Sudan", "South Sudanese"],
+    "ST": ["Sao Tome and Principe", "São Tomé and Príncipe", "Sao Tomean"],
+    "SV": ["El Salvador", "Salvadoran"],
+    "SX": ["Sint Maarten", "Sint Maartener"],
+    "SY": ["Syrian Arab Republic", "Syria", "Syrian"],
+    "SZ": ["Eswatini", "Swaziland", "Swazi"],
+    "TA": ["Tristan da Cunha"],
+    "TC": ["Turks and Caicos Islands", "Turks and Caicos Islander"],
+    "TD": ["Chad", "Chadian"],
+    "TF": ["French Southern Territories"],
+    "TG": ["Togo", "Togolese"],
+    "TH": ["Thailand", "Thai"],
+    "TJ": ["Tajikistan", "Tadzhik"],
+    "TK": ["Tokelau", "Tokelauan"],
+    "TL": ["Timor-Leste", "East Timorese"],
+    "TM": ["Turkmenistan", "Turkmen"],
+    "TN": ["Tunisia", "Tunisian"],
+    "TO": ["Tonga", "Tongan"],
+    "TR": ["Türkiye", "Turkey", "Turkish"],
+    "TT": ["Trinidad and Tobago", "Trinidadian"],
+    "TV": ["Tuvalu", "Tuvaluan"],
+    "TW": ["Taiwan", "Taiwanese"],
+    "TZ": ["Tanzania, United Republic of", "Tanzanian"],
+    "UA": ["Ukraine", "Ukrainian"],
+    "UG": ["Uganda", "Ugandan"],
+    "UM": ["United States Minor Outlying Islands"],
+    "UN": ["United Nations"],
+    "US": ["United States", "USA", "US", "American"],
+    "UY": ["Uruguay", "Uruguayan"],
+    "UZ": ["Uzbekistan", "Uzbekistani"],
+    "VA": ["Holy See (Vatican City State)", "Vatican"],
+    "VC": ["Saint Vincent and the Grenadines", "Saint Vincentian"],
+    "VE": ["Venezuela", "Venezuelan"],
+    "VG": ["Virgin Islands, British"],
+    "VI": ["Virgin Islands, U.S."],
+    "VN": ["Vietnam", "Viet Nam", "Vietnamese"],
+    "VU": ["Vanuatu", "Ni-Vanuatu"],
+    "WF": ["Wallis and Futuna", "Wallis and Futuna Islander"],
+    "WS": ["Samoa", "Samoan"],
+    "XK": ["Kosovo", "Kosovar"],
+    "YE": ["Yemen", "Yemeni"],
+    "YT": ["Mayotte", "Mahoran"],
+    "ZA": ["South Africa", "South African"],
+    "ZM": ["Zambia", "Zambian"],
+    "ZW": ["Zimbabwe", "Zimbabwean"]
+};
+export { Countries };

package/formatters/Country/Country.d.ts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+interface IProps {
+    /**
+     * The country code (e.g. "FR") or name (e.g. "France") to format.
+     */
+    value: string;
+    /**
+     * The type of output to return. This can be either `flag` (to show a flag),
+     * `name` (to show the country name), or `both` (to show both the flag and
+     * name).
+     * @default both
+     */
+    type?: 'flag' | 'name' | 'both';
+}
+/**
+ * The `Country` formatter takes a country code or name and produces either
+ * an emoji flag, the country name, or both, depending on the `type` prop.
+ */
+declare const Country: ({ value, type }: IProps) => React.JSX.Element;
+export { Country };

package/formatters/Country/Country.js

@@ -0,0 +1,29 @@
+var __makeTemplateObject = (this && this.__makeTemplateObject) || function (cooked, raw) {
+    if (Object.defineProperty) { Object.defineProperty(cooked, "raw", { value: raw }); } else { cooked.raw = raw; }
+    return cooked;
+};
+import * as React from 'react';
+import styled from 'styled-components';
+import { CountryUtil } from './CountryUtil';
+/**
+ * The `Country` formatter takes a country code or name and produces either
+ * an emoji flag, the country name, or both, depending on the `type` prop.
+ */
+var Country = function (_a) {
+    var value = _a.value, _b = _a.type, type = _b === void 0 ? 'both' : _b;
+    switch (type) {
+        case 'flag':
+            return React.createElement(Flag, null, CountryUtil.getFlag(value));
+        case 'name':
+            return React.createElement(Name, null, CountryUtil.getName(value));
+        default:
+            return (React.createElement(FlagAndCountry, null,
+                React.createElement(Flag, null, CountryUtil.getFlag(value)),
+                React.createElement(Name, null, CountryUtil.getName(value))));
+    }
+};
+var Flag = styled.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  font-family:  \"Twemoji Country Flags\", \"Helvetica\", \"Comic Sans\", serif;\n"], ["\n  font-family:  \"Twemoji Country Flags\", \"Helvetica\", \"Comic Sans\", serif;\n"])));
+var Name = styled.div(templateObject_2 || (templateObject_2 = __makeTemplateObject(["\n  text-overflow: ellipsis;\n  overflow: hidden;  \n"], ["\n  text-overflow: ellipsis;\n  overflow: hidden;  \n"])));
+var FlagAndCountry = styled.div(templateObject_3 || (templateObject_3 = __makeTemplateObject(["\n  display: flex;\n  flex-direction: row;\n  gap: 6px;\n  align-items: center;\n"], ["\n  display: flex;\n  flex-direction: row;\n  gap: 6px;\n  align-items: center;\n"])));
+export { Country };
+var templateObject_1, templateObject_2, templateObject_3;

package/formatters/Country/CountryUtil.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Utility class for country code and name conversions, flag emoji generation,
+ * and fuzzy string matching for user input.
+ */
+declare class CountryUtil {
+    /**
+     * Normalizes country name formatting for names like
+       * "Virgin Islands, British" → "British Virgin Islands".
+     *
+     * @param name - Raw country name.
+     * @returns Normalized country name, or the original string if no formatting was needed.
+     */
+    static normalizeOutput: (name: string) => string;
+    /**
+     * Cleans and normalizes country names by:
+     * - Replacing ampersands with "and"
+     * - Removing diacritics
+     * - Reformatting comma-separated names
+     *
+     * @param name - Country name to normalize.
+     * @returns A normalized name used for fuzzy matching.
+     */
+    static normalizeName: (name: string) => string;
+    /**
+     * Performs a fuzzy comparison between two country names.
+     * Handles partial matches and normalization like:
+     * - "UK" vs "United Kingdom"
+     * - "Vatican" vs "Holy See (Vatican City State)"
+     *
+     * @param input - User input or free-form name.
+     * @param name - Official or alternative country name.
+     * @returns `true` if the two names match fuzzily; otherwise, `false`.
+     */
+    static fuzzyCompare: (input: string, name: string) => boolean;
+    /**
+     * Converts a full country name or common alias to its ISO 3166-1 alpha-2 code.
+     * Special-cases like "UK" are mapped to "GB".
+     *
+     * @param value - Country name or 2-letter ISO code.
+     * @returns The matching ISO code, or `null` if ambiguous or not found.
+     */
+    static nameToCode: (value: string) => string;
+    /**
+     * Returns the primary name associated with a given ISO country code.
+     *
+     * @param code - ISO 3166-1 alpha-2 code (e.g. "FR").
+     * @returns The display country name, or `undefined` if not found.
+     */
+    static codeToName: (code: string) => string;
+    /**
+     * Resolves a country name or code into a standardized display name.
+     *
+     * @param value - A country name or ISO code.
+     * @returns Country name, or `null` if not matched.
+     */
+    static getName: (value: string) => string;
+    /**
+     * Returns the Unicode flag emoji for a given country name or ISO code.
+     *
+     * Example: "FR" → 🇫🇷
+     *
+     * @param value - Country name or ISO code.
+     * @returns Flag emoji string, or `null` if not matched.
+     */
+    static getFlag: (value: string) => string;
+}
+export { CountryUtil };

package/formatters/Country/CountryUtil.js

@@ -0,0 +1,159 @@
+import { Countries } from './Countries';
+// Polyfill for country flag emojis in environments that don't support them 
+// natively.
+// See https://www.npmjs.com/package/country-flag-emoji-polyfill
+import { polyfillCountryFlagEmojis } from "country-flag-emoji-polyfill";
+polyfillCountryFlagEmojis();
+var CODE_RE = /^[a-z]{2}$/i;
+var MAGIC_NUMBER = 0x1F1E6 - 65; // Base offset for regional indicator symbols
+/**
+ * Utility class for country code and name conversions, flag emoji generation,
+ * and fuzzy string matching for user input.
+ */
+var CountryUtil = /** @class */ (function () {
+    function CountryUtil() {
+    }
+    var _a;
+    _a = CountryUtil;
+    /**
+     * Normalizes country name formatting for names like
+       * "Virgin Islands, British" → "British Virgin Islands".
+     *
+     * @param name - Raw country name.
+     * @returns Normalized country name, or the original string if no formatting was needed.
+     */
+    CountryUtil.normalizeOutput = function (name) {
+        if (!name)
+            return name;
+        if (name.includes(", ")) {
+            name = name.split(", ").reverse().join(' ');
+        }
+        return name;
+    };
+    /**
+     * Cleans and normalizes country names by:
+     * - Replacing ampersands with "and"
+     * - Removing diacritics
+     * - Reformatting comma-separated names
+     *
+     * @param name - Country name to normalize.
+     * @returns A normalized name used for fuzzy matching.
+     */
+    CountryUtil.normalizeName = function (name) {
+        if (!name)
+            return name;
+        // Replace & with and
+        name = name.replace(/\s*&\s*/g, ' and ');
+        // Replace diacritics with their base characters
+        name = name.normalize('NFD').replace(/[\u0300-\u036F]/g, '');
+        name = _a.normalizeOutput(name);
+        return name;
+    };
+    /**
+     * Performs a fuzzy comparison between two country names.
+     * Handles partial matches and normalization like:
+     * - "UK" vs "United Kingdom"
+     * - "Vatican" vs "Holy See (Vatican City State)"
+     *
+     * @param input - User input or free-form name.
+     * @param name - Official or alternative country name.
+     * @returns `true` if the two names match fuzzily; otherwise, `false`.
+     */
+    CountryUtil.fuzzyCompare = function (input, name) {
+        name = name.toLowerCase();
+        input = input.toLowerCase();
+        // Cases like:
+        //    "Vatican" <-> "Holy See (Vatican City State)"
+        //    "Russia"  <-> "Russian Federation"
+        if (name.includes(input) || input.includes(name)) {
+            return true;
+        }
+        var normalizedName = _a.normalizeName(name);
+        var normalizedInput = _a.normalizeName(input);
+        // Cases like:
+        //    "British Virgin Islands" <-> "Virgin Islands, British"
+        //    "Republic of Moldova"    <-> "Moldova, Republic of"
+        //    "Trinidad & Tobago"      <-> "Trinidad and Tobago"
+        if (normalizedName !== name || normalizedInput !== input) {
+            if (normalizedName.includes(normalizedInput) || normalizedInput.includes(normalizedName)) {
+                return true;
+            }
+        }
+        return false;
+    };
+    /**
+     * Converts a full country name or common alias to its ISO 3166-1 alpha-2 code.
+     * Special-cases like "UK" are mapped to "GB".
+     *
+     * @param value - Country name or 2-letter ISO code.
+     * @returns The matching ISO code, or `null` if ambiguous or not found.
+     */
+    CountryUtil.nameToCode = function (value) {
+        if (!value)
+            return null;
+        // Is this already a country code?
+        // (UK is an exception, as it must map to "GB").
+        if (CODE_RE.test(value) && value !== 'UK')
+            return value;
+        value = value.trim().toLowerCase();
+        // Look for exact match
+        for (var _i = 0, _b = Object.entries(Countries); _i < _b.length; _i++) {
+            var _c = _b[_i], code = _c[0], names = _c[1];
+            if (names.some(function (n) { return n.toLowerCase() === value; })) {
+                return code;
+            }
+        }
+        // Look for inexact match
+        var matches = Object.keys(Countries)
+            .filter(function (code) {
+            return Countries[code].some(function (n) { return _a.fuzzyCompare(value, n); });
+        });
+        // Return only when exactly one match was found
+        //   prevents cases like "United"
+        if (matches.length === 1) {
+            return matches[0];
+        }
+        return null;
+    };
+    /**
+     * Returns the primary name associated with a given ISO country code.
+     *
+     * @param code - ISO 3166-1 alpha-2 code (e.g. "FR").
+     * @returns The display country name, or `undefined` if not found.
+     */
+    CountryUtil.codeToName = function (code) {
+        var _b;
+        return _a.normalizeOutput((_b = Countries[code.toUpperCase()]) === null || _b === void 0 ? void 0 : _b[0]);
+    };
+    /**
+     * Resolves a country name or code into a standardized display name.
+     *
+     * @param value - A country name or ISO code.
+     * @returns Country name, or `null` if not matched.
+     */
+    CountryUtil.getName = function (value) {
+        var code = _a.nameToCode(value);
+        if (!code)
+            return null;
+        return _a.codeToName(code);
+    };
+    /**
+     * Returns the Unicode flag emoji for a given country name or ISO code.
+     *
+     * Example: "FR" → 🇫🇷
+     *
+     * @param value - Country name or ISO code.
+     * @returns Flag emoji string, or `null` if not matched.
+     */
+    CountryUtil.getFlag = function (value) {
+        var code = _a.nameToCode(value);
+        if (!code)
+            return null;
+        return code
+            .split("")
+            .map(function (c) { return String.fromCodePoint(MAGIC_NUMBER + c.charCodeAt(0)); })
+            .join("");
+    };
+    return CountryUtil;
+}());
+export { CountryUtil };

package/inputs/Dropdown/Dropdown.d.ts

@@ -133,4 +133,4 @@ declare const Dropdown: {
         displayName: string;
     };
 };
-export { Dropdown };
+export { Dropdown, IDropdownProps };

package/inputs/Dropdown/index.d.ts

@@ -1 +1 @@
-export { Dropdown } from './Dropdown';
+export { Dropdown, IDropdownProps } from './Dropdown';

package/inputs/Slider/Slider.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-interface IProps {
+interface ISliderProps {
     /** @ignore */
     className?: string;
     /**
@@ -64,5 +64,5 @@ interface IProps {
  * They're ideal for adjusting settings such as volume and brightness, or for
  * applying image filters.
  */
-declare const Slider: ({ min, max, fluid, ...props }: IProps) => React.JSX.Element;
-export { Slider, IProps };
+declare const Slider: ({ min, max, fluid, ...props }: ISliderProps) => React.JSX.Element;
+export { Slider, ISliderProps };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longline/aqua-ui",
-  "version": "1.0.187",
+  "version": "1.0.188",
   "description": "AquaUI",
   "author": "Alexander van Oostenrijk / Longline Environment",
   "license": "Commercial",
@@ -49,6 +49,7 @@
     "@types/react": "^18.3.10",
     "@types/react-dom": "^18.3.0",
     "awesome-debounce-promise": "^2.1.0",
+    "country-flag-emoji-polyfill": "^0.1.8",
     "gl-matrix": "^3.4.3",
     "mapbox-gl": "^3.9.4",
     "overlayscrollbars-react": "^0.5.6",