@webority/mobile-core 0.0.23

package/lib/module/formatters/dateMath.js

@@ -0,0 +1,294 @@
+"use strict";
+
+import { WINDOWS_TO_IANA } from "./windowsToIanaTable.js";
+const toDate = value => {
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? null : value;
+  }
+  const d = new Date(value);
+  return Number.isNaN(d.getTime()) ? null : d;
+};
+const PAD = n => n < 10 ? `0${n}` : `${n}`;
+
+/**
+ * Whether two values fall on the same calendar day in the device's local
+ * timezone. Invalid input on either side returns false rather than throwing.
+ */
+export const isSameDay = (a, b) => {
+  const da = toDate(a);
+  const db = toDate(b);
+  if (!da || !db) {
+    return false;
+  }
+  return da.getFullYear() === db.getFullYear() && da.getMonth() === db.getMonth() && da.getDate() === db.getDate();
+};
+
+/** `a` is strictly before `b`. Invalid input on either side returns false. */
+export const isDateBefore = (a, b) => {
+  const da = toDate(a);
+  const db = toDate(b);
+  return da !== null && db !== null && da.getTime() < db.getTime();
+};
+
+/** `a` is strictly after `b`. Invalid input on either side returns false. */
+export const isDateAfter = (a, b) => {
+  const da = toDate(a);
+  const db = toDate(b);
+  return da !== null && db !== null && da.getTime() > db.getTime();
+};
+
+/**
+ * `a - b` in milliseconds, matching dayjs's `a.diff(b)` sign convention
+ * (positive when `a` is later than `b`). Returns `NaN` if either side fails
+ * to parse, the same way subtracting two invalid dayjs objects would.
+ */
+export const diffMs = (a, b) => {
+  const da = toDate(a);
+  const db = toDate(b);
+  if (!da || !db) {
+    return Number.NaN;
+  }
+  return da.getTime() - db.getTime();
+};
+
+/**
+ * Midnight of the given date, in the device's local timezone. Returns null
+ * for unparseable input.
+ */
+export const startOfDay = value => {
+  const d = toDate(value);
+  if (!d) {
+    return null;
+  }
+  const start = new Date(d);
+  start.setHours(0, 0, 0, 0);
+  return start;
+};
+
+/**
+ * Adds (or, with a negative count, subtracts) whole calendar days in the
+ * device's local timezone. Returns null for unparseable input.
+ */
+export const addDays = (value, count) => {
+  const d = toDate(value);
+  if (!d) {
+    return null;
+  }
+  const next = new Date(d);
+  next.setDate(next.getDate() + count);
+  return next;
+};
+const WEEKDAY_SHORT = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+const WEEKDAY_LONG = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+const MONTH_LONG = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
+
+// Longest-first so 'YYYY' is tried before 'YY', 'DD' before 'D', etc. — a
+// greedy single pass over the pattern, not a regex, so a literal character
+// (a comma, a colon, a digit) can never accidentally match a token.
+const TOKENS = ['YYYY', 'YY', 'MMMM', 'MMM', 'MM', 'M', 'DD', 'D', 'dddd', 'ddd', 'HH', 'H', 'hh', 'h', 'mm', 'm', 'ss', 's', 'A', 'a'];
+const tokenizePattern = pattern => {
+  const result = [];
+  let i = 0;
+  outer: while (i < pattern.length) {
+    for (const token of TOKENS) {
+      if (pattern.startsWith(token, i)) {
+        result.push(token);
+        i += token.length;
+        continue outer;
+      }
+    }
+    result.push(pattern[i]);
+    i += 1;
+  }
+  return result;
+};
+
+/**
+ * Small dayjs/moment-style token formatter — YYYY/YY, MMMM/MMM/MM/M,
+ * DD/D, dddd/ddd, HH/H (24h), hh/h (12h), mm/m, ss/s, A/a (upper/lower AM/PM).
+ * Everything else in the pattern (spaces, commas, colons) passes through
+ * literally. Hand-rolled rather than a dependency because this fleet's date
+ * formatting needs are a small, closed token set, not general i18n — for
+ * genuinely locale-aware output, `formatDate`/`formatTime` (Intl-backed, in
+ * `./date`) are the ones to reach for; this is for matching an exact
+ * existing pattern (a legacy display string, an API's expected shape).
+ *
+ * `utc: true` reads every field from the UTC calendar/clock instead of the
+ * device's local one — see `formatDateDDMMMYYYY`'s note on why this isn't
+ * cosmetic.
+ */
+export const formatDatePattern = (value, pattern, options) => {
+  const d = toDate(value);
+  if (!d) {
+    return '';
+  }
+  const utc = options?.utc ?? false;
+  const year = utc ? d.getUTCFullYear() : d.getFullYear();
+  const month = utc ? d.getUTCMonth() : d.getMonth();
+  const day = utc ? d.getUTCDate() : d.getDate();
+  const weekday = utc ? d.getUTCDay() : d.getDay();
+  const hours24 = utc ? d.getUTCHours() : d.getHours();
+  const minutes = utc ? d.getUTCMinutes() : d.getMinutes();
+  const seconds = utc ? d.getUTCSeconds() : d.getSeconds();
+  const {
+    hour12,
+    period
+  } = to12Hour(hours24);
+  return tokenizePattern(pattern).map(t => {
+    switch (t) {
+      case 'YYYY':
+        return String(year);
+      case 'YY':
+        return String(year).slice(-2);
+      case 'MMMM':
+        return MONTH_LONG[month];
+      case 'MMM':
+        return MONTH_SHORT[month];
+      case 'MM':
+        return PAD(month + 1);
+      case 'M':
+        return String(month + 1);
+      case 'DD':
+        return PAD(day);
+      case 'D':
+        return String(day);
+      case 'dddd':
+        return WEEKDAY_LONG[weekday];
+      case 'ddd':
+        return WEEKDAY_SHORT[weekday];
+      case 'HH':
+        return PAD(hours24);
+      case 'H':
+        return String(hours24);
+      case 'hh':
+        return PAD(hour12);
+      case 'h':
+        return String(hour12);
+      case 'mm':
+        return PAD(minutes);
+      case 'm':
+        return String(minutes);
+      case 'ss':
+        return PAD(seconds);
+      case 's':
+        return String(seconds);
+      case 'A':
+        return period;
+      case 'a':
+        return period.toLowerCase();
+      default:
+        return t;
+    }
+  }).join('');
+};
+const MONTH_SHORT = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+
+/**
+ * `DD MMM, YYYY` — zero-padded day, short month, comma, year (e.g.
+ * `05 Sep, 2025`). A specific legacy pattern some apps already display,
+ * not the fleet's own product convention: `formatDate` (the Intl `style`-based
+ * formatter in `./date`) is the one to reach for in new code. This exists so
+ * an app already showing this exact pattern can move off a date library
+ * without a visible change.
+ *
+ * `utc: true` reads the calendar day from the UTC fields instead of the
+ * device's local ones — matching `dayjs.utc(x).format(...)`, not
+ * `dayjs(x).format(...)`. The two disagree whenever local time has crossed a
+ * day boundary UTC hasn't yet (or vice versa), so this is not a cosmetic
+ * option; pass it only to match a call site that was genuinely UTC-explicit.
+ */
+export const formatDateDDMMMYYYY = (value, options) => {
+  const d = toDate(value);
+  if (!d) {
+    return '';
+  }
+  if (options?.utc) {
+    return `${PAD(d.getUTCDate())} ${MONTH_SHORT[d.getUTCMonth()]}, ${d.getUTCFullYear()}`;
+  }
+  return `${PAD(d.getDate())} ${MONTH_SHORT[d.getMonth()]}, ${d.getFullYear()}`;
+};
+
+/** `YYYY-MM-DD`, in the device's local timezone. */
+export const formatDateISO = value => {
+  const d = toDate(value);
+  if (!d) {
+    return '';
+  }
+  return `${d.getFullYear()}-${PAD(d.getMonth() + 1)}-${PAD(d.getDate())}`;
+};
+const to12Hour = hours => {
+  const period = hours >= 12 ? 'PM' : 'AM';
+  const hour12 = hours % 12 || 12;
+  return {
+    hour12,
+    period
+  };
+};
+
+/**
+ * `hh:mm A` in the device's local timezone — zero-padded 12-hour clock,
+ * uppercase AM/PM (e.g. `09:30 PM`).
+ */
+export const formatTime12h = value => {
+  const d = toDate(value);
+  if (!d) {
+    return '';
+  }
+  const {
+    hour12,
+    period
+  } = to12Hour(d.getHours());
+  return `${PAD(hour12)}:${PAD(d.getMinutes())} ${period}`;
+};
+const hasIntl = () => typeof Intl !== 'undefined' && typeof Intl.DateTimeFormat === 'function';
+
+/**
+ * `hh:mm a` (zero-padded 12-hour, lowercase am/pm) of the given instant as
+ * seen in `ianaTimeZone` (e.g. `Asia/Kolkata`) — not the device's own
+ * timezone. Reads the hour/minute/period through `Intl.DateTimeFormat`'s
+ * `formatToParts` rather than its assembled string, because the assembled
+ * string's spacing before AM/PM varies by JS engine (some insert a narrow
+ * no-break space, U+202F, instead of a plain space) and isn't reliably
+ * zero-padded either. Throws if `ianaTimeZone` isn't a timezone Intl
+ * recognises — the same failure mode as handing dayjs.tz() a bad zone name.
+ */
+export const formatTimeInZone = (value, ianaTimeZone) => {
+  const d = toDate(value);
+  if (!d) {
+    return '';
+  }
+  if (!hasIntl()) {
+    // No Intl.DateTimeFormat means no reliable IANA timezone database to
+    // convert against; the device-local fallback below is the least-wrong
+    // answer available, not a genuine timezone conversion.
+    return formatTime12h(d);
+  }
+  const parts = new Intl.DateTimeFormat('en-US', {
+    timeZone: ianaTimeZone,
+    hour: 'numeric',
+    minute: '2-digit',
+    hour12: true
+  }).formatToParts(d);
+  const get = type => parts.find(p => p.type === type)?.value ?? '';
+  const hour = Number.parseInt(get('hour'), 10);
+  const minute = get('minute');
+  const period = get('dayPeriod').toLowerCase();
+  return `${PAD(hour)}:${minute} ${period}`;
+};
+
+/**
+ * Same as {@link formatTimeInZone}, but for a .NET-style Windows timezone ID
+ * (e.g. `"India Standard Time"`) rather than an IANA one. .NET's own
+ * `TimeZoneInfo` API only knows Windows IDs, so a backend built on it hands
+ * these to clients directly — `Intl`, by contrast, only recognises IANA
+ * names, so the ID has to be translated before it can be used here. Throws
+ * if `windowsTimeZoneId` has no known IANA mapping.
+ */
+export const formatTimeInWindowsZone = (value, windowsTimeZoneId) => {
+  const ianaTimeZone = WINDOWS_TO_IANA[windowsTimeZoneId];
+  if (!ianaTimeZone) {
+    throw new Error(`Mapping for Windows time zone '${windowsTimeZoneId}' not found.`);
+  }
+  return formatTimeInZone(value, ianaTimeZone);
+};
+//# sourceMappingURL=dateMath.js.map

package/lib/module/formatters/index.js

@@ -0,0 +1,9 @@
+"use strict";
+
+export { formatCurrency } from "./currency.js";
+export { formatDate, formatDateTime, formatRelativeTime, formatTime } from "./date.js";
+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 { AsYouType, clampNationalNumber, countryFlagEmoji, detectPhoneCountry, formatPhone, formatPhoneAsTyped, getCountries, getCountryCallingCode, getPhoneCountries, isSupportedCountry, isValidNationalNumber, isValidPhoneNumber, maxNationalNumberLength, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString, splitPhoneNumber, validatePhoneNumberLength } from "./phone.js";
+//# sourceMappingURL=index.js.map

package/lib/module/formatters/initials.js

@@ -0,0 +1,27 @@
+"use strict";
+
+/**
+ * Returns up to `maxChars` uppercase initials from a name.
+ *
+ * @example
+ * getInitials('Navneet Singh')       // 'NS'
+ * getInitials('mary anne lee', 3)    // 'MAL'
+ * getInitials('navneet')             // 'NA'
+ * getInitials('  ')                  // ''
+ */
+export const getInitials = (name, maxChars = 2) => {
+  if (!name) {
+    return '';
+  }
+  const trimmed = name.trim();
+  if (!trimmed) {
+    return '';
+  }
+  const parts = trimmed.split(/\s+/);
+  if (parts.length === 1) {
+    const single = parts[0] ?? '';
+    return single.slice(0, maxChars).toUpperCase();
+  }
+  return parts.slice(0, maxChars).map(p => (p[0] ?? '').toUpperCase()).join('');
+};
+//# sourceMappingURL=initials.js.map

package/lib/module/formatters/number.js

@@ -0,0 +1,81 @@
+"use strict";
+
+const hasIntlNumber = () => typeof Intl !== 'undefined' && typeof Intl.NumberFormat === 'function';
+
+/**
+ * Locale-aware number formatter. Defaults to `'en-IN'` (Indian grouping).
+ */
+export const formatNumber = (value, fractionDigits, locale = 'en-IN') => {
+  if (value == null || Number.isNaN(value)) {
+    return '';
+  }
+  if (hasIntlNumber()) {
+    try {
+      const opts = {};
+      if (fractionDigits != null) {
+        opts.minimumFractionDigits = fractionDigits;
+        opts.maximumFractionDigits = fractionDigits;
+      }
+      return new Intl.NumberFormat(locale, opts).format(value);
+    } catch {
+      /* fall through */
+    }
+  }
+  return fractionDigits != null ? value.toFixed(fractionDigits) : String(value);
+};
+
+/**
+ * Format a 0–1 ratio (or 0–100 percent) as a percent string.
+ * Pass `asRatio: false` if your input is already on the 0–100 scale.
+ */
+export const formatPercent = (value, fractionDigits = 0, asRatio = true, locale = 'en-IN') => {
+  if (value == null || Number.isNaN(value)) {
+    return '';
+  }
+  const ratio = asRatio ? value : value / 100;
+  if (hasIntlNumber()) {
+    try {
+      return new Intl.NumberFormat(locale, {
+        style: 'percent',
+        minimumFractionDigits: fractionDigits,
+        maximumFractionDigits: fractionDigits
+      }).format(ratio);
+    } catch {
+      /* fall through */
+    }
+  }
+  return `${(ratio * 100).toFixed(fractionDigits)}%`;
+};
+
+/**
+ * Format a number compactly (1.2K, 3.4M, 1.5L, 2.3Cr).
+ * Defaults to Indian compact notation via `'en-IN'` locale (lakh / crore).
+ */
+export const formatCompactNumber = (value, locale = 'en-IN') => {
+  if (value == null || Number.isNaN(value)) {
+    return '';
+  }
+  if (hasIntlNumber()) {
+    try {
+      return new Intl.NumberFormat(locale, {
+        notation: 'compact',
+        maximumFractionDigits: 1
+      }).format(value);
+    } catch {
+      /* fall through */
+    }
+  }
+  const abs = Math.abs(value);
+  const sign = value < 0 ? '-' : '';
+  if (abs >= 1e7) {
+    return `${sign}${(abs / 1e7).toFixed(1)}Cr`;
+  }
+  if (abs >= 1e5) {
+    return `${sign}${(abs / 1e5).toFixed(1)}L`;
+  }
+  if (abs >= 1e3) {
+    return `${sign}${(abs / 1e3).toFixed(1)}K`;
+  }
+  return `${value}`;
+};
+//# sourceMappingURL=number.js.map