@gusto/embedded-react-sdk 0.55.6 → 0.55.8

package/dist/{components → src/components}/Payroll/PayrollEditEmployee/shared/usePayrollEditEmployeeForm/usePayrollEditEmployeeForm.d.ts

@@ -4,7 +4,8 @@ import { PayrollEmployeeCompensationsType } from '@gusto/embedded-api/models/com
 import { PayrollPrepared } from '@gusto/embedded-api/models/components/payrollshow';
 import { PayScheduleShow } from '@gusto/embedded-api/models/components/payscheduleshow';
 import { PayrollEditEmployeeFormData } from './payrollEditEmployeeSchema';
-import { PayrollEditEmployeeFields, ReimbursementRow } from './fields';
+import { NormalizedWorkweek } from './payrollEditEmployeeHelpers';
+import { PayrollEditEmployeeErrorMessages, PayrollEditEmployeeFields, ReimbursementRow } from './fields';
 import { BaseFormHookReady, FieldMetadata, FieldMetadataWithOptions, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
 /**
  * Options accepted by {@link usePayrollEditEmployeeForm}.
@@ -29,6 +30,13 @@ export interface UsePayrollEditEmployeeFormProps {
     validationMode?: UseFormProps['mode'];
     /** Auto-focus the first invalid field on submit. Defaults to `true`. Set to `false` when composing with other forms. */
     shouldFocusError?: boolean;
+    /**
+     * Display copy for each validation error code, baked into every bound field so
+     * it resolves and renders its own message. Supply it once, keyed by
+     * {@link PayrollEditEmployeeErrorCodes}; a missing code falls back to the raw
+     * code. Omit it to render raw codes.
+     */
+    errorMessages?: PayrollEditEmployeeErrorMessages;
 }
 /**
  * Field metadata for {@link usePayrollEditEmployeeForm}, keyed by full form path.
@@ -60,8 +68,26 @@ export interface UsePayrollEditEmployeeFormReady extends BaseFormHookReady<Payro
         paySchedule?: PayScheduleShow;
         /** Whether the pay period spans more than one workweek. Raw workweeks are on `preparedPayroll.workweeks`. */
         isMultipleWorkweeks: boolean;
+        /**
+         * The pay period's normalized workweeks (`{ startDate, endDate }` strings),
+         * in order — one entry, spanning the pay period, when it's a single
+         * workweek. The per-workweek split fields are keyed by start date only, so
+         * this is the source for each column's date range.
+         */
+        workweeks: NormalizedWorkweek[];
         /** Whether the employee is overtime-eligible (nonexempt family). Drives whether hours split by workweek. */
         isOvertimeEligible: boolean;
+        /**
+         * The single, form-wide overtime-mode flag. `false` renders one flat
+         * column per line with Overtime/Double-overtime rows hidden; `true`
+         * splits hours and overtime-affecting earnings into per-workweek columns
+         * (for overtime-eligible employees on a multi-workweek payroll) and
+         * un-hides those rows. Starts `true` when the employee already has real
+         * overtime hours or matching per-workweek breakdowns (see
+         * `hasExistingOvertimeHours`, `hasBreakdownsMatchingWorkweeks`), or after
+         * `actions.addOvertime` is called; otherwise starts `false`.
+         */
+        withOvertime: boolean;
         /** Whether the employee has a direct-deposit bank account set up. */
         hasDirectDepositSetup: boolean;
         /**
@@ -81,6 +107,17 @@ export interface UsePayrollEditEmployeeFormReady extends BaseFormHookReady<Payro
     actions: {
         /** Validates and submits the form, resolving to the updated prepared payroll on success or `undefined` when validation blocked the submit. */
         onSubmit: () => Promise<HookSubmitResult<PayrollPrepared> | undefined>;
+        /**
+         * Sets `data.withOvertime` to `true`, switching the whole form to the
+         * workweek split: un-hides Overtime/Double-overtime rows and splits hours
+         * and overtime-affecting earnings into per-workweek columns. Populates
+         * only the first workweek cell of each line with that line's current
+         * total, leaving every other cell blank — no auto distribution — so the
+         * per-row validation then requires the user to fill in the rest. One
+         * affordance for the whole employee, not one per job. One-directional —
+         * there's no corresponding "remove overtime" action.
+         */
+        addOvertime: () => void;
         /** Reveals the draft reimbursement row. Present only when reimbursement controls are exposed. */
         beginAddReimbursement?: () => void;
         /** Validates the draft and commits it to the reimbursement list, or flags the draft amount if invalid. Present only when reimbursement controls are exposed. */
@@ -113,14 +150,16 @@ export type UsePayrollEditEmployeeFormResult = HookLoadingResult | UsePayrollEdi
  * @remarks
  * Prepares the payroll for the target employee, then exposes a workweek-keyed
  * form whose submit builds a `PayrollUpdate`. Single-workweek pay periods send
- * totals without `breakdowns`; multi-workweek pay periods send `breakdowns`
- * tiling every workweek exactly. Overtime-eligible (nonexempt) employees split
- * hours and overtime-affecting earnings per workweek; everyone else edits flat
- * totals.
+ * totals without `breakdowns`; multi-workweek pay periods send `breakdowns` per
+ * line once that line's every workweek cell is filled. Overtime-eligible
+ * (nonexempt) employees split hours and overtime-affecting earnings per
+ * workweek while the single `data.withOvertime` flag is on (see
+ * `actions.addOvertime`); everyone else, and every line while `withOvertime` is
+ * off, edits flat totals.
  *
  * @param props - Hook options.
  * @returns A loading result while data is fetching, or a ready result with data,
  * fields, status, actions, and error handling.
  * @public
  */
-export declare function usePayrollEditEmployeeForm({ employeeId, companyId, payrollId, withReimbursements, validationMode, shouldFocusError, }: UsePayrollEditEmployeeFormProps): UsePayrollEditEmployeeFormResult;
+export declare function usePayrollEditEmployeeForm({ employeeId, companyId, payrollId, withReimbursements, validationMode, shouldFocusError, errorMessages, }: UsePayrollEditEmployeeFormProps): UsePayrollEditEmployeeFormResult;

package/dist/{components → src/components}/Payroll/PayrollHistory/PayrollHistoryPresentation.d.ts

@@ -3,6 +3,8 @@ import { WireInRequest } from '@gusto/embedded-api/models/components/wireinreque
 import { PaginationControlProps } from '../../Common/PaginationControl/PaginationControlTypes';
 import { UseDateRangeFilterResult } from '../../../hooks/useDateRangeFilter/useDateRangeFilter';
 interface PayrollHistoryPresentationProps {
+    /** CSS class name applied to the root element. */
+    className?: string;
     payrollHistory: Payroll[];
     wireInRequests: WireInRequest[];
     pagination: PaginationControlProps;
@@ -16,5 +18,5 @@ interface PayrollHistoryPresentationProps {
     dateRangeFilter: UseDateRangeFilterResult;
 }
 /** @internal */
-export declare const PayrollHistoryPresentation: ({ payrollHistory, wireInRequests, pagination, onViewSummary, onViewReceipt, onCancelPayroll, cancelDialogItem, onCancelDialogOpen, onCancelDialogClose, isLoading, dateRangeFilter, }: PayrollHistoryPresentationProps) => import("react").JSX.Element;
+export declare const PayrollHistoryPresentation: ({ className, payrollHistory, wireInRequests, pagination, onViewSummary, onViewReceipt, onCancelPayroll, cancelDialogItem, onCancelDialogOpen, onCancelDialogClose, isLoading, dateRangeFilter, }: PayrollHistoryPresentationProps) => import("react").JSX.Element;
 export {};

package/dist/{components → src/components}/Payroll/PayrollList/PayrollListPresentation.d.ts

@@ -5,6 +5,8 @@ import { ApiPayrollBlocker } from '../PayrollBlocker/payrollHelpers';
 import { PaginationControlProps } from '../../Common/PaginationControl/PaginationControlTypes';
 import { UseDateRangeFilterResult } from '../../../hooks/useDateRangeFilter/useDateRangeFilter';
 interface PayrollListPresentationProps {
+    /** CSS class name applied to the root element. */
+    className?: string;
     onRunPayroll: ({ payrollUuid, payPeriod }: Pick<Payroll, 'payrollUuid' | 'payPeriod'>) => void;
     onSubmitPayroll: ({ payrollUuid, payPeriod }: Pick<Payroll, 'payrollUuid' | 'payPeriod'>) => void;
     onSkipPayroll: ({ payrollUuid }: Pick<Payroll, 'payrollUuid'>) => void;
@@ -26,5 +28,5 @@ interface PayrollListPresentationProps {
     withOffcyclePayroll?: boolean;
 }
 /** @internal */
-export declare const PayrollListPresentation: ({ onRunPayroll, onSubmitPayroll, onSkipPayroll, onDeletePayroll, onRunOffCyclePayroll, payrolls, pagination, paySchedules, showSkipSuccessAlert, onDismissSkipSuccessAlert, showDeleteSuccessAlert, onDismissDeleteSuccessAlert, skippingPayrollId, deletingPayrollId, blockers, wireInRequests, dateRangeFilter, hasUnprocessedTransitions, withOffcyclePayroll, }: PayrollListPresentationProps) => import("react").JSX.Element;
+export declare const PayrollListPresentation: ({ className, onRunPayroll, onSubmitPayroll, onSkipPayroll, onDeletePayroll, onRunOffCyclePayroll, payrolls, pagination, paySchedules, showSkipSuccessAlert, onDismissSkipSuccessAlert, showDeleteSuccessAlert, onDismissDeleteSuccessAlert, skippingPayrollId, deletingPayrollId, blockers, wireInRequests, dateRangeFilter, hasUnprocessedTransitions, withOffcyclePayroll, }: PayrollListPresentationProps) => import("react").JSX.Element;
 export {};

package/dist/{components → src/components}/Payroll/PayrollOverview/PayrollOverviewPresentation.d.ts

@@ -6,7 +6,9 @@ import { PayrollFlowAlert } from '../PayrollFlow/PayrollFlowComponents';
 import { PayrollOverviewStatus } from './PayrollOverviewTypes';
 import { PaginationControlProps } from '../../Common/PaginationControl/PaginationControlTypes';
 interface PayrollOverviewProps {
+    className?: string;
     payrollData: PayrollShow;
+    employeeFlsaStatusByUuid?: Record<string, string | undefined>;
     bankAccount?: CompanyBankAccount;
     taxes: Record<string, {
         employee: number;
@@ -33,5 +35,5 @@ interface PayrollOverviewProps {
     downloadingEmployeeIds?: ReadonlySet<string>;
 }
 /** @internal */
-export declare const PayrollOverviewPresentation: ({ onEdit, onSubmit, onCancel, onPayrollReceipt, onPaystubDownload, payrollData, bankAccount, taxes, status, isProcessed, canCancel, canEdit, alerts, submissionBlockers, selectedUnblockOptions, onUnblockOptionChange, wireInConfirmationRequest, printChecksBanner, withReimbursements, paymentSpeed, pagination, downloadingEmployeeIds, }: PayrollOverviewProps) => import("react").JSX.Element;
+export declare const PayrollOverviewPresentation: ({ className, onEdit, onSubmit, onCancel, onPayrollReceipt, onPaystubDownload, payrollData, employeeFlsaStatusByUuid, bankAccount, taxes, status, isProcessed, canCancel, canEdit, alerts, submissionBlockers, selectedUnblockOptions, onUnblockOptionChange, wireInConfirmationRequest, printChecksBanner, withReimbursements, paymentSpeed, pagination, downloadingEmployeeIds, }: PayrollOverviewProps) => import("react").JSX.Element;
 export {};

package/dist/{components → src/components}/Payroll/PayrollReceipts/PayrollReceiptsPresentation.d.ts

@@ -1,8 +1,9 @@
 import { PayrollReceipt } from '@gusto/embedded-api/models/components/payrollreceipt';
 interface PayrollReceiptsPresentationProps {
+    className?: string;
     receiptData: PayrollReceipt;
     withReimbursements?: boolean;
 }
 /** @internal */
-export declare const PayrollReceiptsPresentation: ({ receiptData, withReimbursements, }: PayrollReceiptsPresentationProps) => import("react").JSX.Element;
+export declare const PayrollReceiptsPresentation: ({ className, receiptData, withReimbursements, }: PayrollReceiptsPresentationProps) => import("react").JSX.Element;
 export {};

package/dist/src/components/Payroll/TransitionCreation/TransitionCreationPresentation.d.ts

@@ -0,0 +1,9 @@
+import { TransitionCreationPresentationProps } from './TransitionCreationTypes';
+/**
+ * Presentational layout for the transition payroll creation form.
+ *
+ * @param props - {@link TransitionCreationPresentationProps}.
+ * @returns The transition payroll creation form layout.
+ * @internal
+ */
+export declare function TransitionCreationPresentation({ className, startDate, endDate, payScheduleName, isPending, taxWithholdingConfig, isTaxWithholdingModalOpen, onTaxWithholdingEditClick, onTaxWithholdingModalDone, onTaxWithholdingModalCancel, }: TransitionCreationPresentationProps): import("react").JSX.Element;

package/dist/{components → src/components}/Payroll/TransitionCreation/TransitionCreationTypes.d.ts

@@ -34,6 +34,8 @@ export declare function createTransitionCreationSchema(t: (key: string, options?
 }, z.core.$strip>;
 /** @internal */
 export interface TransitionCreationPresentationProps {
+    /** CSS class name applied to the component's root element. */
+    className?: string;
     /** The start date of the transition pay period (YYYY-MM-DD). */
     startDate: string;
     /** The end date of the transition pay period (YYYY-MM-DD). */

package/dist/{components → src/components}/Payroll/TransitionPayrollAlert/TransitionPayrollAlert.d.ts

@@ -1,9 +1,11 @@
+import { LoaderComponentType } from '../../Base/Base';
 import { OnEventType } from '../../Base/useBase';
 import { EventType } from '../../../shared/constants';
 interface TransitionPayrollAlertProps {
     companyId: string;
     onEvent: OnEventType<EventType, unknown>;
+    LoaderComponent?: LoaderComponentType;
 }
 /** @internal */
-export declare function TransitionPayrollAlert({ companyId, onEvent }: TransitionPayrollAlertProps): import("react").JSX.Element;
+export declare function TransitionPayrollAlert({ companyId, onEvent, LoaderComponent, }: TransitionPayrollAlertProps): import("react").JSX.Element;
 export {};

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

@@ -0,0 +1,20 @@
+import { PayrollEditEmployeeProps } from '../PayrollEditEmployee/PayrollEditEmployee';
+/**
+ * In-development regular-rate-of-pay rebuild of {@link PayrollEditEmployee}.
+ *
+ * @remarks
+ * Gated behind the `payrollRegularRateOfPay` unstable feature flag and not part of the public
+ * SDK surface. `PayrollEditEmployee` renders this in place of the stable editor when the flag is
+ * enabled. Consumes {@link usePayrollEditEmployeeForm} and renders the header, the hours /
+ * additional-earnings / time-off / payment-method sections, and the
+ * `Cancel`/`Save` controls, performing a real payroll update on save. For an overtime-eligible
+ * employee on a multi-workweek payroll, Overtime/Double-overtime rows start hidden behind a single,
+ * employee-level "Add overtime" control (`form.data.withOvertime` / `form.actions.addOvertime`)
+ * unless the employee already has real overtime hours or matching per-workweek breakdowns; adding
+ * overtime also switches hours and overtime-affecting earnings to per-workweek columns and surfaces
+ * the per-row "fill in every workweek" validation. `Cancel` and `Save` emit the same events as the
+ * stable component so the surrounding flow behaves identically.
+ *
+ * @internal
+ */
+export declare function UNSTABLE_PayrollEditEmployee({ FallbackComponent, LoaderComponent, ...props }: PayrollEditEmployeeProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/AddEmployeesHoliday/AddEmployeesHoliday.d.ts

@@ -21,4 +21,4 @@ export interface AddEmployeesHolidayProps extends BaseComponentInterface<never>
  * @returns The rendered holiday employee selection screen.
  * @public
  */
-export declare function AddEmployeesHoliday(props: AddEmployeesHolidayProps): import("react").JSX.Element;
+export declare function AddEmployeesHoliday({ className, ...props }: AddEmployeesHolidayProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/AddEmployeesToPolicy/AddEmployeesToPolicy.d.ts

@@ -50,4 +50,4 @@ export interface AddEmployeesToPolicyProps extends BaseComponentInterface<never>
  * }
  * ```
  */
-export declare function AddEmployeesToPolicy(props: AddEmployeesToPolicyProps): import("react").JSX.Element;
+export declare function AddEmployeesToPolicy({ className, ...props }: AddEmployeesToPolicyProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/HolidayPolicyDetail/HolidayPolicyDetailPresentation.d.ts

@@ -1,3 +1,3 @@
 import { HolidayPolicyDetailPresentationProps } from './HolidayPolicyDetailTypes';
 /** @internal */
-export declare function HolidayPolicyDetailPresentation({ title, subtitle, onBack, backLabel, actions, holidays, selectedTabId, onTabChange, employees, onAddEmployee, removeDialog, successAlert, onDismissAlert, }: HolidayPolicyDetailPresentationProps): import("react").JSX.Element;
+export declare function HolidayPolicyDetailPresentation({ title, subtitle, onBack, backLabel, actions, holidays, selectedTabId, onTabChange, employees, onAddEmployee, removeDialog, successAlert, onDismissAlert, className, }: HolidayPolicyDetailPresentationProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/HolidayPolicyDetail/HolidayPolicyDetailTypes.d.ts

@@ -45,4 +45,6 @@ export interface HolidayPolicyDetailPresentationProps {
     successAlert?: string;
     /** Called when the success alert is dismissed. */
     onDismissAlert?: () => void;
+    /** CSS class name applied to the root element. */
+    className?: string;
 }

package/dist/{components → src/components}/TimeOff/HolidaySelectionForm/HolidaySelectionFormTypes.d.ts

@@ -15,6 +15,8 @@ export interface HolidayItem {
 }
 interface HolidaySelectionFormBaseProps {
     holidays: HolidayItem[];
+    /** CSS class name applied to the root element. */
+    className?: string;
 }
 interface HolidaySelectionFormSelectModeProps extends HolidaySelectionFormBaseProps {
     mode?: 'select';

package/dist/{components → src/components}/TimeOff/PolicyList/PolicyListPresentation.d.ts

@@ -1,3 +1,3 @@
 import { PolicyListPresentationProps } from './PolicyListTypes';
 /** @internal */
-export declare function PolicyListPresentation({ policies, onCreatePolicy, onEditPolicy, onFinishSetup, onDeletePolicy, deleteSuccessAlert, onDismissDeleteAlert, isDeletingPolicyId, isPending, }: PolicyListPresentationProps): import("react").JSX.Element;
+export declare function PolicyListPresentation({ policies, onCreatePolicy, onEditPolicy, onFinishSetup, onDeletePolicy, deleteSuccessAlert, onDismissDeleteAlert, isDeletingPolicyId, isPending, className, }: PolicyListPresentationProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/PolicyList/PolicyListTypes.d.ts

@@ -33,4 +33,6 @@ export interface PolicyListPresentationProps {
     isDeletingPolicyId?: string | null;
     /** True while any mutation is in flight; drives the dialog confirm button's loading state. */
     isPending?: boolean;
+    /** CSS class name applied to the root element. */
+    className?: string;
 }

package/dist/{components → src/components}/TimeOff/PolicySettings/PolicySettingsPresentation.d.ts

@@ -13,4 +13,4 @@ import { PolicySettingsPresentationProps } from './PolicySettingsTypes';
  * @returns The rendered policy settings form.
  * @public
  */
-export declare function PolicySettingsPresentation({ accrualMethod, onContinue, onBack, defaultValues, mode, editingPolicyName, isPending, }: PolicySettingsPresentationProps): import("react").JSX.Element;
+export declare function PolicySettingsPresentation({ accrualMethod, onContinue, onBack, defaultValues, mode, editingPolicyName, isPending, className, }: PolicySettingsPresentationProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/PolicySettings/PolicySettingsTypes.d.ts

@@ -49,4 +49,6 @@ export interface PolicySettingsPresentationProps {
     editingPolicyName?: string;
     /** Whether a submit is in flight. Disables the back button and shows a loading state on the continue button. */
     isPending?: boolean;
+    /** CSS class name applied to the root element. */
+    className?: string;
 }

package/dist/{components → src/components}/TimeOff/PolicyTypeSelector/PolicyTypeSelectorPresentation.d.ts

@@ -1,3 +1,3 @@
 import { PolicyTypeSelectorPresentationProps } from './PolicyTypeSelectorTypes';
 /** @internal */
-export declare function PolicyTypeSelectorPresentation({ onContinue, onCancel, defaultPolicyType, holidayPolicyExists, }: PolicyTypeSelectorPresentationProps): import("react").JSX.Element;
+export declare function PolicyTypeSelectorPresentation({ onContinue, onCancel, defaultPolicyType, holidayPolicyExists, className, }: PolicyTypeSelectorPresentationProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/PolicyTypeSelector/PolicyTypeSelectorTypes.d.ts

@@ -14,4 +14,6 @@ export interface PolicyTypeSelectorPresentationProps {
     defaultPolicyType?: PolicyType;
     /** When true, the holiday option is omitted because the company already has a holiday pay policy. */
     holidayPolicyExists?: boolean;
+    /** CSS class name applied to the root element. */
+    className?: string;
 }

package/dist/{components → src/components}/TimeOff/TimeOffManagement/PolicyConfigurationForm/PolicyConfigurationFormPresentation.d.ts

@@ -1,3 +1,3 @@
 import { PolicyConfigurationFormPresentationProps } from './PolicyConfigurationFormTypes';
 /** @internal */
-export declare function PolicyConfigurationFormPresentation({ onContinue, onCancel, defaultValues, editingPolicyName, isPending, lockedAccrualCategory, }: PolicyConfigurationFormPresentationProps): import("react").JSX.Element;
+export declare function PolicyConfigurationFormPresentation({ onContinue, onCancel, defaultValues, editingPolicyName, isPending, lockedAccrualCategory, className, }: PolicyConfigurationFormPresentationProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/TimeOffManagement/PolicyConfigurationForm/PolicyConfigurationFormTypes.d.ts

@@ -78,5 +78,7 @@ export interface PolicyConfigurationFormPresentationProps {
     isPending?: boolean;
     /** Restricts the accrual method options when editing a completed policy. */
     lockedAccrualCategory?: LockedAccrualCategory;
+    /** CSS class name applied to the root element. */
+    className?: string;
 }
 export {};

package/dist/{components → src/components}/TimeOff/TimeOffManagement/SelectEmployees/SelectEmployeesHoliday.d.ts

@@ -1,6 +1,8 @@
 interface SelectEmployeesHolidayProps {
     companyId: string;
     mode?: 'standalone' | 'wizard';
+    /** CSS class name applied to the root element. */
+    className?: string;
 }
 /** @internal */
 export declare function SelectEmployeesHoliday(props: SelectEmployeesHolidayProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/TimeOffManagement/SelectEmployees/SelectEmployeesPresentation.d.ts

@@ -1,3 +1,3 @@
 import { SelectEmployeesPresentationProps } from './SelectEmployeesPresentationTypes';
 /** @internal */
-export declare function SelectEmployeesPresentation({ employees, selectedUuids, searchValue, onSelect, onSelectAll, onSearchChange, onSearchClear, onBack, onContinue, isHolidayPolicy, balances, onBalanceChange, pagination, isFetching, isPending, }: SelectEmployeesPresentationProps): import("react").JSX.Element;
+export declare function SelectEmployeesPresentation({ employees, selectedUuids, searchValue, onSelect, onSelectAll, onSearchChange, onSearchClear, onBack, onContinue, isHolidayPolicy, balances, onBalanceChange, pagination, isFetching, isPending, className, }: SelectEmployeesPresentationProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/TimeOffManagement/SelectEmployees/SelectEmployeesPresentationTypes.d.ts

@@ -28,4 +28,6 @@ export interface SelectEmployeesPresentationProps {
     isFetching?: boolean;
     /** Disables the back button and shows a spinner on the continue button while a submit is in flight. */
     isPending?: boolean;
+    /** CSS class name applied to the root element. */
+    className?: string;
 }

package/dist/{components → src/components}/TimeOff/TimeOffManagement/SelectEmployees/SelectEmployeesTimeOff.d.ts

@@ -4,6 +4,8 @@ interface SelectEmployeesTimeOffProps {
     policyId: string;
     policyType: CreatableTimeOffPolicyType;
     mode?: 'standalone' | 'wizard';
+    /** CSS class name applied to the root element. */
+    className?: string;
 }
 /** @internal */
 export declare function SelectEmployeesTimeOff(props: SelectEmployeesTimeOffProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/TimeOffPolicyDetail/TimeOffPolicyDetailPresentation.d.ts

@@ -13,4 +13,4 @@ import { TimeOffPolicyDetailPresentationProps } from './TimeOffPolicyDetailTypes
  * @returns The rendered detail view.
  * @public
  */
-export declare function TimeOffPolicyDetailPresentation({ title, subtitle, onBack, backLabel, actions, policyDetails, policySettings, onChangeSettings, selectedTabId, onTabChange, employees, onAddEmployee, removeDialog, successAlert, onDismissAlert, }: TimeOffPolicyDetailPresentationProps): import("react").JSX.Element;
+export declare function TimeOffPolicyDetailPresentation({ title, subtitle, onBack, backLabel, actions, policyDetails, policySettings, onChangeSettings, selectedTabId, onTabChange, employees, onAddEmployee, removeDialog, successAlert, onDismissAlert, className, }: TimeOffPolicyDetailPresentationProps): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/TimeOffPolicyDetail/TimeOffPolicyDetailTypes.d.ts

@@ -104,6 +104,8 @@ export interface TimeOffPolicyDetailPresentationBaseProps {
     successAlert?: string;
     /** Called when the success alert is dismissed. */
     onDismissAlert?: () => void;
+    /** CSS class name applied to the root element. */
+    className?: string;
 }
 /**
  * Props for {@link TimeOffPolicyDetailPresentation}.
@@ -130,6 +132,7 @@ export interface TimeOffPolicyDetailPresentationBaseProps {
  * | `removeDialog` | State for the employee removal confirmation dialog. |
  * | `successAlert` | Optional success message rendered as a dismissible alert. |
  * | `onDismissAlert` | Called when the success alert is dismissed. |
+ * | `className` | CSS class name applied to the root element. |
  *
  * @public
  */

package/dist/{components → src/components}/TimeOff/shared/PolicyDetailLayout/PolicyDetailLayout.d.ts

@@ -1,4 +1,4 @@
 import { EmployeeTableItem } from '../EmployeeTable/EmployeeTableTypes';
 import { PolicyDetailLayoutProps } from './PolicyDetailLayoutTypes';
 /** @internal */
-export declare function PolicyDetailLayout<T extends EmployeeTableItem>({ title, subtitle, onBack, backLabel, actions, firstTab, selectedTabId, onTabChange, employees, onAddEmployee, removeDialog, successAlert, onDismissAlert, }: PolicyDetailLayoutProps<T>): import("react").JSX.Element;
+export declare function PolicyDetailLayout<T extends EmployeeTableItem>({ title, subtitle, onBack, backLabel, actions, firstTab, selectedTabId, onTabChange, employees, onAddEmployee, removeDialog, successAlert, onDismissAlert, className, }: PolicyDetailLayoutProps<T>): import("react").JSX.Element;

package/dist/{components → src/components}/TimeOff/shared/PolicyDetailLayout/PolicyDetailLayoutTypes.d.ts

@@ -53,4 +53,6 @@ export interface PolicyDetailLayoutProps<T extends EmployeeTableItem> {
     successAlert?: string;
     /** Called when the success alert is dismissed. */
     onDismissAlert?: () => void;
+    /** CSS class name applied to the root element. */
+    className?: string;
 }

package/dist/{contexts → src/contexts}/ApiProvider/apiVersion.d.ts

@@ -10,6 +10,17 @@
  * @internal
  */
 export declare const API_VERSION = "2026-06-15";
+/**
+ * SDK package name and version, sent on every request via the `X-Gusto-SDK-Version`
+ * header so backend traffic can be attributed to a specific SDK release.
+ *
+ * @remarks
+ * Read directly from `package.json` so it always matches the published package —
+ * no manual bump required.
+ *
+ * @internal
+ */
+export declare const SDK_VERSION: string;
 /**
  * TanStack Query namespace the embedded-api client prefixes onto every generated
  * query and mutation key (segment 1 of every key it emits).

package/dist/{contexts → src/contexts}/ComponentAdapter/componentAdapterTypes.d.ts

@@ -28,6 +28,7 @@ export type { BaseListProps, OrderedListProps, UnorderedListProps, } from '../..
 export type { HeadingProps } from '../../components/Common/UI/Heading/HeadingTypes';
 export type { PaginationControlProps, PaginationItemsPerPage, } from '../../components/Common/PaginationControl/PaginationControlTypes';
 export type { PayrollLoadingProps } from '../../components/Common/PayrollLoading/PayrollLoadingTypes';
+export type { FieldCaptionProps } from '../../components/Common/FieldCaption/FieldCaptionTypes';
 export type { TextProps } from '../../components/Common/UI/Text/TextTypes';
 export type { CalendarPreviewProps } from '../../components/Common/UI/CalendarPreview/CalendarPreviewTypes';
 export type { DialogProps } from '../../components/Common/UI/Dialog/DialogTypes';

package/dist/{contexts → src/contexts}/ComponentAdapter/useComponentContext.d.ts

@@ -38,6 +38,7 @@ import { BoxHeaderProps } from '../../components/Common/UI/BoxHeader/BoxHeaderTy
 import { FormBoxHeaderProps } from '../../components/Common/UI/FormBoxHeader/FormBoxHeaderTypes';
 import { MultiSelectComboBoxProps } from '../../components/Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes';
 import { PayrollLoadingProps } from '../../components/Common/PayrollLoading/PayrollLoadingTypes';
+import { FieldCaptionProps } from '../../components/Common/FieldCaption/FieldCaptionTypes';
 /**
  * Full map of UI components used by the SDK. Every property is a React component that the
  * SDK renders internally — override any of them to substitute your own design system.
@@ -47,7 +48,7 @@ import { PayrollLoadingProps } from '../../components/Common/PayrollLoading/Payr
  *
  * To take full control of every UI component (and eliminate the React Aria dependency),
  * pass a complete {@link ComponentsContextType} to {@link GustoProviderCustomUIAdapter} instead.
- * All properties are then required except `PaginationControl` and `PayrollLoading`,
+ * All properties are then required except `PaginationControl`, `PayrollLoading`, and `FieldCaption`,
  * which fall back to built-in SDK implementations when omitted.
  *
  * @public
@@ -173,6 +174,8 @@ export interface ComponentsContextType {
     TextArea: FunctionComponent<TextAreaProps>;
     /** HTML `<ul>` for an unordered list of items. */
     UnorderedList: FunctionComponent<UnorderedListProps>;
+    /** Label or legend caption for form controls, including the optional/required indicator. Defaults to the SDK's built-in caption UI when omitted. */
+    FieldCaption?: FunctionComponent<FieldCaptionProps>;
     /** Pagination controls for list views. Defaults to the SDK's built-in pagination UI when omitted. */
     PaginationControl?: FunctionComponent<PaginationControlProps>;
     /** Loading indicator for payroll calculation. Defaults to the SDK's built-in loading state when omitted. */

package/dist/{contexts → src/contexts}/UnstableFeaturesProvider/useUnstableFeature.d.ts

@@ -14,7 +14,10 @@
 export interface UnstableFeatures {
     /** Enables recording past payments to contractors within the `ContractorManagement` flows. */
     historicalPayments?: boolean;
-    /** Enables the in-development regular-rate-of-pay experience for editing an employee's payroll. */
+    /**
+     * Enables the in-development regular-rate-of-pay experience: the payroll editing flow, and the
+     * workweek start day field on `PaySchedule` that RRoP's overtime calculations depend on.
+     */
     payrollRegularRateOfPay?: boolean;
 }
 /**

package/dist/{helpers → src/helpers}/dateFormatting.d.ts

@@ -153,6 +153,15 @@ export declare const getDaysUntil: (deadline?: Date | string | null) => number |
  * @internal
  */
 export declare const addDays: (date: Date, days: number) => Date;
+/**
+ * Returns a new `Date` offset by a given number of years.
+ *
+ * @param date - The base date. Not mutated.
+ * @param years - Number of years to add (negative values subtract).
+ * @returns A new `Date` shifted by `years`.
+ * @internal
+ */
+export declare const addYears: (date: Date, years: number) => Date;
 /**
  * Returns a new `Date` offset by a given number of business days (Monday–Friday).
  *

package/dist/{helpers → src/helpers}/formattedStrings.d.ts

@@ -2,18 +2,19 @@ import { Location } from '@gusto/embedded-api/models/components/location';
 import { EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress';
 import { TFunction } from 'i18next';
 /**
- * Joins a first and last name into a single capitalized display string.
+ * Joins a first, middle initial, and last name into a single capitalized display string.
  *
  * @remarks Each name part is capitalized at its first character. A space is
- * inserted between the parts only when the last name is present. Missing
- * parts are treated as empty.
+ * inserted before the middle initial and last name only when that part is
+ * present. Missing parts are treated as empty.
  *
- * @param name - Object with optional `first_name` and `last_name` fields.
- * @returns The combined name, e.g. `Jane Doe`, `Jane`, or `''`.
+ * @param name - Object with optional `first_name`, `middle_initial`, and `last_name` fields.
+ * @returns The combined name, e.g. `Jane M Doe`, `Jane Doe`, `Jane`, or `''`.
  * @internal
  */
-export declare const firstLastName: ({ first_name, last_name, }: {
+export declare const firstLastName: ({ first_name, middle_initial, last_name, }: {
     first_name?: string | null;
+    middle_initial?: string | null;
     last_name?: string | null;
 }) => string;
 /**