@gusto/embedded-react-sdk 0.48.1 → 0.48.3

package/dist/components/Payroll/helpers.d.ts

@@ -7,51 +7,164 @@ import { PayScheduleShow as PayScheduleObject } from '@gusto/embedded-api-v-2025
 import { Payroll } from '@gusto/embedded-api-v-2025-11-15/models/components/payroll';
 import { PayrollType } from './PayrollList/types';
 import { PayrollCategory } from './payrollTypes';
-export declare const getPrimaryJob: (employee: Employee) => import('@gusto/embedded-api-v-2025-11-15/models/components/job.js').Job | null;
+/**
+ * Formats an employee's primary-job pay rate into a localized display string.
+ *
+ * @remarks
+ * Returns `null` when the employee has no jobs, the primary job has no compensations, or the rate is missing
+ * or zero.
+ *
+ * @param args - The employee, translation function, and locale to format against.
+ * @returns The formatted pay-rate string, or `null` when no usable rate is available.
+ * @internal
+ */
 export declare const formatEmployeePayRate: ({ employee, t, locale, }: {
     employee?: Employee;
     t: TFunction;
     locale?: string;
 }) => string | null;
+/**
+ * Returns a memoized formatter that produces a localized pay-rate string from an employee's primary job.
+ *
+ * @returns A callback that takes an `Employee` and returns the formatted pay-rate string, or `null` when the
+ *   employee has no usable primary-job compensation.
+ * @internal
+ */
 export declare const useFormatEmployeePayRate: () => (employee?: Employee) => string | null;
-export declare const getEmployeePayRateInfo: (employee: Employee | undefined) => {
-    rate: number;
-    paymentUnit: import('@gusto/embedded-api-v-2025-11-15/models/components/compensation').PaymentUnit;
-} | null;
+/**
+ * Sums hourly-compensation rows named `'regular hours'`.
+ *
+ * @param compensation - The employee compensation entry.
+ * @returns The total regular hours worked, or `0` when none are recorded.
+ * @internal
+ */
 export declare const getRegularHours: (compensation: PayrollEmployeeCompensationsType) => number;
+/**
+ * Sums the overtime hours (multiplier greater than `1`) from an employee compensation.
+ *
+ * @param compensation - The employee compensation entry.
+ * @returns The total overtime hours, or `0` when the compensation is excluded or has none.
+ * @internal
+ */
 export declare function getOvertimeHours(compensation: PayrollEmployeeCompensationsType): number;
+/**
+ * Sums the paid-time-off hours from an employee compensation.
+ *
+ * @param compensation - The employee compensation entry.
+ * @returns The total PTO hours, or `0` when none are recorded.
+ * @internal
+ */
 export declare const getTotalPtoHours: (compensation: PayrollEmployeeCompensationsType) => number;
+/**
+ * Sums fixed-compensation amounts excluding reimbursements and minimum-wage adjustments.
+ *
+ * @param compensation - The employee compensation entry.
+ * @returns The total additional earnings amount, or `0` when none qualify.
+ * @internal
+ */
 export declare const getAdditionalEarnings: (compensation: PayrollEmployeeCompensationsType) => number;
+/**
+ * Returns the total reimbursement amount for an employee compensation.
+ *
+ * @remarks
+ * Prefers the explicit `reimbursements` array when present; falls back to a fixed-compensation row named
+ * `'Reimbursement'` for older payroll shapes.
+ *
+ * @param compensation - The employee compensation entry.
+ * @returns The summed reimbursement amount, or `0` when none.
+ * @internal
+ */
 export declare const getReimbursements: (compensation: PayrollEmployeeCompensationsType) => number;
 /**
- * Normalizes a reimbursement list for submission to the v2025-11-15 API:
- *
- * - Drops named rows that would be no-ops on the server (zero amount with no
- *   existing uuid).
- * - Drops named rows with an existing uuid and zero amount — these are removals,
- *   and the backend's `replace_itemized_reimbursements` deletes any persisted
- *   reimbursement whose uuid is omitted from the incoming list.
- * - Consolidates multiple unnamed (description-less) rows into a single unnamed
- *   entry, since the API rejects more than one unnamed reimbursement per employee.
- * - When the consolidated unnamed total is zero, sends no unnamed entry at all.
- *   The backend's full-replace semantics then delete any persisted unnamed entry
- *   (unnamed entries never have uuids, so this is the only way to remove them).
- * - Maps the read shape (`description: string | null`) to the write shape
- *   (`description?: string`), omitting the field when there is no description.
+ * Normalizes a reimbursement list for submission to the v2025-11-15 API.
+ *
+ * @remarks
+ * - Drops named rows that would be no-ops on the server (zero amount with no existing uuid).
+ * - Drops named rows with an existing uuid and zero amount — these are removals, and the backend's
+ *   `replace_itemized_reimbursements` deletes any persisted reimbursement whose uuid is omitted from the
+ *   incoming list.
+ * - Consolidates multiple unnamed (description-less) rows into a single unnamed entry, since the API rejects
+ *   more than one unnamed reimbursement per employee.
+ * - When the consolidated unnamed total is zero, sends no unnamed entry at all. The backend's full-replace
+ *   semantics then delete any persisted unnamed entry (unnamed entries never have uuids, so this is the only
+ *   way to remove them).
+ * - Maps the read shape (`description: string | null`) to the write shape (`description?: string`), omitting
+ *   the field when there is no description.
+ *
+ * @param reimbursements - The reimbursements pulled from the prepared payroll.
+ * @returns The normalized reimbursements ready to send on a payroll update.
+ * @internal
  */
 export declare const cleanupReimbursements: (reimbursements: Reimbursement[]) => PayrollUpdateReimbursements[];
+/**
+ * Formats an hours value for display, rounding to two decimals and ensuring whole numbers render with `.0`.
+ *
+ * @param hours - The hours value to format.
+ * @returns A string like `'40.0'` or `'37.25'`.
+ * @internal
+ */
 export declare const formatHoursDisplay: (hours: number) => string;
+/**
+ * Calculates an employee's gross pay for a payroll, combining regular and overtime pay,
+ * additional earnings, PTO pay, and any minimum-wage adjustment.
+ *
+ * @remarks
+ * Returns `0` when the compensation is excluded or the employee has no primary job compensation effective
+ * on the given date. The result is rounded to two decimal places.
+ *
+ * @param compensation - The employee compensation entry from the payroll.
+ * @param employee - The employee record (used to look up jobs and effective compensations).
+ * @param compensationEffectiveDateString - ISO date used to resolve the effective compensation; defaults to now.
+ * @param paySchedule - The pay schedule, used to derive expected hours per pay period.
+ * @param payrollCategory - The payroll category; off-cycle categories change how PTO hours are summed.
+ * @returns The gross pay amount.
+ * @internal
+ */
 export declare const calculateGrossPay: (compensation: PayrollEmployeeCompensationsType, employee: Employee, compensationEffectiveDateString?: string, paySchedule?: PayScheduleObject, payrollCategory?: PayrollCategory) => number;
+/**
+ * Returns the high-level payroll type — `'External'`, `'Off-Cycle'`, or `'Regular'`.
+ *
+ * @param payroll - The payroll whose type to classify.
+ * @returns The payroll type string.
+ * @internal
+ */
 export declare const getPayrollType: (payroll: {
     external?: boolean;
     offCycle?: boolean;
 }) => PayrollType;
+/**
+ * Returns whether an off-cycle reason indicates a dismissal payroll.
+ *
+ * @param offCycleReason - The payroll's off-cycle reason string.
+ * @returns `true` when the reason matches the dismissed-employee reason.
+ * @internal
+ */
 export declare const isDismissalPayroll: (offCycleReason?: string | null) => boolean;
+/**
+ * Returns a human-readable label describing the payroll type, mapping off-cycle reasons to display strings.
+ *
+ * @param payroll - The payroll whose type to describe.
+ * @returns `'External'`, `'Regular'`, `'Off-Cycle'`, or a label derived from the off-cycle reason
+ *   (e.g. `'Bonus'`, `'Dismissal'`).
+ * @internal
+ */
 export declare const getPayrollTypeLabel: (payroll: {
     external?: boolean;
     offCycle?: boolean;
     offCycleReason?: string | null;
 }) => string;
+/**
+ * Merges existing fixed compensations with placeholder entries for any compensation types the employee
+ * doesn't yet have, then filters out excluded types and sorts the result alphabetically.
+ *
+ * @remarks
+ * Owners (FLSA status `Owner`) never receive placeholder entries. Placeholders are added with `amount: '0.00'`
+ * and the supplied `primaryJobUuid`.
+ *
+ * @param options - Inputs controlling which placeholder entries to add and which types to exclude.
+ * @returns The merged, filtered, and sorted list of fixed compensations.
+ * @internal
+ */
 export declare const getAdditionalEarningsCompensations: ({ flsaStatus, existingFixedCompensations, primaryJobUuid, fixedCompensationTypes, excludedTypes, }: {
     flsaStatus: string | undefined;
     existingFixedCompensations?: FixedCompensations[];
@@ -59,20 +172,38 @@ export declare const getAdditionalEarningsCompensations: ({ flsaStatus, existing
     fixedCompensationTypes?: PayrollFixedCompensationTypesType[];
     excludedTypes?: string[];
 }) => FixedCompensations[];
+/**
+ * Returns whether any non-excluded employee compensation uses Direct Deposit.
+ *
+ * @remarks
+ * When the input is empty or every compensation is excluded, returns `true` so callers don't gate UI on an
+ * empty set.
+ *
+ * @param employeeCompensations - The employee compensations to inspect.
+ * @returns `true` when at least one active compensation pays via Direct Deposit, or when the list is empty.
+ * @internal
+ */
 export declare const hasDirectDepositEmployees: (employeeCompensations?: Array<{
     paymentMethod?: string | null;
     excluded?: boolean;
 }>) => boolean;
+/**
+ * Sums gross pay, employer taxes, reimbursements, and benefits from a payroll's totals.
+ *
+ * @param payrollData - The payroll whose totals to sum.
+ * @returns The total payroll cost, or `0` when `payrollData.totals` is missing.
+ * @internal
+ */
 export declare const calculateTotalPayroll: (payrollData: Payroll) => number;
 /**
- * Determines if a payroll can be cancelled based on business rules.
+ * Determines whether a payroll can be cancelled based on its status, deadline, and the 4:00 PM PT cutoff.
  *
- * A payroll can be cancelled if all of the following conditions are met:
- * - The payroll has been processed (processed === true)
- * - Current time is before 4:00 PM PT on the payroll deadline
- * - The payrollStatusMeta.cancellable flag is not explicitly false
+ * @remarks
+ * Returns `true` only when the payroll has been processed, `payrollStatusMeta.cancellable` is not explicitly `false`,
+ * the payroll has a `payrollDeadline`, and the current time is before 4:00 PM Pacific Time on that deadline date.
  *
- * This check enforces the business rule that payrolls can only be cancelled
- * before the 4:00 PM PT cutoff time on their deadline date.
+ * @param payroll - The payroll to evaluate.
+ * @returns `true` if the payroll is still cancellable, `false` otherwise.
+ * @internal
  */
 export declare const canCancelPayroll: (payroll: Payroll) => boolean;

package/dist/components/Payroll/helpers.js

@@ -278,7 +278,6 @@ export {
   pe as getAdditionalEarningsCompensations,
   ie as getOvertimeHours,
   ye as getPayrollTypeLabel,
-  p as getPrimaryJob,
   ue as getRegularHours,
   le as getReimbursements,
   _ as getTotalPtoHours,

package/dist/components/Payroll/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["../../../src/components/Payroll/helpers.ts"],"sourcesContent":["import type { Employee } from '@gusto/embedded-api-v-2025-11-15/models/components/employee'\nimport {\n  type PayrollShowFixedCompensations,\n  OffCycleReasonType,\n} from '@gusto/embedded-api-v-2025-11-15/models/components/payroll'\nimport type {\n  PayrollEmployeeCompensationsTypeFixedCompensations as FixedCompensations,\n  PayrollEmployeeCompensationsTypeReimbursements as Reimbursement,\n} from '@gusto/embedded-api-v-2025-11-15/models/components/payrollemployeecompensationstype'\nimport type { PayrollUpdateReimbursements } from '@gusto/embedded-api-v-2025-11-15/models/components/payrollupdate'\nimport type { PayrollFixedCompensationTypesType } from '@gusto/embedded-api-v-2025-11-15/models/components/payrollfixedcompensationtypestype'\nimport { useCallback } from 'react'\nimport type { TFunction } from 'i18next'\nimport { useTranslation } from 'react-i18next'\nimport type { PayScheduleShow as PayScheduleObject } from '@gusto/embedded-api-v-2025-11-15/models/components/payscheduleshow'\nimport type {\n  Compensation,\n  MinimumWages,\n} from '@gusto/embedded-api-v-2025-11-15/models/components/compensation'\nimport type { PayrollEmployeeCompensationsType } from '@gusto/embedded-api-v-2025-11-15/models/components/payrollemployeecompensationstype'\nimport type { Payroll } from '@gusto/embedded-api-v-2025-11-15/models/components/payroll'\nimport type { PayrollType } from './PayrollList/types'\nimport { PayrollCategory, isOffCyclePayroll } from './payrollTypes'\nimport { formatPayRate } from '@/helpers/formattedStrings'\nimport { useLocale } from '@/contexts/LocaleProvider/useLocale'\nimport { FlsaStatus } from '@/shared/constants'\nimport { MS_PER_HOUR } from '@/helpers/dateFormatting'\nconst REGULAR_HOURS_NAME = 'regular hours'\n\n// Utility to get the primary job from an employee\nexport const getPrimaryJob = (employee: Employee) => {\n  return employee.jobs?.find(job => job.primary) || employee.jobs?.[0] || null\n}\n\nconst roundToSixDecimals = (value: number): number => {\n  return Math.round(value * 1_000_000) / 1_000_000\n}\n\nconst roundToTwoDecimals = (value: number): number => {\n  return Math.round(value * 100) / 100\n}\n\nconst isRegularHours = (compensationName: string): boolean => {\n  return compensationName.toLowerCase() === REGULAR_HOURS_NAME\n}\n\nconst PAY_PERIOD_HOURS_MAPPINGS: Record<string, number> = {\n  Daily: 8.0,\n  'Every week': 40.0,\n  'Every other week': 80.0,\n  'Twice per month': 86.666667,\n  Monthly: 173.333333,\n  Quarterly: 520.0,\n  Semiannually: 1040.0,\n  Annually: 2080.0,\n}\n\nexport const formatEmployeePayRate = ({\n  employee,\n  t,\n  locale = 'en-US',\n}: {\n  employee?: Employee\n  t: TFunction\n  locale?: string\n}) => {\n  if (!employee?.jobs) {\n    return null\n  }\n\n  const primaryJob = getPrimaryJob(employee)\n  if (!primaryJob?.compensations) {\n    return null\n  }\n\n  const jobCompensation = primaryJob.compensations[0]\n  if (!jobCompensation) {\n    return null\n  }\n  if (!jobCompensation.rate || parseFloat(jobCompensation.rate) === 0) {\n    return null\n  }\n\n  const rate = parseFloat(jobCompensation.rate)\n  const paymentUnit = jobCompensation.paymentUnit || 'Hour'\n\n  return formatPayRate({ rate, paymentUnit, t, locale })\n}\n\nexport const useFormatEmployeePayRate = () => {\n  const { t } = useTranslation('common')\n  const { locale } = useLocale()\n\n  return useCallback(\n    (employee?: Employee) => {\n      return formatEmployeePayRate({ employee, t, locale })\n    },\n    [t, locale],\n  )\n}\n\nexport const getEmployeePayRateInfo = (employee: Employee | undefined) => {\n  if (!employee?.jobs) {\n    return null\n  }\n\n  const primaryJob = getPrimaryJob(employee)\n  if (!primaryJob?.compensations) {\n    return null\n  }\n\n  const jobCompensation = primaryJob.compensations[0]\n  if (!jobCompensation) {\n    return null\n  }\n  if (!jobCompensation.rate || parseFloat(jobCompensation.rate) === 0) {\n    return null\n  }\n\n  const rate = parseFloat(jobCompensation.rate)\n  const paymentUnit = jobCompensation.paymentUnit || 'Hour'\n\n  return { rate, paymentUnit }\n}\n\nexport const getRegularHours = (compensation: PayrollEmployeeCompensationsType) => {\n  if (!compensation.hourlyCompensations) return 0\n\n  return compensation.hourlyCompensations\n    .filter(hourlyCompensation => hourlyCompensation.name?.toLowerCase() === 'regular hours')\n    .reduce((sum, hourlyCompensation) => sum + parseFloat(hourlyCompensation.hours || '0'), 0)\n}\n\nexport function getOvertimeHours(compensation: PayrollEmployeeCompensationsType) {\n  if (!compensation.hourlyCompensations || compensation.excluded) {\n    return 0\n  }\n\n  return compensation.hourlyCompensations\n    .filter(hourlyCompensation => Number(hourlyCompensation.compensationMultiplier) > 1)\n    .reduce((sum, hourlyCompensation) => sum + parseFloat(hourlyCompensation.hours || '0'), 0)\n}\n\nexport const getTotalPtoHours = (compensation: PayrollEmployeeCompensationsType) => {\n  if (!compensation.paidTimeOff) {\n    return 0\n  }\n  return compensation.paidTimeOff.reduce((sum, pto) => sum + parseFloat(pto.hours || '0'), 0)\n}\n\nexport const getAdditionalEarnings = (compensation: PayrollEmployeeCompensationsType) => {\n  if (!compensation.fixedCompensations) {\n    return 0\n  }\n\n  return compensation.fixedCompensations\n    .filter(fixedCompensation => {\n      const name = fixedCompensation.name?.toLowerCase() || ''\n      const amount = parseFloat(fixedCompensation.amount || '0')\n      return name !== 'reimbursement' && name !== 'minimum wage adjustment' && amount > 0\n    })\n    .reduce((sum, fixedCompensation) => sum + parseFloat(fixedCompensation.amount || '0'), 0)\n}\n\nexport const getReimbursements = (compensation: PayrollEmployeeCompensationsType) => {\n  if (compensation.reimbursements && compensation.reimbursements.length > 0) {\n    return compensation.reimbursements.reduce(\n      (sum, reimbursement) => sum + parseFloat(reimbursement.amount || '0'),\n      0,\n    )\n  }\n\n  if (!compensation.fixedCompensations) {\n    return 0\n  }\n\n  const reimbursementComp = compensation.fixedCompensations.find(\n    fixedCompensation => fixedCompensation.name?.toLowerCase() === 'reimbursement',\n  )\n  return reimbursementComp ? parseFloat(reimbursementComp.amount || '0') : 0\n}\n\n/**\n * Normalizes a reimbursement list for submission to the v2025-11-15 API:\n *\n * - Drops named rows that would be no-ops on the server (zero amount with no\n *   existing uuid).\n * - Drops named rows with an existing uuid and zero amount — these are removals,\n *   and the backend's `replace_itemized_reimbursements` deletes any persisted\n *   reimbursement whose uuid is omitted from the incoming list.\n * - Consolidates multiple unnamed (description-less) rows into a single unnamed\n *   entry, since the API rejects more than one unnamed reimbursement per employee.\n * - When the consolidated unnamed total is zero, sends no unnamed entry at all.\n *   The backend's full-replace semantics then delete any persisted unnamed entry\n *   (unnamed entries never have uuids, so this is the only way to remove them).\n * - Maps the read shape (`description: string | null`) to the write shape\n *   (`description?: string`), omitting the field when there is no description.\n */\nexport const cleanupReimbursements = (\n  reimbursements: Reimbursement[],\n): PayrollUpdateReimbursements[] => {\n  const consolidated: PayrollUpdateReimbursements[] = []\n  let unnamedTotal = 0\n\n  reimbursements.forEach(reimbursement => {\n    const amount = reimbursement.amount\n    const numericAmount = parseFloat(amount || '0')\n    const description = reimbursement.description?.trim() || ''\n    const uuid = reimbursement.uuid ?? undefined\n\n    if (description === '') {\n      unnamedTotal += numericAmount\n      return\n    }\n\n    if (numericAmount === 0 && !uuid) {\n      return\n    }\n\n    consolidated.push({\n      amount,\n      description,\n      ...(uuid ? { uuid } : {}),\n    })\n  })\n\n  if (unnamedTotal > 0) {\n    consolidated.push({\n      amount: unnamedTotal.toFixed(2),\n    })\n  }\n\n  return consolidated\n}\n\nexport const formatHoursDisplay = (hours: number): string => {\n  const rounded = roundToTwoDecimals(hours)\n\n  if (rounded % 1 === 0) {\n    return `${rounded}.0`\n  }\n\n  return rounded.toString()\n}\n\nconst getHoursInPayPeriod = (paySchedule: PayScheduleObject): number => {\n  if (!paySchedule.frequency) {\n    return 0\n  }\n\n  return PAY_PERIOD_HOURS_MAPPINGS[paySchedule.frequency] || 0\n}\n\nconst getEffectiveCompensation = (\n  compensations: Compensation[],\n  effectiveDate: Date,\n): Compensation | null => {\n  if (!compensations.length) return null\n\n  const sorted = [...compensations].sort(\n    (a, b) =>\n      (a.effectiveDate ? new Date(a.effectiveDate).getTime() : 0) -\n      (b.effectiveDate ? new Date(b.effectiveDate).getTime() : 0),\n  )\n\n  for (let i = sorted.length - 1; i >= 0; i--) {\n    const currentDateString = sorted[i]?.effectiveDate\n    const currentDate = currentDateString ? new Date(currentDateString) : null\n    if (currentDate && currentDate <= effectiveDate) {\n      return sorted[i] || null\n    }\n  }\n\n  return sorted[0] || null\n}\n\nconst getEffectiveMinimumWage = (\n  minimumWages: MinimumWages[],\n  effectiveDate: Date,\n): MinimumWages | null => {\n  if (!minimumWages.length) return null\n\n  const sorted = [...minimumWages].sort(\n    (a, b) =>\n      (a.effectiveDate ? new Date(a.effectiveDate).getTime() : 0) -\n      (b.effectiveDate ? new Date(b.effectiveDate).getTime() : 0),\n  )\n\n  for (let i = sorted.length - 1; i >= 0; i--) {\n    const currentDateString = sorted[i]?.effectiveDate\n    const currentDate = currentDateString ? new Date(currentDateString) : null\n    if (currentDate && currentDate <= effectiveDate) {\n      return sorted[i] || null\n    }\n  }\n\n  return sorted[0] || null\n}\n\nconst isSalaried = (compensation: Compensation): boolean => {\n  return compensation.flsaStatus === 'Exempt' || compensation.flsaStatus === 'Salaried Nonexempt'\n}\n\nconst getTotalTipCompensations = (fixedCompensations: PayrollShowFixedCompensations[]): number => {\n  if (!fixedCompensations.length) return 0\n\n  return fixedCompensations\n    .filter(fixedCompensation => {\n      const name = fixedCompensation.name?.toLowerCase()\n      const amount = parseFloat(fixedCompensation.amount || '0')\n      return (name === 'paycheck tips' || name === 'cash tips') && amount > 0\n    })\n    .reduce((sum, fixedCompensation) => sum + parseFloat(fixedCompensation.amount || '0'), 0)\n}\n\nconst calculateHourlyRate = (compensation: Compensation): number => {\n  const rate = parseFloat(compensation.rate || '0')\n  const paymentUnit = compensation.paymentUnit || 'Hour'\n\n  switch (paymentUnit) {\n    case 'Hour':\n      return rate\n    case 'Year':\n      return rate / 2080 // 52 weeks * 40 hours\n    case 'Month':\n      return rate / 173.333333\n    case 'Week':\n      return rate / 40\n    case 'Paycheck':\n      return 0 // Paycheck rate is 0 for hourly calculation\n    default:\n      return rate\n  }\n}\n\nconst getHourlyRateForJob = (employee: Employee, jobUuid: string, effectiveDate: Date): number => {\n  const job = employee.jobs?.find(j => j.uuid === jobUuid)\n  if (!job?.compensations) {\n    return 0\n  }\n\n  const compensation = getEffectiveCompensation(job.compensations, effectiveDate)\n  return compensation ? calculateHourlyRate(compensation) : 0\n}\n\nconst getPrimaryHourlyRate = (employee: Employee, effectiveDate: Date): number => {\n  const primaryJob = getPrimaryJob(employee)\n  if (!primaryJob?.compensations) {\n    return 0\n  }\n\n  const compensation = getEffectiveCompensation(primaryJob.compensations, effectiveDate)\n  return compensation ? calculateHourlyRate(compensation) : 0\n}\n\nconst getTotalOutstandingPtoHours = (compensation: PayrollEmployeeCompensationsType): number => {\n  if (!compensation.paidTimeOff) {\n    return 0\n  }\n\n  return compensation.paidTimeOff.reduce(\n    (sum, paidTimeOff) => sum + parseFloat(paidTimeOff.finalPayoutUnusedHoursInput || '0'),\n    0,\n  )\n}\n\nconst getPtoHours = (\n  compensation: PayrollEmployeeCompensationsType,\n  isSalariedWithExpectedHours: boolean,\n  hoursInPayPeriod: number,\n  offCycle: boolean,\n): number => {\n  const regularPtoHours = getTotalPtoHours(compensation)\n\n  if (offCycle) {\n    const outstandingPtoHours = getTotalOutstandingPtoHours(compensation)\n    return regularPtoHours + outstandingPtoHours\n  }\n\n  if (isSalariedWithExpectedHours) {\n    return Math.min(hoursInPayPeriod, regularPtoHours)\n  }\n\n  return regularPtoHours\n}\n\nconst calculateMinimumWageAdjustment = (\n  primaryCompensation: Compensation,\n  compensation: PayrollEmployeeCompensationsType,\n  effectiveDate: Date,\n): number => {\n  if (!primaryCompensation.adjustForMinimumWage) return 0\n\n  const effectiveMinWage = getEffectiveMinimumWage(\n    primaryCompensation.minimumWages || [],\n    effectiveDate,\n  )\n  if (!effectiveMinWage) {\n    return 0\n  }\n\n  const totalHours =\n    compensation.hourlyCompensations?.reduce(\n      (sum, hourlyCompensation) => sum + parseFloat(hourlyCompensation.hours || '0'),\n      0,\n    ) || 0\n\n  const hourlyRate = calculateHourlyRate(primaryCompensation)\n\n  const totalTipCredit = (parseFloat(effectiveMinWage.wage || '0') - hourlyRate) * totalHours\n  const totalTips = getTotalTipCompensations(compensation.fixedCompensations || [])\n\n  return Math.max(0, totalTipCredit - totalTips)\n}\n\nconst calculateRegularPlusOvertimePay = (\n  compensation: PayrollEmployeeCompensationsType,\n  employee: Employee,\n  effectiveDate: Date,\n  isSalariedWithExpectedHours: boolean,\n  hoursInPayPeriod: number,\n  ptoHours: number,\n  isOffCycle: boolean,\n): number => {\n  if (!isOffCycle && isSalariedWithExpectedHours) {\n    const primaryHourlyRate = getPrimaryHourlyRate(employee, effectiveDate)\n    return primaryHourlyRate * (hoursInPayPeriod - ptoHours)\n  }\n\n  if (!compensation.hourlyCompensations || !employee.jobs) {\n    return 0\n  }\n\n  const regularRatePay = compensation.hourlyCompensations.reduce((sum, hc) => {\n    const hours = parseFloat(hc.hours || '0')\n    const hourlyRate = getHourlyRateForJob(employee, hc.jobUuid || '', effectiveDate)\n    return sum + hours * hourlyRate\n  }, 0)\n\n  const totalHours = compensation.hourlyCompensations.reduce((sum, hc) => {\n    return sum + parseFloat(hc.hours || '0')\n  }, 0)\n\n  if (totalHours === 0) return regularRatePay\n\n  const overtimeWeightedRate = roundToSixDecimals(regularRatePay / totalHours)\n\n  // Calculate overtime pay for non-regular hours\n  const overtimePay = compensation.hourlyCompensations\n    .filter(hc => !isRegularHours(hc.name || ''))\n    .reduce((sum, hc) => {\n      const hours = parseFloat(hc.hours || '0')\n      const multiplier = hc.compensationMultiplier || 1\n      return sum + hours * overtimeWeightedRate * (multiplier - 1)\n    }, 0)\n\n  return regularRatePay + overtimePay\n}\n\nconst calculatePtoPay = (\n  compensation: PayrollEmployeeCompensationsType,\n  employee: Employee,\n  effectiveDate: Date,\n  isSalariedWithExpectedHours: boolean,\n  hoursInPayPeriod: number,\n  offCycle: boolean,\n): number => {\n  const ptoHours = getPtoHours(\n    compensation,\n    isSalariedWithExpectedHours,\n    hoursInPayPeriod,\n    offCycle,\n  )\n  const primaryHourlyRate = getPrimaryHourlyRate(employee, effectiveDate)\n  return ptoHours * primaryHourlyRate\n}\n\nconst isSalariedWithPayPeriodExpectedHours = (\n  compensation: PayrollEmployeeCompensationsType,\n  isSalaried: boolean,\n  hoursInPayPeriod: number,\n): boolean => {\n  if (!isSalaried) return false\n\n  const regularHourlyCompensation = compensation.hourlyCompensations?.find(hourlyCompensation =>\n    isRegularHours(hourlyCompensation.name || ''),\n  )\n\n  if (!regularHourlyCompensation) return false\n\n  const regularHours = parseFloat(regularHourlyCompensation.hours || '0')\n  return regularHours === hoursInPayPeriod\n}\n\nexport const calculateGrossPay = (\n  compensation: PayrollEmployeeCompensationsType,\n  employee: Employee,\n  compensationEffectiveDateString?: string,\n  paySchedule?: PayScheduleObject,\n  payrollCategory: PayrollCategory = PayrollCategory.Regular,\n): number => {\n  if (compensation.excluded) {\n    return 0\n  }\n\n  const compensationEffectiveDate = compensationEffectiveDateString\n    ? new Date(compensationEffectiveDateString)\n    : new Date()\n\n  const primaryJob = getPrimaryJob(employee)\n  if (!primaryJob?.compensations) {\n    return 0\n  }\n\n  const primaryCompensation = getEffectiveCompensation(\n    primaryJob.compensations,\n    compensationEffectiveDate,\n  )\n\n  if (!primaryCompensation) {\n    return 0\n  }\n\n  const salaried = isSalaried(primaryCompensation)\n  const hoursInPayPeriod = paySchedule ? getHoursInPayPeriod(paySchedule) : 0\n\n  const isSalariedWithExpectedHours = isSalariedWithPayPeriodExpectedHours(\n    compensation,\n    salaried,\n    hoursInPayPeriod,\n  )\n\n  const offCycle = isOffCyclePayroll(payrollCategory)\n\n  const ptoHours = getPtoHours(\n    compensation,\n    isSalariedWithExpectedHours,\n    hoursInPayPeriod,\n    offCycle,\n  )\n\n  const regularPlusOvertimePay = calculateRegularPlusOvertimePay(\n    compensation,\n    employee,\n    compensationEffectiveDate,\n    isSalariedWithExpectedHours,\n    hoursInPayPeriod,\n    ptoHours,\n    offCycle,\n  )\n\n  const fixedPay = getAdditionalEarnings(compensation)\n  const ptoPay = calculatePtoPay(\n    compensation,\n    employee,\n    compensationEffectiveDate,\n    isSalariedWithExpectedHours,\n    hoursInPayPeriod,\n    offCycle,\n  )\n  const minimumWageAdjustment = calculateMinimumWageAdjustment(\n    primaryCompensation,\n    compensation,\n    compensationEffectiveDate,\n  )\n\n  const total = regularPlusOvertimePay + fixedPay + ptoPay + minimumWageAdjustment\n  return roundToTwoDecimals(total)\n}\n\n// Payroll type and status utilities\nexport const getPayrollType = (payroll: {\n  external?: boolean\n  offCycle?: boolean\n}): PayrollType => {\n  if (payroll.external) return 'External'\n  if (payroll.offCycle) return 'Off-Cycle'\n  return 'Regular'\n}\n\nexport const isDismissalPayroll = (offCycleReason?: string | null): boolean =>\n  offCycleReason === OffCycleReasonType.DismissedEmployee\n\nconst OFF_CYCLE_REASON_LABELS: Record<string, string> = {\n  Bonus: 'Bonus',\n  Correction: 'Correction',\n  'Transition from old pay schedule': 'Transition',\n  'Dismissed employee': 'Dismissal',\n  'Hired employee': 'New Hire',\n  'Benefit reversal': 'Benefit Reversal',\n  'Wage correction': 'Wage Correction',\n  'Tax reconciliation': 'Tax Reconciliation',\n  Reversal: 'Reversal',\n  'Disability insurance distribution': 'Disability Insurance',\n}\n\nexport const getPayrollTypeLabel = (payroll: {\n  external?: boolean\n  offCycle?: boolean\n  offCycleReason?: string | null\n}): string => {\n  if (payroll.external) return 'External'\n  if (payroll.offCycle && payroll.offCycleReason) {\n    return OFF_CYCLE_REASON_LABELS[payroll.offCycleReason] ?? payroll.offCycleReason\n  }\n  if (payroll.offCycle) return 'Off-Cycle'\n  return 'Regular'\n}\n\nexport const getAdditionalEarningsCompensations = ({\n  flsaStatus,\n  existingFixedCompensations = [],\n  primaryJobUuid,\n  fixedCompensationTypes = [],\n  excludedTypes = [],\n}: {\n  flsaStatus: string | undefined\n  existingFixedCompensations?: FixedCompensations[]\n  primaryJobUuid?: string\n  fixedCompensationTypes?: PayrollFixedCompensationTypesType[]\n  excludedTypes?: string[]\n}): FixedCompensations[] => {\n  const allFixedCompensations = [...existingFixedCompensations]\n\n  if (flsaStatus !== FlsaStatus.OWNER && primaryJobUuid && fixedCompensationTypes.length > 0) {\n    const compensationTypeNames = fixedCompensationTypes\n      .map(type => type.name)\n      .filter(Boolean) as string[]\n\n    compensationTypeNames.forEach(compensationName => {\n      const exists = allFixedCompensations.some(\n        comp => comp.name?.toLowerCase() === compensationName.toLowerCase(),\n      )\n\n      if (!exists) {\n        allFixedCompensations.push({\n          name: compensationName,\n          amount: '0.00',\n          jobUuid: primaryJobUuid,\n        })\n      }\n    })\n  }\n\n  // Filter and sort additional earnings (exclude specified types)\n  return allFixedCompensations\n    .filter(comp => comp.name && !excludedTypes.includes(comp.name))\n    .sort((a, b) => (a.name || '').localeCompare(b.name || ''))\n}\n\nexport const hasDirectDepositEmployees = (\n  employeeCompensations?: Array<{ paymentMethod?: string | null; excluded?: boolean }>,\n): boolean => {\n  if (!employeeCompensations || employeeCompensations.length === 0) return true\n  const activeCompensations = employeeCompensations.filter(comp => !comp.excluded)\n  if (activeCompensations.length === 0) return true\n  return activeCompensations.some(comp => comp.paymentMethod === 'Direct Deposit')\n}\n\n// Total Payroll = Gross Pay + Employer Taxes + Reimbursements + Benefits\nexport const calculateTotalPayroll = (payrollData: Payroll) => {\n  const totalPayroll = payrollData.totals\n    ? Number(payrollData.totals.grossPay ?? 0) +\n      Number(payrollData.totals.employerTaxes ?? 0) +\n      Number(payrollData.totals.reimbursements ?? 0) +\n      Number(payrollData.totals.benefits ?? 0)\n    : 0\n\n  return totalPayroll\n}\n\n/**\n * Converts a Date to Pacific Time considering Daylight Saving Time.\n * Returns the UTC offset in hours (e.g., -7 for PDT, -8 for PST).\n *\n * DST rules for Pacific Time:\n * - Starts: Second Sunday in March at 2:00 AM\n * - Ends: First Sunday in November at 2:00 AM\n */\nconst getPacificTimeOffset = (date: Date): number => {\n  const year = date.getFullYear()\n\n  const secondSundayMarch = new Date(year, 2, 1)\n  secondSundayMarch.setDate(1 + (7 - secondSundayMarch.getDay()) + 7)\n\n  const firstSundayNovember = new Date(year, 10, 1)\n  firstSundayNovember.setDate(1 + ((7 - firstSundayNovember.getDay()) % 7))\n\n  const isDST = date >= secondSundayMarch && date < firstSundayNovember\n  return isDST ? -7 : -8\n}\n\n/**\n * Determines if a payroll can be cancelled based on business rules.\n *\n * A payroll can be cancelled if all of the following conditions are met:\n * - The payroll has been processed (processed === true)\n * - Current time is before 4:00 PM PT on the payroll deadline\n * - The payrollStatusMeta.cancellable flag is not explicitly false\n *\n * This check enforces the business rule that payrolls can only be cancelled\n * before the 4:00 PM PT cutoff time on their deadline date.\n */\nexport const canCancelPayroll = (payroll: Payroll): boolean => {\n  if (payroll.payrollStatusMeta?.cancellable === false) {\n    return false\n  }\n\n  if (!payroll.processed) {\n    return false\n  }\n\n  if (!payroll.payrollDeadline) {\n    return false\n  }\n\n  const now = new Date()\n  const deadline = new Date(payroll.payrollDeadline)\n\n  const nowInPT = new Date(now.getTime() + getPacificTimeOffset(now) * MS_PER_HOUR)\n  const deadlineInPT = new Date(deadline.getTime() + getPacificTimeOffset(deadline) * MS_PER_HOUR)\n\n  const cutoffTime = new Date(deadlineInPT)\n  cutoffTime.setUTCHours(16, 0, 0, 0)\n\n  if (nowInPT >= cutoffTime) {\n    return false\n  }\n\n  return true\n}\n"],"names":["REGULAR_HOURS_NAME","getPrimaryJob","employee","job","roundToSixDecimals","value","roundToTwoDecimals","isRegularHours","compensationName","PAY_PERIOD_HOURS_MAPPINGS","formatEmployeePayRate","locale","primaryJob","jobCompensation","rate","paymentUnit","formatPayRate","useFormatEmployeePayRate","t","useTranslation","useLocale","useCallback","getRegularHours","compensation","hourlyCompensation","sum","getOvertimeHours","getTotalPtoHours","pto","getAdditionalEarnings","fixedCompensation","name","amount","getReimbursements","reimbursement","reimbursementComp","cleanupReimbursements","reimbursements","consolidated","unnamedTotal","numericAmount","description","uuid","formatHoursDisplay","hours","rounded","getHoursInPayPeriod","paySchedule","getEffectiveCompensation","compensations","effectiveDate","sorted","a","b","i","currentDateString","currentDate","getEffectiveMinimumWage","minimumWages","isSalaried","getTotalTipCompensations","fixedCompensations","calculateHourlyRate","getHourlyRateForJob","jobUuid","j","getPrimaryHourlyRate","getTotalOutstandingPtoHours","paidTimeOff","getPtoHours","isSalariedWithExpectedHours","hoursInPayPeriod","offCycle","regularPtoHours","outstandingPtoHours","calculateMinimumWageAdjustment","primaryCompensation","effectiveMinWage","totalHours","hourlyRate","totalTipCredit","totalTips","calculateRegularPlusOvertimePay","ptoHours","isOffCycle","regularRatePay","hc","overtimeWeightedRate","overtimePay","multiplier","calculatePtoPay","primaryHourlyRate","isSalariedWithPayPeriodExpectedHours","regularHourlyCompensation","calculateGrossPay","compensationEffectiveDateString","payrollCategory","PayrollCategory","compensationEffectiveDate","salaried","isOffCyclePayroll","regularPlusOvertimePay","fixedPay","ptoPay","minimumWageAdjustment","total","isDismissalPayroll","offCycleReason","OffCycleReasonType","OFF_CYCLE_REASON_LABELS","getPayrollTypeLabel","payroll","getAdditionalEarningsCompensations","flsaStatus","existingFixedCompensations","primaryJobUuid","fixedCompensationTypes","excludedTypes","allFixedCompensations","FlsaStatus","type","comp","hasDirectDepositEmployees","employeeCompensations","activeCompensations","calculateTotalPayroll","payrollData","getPacificTimeOffset","date","year","secondSundayMarch","firstSundayNovember","canCancelPayroll","now","deadline","nowInPT","MS_PER_HOUR","deadlineInPT","cutoffTime"],"mappings":";;;;;;;;AA2BA,MAAMA,IAAqB,iBAGdC,IAAgB,CAACC,MACrBA,EAAS,MAAM,KAAK,CAAAC,MAAOA,EAAI,OAAO,KAAKD,EAAS,OAAO,CAAC,KAAK,MAGpEE,IAAqB,CAACC,MACnB,KAAK,MAAMA,IAAQ,GAAS,IAAI,KAGnCC,IAAqB,CAACD,MACnB,KAAK,MAAMA,IAAQ,GAAG,IAAI,KAG7BE,IAAiB,CAACC,MACfA,EAAiB,kBAAkBR,GAGtCS,IAAoD;AAAA,EACxD,OAAO;AAAA,EACP,cAAc;AAAA,EACd,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,SAAS;AAAA,EACT,WAAW;AAAA,EACX,cAAc;AAAA,EACd,UAAU;AACZ,GAEaC,IAAwB,CAAC;AAAA,EACpC,UAAAR;AAAA,EACA;AAAA,EACA,QAAAS,IAAS;AACX,MAIM;AACJ,MAAI,CAACT,GAAU;AACb,WAAO;AAGT,QAAMU,IAAaX,EAAcC,CAAQ;AACzC,MAAI,CAACU,GAAY;AACf,WAAO;AAGT,QAAMC,IAAkBD,EAAW,cAAc,CAAC;AAIlD,MAHI,CAACC,KAGD,CAACA,EAAgB,QAAQ,WAAWA,EAAgB,IAAI,MAAM;AAChE,WAAO;AAGT,QAAMC,IAAO,WAAWD,EAAgB,IAAI,GACtCE,IAAcF,EAAgB,eAAe;AAEnD,SAAOG,EAAc,EAAE,MAAAF,GAAM,aAAAC,GAAa,GAAG,QAAAJ,GAAQ;AACvD,GAEaM,KAA2B,MAAM;AAC5C,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,QAAQ,GAC/B,EAAE,QAAAR,EAAA,IAAWS,EAAA;AAEnB,SAAOC;AAAA,IACL,CAACnB,MACQQ,EAAsB,EAAE,UAAAR,GAAU,GAAAgB,GAAG,QAAAP,GAAQ;AAAA,IAEtD,CAACO,GAAGP,CAAM;AAAA,EAAA;AAEd,GA0BaW,KAAkB,CAACC,MACzBA,EAAa,sBAEXA,EAAa,oBACjB,OAAO,CAAAC,MAAsBA,EAAmB,MAAM,YAAA,MAAkB,eAAe,EACvF,OAAO,CAACC,GAAKD,MAAuBC,IAAM,WAAWD,EAAmB,SAAS,GAAG,GAAG,CAAC,IAJ7C;AAOzC,SAASE,GAAiBH,GAAgD;AAC/E,SAAI,CAACA,EAAa,uBAAuBA,EAAa,WAC7C,IAGFA,EAAa,oBACjB,OAAO,CAAAC,MAAsB,OAAOA,EAAmB,sBAAsB,IAAI,CAAC,EAClF,OAAO,CAACC,GAAKD,MAAuBC,IAAM,WAAWD,EAAmB,SAAS,GAAG,GAAG,CAAC;AAC7F;AAEO,MAAMG,IAAmB,CAACJ,MAC1BA,EAAa,cAGXA,EAAa,YAAY,OAAO,CAACE,GAAKG,MAAQH,IAAM,WAAWG,EAAI,SAAS,GAAG,GAAG,CAAC,IAFjF,GAKEC,IAAwB,CAACN,MAC/BA,EAAa,qBAIXA,EAAa,mBACjB,OAAO,CAAAO,MAAqB;AAC3B,QAAMC,IAAOD,EAAkB,MAAM,YAAA,KAAiB,IAChDE,IAAS,WAAWF,EAAkB,UAAU,GAAG;AACzD,SAAOC,MAAS,mBAAmBA,MAAS,6BAA6BC,IAAS;AACpF,CAAC,EACA,OAAO,CAACP,GAAKK,MAAsBL,IAAM,WAAWK,EAAkB,UAAU,GAAG,GAAG,CAAC,IATjF,GAYEG,KAAoB,CAACV,MAAmD;AACnF,MAAIA,EAAa,kBAAkBA,EAAa,eAAe,SAAS;AACtE,WAAOA,EAAa,eAAe;AAAA,MACjC,CAACE,GAAKS,MAAkBT,IAAM,WAAWS,EAAc,UAAU,GAAG;AAAA,MACpE;AAAA,IAAA;AAIJ,MAAI,CAACX,EAAa;AAChB,WAAO;AAGT,QAAMY,IAAoBZ,EAAa,mBAAmB;AAAA,IACxD,CAAAO,MAAqBA,EAAkB,MAAM,YAAA,MAAkB;AAAA,EAAA;AAEjE,SAAOK,IAAoB,WAAWA,EAAkB,UAAU,GAAG,IAAI;AAC3E,GAkBaC,KAAwB,CACnCC,MACkC;AAClC,QAAMC,IAA8C,CAAA;AACpD,MAAIC,IAAe;AAEnB,SAAAF,EAAe,QAAQ,CAAAH,MAAiB;AACtC,UAAMF,IAASE,EAAc,QACvBM,IAAgB,WAAWR,KAAU,GAAG,GACxCS,IAAcP,EAAc,aAAa,KAAA,KAAU,IACnDQ,IAAOR,EAAc,QAAQ;AAEnC,QAAIO,MAAgB,IAAI;AACtB,MAAAF,KAAgBC;AAChB;AAAA,IACF;AAEA,IAAIA,MAAkB,KAAK,CAACE,KAI5BJ,EAAa,KAAK;AAAA,MAChB,QAAAN;AAAA,MACA,aAAAS;AAAA,MACA,GAAIC,IAAO,EAAE,MAAAA,MAAS,CAAA;AAAA,IAAC,CACxB;AAAA,EACH,CAAC,GAEGH,IAAe,KACjBD,EAAa,KAAK;AAAA,IAChB,QAAQC,EAAa,QAAQ,CAAC;AAAA,EAAA,CAC/B,GAGID;AACT,GAEaK,KAAqB,CAACC,MAA0B;AAC3D,QAAMC,IAAUvC,EAAmBsC,CAAK;AAExC,SAAIC,IAAU,MAAM,IACX,GAAGA,CAAO,OAGZA,EAAQ,SAAA;AACjB,GAEMC,IAAsB,CAACC,MACtBA,EAAY,aAIVtC,EAA0BsC,EAAY,SAAS,KAAK,GAGvDC,IAA2B,CAC/BC,GACAC,MACwB;AACxB,MAAI,CAACD,EAAc,OAAQ,QAAO;AAElC,QAAME,IAAS,CAAC,GAAGF,CAAa,EAAE;AAAA,IAChC,CAACG,GAAGC,OACDD,EAAE,gBAAgB,IAAI,KAAKA,EAAE,aAAa,EAAE,YAAY,MACxDC,EAAE,gBAAgB,IAAI,KAAKA,EAAE,aAAa,EAAE,QAAA,IAAY;AAAA,EAAA;AAG7D,WAASC,IAAIH,EAAO,SAAS,GAAGG,KAAK,GAAGA,KAAK;AAC3C,UAAMC,IAAoBJ,EAAOG,CAAC,GAAG,eAC/BE,IAAcD,IAAoB,IAAI,KAAKA,CAAiB,IAAI;AACtE,QAAIC,KAAeA,KAAeN;AAChC,aAAOC,EAAOG,CAAC,KAAK;AAAA,EAExB;AAEA,SAAOH,EAAO,CAAC,KAAK;AACtB,GAEMM,IAA0B,CAC9BC,GACAR,MACwB;AACxB,MAAI,CAACQ,EAAa,OAAQ,QAAO;AAEjC,QAAMP,IAAS,CAAC,GAAGO,CAAY,EAAE;AAAA,IAC/B,CAACN,GAAGC,OACDD,EAAE,gBAAgB,IAAI,KAAKA,EAAE,aAAa,EAAE,YAAY,MACxDC,EAAE,gBAAgB,IAAI,KAAKA,EAAE,aAAa,EAAE,QAAA,IAAY;AAAA,EAAA;AAG7D,WAASC,IAAIH,EAAO,SAAS,GAAGG,KAAK,GAAGA,KAAK;AAC3C,UAAMC,IAAoBJ,EAAOG,CAAC,GAAG,eAC/BE,IAAcD,IAAoB,IAAI,KAAKA,CAAiB,IAAI;AACtE,QAAIC,KAAeA,KAAeN;AAChC,aAAOC,EAAOG,CAAC,KAAK;AAAA,EAExB;AAEA,SAAOH,EAAO,CAAC,KAAK;AACtB,GAEMQ,IAAa,CAACpC,MACXA,EAAa,eAAe,YAAYA,EAAa,eAAe,sBAGvEqC,IAA2B,CAACC,MAC3BA,EAAmB,SAEjBA,EACJ,OAAO,CAAA/B,MAAqB;AAC3B,QAAMC,IAAOD,EAAkB,MAAM,YAAA,GAC/BE,IAAS,WAAWF,EAAkB,UAAU,GAAG;AACzD,UAAQC,MAAS,mBAAmBA,MAAS,gBAAgBC,IAAS;AACxE,CAAC,EACA,OAAO,CAACP,GAAKK,MAAsBL,IAAM,WAAWK,EAAkB,UAAU,GAAG,GAAG,CAAC,IARnD,GAWnCgC,IAAsB,CAACvC,MAAuC;AAClE,QAAMT,IAAO,WAAWS,EAAa,QAAQ,GAAG;AAGhD,UAFoBA,EAAa,eAAe,QAExC;AAAA,IACN,KAAK;AACH,aAAOT;AAAA,IACT,KAAK;AACH,aAAOA,IAAO;AAAA;AAAA,IAChB,KAAK;AACH,aAAOA,IAAO;AAAA,IAChB,KAAK;AACH,aAAOA,IAAO;AAAA,IAChB,KAAK;AACH,aAAO;AAAA;AAAA,IACT;AACE,aAAOA;AAAA,EAAA;AAEb,GAEMiD,IAAsB,CAAC7D,GAAoB8D,GAAiBd,MAAgC;AAChG,QAAM/C,IAAMD,EAAS,MAAM,KAAK,CAAA+D,MAAKA,EAAE,SAASD,CAAO;AACvD,MAAI,CAAC7D,GAAK;AACR,WAAO;AAGT,QAAMoB,IAAeyB,EAAyB7C,EAAI,eAAe+C,CAAa;AAC9E,SAAO3B,IAAeuC,EAAoBvC,CAAY,IAAI;AAC5D,GAEM2C,IAAuB,CAAChE,GAAoBgD,MAAgC;AAChF,QAAMtC,IAAaX,EAAcC,CAAQ;AACzC,MAAI,CAACU,GAAY;AACf,WAAO;AAGT,QAAMW,IAAeyB,EAAyBpC,EAAW,eAAesC,CAAa;AACrF,SAAO3B,IAAeuC,EAAoBvC,CAAY,IAAI;AAC5D,GAEM4C,IAA8B,CAAC5C,MAC9BA,EAAa,cAIXA,EAAa,YAAY;AAAA,EAC9B,CAACE,GAAK2C,MAAgB3C,IAAM,WAAW2C,EAAY,+BAA+B,GAAG;AAAA,EACrF;AAAA,IALO,GASLC,IAAc,CAClB9C,GACA+C,GACAC,GACAC,MACW;AACX,QAAMC,IAAkB9C,EAAiBJ,CAAY;AAErD,MAAIiD,GAAU;AACZ,UAAME,IAAsBP,EAA4B5C,CAAY;AACpE,WAAOkD,IAAkBC;AAAA,EAC3B;AAEA,SAAIJ,IACK,KAAK,IAAIC,GAAkBE,CAAe,IAG5CA;AACT,GAEME,IAAiC,CACrCC,GACArD,GACA2B,MACW;AACX,MAAI,CAAC0B,EAAoB,qBAAsB,QAAO;AAEtD,QAAMC,IAAmBpB;AAAA,IACvBmB,EAAoB,gBAAgB,CAAA;AAAA,IACpC1B;AAAA,EAAA;AAEF,MAAI,CAAC2B;AACH,WAAO;AAGT,QAAMC,IACJvD,EAAa,qBAAqB;AAAA,IAChC,CAACE,GAAKD,MAAuBC,IAAM,WAAWD,EAAmB,SAAS,GAAG;AAAA,IAC7E;AAAA,EAAA,KACG,GAEDuD,IAAajB,EAAoBc,CAAmB,GAEpDI,KAAkB,WAAWH,EAAiB,QAAQ,GAAG,IAAIE,KAAcD,GAC3EG,IAAYrB,EAAyBrC,EAAa,sBAAsB,CAAA,CAAE;AAEhF,SAAO,KAAK,IAAI,GAAGyD,IAAiBC,CAAS;AAC/C,GAEMC,IAAkC,CACtC3D,GACArB,GACAgD,GACAoB,GACAC,GACAY,GACAC,MACW;AACX,MAAI,CAACA,KAAcd;AAEjB,WAD0BJ,EAAqBhE,GAAUgD,CAAa,KAC1CqB,IAAmBY;AAGjD,MAAI,CAAC5D,EAAa,uBAAuB,CAACrB,EAAS;AACjD,WAAO;AAGT,QAAMmF,IAAiB9D,EAAa,oBAAoB,OAAO,CAACE,GAAK6D,MAAO;AAC1E,UAAM1C,IAAQ,WAAW0C,EAAG,SAAS,GAAG,GAClCP,IAAahB,EAAoB7D,GAAUoF,EAAG,WAAW,IAAIpC,CAAa;AAChF,WAAOzB,IAAMmB,IAAQmC;AAAA,EACvB,GAAG,CAAC,GAEED,IAAavD,EAAa,oBAAoB,OAAO,CAACE,GAAK6D,MACxD7D,IAAM,WAAW6D,EAAG,SAAS,GAAG,GACtC,CAAC;AAEJ,MAAIR,MAAe,EAAG,QAAOO;AAE7B,QAAME,IAAuBnF,EAAmBiF,IAAiBP,CAAU,GAGrEU,IAAcjE,EAAa,oBAC9B,OAAO,OAAM,CAAChB,EAAe+E,EAAG,QAAQ,EAAE,CAAC,EAC3C,OAAO,CAAC7D,GAAK6D,MAAO;AACnB,UAAM1C,IAAQ,WAAW0C,EAAG,SAAS,GAAG,GAClCG,IAAaH,EAAG,0BAA0B;AAChD,WAAO7D,IAAMmB,IAAQ2C,KAAwBE,IAAa;AAAA,EAC5D,GAAG,CAAC;AAEN,SAAOJ,IAAiBG;AAC1B,GAEME,IAAkB,CACtBnE,GACArB,GACAgD,GACAoB,GACAC,GACAC,MACW;AACX,QAAMW,IAAWd;AAAA,IACf9C;AAAA,IACA+C;AAAA,IACAC;AAAA,IACAC;AAAA,EAAA,GAEImB,IAAoBzB,EAAqBhE,GAAUgD,CAAa;AACtE,SAAOiC,IAAWQ;AACpB,GAEMC,IAAuC,CAC3CrE,GACAoC,GACAY,MACY;AACZ,MAAI,CAACZ,EAAY,QAAO;AAExB,QAAMkC,IAA4BtE,EAAa,qBAAqB;AAAA,IAAK,CAAAC,MACvEjB,EAAeiB,EAAmB,QAAQ,EAAE;AAAA,EAAA;AAG9C,SAAKqE,IAEgB,WAAWA,EAA0B,SAAS,GAAG,MAC9CtB,IAHe;AAIzC,GAEauB,KAAoB,CAC/BvE,GACArB,GACA6F,GACAhD,GACAiD,IAAmCC,EAAgB,YACxC;AACX,MAAI1E,EAAa;AACf,WAAO;AAGT,QAAM2E,IAA4BH,IAC9B,IAAI,KAAKA,CAA+B,wBACpC,KAAA,GAEFnF,IAAaX,EAAcC,CAAQ;AACzC,MAAI,CAACU,GAAY;AACf,WAAO;AAGT,QAAMgE,IAAsB5B;AAAA,IAC1BpC,EAAW;AAAA,IACXsF;AAAA,EAAA;AAGF,MAAI,CAACtB;AACH,WAAO;AAGT,QAAMuB,IAAWxC,EAAWiB,CAAmB,GACzCL,IAAmBxB,IAAcD,EAAoBC,CAAW,IAAI,GAEpEuB,IAA8BsB;AAAA,IAClCrE;AAAA,IACA4E;AAAA,IACA5B;AAAA,EAAA,GAGIC,IAAW4B,EAAkBJ,CAAe,GAE5Cb,IAAWd;AAAA,IACf9C;AAAA,IACA+C;AAAA,IACAC;AAAA,IACAC;AAAA,EAAA,GAGI6B,IAAyBnB;AAAA,IAC7B3D;AAAA,IACArB;AAAA,IACAgG;AAAA,IACA5B;AAAA,IACAC;AAAA,IACAY;AAAA,IACAX;AAAA,EAAA,GAGI8B,IAAWzE,EAAsBN,CAAY,GAC7CgF,IAASb;AAAA,IACbnE;AAAA,IACArB;AAAA,IACAgG;AAAA,IACA5B;AAAA,IACAC;AAAA,IACAC;AAAA,EAAA,GAEIgC,IAAwB7B;AAAA,IAC5BC;AAAA,IACArD;AAAA,IACA2E;AAAA,EAAA,GAGIO,IAAQJ,IAAyBC,IAAWC,IAASC;AAC3D,SAAOlG,EAAmBmG,CAAK;AACjC,GAYaC,KAAqB,CAACC,MACjCA,MAAmBC,EAAmB,mBAElCC,IAAkD;AAAA,EACtD,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,oCAAoC;AAAA,EACpC,sBAAsB;AAAA,EACtB,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,sBAAsB;AAAA,EACtB,UAAU;AAAA,EACV,qCAAqC;AACvC,GAEaC,KAAsB,CAACC,MAK9BA,EAAQ,WAAiB,aACzBA,EAAQ,YAAYA,EAAQ,iBACvBF,EAAwBE,EAAQ,cAAc,KAAKA,EAAQ,iBAEhEA,EAAQ,WAAiB,cACtB,WAGIC,KAAqC,CAAC;AAAA,EACjD,YAAAC;AAAA,EACA,4BAAAC,IAA6B,CAAA;AAAA,EAC7B,gBAAAC;AAAA,EACA,wBAAAC,IAAyB,CAAA;AAAA,EACzB,eAAAC,IAAgB,CAAA;AAClB,MAM4B;AAC1B,QAAMC,IAAwB,CAAC,GAAGJ,CAA0B;AAE5D,SAAID,MAAeM,EAAW,SAASJ,KAAkBC,EAAuB,SAAS,KACzDA,EAC3B,IAAI,CAAAI,MAAQA,EAAK,IAAI,EACrB,OAAO,OAAO,EAEK,QAAQ,CAAAhH,MAAoB;AAKhD,IAJe8G,EAAsB;AAAA,MACnC,OAAQG,EAAK,MAAM,YAAA,MAAkBjH,EAAiB,YAAA;AAAA,IAAY,KAIlE8G,EAAsB,KAAK;AAAA,MACzB,MAAM9G;AAAA,MACN,QAAQ;AAAA,MACR,SAAS2G;AAAA,IAAA,CACV;AAAA,EAEL,CAAC,GAIIG,EACJ,OAAO,CAAAG,MAAQA,EAAK,QAAQ,CAACJ,EAAc,SAASI,EAAK,IAAI,CAAC,EAC9D,KAAK,CAACrE,GAAGC,OAAOD,EAAE,QAAQ,IAAI,cAAcC,EAAE,QAAQ,EAAE,CAAC;AAC9D,GAEaqE,KAA4B,CACvCC,MACY;AACZ,MAAI,CAACA,KAAyBA,EAAsB,WAAW,EAAG,QAAO;AACzE,QAAMC,IAAsBD,EAAsB,OAAO,CAAAF,MAAQ,CAACA,EAAK,QAAQ;AAC/E,SAAIG,EAAoB,WAAW,IAAU,KACtCA,EAAoB,KAAK,CAAAH,MAAQA,EAAK,kBAAkB,gBAAgB;AACjF,GAGaI,KAAwB,CAACC,MACfA,EAAY,SAC7B,OAAOA,EAAY,OAAO,YAAY,CAAC,IACvC,OAAOA,EAAY,OAAO,iBAAiB,CAAC,IAC5C,OAAOA,EAAY,OAAO,kBAAkB,CAAC,IAC7C,OAAOA,EAAY,OAAO,YAAY,CAAC,IACvC,GAaAC,IAAuB,CAACC,MAAuB;AACnD,QAAMC,IAAOD,EAAK,YAAA,GAEZE,IAAoB,IAAI,KAAKD,GAAM,GAAG,CAAC;AAC7C,EAAAC,EAAkB,QAAQ,KAAK,IAAIA,EAAkB,OAAA,KAAY,CAAC;AAElE,QAAMC,IAAsB,IAAI,KAAKF,GAAM,IAAI,CAAC;AAChD,SAAAE,EAAoB,QAAQ,KAAM,IAAIA,EAAoB,OAAA,KAAY,CAAE,GAE1DH,KAAQE,KAAqBF,IAAOG,IACnC,KAAK;AACtB,GAaaC,KAAmB,CAACrB,MAA8B;AAS7D,MARIA,EAAQ,mBAAmB,gBAAgB,MAI3C,CAACA,EAAQ,aAIT,CAACA,EAAQ;AACX,WAAO;AAGT,QAAMsB,wBAAU,KAAA,GACVC,IAAW,IAAI,KAAKvB,EAAQ,eAAe,GAE3CwB,IAAU,IAAI,KAAKF,EAAI,YAAYN,EAAqBM,CAAG,IAAIG,CAAW,GAC1EC,IAAe,IAAI,KAAKH,EAAS,YAAYP,EAAqBO,CAAQ,IAAIE,CAAW,GAEzFE,IAAa,IAAI,KAAKD,CAAY;AAGxC,SAFAC,EAAW,YAAY,IAAI,GAAG,GAAG,CAAC,GAE9B,EAAAH,KAAWG;AAKjB;"}
+{"version":3,"file":"helpers.js","sources":["../../../src/components/Payroll/helpers.ts"],"sourcesContent":["import type { Employee } from '@gusto/embedded-api-v-2025-11-15/models/components/employee'\nimport {\n  type PayrollShowFixedCompensations,\n  OffCycleReasonType,\n} from '@gusto/embedded-api-v-2025-11-15/models/components/payroll'\nimport type {\n  PayrollEmployeeCompensationsTypeFixedCompensations as FixedCompensations,\n  PayrollEmployeeCompensationsTypeReimbursements as Reimbursement,\n} from '@gusto/embedded-api-v-2025-11-15/models/components/payrollemployeecompensationstype'\nimport type { PayrollUpdateReimbursements } from '@gusto/embedded-api-v-2025-11-15/models/components/payrollupdate'\nimport type { PayrollFixedCompensationTypesType } from '@gusto/embedded-api-v-2025-11-15/models/components/payrollfixedcompensationtypestype'\nimport { useCallback } from 'react'\nimport type { TFunction } from 'i18next'\nimport { useTranslation } from 'react-i18next'\nimport type { PayScheduleShow as PayScheduleObject } from '@gusto/embedded-api-v-2025-11-15/models/components/payscheduleshow'\nimport type {\n  Compensation,\n  MinimumWages,\n} from '@gusto/embedded-api-v-2025-11-15/models/components/compensation'\nimport type { PayrollEmployeeCompensationsType } from '@gusto/embedded-api-v-2025-11-15/models/components/payrollemployeecompensationstype'\nimport type { Payroll } from '@gusto/embedded-api-v-2025-11-15/models/components/payroll'\nimport type { PayrollType } from './PayrollList/types'\nimport { PayrollCategory, isOffCyclePayroll } from './payrollTypes'\nimport { formatPayRate } from '@/helpers/formattedStrings'\nimport { useLocale } from '@/contexts/LocaleProvider/useLocale'\nimport { FlsaStatus } from '@/shared/constants'\nimport { MS_PER_HOUR } from '@/helpers/dateFormatting'\nconst REGULAR_HOURS_NAME = 'regular hours'\n\n// Utility to get the primary job from an employee\nconst getPrimaryJob = (employee: Employee) => {\n  return employee.jobs?.find(job => job.primary) || employee.jobs?.[0] || null\n}\n\nconst roundToSixDecimals = (value: number): number => {\n  return Math.round(value * 1_000_000) / 1_000_000\n}\n\nconst roundToTwoDecimals = (value: number): number => {\n  return Math.round(value * 100) / 100\n}\n\nconst isRegularHours = (compensationName: string): boolean => {\n  return compensationName.toLowerCase() === REGULAR_HOURS_NAME\n}\n\nconst PAY_PERIOD_HOURS_MAPPINGS: Record<string, number> = {\n  Daily: 8.0,\n  'Every week': 40.0,\n  'Every other week': 80.0,\n  'Twice per month': 86.666667,\n  Monthly: 173.333333,\n  Quarterly: 520.0,\n  Semiannually: 1040.0,\n  Annually: 2080.0,\n}\n\n/**\n * Formats an employee's primary-job pay rate into a localized display string.\n *\n * @remarks\n * Returns `null` when the employee has no jobs, the primary job has no compensations, or the rate is missing\n * or zero.\n *\n * @param args - The employee, translation function, and locale to format against.\n * @returns The formatted pay-rate string, or `null` when no usable rate is available.\n * @internal\n */\nexport const formatEmployeePayRate = ({\n  employee,\n  t,\n  locale = 'en-US',\n}: {\n  employee?: Employee\n  t: TFunction\n  locale?: string\n}) => {\n  if (!employee?.jobs) {\n    return null\n  }\n\n  const primaryJob = getPrimaryJob(employee)\n  if (!primaryJob?.compensations) {\n    return null\n  }\n\n  const jobCompensation = primaryJob.compensations[0]\n  if (!jobCompensation) {\n    return null\n  }\n  if (!jobCompensation.rate || parseFloat(jobCompensation.rate) === 0) {\n    return null\n  }\n\n  const rate = parseFloat(jobCompensation.rate)\n  const paymentUnit = jobCompensation.paymentUnit || 'Hour'\n\n  return formatPayRate({ rate, paymentUnit, t, locale })\n}\n\n/**\n * Returns a memoized formatter that produces a localized pay-rate string from an employee's primary job.\n *\n * @returns A callback that takes an `Employee` and returns the formatted pay-rate string, or `null` when the\n *   employee has no usable primary-job compensation.\n * @internal\n */\nexport const useFormatEmployeePayRate = () => {\n  const { t } = useTranslation('common')\n  const { locale } = useLocale()\n\n  return useCallback(\n    (employee?: Employee) => {\n      return formatEmployeePayRate({ employee, t, locale })\n    },\n    [t, locale],\n  )\n}\n\n/**\n * Sums hourly-compensation rows named `'regular hours'`.\n *\n * @param compensation - The employee compensation entry.\n * @returns The total regular hours worked, or `0` when none are recorded.\n * @internal\n */\nexport const getRegularHours = (compensation: PayrollEmployeeCompensationsType) => {\n  if (!compensation.hourlyCompensations) return 0\n\n  return compensation.hourlyCompensations\n    .filter(hourlyCompensation => hourlyCompensation.name?.toLowerCase() === 'regular hours')\n    .reduce((sum, hourlyCompensation) => sum + parseFloat(hourlyCompensation.hours || '0'), 0)\n}\n\n/**\n * Sums the overtime hours (multiplier greater than `1`) from an employee compensation.\n *\n * @param compensation - The employee compensation entry.\n * @returns The total overtime hours, or `0` when the compensation is excluded or has none.\n * @internal\n */\nexport function getOvertimeHours(compensation: PayrollEmployeeCompensationsType) {\n  if (!compensation.hourlyCompensations || compensation.excluded) {\n    return 0\n  }\n\n  return compensation.hourlyCompensations\n    .filter(hourlyCompensation => Number(hourlyCompensation.compensationMultiplier) > 1)\n    .reduce((sum, hourlyCompensation) => sum + parseFloat(hourlyCompensation.hours || '0'), 0)\n}\n\n/**\n * Sums the paid-time-off hours from an employee compensation.\n *\n * @param compensation - The employee compensation entry.\n * @returns The total PTO hours, or `0` when none are recorded.\n * @internal\n */\nexport const getTotalPtoHours = (compensation: PayrollEmployeeCompensationsType) => {\n  if (!compensation.paidTimeOff) {\n    return 0\n  }\n  return compensation.paidTimeOff.reduce((sum, pto) => sum + parseFloat(pto.hours || '0'), 0)\n}\n\n/**\n * Sums fixed-compensation amounts excluding reimbursements and minimum-wage adjustments.\n *\n * @param compensation - The employee compensation entry.\n * @returns The total additional earnings amount, or `0` when none qualify.\n * @internal\n */\nexport const getAdditionalEarnings = (compensation: PayrollEmployeeCompensationsType) => {\n  if (!compensation.fixedCompensations) {\n    return 0\n  }\n\n  return compensation.fixedCompensations\n    .filter(fixedCompensation => {\n      const name = fixedCompensation.name?.toLowerCase() || ''\n      const amount = parseFloat(fixedCompensation.amount || '0')\n      return name !== 'reimbursement' && name !== 'minimum wage adjustment' && amount > 0\n    })\n    .reduce((sum, fixedCompensation) => sum + parseFloat(fixedCompensation.amount || '0'), 0)\n}\n\n/**\n * Returns the total reimbursement amount for an employee compensation.\n *\n * @remarks\n * Prefers the explicit `reimbursements` array when present; falls back to a fixed-compensation row named\n * `'Reimbursement'` for older payroll shapes.\n *\n * @param compensation - The employee compensation entry.\n * @returns The summed reimbursement amount, or `0` when none.\n * @internal\n */\nexport const getReimbursements = (compensation: PayrollEmployeeCompensationsType) => {\n  if (compensation.reimbursements && compensation.reimbursements.length > 0) {\n    return compensation.reimbursements.reduce(\n      (sum, reimbursement) => sum + parseFloat(reimbursement.amount || '0'),\n      0,\n    )\n  }\n\n  if (!compensation.fixedCompensations) {\n    return 0\n  }\n\n  const reimbursementComp = compensation.fixedCompensations.find(\n    fixedCompensation => fixedCompensation.name?.toLowerCase() === 'reimbursement',\n  )\n  return reimbursementComp ? parseFloat(reimbursementComp.amount || '0') : 0\n}\n\n/**\n * Normalizes a reimbursement list for submission to the v2025-11-15 API.\n *\n * @remarks\n * - Drops named rows that would be no-ops on the server (zero amount with no existing uuid).\n * - Drops named rows with an existing uuid and zero amount — these are removals, and the backend's\n *   `replace_itemized_reimbursements` deletes any persisted reimbursement whose uuid is omitted from the\n *   incoming list.\n * - Consolidates multiple unnamed (description-less) rows into a single unnamed entry, since the API rejects\n *   more than one unnamed reimbursement per employee.\n * - When the consolidated unnamed total is zero, sends no unnamed entry at all. The backend's full-replace\n *   semantics then delete any persisted unnamed entry (unnamed entries never have uuids, so this is the only\n *   way to remove them).\n * - Maps the read shape (`description: string | null`) to the write shape (`description?: string`), omitting\n *   the field when there is no description.\n *\n * @param reimbursements - The reimbursements pulled from the prepared payroll.\n * @returns The normalized reimbursements ready to send on a payroll update.\n * @internal\n */\nexport const cleanupReimbursements = (\n  reimbursements: Reimbursement[],\n): PayrollUpdateReimbursements[] => {\n  const consolidated: PayrollUpdateReimbursements[] = []\n  let unnamedTotal = 0\n\n  reimbursements.forEach(reimbursement => {\n    const amount = reimbursement.amount\n    const numericAmount = parseFloat(amount || '0')\n    const description = reimbursement.description?.trim() || ''\n    const uuid = reimbursement.uuid ?? undefined\n\n    if (description === '') {\n      unnamedTotal += numericAmount\n      return\n    }\n\n    if (numericAmount === 0 && !uuid) {\n      return\n    }\n\n    consolidated.push({\n      amount,\n      description,\n      ...(uuid ? { uuid } : {}),\n    })\n  })\n\n  if (unnamedTotal > 0) {\n    consolidated.push({\n      amount: unnamedTotal.toFixed(2),\n    })\n  }\n\n  return consolidated\n}\n\n/**\n * Formats an hours value for display, rounding to two decimals and ensuring whole numbers render with `.0`.\n *\n * @param hours - The hours value to format.\n * @returns A string like `'40.0'` or `'37.25'`.\n * @internal\n */\nexport const formatHoursDisplay = (hours: number): string => {\n  const rounded = roundToTwoDecimals(hours)\n\n  if (rounded % 1 === 0) {\n    return `${rounded}.0`\n  }\n\n  return rounded.toString()\n}\n\nconst getHoursInPayPeriod = (paySchedule: PayScheduleObject): number => {\n  if (!paySchedule.frequency) {\n    return 0\n  }\n\n  return PAY_PERIOD_HOURS_MAPPINGS[paySchedule.frequency] || 0\n}\n\nconst getEffectiveCompensation = (\n  compensations: Compensation[],\n  effectiveDate: Date,\n): Compensation | null => {\n  if (!compensations.length) return null\n\n  const sorted = [...compensations].sort(\n    (a, b) =>\n      (a.effectiveDate ? new Date(a.effectiveDate).getTime() : 0) -\n      (b.effectiveDate ? new Date(b.effectiveDate).getTime() : 0),\n  )\n\n  for (let i = sorted.length - 1; i >= 0; i--) {\n    const currentDateString = sorted[i]?.effectiveDate\n    const currentDate = currentDateString ? new Date(currentDateString) : null\n    if (currentDate && currentDate <= effectiveDate) {\n      return sorted[i] || null\n    }\n  }\n\n  return sorted[0] || null\n}\n\nconst getEffectiveMinimumWage = (\n  minimumWages: MinimumWages[],\n  effectiveDate: Date,\n): MinimumWages | null => {\n  if (!minimumWages.length) return null\n\n  const sorted = [...minimumWages].sort(\n    (a, b) =>\n      (a.effectiveDate ? new Date(a.effectiveDate).getTime() : 0) -\n      (b.effectiveDate ? new Date(b.effectiveDate).getTime() : 0),\n  )\n\n  for (let i = sorted.length - 1; i >= 0; i--) {\n    const currentDateString = sorted[i]?.effectiveDate\n    const currentDate = currentDateString ? new Date(currentDateString) : null\n    if (currentDate && currentDate <= effectiveDate) {\n      return sorted[i] || null\n    }\n  }\n\n  return sorted[0] || null\n}\n\nconst isSalaried = (compensation: Compensation): boolean => {\n  return compensation.flsaStatus === 'Exempt' || compensation.flsaStatus === 'Salaried Nonexempt'\n}\n\nconst getTotalTipCompensations = (fixedCompensations: PayrollShowFixedCompensations[]): number => {\n  if (!fixedCompensations.length) return 0\n\n  return fixedCompensations\n    .filter(fixedCompensation => {\n      const name = fixedCompensation.name?.toLowerCase()\n      const amount = parseFloat(fixedCompensation.amount || '0')\n      return (name === 'paycheck tips' || name === 'cash tips') && amount > 0\n    })\n    .reduce((sum, fixedCompensation) => sum + parseFloat(fixedCompensation.amount || '0'), 0)\n}\n\nconst calculateHourlyRate = (compensation: Compensation): number => {\n  const rate = parseFloat(compensation.rate || '0')\n  const paymentUnit = compensation.paymentUnit || 'Hour'\n\n  switch (paymentUnit) {\n    case 'Hour':\n      return rate\n    case 'Year':\n      return rate / 2080 // 52 weeks * 40 hours\n    case 'Month':\n      return rate / 173.333333\n    case 'Week':\n      return rate / 40\n    case 'Paycheck':\n      return 0 // Paycheck rate is 0 for hourly calculation\n    default:\n      return rate\n  }\n}\n\nconst getHourlyRateForJob = (employee: Employee, jobUuid: string, effectiveDate: Date): number => {\n  const job = employee.jobs?.find(j => j.uuid === jobUuid)\n  if (!job?.compensations) {\n    return 0\n  }\n\n  const compensation = getEffectiveCompensation(job.compensations, effectiveDate)\n  return compensation ? calculateHourlyRate(compensation) : 0\n}\n\nconst getPrimaryHourlyRate = (employee: Employee, effectiveDate: Date): number => {\n  const primaryJob = getPrimaryJob(employee)\n  if (!primaryJob?.compensations) {\n    return 0\n  }\n\n  const compensation = getEffectiveCompensation(primaryJob.compensations, effectiveDate)\n  return compensation ? calculateHourlyRate(compensation) : 0\n}\n\nconst getTotalOutstandingPtoHours = (compensation: PayrollEmployeeCompensationsType): number => {\n  if (!compensation.paidTimeOff) {\n    return 0\n  }\n\n  return compensation.paidTimeOff.reduce(\n    (sum, paidTimeOff) => sum + parseFloat(paidTimeOff.finalPayoutUnusedHoursInput || '0'),\n    0,\n  )\n}\n\nconst getPtoHours = (\n  compensation: PayrollEmployeeCompensationsType,\n  isSalariedWithExpectedHours: boolean,\n  hoursInPayPeriod: number,\n  offCycle: boolean,\n): number => {\n  const regularPtoHours = getTotalPtoHours(compensation)\n\n  if (offCycle) {\n    const outstandingPtoHours = getTotalOutstandingPtoHours(compensation)\n    return regularPtoHours + outstandingPtoHours\n  }\n\n  if (isSalariedWithExpectedHours) {\n    return Math.min(hoursInPayPeriod, regularPtoHours)\n  }\n\n  return regularPtoHours\n}\n\nconst calculateMinimumWageAdjustment = (\n  primaryCompensation: Compensation,\n  compensation: PayrollEmployeeCompensationsType,\n  effectiveDate: Date,\n): number => {\n  if (!primaryCompensation.adjustForMinimumWage) return 0\n\n  const effectiveMinWage = getEffectiveMinimumWage(\n    primaryCompensation.minimumWages || [],\n    effectiveDate,\n  )\n  if (!effectiveMinWage) {\n    return 0\n  }\n\n  const totalHours =\n    compensation.hourlyCompensations?.reduce(\n      (sum, hourlyCompensation) => sum + parseFloat(hourlyCompensation.hours || '0'),\n      0,\n    ) || 0\n\n  const hourlyRate = calculateHourlyRate(primaryCompensation)\n\n  const totalTipCredit = (parseFloat(effectiveMinWage.wage || '0') - hourlyRate) * totalHours\n  const totalTips = getTotalTipCompensations(compensation.fixedCompensations || [])\n\n  return Math.max(0, totalTipCredit - totalTips)\n}\n\nconst calculateRegularPlusOvertimePay = (\n  compensation: PayrollEmployeeCompensationsType,\n  employee: Employee,\n  effectiveDate: Date,\n  isSalariedWithExpectedHours: boolean,\n  hoursInPayPeriod: number,\n  ptoHours: number,\n  isOffCycle: boolean,\n): number => {\n  if (!isOffCycle && isSalariedWithExpectedHours) {\n    const primaryHourlyRate = getPrimaryHourlyRate(employee, effectiveDate)\n    return primaryHourlyRate * (hoursInPayPeriod - ptoHours)\n  }\n\n  if (!compensation.hourlyCompensations || !employee.jobs) {\n    return 0\n  }\n\n  const regularRatePay = compensation.hourlyCompensations.reduce((sum, hc) => {\n    const hours = parseFloat(hc.hours || '0')\n    const hourlyRate = getHourlyRateForJob(employee, hc.jobUuid || '', effectiveDate)\n    return sum + hours * hourlyRate\n  }, 0)\n\n  const totalHours = compensation.hourlyCompensations.reduce((sum, hc) => {\n    return sum + parseFloat(hc.hours || '0')\n  }, 0)\n\n  if (totalHours === 0) return regularRatePay\n\n  const overtimeWeightedRate = roundToSixDecimals(regularRatePay / totalHours)\n\n  // Calculate overtime pay for non-regular hours\n  const overtimePay = compensation.hourlyCompensations\n    .filter(hc => !isRegularHours(hc.name || ''))\n    .reduce((sum, hc) => {\n      const hours = parseFloat(hc.hours || '0')\n      const multiplier = hc.compensationMultiplier || 1\n      return sum + hours * overtimeWeightedRate * (multiplier - 1)\n    }, 0)\n\n  return regularRatePay + overtimePay\n}\n\nconst calculatePtoPay = (\n  compensation: PayrollEmployeeCompensationsType,\n  employee: Employee,\n  effectiveDate: Date,\n  isSalariedWithExpectedHours: boolean,\n  hoursInPayPeriod: number,\n  offCycle: boolean,\n): number => {\n  const ptoHours = getPtoHours(\n    compensation,\n    isSalariedWithExpectedHours,\n    hoursInPayPeriod,\n    offCycle,\n  )\n  const primaryHourlyRate = getPrimaryHourlyRate(employee, effectiveDate)\n  return ptoHours * primaryHourlyRate\n}\n\nconst isSalariedWithPayPeriodExpectedHours = (\n  compensation: PayrollEmployeeCompensationsType,\n  isSalaried: boolean,\n  hoursInPayPeriod: number,\n): boolean => {\n  if (!isSalaried) return false\n\n  const regularHourlyCompensation = compensation.hourlyCompensations?.find(hourlyCompensation =>\n    isRegularHours(hourlyCompensation.name || ''),\n  )\n\n  if (!regularHourlyCompensation) return false\n\n  const regularHours = parseFloat(regularHourlyCompensation.hours || '0')\n  return regularHours === hoursInPayPeriod\n}\n\n/**\n * Calculates an employee's gross pay for a payroll, combining regular and overtime pay,\n * additional earnings, PTO pay, and any minimum-wage adjustment.\n *\n * @remarks\n * Returns `0` when the compensation is excluded or the employee has no primary job compensation effective\n * on the given date. The result is rounded to two decimal places.\n *\n * @param compensation - The employee compensation entry from the payroll.\n * @param employee - The employee record (used to look up jobs and effective compensations).\n * @param compensationEffectiveDateString - ISO date used to resolve the effective compensation; defaults to now.\n * @param paySchedule - The pay schedule, used to derive expected hours per pay period.\n * @param payrollCategory - The payroll category; off-cycle categories change how PTO hours are summed.\n * @returns The gross pay amount.\n * @internal\n */\nexport const calculateGrossPay = (\n  compensation: PayrollEmployeeCompensationsType,\n  employee: Employee,\n  compensationEffectiveDateString?: string,\n  paySchedule?: PayScheduleObject,\n  payrollCategory: PayrollCategory = PayrollCategory.Regular,\n): number => {\n  if (compensation.excluded) {\n    return 0\n  }\n\n  const compensationEffectiveDate = compensationEffectiveDateString\n    ? new Date(compensationEffectiveDateString)\n    : new Date()\n\n  const primaryJob = getPrimaryJob(employee)\n  if (!primaryJob?.compensations) {\n    return 0\n  }\n\n  const primaryCompensation = getEffectiveCompensation(\n    primaryJob.compensations,\n    compensationEffectiveDate,\n  )\n\n  if (!primaryCompensation) {\n    return 0\n  }\n\n  const salaried = isSalaried(primaryCompensation)\n  const hoursInPayPeriod = paySchedule ? getHoursInPayPeriod(paySchedule) : 0\n\n  const isSalariedWithExpectedHours = isSalariedWithPayPeriodExpectedHours(\n    compensation,\n    salaried,\n    hoursInPayPeriod,\n  )\n\n  const offCycle = isOffCyclePayroll(payrollCategory)\n\n  const ptoHours = getPtoHours(\n    compensation,\n    isSalariedWithExpectedHours,\n    hoursInPayPeriod,\n    offCycle,\n  )\n\n  const regularPlusOvertimePay = calculateRegularPlusOvertimePay(\n    compensation,\n    employee,\n    compensationEffectiveDate,\n    isSalariedWithExpectedHours,\n    hoursInPayPeriod,\n    ptoHours,\n    offCycle,\n  )\n\n  const fixedPay = getAdditionalEarnings(compensation)\n  const ptoPay = calculatePtoPay(\n    compensation,\n    employee,\n    compensationEffectiveDate,\n    isSalariedWithExpectedHours,\n    hoursInPayPeriod,\n    offCycle,\n  )\n  const minimumWageAdjustment = calculateMinimumWageAdjustment(\n    primaryCompensation,\n    compensation,\n    compensationEffectiveDate,\n  )\n\n  const total = regularPlusOvertimePay + fixedPay + ptoPay + minimumWageAdjustment\n  return roundToTwoDecimals(total)\n}\n\n/**\n * Returns the high-level payroll type — `'External'`, `'Off-Cycle'`, or `'Regular'`.\n *\n * @param payroll - The payroll whose type to classify.\n * @returns The payroll type string.\n * @internal\n */\nexport const getPayrollType = (payroll: {\n  external?: boolean\n  offCycle?: boolean\n}): PayrollType => {\n  if (payroll.external) return 'External'\n  if (payroll.offCycle) return 'Off-Cycle'\n  return 'Regular'\n}\n\n/**\n * Returns whether an off-cycle reason indicates a dismissal payroll.\n *\n * @param offCycleReason - The payroll's off-cycle reason string.\n * @returns `true` when the reason matches the dismissed-employee reason.\n * @internal\n */\nexport const isDismissalPayroll = (offCycleReason?: string | null): boolean =>\n  offCycleReason === OffCycleReasonType.DismissedEmployee\n\nconst OFF_CYCLE_REASON_LABELS: Record<string, string> = {\n  Bonus: 'Bonus',\n  Correction: 'Correction',\n  'Transition from old pay schedule': 'Transition',\n  'Dismissed employee': 'Dismissal',\n  'Hired employee': 'New Hire',\n  'Benefit reversal': 'Benefit Reversal',\n  'Wage correction': 'Wage Correction',\n  'Tax reconciliation': 'Tax Reconciliation',\n  Reversal: 'Reversal',\n  'Disability insurance distribution': 'Disability Insurance',\n}\n\n/**\n * Returns a human-readable label describing the payroll type, mapping off-cycle reasons to display strings.\n *\n * @param payroll - The payroll whose type to describe.\n * @returns `'External'`, `'Regular'`, `'Off-Cycle'`, or a label derived from the off-cycle reason\n *   (e.g. `'Bonus'`, `'Dismissal'`).\n * @internal\n */\nexport const getPayrollTypeLabel = (payroll: {\n  external?: boolean\n  offCycle?: boolean\n  offCycleReason?: string | null\n}): string => {\n  if (payroll.external) return 'External'\n  if (payroll.offCycle && payroll.offCycleReason) {\n    return OFF_CYCLE_REASON_LABELS[payroll.offCycleReason] ?? payroll.offCycleReason\n  }\n  if (payroll.offCycle) return 'Off-Cycle'\n  return 'Regular'\n}\n\n/**\n * Merges existing fixed compensations with placeholder entries for any compensation types the employee\n * doesn't yet have, then filters out excluded types and sorts the result alphabetically.\n *\n * @remarks\n * Owners (FLSA status `Owner`) never receive placeholder entries. Placeholders are added with `amount: '0.00'`\n * and the supplied `primaryJobUuid`.\n *\n * @param options - Inputs controlling which placeholder entries to add and which types to exclude.\n * @returns The merged, filtered, and sorted list of fixed compensations.\n * @internal\n */\nexport const getAdditionalEarningsCompensations = ({\n  flsaStatus,\n  existingFixedCompensations = [],\n  primaryJobUuid,\n  fixedCompensationTypes = [],\n  excludedTypes = [],\n}: {\n  flsaStatus: string | undefined\n  existingFixedCompensations?: FixedCompensations[]\n  primaryJobUuid?: string\n  fixedCompensationTypes?: PayrollFixedCompensationTypesType[]\n  excludedTypes?: string[]\n}): FixedCompensations[] => {\n  const allFixedCompensations = [...existingFixedCompensations]\n\n  if (flsaStatus !== FlsaStatus.OWNER && primaryJobUuid && fixedCompensationTypes.length > 0) {\n    const compensationTypeNames = fixedCompensationTypes\n      .map(type => type.name)\n      .filter(Boolean) as string[]\n\n    compensationTypeNames.forEach(compensationName => {\n      const exists = allFixedCompensations.some(\n        comp => comp.name?.toLowerCase() === compensationName.toLowerCase(),\n      )\n\n      if (!exists) {\n        allFixedCompensations.push({\n          name: compensationName,\n          amount: '0.00',\n          jobUuid: primaryJobUuid,\n        })\n      }\n    })\n  }\n\n  // Filter and sort additional earnings (exclude specified types)\n  return allFixedCompensations\n    .filter(comp => comp.name && !excludedTypes.includes(comp.name))\n    .sort((a, b) => (a.name || '').localeCompare(b.name || ''))\n}\n\n/**\n * Returns whether any non-excluded employee compensation uses Direct Deposit.\n *\n * @remarks\n * When the input is empty or every compensation is excluded, returns `true` so callers don't gate UI on an\n * empty set.\n *\n * @param employeeCompensations - The employee compensations to inspect.\n * @returns `true` when at least one active compensation pays via Direct Deposit, or when the list is empty.\n * @internal\n */\nexport const hasDirectDepositEmployees = (\n  employeeCompensations?: Array<{ paymentMethod?: string | null; excluded?: boolean }>,\n): boolean => {\n  if (!employeeCompensations || employeeCompensations.length === 0) return true\n  const activeCompensations = employeeCompensations.filter(comp => !comp.excluded)\n  if (activeCompensations.length === 0) return true\n  return activeCompensations.some(comp => comp.paymentMethod === 'Direct Deposit')\n}\n\n/**\n * Sums gross pay, employer taxes, reimbursements, and benefits from a payroll's totals.\n *\n * @param payrollData - The payroll whose totals to sum.\n * @returns The total payroll cost, or `0` when `payrollData.totals` is missing.\n * @internal\n */\nexport const calculateTotalPayroll = (payrollData: Payroll) => {\n  const totalPayroll = payrollData.totals\n    ? Number(payrollData.totals.grossPay ?? 0) +\n      Number(payrollData.totals.employerTaxes ?? 0) +\n      Number(payrollData.totals.reimbursements ?? 0) +\n      Number(payrollData.totals.benefits ?? 0)\n    : 0\n\n  return totalPayroll\n}\n\n/**\n * Converts a Date to Pacific Time considering Daylight Saving Time.\n * Returns the UTC offset in hours (e.g., -7 for PDT, -8 for PST).\n *\n * DST rules for Pacific Time:\n * - Starts: Second Sunday in March at 2:00 AM\n * - Ends: First Sunday in November at 2:00 AM\n */\nconst getPacificTimeOffset = (date: Date): number => {\n  const year = date.getFullYear()\n\n  const secondSundayMarch = new Date(year, 2, 1)\n  secondSundayMarch.setDate(1 + (7 - secondSundayMarch.getDay()) + 7)\n\n  const firstSundayNovember = new Date(year, 10, 1)\n  firstSundayNovember.setDate(1 + ((7 - firstSundayNovember.getDay()) % 7))\n\n  const isDST = date >= secondSundayMarch && date < firstSundayNovember\n  return isDST ? -7 : -8\n}\n\n/**\n * Determines whether a payroll can be cancelled based on its status, deadline, and the 4:00 PM PT cutoff.\n *\n * @remarks\n * Returns `true` only when the payroll has been processed, `payrollStatusMeta.cancellable` is not explicitly `false`,\n * the payroll has a `payrollDeadline`, and the current time is before 4:00 PM Pacific Time on that deadline date.\n *\n * @param payroll - The payroll to evaluate.\n * @returns `true` if the payroll is still cancellable, `false` otherwise.\n * @internal\n */\nexport const canCancelPayroll = (payroll: Payroll): boolean => {\n  if (payroll.payrollStatusMeta?.cancellable === false) {\n    return false\n  }\n\n  if (!payroll.processed) {\n    return false\n  }\n\n  if (!payroll.payrollDeadline) {\n    return false\n  }\n\n  const now = new Date()\n  const deadline = new Date(payroll.payrollDeadline)\n\n  const nowInPT = new Date(now.getTime() + getPacificTimeOffset(now) * MS_PER_HOUR)\n  const deadlineInPT = new Date(deadline.getTime() + getPacificTimeOffset(deadline) * MS_PER_HOUR)\n\n  const cutoffTime = new Date(deadlineInPT)\n  cutoffTime.setUTCHours(16, 0, 0, 0)\n\n  if (nowInPT >= cutoffTime) {\n    return false\n  }\n\n  return true\n}\n"],"names":["REGULAR_HOURS_NAME","getPrimaryJob","employee","job","roundToSixDecimals","value","roundToTwoDecimals","isRegularHours","compensationName","PAY_PERIOD_HOURS_MAPPINGS","formatEmployeePayRate","locale","primaryJob","jobCompensation","rate","paymentUnit","formatPayRate","useFormatEmployeePayRate","t","useTranslation","useLocale","useCallback","getRegularHours","compensation","hourlyCompensation","sum","getOvertimeHours","getTotalPtoHours","pto","getAdditionalEarnings","fixedCompensation","name","amount","getReimbursements","reimbursement","reimbursementComp","cleanupReimbursements","reimbursements","consolidated","unnamedTotal","numericAmount","description","uuid","formatHoursDisplay","hours","rounded","getHoursInPayPeriod","paySchedule","getEffectiveCompensation","compensations","effectiveDate","sorted","a","b","i","currentDateString","currentDate","getEffectiveMinimumWage","minimumWages","isSalaried","getTotalTipCompensations","fixedCompensations","calculateHourlyRate","getHourlyRateForJob","jobUuid","j","getPrimaryHourlyRate","getTotalOutstandingPtoHours","paidTimeOff","getPtoHours","isSalariedWithExpectedHours","hoursInPayPeriod","offCycle","regularPtoHours","outstandingPtoHours","calculateMinimumWageAdjustment","primaryCompensation","effectiveMinWage","totalHours","hourlyRate","totalTipCredit","totalTips","calculateRegularPlusOvertimePay","ptoHours","isOffCycle","regularRatePay","hc","overtimeWeightedRate","overtimePay","multiplier","calculatePtoPay","primaryHourlyRate","isSalariedWithPayPeriodExpectedHours","regularHourlyCompensation","calculateGrossPay","compensationEffectiveDateString","payrollCategory","PayrollCategory","compensationEffectiveDate","salaried","isOffCyclePayroll","regularPlusOvertimePay","fixedPay","ptoPay","minimumWageAdjustment","total","isDismissalPayroll","offCycleReason","OffCycleReasonType","OFF_CYCLE_REASON_LABELS","getPayrollTypeLabel","payroll","getAdditionalEarningsCompensations","flsaStatus","existingFixedCompensations","primaryJobUuid","fixedCompensationTypes","excludedTypes","allFixedCompensations","FlsaStatus","type","comp","hasDirectDepositEmployees","employeeCompensations","activeCompensations","calculateTotalPayroll","payrollData","getPacificTimeOffset","date","year","secondSundayMarch","firstSundayNovember","canCancelPayroll","now","deadline","nowInPT","MS_PER_HOUR","deadlineInPT","cutoffTime"],"mappings":"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"}

package/dist/components/Payroll/index.d.ts

@@ -1,20 +1,29 @@
 import "./types/i18next.d.ts"
 export { PayrollConfiguration } from './PayrollConfiguration/PayrollConfiguration';
+export type { PayrollConfigurationProps } from './PayrollConfiguration/PayrollConfiguration';
 export { PayrollEditEmployee } from './PayrollEditEmployee/PayrollEditEmployee';
+export type { PayrollEditEmployeeProps } from './PayrollEditEmployee/PayrollEditEmployee';
 export { PayrollHistory } from './PayrollHistory/PayrollHistory';
+export type { PayrollHistoryProps } from './PayrollHistory/PayrollHistory';
 export { PayrollLanding } from './PayrollLanding/PayrollLanding';
+export type { PayrollLandingProps } from './PayrollLanding/PayrollLanding';
 export { PayrollList } from './PayrollList/PayrollList';
+export type { PayrollListBlockProps } from './PayrollList/PayrollList';
 export { OffCycleReasonSelection } from './OffCycleReasonSelection';
-export type { OffCycleReason, OffCycleReasonDefaults, OffCycleReasonSelectionProps, SelectReasonPayload, } from './OffCycleReasonSelection';
+export type { OffCycleReason, OffCycleReasonDefaults, OffCycleReasonSelectionProps, SelectReasonPayload, WithholdingType, } from './OffCycleReasonSelection';
 export { OffCycleDeductionsSetting } from './OffCycleDeductionsSetting';
 export type { OffCycleDeductionsSettingProps, OffCycleDeductionsSettingChangePayload, } from './OffCycleDeductionsSetting';
 export { PayrollOverview } from './PayrollOverview/PayrollOverview';
+export type { PayrollOverviewProps } from './PayrollOverview/PayrollOverview';
 export { PayrollFlow } from './PayrollFlow/PayrollFlow';
+export type { PayrollFlowProps, PayrollFlowAlert } from './PayrollFlow/PayrollFlowComponents';
 export { PayrollExecutionFlow, type PayrollExecutionFlowProps, type PayrollExecutionInitialState, } from './PayrollExecutionFlow';
 export { PayrollReceipts } from './PayrollReceipts/PayrollReceipts';
+export type { PayrollReceiptsProps } from './PayrollReceipts/PayrollReceipts';
 export { ConfirmWireDetails } from './ConfirmWireDetails/ConfirmWireDetails';
 export type { ConfirmWireDetailsProps, ConfirmWireDetailsComponentType } from './ConfirmWireDetails';
 export { PayrollBlockerList, type ApiPayrollBlocker } from './PayrollBlocker';
+export type { PayrollBlockerListProps } from './PayrollBlocker/components/PayrollBlockerList';
 export { RecoveryCases } from './RecoveryCases/RecoveryCases';
 export type { OffCyclePayPeriodDateFormData, OffCyclePayrollDateType, } from './OffCyclePayPeriodDateForm';
 export { OffCycleCreation } from './OffCycleCreation';
@@ -22,7 +31,7 @@ export type { OffCycleCreationProps, OffCycleCreationFormData } from './OffCycle
 export { OffCycleFlow } from './OffCycle';
 export type { OffCycleFlowContextInterface, OffCycleFlowProps } from './OffCycle';
 export { DismissalFlow } from './Dismissal';
-export type { DismissalFlowProps, DismissalFlowContextInterface } from './Dismissal';
+export type { DismissalFlowProps } from './Dismissal';
 export { DismissalPayPeriodSelection } from './Dismissal';
 export type { DismissalPayPeriodSelectionProps } from './Dismissal';
 export { TransitionFlow } from './Transition';

package/dist/components/Payroll/payrollTypes.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Enum-like map of payroll categories combining `Regular`, `External`, and every off-cycle reason.
+ *
+ * @internal
+ */
 export declare const PayrollCategory: {
     readonly Regular: "Regular";
     readonly External: "External";
@@ -12,10 +17,29 @@ export declare const PayrollCategory: {
     readonly Reversal: "Reversal";
     readonly DisabilityInsurance: "Disability insurance distribution";
 };
+/**
+ * Union of payroll category string values from {@link PayrollCategory}.
+ *
+ * @internal
+ */
 export type PayrollCategory = (typeof PayrollCategory)[keyof typeof PayrollCategory];
+/**
+ * Derives a {@link PayrollCategory} from a payroll's `external`, `offCycle`, and `offCycleReason` flags.
+ *
+ * @param payroll - The payroll whose category to derive.
+ * @returns The matching category, falling back to `Regular` when nothing else applies.
+ * @internal
+ */
 export declare function derivePayrollCategory(payroll: {
     offCycle?: boolean;
     offCycleReason?: string | null;
     external?: boolean;
 }): PayrollCategory;
+/**
+ * Returns whether a payroll category represents an off-cycle payroll.
+ *
+ * @param category - The payroll category to check.
+ * @returns `true` for any category other than `Regular` or `External`.
+ * @internal
+ */
 export declare function isOffCyclePayroll(category: PayrollCategory): boolean;

package/dist/components/Payroll/payrollTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"payrollTypes.js","sources":["../../../src/components/Payroll/payrollTypes.ts"],"sourcesContent":["import { OffCycleReasonType } from '@gusto/embedded-api-v-2025-11-15/models/components/payroll'\n\nexport const PayrollCategory = {\n  Regular: 'Regular',\n  External: 'External',\n  Bonus: OffCycleReasonType.Bonus,\n  Correction: OffCycleReasonType.Correction,\n  Dismissal: OffCycleReasonType.DismissedEmployee,\n  HiredEmployee: OffCycleReasonType.HiredEmployee,\n  Transition: OffCycleReasonType.TransitionFromOldPaySchedule,\n  BenefitReversal: OffCycleReasonType.BenefitReversal,\n  WageCorrection: OffCycleReasonType.WageCorrection,\n  TaxReconciliation: OffCycleReasonType.TaxReconciliation,\n  Reversal: OffCycleReasonType.Reversal,\n  DisabilityInsurance: OffCycleReasonType.DisabilityInsuranceDistribution,\n} as const\n\nexport type PayrollCategory = (typeof PayrollCategory)[keyof typeof PayrollCategory]\n\nconst VALID_PAYROLL_CATEGORIES = new Set<string>(Object.values(PayrollCategory))\n\nexport function derivePayrollCategory(payroll: {\n  offCycle?: boolean\n  offCycleReason?: string | null\n  external?: boolean\n}): PayrollCategory {\n  if (payroll.external) return PayrollCategory.External\n  if (\n    payroll.offCycle &&\n    payroll.offCycleReason &&\n    VALID_PAYROLL_CATEGORIES.has(payroll.offCycleReason)\n  ) {\n    return payroll.offCycleReason as PayrollCategory\n  }\n  return PayrollCategory.Regular\n}\n\nexport function isOffCyclePayroll(category: PayrollCategory): boolean {\n  return category !== PayrollCategory.Regular && category !== PayrollCategory.External\n}\n"],"names":["PayrollCategory","OffCycleReasonType","VALID_PAYROLL_CATEGORIES","derivePayrollCategory","payroll","isOffCyclePayroll","category"],"mappings":";AAEO,MAAMA,IAAkB;AAAA,EAC7B,SAAS;AAAA,EACT,UAAU;AAAA,EACV,OAAOC,EAAmB;AAAA,EAC1B,YAAYA,EAAmB;AAAA,EAC/B,WAAWA,EAAmB;AAAA,EAC9B,eAAeA,EAAmB;AAAA,EAClC,YAAYA,EAAmB;AAAA,EAC/B,iBAAiBA,EAAmB;AAAA,EACpC,gBAAgBA,EAAmB;AAAA,EACnC,mBAAmBA,EAAmB;AAAA,EACtC,UAAUA,EAAmB;AAAA,EAC7B,qBAAqBA,EAAmB;AAC1C,GAIMC,IAA2B,IAAI,IAAY,OAAO,OAAOF,CAAe,CAAC;AAExE,SAASG,EAAsBC,GAIlB;AAClB,SAAIA,EAAQ,WAAiBJ,EAAgB,WAE3CI,EAAQ,YACRA,EAAQ,kBACRF,EAAyB,IAAIE,EAAQ,cAAc,IAE5CA,EAAQ,iBAEVJ,EAAgB;AACzB;AAEO,SAASK,EAAkBC,GAAoC;AACpE,SAAOA,MAAaN,EAAgB,WAAWM,MAAaN,EAAgB;AAC9E;"}
+{"version":3,"file":"payrollTypes.js","sources":["../../../src/components/Payroll/payrollTypes.ts"],"sourcesContent":["import { OffCycleReasonType } from '@gusto/embedded-api-v-2025-11-15/models/components/payroll'\n\n/**\n * Enum-like map of payroll categories combining `Regular`, `External`, and every off-cycle reason.\n *\n * @internal\n */\nexport const PayrollCategory = {\n  Regular: 'Regular',\n  External: 'External',\n  Bonus: OffCycleReasonType.Bonus,\n  Correction: OffCycleReasonType.Correction,\n  Dismissal: OffCycleReasonType.DismissedEmployee,\n  HiredEmployee: OffCycleReasonType.HiredEmployee,\n  Transition: OffCycleReasonType.TransitionFromOldPaySchedule,\n  BenefitReversal: OffCycleReasonType.BenefitReversal,\n  WageCorrection: OffCycleReasonType.WageCorrection,\n  TaxReconciliation: OffCycleReasonType.TaxReconciliation,\n  Reversal: OffCycleReasonType.Reversal,\n  DisabilityInsurance: OffCycleReasonType.DisabilityInsuranceDistribution,\n} as const\n\n/**\n * Union of payroll category string values from {@link PayrollCategory}.\n *\n * @internal\n */\nexport type PayrollCategory = (typeof PayrollCategory)[keyof typeof PayrollCategory]\n\nconst VALID_PAYROLL_CATEGORIES = new Set<string>(Object.values(PayrollCategory))\n\n/**\n * Derives a {@link PayrollCategory} from a payroll's `external`, `offCycle`, and `offCycleReason` flags.\n *\n * @param payroll - The payroll whose category to derive.\n * @returns The matching category, falling back to `Regular` when nothing else applies.\n * @internal\n */\nexport function derivePayrollCategory(payroll: {\n  offCycle?: boolean\n  offCycleReason?: string | null\n  external?: boolean\n}): PayrollCategory {\n  if (payroll.external) return PayrollCategory.External\n  if (\n    payroll.offCycle &&\n    payroll.offCycleReason &&\n    VALID_PAYROLL_CATEGORIES.has(payroll.offCycleReason)\n  ) {\n    return payroll.offCycleReason as PayrollCategory\n  }\n  return PayrollCategory.Regular\n}\n\n/**\n * Returns whether a payroll category represents an off-cycle payroll.\n *\n * @param category - The payroll category to check.\n * @returns `true` for any category other than `Regular` or `External`.\n * @internal\n */\nexport function isOffCyclePayroll(category: PayrollCategory): boolean {\n  return category !== PayrollCategory.Regular && category !== PayrollCategory.External\n}\n"],"names":["PayrollCategory","OffCycleReasonType","VALID_PAYROLL_CATEGORIES","derivePayrollCategory","payroll","isOffCyclePayroll","category"],"mappings":";AAOO,MAAMA,IAAkB;AAAA,EAC7B,SAAS;AAAA,EACT,UAAU;AAAA,EACV,OAAOC,EAAmB;AAAA,EAC1B,YAAYA,EAAmB;AAAA,EAC/B,WAAWA,EAAmB;AAAA,EAC9B,eAAeA,EAAmB;AAAA,EAClC,YAAYA,EAAmB;AAAA,EAC/B,iBAAiBA,EAAmB;AAAA,EACpC,gBAAgBA,EAAmB;AAAA,EACnC,mBAAmBA,EAAmB;AAAA,EACtC,UAAUA,EAAmB;AAAA,EAC7B,qBAAqBA,EAAmB;AAC1C,GASMC,IAA2B,IAAI,IAAY,OAAO,OAAOF,CAAe,CAAC;AASxE,SAASG,EAAsBC,GAIlB;AAClB,SAAIA,EAAQ,WAAiBJ,EAAgB,WAE3CI,EAAQ,YACRA,EAAQ,kBACRF,EAAyB,IAAIE,EAAQ,cAAc,IAE5CA,EAAQ,iBAEVJ,EAAgB;AACzB;AASO,SAASK,EAAkBC,GAAoC;AACpE,SAAOA,MAAaN,EAAgB,WAAWM,MAAaN,EAAgB;AAC9E;"}

package/dist/components/Payroll/usePreparedPayrollData.d.ts

@@ -16,5 +16,17 @@ interface UsePreparedPayrollDataReturn {
     isPaginating: boolean;
     hasInitialData: boolean;
 }
+/**
+ * Wraps the prepare-payroll mutation and pay-schedule fetch, retrying while the payroll is still being processed.
+ *
+ * @remarks
+ * Fires the prepare call once on mount, then exposes `handlePreparePayroll` for callers that need to re-prepare
+ * (e.g. after sort or pagination changes). Distinguishes initial loading from subsequent pagination via
+ * `isLoading` and `isPaginating`, and surfaces the pay schedule for the prepared payroll's pay period.
+ *
+ * @param params - The company and payroll identifiers, plus optional employee filter, sort, and ready callback.
+ * @returns The prepared payroll, its pay schedule, loading flags, and a `handlePreparePayroll` callback to re-run.
+ * @internal
+ */
 export declare const usePreparedPayrollData: ({ companyId, payrollId, employeeUuids, sortBy, onDataReady, }: UsePreparedPayrollDataParams) => UsePreparedPayrollDataReturn;
 export {};