@gusto/embedded-react-sdk 0.57.0 → 0.57.2

package/dist/src/components/Company/TaxPayments/shared/taxPaymentStatus.d.ts

@@ -0,0 +1,62 @@
+import { TaxPayment } from '@gusto/embedded-api/models/components/taxpayment';
+/** @internal */
+export type TaxPaymentStatus = 'paid' | 'scheduled' | 'overdue' | 'refund';
+/** @internal */
+export declare const TAX_PAYMENT_STATUSES: readonly TaxPaymentStatus[];
+/**
+ * Value of the "show everything" entry in the jurisdiction and status filters.
+ *
+ * @remarks
+ * A non-empty sentinel rather than `''` so the filter has a real selected key — an empty key reads
+ * as "no selection" to the underlying select, which renders the placeholder instead of the option
+ * and cannot be distinguished from being cleared.
+ *
+ * @internal
+ */
+export declare const ALL_FILTER_VALUE = "all";
+/** @internal */
+export declare const FEDERAL_JURISDICTION = "US";
+/** @internal */
+export declare const TAX_PAYMENT_STATUS_BADGES: Record<TaxPaymentStatus, 'info' | 'success' | 'warning' | 'error'>;
+/** @internal */
+export declare function isFederalTaxPayment(payment: Pick<TaxPayment, 'jurisdiction'>): boolean;
+/**
+ * Resolves the translation key and interpolation values for a tax payment's jurisdiction label.
+ *
+ * @remarks
+ * Returns a key rather than a string because `Company.Management.TaxPaymentsList` and
+ * `Company.Management.TaxPaymentDetail` each own their own i18n namespace and must translate from it. This
+ * keeps the federal/state branching in one place while leaving the lookup to the caller.
+ *
+ * @param payment - The tax payment to label.
+ * @returns The translation key and its interpolation values.
+ * @internal
+ */
+export declare function getJurisdictionLabel(payment: Pick<TaxPayment, 'jurisdiction'>): {
+    key: 'federal' | 'state';
+    values: {
+        jurisdiction: string;
+    };
+};
+/**
+ * Derives a display status for a tax payment.
+ *
+ * @remarks
+ * The API has no status field, so status is derived from the amounts and dates. The API sends
+ * `payment_sent_on: null` for both never-sent and returned/cancelled payments, so a
+ * returned/cancelled state cannot be distinguished here.
+ *
+ * Settlement is checked before the amount's sign, so a refund that has already been sent or
+ * reimbursed reads as `paid` rather than staying `refund` forever.
+ *
+ * A zero-amount payment owes nothing and will never be sent, so it reads as `paid` rather than
+ * sitting in `scheduled` indefinitely. The list endpoint does return zero-amount payments — it
+ * applies `.for_taxes.non_penalty` but not `.with_amounts` — so this is a real case, not a
+ * theoretical one.
+ *
+ * @param payment - The tax payment to classify.
+ * @param today - Today's date as a `YYYY-MM-DD` string in the user's local timezone.
+ * @returns The derived status.
+ * @internal
+ */
+export declare function deriveTaxPaymentStatus(payment: Pick<TaxPayment, 'amount' | 'amountPaid' | 'dueDate' | 'paymentSentOn'>, today: string): TaxPaymentStatus;

package/dist/src/components/Company/TaxPayments/shared/taxPaymentStatus.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/components/Company/TaxPayments/shared/useAllTaxPayments.d.ts

@@ -0,0 +1,30 @@
+import { TaxPayment } from '@gusto/embedded-api/models/components/taxpayment';
+/**
+ * Result of {@link useAllTaxPayments}.
+ *
+ * @internal
+ */
+export interface AllTaxPaymentsResult {
+    /** Every tax payment fetched, newest due date first. */
+    taxPayments: TaxPayment[];
+    /** Whether the server reported more pages than {@link MAX_PAGES} and the list was truncated. */
+    isTruncated: boolean;
+}
+/**
+ * Fetches a company's tax payments so filtering, search, and pagination can be applied client-side.
+ *
+ * @remarks
+ * Suspends until every fetched page resolves. Filtering and search stay client-side deliberately:
+ * the derived `Overdue` and `Scheduled` statuses depend on "not yet sent", which the API exposes no
+ * filter for, the `jurisdiction` filter would silently drop local/city agencies that still report a
+ * state code, and there is no text-search parameter at all.
+ *
+ * Fetching is capped at {@link MAX_PAGES} pages because the endpoint paginates an in-memory array —
+ * each page request reloads the company's full payment history server-side, so an uncapped fan-out
+ * multiplies that cost rather than amortizing it.
+ *
+ * @param companyId - The company whose tax payments are fetched.
+ * @returns The fetched tax payments and whether the list was truncated.
+ * @internal
+ */
+export declare function useAllTaxPayments(companyId: string): AllTaxPaymentsResult;

package/dist/src/components/Company/exports/companyManagement.d.ts

@@ -1,2 +1,4 @@
 export { PaySchedule, type PayScheduleProps, type PayScheduleDictionary, } from '../PaySchedule/management';
 export { PayScheduleAssignment, type PayScheduleAssignmentProps, } from '../PaySchedule/management/PayScheduleAssignment';
+export { TaxPaymentsFlow, TaxPaymentsList, TaxPaymentDetail } from '../TaxPayments';
+export type { TaxPaymentsFlowProps, TaxPaymentsListProps, TaxPaymentDetailProps, } from '../TaxPayments';

package/dist/src/components/Payroll/PayrollConfiguration/__fixtures__/payrollConfigurationMocks.d.ts

@@ -261,6 +261,11 @@ interface PayrollHandlersOptions {
     getPayrollData: () => ReturnType<typeof buildPayrollData>;
     /** Employees returned by the paginated list endpoint. Defaults to all 27. */
     employees?: Array<ReturnType<typeof createEmployee>>;
+    /**
+     * Employees per page returned by the list endpoint, overriding the requested `per`.
+     * Lets pagination tests page through a few rows instead of rendering 25 per page.
+     */
+    pageSize?: number;
     /** Pay schedule returned by the pay-schedule endpoint. */
     paySchedule?: typeof mockPaySchedule;
     /** Blockers returned by the blockers endpoint. Defaults to none. */
@@ -272,5 +277,5 @@ interface PayrollHandlersOptions {
  * and pay schedule. Tests spread these into `server.use(...)` and add/override
  * endpoint handlers (e.g. `calculate`) as needed.
  */
-export declare const buildPayrollConfigurationHandlers: ({ getPayrollData, employees, paySchedule, blockers, }: PayrollHandlersOptions) => HttpHandler[];
+export declare const buildPayrollConfigurationHandlers: ({ getPayrollData, employees, paySchedule, blockers, pageSize, }: PayrollHandlersOptions) => HttpHandler[];
 export {};

package/dist/src/components/Payroll/PayrollFlow/PayrollFlow.d.ts

@@ -19,6 +19,7 @@ import { PayrollFlowProps } from './PayrollFlowComponents';
  * | `runPayroll/processed` | Payroll processing completes | — |
  * | `runPayroll/processingFailed` | Payroll processing fails | Error details |
  * | `runPayroll/cancelled` | A submitted payroll is cancelled | `{ payrollId: string, result: object }` |
+ * | `runPayroll/notCalculated/backToList` | User returns to the payroll list from a payroll that is no longer calculated | — |
  * | `runPayroll/summary/viewed` | The summary screen is opened | `{ payrollId: string }` |
  * | `runPayroll/receipt/viewed` | The receipt screen is opened | `{ payrollId: string }` |
  * | `runPayroll/offCycle/start` | The user starts an off-cycle payroll | — |

package/dist/src/components/Payroll/PayrollLanding/PayrollLanding.d.ts

@@ -35,6 +35,7 @@ export interface PayrollLandingProps extends BaseComponentInterface<'Payroll.Pay
  * | `runPayroll/receipt/viewed` | User opened a payroll's receipt view | `{ payrollId: string }` |
  * | `runPayroll/blockers/viewAll` | User opened the full list of payroll blockers | — |
  * | `runPayroll/cancelled` | A payroll was cancelled | `{ payrollId: string, result: object }` |
+ * | `runPayroll/notCalculated/backToList` | User returns to the payroll list from a payroll that is no longer calculated | — |
  * | `runPayroll/cancelled/alertDismissed` | User dismissed the payroll-cancelled success alert | — |
  *
  * When unprocessed transition pay periods exist, the landing surface renders a Transition

package/dist/src/components/Payroll/PayrollOverview/PayrollOverview.d.ts

@@ -9,7 +9,10 @@ import { BaseComponentInterface } from '../../Base';
 export interface PayrollOverviewProps extends BaseComponentInterface<'Payroll.PayrollOverview'> {
     /** Identifier of the company that owns the payroll. */
     companyId: string;
-    /** Identifier of the payroll being reviewed. The payroll must already be calculated. */
+    /**
+     * Identifier of the payroll being reviewed. An unprocessed payroll must already be calculated;
+     * a processed payroll renders as a summary whether or not it has a calculation.
+     */
     payrollId: string;
     /** Alert banners to display above the payroll summary. */
     alerts?: PayrollFlowAlert[];
@@ -30,8 +33,10 @@ export interface PayrollOverviewProps extends BaseComponentInterface<'Payroll.Pa
  * and per-employee paystub downloads once complete.
  *
  * @remarks
- * The payroll referenced by `payrollId` must already be calculated; rendering with an
- * uncalculated payroll throws. Unresolved submission blockers (e.g. fast-ACH threshold,
+ * An unprocessed payroll referenced by `payrollId` must already be calculated; rendering an
+ * unprocessed, uncalculated payroll throws. Processed payrolls render as a summary even without a
+ * calculation (for example tax reconciliation, reversal, wage correction, or external payrolls).
+ * Unresolved submission blockers (e.g. fast-ACH threshold,
  * wire-in funding) are surfaced inline and the submit action stays disabled until each
  * blocker has a selected unblock option. While the payroll is processing, the component
  * polls until success or failure and emits the corresponding event. Pass `readOnly` to hide
@@ -46,6 +51,7 @@ export interface PayrollOverviewProps extends BaseComponentInterface<'Payroll.Pa
  * | `runPayroll/processed` | Payroll finished processing successfully | `{ payPeriod, payrollUuid }` |
  * | `runPayroll/processingFailed` | Payroll processing failed | — |
  * | `runPayroll/cancelled` | Payroll was cancelled | Cancel payroll response |
+ * | `runPayroll/notCalculated/backToList` | User chose to return to the payroll list after the payroll was found to be no longer calculated (e.g. cancelled in another session) | — |
  * | `runPayroll/receipt/get` | User requested the payroll receipt | `{ payrollId }` |
  * | `runPayroll/pdfPaystub/viewed` | User opened an employee's paystub PDF | `{ employeeId }` |
  * | `payroll/wire/form/done` | Wire-in details were confirmed via the embedded wire form | Submit wire-in response |

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

@@ -169,19 +169,6 @@ export declare const getPayrollType: (payroll: {
  * @internal
  */
 export declare const isDismissalPayroll: (offCycleReason?: string | null) => boolean;
-/**
- * Returns whether an off-cycle reason indicates a tax reconciliation payroll.
- *
- * @remarks
- * Tax reconciliation payrolls are created by Gusto rather than run by the partner. They come
- * back processed with no pay period and no `calculatedAt`, so callers use this to grant them a
- * targeted exception from checks that otherwise assume every payroll has both.
- *
- * @param offCycleReason - The payroll's off-cycle reason string.
- * @returns `true` when the reason matches the tax reconciliation reason.
- * @internal
- */
-export declare const isTaxReconciliationPayroll: (offCycleReason?: string | null) => boolean;
 /**
  * Returns a formatted pay-period range, falling back to the formatted check date when the
  * payroll has no pay period.
@@ -243,14 +230,43 @@ export declare const getAdditionalEarningsCompensations: ({ flsaStatus, existing
  */
 export declare const calculateTotalPayroll: (payrollData: Payroll) => number;
 /**
- * Determines whether a payroll can be cancelled based on its status, deadline, and the 4:00 PM PT cutoff.
+ * Returns the interpolation values for the cancel dialog's deadline sentence.
+ *
+ * @remarks
+ * Translations place `time` and `date` themselves, so word order and the joining word stay
+ * localizable. `deadline` is the legacy pre-joined English string, kept so existing
+ * translations and partner overrides that use `{{deadline}}` keep rendering.
+ *
+ * @param payroll - The payroll whose `payrollDeadline` is shown.
+ * @param dateFormatter - The date formatter returned by {@link useDateFormatter}.
+ * @returns The `time`, `date`, and legacy `deadline` values in the user's local time zone.
+ * @internal
+ */
+export declare const getCancelDeadlineValues: (payroll: {
+    payrollDeadline?: string | Date | null;
+}, dateFormatter: ReturnType<typeof useDateFormatter>) => {
+    time: string;
+    date: string;
+    deadline: string;
+};
+/**
+ * Returns whether to show the cancel action for a payroll.
  *
  * @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.
+ * Shows cancel only when the API will accept it:
+ *
+ * - `payrollStatusMeta.cancellable` is `true`. A missing flag hides cancel, so fetch the payroll
+ *   with `payroll_status_meta`.
+ * - The payroll is processed and not external.
+ * - It is a regular payroll, or an off-cycle payroll with one of the reasons listed above. The
+ *   `cancellable` flag does not check the payroll type yet, so this helper does.
+ * - It is before 4:00 PM PT on the `payrollDeadline` date, so a page left open past the cutoff
+ *   stops offering cancel.
+ *
+ * The API can still refuse if a tax filing was already sent. The payroll data doesn't show that.
  *
- * @param payroll - The payroll to evaluate.
- * @returns `true` if the payroll is still cancellable, `false` otherwise.
+ * @param payroll - The payroll to check, fetched with `payroll_status_meta`.
+ * @returns `true` if cancel should be shown.
  * @internal
  */
 export declare const canCancelPayroll: (payroll: Payroll) => boolean;

package/dist/src/contexts/ApiProvider/payrollOffCycleReasonEnumHook.d.ts

@@ -0,0 +1,14 @@
+import { AfterSuccessHook } from '../../types/hooks';
+/**
+ * Temporary workaround for a Gusto-Partner-API spec gap: `off_cycle_reason` on payroll responses
+ * is generated as a closed enum (`z.nativeEnum(OffCycleReasonType)`) in `@gusto/embedded-api`, but
+ * the API also emits reasons the published OAS doesn't list (e.g. `Max out 401k`, `Other`). A
+ * single such payroll makes the whole `GetV1CompaniesCompanyIdPayrolls` response throw an
+ * `SDKValidationError`, taking down Payroll History and every other payroll list for the company.
+ * This afterSuccess hook nulls out any reason outside the closed enum before the SDK's zod parse,
+ * so the response still validates and the payroll renders as a generic off-cycle payroll. Remove
+ * once the client supports lax/open enum parsing for this field.
+ *
+ * @internal
+ */
+export declare const payrollOffCycleReasonEnumHook: AfterSuccessHook;

package/dist/src/contexts/ApiProvider/payrollOffCycleReasonEnumHook.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/contexts/UnstableFeaturesProvider/useUnstableFeature.d.ts

@@ -21,6 +21,8 @@ export interface UnstableFeatures {
     payrollRegularRateOfPay?: boolean;
     /** Enables the in-development `CompanyManagement.PaySchedule` flow for managing pay schedules and their assignments after onboarding. */
     managePaySchedules?: boolean;
+    /** Enables the in-development `CompanyManagement.TaxPaymentsFlow` for reviewing a company's tax payments and their liabilities. */
+    taxPayments?: boolean;
 }
 /**
  * React context backing {@link useUnstableFeature}.

package/dist/src/helpers/dateFormatting.d.ts

@@ -1,3 +1,4 @@
+import { RFCDate } from '@gusto/embedded-api/types/rfcdate';
 /**
  * Normalizes any date input (string, Date, or undefined) to a Date object.
  *
@@ -99,6 +100,18 @@ export declare const formatPayPeriodRange: (startDateInput?: string | Date | nul
  * @internal
  */
 export declare const formatDateToStringDate: (date: Date) => string | null;
+/**
+ * Converts a `Date` into an `RFCDate` for the same local calendar day.
+ *
+ * @remarks Use this instead of `new RFCDate(date)`, which serializes through
+ * `toISOString()` and shifts the day back by one in timezones ahead of UTC.
+ *
+ * @param date - The date to convert.
+ * @returns An `RFCDate` carrying the local year, month, and day of `date`.
+ * @throws RangeError when `date` is an invalid date.
+ * @internal
+ */
+export declare const toRFCDate: (date: Date) => RFCDate;
 /**
  * Converts any parseable date string to a `YYYY-MM-DD` ISO string using local time.
  *

package/dist/src/i18n/types.d.ts

@@ -35,6 +35,10 @@ export interface Resources {
   /** */
   'Company.Management.PayScheduleAssignment': Translations.CompanyManagementPayScheduleAssignment
   /** */
+  'Company.Management.TaxPaymentDetail': Translations.CompanyManagementTaxPaymentDetail
+  /** */
+  'Company.Management.TaxPaymentsList': Translations.CompanyManagementTaxPaymentsList
+  /** */
   'Company.OnboardingOverview': Translations.CompanyOnboardingOverview
   /** */
   'Company.PaySchedule': Translations.CompanyPaySchedule
@@ -1071,6 +1075,12 @@ export namespace Translations {
       /** @defaultValue `"Pay schedule assignment updated."` */
       assignmentUpdated: string
     }
+    scheduleForm: {
+      /** @defaultValue `"The last date of the first pay period; can be the same as the first pay date."` */
+      anchorEndOfPayPeriodDescription: string
+      /** @defaultValue `"Run payroll by"` */
+      payrollDeadline: string
+    }
   }
   /** Translation keys for the `Company.Management.PayScheduleAssignment` i18n namespace. */
   export interface CompanyManagementPayScheduleAssignment {
@@ -1144,6 +1154,154 @@ export namespace Translations {
     continueCta: string
     /** @defaultValue `"Submit"` */
     submitCta: string
+    scheduleForm: {
+      /** @defaultValue `"The last date of the first pay period; can be the same as the first pay date."` */
+      anchorEndOfPayPeriodDescription: string
+      /** @defaultValue `"Run payroll by"` */
+      payrollDeadline: string
+    }
+  }
+  /** Translation keys for the `Company.Management.TaxPaymentDetail` i18n namespace. */
+  export interface CompanyManagementTaxPaymentDetail {
+    /** @defaultValue `"Back to tax payments"` */
+    backCta: string
+    /** @defaultValue `"Unknown agency"` */
+    unknownAgency: string
+    /** @defaultValue `"Federal"` */
+    federal: string
+    /** @defaultValue `"State · {{jurisdiction}}"` */
+    state: string
+    /** @defaultValue `"—"` */
+    notAvailable: string
+    status: {
+      /** @defaultValue `"Paid"` */
+      paid: string
+      /** @defaultValue `"Scheduled"` */
+      scheduled: string
+      /** @defaultValue `"Overdue"` */
+      overdue: string
+      /** @defaultValue `"Refund / Credit"` */
+      refund: string
+    }
+    overdueAlert: {
+      /** @defaultValue `"Payment overdue"` */
+      label: string
+      /** @defaultValue `"This payment was due on {{dueDate}} and has not been sent. Take action to avoid penalties."` */
+      description: string
+    }
+    details: {
+      /** @defaultValue `"Payment details"` */
+      title: string
+      /** @defaultValue `"Jurisdiction"` */
+      jurisdiction: string
+      /** @defaultValue `"Period"` */
+      period: string
+      /** @defaultValue `"Due date"` */
+      dueDate: string
+      /** @defaultValue `"Payment sent on"` */
+      paymentSentOn: string
+      /** @defaultValue `"Amount"` */
+      amount: string
+      /** @defaultValue `"Amount paid"` */
+      amountPaid: string
+    }
+    liabilities: {
+      /** @defaultValue `"Tax liabilities"` */
+      title: string
+      /** @defaultValue `"Tax liabilities"` */
+      tableLabel: string
+      /** @defaultValue `"Tax ID"` */
+      taxIdColumn: string
+      /** @defaultValue `"Payroll"` */
+      payrollColumn: string
+      /** @defaultValue `"Amount"` */
+      amountColumn: string
+      /** @defaultValue `"No tax liabilities."` */
+      emptyState: string
+    }
+    errors: {
+      /** @defaultValue `"Tax payment not found"` */
+      taxPaymentNotFound: string
+    }
+  }
+  /** Translation keys for the `Company.Management.TaxPaymentsList` i18n namespace. */
+  export interface CompanyManagementTaxPaymentsList {
+    /** @defaultValue `"Tax payments"` */
+    title: string
+    /** @defaultValue `"Tax payments"` */
+    tableLabel: string
+    /** @defaultValue `"Search tax payments"` */
+    searchLabel: string
+    /** @defaultValue `"Search by agency..."` */
+    searchPlaceholder: string
+    /** @defaultValue `"Jurisdiction"` */
+    jurisdictionFilterLabel: string
+    /** @defaultValue `"All jurisdictions"` */
+    allJurisdictions: string
+    /** @defaultValue `"Federal (US)"` */
+    federalJurisdictionOption: string
+    /** @defaultValue `"Status"` */
+    statusFilterLabel: string
+    /** @defaultValue `"All statuses"` */
+    allStatuses: string
+    columns: {
+      /** @defaultValue `"Agency"` */
+      agency: string
+      /** @defaultValue `"Jurisdiction"` */
+      jurisdiction: string
+      /** @defaultValue `"Period"` */
+      period: string
+      /** @defaultValue `"Due date"` */
+      dueDate: string
+      /** @defaultValue `"Amount"` */
+      amount: string
+      /** @defaultValue `"Status"` */
+      status: string
+    }
+    /** @defaultValue `"Federal"` */
+    federal: string
+    /** @defaultValue `"State · {{jurisdiction}}"` */
+    state: string
+    /** @defaultValue `"Unknown agency"` */
+    unknownAgency: string
+    /** @defaultValue `"—"` */
+    notAvailable: string
+    /** @defaultValue `"View"` */
+    viewCta: string
+    /** @defaultValue `"View {{agency}} tax payment"` */
+    viewPaymentLabel: string
+    status: {
+      /** @defaultValue `"Paid"` */
+      paid: string
+      /** @defaultValue `"Scheduled"` */
+      scheduled: string
+      /** @defaultValue `"Overdue"` */
+      overdue: string
+      /** @defaultValue `"Refund / Credit"` */
+      refund: string
+    }
+    overdueAlert: {
+      /** @defaultValue `"{{count}} tax payment is overdue and may require immediate attention."` */
+      label_one: string
+      /** @defaultValue `"{{count}} tax payments are overdue and may require immediate attention."` */
+      label_other: string
+    }
+    emptyState: {
+      /** @defaultValue `"No tax payments yet"` */
+      title: string
+      /** @defaultValue `"Tax payments appear here after payroll is processed."` */
+      description: string
+    }
+    noResults: {
+      /** @defaultValue `"No matching tax payments"` */
+      title: string
+      /** @defaultValue `"Try a different search or adjust the filters."` */
+      description: string
+    }
+    truncatedAlert: {
+      /** @defaultValue `"Showing the most recent tax payments. Older payments are not included."` */
+      label: string
+    }
   }
   /** Translation keys for the `Company.OnboardingOverview` i18n namespace. */
   export interface CompanyOnboardingOverview {
@@ -1444,6 +1602,8 @@ export namespace Translations {
       errors: {
         /** @defaultValue `"{{section}} for {{state}} is incomplete. Complete all required fields and try again."` */
         incompleteRequirementSet: string
+        /** @defaultValue `"Some values in {{section}} for {{state}} are invalid. Correct the highlighted fields and try again."` */
+        invalidRequirementSet: string
       }
       validations: {
         /** @defaultValue `"Minimum value is {{min}}%"` */
@@ -7981,7 +8141,7 @@ export namespace Translations {
       title: string
       /** @defaultValue `"You may cancel this payroll and run it again later. Your changes will be saved."` */
       body: string
-      /** @defaultValue `"Run this payroll by {{deadline}} to pay your employees on time."` */
+      /** @defaultValue `"Run this payroll by {{time}} on {{date}} to pay your employees on time."` */
       deadline: string
       /** @defaultValue `"Yes, cancel payroll"` */
       primaryAction: string
@@ -8143,7 +8303,7 @@ export namespace Translations {
     cancelDialogTitleDismissal: string
     /** @defaultValue `"You may cancel this payroll and run it again later. Your changes will be saved."` */
     cancelDialogDescription: string
-    /** @defaultValue `"Run this payroll by {{deadline}} to pay your employees on time."` */
+    /** @defaultValue `"Run this payroll by {{time}} on {{date}} to pay your employees on time."` */
     cancelDialogDescriptionDeadline: string
     /** @defaultValue `"Yes, cancel payroll"` */
     confirmCancelCta: string
@@ -8165,11 +8325,15 @@ export namespace Translations {
     cancellingTitle: string
     /** @defaultValue `"This payroll has been cancelled."` */
     cancelledEmptyState: string
+    /** @defaultValue `"This payroll has changed"` */
+    notCalculatedErrorTitle: string
+    /** @defaultValue `"Refresh or return to your payrolls to continue."` */
+    notCalculatedErrorDescription: string
+    /** @defaultValue `"Back to payrolls"` */
+    notCalculatedErrorCta: string
     /** @defaultValue `"Skipped"` */
     skippedBadge: string
     alerts: {
-      /** @defaultValue `"Payroll is not calculated"` */
-      payrollNotCalculated: string
       /** @defaultValue `"There was an issue loading this payroll. Please try again."` */
       payrollLoadFailed: string
       /** @defaultValue `"To pay your employees with direct deposit by {{payDate}}, you'll need to run payroll by {{time}} on {{date}}."` */

package/dist/src/models/external.d.ts

@@ -335,6 +335,8 @@ export { IdentityVerificationStatus } from '@gusto/embedded-api/models/component
 /** `SignatoryHomeAddress` entity from the Gusto Embedded API. */
 export type { SignatoryHomeAddress } from '@gusto/embedded-api/models/components/signatory';
 export type { Signatory } from '@gusto/embedded-api/models/components/signatory';
+export type { TaxPayment } from '@gusto/embedded-api/models/components/taxpayment';
+export type { TaxPaymentLineItem } from '@gusto/embedded-api/models/components/taxpaymentlineitem';
 /** `ApplicableIf` entity from the Gusto Embedded API. */
 export type { ApplicableIf } from '@gusto/embedded-api/models/components/taxrequirement';
 /** `TaxRequirement` entity from the Gusto Embedded API. */

package/dist/src/shared/constants.d.ts

@@ -349,6 +349,7 @@ export declare const runPayrollEvents: {
     readonly RUN_PAYROLL_ALREADY_PROCESSED: "runPayroll/alreadyProcessed";
     readonly RUN_PAYROLL_CANCELLED: "runPayroll/cancelled";
     readonly RUN_PAYROLL_CANCELLED_ALERT_DISMISSED: "runPayroll/cancelled/alertDismissed";
+    readonly RUN_PAYROLL_NOT_CALCULATED_BACK_TO_LIST: "runPayroll/notCalculated/backToList";
     readonly RUN_PAYROLL_EDIT: "runPayroll/edit";
     readonly RUN_PAYROLL_EMPLOYEE_EDIT: "runPayroll/employee/edit";
     readonly RUN_PAYROLL_EMPLOYEE_SKIP: "runPayroll/employee/skip";
@@ -446,6 +447,20 @@ export declare const printChecksEvents: {
     readonly PRINT_CHECKS_CANCEL: "payroll/printChecks/cancel";
     readonly PRINT_CHECKS_CLOSE: "payroll/printChecks/close";
 };
+/**
+ * Event keys emitted by the tax payments components.
+ *
+ * @remarks
+ * These keys are merged into {@link componentEvents}. Consume them through the
+ * `onEvent` handler of a tax payments component and compare against the
+ * value of an entry on this object.
+ *
+ * @alpha
+ */
+export declare const taxPaymentEvents: {
+    readonly TAX_PAYMENT_VIEW: "company/taxPayments/view";
+    readonly TAX_PAYMENT_BACK: "company/taxPayments/back";
+};
 /**
  * Event keys emitted by off-cycle payroll and transition components.
  *
@@ -596,6 +611,8 @@ export declare const componentEvents: {
     readonly CONTRACTOR_PAYMENT_CANCEL: "contractor/payments/cancel";
     readonly CONTRACTOR_PAYMENT_EXIT: "contractor/payments/exit";
     readonly CONTRACTOR_PAYMENT_RFI_RESPOND: "contractor/payments/rfi/respond";
+    readonly TAX_PAYMENT_VIEW: "company/taxPayments/view";
+    readonly TAX_PAYMENT_BACK: "company/taxPayments/back";
     readonly PRINT_CHECKS_START: "payroll/printChecks/start";
     readonly PRINT_CHECKS_GENERATE_START: "payroll/printChecks/generate/start";
     readonly PRINT_CHECKS_GENERATE_SUCCEEDED: "payroll/printChecks/generate/succeeded";
@@ -622,6 +639,7 @@ export declare const componentEvents: {
     readonly RUN_PAYROLL_ALREADY_PROCESSED: "runPayroll/alreadyProcessed";
     readonly RUN_PAYROLL_CANCELLED: "runPayroll/cancelled";
     readonly RUN_PAYROLL_CANCELLED_ALERT_DISMISSED: "runPayroll/cancelled/alertDismissed";
+    readonly RUN_PAYROLL_NOT_CALCULATED_BACK_TO_LIST: "runPayroll/notCalculated/backToList";
     readonly RUN_PAYROLL_EDIT: "runPayroll/edit";
     readonly RUN_PAYROLL_EMPLOYEE_EDIT: "runPayroll/employee/edit";
     readonly RUN_PAYROLL_EMPLOYEE_SKIP: "runPayroll/employee/skip";