@sankyu/circle-flags-core 1.5.4 → 1.6.0

package/dist/index.d.cts

@@ -1,499 +1,434 @@
-/**
- * Base props for all flag components across all frameworks
- * Individual framework packages may extend this interface
- */
-interface FlagComponentProps {
-    /** Width of the flag */
-    width?: number | string;
-    /** Height of the flag */
-    height?: number | string;
-    /** CSS className */
-    className?: string;
-    /** Accessible title for screen readers */
-    title?: string;
-}
-/**
- * Metadata for each flag component
- */
-interface FlagMetadata {
-    code: string;
-    name: string;
-    componentName: string;
-    svgSize: number;
-    optimizedSize: number;
-}
-/**
- * Build metadata interface
- */
-interface BuildMeta {
-    version: string;
-    builtTimestamp: number;
-    commitHash: string;
-    circleFlagsCommitHash: string;
-}
-
-/**
- * Convert ISO country code to flag emoji
- * @example
- * codeToEmoji('us') // returns '🇺🇸'
- * codeToEmoji('cn') // returns '🇨🇳'
- */
-declare function codeToEmoji(code: string): string;
-/**
- * Convert file code to valid JavaScript identifier (PascalCase)
- * @example
- * codeToComponentName('us') // returns 'FlagUs'
- * codeToComponentName('af-emirate') // returns 'FlagAfEmirate'
- */
-declare function codeToComponentName(code: string): string;
-/**
- * Standard flag sizes
- */
-declare const FlagSizes: {
-    readonly xs: 16;
-    readonly sm: 24;
-    readonly md: 32;
-    readonly lg: 48;
-    readonly xl: 64;
-    readonly xxl: 96;
-    readonly xxxl: 128;
-};
-type FlagSizeName = keyof typeof FlagSizes;
-/**
- * Get size name from pixel value
- */
-declare function getSizeName(pixels: number): FlagSizeName | null;
-
 declare const FLAG_REGISTRY: {
-    readonly io: "FlagIo";
-    readonly "pk-sd": "FlagPkSd";
-    readonly ki: "FlagKi";
-    readonly "ca-bc": "FlagCaBc";
-    readonly somaliland: "FlagSomaliland";
-    readonly sa: "FlagSa";
+    readonly ac: "FlagAc";
+    readonly ad: "FlagAd";
+    readonly ae: "FlagAe";
     readonly "af-emirate": "FlagAfEmirate";
-    readonly "it-77": "FlagIt77";
-    readonly yt: "FlagYt";
-    readonly hausa: "FlagHausa";
-    readonly gp: "FlagGp";
-    readonly es: "FlagEs";
-    readonly "fr-bre": "FlagFrBre";
-    readonly "nl-fr": "FlagNlFr";
-    readonly "it-34": "FlagIt34";
-    readonly "it-32": "FlagIt32";
-    readonly "us-wa": "FlagUsWa";
-    readonly mx: "FlagMx";
-    readonly tm: "FlagTm";
-    readonly mp: "FlagMp";
-    readonly "it-42": "FlagIt42";
-    readonly yorubaland: "FlagYorubaland";
-    readonly "us-ms": "FlagUsMs";
-    readonly guarani: "FlagGuarani";
-    readonly "it-88": "FlagIt88";
-    readonly tv: "FlagTv";
-    readonly "in-tn": "FlagInTn";
-    readonly uz: "FlagUz";
-    readonly "us-mo": "FlagUsMo";
-    readonly cx: "FlagCx";
-    readonly "mq-old": "FlagMqOld";
-    readonly "au-nsw": "FlagAuNsw";
-    readonly "es-ce": "FlagEsCe";
-    readonly dm: "FlagDm";
-    readonly "au-nt": "FlagAuNt";
-    readonly "it-75": "FlagIt75";
+    readonly af: "FlagAf";
+    readonly ag: "FlagAg";
     readonly ai: "FlagAi";
-    readonly "it-62": "FlagIt62";
-    readonly ky: "FlagKy";
-    readonly cv: "FlagCv";
-    readonly "it-57": "FlagIt57";
-    readonly mo: "FlagMo";
-    readonly "id-jb": "FlagIdJb";
-    readonly hr: "FlagHr";
-    readonly pg: "FlagPg";
-    readonly gd: "FlagGd";
-    readonly "es-ml": "FlagEsMl";
-    readonly "pt-20": "FlagPt20";
-    readonly "us-in": "FlagUsIn";
-    readonly wiphala: "FlagWiphala";
-    readonly "us-ar": "FlagUsAr";
-    readonly "id-jt": "FlagIdJt";
+    readonly al: "FlagAl";
+    readonly am: "FlagAm";
+    readonly an: "FlagAn";
+    readonly ao: "FlagAo";
+    readonly "aq-true_south": "FlagAqTrueSouth";
+    readonly aq: "FlagAq";
+    readonly ar: "FlagAr";
+    readonly artsakh: "FlagArtsakh";
+    readonly as: "FlagAs";
+    readonly at: "FlagAt";
+    readonly "au-aboriginal": "FlagAuAboriginal";
     readonly "au-act": "FlagAuAct";
-    readonly ck: "FlagCk";
-    readonly pm: "FlagPm";
-    readonly "us-betsy_ross": "FlagUsBetsyRoss";
-    readonly cq: "FlagCq";
-    readonly hmong: "FlagHmong";
-    readonly "sh-hl": "FlagShHl";
-    readonly ke: "FlagKe";
-    readonly iq: "FlagIq";
-    readonly "ge-ab": "FlagGeAb";
-    readonly fk: "FlagFk";
-    readonly tk: "FlagTk";
-    readonly tc: "FlagTc";
-    readonly ve: "FlagVe";
-    readonly occitania: "FlagOccitania";
-    readonly "ch-gr": "FlagChGr";
-    readonly ba: "FlagBa";
-    readonly tj: "FlagTj";
-    readonly "us-wy": "FlagUsWy";
-    readonly "it-82": "FlagIt82";
-    readonly gs: "FlagGs";
-    readonly "us-ri": "FlagUsRi";
-    readonly european_union: "FlagEuropeanUnion";
-    readonly sm: "FlagSm";
-    readonly vg: "FlagVg";
-    readonly rs: "FlagRs";
-    readonly "gb-nir": "FlagGbNir";
-    readonly "sh-ta": "FlagShTa";
-    readonly nc: "FlagNc";
-    readonly kr: "FlagKr";
-    readonly nz: "FlagNz";
-    readonly gu: "FlagGu";
-    readonly bm: "FlagBm";
-    readonly "au-vic": "FlagAuVic";
-    readonly "us-confederate_battle": "FlagUsConfederateBattle";
-    readonly xk: "FlagXk";
-    readonly me: "FlagMe";
-    readonly "cn-xz": "FlagCnXz";
+    readonly "au-nsw": "FlagAuNsw";
+    readonly "au-nt": "FlagAuNt";
+    readonly "au-qld": "FlagAuQld";
+    readonly "au-sa": "FlagAuSa";
     readonly "au-tas": "FlagAuTas";
-    readonly un: "FlagUn";
+    readonly "au-torres_strait_islands": "FlagAuTorresStraitIslands";
+    readonly "au-vic": "FlagAuVic";
     readonly "au-wa": "FlagAuWa";
-    readonly cc: "FlagCc";
-    readonly kg: "FlagKg";
-    readonly "sh-ac": "FlagShAc";
     readonly au: "FlagAu";
-    readonly kikuyu: "FlagKikuyu";
+    readonly aw: "FlagAw";
+    readonly ax: "FlagAx";
+    readonly az: "FlagAz";
+    readonly ba: "FlagBa";
+    readonly bb: "FlagBb";
+    readonly bd: "FlagBd";
+    readonly be: "FlagBe";
+    readonly bf: "FlagBf";
+    readonly bg: "FlagBg";
+    readonly bh: "FlagBh";
     readonly bi: "FlagBi";
-    readonly "it-36": "FlagIt36";
-    readonly ad: "FlagAd";
-    readonly "it-21": "FlagIt21";
-    readonly "it-52": "FlagIt52";
-    readonly lk: "FlagLk";
-    readonly bt: "FlagBt";
-    readonly "gb-wls": "FlagGbWls";
-    readonly ir: "FlagIr";
-    readonly gb: "FlagGb";
-    readonly "us-md": "FlagUsMd";
-    readonly zw: "FlagZw";
-    readonly fj: "FlagFj";
-    readonly "au-qld": "FlagAuQld";
-    readonly "bq-se": "FlagBqSe";
-    readonly ph: "FlagPh";
-    readonly md: "FlagMd";
-    readonly pn: "FlagPn";
-    readonly hn: "FlagHn";
-    readonly sz: "FlagSz";
-    readonly sk: "FlagSk";
-    readonly sb: "FlagSb";
-    readonly mz: "FlagMz";
-    readonly "it-78": "FlagIt78";
-    readonly "us-nm": "FlagUsNm";
-    readonly np: "FlagNp";
-    readonly vi: "FlagVi";
-    readonly mk: "FlagMk";
-    readonly ec: "FlagEc";
-    readonly lr: "FlagLr";
-    readonly "fr-20r": "FlagFr20r";
-    readonly "ru-cu": "FlagRuCu";
-    readonly us: "FlagUs";
-    readonly east_african_federation: "FlagEastAfricanFederation";
-    readonly uy: "FlagUy";
-    readonly nu: "FlagNu";
-    readonly ws: "FlagWs";
-    readonly kz: "FlagKz";
-    readonly il: "FlagIl";
-    readonly km: "FlagKm";
-    readonly ms: "FlagMs";
-    readonly cn: "FlagCn";
+    readonly bj: "FlagBj";
     readonly bl: "FlagBl";
-    readonly hk: "FlagHk";
-    readonly gi: "FlagGi";
-    readonly "us-ga": "FlagUsGa";
-    readonly do: "FlagDo";
-    readonly xx: "FlagXx";
-    readonly "au-sa": "FlagAuSa";
+    readonly bm: "FlagBm";
+    readonly bn: "FlagBn";
+    readonly bo: "FlagBo";
     readonly "bq-bo": "FlagBqBo";
-    readonly tf: "FlagTf";
+    readonly "bq-sa": "FlagBqSa";
+    readonly "bq-se": "FlagBqSe";
+    readonly bq: "FlagBq";
     readonly br: "FlagBr";
-    readonly ug: "FlagUg";
+    readonly bs: "FlagBs";
+    readonly bt: "FlagBt";
+    readonly bv: "FlagBv";
+    readonly bw: "FlagBw";
+    readonly "by-historical": "FlagByHistorical";
     readonly by: "FlagBy";
-    readonly "es-ib": "FlagEsIb";
-    readonly sx: "FlagSx";
-    readonly "es-ar": "FlagEsAr";
-    readonly "in-as": "FlagInAs";
-    readonly "us-sc": "FlagUsSc";
-    readonly va: "FlagVa";
-    readonly "us-ca": "FlagUsCa";
-    readonly ni: "FlagNi";
-    readonly bn: "FlagBn";
-    readonly "it-55": "FlagIt55";
-    readonly otomi: "FlagOtomi";
-    readonly al: "FlagAl";
-    readonly na: "FlagNa";
-    readonly zm: "FlagZm";
-    readonly "au-torres_strait_islands": "FlagAuTorresStraitIslands";
-    readonly "pk-jk": "FlagPkJk";
-    readonly vu: "FlagVu";
-    readonly kn: "FlagKn";
-    readonly "it-67": "FlagIt67";
-    readonly my: "FlagMy";
-    readonly bb: "FlagBb";
-    readonly "fr-cp": "FlagFrCp";
-    readonly ht: "FlagHt";
-    readonly as: "FlagAs";
-    readonly cy: "FlagCy";
-    readonly cf: "FlagCf";
-    readonly gt: "FlagGt";
-    readonly "et-or": "FlagEtOr";
-    readonly "iq-kr": "FlagIqKr";
-    readonly mn: "FlagMn";
     readonly bz: "FlagBz";
-    readonly sg: "FlagSg";
-    readonly ax: "FlagAx";
-    readonly fo: "FlagFo";
-    readonly "gb-ork": "FlagGbOrk";
-    readonly tg: "FlagTg";
-    readonly tw: "FlagTw";
-    readonly is: "FlagIs";
-    readonly no: "FlagNo";
-    readonly "us-az": "FlagUsAz";
-    readonly eh: "FlagEh";
-    readonly "es-pv": "FlagEsPv";
-    readonly ao: "FlagAo";
-    readonly gg: "FlagGg";
-    readonly py: "FlagPy";
-    readonly "us-nc": "FlagUsNc";
-    readonly er: "FlagEr";
-    readonly aw: "FlagAw";
-    readonly ss: "FlagSs";
-    readonly je: "FlagJe";
-    readonly cu: "FlagCu";
-    readonly "pt-30": "FlagPt30";
-    readonly sv: "FlagSv";
-    readonly "us-ak": "FlagUsAk";
-    readonly "us-hi": "FlagUsHi";
-    readonly kp: "FlagKp";
-    readonly pf: "FlagPf";
-    readonly rw: "FlagRw";
+    readonly "ca-bc": "FlagCaBc";
     readonly "ca-qc": "FlagCaQc";
-    readonly ge: "FlagGe";
-    readonly soviet_union: "FlagSovietUnion";
-    readonly pa: "FlagPa";
-    readonly an: "FlagAn";
-    readonly et: "FlagEt";
-    readonly mh: "FlagMh";
-    readonly "us-tn": "FlagUsTn";
-    readonly "in-mn": "FlagInMn";
-    readonly jo: "FlagJo";
-    readonly za: "FlagZa";
-    readonly gq: "FlagGq";
-    readonly "et-af": "FlagEtAf";
-    readonly ag: "FlagAg";
-    readonly "et-si": "FlagEtSi";
-    readonly sami: "FlagSami";
-    readonly az: "FlagAz";
-    readonly fm: "FlagFm";
-    readonly ma: "FlagMa";
-    readonly "us-or": "FlagUsOr";
-    readonly ar: "FlagAr";
-    readonly eg: "FlagEg";
-    readonly cw: "FlagCw";
-    readonly si: "FlagSi";
-    readonly nr: "FlagNr";
-    readonly pr: "FlagPr";
-    readonly st: "FlagSt";
-    readonly quechua: "FlagQuechua";
-    readonly pt: "FlagPt";
-    readonly sr: "FlagSr";
+    readonly ca: "FlagCa";
+    readonly cc: "FlagCc";
     readonly cd: "FlagCd";
-    readonly jm: "FlagJm";
-    readonly af: "FlagAf";
-    readonly ly: "FlagLy";
-    readonly "it-65": "FlagIt65";
-    readonly om: "FlagOm";
-    readonly "us-co": "FlagUsCo";
-    readonly pk: "FlagPk";
-    readonly sc: "FlagSc";
-    readonly gr: "FlagGr";
-    readonly artsakh: "FlagArtsakh";
-    readonly gy: "FlagGy";
-    readonly kh: "FlagKh";
-    readonly northern_cyprus: "FlagNorthernCyprus";
-    readonly in: "FlagIn";
-    readonly vc: "FlagVc";
-    readonly "it-25": "FlagIt25";
-    readonly li: "FlagLi";
-    readonly re: "FlagRe";
-    readonly mw: "FlagMw";
-    readonly gw: "FlagGw";
-    readonly mr: "FlagMr";
-    readonly sy: "FlagSy";
-    readonly mm: "FlagMm";
-    readonly "us-fl": "FlagUsFl";
-    readonly yu: "FlagYu";
-    readonly "et-sw": "FlagEtSw";
-    readonly wf: "FlagWf";
+    readonly cf: "FlagCf";
+    readonly cg: "FlagCg";
+    readonly "ch-gr": "FlagChGr";
+    readonly ch: "FlagCh";
+    readonly ci: "FlagCi";
+    readonly ck: "FlagCk";
+    readonly cl: "FlagCl";
     readonly cm: "FlagCm";
-    readonly kongo: "FlagKongo";
-    readonly maori: "FlagMaori";
-    readonly sn: "FlagSn";
-    readonly mf: "FlagMf";
-    readonly im: "FlagIm";
+    readonly "cn-hk": "FlagCnHk";
+    readonly "cn-xj": "FlagCnXj";
+    readonly "cn-xz": "FlagCnXz";
+    readonly cn: "FlagCn";
+    readonly co: "FlagCo";
+    readonly cp: "FlagCp";
+    readonly cq: "FlagCq";
+    readonly cr: "FlagCr";
+    readonly cu: "FlagCu";
+    readonly cv: "FlagCv";
+    readonly cw: "FlagCw";
+    readonly cx: "FlagCx";
+    readonly cy: "FlagCy";
+    readonly cz: "FlagCz";
+    readonly de: "FlagDe";
+    readonly dg: "FlagDg";
+    readonly dj: "FlagDj";
+    readonly dk: "FlagDk";
+    readonly dm: "FlagDm";
+    readonly do: "FlagDo";
     readonly dz: "FlagDz";
-    readonly gm: "FlagGm";
+    readonly ea: "FlagEa";
+    readonly east_african_federation: "FlagEastAfricanFederation";
     readonly easter_island: "FlagEasterIsland";
+    readonly "ec-w": "FlagEcW";
+    readonly ec: "FlagEc";
+    readonly ee: "FlagEe";
+    readonly eg: "FlagEg";
+    readonly eh: "FlagEh";
+    readonly er: "FlagEr";
+    readonly "es-ar": "FlagEsAr";
+    readonly "es-ce": "FlagEsCe";
+    readonly "es-cn": "FlagEsCn";
     readonly "es-ct": "FlagEsCt";
-    readonly dj: "FlagDj";
-    readonly "it-72": "FlagIt72";
-    readonly tl: "FlagTl";
-    readonly ca: "FlagCa";
-    readonly ls: "FlagLs";
-    readonly tn: "FlagTn";
-    readonly "et-so": "FlagEtSo";
-    readonly "us-dc": "FlagUsDc";
-    readonly "bq-sa": "FlagBqSa";
     readonly "es-ga": "FlagEsGa";
-    readonly qa: "FlagQa";
-    readonly ewe: "FlagEwe";
-    readonly cl: "FlagCl";
+    readonly "es-ib": "FlagEsIb";
+    readonly "es-ml": "FlagEsMl";
+    readonly "es-pv": "FlagEsPv";
+    readonly "es-variant": "FlagEsVariant";
+    readonly "es-vc": "FlagEsVc";
+    readonly es: "FlagEs";
+    readonly "et-af": "FlagEtAf";
+    readonly "et-am": "FlagEtAm";
+    readonly "et-be": "FlagEtBe";
     readonly "et-ga": "FlagEtGa";
     readonly "et-ha": "FlagEtHa";
+    readonly "et-or": "FlagEtOr";
+    readonly "et-si": "FlagEtSi";
+    readonly "et-sn": "FlagEtSn";
+    readonly "et-so": "FlagEtSo";
+    readonly "et-sw": "FlagEtSw";
+    readonly "et-ti": "FlagEtTi";
+    readonly et: "FlagEt";
+    readonly eu: "FlagEu";
+    readonly european_union: "FlagEuropeanUnion";
+    readonly ewe: "FlagEwe";
     readonly fi: "FlagFi";
-    readonly dk: "FlagDk";
-    readonly se: "FlagSe";
-    readonly mu: "FlagMu";
+    readonly fj: "FlagFj";
+    readonly fk: "FlagFk";
+    readonly fm: "FlagFm";
+    readonly fo: "FlagFo";
+    readonly "fr-20r": "FlagFr20r";
+    readonly "fr-bre": "FlagFrBre";
+    readonly "fr-cp": "FlagFrCp";
+    readonly fr: "FlagFr";
+    readonly fx: "FlagFx";
+    readonly ga: "FlagGa";
+    readonly "gb-con": "FlagGbCon";
+    readonly "gb-eng": "FlagGbEng";
+    readonly "gb-nir": "FlagGbNir";
+    readonly "gb-ork": "FlagGbOrk";
+    readonly "gb-sct": "FlagGbSct";
+    readonly "gb-wls": "FlagGbWls";
+    readonly gb: "FlagGb";
+    readonly gd: "FlagGd";
+    readonly "ge-ab": "FlagGeAb";
+    readonly ge: "FlagGe";
+    readonly gf: "FlagGf";
+    readonly gg: "FlagGg";
+    readonly gh: "FlagGh";
+    readonly gi: "FlagGi";
     readonly gl: "FlagGl";
-    readonly "tz-zanzibar": "FlagTzZanzibar";
-    readonly bh: "FlagBh";
+    readonly gm: "FlagGm";
+    readonly gn: "FlagGn";
+    readonly gp: "FlagGp";
+    readonly gq: "FlagGq";
+    readonly gr: "FlagGr";
+    readonly gs: "FlagGs";
+    readonly gt: "FlagGt";
+    readonly gu: "FlagGu";
+    readonly guarani: "FlagGuarani";
+    readonly gw: "FlagGw";
+    readonly gy: "FlagGy";
+    readonly hausa: "FlagHausa";
+    readonly hk: "FlagHk";
+    readonly hm: "FlagHm";
+    readonly hmong: "FlagHmong";
+    readonly hn: "FlagHn";
+    readonly hr: "FlagHr";
+    readonly ht: "FlagHt";
+    readonly hu: "FlagHu";
+    readonly ic: "FlagIc";
+    readonly "id-jb": "FlagIdJb";
+    readonly "id-jt": "FlagIdJt";
+    readonly id: "FlagId";
+    readonly ie: "FlagIe";
+    readonly il: "FlagIl";
+    readonly im: "FlagIm";
+    readonly "in-as": "FlagInAs";
+    readonly "in-gj": "FlagInGj";
+    readonly "in-ka": "FlagInKa";
+    readonly "in-mn": "FlagInMn";
+    readonly "in-mz": "FlagInMz";
+    readonly "in-or": "FlagInOr";
+    readonly "in-tg": "FlagInTg";
+    readonly "in-tn": "FlagInTn";
+    readonly in: "FlagIn";
+    readonly io: "FlagIo";
+    readonly "iq-kr": "FlagIqKr";
+    readonly iq: "FlagIq";
+    readonly ir: "FlagIr";
+    readonly is: "FlagIs";
+    readonly "it-21": "FlagIt21";
+    readonly "it-23": "FlagIt23";
+    readonly "it-25": "FlagIt25";
+    readonly "it-32": "FlagIt32";
+    readonly "it-34": "FlagIt34";
+    readonly "it-36": "FlagIt36";
+    readonly "it-42": "FlagIt42";
     readonly "it-45": "FlagIt45";
-    readonly ae: "FlagAe";
-    readonly lb: "FlagLb";
-    readonly ne: "FlagNe";
-    readonly nf: "FlagNf";
-    readonly bw: "FlagBw";
-    readonly "us-mn": "FlagUsMn";
-    readonly bf: "FlagBf";
-    readonly gh: "FlagGh";
+    readonly "it-52": "FlagIt52";
+    readonly "it-55": "FlagIt55";
+    readonly "it-57": "FlagIt57";
+    readonly "it-62": "FlagIt62";
+    readonly "it-65": "FlagIt65";
+    readonly "it-67": "FlagIt67";
+    readonly "it-72": "FlagIt72";
+    readonly "it-75": "FlagIt75";
+    readonly "it-77": "FlagIt77";
+    readonly "it-78": "FlagIt78";
+    readonly "it-82": "FlagIt82";
+    readonly "it-88": "FlagIt88";
+    readonly it: "FlagIt";
+    readonly je: "FlagJe";
+    readonly jm: "FlagJm";
+    readonly jo: "FlagJo";
+    readonly jp: "FlagJp";
     readonly kanuri: "FlagKanuri";
-    readonly cr: "FlagCr";
-    readonly "et-sn": "FlagEtSn";
-    readonly tz: "FlagTz";
-    readonly tr: "FlagTr";
-    readonly "in-tg": "FlagInTg";
-    readonly th: "FlagTh";
+    readonly ke: "FlagKe";
+    readonly kg: "FlagKg";
+    readonly kh: "FlagKh";
+    readonly ki: "FlagKi";
+    readonly kikuyu: "FlagKikuyu";
+    readonly km: "FlagKm";
+    readonly kn: "FlagKn";
+    readonly kongo: "FlagKongo";
+    readonly kp: "FlagKp";
+    readonly kr: "FlagKr";
     readonly kw: "FlagKw";
-    readonly lc: "FlagLc";
-    readonly "mt-civil_ensign": "FlagMtCivilEnsign";
-    readonly "ru-ud": "FlagRuUd";
-    readonly "ru-ba": "FlagRuBa";
-    readonly sd: "FlagSd";
-    readonly mv: "FlagMv";
-    readonly "et-be": "FlagEtBe";
-    readonly tt: "FlagTt";
-    readonly ps: "FlagPs";
-    readonly "us-tx": "FlagUsTx";
+    readonly ky: "FlagKy";
+    readonly kz: "FlagKz";
     readonly la: "FlagLa";
-    readonly "et-am": "FlagEtAm";
-    readonly to: "FlagTo";
-    readonly aq: "FlagAq";
-    readonly "gb-eng": "FlagGbEng";
-    readonly "gb-sct": "FlagGbSct";
-    readonly "ru-ce": "FlagRuCe";
-    readonly "gb-con": "FlagGbCon";
-    readonly "us-al": "FlagUsAl";
-    readonly "us-wi": "FlagUsWi";
-    readonly bj: "FlagBj";
-    readonly mt: "FlagMt";
-    readonly bs: "FlagBs";
-    readonly mg: "FlagMg";
-    readonly "ec-w": "FlagEcW";
-    readonly bg: "FlagBg";
-    readonly ee: "FlagEe";
-    readonly cg: "FlagCg";
-    readonly bo: "FlagBo";
-    readonly ga: "FlagGa";
-    readonly gn: "FlagGn";
+    readonly lb: "FlagLb";
+    readonly lc: "FlagLc";
+    readonly li: "FlagLi";
+    readonly lk: "FlagLk";
+    readonly lr: "FlagLr";
+    readonly ls: "FlagLs";
     readonly lt: "FlagLt";
+    readonly lu: "FlagLu";
+    readonly lv: "FlagLv";
+    readonly ly: "FlagLy";
+    readonly ma: "FlagMa";
     readonly malayali: "FlagMalayali";
+    readonly maori: "FlagMaori";
+    readonly mc: "FlagMc";
+    readonly md: "FlagMd";
+    readonly me: "FlagMe";
+    readonly mf: "FlagMf";
+    readonly mg: "FlagMg";
+    readonly mh: "FlagMh";
+    readonly mk: "FlagMk";
     readonly ml: "FlagMl";
-    readonly ro: "FlagRo";
-    readonly "es-cn": "FlagEsCn";
-    readonly gf: "FlagGf";
-    readonly "in-gj": "FlagInGj";
-    readonly "ua-kpr": "FlagUaKpr";
-    readonly co: "FlagCo";
-    readonly fr: "FlagFr";
-    readonly hu: "FlagHu";
-    readonly ie: "FlagIe";
-    readonly it: "FlagIt";
-    readonly lu: "FlagLu";
+    readonly mm: "FlagMm";
+    readonly mn: "FlagMn";
+    readonly mo: "FlagMo";
+    readonly mp: "FlagMp";
+    readonly "mq-old": "FlagMqOld";
+    readonly mq: "FlagMq";
+    readonly mr: "FlagMr";
+    readonly ms: "FlagMs";
+    readonly "mt-civil_ensign": "FlagMtCivilEnsign";
+    readonly mt: "FlagMt";
+    readonly mu: "FlagMu";
+    readonly mv: "FlagMv";
+    readonly mw: "FlagMw";
+    readonly mx: "FlagMx";
+    readonly my: "FlagMy";
+    readonly mz: "FlagMz";
+    readonly na: "FlagNa";
+    readonly nc: "FlagNc";
+    readonly ne: "FlagNe";
+    readonly nf: "FlagNf";
+    readonly ng: "FlagNg";
+    readonly ni: "FlagNi";
+    readonly "nl-fr": "FlagNlFr";
     readonly nl: "FlagNl";
-    readonly sl: "FlagSl";
-    readonly south_ossetia: "FlagSouthOssetia";
-    readonly td: "FlagTd";
-    readonly be: "FlagBe";
-    readonly ci: "FlagCi";
-    readonly ye: "FlagYe";
-    readonly "ru-lpr": "FlagRuLpr";
-    readonly am: "FlagAm";
-    readonly de: "FlagDe";
+    readonly no: "FlagNo";
+    readonly northern_cyprus: "FlagNorthernCyprus";
+    readonly np: "FlagNp";
+    readonly nr: "FlagNr";
+    readonly nu: "FlagNu";
+    readonly nz: "FlagNz";
+    readonly occitania: "FlagOccitania";
+    readonly om: "FlagOm";
+    readonly otomi: "FlagOtomi";
+    readonly pa: "FlagPa";
+    readonly pe: "FlagPe";
+    readonly pf: "FlagPf";
+    readonly pg: "FlagPg";
+    readonly ph: "FlagPh";
+    readonly "pk-jk": "FlagPkJk";
+    readonly "pk-sd": "FlagPkSd";
+    readonly pk: "FlagPk";
+    readonly pl: "FlagPl";
+    readonly pm: "FlagPm";
+    readonly pn: "FlagPn";
+    readonly pr: "FlagPr";
+    readonly ps: "FlagPs";
+    readonly "pt-20": "FlagPt20";
+    readonly "pt-30": "FlagPt30";
+    readonly pt: "FlagPt";
+    readonly pw: "FlagPw";
+    readonly py: "FlagPy";
+    readonly qa: "FlagQa";
+    readonly quechua: "FlagQuechua";
+    readonly re: "FlagRe";
+    readonly ro: "FlagRo";
+    readonly rs: "FlagRs";
+    readonly "ru-ba": "FlagRuBa";
+    readonly "ru-ce": "FlagRuCe";
+    readonly "ru-cu": "FlagRuCu";
     readonly "ru-da": "FlagRuDa";
     readonly "ru-dpr": "FlagRuDpr";
-    readonly ru: "FlagRu";
-    readonly so: "FlagSo";
-    readonly "in-or": "FlagInOr";
     readonly "ru-ko": "FlagRuKo";
-    readonly "ua-bpr": "FlagUaBpr";
+    readonly "ru-lpr": "FlagRuLpr";
     readonly "ru-ta": "FlagRuTa";
+    readonly "ru-ud": "FlagRuUd";
+    readonly ru: "FlagRu";
+    readonly rw: "FlagRw";
+    readonly sa: "FlagSa";
+    readonly sami: "FlagSami";
+    readonly sb: "FlagSb";
+    readonly sc: "FlagSc";
+    readonly sd: "FlagSd";
+    readonly se: "FlagSe";
     readonly sealand: "FlagSealand";
-    readonly "aq-true_south": "FlagAqTrueSouth";
-    readonly "au-aboriginal": "FlagAuAboriginal";
-    readonly "in-mz": "FlagInMz";
-    readonly "cn-xj": "FlagCnXj";
-    readonly cz: "FlagCz";
-    readonly mq: "FlagMq";
-    readonly lv: "FlagLv";
-    readonly transnistria: "FlagTransnistria";
-    readonly "es-variant": "FlagEsVariant";
-    readonly "et-ti": "FlagEtTi";
-    readonly pe: "FlagPe";
-    readonly at: "FlagAt";
-    readonly ch: "FlagCh";
-    readonly "by-historical": "FlagByHistorical";
-    readonly ng: "FlagNg";
-    readonly vn: "FlagVn";
-    readonly "in-ka": "FlagInKa";
-    readonly "it-23": "FlagIt23";
-    readonly ua: "FlagUa";
-    readonly id: "FlagId";
-    readonly mc: "FlagMc";
-    readonly pl: "FlagPl";
-    readonly bd: "FlagBd";
-    readonly pw: "FlagPw";
-    readonly jp: "FlagJp";
-    readonly ac: "FlagAc";
-    readonly bq: "FlagBq";
-    readonly bv: "FlagBv";
-    readonly "cn-hk": "FlagCnHk";
-    readonly cp: "FlagCp";
-    readonly dg: "FlagDg";
-    readonly ea: "FlagEa";
-    readonly eu: "FlagEu";
-    readonly fx: "FlagFx";
-    readonly hm: "FlagHm";
-    readonly ic: "FlagIc";
+    readonly sg: "FlagSg";
+    readonly "sh-ac": "FlagShAc";
+    readonly "sh-hl": "FlagShHl";
+    readonly "sh-ta": "FlagShTa";
     readonly sh: "FlagSh";
+    readonly si: "FlagSi";
     readonly sj: "FlagSj";
+    readonly sk: "FlagSk";
+    readonly sl: "FlagSl";
+    readonly sm: "FlagSm";
+    readonly sn: "FlagSn";
+    readonly so: "FlagSo";
+    readonly somaliland: "FlagSomaliland";
+    readonly south_ossetia: "FlagSouthOssetia";
+    readonly soviet_union: "FlagSovietUnion";
+    readonly sr: "FlagSr";
+    readonly ss: "FlagSs";
+    readonly st: "FlagSt";
     readonly su: "FlagSu";
+    readonly sv: "FlagSv";
+    readonly sx: "FlagSx";
+    readonly sy: "FlagSy";
+    readonly sz: "FlagSz";
     readonly ta: "FlagTa";
+    readonly tc: "FlagTc";
+    readonly td: "FlagTd";
+    readonly tf: "FlagTf";
+    readonly tg: "FlagTg";
+    readonly th: "FlagTh";
+    readonly tj: "FlagTj";
+    readonly tk: "FlagTk";
+    readonly tl: "FlagTl";
+    readonly tm: "FlagTm";
+    readonly tn: "FlagTn";
+    readonly to: "FlagTo";
+    readonly tr: "FlagTr";
+    readonly transnistria: "FlagTransnistria";
+    readonly tt: "FlagTt";
+    readonly tv: "FlagTv";
+    readonly tw: "FlagTw";
+    readonly "tz-zanzibar": "FlagTzZanzibar";
+    readonly tz: "FlagTz";
+    readonly "ua-bpr": "FlagUaBpr";
+    readonly "ua-kpr": "FlagUaKpr";
+    readonly ua: "FlagUa";
+    readonly ug: "FlagUg";
     readonly uk: "FlagUk";
     readonly um: "FlagUm";
+    readonly un: "FlagUn";
+    readonly "us-ak": "FlagUsAk";
+    readonly "us-al": "FlagUsAl";
+    readonly "us-ar": "FlagUsAr";
     readonly "us-as": "FlagUsAs";
+    readonly "us-az": "FlagUsAz";
+    readonly "us-betsy_ross": "FlagUsBetsyRoss";
+    readonly "us-ca": "FlagUsCa";
+    readonly "us-co": "FlagUsCo";
+    readonly "us-confederate_battle": "FlagUsConfederateBattle";
+    readonly "us-dc": "FlagUsDc";
+    readonly "us-fl": "FlagUsFl";
+    readonly "us-ga": "FlagUsGa";
     readonly "us-gu": "FlagUsGu";
+    readonly "us-hi": "FlagUsHi";
+    readonly "us-in": "FlagUsIn";
+    readonly "us-md": "FlagUsMd";
+    readonly "us-mn": "FlagUsMn";
+    readonly "us-mo": "FlagUsMo";
     readonly "us-mp": "FlagUsMp";
+    readonly "us-ms": "FlagUsMs";
+    readonly "us-nc": "FlagUsNc";
+    readonly "us-nm": "FlagUsNm";
+    readonly "us-or": "FlagUsOr";
     readonly "us-pr": "FlagUsPr";
+    readonly "us-ri": "FlagUsRi";
+    readonly "us-sc": "FlagUsSc";
+    readonly "us-tn": "FlagUsTn";
+    readonly "us-tx": "FlagUsTx";
     readonly "us-um": "FlagUsUm";
     readonly "us-vi": "FlagUsVi";
+    readonly "us-wa": "FlagUsWa";
+    readonly "us-wi": "FlagUsWi";
+    readonly "us-wy": "FlagUsWy";
+    readonly us: "FlagUs";
+    readonly uy: "FlagUy";
+    readonly uz: "FlagUz";
+    readonly va: "FlagVa";
+    readonly vc: "FlagVc";
+    readonly ve: "FlagVe";
+    readonly vg: "FlagVg";
+    readonly vi: "FlagVi";
+    readonly vn: "FlagVn";
+    readonly vu: "FlagVu";
+    readonly wf: "FlagWf";
+    readonly wiphala: "FlagWiphala";
+    readonly ws: "FlagWs";
+    readonly xk: "FlagXk";
+    readonly xx: "FlagXx";
+    readonly ye: "FlagYe";
+    readonly yorubaland: "FlagYorubaland";
+    readonly yt: "FlagYt";
+    readonly yu: "FlagYu";
+    readonly za: "FlagZa";
+    readonly zm: "FlagZm";
+    readonly zw: "FlagZw";
 };
 declare const FLAG_ALIASES: {
     readonly ac: "sh-ac";
@@ -522,6 +457,74 @@ declare const FLAG_ALIASES: {
 };
 type FlagCode = keyof typeof FLAG_REGISTRY;
 
+/**
+ * Base props for all flag components across all frameworks
+ * Individual framework packages may extend this interface
+ */
+interface FlagComponentProps {
+    /** Width of the flag */
+    width?: number | string;
+    /** Height of the flag */
+    height?: number | string;
+    /** CSS className */
+    className?: string;
+    /** Accessible title for screen readers */
+    title?: string;
+}
+/**
+ * Metadata for each flag component
+ */
+interface FlagMetadata {
+    code: string;
+    name: string;
+    componentName: string;
+    svgSize: number;
+    optimizedSize: number;
+}
+/**
+ * Build metadata interface
+ */
+interface BuildMeta {
+    version: string;
+    builtTimestamp: number;
+    commitHash: string;
+    circleFlagsCommitHash: string;
+}
+
+/**
+ * Convert ISO country code to flag emoji
+ * @example
+ * codeToEmoji('us') // returns '🇺🇸'
+ * codeToEmoji('cn') // returns '🇨🇳'
+ */
+declare function codeToEmoji(code: string): string;
+/**
+ * Convert file code to valid JavaScript identifier (PascalCase)
+ * @example
+ * codeToComponentName('us') // returns 'FlagUs'
+ * codeToComponentName('af-emirate') // returns 'FlagAfEmirate'
+ */
+declare function codeToComponentName(code: string): string;
+/**
+ * Standard flag sizes
+ */
+declare const FlagSizes: {
+    readonly xs: 16;
+    readonly sm: 24;
+    readonly md: 32;
+    readonly lg: 48;
+    readonly xl: 64;
+    readonly xxl: 96;
+    readonly xxxl: 128;
+};
+type FlagSizeName = keyof typeof FlagSizes;
+/**
+ * Get size name from pixel value
+ */
+declare function getSizeName(pixels: number): FlagSizeName | null;
+declare function isFlagCode(code: string): code is FlagCode;
+declare function coerceFlagCode(code: string, fallback?: FlagCode): FlagCode;
+
 declare const COUNTRY_NAMES: {
     readonly af: "Afghanistan";
     readonly ax: "Åland Islands";
@@ -772,75 +775,76 @@ declare const COUNTRY_NAMES: {
     readonly ye: "Yemen";
     readonly zm: "Zambia";
     readonly zw: "Zimbabwe";
-    readonly somaliland: "Somaliland";
+    readonly ac: "Ascension Island";
     readonly "af-emirate": "Afghanistan";
-    readonly hausa: "Hausa";
-    readonly yorubaland: "Yorubaland";
-    readonly guarani: "Guarani";
-    readonly "mq-old": "Martinique, France";
-    readonly wiphala: "Wiphala";
-    readonly "us-betsy_ross": "Betsy Ross, United States";
+    readonly an: "Netherlands Antilles";
+    readonly "aq-true_south": "Antarctica (True South), Antarctica";
+    readonly artsakh: "Artsakh";
+    readonly "au-aboriginal": "Australian Aboriginal, Australia";
+    readonly "au-torres_strait_islands": "Torres Strait Islands, Australia";
+    readonly "by-historical": "BY-HISTORICAL";
+    readonly cp: "Clipperton Island";
     readonly cq: "Sark";
-    readonly hmong: "Hmong";
-    readonly occitania: "Occitania";
-    readonly european_union: "European Union";
-    readonly "gb-nir": "Northern Ireland, United Kingdom";
-    readonly "us-confederate_battle": "Confederate battle, United States";
-    readonly un: "United Nations";
-    readonly kikuyu: "Kikuyu";
-    readonly "gb-wls": "Wales, United Kingdom";
-    readonly "fr-20r": "Corsica, France";
+    readonly dg: "Diego Garcia";
+    readonly ea: "Ceuta and Melilla";
     readonly east_african_federation: "East African Federation";
-    readonly xx: "<Placeholder>";
+    readonly easter_island: "Easter Island";
+    readonly "es-ct": "Catalonia, Spain";
+    readonly "es-ga": "Galicia, Spain";
     readonly "es-ib": "Balearic Islands, Spain";
-    readonly otomi: "Otomi";
-    readonly "au-torres_strait_islands": "Torres Strait Islands, Australia";
-    readonly "iq-kr": "Kurdistan, Iraq";
     readonly "es-pv": "Basque Country, Spain";
-    readonly soviet_union: "Soviet Union";
-    readonly an: "Netherlands Antilles";
+    readonly "es-variant": "Spain";
+    readonly "es-vc": "ES-VC";
     readonly "et-si": "Sidama, Ethiopia";
-    readonly sami: "Sami";
-    readonly quechua: "Quechua";
-    readonly artsakh: "Artsakh";
-    readonly northern_cyprus: "Northern Cyprus";
-    readonly yu: "Yugoslavia";
     readonly "et-sw": "South West Region, Ethiopia";
-    readonly kongo: "Kongo";
-    readonly maori: "Maori";
-    readonly easter_island: "Easter Island";
-    readonly "es-ct": "Catalonia, Spain";
-    readonly "es-ga": "Galicia, Spain";
+    readonly eu: "European Union";
+    readonly european_union: "European Union";
     readonly ewe: "Ewe";
-    readonly "tz-zanzibar": "Tanzania (Zanzibar), Tanzania";
-    readonly kanuri: "Kanuri";
-    readonly "mt-civil_ensign": "Malta (civil ensign), Malta";
+    readonly "fr-20r": "Corsica, France";
+    readonly fx: "Metropolitan France";
     readonly "gb-eng": "England, United Kingdom";
+    readonly "gb-nir": "Northern Ireland, United Kingdom";
     readonly "gb-sct": "Scotland, United Kingdom";
+    readonly "gb-wls": "Wales, United Kingdom";
+    readonly guarani: "Guarani";
+    readonly hausa: "Hausa";
+    readonly hmong: "Hmong";
+    readonly ic: "Canary Islands";
+    readonly "iq-kr": "Kurdistan, Iraq";
+    readonly kanuri: "Kanuri";
+    readonly kikuyu: "Kikuyu";
+    readonly kongo: "Kongo";
     readonly malayali: "Malayali";
-    readonly "ua-kpr": "Kursk People's Republic, Ukraine";
-    readonly south_ossetia: "South Ossetia";
-    readonly "ru-lpr": "Luhansk People's Republic, Russia";
+    readonly maori: "Maori";
+    readonly "mq-old": "Martinique, France";
+    readonly "mt-civil_ensign": "Malta (civil ensign), Malta";
+    readonly northern_cyprus: "Northern Cyprus";
+    readonly occitania: "Occitania";
+    readonly otomi: "Otomi";
+    readonly quechua: "Quechua";
     readonly "ru-dpr": "Donetsk People's Republic, Russia";
-    readonly "ua-bpr": "Belgorod People's Republic, Ukraine";
+    readonly "ru-lpr": "Luhansk People's Republic, Russia";
+    readonly sami: "Sami";
     readonly sealand: "Sealand";
-    readonly "aq-true_south": "Antarctica (True South), Antarctica";
-    readonly "au-aboriginal": "Australian Aboriginal, Australia";
-    readonly transnistria: "Transnistria";
-    readonly "es-variant": "Spain";
-    readonly "by-historical": "BY-HISTORICAL";
-    readonly ac: "Ascension Island";
-    readonly cp: "Clipperton Island";
-    readonly dg: "Diego Garcia";
-    readonly ea: "Ceuta and Melilla";
-    readonly eu: "European Union";
-    readonly fx: "Metropolitan France";
-    readonly ic: "Canary Islands";
     readonly sj: "Svalbard and Jan Mayen";
+    readonly somaliland: "Somaliland";
+    readonly south_ossetia: "South Ossetia";
+    readonly soviet_union: "Soviet Union";
     readonly su: "Soviet Union";
     readonly ta: "Tristan da Cunha";
+    readonly transnistria: "Transnistria";
+    readonly "tz-zanzibar": "Tanzania (Zanzibar), Tanzania";
+    readonly "ua-bpr": "Belgorod People's Republic, Ukraine";
+    readonly "ua-kpr": "Kursk People's Republic, Ukraine";
     readonly uk: "United Kingdom";
+    readonly un: "United Nations";
+    readonly "us-betsy_ross": "Betsy Ross, United States";
+    readonly "us-confederate_battle": "Confederate battle, United States";
     readonly "us-um": "U.S. Minor Outlying Islands, United States";
+    readonly wiphala: "Wiphala";
+    readonly xx: "<Placeholder>";
+    readonly yorubaland: "Yorubaland";
+    readonly yu: "Yugoslavia";
 };
 declare const SUBDIVISION_NAMES: {
     readonly "af-bds": {
@@ -34501,4 +34505,6 @@ declare const SUBDIVISION_NAMES: {
     };
 };
 
-export { type BuildMeta, COUNTRY_NAMES, FLAG_ALIASES, FLAG_REGISTRY, type FlagCode, type FlagComponentProps, type FlagMetadata, type FlagSizeName, FlagSizes, SUBDIVISION_NAMES, codeToComponentName, codeToEmoji, getSizeName };
+type CountryCode = FlagCode;
+
+export { type BuildMeta, COUNTRY_NAMES, type CountryCode, FLAG_ALIASES, FLAG_REGISTRY, type FlagCode, type FlagComponentProps, type FlagMetadata, type FlagSizeName, FlagSizes, SUBDIVISION_NAMES, codeToComponentName, codeToEmoji, coerceFlagCode, getSizeName, isFlagCode };