@africanies/angular-web-sdk 0.1.11 → 0.1.13

package/libs/africanies-ui/src/lib/forms/index.ts

@@ -26,6 +26,26 @@ export {
 } from './file-upload';
 export { NumberInputComponent } from './number-input';
 export { OtpInputComponent, type OtpInputVariant } from './otp-input';
+export {
+  buildPhoneNumberValue,
+  dialCodeForIso2,
+  formatNationalDigits,
+  isPhoneNumberComplete,
+  matchDialCode,
+  normalizePhoneIso2,
+  parsePhoneControlValue,
+  PHONE_DIAL_CODES,
+  PHONE_MAX_NATIONAL_DIGITS,
+  PHONE_MIN_NATIONAL_DIGITS,
+  phoneCountryName,
+  type PhoneCountryOption,
+  phoneCountryOptions,
+  phoneDigitsOnly,
+  PhoneInputComponent,
+  type PhoneNumberValue,
+  phoneToE164,
+  removeDialCode,
+} from './phone-input';
 export { RadioComponent, type RadioOption } from './radio';
 export {
   type SearchComboboxBadge,

package/libs/africanies-ui/src/lib/forms/number-input/number-input.component.ts

@@ -148,6 +148,9 @@ function formatWhileTyping(raw: string): {
     }
   `,
 })
+/**
+ * Numeric field following the shared AFRICANIES form field pattern.
+ */
 export class NumberInputComponent implements ControlValueAccessor {
   protected readonly controlId = `africanies-number-input-${++nextNumberInputId}`;
   protected readonly hintId = `${this.controlId}-hint`;

package/libs/africanies-ui/src/lib/forms/otp-input/otp-input.component.ts

@@ -148,6 +148,9 @@ export type OtpInputVariant = 'default' | 'masked';
     </div>
   `,
 })
+/**
+ * One-time-passcode field — discrete digit cells, single string model.
+ */
 export class OtpInputComponent implements ControlValueAccessor, OnDestroy {
   private readonly destroyRef = inject(DestroyRef);
   private readonly cellInputs =

package/libs/africanies-ui/src/lib/forms/phone-input/index.ts

@@ -0,0 +1,21 @@
+/**
+ * Phone input form control exports.
+ */
+export { PHONE_DIAL_CODES, PHONE_MAX_NATIONAL_DIGITS, PHONE_MIN_NATIONAL_DIGITS } from './phone-codes';
+export { PhoneInputComponent } from './phone-input.component';
+export type { PhoneCountryOption, PhoneNumberValue } from './phone-input.types';
+export {
+  buildPhoneNumberValue,
+  dialCodeForIso2,
+  filterPhoneCountries,
+  formatNationalDigits,
+  isPhoneNumberComplete,
+  matchDialCode,
+  normalizePhoneIso2,
+  parsePhoneControlValue,
+  phoneCountryName,
+  phoneCountryOptions,
+  phoneDigitsOnly,
+  phoneToE164,
+  removeDialCode,
+} from './phone-input.utils';

package/libs/africanies-ui/src/lib/forms/phone-input/phone-codes.ts

@@ -0,0 +1,264 @@
+/**
+ * ISO 3166-1 alpha-2 → dial code (with `+`).
+ *
+ * Shared with classic import-export phone fields; used when
+ * `libphonenumber-js` is not bundled as a peer.
+ */
+export const PHONE_DIAL_CODES: Readonly<Record<string, string>> = {
+  AF: '+93',
+  AX: '+358',
+  AL: '+355',
+  DZ: '+213',
+  AS: '+1',
+  AD: '+376',
+  AO: '+244',
+  AI: '+1',
+  AQ: '+672',
+  AG: '+1',
+  AR: '+54',
+  AM: '+374',
+  AW: '+297',
+  AU: '+61',
+  AT: '+43',
+  AZ: '+994',
+  BS: '+1',
+  BH: '+973',
+  BD: '+880',
+  BB: '+1',
+  BY: '+375',
+  BE: '+32',
+  BZ: '+501',
+  BJ: '+229',
+  BM: '+1',
+  BT: '+975',
+  BO: '+591',
+  BQ: '+599',
+  BA: '+387',
+  BW: '+267',
+  BV: '+55',
+  BR: '+55',
+  IO: '+246',
+  BN: '+673',
+  BG: '+359',
+  BF: '+226',
+  BI: '+257',
+  KH: '+855',
+  CM: '+237',
+  CA: '+1',
+  CV: '+238',
+  KY: '+1',
+  CF: '+236',
+  TD: '+235',
+  CL: '+56',
+  CN: '+86',
+  CX: '+61',
+  CC: '+61',
+  CO: '+57',
+  KM: '+269',
+  CG: '+242',
+  CK: '+682',
+  CR: '+506',
+  HR: '+385',
+  CU: '+53',
+  CW: '+599',
+  CY: '+357',
+  CZ: '+420',
+  DK: '+45',
+  DJ: '+253',
+  DM: '+1',
+  DO: '+1',
+  CD: '+243',
+  EC: '+593',
+  EG: '+20',
+  SV: '+503',
+  GQ: '+240',
+  ER: '+291',
+  EE: '+370',
+  ET: '+251',
+  FK: '+500',
+  FO: '+298',
+  FJ: '+679',
+  FI: '+358',
+  FR: '+33',
+  GF: '+594',
+  PF: '+689',
+  TF: '+262',
+  GA: '+241',
+  GM: '+220',
+  GE: '+995',
+  DE: '+49',
+  GH: '+233',
+  GI: '+350',
+  GR: '+30',
+  GL: '+299',
+  GD: '+1',
+  GP: '+590',
+  GU: '+1',
+  GT: '+502',
+  GG: '+44',
+  GN: '+224',
+  GW: '+245',
+  GY: '+592',
+  HT: '+509',
+  HM: '+672',
+  HN: '+504',
+  HK: '+852',
+  HU: '+36',
+  IS: '+354',
+  IN: '+91',
+  ID: '+62',
+  IR: '+98',
+  IQ: '+964',
+  IE: '+353',
+  IM: '+44',
+  IL: '+972',
+  IT: '+39',
+  CI: '+225',
+  JM: '+1',
+  JP: '+81',
+  JE: '+44',
+  JO: '+962',
+  KZ: '+7',
+  KE: '+254',
+  KI: '+686',
+  XK: '+383',
+  KW: '+965',
+  KG: '+996',
+  LA: '+856',
+  LV: '+371',
+  LB: '+961',
+  LS: '+266',
+  LR: '+231',
+  LY: '+218',
+  LI: '+423',
+  LT: '+370',
+  LU: '+352',
+  MO: '+853',
+  MK: '+389',
+  MG: '+261',
+  MW: '+265',
+  MY: '+60',
+  MV: '+960',
+  ML: '+223',
+  MT: '+356',
+  MH: '+692',
+  MQ: '+596',
+  MR: '+222',
+  MU: '+230',
+  YT: '+262',
+  MX: '+52',
+  FM: '+691',
+  MD: '+373',
+  MC: '+377',
+  MN: '+976',
+  ME: '+382',
+  MS: '+1',
+  MA: '+212',
+  MZ: '+258',
+  MM: '+95',
+  NA: '+264',
+  NR: '+674',
+  NP: '+977',
+  NL: '+31',
+  AN: '+599',
+  NC: '+687',
+  NZ: '+64',
+  NI: '+505',
+  NE: '+227',
+  NG: '+234',
+  NU: '+683',
+  NF: '+672',
+  MP: '+1',
+  KP: '+850',
+  NO: '+47',
+  OM: '+968',
+  PK: '+92',
+  PW: '+680',
+  PS: '+970',
+  PA: '+507',
+  PG: '+675',
+  PY: '+595',
+  PE: '+51',
+  PH: '+63',
+  PN: '+64',
+  PL: '+48',
+  PT: '+351',
+  PR: '+1',
+  QA: '+974',
+  RO: '+40',
+  RU: '+7',
+  RW: '+250',
+  RE: '+262',
+  BL: '+590',
+  MF: '+590',
+  SH: '+290',
+  KN: '+1',
+  LC: '+1',
+  PM: '+508',
+  VC: '+1',
+  WS: '+685',
+  SM: '+378',
+  ST: '+239',
+  SA: '+966',
+  SN: '+221',
+  RS: '+381',
+  SC: '+248',
+  SL: '+232',
+  SG: '+65',
+  SX: '+1',
+  SK: '+421',
+  SI: '+386',
+  SB: '+677',
+  SO: '+252',
+  ZA: '+27',
+  GS: '+500',
+  KR: '+82',
+  SS: '+211',
+  ES: '+34',
+  LK: '+94',
+  SD: '+249',
+  SR: '+597',
+  SJ: '+47',
+  SZ: '+268',
+  SE: '+46',
+  CH: '+41',
+  SY: '+963',
+  TW: '+886',
+  TJ: '+992',
+  TZ: '+255',
+  TH: '+66',
+  TL: '+670',
+  TG: '+228',
+  TK: '+690',
+  TO: '+676',
+  TT: '+1',
+  TN: '+216',
+  TR: '+90',
+  TM: '+993',
+  TC: '+1',
+  TV: '+688',
+  UG: '+256',
+  UA: '+380',
+  AE: '+971',
+  GB: '+44',
+  US: '+1',
+  UY: '+598',
+  UZ: '+998',
+  VU: '+678',
+  VA: '+379',
+  VE: '+58',
+  VN: '+84',
+  VG: '+1',
+  VI: '+1',
+  WF: '+681',
+  EH: '+212',
+  YE: '+967',
+  ZM: '+260',
+  ZW: '+263',
+};
+
+/** Max national digit count (ITU E.164 national significant number). */
+export const PHONE_MAX_NATIONAL_DIGITS = 15;
+
+/** Minimum national digits before we treat a draft as a complete number. */
+export const PHONE_MIN_NATIONAL_DIGITS = 4;