@ews-admin/global-design-system 1.25.0 → 1.26.0

package/dist/index.js

@@ -226,6 +226,46 @@ function formatPhoneNumberWithCountryCode(phoneNumber, countryCode = "+221") {
         return "";
     return `${countryCode}${cleaned}`;
 }
+/**
+ * National digit groups used to display a phone number, per country code:
+ * Senegal numbers have 9 national digits (77 123 45 67, 33 823 45 67), Chad
+ * numbers 8 (66 12 34 56).
+ */
+const DISPLAY_DIGIT_GROUPS = {
+    "+221": [2, 3, 2, 2],
+    "+235": [2, 2, 2, 2],
+};
+/**
+ * Formats a phone number for display only: the country code, then the
+ * national digits in their usual groups. Do not use it for values sent to the
+ * API, form values or tel: links; formatPhoneNumberWithCountryCode gives the
+ * unspaced value for those. A number from another country, or of an
+ * unexpected length, is returned as formatPhoneNumberWithCountryCode returns it.
+ *
+ * @example
+ * formatPhoneNumberForDisplay("221771234567")  // "+221 77 123 45 67" (backend's storage format)
+ * formatPhoneNumberForDisplay("771234567")     // "+221 77 123 45 67"
+ * formatPhoneNumberForDisplay("+23566123456")  // "+235 66 12 34 56"
+ * formatPhoneNumberForDisplay("+22177123")     // "+22177123" (unexpected length, unchanged)
+ */
+function formatPhoneNumberForDisplay(phoneNumber, countryCode = "+221") {
+    const canonical = formatPhoneNumberWithCountryCode(phoneNumber, countryCode);
+    const code = COUNTRY_CODES.find(({ code: c }) => canonical.startsWith(c))?.code;
+    const groups = code ? DISPLAY_DIGIT_GROUPS[code] : undefined;
+    if (!code || !groups)
+        return canonical;
+    const national = canonical.slice(code.length).replace(/[\s-]/g, "");
+    const expectedLength = groups.reduce((sum, size) => sum + size, 0);
+    if (!/^\d+$/.test(national) || national.length !== expectedLength)
+        return canonical;
+    const parts = [];
+    let start = 0;
+    for (const size of groups) {
+        parts.push(national.slice(start, start + size));
+        start += size;
+    }
+    return `${code} ${parts.join(" ")}`;
+}
 
 /**
  * Default currency for price formatting
@@ -40865,6 +40905,7 @@ exports.extractCountryCodeFromPhoneNumber = extractCountryCodeFromPhoneNumber;
 exports.formatCurrency = formatCurrency;
 exports.formatDate = formatDate;
 exports.formatNumeric = formatNumeric;
+exports.formatPhoneNumberForDisplay = formatPhoneNumberForDisplay;
 exports.formatPhoneNumberWithCountryCode = formatPhoneNumberWithCountryCode;
 exports.generateId = generateId;
 exports.getDefaultCountryCode = getDefaultCountryCode;