@gusto/embedded-react-sdk 0.46.3 → 0.47.0

package/dist/helpers/dateFormatting.d.ts

@@ -1,51 +1,186 @@
 /**
  * Normalizes any date input (string, Date, or undefined) to a Date object.
- * Handles YYYY-MM-DD strings by parsing them in local timezone to avoid timezone issues.
- * Also handles ISO timestamp strings for compatibility.
- * Returns null for invalid inputs.
+ *
+ * @remarks Handles `YYYY-MM-DD` strings by parsing them in local time to avoid
+ * timezone drift. Also accepts ISO timestamp strings and existing `Date`
+ * instances. Returns `null` for nullish, empty, or unparseable input.
+ *
+ * @param dateInput - The date value to normalize.
+ * @returns A `Date` instance, or `null` if the input is missing or invalid.
+ * @internal
  */
 export declare const normalizeToDate: (dateInput?: string | Date | null) => Date | null;
+/**
+ * Formats a date as a short weekday plus short month and day (e.g. `Mon, Jan 5`).
+ *
+ * @internal
+ */
 export declare const formatDateShortWithWeekday: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Formats a date as a short weekday, short month, day, and year (e.g. `Mon, Jan 5, 2025`).
+ *
+ * @internal
+ */
 export declare const formatDateShortWithWeekdayAndYear: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Formats a date as a short month and day (e.g. `Jan 5`).
+ *
+ * @internal
+ */
 export declare const formatDateShort: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Formats a date as a short month, day, and year (e.g. `Jan 5, 2025`).
+ *
+ * @internal
+ */
 export declare const formatDateShortWithYear: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Formats a date as a long month and day (e.g. `January 5`).
+ *
+ * @internal
+ */
 export declare const formatDateLong: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Formats a date as a long month, day, and year (e.g. `January 5, 2025`).
+ *
+ * @internal
+ */
 export declare const formatDateLongWithYear: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Splits a date into separate locale-formatted time and date strings.
+ *
+ * @param dateInput - The date value to format.
+ * @param locale - Optional BCP 47 locale tag passed to `toLocaleString`.
+ * @returns An object with `time` (e.g. `3:45 PM EST`) and `date` (e.g. `Mon, Jan 5`).
+ * Both fields are empty strings when the input cannot be parsed.
+ * @internal
+ */
 export declare const formatDateWithTime: (dateInput?: string | Date | null, locale?: string) => {
     time: string;
     date: string;
 };
+/**
+ * Formats a pay period start and end date for display as separate fields.
+ *
+ * @remarks Start date renders with the long month and day; end date renders
+ * with the short month, day, and year.
+ *
+ * @param startDateInput - Pay period start date.
+ * @param endDateInput - Pay period end date.
+ * @param locale - Optional BCP 47 locale tag passed to `toLocaleDateString`.
+ * @returns Formatted `startDate` and `endDate` strings. Both fields are empty
+ * strings when either input cannot be parsed.
+ * @internal
+ */
 export declare const formatPayPeriod: (startDateInput?: string | Date | null, endDateInput?: string | Date | null, locale?: string) => {
     startDate: string;
     endDate: string;
 };
+/**
+ * Formats a pay period as a single en-dash–separated range string.
+ *
+ * @param startDateInput - Pay period start date.
+ * @param endDateInput - Pay period end date.
+ * @param locale - Optional BCP 47 locale tag passed to `toLocaleDateString`.
+ * @param options - When `useShortMonth` is true, both ends use short month names.
+ * Otherwise the start uses the long month name and the end uses short.
+ * @returns The formatted range (e.g. `January 1–Jan 15, 2025`), or an empty
+ * string when either input cannot be parsed.
+ * @internal
+ */
 export declare const formatPayPeriodRange: (startDateInput?: string | Date | null, endDateInput?: string | Date | null, locale?: string, options?: {
     useShortMonth?: boolean;
 }) => string;
+/**
+ * Formats a `Date` as a `YYYY-MM-DD` string using the local year, month, and day.
+ *
+ * @param date - The date to format.
+ * @returns A zero-padded `YYYY-MM-DD` string, or `null` when the input is an invalid date.
+ * @internal
+ */
 export declare const formatDateToStringDate: (date: Date) => string | null;
 /**
- * Converts any parseable date string to a `YYYY-MM-DD` ISO string using local
- * time, so the calendar date is preserved regardless of the runtime timezone.
+ * Converts any parseable date string to a `YYYY-MM-DD` ISO string using local time.
  *
- * Unlike `formatDateToStringDate` (which reads UTC), this function reads the
- * local year/month/day — safe for dates parsed from locale-format strings
- * (e.g. "4/16/1998") or ISO strings, both of which `normalizeToDate` lands at
- * local midnight.
+ * @remarks Reads the local year, month, and day so the calendar date is
+ * preserved regardless of the runtime timezone. Safe for dates parsed from
+ * locale-format strings (e.g. `4/16/1998`) or ISO strings, both of which land
+ * at local midnight when normalized.
  *
- * Returns `''` for null, undefined, empty, or unparseable input.
+ * @param value - The date string to convert.
+ * @returns A `YYYY-MM-DD` string, or `''` for nullish, empty, or unparseable input.
+ * @internal
  */
 export declare const normalizeToISOString: (value?: string | null) => string;
 /**
- * Normalizes Date to local midnight, handling timezone issues from any adapter.
+ * Normalizes a `Date` to local midnight, stripping any time-of-day component.
+ *
+ * @param date - The date to normalize, or `null`.
+ * @returns A new `Date` at local midnight, or `null` when the input is missing or invalid.
+ * @internal
  */
 export declare const normalizeDateToLocal: (date: Date | null) => Date | null;
+/**
+ * Number of milliseconds in one hour.
+ *
+ * @internal
+ */
 export declare const MS_PER_HOUR: number;
+/**
+ * Returns the number of hours from now until a deadline.
+ *
+ * @param deadline - Target date in the future (or past, for negative results).
+ * @returns Hours until `deadline` (fractional, negative if `deadline` is in
+ * the past), or `null` when the input cannot be parsed.
+ * @internal
+ */
 export declare const getHoursUntil: (deadline?: Date | string | null) => number | null;
+/**
+ * Returns the number of days from now until a deadline.
+ *
+ * @param deadline - Target date in the future (or past, for negative results).
+ * @returns Days until `deadline` (fractional, negative if `deadline` is in
+ * the past), or `null` when the input cannot be parsed.
+ * @internal
+ */
 export declare const getDaysUntil: (deadline?: Date | string | null) => number | null;
-export declare const isWeekend: (date: Date) => boolean;
+/**
+ * Returns a new `Date` offset from the input by a given number of days.
+ *
+ * @param date - The base date. Not mutated.
+ * @param days - Number of days to add (negative values subtract).
+ * @returns A new `Date` shifted by `days`.
+ * @internal
+ */
 export declare const addDays: (date: Date, days: number) => Date;
+/**
+ * Returns a new `Date` offset by a given number of business days (Monday–Friday).
+ *
+ * @remarks Skips Saturdays and Sundays when counting. The result is normalized
+ * to local midnight. Does not account for holidays.
+ *
+ * @param startDate - The base date. Not mutated.
+ * @param businessDays - Number of business days to add.
+ * @returns A new `Date` shifted forward by `businessDays` weekdays.
+ * @internal
+ */
 export declare const addBusinessDays: (startDate: Date, businessDays: number) => Date;
-/** Formats numeric month and day as a zero-padded `MM-DD` string. */
+/**
+ * Formats numeric month and day as a zero-padded `MM-DD` string.
+ *
+ * @param month - Month number, 1–12.
+ * @param day - Day-of-month number, 1–31.
+ * @returns A `MM-DD` string, or `undefined` when either argument is missing.
+ * @internal
+ */
 export declare function formatMonthDay(month?: number, day?: number): string | undefined;
-/** Returns the number of days in a given month (1-indexed). Uses a non-leap year so February always returns 28. */
+/**
+ * Returns the number of days in a given month (1-indexed).
+ *
+ * @remarks Uses a non-leap year, so February always returns 28.
+ *
+ * @param month - Month number, 1–12.
+ * @returns The number of days in that month.
+ * @internal
+ */
 export declare function getDaysInMonth(month: number): number;

package/dist/helpers/dateFormatting.js

@@ -136,7 +136,6 @@ export {
   R as getDaysInMonth,
   k as getDaysUntil,
   Y as getHoursUntil,
-  g as isWeekend,
   W as normalizeDateToLocal,
   s as normalizeToDate,
   F as normalizeToISOString

package/dist/helpers/dateFormatting.js.map

@@ -1 +1 @@
-{"version":3,"file":"dateFormatting.js","sources":["../../src/helpers/dateFormatting.ts"],"sourcesContent":["/**\n * Normalizes any date input (string, Date, or undefined) to a Date object.\n * Handles YYYY-MM-DD strings by parsing them in local timezone to avoid timezone issues.\n * Also handles ISO timestamp strings for compatibility.\n * Returns null for invalid inputs.\n */\nexport const normalizeToDate = (dateInput?: string | Date | null): Date | null => {\n  if (!dateInput) return null\n\n  if (typeof dateInput === 'string') {\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(dateInput)) {\n      const parts = dateInput.split('-')\n      if (parts.length !== 3) return null\n\n      const numbers = parts.map(Number)\n      const year = numbers[0]\n      const month = numbers[1]\n      const day = numbers[2]\n      if (year === undefined || month === undefined || day === undefined) {\n        return null\n      }\n\n      if (\n        isNaN(year) ||\n        isNaN(month) ||\n        isNaN(day) ||\n        month < 1 ||\n        month > 12 ||\n        day < 1 ||\n        day > 31\n      ) {\n        return null\n      }\n\n      return new Date(year, month - 1, day)\n    }\n\n    const parsedDate = new Date(dateInput)\n    return isNaN(parsedDate.getTime()) ? null : parsedDate\n  }\n\n  if (dateInput instanceof Date) {\n    return isNaN(dateInput.getTime()) ? null : dateInput\n  }\n\n  return null\n}\n\n/**\n * Creates a date formatter function that handles both string and Date inputs.\n */\nconst createDateFormatter =\n  (options: Intl.DateTimeFormatOptions) =>\n  (dateInput?: string | Date | null, locale?: string): string => {\n    const date = normalizeToDate(dateInput)\n    if (!date) return ''\n    return date.toLocaleDateString(locale, options)\n  }\n\nexport const formatDateShortWithWeekday = createDateFormatter({\n  weekday: 'short',\n  month: 'short',\n  day: 'numeric',\n})\n\nexport const formatDateShortWithWeekdayAndYear = createDateFormatter({\n  weekday: 'short',\n  month: 'short',\n  day: 'numeric',\n  year: 'numeric',\n})\n\nexport const formatDateShort = createDateFormatter({\n  month: 'short',\n  day: 'numeric',\n})\n\nexport const formatDateShortWithYear = createDateFormatter({\n  month: 'short',\n  day: 'numeric',\n  year: 'numeric',\n})\n\nexport const formatDateLong = createDateFormatter({\n  month: 'long',\n  day: 'numeric',\n})\n\nexport const formatDateLongWithYear = createDateFormatter({\n  month: 'long',\n  day: 'numeric',\n  year: 'numeric',\n})\n\nexport const formatDateWithTime = (\n  dateInput?: string | Date | null,\n  locale?: string,\n): { time: string; date: string } => {\n  const date = normalizeToDate(dateInput)\n  if (!date) return { time: '', date: '' }\n\n  const time = date.toLocaleTimeString(locale, {\n    hour: 'numeric',\n    minute: '2-digit',\n    hour12: true,\n    timeZoneName: 'short',\n  })\n\n  const dateString = date.toLocaleDateString(locale, {\n    weekday: 'short',\n    month: 'short',\n    day: 'numeric',\n  })\n\n  return { time, date: dateString }\n}\n\nexport const formatPayPeriod = (\n  startDateInput?: string | Date | null,\n  endDateInput?: string | Date | null,\n  locale?: string,\n): { startDate: string; endDate: string } => {\n  const startDate = normalizeToDate(startDateInput)\n  const endDate = normalizeToDate(endDateInput)\n\n  if (!startDate || !endDate) {\n    return { startDate: '', endDate: '' }\n  }\n\n  const startFormatted = startDate.toLocaleDateString(locale, {\n    month: 'long',\n    day: 'numeric',\n  })\n\n  const endFormatted = endDate.toLocaleDateString(locale, {\n    month: 'short',\n    day: 'numeric',\n    year: 'numeric',\n  })\n\n  return { startDate: startFormatted, endDate: endFormatted }\n}\n\nexport const formatPayPeriodRange = (\n  startDateInput?: string | Date | null,\n  endDateInput?: string | Date | null,\n  locale?: string,\n  options?: { useShortMonth?: boolean },\n): string => {\n  const startDate = normalizeToDate(startDateInput)\n  const endDate = normalizeToDate(endDateInput)\n\n  if (!startDate || !endDate) return ''\n\n  const monthFormat = options?.useShortMonth ? 'short' : 'long'\n\n  const startFormatted = startDate.toLocaleDateString(locale, {\n    month: monthFormat,\n    day: 'numeric',\n  })\n\n  const endFormatted = endDate.toLocaleDateString(locale, {\n    month: monthFormat,\n    day: 'numeric',\n    year: 'numeric',\n  })\n\n  return `${startFormatted}–${endFormatted}`\n}\n\nexport const formatDateToStringDate = (date: Date): string | null => {\n  if (isNaN(date.getTime())) {\n    return null\n  }\n  const year = String(date.getFullYear()).padStart(4, '0')\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  return `${year}-${month}-${day}`\n}\n\n/**\n * Converts any parseable date string to a `YYYY-MM-DD` ISO string using local\n * time, so the calendar date is preserved regardless of the runtime timezone.\n *\n * Unlike `formatDateToStringDate` (which reads UTC), this function reads the\n * local year/month/day — safe for dates parsed from locale-format strings\n * (e.g. \"4/16/1998\") or ISO strings, both of which `normalizeToDate` lands at\n * local midnight.\n *\n * Returns `''` for null, undefined, empty, or unparseable input.\n */\nexport const normalizeToISOString = (value?: string | null): string => {\n  if (!value) return ''\n  const date = normalizeToDate(value)\n  if (!date) return ''\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  return `${year}-${month}-${day}`\n}\n\n/**\n * Normalizes Date to local midnight, handling timezone issues from any adapter.\n */\nexport const normalizeDateToLocal = (date: Date | null): Date | null => {\n  if (!date || isNaN(date.getTime())) {\n    return null\n  }\n  return new Date(date.getFullYear(), date.getMonth(), date.getDate())\n}\n\nexport const MS_PER_HOUR = 1000 * 60 * 60\nconst MS_PER_DAY = MS_PER_HOUR * 24\n\nexport const getHoursUntil = (deadline?: Date | string | null): number | null => {\n  const deadlineDate = normalizeToDate(deadline)\n  if (!deadlineDate) return null\n\n  const now = new Date()\n  const timeDiffMs = deadlineDate.getTime() - now.getTime()\n  return timeDiffMs / MS_PER_HOUR\n}\n\nexport const getDaysUntil = (deadline?: Date | string | null): number | null => {\n  const deadlineDate = normalizeToDate(deadline)\n  if (!deadlineDate) return null\n\n  const now = new Date()\n  const timeDiffMs = deadlineDate.getTime() - now.getTime()\n  return timeDiffMs / MS_PER_DAY\n}\n\nexport const isWeekend = (date: Date): boolean => {\n  const day = date.getDay()\n  return day === 0 || day === 6\n}\n\nexport const addDays = (date: Date, days: number): Date => {\n  const result = new Date(date)\n  result.setDate(result.getDate() + days)\n  return result\n}\n\nexport const addBusinessDays = (startDate: Date, businessDays: number): Date => {\n  let currentDate = new Date(startDate)\n  currentDate.setHours(0, 0, 0, 0)\n  let daysAdded = 0\n\n  while (daysAdded < businessDays) {\n    currentDate = addDays(currentDate, 1)\n    if (!isWeekend(currentDate)) {\n      daysAdded++\n    }\n  }\n\n  return currentDate\n}\n\n/** Formats numeric month and day as a zero-padded `MM-DD` string. */\nexport function formatMonthDay(month?: number, day?: number): string | undefined {\n  if (month == null || day == null) return undefined\n  return `${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`\n}\n\n/** Returns the number of days in a given month (1-indexed). Uses a non-leap year so February always returns 28. */\nexport function getDaysInMonth(month: number): number {\n  return new Date(2023, month, 0).getDate()\n}\n"],"names":["normalizeToDate","dateInput","parts","numbers","year","month","day","parsedDate","createDateFormatter","options","locale","date","formatDateShortWithWeekday","formatDateShortWithWeekdayAndYear","formatDateShort","formatDateShortWithYear","formatDateLong","formatDateLongWithYear","formatDateWithTime","time","dateString","formatPayPeriod","startDateInput","endDateInput","startDate","endDate","startFormatted","endFormatted","formatPayPeriodRange","monthFormat","formatDateToStringDate","normalizeToISOString","value","normalizeDateToLocal","MS_PER_HOUR","MS_PER_DAY","getHoursUntil","deadline","deadlineDate","now","getDaysUntil","isWeekend","addDays","days","result","addBusinessDays","businessDays","currentDate","daysAdded","formatMonthDay","getDaysInMonth"],"mappings":"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"}
+{"version":3,"file":"dateFormatting.js","sources":["../../src/helpers/dateFormatting.ts"],"sourcesContent":["/**\n * Normalizes any date input (string, Date, or undefined) to a Date object.\n *\n * @remarks Handles `YYYY-MM-DD` strings by parsing them in local time to avoid\n * timezone drift. Also accepts ISO timestamp strings and existing `Date`\n * instances. Returns `null` for nullish, empty, or unparseable input.\n *\n * @param dateInput - The date value to normalize.\n * @returns A `Date` instance, or `null` if the input is missing or invalid.\n * @internal\n */\nexport const normalizeToDate = (dateInput?: string | Date | null): Date | null => {\n  if (!dateInput) return null\n\n  if (typeof dateInput === 'string') {\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(dateInput)) {\n      const parts = dateInput.split('-')\n      if (parts.length !== 3) return null\n\n      const numbers = parts.map(Number)\n      const year = numbers[0]\n      const month = numbers[1]\n      const day = numbers[2]\n      if (year === undefined || month === undefined || day === undefined) {\n        return null\n      }\n\n      if (\n        isNaN(year) ||\n        isNaN(month) ||\n        isNaN(day) ||\n        month < 1 ||\n        month > 12 ||\n        day < 1 ||\n        day > 31\n      ) {\n        return null\n      }\n\n      return new Date(year, month - 1, day)\n    }\n\n    const parsedDate = new Date(dateInput)\n    return isNaN(parsedDate.getTime()) ? null : parsedDate\n  }\n\n  if (dateInput instanceof Date) {\n    return isNaN(dateInput.getTime()) ? null : dateInput\n  }\n\n  return null\n}\n\n/**\n * Creates a date formatter function that handles both string and Date inputs.\n */\nconst createDateFormatter =\n  (options: Intl.DateTimeFormatOptions) =>\n  (dateInput?: string | Date | null, locale?: string): string => {\n    const date = normalizeToDate(dateInput)\n    if (!date) return ''\n    return date.toLocaleDateString(locale, options)\n  }\n\n/**\n * Formats a date as a short weekday plus short month and day (e.g. `Mon, Jan 5`).\n *\n * @internal\n */\nexport const formatDateShortWithWeekday = createDateFormatter({\n  weekday: 'short',\n  month: 'short',\n  day: 'numeric',\n})\n\n/**\n * Formats a date as a short weekday, short month, day, and year (e.g. `Mon, Jan 5, 2025`).\n *\n * @internal\n */\nexport const formatDateShortWithWeekdayAndYear = createDateFormatter({\n  weekday: 'short',\n  month: 'short',\n  day: 'numeric',\n  year: 'numeric',\n})\n\n/**\n * Formats a date as a short month and day (e.g. `Jan 5`).\n *\n * @internal\n */\nexport const formatDateShort = createDateFormatter({\n  month: 'short',\n  day: 'numeric',\n})\n\n/**\n * Formats a date as a short month, day, and year (e.g. `Jan 5, 2025`).\n *\n * @internal\n */\nexport const formatDateShortWithYear = createDateFormatter({\n  month: 'short',\n  day: 'numeric',\n  year: 'numeric',\n})\n\n/**\n * Formats a date as a long month and day (e.g. `January 5`).\n *\n * @internal\n */\nexport const formatDateLong = createDateFormatter({\n  month: 'long',\n  day: 'numeric',\n})\n\n/**\n * Formats a date as a long month, day, and year (e.g. `January 5, 2025`).\n *\n * @internal\n */\nexport const formatDateLongWithYear = createDateFormatter({\n  month: 'long',\n  day: 'numeric',\n  year: 'numeric',\n})\n\n/**\n * Splits a date into separate locale-formatted time and date strings.\n *\n * @param dateInput - The date value to format.\n * @param locale - Optional BCP 47 locale tag passed to `toLocaleString`.\n * @returns An object with `time` (e.g. `3:45 PM EST`) and `date` (e.g. `Mon, Jan 5`).\n * Both fields are empty strings when the input cannot be parsed.\n * @internal\n */\nexport const formatDateWithTime = (\n  dateInput?: string | Date | null,\n  locale?: string,\n): { time: string; date: string } => {\n  const date = normalizeToDate(dateInput)\n  if (!date) return { time: '', date: '' }\n\n  const time = date.toLocaleTimeString(locale, {\n    hour: 'numeric',\n    minute: '2-digit',\n    hour12: true,\n    timeZoneName: 'short',\n  })\n\n  const dateString = date.toLocaleDateString(locale, {\n    weekday: 'short',\n    month: 'short',\n    day: 'numeric',\n  })\n\n  return { time, date: dateString }\n}\n\n/**\n * Formats a pay period start and end date for display as separate fields.\n *\n * @remarks Start date renders with the long month and day; end date renders\n * with the short month, day, and year.\n *\n * @param startDateInput - Pay period start date.\n * @param endDateInput - Pay period end date.\n * @param locale - Optional BCP 47 locale tag passed to `toLocaleDateString`.\n * @returns Formatted `startDate` and `endDate` strings. Both fields are empty\n * strings when either input cannot be parsed.\n * @internal\n */\nexport const formatPayPeriod = (\n  startDateInput?: string | Date | null,\n  endDateInput?: string | Date | null,\n  locale?: string,\n): { startDate: string; endDate: string } => {\n  const startDate = normalizeToDate(startDateInput)\n  const endDate = normalizeToDate(endDateInput)\n\n  if (!startDate || !endDate) {\n    return { startDate: '', endDate: '' }\n  }\n\n  const startFormatted = startDate.toLocaleDateString(locale, {\n    month: 'long',\n    day: 'numeric',\n  })\n\n  const endFormatted = endDate.toLocaleDateString(locale, {\n    month: 'short',\n    day: 'numeric',\n    year: 'numeric',\n  })\n\n  return { startDate: startFormatted, endDate: endFormatted }\n}\n\n/**\n * Formats a pay period as a single en-dash–separated range string.\n *\n * @param startDateInput - Pay period start date.\n * @param endDateInput - Pay period end date.\n * @param locale - Optional BCP 47 locale tag passed to `toLocaleDateString`.\n * @param options - When `useShortMonth` is true, both ends use short month names.\n * Otherwise the start uses the long month name and the end uses short.\n * @returns The formatted range (e.g. `January 1–Jan 15, 2025`), or an empty\n * string when either input cannot be parsed.\n * @internal\n */\nexport const formatPayPeriodRange = (\n  startDateInput?: string | Date | null,\n  endDateInput?: string | Date | null,\n  locale?: string,\n  options?: { useShortMonth?: boolean },\n): string => {\n  const startDate = normalizeToDate(startDateInput)\n  const endDate = normalizeToDate(endDateInput)\n\n  if (!startDate || !endDate) return ''\n\n  const monthFormat = options?.useShortMonth ? 'short' : 'long'\n\n  const startFormatted = startDate.toLocaleDateString(locale, {\n    month: monthFormat,\n    day: 'numeric',\n  })\n\n  const endFormatted = endDate.toLocaleDateString(locale, {\n    month: monthFormat,\n    day: 'numeric',\n    year: 'numeric',\n  })\n\n  return `${startFormatted}–${endFormatted}`\n}\n\n/**\n * Formats a `Date` as a `YYYY-MM-DD` string using the local year, month, and day.\n *\n * @param date - The date to format.\n * @returns A zero-padded `YYYY-MM-DD` string, or `null` when the input is an invalid date.\n * @internal\n */\nexport const formatDateToStringDate = (date: Date): string | null => {\n  if (isNaN(date.getTime())) {\n    return null\n  }\n  const year = String(date.getFullYear()).padStart(4, '0')\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  return `${year}-${month}-${day}`\n}\n\n/**\n * Converts any parseable date string to a `YYYY-MM-DD` ISO string using local time.\n *\n * @remarks Reads the local year, month, and day so the calendar date is\n * preserved regardless of the runtime timezone. Safe for dates parsed from\n * locale-format strings (e.g. `4/16/1998`) or ISO strings, both of which land\n * at local midnight when normalized.\n *\n * @param value - The date string to convert.\n * @returns A `YYYY-MM-DD` string, or `''` for nullish, empty, or unparseable input.\n * @internal\n */\nexport const normalizeToISOString = (value?: string | null): string => {\n  if (!value) return ''\n  const date = normalizeToDate(value)\n  if (!date) return ''\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  return `${year}-${month}-${day}`\n}\n\n/**\n * Normalizes a `Date` to local midnight, stripping any time-of-day component.\n *\n * @param date - The date to normalize, or `null`.\n * @returns A new `Date` at local midnight, or `null` when the input is missing or invalid.\n * @internal\n */\nexport const normalizeDateToLocal = (date: Date | null): Date | null => {\n  if (!date || isNaN(date.getTime())) {\n    return null\n  }\n  return new Date(date.getFullYear(), date.getMonth(), date.getDate())\n}\n\n/**\n * Number of milliseconds in one hour.\n *\n * @internal\n */\nexport const MS_PER_HOUR = 1000 * 60 * 60\nconst MS_PER_DAY = MS_PER_HOUR * 24\n\n/**\n * Returns the number of hours from now until a deadline.\n *\n * @param deadline - Target date in the future (or past, for negative results).\n * @returns Hours until `deadline` (fractional, negative if `deadline` is in\n * the past), or `null` when the input cannot be parsed.\n * @internal\n */\nexport const getHoursUntil = (deadline?: Date | string | null): number | null => {\n  const deadlineDate = normalizeToDate(deadline)\n  if (!deadlineDate) return null\n\n  const now = new Date()\n  const timeDiffMs = deadlineDate.getTime() - now.getTime()\n  return timeDiffMs / MS_PER_HOUR\n}\n\n/**\n * Returns the number of days from now until a deadline.\n *\n * @param deadline - Target date in the future (or past, for negative results).\n * @returns Days until `deadline` (fractional, negative if `deadline` is in\n * the past), or `null` when the input cannot be parsed.\n * @internal\n */\nexport const getDaysUntil = (deadline?: Date | string | null): number | null => {\n  const deadlineDate = normalizeToDate(deadline)\n  if (!deadlineDate) return null\n\n  const now = new Date()\n  const timeDiffMs = deadlineDate.getTime() - now.getTime()\n  return timeDiffMs / MS_PER_DAY\n}\n\n/**\n * Returns whether a date falls on Saturday or Sunday.\n *\n * @param date - The date to test.\n * @returns `true` if `date` is a weekend day.\n * @internal\n */\nconst isWeekend = (date: Date): boolean => {\n  const day = date.getDay()\n  return day === 0 || day === 6\n}\n\n/**\n * Returns a new `Date` offset from the input by a given number of days.\n *\n * @param date - The base date. Not mutated.\n * @param days - Number of days to add (negative values subtract).\n * @returns A new `Date` shifted by `days`.\n * @internal\n */\nexport const addDays = (date: Date, days: number): Date => {\n  const result = new Date(date)\n  result.setDate(result.getDate() + days)\n  return result\n}\n\n/**\n * Returns a new `Date` offset by a given number of business days (Monday–Friday).\n *\n * @remarks Skips Saturdays and Sundays when counting. The result is normalized\n * to local midnight. Does not account for holidays.\n *\n * @param startDate - The base date. Not mutated.\n * @param businessDays - Number of business days to add.\n * @returns A new `Date` shifted forward by `businessDays` weekdays.\n * @internal\n */\nexport const addBusinessDays = (startDate: Date, businessDays: number): Date => {\n  let currentDate = new Date(startDate)\n  currentDate.setHours(0, 0, 0, 0)\n  let daysAdded = 0\n\n  while (daysAdded < businessDays) {\n    currentDate = addDays(currentDate, 1)\n    if (!isWeekend(currentDate)) {\n      daysAdded++\n    }\n  }\n\n  return currentDate\n}\n\n/**\n * Formats numeric month and day as a zero-padded `MM-DD` string.\n *\n * @param month - Month number, 1–12.\n * @param day - Day-of-month number, 1–31.\n * @returns A `MM-DD` string, or `undefined` when either argument is missing.\n * @internal\n */\nexport function formatMonthDay(month?: number, day?: number): string | undefined {\n  if (month == null || day == null) return undefined\n  return `${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`\n}\n\n/**\n * Returns the number of days in a given month (1-indexed).\n *\n * @remarks Uses a non-leap year, so February always returns 28.\n *\n * @param month - Month number, 1–12.\n * @returns The number of days in that month.\n * @internal\n */\nexport function getDaysInMonth(month: number): number {\n  return new Date(2023, month, 0).getDate()\n}\n"],"names":["normalizeToDate","dateInput","parts","numbers","year","month","day","parsedDate","createDateFormatter","options","locale","date","formatDateShortWithWeekday","formatDateShortWithWeekdayAndYear","formatDateShort","formatDateShortWithYear","formatDateLong","formatDateLongWithYear","formatDateWithTime","time","dateString","formatPayPeriod","startDateInput","endDateInput","startDate","endDate","startFormatted","endFormatted","formatPayPeriodRange","monthFormat","formatDateToStringDate","normalizeToISOString","value","normalizeDateToLocal","MS_PER_HOUR","MS_PER_DAY","getHoursUntil","deadline","deadlineDate","now","getDaysUntil","isWeekend","addDays","days","result","addBusinessDays","businessDays","currentDate","daysAdded","formatMonthDay","getDaysInMonth"],"mappings":"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"}

package/dist/helpers/ensureRequired.d.ts

@@ -1 +1,13 @@
+/**
+ * Asserts that a value is defined, throwing a translated error otherwise.
+ *
+ * @remarks Used to narrow `T | undefined` to `T` at call sites where the value
+ * is required by contract but the type system allows `undefined`.
+ *
+ * @typeParam T - The non-undefined value type.
+ * @param prop - The value to assert.
+ * @returns The same value with the `undefined` branch removed from its type.
+ * @throws Error when `prop` is `undefined`.
+ * @internal
+ */
 export declare function ensureRequired<T>(prop: T | undefined): T;

package/dist/helpers/ensureRequired.js.map

@@ -1 +1 @@
-{"version":3,"file":"ensureRequired.js","sources":["../../src/helpers/ensureRequired.ts"],"sourcesContent":["import { t } from 'i18next'\n\nexport function ensureRequired<T>(prop: T | undefined): T {\n  if (prop === undefined) {\n    throw new Error(t('errors.ensureRequired'))\n  }\n  return prop\n}\n"],"names":["ensureRequired","prop","t"],"mappings":";AAEO,SAASA,EAAkBC,GAAwB;AACxD,MAAIA,MAAS;AACX,UAAM,IAAI,MAAMC,EAAE,uBAAuB,CAAC;AAE5C,SAAOD;AACT;"}
+{"version":3,"file":"ensureRequired.js","sources":["../../src/helpers/ensureRequired.ts"],"sourcesContent":["import { t } from 'i18next'\n\n/**\n * Asserts that a value is defined, throwing a translated error otherwise.\n *\n * @remarks Used to narrow `T | undefined` to `T` at call sites where the value\n * is required by contract but the type system allows `undefined`.\n *\n * @typeParam T - The non-undefined value type.\n * @param prop - The value to assert.\n * @returns The same value with the `undefined` branch removed from its type.\n * @throws Error when `prop` is `undefined`.\n * @internal\n */\nexport function ensureRequired<T>(prop: T | undefined): T {\n  if (prop === undefined) {\n    throw new Error(t('errors.ensureRequired'))\n  }\n  return prop\n}\n"],"names":["ensureRequired","prop","t"],"mappings":";AAcO,SAASA,EAAkBC,GAAwB;AACxD,MAAIA,MAAS;AACX,UAAM,IAAI,MAAMC,EAAE,uBAAuB,CAAC;AAE5C,SAAOD;AACT;"}

package/dist/helpers/federalEin.d.ts

@@ -1,9 +1,20 @@
 /**
- * Normalizes string input to a 9 digit EIN format with two leading digits, a dash, and 7 trailing digits removing any non-numeric characters.
+ * Normalizes a raw string to the federal EIN display format `NN-NNNNNNN`.
  *
- * @param value - Raw string value to be formatted as a federal EIN
- * @returns String in the federal EIN format with all invalid characters removed
+ * @remarks Strips non-numeric characters, then inserts a dash between the
+ * first two digits and the remaining seven. Returns an empty string when no
+ * digits are present.
+ *
+ * @param value - Raw string value to be formatted as a federal EIN.
+ * @returns A string in `NN-NNNNNNN` format with non-digit characters removed.
+ * @internal
  */
 export declare const normalizeEin: (value: string) => string;
-export declare const createPlaceholderEin: (hasEin?: boolean, placeholderEin?: string) => string | undefined;
+/**
+ * Hook that returns a translated placeholder string for a masked EIN field.
+ *
+ * @param hasEin - Whether the form currently has a stored EIN value.
+ * @returns The translated placeholder when `hasEin` is true; otherwise an empty string.
+ * @internal
+ */
 export declare const usePlaceholderEin: (hasEin?: boolean) => string | undefined;

package/dist/helpers/federalEin.js

@@ -4,7 +4,6 @@ const r = (n) => n.match(/\d*/g)?.join("").match(/(\d{0,2})(\d{0,7})/)?.slice(1)
   return t(n, e("inputs.ein.placeholder"));
 };
 export {
-  t as createPlaceholderEin,
   r as normalizeEin,
   c as usePlaceholderEin
 };

package/dist/helpers/federalEin.js.map

@@ -1 +1 @@
-{"version":3,"file":"federalEin.js","sources":["../../src/helpers/federalEin.ts"],"sourcesContent":["import { useTranslation } from 'react-i18next'\n\n/**\n * Normalizes string input to a 9 digit EIN format with two leading digits, a dash, and 7 trailing digits removing any non-numeric characters.\n *\n * @param value - Raw string value to be formatted as a federal EIN\n * @returns String in the federal EIN format with all invalid characters removed\n */\nexport const normalizeEin = (value: string) =>\n  value\n    .match(/\\d*/g)\n    ?.join('')\n    .match(/(\\d{0,2})(\\d{0,7})/)\n    ?.slice(1)\n    .filter(match => match !== '')\n    .join('-')\n    .substring(0, 10) || ''\n\nexport const createPlaceholderEin = (hasEin?: boolean, placeholderEin?: string) =>\n  hasEin ? placeholderEin : ''\n\nexport const usePlaceholderEin = (hasEin?: boolean) => {\n  const { t } = useTranslation('common')\n  return createPlaceholderEin(hasEin, t('inputs.ein.placeholder'))\n}\n"],"names":["normalizeEin","value","match","createPlaceholderEin","hasEin","placeholderEin","usePlaceholderEin","t","useTranslation"],"mappings":";AAQO,MAAMA,IAAe,CAACC,MAC3BA,EACG,MAAM,MAAM,GACX,KAAK,EAAE,EACR,MAAM,oBAAoB,GACzB,MAAM,CAAC,EACR,OAAO,CAAAC,MAASA,MAAU,EAAE,EAC5B,KAAK,GAAG,EACR,UAAU,GAAG,EAAE,KAAK,IAEZC,IAAuB,CAACC,GAAkBC,MACrDD,IAASC,IAAiB,IAEfC,IAAoB,CAACF,MAAqB;AACrD,QAAM,EAAE,GAAAG,EAAA,IAAMC,EAAe,QAAQ;AACrC,SAAOL,EAAqBC,GAAQG,EAAE,wBAAwB,CAAC;AACjE;"}
+{"version":3,"file":"federalEin.js","sources":["../../src/helpers/federalEin.ts"],"sourcesContent":["import { useTranslation } from 'react-i18next'\n\n/**\n * Normalizes a raw string to the federal EIN display format `NN-NNNNNNN`.\n *\n * @remarks Strips non-numeric characters, then inserts a dash between the\n * first two digits and the remaining seven. Returns an empty string when no\n * digits are present.\n *\n * @param value - Raw string value to be formatted as a federal EIN.\n * @returns A string in `NN-NNNNNNN` format with non-digit characters removed.\n * @internal\n */\nexport const normalizeEin = (value: string) =>\n  value\n    .match(/\\d*/g)\n    ?.join('')\n    .match(/(\\d{0,2})(\\d{0,7})/)\n    ?.slice(1)\n    .filter(match => match !== '')\n    .join('-')\n    .substring(0, 10) || ''\n\n/**\n * Returns the placeholder EIN to display when an EIN exists but is masked.\n *\n * @param hasEin - Whether the form currently has a stored EIN value.\n * @param placeholderEin - The masked placeholder string to show.\n * @returns The placeholder string when `hasEin` is true; otherwise an empty string.\n * @internal\n */\nconst createPlaceholderEin = (hasEin?: boolean, placeholderEin?: string) =>\n  hasEin ? placeholderEin : ''\n\n/**\n * Hook that returns a translated placeholder string for a masked EIN field.\n *\n * @param hasEin - Whether the form currently has a stored EIN value.\n * @returns The translated placeholder when `hasEin` is true; otherwise an empty string.\n * @internal\n */\nexport const usePlaceholderEin = (hasEin?: boolean) => {\n  const { t } = useTranslation('common')\n  return createPlaceholderEin(hasEin, t('inputs.ein.placeholder'))\n}\n"],"names":["normalizeEin","value","match","createPlaceholderEin","hasEin","placeholderEin","usePlaceholderEin","t","useTranslation"],"mappings":";AAaO,MAAMA,IAAe,CAACC,MAC3BA,EACG,MAAM,MAAM,GACX,KAAK,EAAE,EACR,MAAM,oBAAoB,GACzB,MAAM,CAAC,EACR,OAAO,CAAAC,MAASA,MAAU,EAAE,EAC5B,KAAK,GAAG,EACR,UAAU,GAAG,EAAE,KAAK,IAUnBC,IAAuB,CAACC,GAAkBC,MAC9CD,IAASC,IAAiB,IASfC,IAAoB,CAACF,MAAqB;AACrD,QAAM,EAAE,GAAAG,EAAA,IAAMC,EAAe,QAAQ;AACrC,SAAOL,EAAqBC,GAAQG,EAAE,wBAAwB,CAAC;AACjE;"}

package/dist/helpers/formattedStrings.d.ts

@@ -1,31 +1,102 @@
-import { Location } from '@gusto/embedded-api/models/components/location';
-import { EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress';
+import { Location } from '@gusto/embedded-api-v-2025-11-15/models/components/location';
+import { EmployeeAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeaddress';
 import { TFunction } from 'i18next';
+/**
+ * Joins a first and last name into a single capitalized display string.
+ *
+ * @remarks Each name part is capitalized at its first character. A space is
+ * inserted between the parts only when the last name is present. Missing
+ * parts are treated as empty.
+ *
+ * @param name - Object with optional `first_name` and `last_name` fields.
+ * @returns The combined name, e.g. `Jane Doe`, `Jane`, or `''`.
+ * @internal
+ */
 export declare const firstLastName: ({ first_name, last_name, }: {
     first_name?: string | null;
     last_name?: string | null;
 }) => string;
+/**
+ * Combines an address's two street lines with a comma separator.
+ *
+ * @remarks Each line is prefixed with a leading space when present, producing
+ * a string like ` 123 Main St, Apt 4`. Prefer {@link formatStreetForDisplay}
+ * for new display code; this function is retained for legacy callers.
+ *
+ * @param address - Address whose `street1` and `street2` are joined.
+ * @returns The joined street string.
+ * @internal
+ */
 export declare const getStreet: (address: EmployeeAddress | Location) => string;
-/** Joins street lines with a comma for display (avoids getStreet’s leading-space/comma quirks). */
+/**
+ * Joins an address's street lines with a comma for display.
+ *
+ * @remarks Trims each line and skips empty values, avoiding the leading-space
+ * and trailing-comma artifacts of {@link getStreet}.
+ *
+ * @param address - Address whose `street1` and `street2` are joined.
+ * @returns The display-formatted street string, e.g. `123 Main St, Apt 4`.
+ * @internal
+ */
 export declare const formatStreetForDisplay: (address: EmployeeAddress | Location) => string;
+/**
+ * Formats an address's city, state, and zip into a single display string.
+ *
+ * @param address - Address whose `city`, `state`, and `zip` are joined.
+ * @returns A `City, State Zip` string. Empty fields are skipped.
+ * @internal
+ */
 export declare const getCityStateZip: (address: EmployeeAddress | Location) => string;
+/**
+ * Formats a full address as a single inline string.
+ *
+ * @param address - The address to format.
+ * @returns The combined street and city/state/zip string.
+ * @internal
+ */
 export declare const addressInline: (address: EmployeeAddress | Location) => string;
-export declare const currentDateString: () => string;
-export declare function isNumberKey({ which, keyCode }: KeyboardEvent): boolean;
-export declare const booleanToString: (value: boolean) => "true" | "false";
-export declare const amountStr: (amount: string, isPercentage: boolean) => string;
+/**
+ * Formats a number as a USD currency string with two decimal places.
+ *
+ * @param amount - The numeric value to format.
+ * @param locale - Optional BCP 47 locale tag passed to `toLocaleString`.
+ * Defaults to `en-US`.
+ * @returns A `$1,234.56` style currency string.
+ * @internal
+ */
 export declare const formatNumberAsCurrency: (amount: number, locale?: string) => string;
+/**
+ * Formats a pay rate with its payment unit, annualizing weekly and monthly values.
+ *
+ * @remarks Hourly, yearly, and paycheck rates are displayed at the input
+ * value. Weekly rates are multiplied by 52 and monthly rates by 12 to express
+ * an annualized amount. Unknown payment units render as the currency value
+ * alone.
+ *
+ * @param args - Formatting inputs: `rate` (numeric value), `paymentUnit`
+ * (`Hour`, `Week`, `Month`, `Year`, or `Paycheck`), `t` (i18next translation
+ * function), and optional `locale` (BCP 47 tag, default `en-US`).
+ * @returns The translated, formatted pay rate string.
+ * @internal
+ */
 export declare const formatPayRate: ({ rate, paymentUnit, t, locale, }: {
     rate: number;
     paymentUnit: string;
     t: TFunction;
     locale?: string;
 }) => string;
-export declare const useFormatPayRate: () => (rate: number, paymentUnit: string) => string;
 /**
- * Formats a compensation rate as-is, without annualizing weekly or monthly
- * values. Use this for displaying compensation card data where the stored rate
- * should be shown directly (e.g. "$950 per week", "$3,500 per month").
+ * Formats a compensation rate as-is, without annualizing weekly or monthly values.
+ *
+ * @remarks Use for displaying compensation card data where the stored rate
+ * should be shown directly (e.g. `$950 per week`, `$3,500 per month`).
+ * Unknown payment units render as the currency value alone.
+ *
+ * @param args - Formatting inputs: `rate` (numeric value), `paymentUnit`
+ * (`Hour`, `Week`, `Month`, `Year`, or `Paycheck`), `t` (i18next translation
+ * function), and optional `locale` (BCP 47 tag, default `en-US`).
+ * @returns The translated, formatted compensation rate string.
+ * @internal
  */
 export declare const formatCompensationRate: ({ rate, paymentUnit, t, locale, }: {
     rate: number;
@@ -33,12 +104,78 @@ export declare const formatCompensationRate: ({ rate, paymentUnit, t, locale, }:
     t: TFunction;
     locale?: string;
 }) => string;
+/**
+ * Hook that returns a memoized {@link formatCompensationRate} bound to the active locale.
+ *
+ * @returns A callback `(rate, paymentUnit) => string`.
+ * @internal
+ */
 export declare const useFormatCompensationRate: () => (rate: number, paymentUnit: string) => string;
+/**
+ * Sanitizes an HTML string for use with React's `dangerouslySetInnerHTML`.
+ *
+ * @remarks Only `<a>`, `<b>`, and `<strong>` tags are allowed, and `<a>`
+ * elements may retain only `href` and `target` attributes. All other markup
+ * is stripped via DOMPurify.
+ *
+ * @param dirty - The raw HTML string to sanitize.
+ * @returns An object shaped for `dangerouslySetInnerHTML`. The `__html`
+ * field is `''` when the input is empty.
+ * @internal
+ */
 export declare function createMarkup(dirty: string): {
     __html: string;
 };
+/**
+ * Removes all non-digit characters from a string.
+ *
+ * @param value - The string to filter.
+ * @returns The input with only the digit characters `0`–`9` retained.
+ * @internal
+ */
 export declare const removeNonDigits: (value: string) => string;
+/**
+ * Strips the trailing `.value` segment from an API error path.
+ *
+ * @remarks API validation errors target a `.value` field on the inner
+ * object, but react-hook-form registers the field under its bare name.
+ * Stripping `.value` aligns the error path with the form field name.
+ *
+ * @param errorKey - The dotted error path returned by the API.
+ * @returns The error key without a trailing `.value`.
+ * @internal
+ */
 export declare const normalizeErrorKeyForForm: (errorKey: string) => string;
+/**
+ * Converts a `snake_case` string to `camelCase`.
+ *
+ * @param s - The snake_case string to convert.
+ * @returns The camelCase equivalent.
+ * @internal
+ */
 export declare const snakeCaseToCamelCase: (s: string) => string;
+/**
+ * Converts a `camelCase` or `PascalCase` string to `snake_case`.
+ *
+ * @remarks Handles consecutive uppercase letters by inserting a separator
+ * before the final letter of a run that is followed by a lowercase letter
+ * (e.g. `HTMLParser` becomes `html_parser`).
+ *
+ * @param s - The camelCase or PascalCase string to convert.
+ * @returns The snake_case equivalent in lower case.
+ * @internal
+ */
 export declare const camelCaseToSnakeCase: (s: string) => string;
+/**
+ * Formats a US phone number as `NNN-NNN-NNNN` for display.
+ *
+ * @remarks Strips non-digit characters before formatting. A leading `1`
+ * country code on 11-digit inputs is dropped. Inputs that are not 10 or 11
+ * digits are returned as the raw digit string. Returns an empty string for
+ * nullish input.
+ *
+ * @param phoneNumber - The phone number to format.
+ * @returns The formatted phone number, the digit-only fallback, or `''`.
+ * @internal
+ */
 export declare const formatPhoneNumber: (phoneNumber: string | number | null | undefined) => string;

package/dist/helpers/formattedStrings.js

@@ -81,7 +81,6 @@ const g = (t) => t.replace(/\D/g, ""), z = (t) => t.replace(/\.value$/, ""), P =
 };
 export {
   L as addressInline,
-  f as amountStr,
   b as createMarkup,
   S as firstLastName,
   $ as formatCompensationRate,

package/dist/helpers/formattedStrings.js.map

@@ -1 +1 @@
-{"version":3,"file":"formattedStrings.js","sources":["../../src/helpers/formattedStrings.ts"],"sourcesContent":["import DOMPurify from 'dompurify'\nimport { type Location } from '@gusto/embedded-api/models/components/location'\nimport { type EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress'\nimport { type TFunction } from 'i18next'\nimport { useTranslation } from 'react-i18next'\nimport { useCallback } from 'react'\nimport { useLocale } from '@/contexts/LocaleProvider/useLocale'\n\nconst capitalize = (word: string) => word.charAt(0).toLocaleUpperCase() + word.slice(1)\n\nexport const firstLastName = ({\n  first_name,\n  last_name,\n}: {\n  first_name?: string | null\n  last_name?: string | null\n}) =>\n  `${first_name ? capitalize(first_name) : ''}${last_name ? maybeString(capitalize(last_name)) : ''}`\n\nconst maybeString = (str: string | null | undefined) => {\n  return str ? ` ${str}` : ''\n}\n\nexport const getStreet = (address: EmployeeAddress | Location) => {\n  const street1 = maybeString(address.street1)\n  const street2 = maybeString(address.street2)\n\n  return `${street1},${street2}`\n}\n\n/** Joins street lines with a comma for display (avoids getStreet’s leading-space/comma quirks). */\nexport const formatStreetForDisplay = (address: EmployeeAddress | Location) => {\n  const parts = [address.street1?.trim(), address.street2?.trim()].filter((part): part is string =>\n    Boolean(part),\n  )\n  return parts.join(', ')\n}\n\nexport const getCityStateZip = (address: EmployeeAddress | Location) =>\n  `${maybeString(address.city)}, ${maybeString(address.state)} ${maybeString(address.zip)}`\n\nexport const addressInline = (address: EmployeeAddress | Location) =>\n  `${getStreet(address)} ${getCityStateZip(address)}`\n\nexport const currentDateString = () => {\n  const d = new Date()\n  const dateString = `${String(d.getFullYear())}-${('0' + String(d.getMonth() + 1)).slice(-2)}-${('0' + String(d.getDate())).slice(-2)}`\n  return dateString\n}\n\nexport function isNumberKey({ which, keyCode }: KeyboardEvent) {\n  const charCode = which ? which : keyCode\n  if (charCode > 31 && charCode != 46 && (charCode < 48 || charCode > 57)) return false\n  return true\n}\n\nexport const booleanToString = (value: boolean) => (value ? 'true' : 'false')\n\nexport const amountStr = (amount: string, isPercentage: boolean) =>\n  isPercentage ? `${amount}%` : `$${amount}`\n\nexport const formatNumberAsCurrency = (amount: number, locale: string = 'en-US') => {\n  const formattedNumber = amount.toLocaleString(locale, {\n    minimumFractionDigits: 2,\n    maximumFractionDigits: 2,\n  })\n  return amountStr(formattedNumber, false)\n}\n\nexport const formatPayRate = ({\n  rate,\n  paymentUnit,\n  t,\n  locale = 'en-US',\n}: {\n  rate: number\n  paymentUnit: string\n  t: TFunction\n  locale?: string\n}) => {\n  const amount = formatNumberAsCurrency(rate, locale)\n\n  switch (paymentUnit) {\n    case 'Hour':\n      return t('payRateFormats.hourly', { amount, ns: 'common' })\n    case 'Week':\n      return t('payRateFormats.weekly', {\n        amount: formatNumberAsCurrency(rate * 52, locale),\n        ns: 'common',\n      })\n    case 'Month':\n      return t('payRateFormats.monthly', {\n        amount: formatNumberAsCurrency(rate * 12, locale),\n        ns: 'common',\n      })\n    case 'Year':\n      return t('payRateFormats.yearly', { amount, ns: 'common' })\n    case 'Paycheck':\n      return t('payRateFormats.paycheck', { amount, ns: 'common' })\n    default:\n      return amount\n  }\n}\n\nexport const useFormatPayRate = () => {\n  const { t } = useTranslation('common')\n  const { locale } = useLocale()\n\n  return useCallback(\n    (rate: number, paymentUnit: string) => {\n      return formatPayRate({ rate, paymentUnit, t, locale })\n    },\n    [t, locale],\n  )\n}\n\n/**\n * Formats a compensation rate as-is, without annualizing weekly or monthly\n * values. Use this for displaying compensation card data where the stored rate\n * should be shown directly (e.g. \"$950 per week\", \"$3,500 per month\").\n */\nexport const formatCompensationRate = ({\n  rate,\n  paymentUnit,\n  t,\n  locale = 'en-US',\n}: {\n  rate: number\n  paymentUnit: string\n  t: TFunction\n  locale?: string\n}) => {\n  const amount = formatNumberAsCurrency(rate, locale)\n\n  switch (paymentUnit) {\n    case 'Hour':\n      return t('compensationRateFormats.hourly', { amount, ns: 'common' })\n    case 'Week':\n      return t('compensationRateFormats.weekly', { amount, ns: 'common' })\n    case 'Month':\n      return t('compensationRateFormats.monthly', { amount, ns: 'common' })\n    case 'Year':\n      return t('compensationRateFormats.yearly', { amount, ns: 'common' })\n    case 'Paycheck':\n      return t('compensationRateFormats.paycheck', { amount, ns: 'common' })\n    default:\n      return amount\n  }\n}\n\nexport const useFormatCompensationRate = () => {\n  const { t } = useTranslation('common')\n  const { locale } = useLocale()\n\n  return useCallback(\n    (rate: number, paymentUnit: string) => {\n      return formatCompensationRate({ rate, paymentUnit, t, locale })\n    },\n    [t, locale],\n  )\n}\n\nconst dompurifyConfig = { ALLOWED_TAGS: ['a', 'b', 'strong'], ALLOWED_ATTR: ['href', 'target'] }\nexport function createMarkup(dirty: string) {\n  if (!dirty) return { __html: '' }\n  return { __html: DOMPurify.sanitize(dirty, dompurifyConfig) }\n}\n\nexport const removeNonDigits = (value: string): string => {\n  return value.replace(/\\D/g, '')\n}\n\nexport const normalizeErrorKeyForForm = (errorKey: string): string =>\n  errorKey.replace(/\\.value$/, '')\n\nexport const snakeCaseToCamelCase = (s: string) => {\n  return s.replace(/_([a-z])/g, (_: string, char: string) => char.toUpperCase())\n}\n\nexport const camelCaseToSnakeCase = (s: string) => {\n  return s\n    .replace(\n      /([a-z0-9])([A-Z])/g,\n      (_: string, group1: string, group2: string) => `${group1}_${group2.toLowerCase()}`,\n    )\n    .replace(\n      /([A-Z])([A-Z])(?=[a-z])/g,\n      (_: string, group1: string, group2: string) =>\n        `${group1.toLowerCase()}_${group2.toLowerCase()}`,\n    )\n    .toLowerCase()\n}\n\nexport const formatPhoneNumber = (phoneNumber: string | number | null | undefined): string => {\n  if (!phoneNumber) return ''\n\n  const digits = removeNonDigits(String(phoneNumber))\n\n  if (digits.length === 10) {\n    return `${digits.slice(0, 3)}-${digits.slice(3, 6)}-${digits.slice(6)}`\n  }\n\n  if (digits.length === 11 && digits.startsWith('1')) {\n    return `${digits.slice(1, 4)}-${digits.slice(4, 7)}-${digits.slice(7)}`\n  }\n\n  return digits || ''\n}\n"],"names":["capitalize","word","firstLastName","first_name","last_name","maybeString","str","getStreet","address","street1","street2","formatStreetForDisplay","part","getCityStateZip","addressInline","amountStr","amount","isPercentage","formatNumberAsCurrency","locale","formattedNumber","formatPayRate","rate","paymentUnit","t","formatCompensationRate","useFormatCompensationRate","useTranslation","useLocale","useCallback","dompurifyConfig","createMarkup","dirty","DOMPurify","removeNonDigits","value","normalizeErrorKeyForForm","errorKey","snakeCaseToCamelCase","s","_","char","formatPhoneNumber","phoneNumber","digits"],"mappings":"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"}
+{"version":3,"file":"formattedStrings.js","sources":["../../src/helpers/formattedStrings.ts"],"sourcesContent":["import DOMPurify from 'dompurify'\nimport { type Location } from '@gusto/embedded-api-v-2025-11-15/models/components/location'\nimport { type EmployeeAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeaddress'\nimport { type TFunction } from 'i18next'\nimport { useTranslation } from 'react-i18next'\nimport { useCallback } from 'react'\nimport { useLocale } from '@/contexts/LocaleProvider/useLocale'\n\nconst capitalize = (word: string) => word.charAt(0).toLocaleUpperCase() + word.slice(1)\n\n/**\n * Joins a first and last name into a single capitalized display string.\n *\n * @remarks Each name part is capitalized at its first character. A space is\n * inserted between the parts only when the last name is present. Missing\n * parts are treated as empty.\n *\n * @param name - Object with optional `first_name` and `last_name` fields.\n * @returns The combined name, e.g. `Jane Doe`, `Jane`, or `''`.\n * @internal\n */\nexport const firstLastName = ({\n  first_name,\n  last_name,\n}: {\n  first_name?: string | null\n  last_name?: string | null\n}) =>\n  `${first_name ? capitalize(first_name) : ''}${last_name ? maybeString(capitalize(last_name)) : ''}`\n\nconst maybeString = (str: string | null | undefined) => {\n  return str ? ` ${str}` : ''\n}\n\n/**\n * Combines an address's two street lines with a comma separator.\n *\n * @remarks Each line is prefixed with a leading space when present, producing\n * a string like ` 123 Main St, Apt 4`. Prefer {@link formatStreetForDisplay}\n * for new display code; this function is retained for legacy callers.\n *\n * @param address - Address whose `street1` and `street2` are joined.\n * @returns The joined street string.\n * @internal\n */\nexport const getStreet = (address: EmployeeAddress | Location) => {\n  const street1 = maybeString(address.street1)\n  const street2 = maybeString(address.street2)\n\n  return `${street1},${street2}`\n}\n\n/**\n * Joins an address's street lines with a comma for display.\n *\n * @remarks Trims each line and skips empty values, avoiding the leading-space\n * and trailing-comma artifacts of {@link getStreet}.\n *\n * @param address - Address whose `street1` and `street2` are joined.\n * @returns The display-formatted street string, e.g. `123 Main St, Apt 4`.\n * @internal\n */\nexport const formatStreetForDisplay = (address: EmployeeAddress | Location) => {\n  const parts = [address.street1?.trim(), address.street2?.trim()].filter((part): part is string =>\n    Boolean(part),\n  )\n  return parts.join(', ')\n}\n\n/**\n * Formats an address's city, state, and zip into a single display string.\n *\n * @param address - Address whose `city`, `state`, and `zip` are joined.\n * @returns A `City, State Zip` string. Empty fields are skipped.\n * @internal\n */\nexport const getCityStateZip = (address: EmployeeAddress | Location) =>\n  `${maybeString(address.city)}, ${maybeString(address.state)} ${maybeString(address.zip)}`\n\n/**\n * Formats a full address as a single inline string.\n *\n * @param address - The address to format.\n * @returns The combined street and city/state/zip string.\n * @internal\n */\nexport const addressInline = (address: EmployeeAddress | Location) =>\n  `${getStreet(address)} ${getCityStateZip(address)}`\n\n/**\n * Wraps an amount string with a currency or percent symbol.\n *\n * @param amount - Pre-formatted numeric string.\n * @param isPercentage - When `true`, appends `%`; otherwise prepends `$`.\n * @returns The amount with the appropriate symbol.\n * @internal\n */\nconst amountStr = (amount: string, isPercentage: boolean) =>\n  isPercentage ? `${amount}%` : `$${amount}`\n\n/**\n * Formats a number as a USD currency string with two decimal places.\n *\n * @param amount - The numeric value to format.\n * @param locale - Optional BCP 47 locale tag passed to `toLocaleString`.\n * Defaults to `en-US`.\n * @returns A `$1,234.56` style currency string.\n * @internal\n */\nexport const formatNumberAsCurrency = (amount: number, locale: string = 'en-US') => {\n  const formattedNumber = amount.toLocaleString(locale, {\n    minimumFractionDigits: 2,\n    maximumFractionDigits: 2,\n  })\n  return amountStr(formattedNumber, false)\n}\n\n/**\n * Formats a pay rate with its payment unit, annualizing weekly and monthly values.\n *\n * @remarks Hourly, yearly, and paycheck rates are displayed at the input\n * value. Weekly rates are multiplied by 52 and monthly rates by 12 to express\n * an annualized amount. Unknown payment units render as the currency value\n * alone.\n *\n * @param args - Formatting inputs: `rate` (numeric value), `paymentUnit`\n * (`Hour`, `Week`, `Month`, `Year`, or `Paycheck`), `t` (i18next translation\n * function), and optional `locale` (BCP 47 tag, default `en-US`).\n * @returns The translated, formatted pay rate string.\n * @internal\n */\nexport const formatPayRate = ({\n  rate,\n  paymentUnit,\n  t,\n  locale = 'en-US',\n}: {\n  rate: number\n  paymentUnit: string\n  t: TFunction\n  locale?: string\n}) => {\n  const amount = formatNumberAsCurrency(rate, locale)\n\n  switch (paymentUnit) {\n    case 'Hour':\n      return t('payRateFormats.hourly', { amount, ns: 'common' })\n    case 'Week':\n      return t('payRateFormats.weekly', {\n        amount: formatNumberAsCurrency(rate * 52, locale),\n        ns: 'common',\n      })\n    case 'Month':\n      return t('payRateFormats.monthly', {\n        amount: formatNumberAsCurrency(rate * 12, locale),\n        ns: 'common',\n      })\n    case 'Year':\n      return t('payRateFormats.yearly', { amount, ns: 'common' })\n    case 'Paycheck':\n      return t('payRateFormats.paycheck', { amount, ns: 'common' })\n    default:\n      return amount\n  }\n}\n\n/**\n * Formats a compensation rate as-is, without annualizing weekly or monthly values.\n *\n * @remarks Use for displaying compensation card data where the stored rate\n * should be shown directly (e.g. `$950 per week`, `$3,500 per month`).\n * Unknown payment units render as the currency value alone.\n *\n * @param args - Formatting inputs: `rate` (numeric value), `paymentUnit`\n * (`Hour`, `Week`, `Month`, `Year`, or `Paycheck`), `t` (i18next translation\n * function), and optional `locale` (BCP 47 tag, default `en-US`).\n * @returns The translated, formatted compensation rate string.\n * @internal\n */\nexport const formatCompensationRate = ({\n  rate,\n  paymentUnit,\n  t,\n  locale = 'en-US',\n}: {\n  rate: number\n  paymentUnit: string\n  t: TFunction\n  locale?: string\n}) => {\n  const amount = formatNumberAsCurrency(rate, locale)\n\n  switch (paymentUnit) {\n    case 'Hour':\n      return t('compensationRateFormats.hourly', { amount, ns: 'common' })\n    case 'Week':\n      return t('compensationRateFormats.weekly', { amount, ns: 'common' })\n    case 'Month':\n      return t('compensationRateFormats.monthly', { amount, ns: 'common' })\n    case 'Year':\n      return t('compensationRateFormats.yearly', { amount, ns: 'common' })\n    case 'Paycheck':\n      return t('compensationRateFormats.paycheck', { amount, ns: 'common' })\n    default:\n      return amount\n  }\n}\n\n/**\n * Hook that returns a memoized {@link formatCompensationRate} bound to the active locale.\n *\n * @returns A callback `(rate, paymentUnit) => string`.\n * @internal\n */\nexport const useFormatCompensationRate = () => {\n  const { t } = useTranslation('common')\n  const { locale } = useLocale()\n\n  return useCallback(\n    (rate: number, paymentUnit: string) => {\n      return formatCompensationRate({ rate, paymentUnit, t, locale })\n    },\n    [t, locale],\n  )\n}\n\nconst dompurifyConfig = { ALLOWED_TAGS: ['a', 'b', 'strong'], ALLOWED_ATTR: ['href', 'target'] }\n/**\n * Sanitizes an HTML string for use with React's `dangerouslySetInnerHTML`.\n *\n * @remarks Only `<a>`, `<b>`, and `<strong>` tags are allowed, and `<a>`\n * elements may retain only `href` and `target` attributes. All other markup\n * is stripped via DOMPurify.\n *\n * @param dirty - The raw HTML string to sanitize.\n * @returns An object shaped for `dangerouslySetInnerHTML`. The `__html`\n * field is `''` when the input is empty.\n * @internal\n */\nexport function createMarkup(dirty: string) {\n  if (!dirty) return { __html: '' }\n  return { __html: DOMPurify.sanitize(dirty, dompurifyConfig) }\n}\n\n/**\n * Removes all non-digit characters from a string.\n *\n * @param value - The string to filter.\n * @returns The input with only the digit characters `0`–`9` retained.\n * @internal\n */\nexport const removeNonDigits = (value: string): string => {\n  return value.replace(/\\D/g, '')\n}\n\n/**\n * Strips the trailing `.value` segment from an API error path.\n *\n * @remarks API validation errors target a `.value` field on the inner\n * object, but react-hook-form registers the field under its bare name.\n * Stripping `.value` aligns the error path with the form field name.\n *\n * @param errorKey - The dotted error path returned by the API.\n * @returns The error key without a trailing `.value`.\n * @internal\n */\nexport const normalizeErrorKeyForForm = (errorKey: string): string =>\n  errorKey.replace(/\\.value$/, '')\n\n/**\n * Converts a `snake_case` string to `camelCase`.\n *\n * @param s - The snake_case string to convert.\n * @returns The camelCase equivalent.\n * @internal\n */\nexport const snakeCaseToCamelCase = (s: string) => {\n  return s.replace(/_([a-z])/g, (_: string, char: string) => char.toUpperCase())\n}\n\n/**\n * Converts a `camelCase` or `PascalCase` string to `snake_case`.\n *\n * @remarks Handles consecutive uppercase letters by inserting a separator\n * before the final letter of a run that is followed by a lowercase letter\n * (e.g. `HTMLParser` becomes `html_parser`).\n *\n * @param s - The camelCase or PascalCase string to convert.\n * @returns The snake_case equivalent in lower case.\n * @internal\n */\nexport const camelCaseToSnakeCase = (s: string) => {\n  return s\n    .replace(\n      /([a-z0-9])([A-Z])/g,\n      (_: string, group1: string, group2: string) => `${group1}_${group2.toLowerCase()}`,\n    )\n    .replace(\n      /([A-Z])([A-Z])(?=[a-z])/g,\n      (_: string, group1: string, group2: string) =>\n        `${group1.toLowerCase()}_${group2.toLowerCase()}`,\n    )\n    .toLowerCase()\n}\n\n/**\n * Formats a US phone number as `NNN-NNN-NNNN` for display.\n *\n * @remarks Strips non-digit characters before formatting. A leading `1`\n * country code on 11-digit inputs is dropped. Inputs that are not 10 or 11\n * digits are returned as the raw digit string. Returns an empty string for\n * nullish input.\n *\n * @param phoneNumber - The phone number to format.\n * @returns The formatted phone number, the digit-only fallback, or `''`.\n * @internal\n */\nexport const formatPhoneNumber = (phoneNumber: string | number | null | undefined): string => {\n  if (!phoneNumber) return ''\n\n  const digits = removeNonDigits(String(phoneNumber))\n\n  if (digits.length === 10) {\n    return `${digits.slice(0, 3)}-${digits.slice(3, 6)}-${digits.slice(6)}`\n  }\n\n  if (digits.length === 11 && digits.startsWith('1')) {\n    return `${digits.slice(1, 4)}-${digits.slice(4, 7)}-${digits.slice(7)}`\n  }\n\n  return digits || ''\n}\n"],"names":["capitalize","word","firstLastName","first_name","last_name","maybeString","str","getStreet","address","street1","street2","formatStreetForDisplay","part","getCityStateZip","addressInline","amountStr","amount","isPercentage","formatNumberAsCurrency","locale","formattedNumber","formatPayRate","rate","paymentUnit","t","formatCompensationRate","useFormatCompensationRate","useTranslation","useLocale","useCallback","dompurifyConfig","createMarkup","dirty","DOMPurify","removeNonDigits","value","normalizeErrorKeyForForm","errorKey","snakeCaseToCamelCase","s","_","char","formatPhoneNumber","phoneNumber","digits"],"mappings":"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"}

package/dist/helpers/getDataProps.d.ts

@@ -1,2 +1,13 @@
 import { DataAttributes } from '../types/Helpers';
+/**
+ * Extracts `data-*` attributes from a props object for forwarding to the DOM.
+ *
+ * @remarks Filters out any entry whose key does not begin with `data-` or
+ * whose value is not a string, number, or boolean — matching the runtime
+ * shape that React permits on host elements.
+ *
+ * @param props - The component props to filter.
+ * @returns An object containing only the `data-*` attributes from `props`.
+ * @internal
+ */
 export declare function getDataProps(props: Record<string, unknown>): DataAttributes;