@webority-technologies/mobile-core 0.0.9 → 0.0.11

package/lib/module/phone/countries.js

@@ -0,0 +1,261 @@
+"use strict";
+
+/**
+ * English display names for every country libphonenumber-js knows, keyed by
+ * ISO 3166-1 alpha-2. GENERATED by scripts/gen-phone-countries.mjs from Node's
+ * Intl.DisplayNames('en', { type: 'region' }) over getCountries() on 2026-09-14;
+ * '&' is written as 'and'. Re-run the script rather than editing by hand.
+ *
+ * Lives on its own import path (mobile-core/phone/countries) so an app that
+ * never opens a full country list does not carry these 245 strings in its
+ * bundle. Pair with getPhoneCountries() from the package root for the calling
+ * codes; a country picker that needs another language supplies its own names.
+ */
+export const PHONE_COUNTRY_NAMES = {
+  AF: 'Afghanistan',
+  AX: 'Åland Islands',
+  AL: 'Albania',
+  DZ: 'Algeria',
+  AS: 'American Samoa',
+  AD: 'Andorra',
+  AO: 'Angola',
+  AI: 'Anguilla',
+  AG: 'Antigua and Barbuda',
+  AR: 'Argentina',
+  AM: 'Armenia',
+  AW: 'Aruba',
+  AC: 'Ascension Island',
+  AU: 'Australia',
+  AT: 'Austria',
+  AZ: 'Azerbaijan',
+  BS: 'Bahamas',
+  BH: 'Bahrain',
+  BD: 'Bangladesh',
+  BB: 'Barbados',
+  BY: 'Belarus',
+  BE: 'Belgium',
+  BZ: 'Belize',
+  BJ: 'Benin',
+  BM: 'Bermuda',
+  BT: 'Bhutan',
+  BO: 'Bolivia',
+  BA: 'Bosnia and Herzegovina',
+  BW: 'Botswana',
+  BR: 'Brazil',
+  IO: 'British Indian Ocean Territory',
+  VG: 'British Virgin Islands',
+  BN: 'Brunei',
+  BG: 'Bulgaria',
+  BF: 'Burkina Faso',
+  BI: 'Burundi',
+  KH: 'Cambodia',
+  CM: 'Cameroon',
+  CA: 'Canada',
+  CV: 'Cape Verde',
+  BQ: 'Caribbean Netherlands',
+  KY: 'Cayman Islands',
+  CF: 'Central African Republic',
+  TD: 'Chad',
+  CL: 'Chile',
+  CN: 'China',
+  CX: 'Christmas Island',
+  CC: 'Cocos (Keeling) Islands',
+  CO: 'Colombia',
+  KM: 'Comoros',
+  CG: 'Congo - Brazzaville',
+  CD: 'Congo - Kinshasa',
+  CK: 'Cook Islands',
+  CR: 'Costa Rica',
+  CI: 'Côte d’Ivoire',
+  HR: 'Croatia',
+  CU: 'Cuba',
+  CW: 'Curaçao',
+  CY: 'Cyprus',
+  CZ: 'Czechia',
+  DK: 'Denmark',
+  DJ: 'Djibouti',
+  DM: 'Dominica',
+  DO: 'Dominican Republic',
+  EC: 'Ecuador',
+  EG: 'Egypt',
+  SV: 'El Salvador',
+  GQ: 'Equatorial Guinea',
+  ER: 'Eritrea',
+  EE: 'Estonia',
+  SZ: 'Eswatini',
+  ET: 'Ethiopia',
+  FK: 'Falkland Islands',
+  FO: 'Faroe Islands',
+  FJ: 'Fiji',
+  FI: 'Finland',
+  FR: 'France',
+  GF: 'French Guiana',
+  PF: 'French Polynesia',
+  GA: 'Gabon',
+  GM: 'Gambia',
+  GE: 'Georgia',
+  DE: 'Germany',
+  GH: 'Ghana',
+  GI: 'Gibraltar',
+  GR: 'Greece',
+  GL: 'Greenland',
+  GD: 'Grenada',
+  GP: 'Guadeloupe',
+  GU: 'Guam',
+  GT: 'Guatemala',
+  GG: 'Guernsey',
+  GN: 'Guinea',
+  GW: 'Guinea-Bissau',
+  GY: 'Guyana',
+  HT: 'Haiti',
+  HN: 'Honduras',
+  HK: 'Hong Kong SAR China',
+  HU: 'Hungary',
+  IS: 'Iceland',
+  IN: 'India',
+  ID: 'Indonesia',
+  IR: 'Iran',
+  IQ: 'Iraq',
+  IE: 'Ireland',
+  IM: 'Isle of Man',
+  IL: 'Israel',
+  IT: 'Italy',
+  JM: 'Jamaica',
+  JP: 'Japan',
+  JE: 'Jersey',
+  JO: 'Jordan',
+  KZ: 'Kazakhstan',
+  KE: 'Kenya',
+  KI: 'Kiribati',
+  XK: 'Kosovo',
+  KW: 'Kuwait',
+  KG: 'Kyrgyzstan',
+  LA: 'Laos',
+  LV: 'Latvia',
+  LB: 'Lebanon',
+  LS: 'Lesotho',
+  LR: 'Liberia',
+  LY: 'Libya',
+  LI: 'Liechtenstein',
+  LT: 'Lithuania',
+  LU: 'Luxembourg',
+  MO: 'Macao SAR China',
+  MG: 'Madagascar',
+  MW: 'Malawi',
+  MY: 'Malaysia',
+  MV: 'Maldives',
+  ML: 'Mali',
+  MT: 'Malta',
+  MH: 'Marshall Islands',
+  MQ: 'Martinique',
+  MR: 'Mauritania',
+  MU: 'Mauritius',
+  YT: 'Mayotte',
+  MX: 'Mexico',
+  FM: 'Micronesia',
+  MD: 'Moldova',
+  MC: 'Monaco',
+  MN: 'Mongolia',
+  ME: 'Montenegro',
+  MS: 'Montserrat',
+  MA: 'Morocco',
+  MZ: 'Mozambique',
+  MM: 'Myanmar (Burma)',
+  NA: 'Namibia',
+  NR: 'Nauru',
+  NP: 'Nepal',
+  NL: 'Netherlands',
+  NC: 'New Caledonia',
+  NZ: 'New Zealand',
+  NI: 'Nicaragua',
+  NE: 'Niger',
+  NG: 'Nigeria',
+  NU: 'Niue',
+  NF: 'Norfolk Island',
+  KP: 'North Korea',
+  MK: 'North Macedonia',
+  MP: 'Northern Mariana Islands',
+  NO: 'Norway',
+  OM: 'Oman',
+  PK: 'Pakistan',
+  PW: 'Palau',
+  PS: 'Palestinian Territories',
+  PA: 'Panama',
+  PG: 'Papua New Guinea',
+  PY: 'Paraguay',
+  PE: 'Peru',
+  PH: 'Philippines',
+  PL: 'Poland',
+  PT: 'Portugal',
+  PR: 'Puerto Rico',
+  QA: 'Qatar',
+  RE: 'Réunion',
+  RO: 'Romania',
+  RU: 'Russia',
+  RW: 'Rwanda',
+  WS: 'Samoa',
+  SM: 'San Marino',
+  ST: 'São Tomé and Príncipe',
+  SA: 'Saudi Arabia',
+  SN: 'Senegal',
+  RS: 'Serbia',
+  SC: 'Seychelles',
+  SL: 'Sierra Leone',
+  SG: 'Singapore',
+  SX: 'Sint Maarten',
+  SK: 'Slovakia',
+  SI: 'Slovenia',
+  SB: 'Solomon Islands',
+  SO: 'Somalia',
+  ZA: 'South Africa',
+  KR: 'South Korea',
+  SS: 'South Sudan',
+  ES: 'Spain',
+  LK: 'Sri Lanka',
+  BL: 'St. Barthélemy',
+  SH: 'St. Helena',
+  KN: 'St. Kitts and Nevis',
+  LC: 'St. Lucia',
+  MF: 'St. Martin',
+  PM: 'St. Pierre and Miquelon',
+  VC: 'St. Vincent and Grenadines',
+  SD: 'Sudan',
+  SR: 'Suriname',
+  SJ: 'Svalbard and Jan Mayen',
+  SE: 'Sweden',
+  CH: 'Switzerland',
+  SY: 'Syria',
+  TW: 'Taiwan',
+  TJ: 'Tajikistan',
+  TZ: 'Tanzania',
+  TH: 'Thailand',
+  TL: 'Timor-Leste',
+  TG: 'Togo',
+  TK: 'Tokelau',
+  TO: 'Tonga',
+  TT: 'Trinidad and Tobago',
+  TA: 'Tristan da Cunha',
+  TN: 'Tunisia',
+  TR: 'Türkiye',
+  TM: 'Turkmenistan',
+  TC: 'Turks and Caicos Islands',
+  TV: 'Tuvalu',
+  VI: 'U.S. Virgin Islands',
+  UG: 'Uganda',
+  UA: 'Ukraine',
+  AE: 'United Arab Emirates',
+  GB: 'United Kingdom',
+  US: 'United States',
+  UY: 'Uruguay',
+  UZ: 'Uzbekistan',
+  VU: 'Vanuatu',
+  VA: 'Vatican City',
+  VE: 'Venezuela',
+  VN: 'Vietnam',
+  WF: 'Wallis and Futuna',
+  EH: 'Western Sahara',
+  YE: 'Yemen',
+  ZM: 'Zambia',
+  ZW: 'Zimbabwe'
+};
+//# sourceMappingURL=countries.js.map

package/lib/typescript/commonjs/formatters/index.d.ts

@@ -5,6 +5,6 @@ export { formatDate, formatDateTime, formatRelativeTime, formatTime } from './da
 export { addDays, diffMs, formatDateDDMMMYYYY, formatDateISO, formatDatePattern, formatTime12h, formatTimeInWindowsZone, formatTimeInZone, isDateAfter, isDateBefore, isSameDay, startOfDay } from './dateMath';
 export { getInitials } from './initials';
 export { formatCompactNumber, formatNumber, formatPercent } from './number';
-export type { FormatPhoneOptions, PhoneCountry, PhoneNumber } from './phone';
-export { detectPhoneCountry, formatPhone, isValidPhoneNumber, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString } from './phone';
+export type { FormatPhoneOptions, PhoneCountry, PhoneCountryEntry, PhoneNumber, PhoneNumberType, PhoneParts, PhoneValidationKind } from './phone';
+export { AsYouType, clampNationalNumber, countryFlagEmoji, detectPhoneCountry, formatPhone, formatPhoneAsTyped, getCountries, getCountryCallingCode, getPhoneCountries, isSupportedCountry, isValidNationalNumber, isValidPhoneNumber, maxNationalNumberLength, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString, splitPhoneNumber, validatePhoneNumberLength } from './phone';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/formatters/phone.d.ts

@@ -1,13 +1,6 @@
-/**
- * The bare 'libphonenumber-js' entry point actually resolves to the library's
- * OWN slimmed-down min/ metadata internally, not its full data - './max' is
- * the variant with complete per-country metadata. Since the reason this
- * module exists is validation and formatting accuracy, the more accurate
- * variant wins throughout this file, not just for validation.
- */
 import { type CountryCode } from 'libphonenumber-js/max';
-export type { PhoneNumber } from 'libphonenumber-js/max';
-export { isValidPhoneNumber, parsePhoneNumber, parsePhoneNumberFromString } from 'libphonenumber-js/max';
+export type { NumberType as PhoneNumberType, PhoneNumber } from 'libphonenumber-js/max';
+export { AsYouType, getCountries, getCountryCallingCode, isSupportedCountry, isValidPhoneNumber, parsePhoneNumber, parsePhoneNumberFromString, validatePhoneNumberLength } from 'libphonenumber-js/max';
 /**
  * Re-exported under our own name rather than importing CountryCode directly
  * everywhere, so a future need to diverge (or re-narrow) has one place to do
@@ -47,4 +40,94 @@ export declare const detectPhoneCountry: (input: string, defaultCountryCode?: st
  */
 export declare function formatPhone(input: string, defaultCountryCode?: string): string;
 export declare function formatPhone(input: string, options?: FormatPhoneOptions): string;
+/** Country calling code + national digits, the way a phone field stores them. */
+export interface PhoneParts {
+    /** ISO 3166-1 alpha-2 of the country the number belongs to, when it can be told. */
+    country: PhoneCountry | null;
+    /** Dial prefix WITHOUT the plus, e.g. '91'. */
+    callingCode: string;
+    /** National digits only, no prefix, no formatting. */
+    nationalNumber: string;
+}
+/**
+ * Which kinds of number count as valid. `'any'` is libphonenumber's own
+ * answer (a fixed line passes). `'mobile'` narrows to MOBILE and
+ * FIXED_LINE_OR_MOBILE, which is what an OTP or WhatsApp field wants: in India
+ * a 10-digit number starting with 1 to 5 is a real fixed line and passes
+ * `'any'`, but no SMS will ever reach it.
+ */
+export type PhoneValidationKind = 'any' | 'mobile';
+/**
+ * Split a typed or pasted number into calling code + national digits.
+ * `'+919876543210'` resolves to IN / 91 / 9876543210 from its own prefix; a
+ * bare `'9876543210'` needs `defaultCountry` to resolve at all. Returns null
+ * when the input has no digits or no country can be told. A shared calling
+ * code (`+1` for US and CA) resolves to the country whose area code matches,
+ * which is why the country comes back as part of the answer rather than being
+ * looked up again from the code.
+ */
+export declare const splitPhoneNumber: (input: string, defaultCountry?: PhoneCountry) => PhoneParts | null;
+/**
+ * Cut national digits that run past the longest number the country's plan
+ * allows, so a field stops accepting the impossible without a per-country
+ * length table. This is the PLAN's ceiling, not a mobile number's: India runs
+ * to 13 digits (toll-free 1800 numbers), the US to 10, Germany to 15. A field
+ * that should stop where a subscriber's number ends asks
+ * `maxNationalNumberLength` instead. Digits within range, including a number
+ * still too short, pass through untouched.
+ */
+export declare const clampNationalNumber: (nationalDigits: string, country: PhoneCountry) => string;
+/**
+ * The most national digits a subscriber's number can have in a country, so a
+ * field can refuse the next digit as it is typed rather than trimming after.
+ * `'any'` (default) covers mobile and fixed lines, `'mobile'` mobiles only: India
+ * is 10 either way (its plan's 13 belongs to toll-free numbers), Germany is 15
+ * for `'any'` and 11 for `'mobile'`, the UAE 9. A country whose metadata lists
+ * no lengths by type falls back to the plan's longest number.
+ */
+export declare const maxNationalNumberLength: (country: PhoneCountry, kind?: PhoneValidationKind) => number;
+/**
+ * National digits grouped the way the country writes them, updated on every
+ * keystroke: `'98765'` for IN is `'98765'`, `'9876543210'` is `'98765 43210'`,
+ * `'2025550123'` for US is `'(202) 555-0123'`. Output is for display only; the
+ * digits are what a value stores. Digits past the plan's longest possible
+ * number are dropped first, so an overflowing paste never formats as a longer
+ * number; digits that fit no pattern come back ungrouped rather than forced
+ * into a shape.
+ *
+ * Countries that write a leading 0 (the UAE, the UK, Australia, Saudi Arabia)
+ * only group in national mode when that 0 is typed, and a value never holds
+ * it. When national mode hands the digits back untouched, the grouping comes
+ * from the international form with the calling code removed: `'501234567'`
+ * for AE is `'50 123 4567'`. Countries that group nationally are unaffected.
+ */
+export declare const formatPhoneAsTyped: (nationalDigits: string, country: PhoneCountry) => string;
+/**
+ * Whether national digits form a real number for the country, by the
+ * country's own numbering plan rather than a length check. `kind: 'mobile'`
+ * additionally rejects fixed lines; a number whose type the metadata cannot
+ * tell is accepted, since the metadata, not the number, is what is missing.
+ */
+export declare const isValidNationalNumber: (nationalDigits: string, country: PhoneCountry, kind?: PhoneValidationKind) => boolean;
+/**
+ * The flag as an emoji built from the ISO code's two regional-indicator
+ * letters, so no font asset ships with the library: iOS and Android both draw
+ * these from the system font. An unknown or malformed code returns ''. (Windows
+ * browsers render the two letters instead of a flag; that is the platform, not
+ * the code.)
+ */
+export declare const countryFlagEmoji: (iso: string) => string;
+/** Calling code + ISO for one country, the shape a country picker lists. */
+export interface PhoneCountryEntry {
+    iso: PhoneCountry;
+    /** Dial prefix WITHOUT the plus, e.g. '91'. */
+    callingCode: string;
+}
+/**
+ * Every country libphonenumber-js knows, with its calling code, in metadata
+ * order. Names are deliberately not here: they are display data, in one
+ * language, and live on their own import path (`mobile-core/phone/countries`)
+ * so an app that never opens a full country list does not carry them.
+ */
+export declare const getPhoneCountries: () => ReadonlyArray<PhoneCountryEntry>;
 //# sourceMappingURL=phone.d.ts.map

package/lib/typescript/commonjs/index.d.ts

@@ -12,6 +12,10 @@
  *   @webority-technologies/mobile-core/download     a filesystem module
  *   @webority-technologies/mobile-core/smsRetriever Android only, own TurboModule
  *
+ * One more path is separate for size, not for a native package:
+ *
+ *   @webority-technologies/mobile-core/phone/countries  245 English country names
+ *
  * react-native-keychain is the exception and is a REQUIRED peer: the HTTP client
  * reads the bearer token, so it is reachable from the main barrel by design.
  */
@@ -29,8 +33,8 @@ export type { Config, Environment, LogLevel } from './config';
 export { getConfig, getConfigValue, resetConfig, setConfig } from './config';
 export type { DeepLinkConfig, DeepLinkRoute, ParsedLink } from './deepLink';
 export { DeepLink, parseDeepLink, useDeepLink } from './deepLink';
-export type { DateInput, DateStyle, FormatCurrencyOptions, FormatPhoneOptions, PhoneCountry, PhoneNumber, TimeStyle } from './formatters';
-export { addDays, detectPhoneCountry, diffMs, formatCompactNumber, formatCurrency, formatDate, formatDateDDMMMYYYY, formatDateISO, formatDatePattern, formatDateTime, formatNumber, formatPercent, formatPhone, formatRelativeTime, formatTime, formatTime12h, formatTimeInWindowsZone, formatTimeInZone, getInitials, isDateAfter, isDateBefore, isSameDay, isValidPhoneNumber, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString, startOfDay } from './formatters';
+export type { DateInput, DateStyle, FormatCurrencyOptions, FormatPhoneOptions, PhoneCountry, PhoneCountryEntry, PhoneNumber, PhoneNumberType, PhoneParts, PhoneValidationKind, TimeStyle } from './formatters';
+export { AsYouType, addDays, clampNationalNumber, countryFlagEmoji, detectPhoneCountry, diffMs, formatCompactNumber, formatCurrency, formatDate, formatDateDDMMMYYYY, formatDateISO, formatDatePattern, formatDateTime, formatNumber, formatPercent, formatPhone, formatPhoneAsTyped, formatRelativeTime, formatTime, formatTime12h, formatTimeInWindowsZone, formatTimeInZone, getCountries, getCountryCallingCode, getInitials, getPhoneCountries, isDateAfter, isDateBefore, isSameDay, isSupportedCountry, isValidNationalNumber, isValidPhoneNumber, maxNationalNumberLength, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString, splitPhoneNumber, startOfDay, validatePhoneNumberLength } from './formatters';
 export type { InitConfig } from './initSDK';
 export { initWebority } from './initSDK';
 export type { AuthActions } from './initUserAuth';

package/lib/typescript/commonjs/phone/countries.d.ts

@@ -0,0 +1,13 @@
+/**
+ * English display names for every country libphonenumber-js knows, keyed by
+ * ISO 3166-1 alpha-2. GENERATED by scripts/gen-phone-countries.mjs from Node's
+ * Intl.DisplayNames('en', { type: 'region' }) over getCountries() on 2026-09-14;
+ * '&' is written as 'and'. Re-run the script rather than editing by hand.
+ *
+ * Lives on its own import path (mobile-core/phone/countries) so an app that
+ * never opens a full country list does not carry these 245 strings in its
+ * bundle. Pair with getPhoneCountries() from the package root for the calling
+ * codes; a country picker that needs another language supplies its own names.
+ */
+export declare const PHONE_COUNTRY_NAMES: Readonly<Record<string, string>>;
+//# sourceMappingURL=countries.d.ts.map

package/lib/typescript/module/formatters/index.d.ts

@@ -5,6 +5,6 @@ export { formatDate, formatDateTime, formatRelativeTime, formatTime } from './da
 export { addDays, diffMs, formatDateDDMMMYYYY, formatDateISO, formatDatePattern, formatTime12h, formatTimeInWindowsZone, formatTimeInZone, isDateAfter, isDateBefore, isSameDay, startOfDay } from './dateMath.js';
 export { getInitials } from './initials.js';
 export { formatCompactNumber, formatNumber, formatPercent } from './number.js';
-export type { FormatPhoneOptions, PhoneCountry, PhoneNumber } from './phone.js';
-export { detectPhoneCountry, formatPhone, isValidPhoneNumber, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString } from './phone.js';
+export type { FormatPhoneOptions, PhoneCountry, PhoneCountryEntry, PhoneNumber, PhoneNumberType, PhoneParts, PhoneValidationKind } from './phone.js';
+export { AsYouType, clampNationalNumber, countryFlagEmoji, detectPhoneCountry, formatPhone, formatPhoneAsTyped, getCountries, getCountryCallingCode, getPhoneCountries, isSupportedCountry, isValidNationalNumber, isValidPhoneNumber, maxNationalNumberLength, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString, splitPhoneNumber, validatePhoneNumberLength } from './phone.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/formatters/phone.d.ts

@@ -1,13 +1,6 @@
-/**
- * The bare 'libphonenumber-js' entry point actually resolves to the library's
- * OWN slimmed-down min/ metadata internally, not its full data - './max' is
- * the variant with complete per-country metadata. Since the reason this
- * module exists is validation and formatting accuracy, the more accurate
- * variant wins throughout this file, not just for validation.
- */
 import { type CountryCode } from 'libphonenumber-js/max';
-export type { PhoneNumber } from 'libphonenumber-js/max';
-export { isValidPhoneNumber, parsePhoneNumber, parsePhoneNumberFromString } from 'libphonenumber-js/max';
+export type { NumberType as PhoneNumberType, PhoneNumber } from 'libphonenumber-js/max';
+export { AsYouType, getCountries, getCountryCallingCode, isSupportedCountry, isValidPhoneNumber, parsePhoneNumber, parsePhoneNumberFromString, validatePhoneNumberLength } from 'libphonenumber-js/max';
 /**
  * Re-exported under our own name rather than importing CountryCode directly
  * everywhere, so a future need to diverge (or re-narrow) has one place to do
@@ -47,4 +40,94 @@ export declare const detectPhoneCountry: (input: string, defaultCountryCode?: st
  */
 export declare function formatPhone(input: string, defaultCountryCode?: string): string;
 export declare function formatPhone(input: string, options?: FormatPhoneOptions): string;
+/** Country calling code + national digits, the way a phone field stores them. */
+export interface PhoneParts {
+    /** ISO 3166-1 alpha-2 of the country the number belongs to, when it can be told. */
+    country: PhoneCountry | null;
+    /** Dial prefix WITHOUT the plus, e.g. '91'. */
+    callingCode: string;
+    /** National digits only, no prefix, no formatting. */
+    nationalNumber: string;
+}
+/**
+ * Which kinds of number count as valid. `'any'` is libphonenumber's own
+ * answer (a fixed line passes). `'mobile'` narrows to MOBILE and
+ * FIXED_LINE_OR_MOBILE, which is what an OTP or WhatsApp field wants: in India
+ * a 10-digit number starting with 1 to 5 is a real fixed line and passes
+ * `'any'`, but no SMS will ever reach it.
+ */
+export type PhoneValidationKind = 'any' | 'mobile';
+/**
+ * Split a typed or pasted number into calling code + national digits.
+ * `'+919876543210'` resolves to IN / 91 / 9876543210 from its own prefix; a
+ * bare `'9876543210'` needs `defaultCountry` to resolve at all. Returns null
+ * when the input has no digits or no country can be told. A shared calling
+ * code (`+1` for US and CA) resolves to the country whose area code matches,
+ * which is why the country comes back as part of the answer rather than being
+ * looked up again from the code.
+ */
+export declare const splitPhoneNumber: (input: string, defaultCountry?: PhoneCountry) => PhoneParts | null;
+/**
+ * Cut national digits that run past the longest number the country's plan
+ * allows, so a field stops accepting the impossible without a per-country
+ * length table. This is the PLAN's ceiling, not a mobile number's: India runs
+ * to 13 digits (toll-free 1800 numbers), the US to 10, Germany to 15. A field
+ * that should stop where a subscriber's number ends asks
+ * `maxNationalNumberLength` instead. Digits within range, including a number
+ * still too short, pass through untouched.
+ */
+export declare const clampNationalNumber: (nationalDigits: string, country: PhoneCountry) => string;
+/**
+ * The most national digits a subscriber's number can have in a country, so a
+ * field can refuse the next digit as it is typed rather than trimming after.
+ * `'any'` (default) covers mobile and fixed lines, `'mobile'` mobiles only: India
+ * is 10 either way (its plan's 13 belongs to toll-free numbers), Germany is 15
+ * for `'any'` and 11 for `'mobile'`, the UAE 9. A country whose metadata lists
+ * no lengths by type falls back to the plan's longest number.
+ */
+export declare const maxNationalNumberLength: (country: PhoneCountry, kind?: PhoneValidationKind) => number;
+/**
+ * National digits grouped the way the country writes them, updated on every
+ * keystroke: `'98765'` for IN is `'98765'`, `'9876543210'` is `'98765 43210'`,
+ * `'2025550123'` for US is `'(202) 555-0123'`. Output is for display only; the
+ * digits are what a value stores. Digits past the plan's longest possible
+ * number are dropped first, so an overflowing paste never formats as a longer
+ * number; digits that fit no pattern come back ungrouped rather than forced
+ * into a shape.
+ *
+ * Countries that write a leading 0 (the UAE, the UK, Australia, Saudi Arabia)
+ * only group in national mode when that 0 is typed, and a value never holds
+ * it. When national mode hands the digits back untouched, the grouping comes
+ * from the international form with the calling code removed: `'501234567'`
+ * for AE is `'50 123 4567'`. Countries that group nationally are unaffected.
+ */
+export declare const formatPhoneAsTyped: (nationalDigits: string, country: PhoneCountry) => string;
+/**
+ * Whether national digits form a real number for the country, by the
+ * country's own numbering plan rather than a length check. `kind: 'mobile'`
+ * additionally rejects fixed lines; a number whose type the metadata cannot
+ * tell is accepted, since the metadata, not the number, is what is missing.
+ */
+export declare const isValidNationalNumber: (nationalDigits: string, country: PhoneCountry, kind?: PhoneValidationKind) => boolean;
+/**
+ * The flag as an emoji built from the ISO code's two regional-indicator
+ * letters, so no font asset ships with the library: iOS and Android both draw
+ * these from the system font. An unknown or malformed code returns ''. (Windows
+ * browsers render the two letters instead of a flag; that is the platform, not
+ * the code.)
+ */
+export declare const countryFlagEmoji: (iso: string) => string;
+/** Calling code + ISO for one country, the shape a country picker lists. */
+export interface PhoneCountryEntry {
+    iso: PhoneCountry;
+    /** Dial prefix WITHOUT the plus, e.g. '91'. */
+    callingCode: string;
+}
+/**
+ * Every country libphonenumber-js knows, with its calling code, in metadata
+ * order. Names are deliberately not here: they are display data, in one
+ * language, and live on their own import path (`mobile-core/phone/countries`)
+ * so an app that never opens a full country list does not carry them.
+ */
+export declare const getPhoneCountries: () => ReadonlyArray<PhoneCountryEntry>;
 //# sourceMappingURL=phone.d.ts.map

package/lib/typescript/module/index.d.ts

@@ -12,6 +12,10 @@
  *   @webority-technologies/mobile-core/download     a filesystem module
  *   @webority-technologies/mobile-core/smsRetriever Android only, own TurboModule
  *
+ * One more path is separate for size, not for a native package:
+ *
+ *   @webority-technologies/mobile-core/phone/countries  245 English country names
+ *
  * react-native-keychain is the exception and is a REQUIRED peer: the HTTP client
  * reads the bearer token, so it is reachable from the main barrel by design.
  */
@@ -29,8 +33,8 @@ export type { Config, Environment, LogLevel } from './config/index.js';
 export { getConfig, getConfigValue, resetConfig, setConfig } from './config/index.js';
 export type { DeepLinkConfig, DeepLinkRoute, ParsedLink } from './deepLink/index.js';
 export { DeepLink, parseDeepLink, useDeepLink } from './deepLink/index.js';
-export type { DateInput, DateStyle, FormatCurrencyOptions, FormatPhoneOptions, PhoneCountry, PhoneNumber, TimeStyle } from './formatters/index.js';
-export { addDays, detectPhoneCountry, diffMs, formatCompactNumber, formatCurrency, formatDate, formatDateDDMMMYYYY, formatDateISO, formatDatePattern, formatDateTime, formatNumber, formatPercent, formatPhone, formatRelativeTime, formatTime, formatTime12h, formatTimeInWindowsZone, formatTimeInZone, getInitials, isDateAfter, isDateBefore, isSameDay, isValidPhoneNumber, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString, startOfDay } from './formatters/index.js';
+export type { DateInput, DateStyle, FormatCurrencyOptions, FormatPhoneOptions, PhoneCountry, PhoneCountryEntry, PhoneNumber, PhoneNumberType, PhoneParts, PhoneValidationKind, TimeStyle } from './formatters/index.js';
+export { AsYouType, addDays, clampNationalNumber, countryFlagEmoji, detectPhoneCountry, diffMs, formatCompactNumber, formatCurrency, formatDate, formatDateDDMMMYYYY, formatDateISO, formatDatePattern, formatDateTime, formatNumber, formatPercent, formatPhone, formatPhoneAsTyped, formatRelativeTime, formatTime, formatTime12h, formatTimeInWindowsZone, formatTimeInZone, getCountries, getCountryCallingCode, getInitials, getPhoneCountries, isDateAfter, isDateBefore, isSameDay, isSupportedCountry, isValidNationalNumber, isValidPhoneNumber, maxNationalNumberLength, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString, splitPhoneNumber, startOfDay, validatePhoneNumberLength } from './formatters/index.js';
 export type { InitConfig } from './initSDK.js';
 export { initWebority } from './initSDK.js';
 export type { AuthActions } from './initUserAuth.js';

package/lib/typescript/module/phone/countries.d.ts

@@ -0,0 +1,13 @@
+/**
+ * English display names for every country libphonenumber-js knows, keyed by
+ * ISO 3166-1 alpha-2. GENERATED by scripts/gen-phone-countries.mjs from Node's
+ * Intl.DisplayNames('en', { type: 'region' }) over getCountries() on 2026-09-14;
+ * '&' is written as 'and'. Re-run the script rather than editing by hand.
+ *
+ * Lives on its own import path (mobile-core/phone/countries) so an app that
+ * never opens a full country list does not carry these 245 strings in its
+ * bundle. Pair with getPhoneCountries() from the package root for the calling
+ * codes; a country picker that needs another language supplies its own names.
+ */
+export declare const PHONE_COUNTRY_NAMES: Readonly<Record<string, string>>;
+//# sourceMappingURL=countries.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webority-technologies/mobile-core",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "Platform layer for Webority React Native apps: HTTP clients, auth/token storage, config, logging, formatters, validators, network status, permissions, storage and version checks. No UI.",
   "keywords": [
     "react-native",
@@ -151,6 +151,16 @@
         "default": "./lib/commonjs/smsRetriever/index.js"
       }
     },
+    "./phone/countries": {
+      "import": {
+        "types": "./lib/typescript/module/phone/countries.d.ts",
+        "default": "./lib/module/phone/countries.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/phone/countries.d.ts",
+        "default": "./lib/commonjs/phone/countries.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "main": "./lib/commonjs/index.js",