@innovayse/geo-atlas 2.0.2 → 2.1.0

package/dist/esm/helpers/CountriesAtlas.d.ts

@@ -41,7 +41,11 @@ export declare class CountriesAtlas {
      */
     getStates(iso2: string): State[] | undefined;
     /**
-     * Retrieve all states of a country by its ISO2 code using dynamic import (browser-compatible).
+     * Retrieve all states of a country by its ISO2 code using a static loader registry.
+     *
+     * Uses explicit string-literal dynamic imports (via countryLoaders) so bundlers
+     * such as Vite, webpack, and rollup can statically analyze paths and code-split
+     * country data. Works in both Node.js (CJS/ESM) and browser environments.
      *
      * @param {string} iso2 - ISO2 code of the country.
      * @returns {Promise<State[]>} - Promise resolving to array of state objects.

package/dist/esm/helpers/CountriesAtlas.js

@@ -8,6 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import countriesData from '../data/atlas.json';
+import countryLoaders from './countryLoaders';
 /**
  * Main helper class for querying countries, states, cities, timezones,
  * calling codes and currencies from the offline geo-atlas dataset.
@@ -87,7 +88,11 @@ export class CountriesAtlas {
         return undefined;
     }
     /**
-     * Retrieve all states of a country by its ISO2 code using dynamic import (browser-compatible).
+     * Retrieve all states of a country by its ISO2 code using a static loader registry.
+     *
+     * Uses explicit string-literal dynamic imports (via countryLoaders) so bundlers
+     * such as Vite, webpack, and rollup can statically analyze paths and code-split
+     * country data. Works in both Node.js (CJS/ESM) and browser environments.
      *
      * @param {string} iso2 - ISO2 code of the country.
      * @returns {Promise<State[]>} - Promise resolving to array of state objects.
@@ -96,10 +101,13 @@ export class CountriesAtlas {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
             const country = this.find(iso2);
-            if (!country || !country.iso2)
+            if (!(country === null || country === void 0 ? void 0 : country.iso2))
+                return [];
+            const loader = countryLoaders[country.iso2.toLowerCase()];
+            if (!loader)
                 return [];
             try {
-                const mod = yield import(`../data/countries/${country.iso2.toLowerCase()}.json`);
+                const mod = yield loader();
                 const data = (_a = mod.default) !== null && _a !== void 0 ? _a : mod;
                 return (_b = data.states) !== null && _b !== void 0 ? _b : [];
             }
@@ -176,7 +184,7 @@ export class CountriesAtlas {
      * @returns {PhoneCode[]} - Array of phone code objects.
      */
     getCallingCodes() {
-        return this.getCountries(['name', 'phone', 'iso2']).map(country => {
+        return this.getCountries(['name', 'phone', 'iso2', 'phone_format']).map(country => {
             var _a;
             return Object.assign(Object.assign({}, country), { phone_code: `+${country.phone}`, flag: `flag flag-${(_a = country.iso2) === null || _a === void 0 ? void 0 : _a.toLowerCase()}` });
         });
@@ -196,7 +204,8 @@ export class CountriesAtlas {
                 phone: country.phone,
                 iso2: country.iso2,
                 phone_code: `+${country.phone}`,
-                flag: `flag flag-${(_a = country.iso2) === null || _a === void 0 ? void 0 : _a.toLowerCase()}`
+                flag: `flag flag-${(_a = country.iso2) === null || _a === void 0 ? void 0 : _a.toLowerCase()}`,
+                phone_format: country.phone_format
             };
         }
         return undefined;

package/dist/esm/helpers/countryLoaders.d.ts

@@ -0,0 +1,17 @@
+import type { State } from '../types/state.interface';
+/**
+ * Auto-generated static loader registry for per-country state/city data.
+ *
+ * Each entry uses an explicit string-literal dynamic import path, allowing
+ * bundlers (Vite, webpack, rollup) to statically analyze, bundle, and
+ * code-split country data. DO NOT EDIT MANUALLY.
+ *
+ * Regenerate with: npm run generate:loaders
+ */
+declare const countryLoaders: Record<string, () => Promise<{
+    default?: {
+        states: State[];
+    };
+    states?: State[];
+}>>;
+export default countryLoaders;

package/dist/esm/helpers/countryLoaders.js

@@ -0,0 +1,262 @@
+/**
+ * Auto-generated static loader registry for per-country state/city data.
+ *
+ * Each entry uses an explicit string-literal dynamic import path, allowing
+ * bundlers (Vite, webpack, rollup) to statically analyze, bundle, and
+ * code-split country data. DO NOT EDIT MANUALLY.
+ *
+ * Regenerate with: npm run generate:loaders
+ */
+const countryLoaders = {
+    'ad': () => import('../data/countries/ad.json'),
+    'ae': () => import('../data/countries/ae.json'),
+    'af': () => import('../data/countries/af.json'),
+    'ag': () => import('../data/countries/ag.json'),
+    'ai': () => import('../data/countries/ai.json'),
+    'al': () => import('../data/countries/al.json'),
+    'am': () => import('../data/countries/am.json'),
+    'ao': () => import('../data/countries/ao.json'),
+    'aq': () => import('../data/countries/aq.json'),
+    'ar': () => import('../data/countries/ar.json'),
+    'as': () => import('../data/countries/as.json'),
+    'at': () => import('../data/countries/at.json'),
+    'au': () => import('../data/countries/au.json'),
+    'aw': () => import('../data/countries/aw.json'),
+    'ax': () => import('../data/countries/ax.json'),
+    'az': () => import('../data/countries/az.json'),
+    'ba': () => import('../data/countries/ba.json'),
+    'bb': () => import('../data/countries/bb.json'),
+    'bd': () => import('../data/countries/bd.json'),
+    'be': () => import('../data/countries/be.json'),
+    'bf': () => import('../data/countries/bf.json'),
+    'bg': () => import('../data/countries/bg.json'),
+    'bh': () => import('../data/countries/bh.json'),
+    'bi': () => import('../data/countries/bi.json'),
+    'bj': () => import('../data/countries/bj.json'),
+    'bl': () => import('../data/countries/bl.json'),
+    'bm': () => import('../data/countries/bm.json'),
+    'bn': () => import('../data/countries/bn.json'),
+    'bo': () => import('../data/countries/bo.json'),
+    'bq': () => import('../data/countries/bq.json'),
+    'br': () => import('../data/countries/br.json'),
+    'bs': () => import('../data/countries/bs.json'),
+    'bt': () => import('../data/countries/bt.json'),
+    'bv': () => import('../data/countries/bv.json'),
+    'bw': () => import('../data/countries/bw.json'),
+    'by': () => import('../data/countries/by.json'),
+    'bz': () => import('../data/countries/bz.json'),
+    'ca': () => import('../data/countries/ca.json'),
+    'cc': () => import('../data/countries/cc.json'),
+    'cd': () => import('../data/countries/cd.json'),
+    'cf': () => import('../data/countries/cf.json'),
+    'cg': () => import('../data/countries/cg.json'),
+    'ch': () => import('../data/countries/ch.json'),
+    'ci': () => import('../data/countries/ci.json'),
+    'ck': () => import('../data/countries/ck.json'),
+    'cl': () => import('../data/countries/cl.json'),
+    'cm': () => import('../data/countries/cm.json'),
+    'cn': () => import('../data/countries/cn.json'),
+    'co': () => import('../data/countries/co.json'),
+    'cr': () => import('../data/countries/cr.json'),
+    'cu': () => import('../data/countries/cu.json'),
+    'cv': () => import('../data/countries/cv.json'),
+    'cw': () => import('../data/countries/cw.json'),
+    'cx': () => import('../data/countries/cx.json'),
+    'cy': () => import('../data/countries/cy.json'),
+    'cz': () => import('../data/countries/cz.json'),
+    'de': () => import('../data/countries/de.json'),
+    'dj': () => import('../data/countries/dj.json'),
+    'dk': () => import('../data/countries/dk.json'),
+    'dm': () => import('../data/countries/dm.json'),
+    'do': () => import('../data/countries/do.json'),
+    'dz': () => import('../data/countries/dz.json'),
+    'ec': () => import('../data/countries/ec.json'),
+    'ee': () => import('../data/countries/ee.json'),
+    'eg': () => import('../data/countries/eg.json'),
+    'eh': () => import('../data/countries/eh.json'),
+    'er': () => import('../data/countries/er.json'),
+    'es': () => import('../data/countries/es.json'),
+    'et': () => import('../data/countries/et.json'),
+    'fi': () => import('../data/countries/fi.json'),
+    'fj': () => import('../data/countries/fj.json'),
+    'fk': () => import('../data/countries/fk.json'),
+    'fm': () => import('../data/countries/fm.json'),
+    'fo': () => import('../data/countries/fo.json'),
+    'fr': () => import('../data/countries/fr.json'),
+    'ga': () => import('../data/countries/ga.json'),
+    'gb': () => import('../data/countries/gb.json'),
+    'gd': () => import('../data/countries/gd.json'),
+    'ge': () => import('../data/countries/ge.json'),
+    'gf': () => import('../data/countries/gf.json'),
+    'gg': () => import('../data/countries/gg.json'),
+    'gh': () => import('../data/countries/gh.json'),
+    'gi': () => import('../data/countries/gi.json'),
+    'gl': () => import('../data/countries/gl.json'),
+    'gm': () => import('../data/countries/gm.json'),
+    'gn': () => import('../data/countries/gn.json'),
+    'gp': () => import('../data/countries/gp.json'),
+    'gq': () => import('../data/countries/gq.json'),
+    'gr': () => import('../data/countries/gr.json'),
+    'gs': () => import('../data/countries/gs.json'),
+    'gt': () => import('../data/countries/gt.json'),
+    'gu': () => import('../data/countries/gu.json'),
+    'gw': () => import('../data/countries/gw.json'),
+    'gy': () => import('../data/countries/gy.json'),
+    'hk': () => import('../data/countries/hk.json'),
+    'hm': () => import('../data/countries/hm.json'),
+    'hn': () => import('../data/countries/hn.json'),
+    'hr': () => import('../data/countries/hr.json'),
+    'ht': () => import('../data/countries/ht.json'),
+    'hu': () => import('../data/countries/hu.json'),
+    'id': () => import('../data/countries/id.json'),
+    'ie': () => import('../data/countries/ie.json'),
+    'il': () => import('../data/countries/il.json'),
+    'im': () => import('../data/countries/im.json'),
+    'in': () => import('../data/countries/in.json'),
+    'io': () => import('../data/countries/io.json'),
+    'iq': () => import('../data/countries/iq.json'),
+    'ir': () => import('../data/countries/ir.json'),
+    'is': () => import('../data/countries/is.json'),
+    'it': () => import('../data/countries/it.json'),
+    'je': () => import('../data/countries/je.json'),
+    'jm': () => import('../data/countries/jm.json'),
+    'jo': () => import('../data/countries/jo.json'),
+    'jp': () => import('../data/countries/jp.json'),
+    'ke': () => import('../data/countries/ke.json'),
+    'kg': () => import('../data/countries/kg.json'),
+    'kh': () => import('../data/countries/kh.json'),
+    'ki': () => import('../data/countries/ki.json'),
+    'km': () => import('../data/countries/km.json'),
+    'kn': () => import('../data/countries/kn.json'),
+    'kp': () => import('../data/countries/kp.json'),
+    'kr': () => import('../data/countries/kr.json'),
+    'kw': () => import('../data/countries/kw.json'),
+    'ky': () => import('../data/countries/ky.json'),
+    'kz': () => import('../data/countries/kz.json'),
+    'la': () => import('../data/countries/la.json'),
+    'lb': () => import('../data/countries/lb.json'),
+    'lc': () => import('../data/countries/lc.json'),
+    'li': () => import('../data/countries/li.json'),
+    'lk': () => import('../data/countries/lk.json'),
+    'lr': () => import('../data/countries/lr.json'),
+    'ls': () => import('../data/countries/ls.json'),
+    'lt': () => import('../data/countries/lt.json'),
+    'lu': () => import('../data/countries/lu.json'),
+    'lv': () => import('../data/countries/lv.json'),
+    'ly': () => import('../data/countries/ly.json'),
+    'ma': () => import('../data/countries/ma.json'),
+    'mc': () => import('../data/countries/mc.json'),
+    'md': () => import('../data/countries/md.json'),
+    'me': () => import('../data/countries/me.json'),
+    'mf': () => import('../data/countries/mf.json'),
+    'mg': () => import('../data/countries/mg.json'),
+    'mh': () => import('../data/countries/mh.json'),
+    'mk': () => import('../data/countries/mk.json'),
+    'ml': () => import('../data/countries/ml.json'),
+    'mm': () => import('../data/countries/mm.json'),
+    'mn': () => import('../data/countries/mn.json'),
+    'mo': () => import('../data/countries/mo.json'),
+    'mp': () => import('../data/countries/mp.json'),
+    'mq': () => import('../data/countries/mq.json'),
+    'mr': () => import('../data/countries/mr.json'),
+    'ms': () => import('../data/countries/ms.json'),
+    'mt': () => import('../data/countries/mt.json'),
+    'mu': () => import('../data/countries/mu.json'),
+    'mv': () => import('../data/countries/mv.json'),
+    'mw': () => import('../data/countries/mw.json'),
+    'mx': () => import('../data/countries/mx.json'),
+    'my': () => import('../data/countries/my.json'),
+    'mz': () => import('../data/countries/mz.json'),
+    'na': () => import('../data/countries/na.json'),
+    'nc': () => import('../data/countries/nc.json'),
+    'ne': () => import('../data/countries/ne.json'),
+    'nf': () => import('../data/countries/nf.json'),
+    'ng': () => import('../data/countries/ng.json'),
+    'ni': () => import('../data/countries/ni.json'),
+    'nl': () => import('../data/countries/nl.json'),
+    'no': () => import('../data/countries/no.json'),
+    'np': () => import('../data/countries/np.json'),
+    'nr': () => import('../data/countries/nr.json'),
+    'nu': () => import('../data/countries/nu.json'),
+    'nz': () => import('../data/countries/nz.json'),
+    'om': () => import('../data/countries/om.json'),
+    'pa': () => import('../data/countries/pa.json'),
+    'pe': () => import('../data/countries/pe.json'),
+    'pf': () => import('../data/countries/pf.json'),
+    'pg': () => import('../data/countries/pg.json'),
+    'ph': () => import('../data/countries/ph.json'),
+    'pk': () => import('../data/countries/pk.json'),
+    'pl': () => import('../data/countries/pl.json'),
+    'pm': () => import('../data/countries/pm.json'),
+    'pn': () => import('../data/countries/pn.json'),
+    'pr': () => import('../data/countries/pr.json'),
+    'ps': () => import('../data/countries/ps.json'),
+    'pt': () => import('../data/countries/pt.json'),
+    'pw': () => import('../data/countries/pw.json'),
+    'py': () => import('../data/countries/py.json'),
+    'qa': () => import('../data/countries/qa.json'),
+    're': () => import('../data/countries/re.json'),
+    'ro': () => import('../data/countries/ro.json'),
+    'rs': () => import('../data/countries/rs.json'),
+    'ru': () => import('../data/countries/ru.json'),
+    'rw': () => import('../data/countries/rw.json'),
+    'sa': () => import('../data/countries/sa.json'),
+    'sb': () => import('../data/countries/sb.json'),
+    'sc': () => import('../data/countries/sc.json'),
+    'sd': () => import('../data/countries/sd.json'),
+    'se': () => import('../data/countries/se.json'),
+    'sg': () => import('../data/countries/sg.json'),
+    'sh': () => import('../data/countries/sh.json'),
+    'si': () => import('../data/countries/si.json'),
+    'sj': () => import('../data/countries/sj.json'),
+    'sk': () => import('../data/countries/sk.json'),
+    'sl': () => import('../data/countries/sl.json'),
+    'sm': () => import('../data/countries/sm.json'),
+    'sn': () => import('../data/countries/sn.json'),
+    'so': () => import('../data/countries/so.json'),
+    'sr': () => import('../data/countries/sr.json'),
+    'ss': () => import('../data/countries/ss.json'),
+    'st': () => import('../data/countries/st.json'),
+    'sv': () => import('../data/countries/sv.json'),
+    'sx': () => import('../data/countries/sx.json'),
+    'sy': () => import('../data/countries/sy.json'),
+    'sz': () => import('../data/countries/sz.json'),
+    'tc': () => import('../data/countries/tc.json'),
+    'td': () => import('../data/countries/td.json'),
+    'tf': () => import('../data/countries/tf.json'),
+    'tg': () => import('../data/countries/tg.json'),
+    'th': () => import('../data/countries/th.json'),
+    'tj': () => import('../data/countries/tj.json'),
+    'tk': () => import('../data/countries/tk.json'),
+    'tl': () => import('../data/countries/tl.json'),
+    'tm': () => import('../data/countries/tm.json'),
+    'tn': () => import('../data/countries/tn.json'),
+    'to': () => import('../data/countries/to.json'),
+    'tr': () => import('../data/countries/tr.json'),
+    'tt': () => import('../data/countries/tt.json'),
+    'tv': () => import('../data/countries/tv.json'),
+    'tw': () => import('../data/countries/tw.json'),
+    'tz': () => import('../data/countries/tz.json'),
+    'ua': () => import('../data/countries/ua.json'),
+    'ug': () => import('../data/countries/ug.json'),
+    'um': () => import('../data/countries/um.json'),
+    'us': () => import('../data/countries/us.json'),
+    'uy': () => import('../data/countries/uy.json'),
+    'uz': () => import('../data/countries/uz.json'),
+    'va': () => import('../data/countries/va.json'),
+    'vc': () => import('../data/countries/vc.json'),
+    've': () => import('../data/countries/ve.json'),
+    'vg': () => import('../data/countries/vg.json'),
+    'vi': () => import('../data/countries/vi.json'),
+    'vn': () => import('../data/countries/vn.json'),
+    'vu': () => import('../data/countries/vu.json'),
+    'wf': () => import('../data/countries/wf.json'),
+    'ws': () => import('../data/countries/ws.json'),
+    'xk': () => import('../data/countries/xk.json'),
+    'ye': () => import('../data/countries/ye.json'),
+    'yt': () => import('../data/countries/yt.json'),
+    'za': () => import('../data/countries/za.json'),
+    'zm': () => import('../data/countries/zm.json'),
+    'zw': () => import('../data/countries/zw.json'),
+};
+export default countryLoaders;

package/dist/esm/types/country.interface.d.ts

@@ -42,5 +42,7 @@ export interface Country {
     emojiU?: string;
     /** Legacy code field (same as iso2 in some datasets). */
     code?: string;
+    /** Full international phone format placeholder with country code (e.g. "+374 9X XXX XXX"). */
+    phone_format?: string;
     [key: string]: any;
 }

package/dist/esm/types/phone-code.interface.d.ts

@@ -10,4 +10,6 @@ export interface PhoneCode {
     phone_code?: string;
     /** CSS flag class string (e.g. "flag flag-am"). */
     flag?: string;
+    /** Full international phone number format placeholder (e.g. "+374 9X XXX XXX"). */
+    phone_format?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@innovayse/geo-atlas",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "Offline countries, states and cities with multilingual support (EN/RU/HY + 15 languages).",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",