@gusto/embedded-react-sdk 0.56.0 → 0.56.2

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

@@ -28,4 +28,4 @@ export interface PayrollHistoryProps extends BaseComponentInterface<'Payroll.Pay
  * @returns The rendered payroll history view.
  * @public
  */
-export declare function PayrollHistory(props: PayrollHistoryProps): import("react").JSX.Element;
+export declare function PayrollHistory(props: PayrollHistoryProps): import('react').JSX.Element;

package/dist/src/components/Payroll/PayrollHistory/PayrollHistoryPresentation.d.ts

@@ -18,5 +18,5 @@ interface PayrollHistoryPresentationProps {
     dateRangeFilter: UseDateRangeFilterResult;
 }
 /** @internal */
-export declare const PayrollHistoryPresentation: ({ className, 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/src/components/Payroll/PayrollLanding/PayrollLanding.d.ts

@@ -50,4 +50,4 @@ export interface PayrollLandingProps extends BaseComponentInterface<'Payroll.Pay
  * @returns The payroll landing flow.
  * @public
  */
-export declare function PayrollLanding(props: PayrollLandingProps): import("react").JSX.Element;
+export declare function PayrollLanding(props: PayrollLandingProps): import('react').JSX.Element;

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

@@ -40,8 +40,8 @@ export interface PayrollLandingFlowContextInterface extends FlowContextInterface
     showPayrollCancelledAlert?: boolean;
 }
 /** @internal */
-export declare function PayrollLandingTabsContextual(): import("react").JSX.Element;
+export declare function PayrollLandingTabsContextual(): import('react').JSX.Element;
 /** @internal */
-export declare function PayrollLandingReceiptsContextual(): import("react").JSX.Element;
+export declare function PayrollLandingReceiptsContextual(): import('react').JSX.Element;
 /** @internal */
-export declare function PayrollLandingOverviewContextual(): import("react").JSX.Element;
+export declare function PayrollLandingOverviewContextual(): import('react').JSX.Element;

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

@@ -41,4 +41,4 @@ export interface PayrollListBlockProps extends BaseComponentInterface<never> {
  * @returns The rendered payroll list.
  * @public
  */
-export declare function PayrollList(props: PayrollListBlockProps): import("react").JSX.Element;
+export declare function PayrollList(props: PayrollListBlockProps): import('react').JSX.Element;

package/dist/src/components/Payroll/PayrollList/PayrollListPresentation.d.ts

@@ -28,5 +28,5 @@ interface PayrollListPresentationProps {
     withOffcyclePayroll?: boolean;
 }
 /** @internal */
-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 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/src/components/Payroll/PayrollOverview/PayrollOverview.d.ts

@@ -61,4 +61,4 @@ export interface PayrollOverviewProps extends BaseComponentInterface<'Payroll.Pa
  * @returns The payroll overview surface.
  * @public
  */
-export declare function PayrollOverview(props: PayrollOverviewProps): import("react").JSX.Element;
+export declare function PayrollOverview(props: PayrollOverviewProps): import('react').JSX.Element;

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

@@ -35,5 +35,5 @@ interface PayrollOverviewProps {
     downloadingEmployeeIds?: ReadonlySet<string>;
 }
 /** @internal */
-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 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/src/components/Payroll/PayrollOverview/SubmissionBlockers/FastAchSubmissionBlockerBanner.d.ts

@@ -7,5 +7,5 @@ interface FastAchSubmissionBlockerBannerProps {
     paymentSpeed?: PaymentSpeed;
 }
 /** @internal */
-export declare const FastAchSubmissionBlockerBanner: ({ blocker, selectedValue, onUnblockOptionChange, paymentSpeed, }: FastAchSubmissionBlockerBannerProps) => import("react").JSX.Element;
+export declare const FastAchSubmissionBlockerBanner: ({ blocker, selectedValue, onUnblockOptionChange, paymentSpeed, }: FastAchSubmissionBlockerBannerProps) => import('react').JSX.Element;
 export {};

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

@@ -3,5 +3,5 @@ interface GenericBlockerProps {
     blocker: PayrollSubmissionBlockerType;
 }
 /** @internal */
-export declare const GenericBlocker: ({ blocker }: GenericBlockerProps) => import("react").JSX.Element;
+export declare const GenericBlocker: ({ blocker }: GenericBlockerProps) => import('react').JSX.Element;
 export {};

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

@@ -28,4 +28,4 @@ export interface PayrollReceiptsProps extends BaseComponentInterface<'Payroll.Pa
  * }
  * ```
  */
-export declare function PayrollReceipts(props: PayrollReceiptsProps): import("react").JSX.Element;
+export declare function PayrollReceipts(props: PayrollReceiptsProps): import('react').JSX.Element;

package/dist/src/components/Payroll/PayrollReceipts/PayrollReceiptsPresentation.d.ts

@@ -5,5 +5,5 @@ interface PayrollReceiptsPresentationProps {
     withReimbursements?: boolean;
 }
 /** @internal */
-export declare const PayrollReceiptsPresentation: ({ className, 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/PayrollStatusBadges/PayrollStatusBadges.d.ts

@@ -4,5 +4,5 @@ interface PayrollStatusBadgesProps {
     wireInRequest?: WireInRequestInput;
 }
 /** @internal */
-export declare const PayrollStatusBadges: ({ payroll, wireInRequest }: PayrollStatusBadgesProps) => import("react").JSX.Element;
+export declare const PayrollStatusBadges: ({ payroll, wireInRequest }: PayrollStatusBadgesProps) => import('react').JSX.Element;
 export {};

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

@@ -18,4 +18,4 @@ import { PrintChecksProps } from './types';
  * @returns The print-checks banner and modal flow.
  * @public
  */
-export declare function PrintChecks({ onEvent, ...props }: PrintChecksProps): import("react").JSX.Element;
+export declare function PrintChecks({ onEvent, ...props }: PrintChecksProps): import('react').JSX.Element;

package/dist/src/components/Payroll/PrintChecks/PrintChecksBanner/PrintChecksBanner.d.ts

@@ -5,5 +5,5 @@ interface PrintChecksBannerProps extends BaseComponentInterface<'Payroll.PrintCh
     onStartPrintChecks: () => void;
 }
 /** @internal */
-export declare function PrintChecksBanner(props: PrintChecksBannerProps): import("react").JSX.Element;
+export declare function PrintChecksBanner(props: PrintChecksBannerProps): import('react').JSX.Element;
 export {};

package/dist/src/components/Payroll/PrintChecks/PrintChecksComponents.d.ts

@@ -26,21 +26,21 @@ export interface PrintChecksContextInterface extends FlowContextInterface {
     }) | null;
 }
 /** @internal */
-export declare function PrintChecksFormContextual(): import("react").JSX.Element;
+export declare function PrintChecksFormContextual(): import('react').JSX.Element;
 export declare namespace PrintChecksFormContextual {
     var Footer: ({ onEvent }: {
         onEvent: OnEventType<EventType, unknown>;
     }) => import("react").JSX.Element;
 }
 /** @internal */
-export declare function PrintChecksFailureContextual(): import("react").JSX.Element;
+export declare function PrintChecksFailureContextual(): import('react').JSX.Element;
 export declare namespace PrintChecksFailureContextual {
     var Footer: ({ onEvent }: {
         onEvent: OnEventType<EventType, unknown>;
     }) => import("react").JSX.Element;
 }
 /** @internal */
-export declare function PrintChecksSummaryContextual(): import("react").JSX.Element;
+export declare function PrintChecksSummaryContextual(): import('react').JSX.Element;
 export declare namespace PrintChecksSummaryContextual {
     var Footer: ({ onEvent }: {
         onEvent: OnEventType<EventType, unknown>;

package/dist/src/components/Payroll/PrintChecks/PrintChecksFailure/PrintChecksFailure.d.ts

@@ -5,7 +5,7 @@ interface PrintChecksFailureProps extends BaseComponentInterface<'Payroll.PrintC
     errorMessage?: string;
 }
 /** @internal */
-export declare function PrintChecksFailure(props: PrintChecksFailureProps): import("react").JSX.Element;
+export declare function PrintChecksFailure(props: PrintChecksFailureProps): import('react').JSX.Element;
 export declare namespace PrintChecksFailure {
     var Footer: ({ onEvent }: {
         onEvent: OnEventType<EventType, unknown>;

package/dist/src/components/Payroll/PrintChecks/PrintChecksForm/PrintChecksForm.d.ts

@@ -7,7 +7,7 @@ interface PrintChecksFormProps extends BaseComponentInterface<'Payroll.PrintChec
     isGenerating?: boolean;
 }
 /** @internal */
-export declare function PrintChecksForm(props: PrintChecksFormProps): import("react").JSX.Element;
+export declare function PrintChecksForm(props: PrintChecksFormProps): import('react').JSX.Element;
 export declare namespace PrintChecksForm {
     var Footer: ({ onEvent }: {
         onEvent: OnEventType<EventType, unknown>;

package/dist/src/components/Payroll/PrintChecks/PrintChecksSummary/PrintChecksSummary.d.ts

@@ -5,7 +5,7 @@ interface PrintChecksSummaryProps extends BaseComponentInterface<'Payroll.PrintC
     documentUrl?: string;
 }
 /** @internal */
-export declare function PrintChecksSummary(props: PrintChecksSummaryProps): import("react").JSX.Element;
+export declare function PrintChecksSummary(props: PrintChecksSummaryProps): import('react').JSX.Element;
 export declare namespace PrintChecksSummary {
     var Footer: ({ onEvent }: {
         onEvent: OnEventType<EventType, unknown>;

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

@@ -31,4 +31,4 @@ export interface RecoveryCasesProps extends Omit<BaseComponentInterface<never>,
  * @returns The recovery cases list with an embedded resubmit modal.
  * @public
  */
-export declare function RecoveryCases({ onEvent, ...props }: RecoveryCasesProps): import("react").JSX.Element;
+export declare function RecoveryCases({ onEvent, ...props }: RecoveryCasesProps): import('react').JSX.Element;

package/dist/src/components/Payroll/RecoveryCases/RecoveryCasesComponents.d.ts

@@ -16,7 +16,7 @@ export interface RecoveryCasesContextInterface extends FlowContextInterface {
     }) | null;
 }
 /** @internal */
-export declare function RecoveryCasesResubmitContextual(): import("react").JSX.Element;
+export declare function RecoveryCasesResubmitContextual(): import('react').JSX.Element;
 export declare namespace RecoveryCasesResubmitContextual {
     var Footer: ({ onEvent }: {
         onEvent: OnEventType<EventType, unknown>;

package/dist/src/components/Payroll/RecoveryCases/RecoveryCasesList/RecoveryCasesList.d.ts

@@ -3,5 +3,5 @@ interface RecoveryCasesListProps extends BaseComponentInterface<'Payroll.Recover
     companyId: string;
 }
 /** @internal */
-export declare function RecoveryCasesList(props: RecoveryCasesListProps): import("react").JSX.Element;
+export declare function RecoveryCasesList(props: RecoveryCasesListProps): import('react').JSX.Element;
 export {};

package/dist/src/components/Payroll/RecoveryCases/RecoveryCasesResubmit/RecoveryCasesResubmit.d.ts

@@ -5,7 +5,7 @@ interface RecoveryCasesResubmitProps extends BaseComponentInterface<'Payroll.Rec
     recoveryCaseId: string;
 }
 /** @internal */
-export declare function RecoveryCasesResubmit(props: RecoveryCasesResubmitProps): import("react").JSX.Element;
+export declare function RecoveryCasesResubmit(props: RecoveryCasesResubmitProps): import('react').JSX.Element;
 export declare namespace RecoveryCasesResubmit {
     var Footer: ({ onEvent }: {
         onEvent: OnEventType<EventType, unknown>;

package/dist/src/components/Payroll/Transition/TransitionFlow.d.ts

@@ -1,29 +1,31 @@
 import { TransitionFlowProps } from './TransitionFlowComponents';
 /**
- * Guided flow to run a transition payroll when employees move from one pay schedule to another.
+ * Macro flow that runs a transition payroll end to end: resolve or create the payroll, then
+ * configure, review, submit, and view receipts.
  *
  * @remarks
- * When employees switch from an old pay schedule to a new one, the change can leave a gap between
- * the last pay period on the old schedule and the first on the new one. A transition payroll covers
- * the wages earned during that gap.
+ * Renders {@link TransitionPayroll} as its entry step, then routes the events its configuration
+ * screen emits into the shared payroll-execution states (overview, edit-employee, receipts,
+ * blockers). It owns the breadcrumb chrome and back-navigation, and re-runs the same cached resolve
+ * lookup to seed its initial breadcrumb and payroll context.
  *
- * Starts on the creation step (configure check date, deductions, and tax withholding for the
- * transition pay period). After the payroll is created, the flow hands off to the standard
- * payroll execution experience — configure compensation, review, submit, and view receipts.
- *
- * If a `payrollUuid` is supplied, the flow skips creation and resumes directly in execution.
+ * There is no terminal state (SDK-1169). Completion events bubble via `onEvent` for the parent to
+ * handle (in `Payroll.PayrollFlow` the parent machine does).
  *
  * @events
  * | Event | Description | Data |
  * | ----- | ----------- | ---- |
- * | `breadcrumb/navigate` | Fired when the user navigates back to the creation step via breadcrumbs | `{ key: string }` |
- * | `transition/created` | Fired when the transition payroll is created and the flow advances to execution | `{ payrollUuid: string }` |
+ * | `transition/created` | Fired when the transition payroll is created and the flow advances to configuration | `{ payrollUuid: string }` |
+ * | `breadcrumb/navigate` | Fired when the user navigates via the breadcrumb header | `{ key: string }` |
  *
- * Once execution begins, all standard run-payroll events are emitted as well.
+ * All standard run-payroll events are emitted once configuration begins.
  *
  * @components
- * - {@link TransitionCreation}
- * - {@link PayrollExecutionFlow}
+ * - {@link TransitionPayroll}
+ * - {@link PayrollOverview}
+ * - {@link PayrollEditEmployee}
+ * - {@link PayrollReceipts}
+ * - {@link PayrollBlockerList}
  *
  * @param props - See {@link TransitionFlowProps}.
  * @returns The transition payroll flow.
@@ -50,4 +52,4 @@ import { TransitionFlowProps } from './TransitionFlowComponents';
  * }
  * ```
  */
-export declare function TransitionFlow({ companyId, startDate, endDate, payScheduleUuid, payrollUuid, onEvent, }: TransitionFlowProps): import("react").JSX.Element;
+export declare function TransitionFlow(props: TransitionFlowProps): import('react').JSX.Element;

package/dist/src/components/Payroll/Transition/TransitionFlowComponents.d.ts

@@ -1,22 +1,23 @@
-import { FlowContextInterface } from '../../Flow/useFlow';
+import { PayrollFlowContextInterface } from '../PayrollFlow/PayrollFlowComponents';
 import { OnEventType } from '../../Base/useBase';
 import { EventType } from '../../../shared/constants';
 /**
- * Flow context shape carried through the transition payroll state machine.
+ * Flow context shape carried through the transition payroll macro state machine.
+ *
+ * @remarks
+ * Extends {@link PayrollFlowContextInterface} so the payroll-execution reducers reused by the
+ * transition machine (overview, edit-employee, receipts, blockers) typecheck against a single
+ * shared context shape.
  *
  * @internal
  */
-export interface TransitionFlowContextInterface extends FlowContextInterface {
-    /** Company the transition payroll belongs to. */
-    companyId: string;
+export interface TransitionFlowContextInterface extends PayrollFlowContextInterface {
     /** Start date of the transition pay period (YYYY-MM-DD). */
     startDate: string;
     /** End date of the transition pay period (YYYY-MM-DD). */
     endDate: string;
     /** UUID of the pay schedule the transition is associated with. */
     payScheduleUuid: string;
-    /** UUID of the created transition payroll, populated once creation completes. */
-    payrollUuid?: string;
 }
 /**
  * Props for {@link TransitionFlow}.
@@ -32,12 +33,20 @@ export interface TransitionFlowProps {
     endDate: string;
     /** UUID of the pay schedule the transition is associated with. */
     payScheduleUuid: string;
-    /** UUID of an existing transition payroll. When provided, the flow skips creation and resumes in execution. */
+    /**
+     * UUID of an existing transition payroll. When provided, the flow skips the lookup and starts on
+     * configuration for this payroll. When omitted, it resolves the payroll for the pay period.
+     */
     payrollUuid?: string;
+    /** Whether reimbursement fields are shown throughout the flow. Defaults to `true`. */
+    withReimbursements?: boolean;
     /** Callback invoked for each event emitted by the flow and its child steps. */
     onEvent: OnEventType<EventType, unknown>;
 }
-/** @internal */
-export declare function TransitionCreationContextual(): import("react").JSX.Element;
-/** @internal */
-export declare function TransitionExecutionContextual(): import("react").JSX.Element;
+/**
+ * Renders {@link TransitionPayroll} as the entry step of {@link TransitionFlow}, wiring its events
+ * up to the flow's state machine.
+ *
+ * @internal
+ */
+export declare function TransitionPayrollContextual(): import('react').JSX.Element;

package/dist/src/components/Payroll/Transition/transitionStateMachine.d.ts

@@ -1,8 +1,29 @@
 import { BreadcrumbNodes } from '../../Common/FlowBreadcrumbs/FlowBreadcrumbsTypes';
-/** @internal */
+/**
+ * Breadcrumb nodes for the transition payroll macro flow: the creation crumb merged with the
+ * shared payroll-execution crumbs. `configuration` is nested under the creation crumb so the
+ * "Transition Payroll" crumb persists in the trail once the flow advances past creation, matching
+ * the display-only prefix the flow rendered before this refactor.
+ *
+ * @internal
+ */
 export declare const transitionBreadcrumbsNodes: BreadcrumbNodes;
-/** @internal */
+/**
+ * Macro state machine for {@link TransitionFlow}.
+ *
+ * @remarks
+ * The entry state renders {@link TransitionPayroll}; the rest of the states are the shared
+ * {@link payrollExecutionMachine} states, reused via object spread. The entry state reuses that
+ * machine's onward transitions so configuration events route into overview / edit-employee /
+ * blockers.
+ *
+ * @internal
+ */
 export declare const transitionMachine: {
-    createTransitionPayroll: import('robot3').MachineState<any>;
-    execution: import('robot3').MachineState<any>;
+    configuration: import('robot3').MachineState<any>;
+    overview: import('robot3').MachineState<any>;
+    editEmployee: import('robot3').MachineState<any>;
+    receipts: import('robot3').MachineState<any>;
+    blockers: import('robot3').MachineState<any>;
+    transitionPayroll: import('robot3').MachineState<any>;
 };

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

@@ -19,4 +19,4 @@ import { TransitionCreationProps } from './TransitionCreationTypes';
  * @returns The transition payroll creation form.
  * @public
  */
-export declare function TransitionCreation(props: TransitionCreationProps): import("react").JSX.Element;
+export declare function TransitionCreation(props: TransitionCreationProps): import('react').JSX.Element;

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

@@ -6,4 +6,4 @@ import { TransitionCreationPresentationProps } from './TransitionCreationTypes';
  * @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;
+export declare function TransitionCreationPresentation({ className, startDate, endDate, payScheduleName, isPending, taxWithholdingConfig, isTaxWithholdingModalOpen, onTaxWithholdingEditClick, onTaxWithholdingModalDone, onTaxWithholdingModalCancel, }: TransitionCreationPresentationProps): import('react').JSX.Element;

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

@@ -0,0 +1,55 @@
+import { TransitionPayrollProps } from './TransitionPayrollTypes';
+/**
+ * Resolves and runs a transition payroll for a pay-schedule change, picking up an existing
+ * unprocessed transition payroll when one exists and creating one otherwise.
+ *
+ * @remarks
+ * A transition payroll covers the gap that opens when a company changes its pay schedule. This
+ * component looks up whether one already exists for the pay period and picks the starting screen:
+ *
+ * - If it exists, it starts on {@link PayrollConfiguration} for that payroll.
+ * - Otherwise it starts on {@link TransitionCreation}, then advances to {@link PayrollConfiguration}
+ *   once the payroll is created.
+ *
+ * Configuration events (calculate, employee edit, blockers, etc.) are emitted through `onEvent` for
+ * the host to route. Compose it inside {@link TransitionFlow} for the full run-payroll experience,
+ * or handle the events yourself.
+ *
+ * @events
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `transition/created` | The transition payroll has been created and the flow advances to configuration | `{ payrollUuid: string }` |
+ *
+ * Once configuration begins, all standard run-payroll events are emitted as well (e.g.
+ * `runPayroll/calculated`, `runPayroll/employee/edit`, `runPayroll/blockers/viewAll`).
+ *
+ * @components
+ * - {@link TransitionCreation}
+ * - {@link PayrollConfiguration}
+ *
+ * @param props - See {@link TransitionPayrollProps}.
+ * @returns The transition payroll component.
+ * @public
+ *
+ * @example
+ * ```tsx title="App.tsx"
+ * import { Payroll, type EventType } from '@gusto/embedded-react-sdk'
+ *
+ * function MyApp() {
+ *   return (
+ *     <Payroll.TransitionPayroll
+ *       companyId="a007e1ab-3595-43c2-ab4b-af7a5af2e365"
+ *       startDate="2025-01-16"
+ *       endDate="2025-01-31"
+ *       payScheduleUuid="c75c1ef6-2ec0-4cca-94a5-8b4cf7e5ea21"
+ *       onEvent={(eventType: EventType) => {
+ *         if (eventType === 'runPayroll/calculated') {
+ *           // Payroll calculated — navigate to your review screen
+ *         }
+ *       }}
+ *     />
+ *   )
+ * }
+ * ```
+ */
+export declare function TransitionPayroll(props: TransitionPayrollProps): import('react').JSX.Element;

package/dist/src/components/Payroll/TransitionPayroll/TransitionPayrollComponents.d.ts

@@ -0,0 +1,24 @@
+import { FlowContextInterface } from '../../Flow/useFlow';
+/**
+ * Flow context shape carried through the {@link TransitionPayroll} state machine.
+ *
+ * @internal
+ */
+export interface TransitionPayrollContextInterface extends FlowContextInterface {
+    /** Company the transition payroll belongs to. */
+    companyId: string;
+    /** Start date of the transition pay period (YYYY-MM-DD). */
+    startDate: string;
+    /** End date of the transition pay period (YYYY-MM-DD). */
+    endDate: string;
+    /** UUID of the pay schedule the transition is associated with. */
+    payScheduleUuid: string;
+    /** UUID of the transition payroll once it has been resolved or created. */
+    payrollUuid?: string;
+    /** Whether reimbursement fields are shown on the configuration screen. Defaults to `true`. */
+    withReimbursements?: boolean;
+}
+/** @internal */
+export declare function TransitionCreationContextual(): import('react').JSX.Element;
+/** @internal */
+export declare function PayrollConfigurationContextual(): import('react').JSX.Element;

package/dist/src/components/Payroll/TransitionPayroll/TransitionPayrollTypes.d.ts

@@ -0,0 +1,23 @@
+import { BaseComponentInterface } from '../../Base/Base';
+/**
+ * Props for {@link TransitionPayroll}.
+ *
+ * @public
+ */
+export interface TransitionPayrollProps extends BaseComponentInterface {
+    /** The company running the transition payroll. */
+    companyId: 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). */
+    endDate: string;
+    /** The UUID of the pay schedule the transition is associated with. */
+    payScheduleUuid: string;
+    /**
+     * UUID of an existing transition payroll. When provided, the component skips the lookup and starts
+     * on configuration for this payroll. When omitted, it resolves the payroll for the pay period.
+     */
+    payrollUuid?: string;
+    /** Whether reimbursement fields are shown on the configuration screen. Defaults to `true`. */
+    withReimbursements?: boolean;
+}

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

@@ -0,0 +1,2 @@
+export { TransitionPayroll } from './TransitionPayroll';
+export type { TransitionPayrollProps } from './TransitionPayrollTypes';

package/dist/src/components/Payroll/TransitionPayroll/transitionPayrollStateMachine.d.ts

@@ -0,0 +1,15 @@
+/**
+ * State machine for {@link TransitionPayroll}.
+ *
+ * @remarks
+ * `creation` shows {@link TransitionCreation}; `configuration` shows {@link PayrollConfiguration}.
+ * The component freezes the initial state from the resolve lookup. `configuration` has no outgoing
+ * transitions (a plain zero-transition state, not a robot3 final state per SDK-1169) so its events
+ * bubble via `onEvent` and the screen keeps working if the host stays mounted past completion.
+ *
+ * @internal
+ */
+export declare const transitionPayrollMachine: {
+    creation: import('robot3').MachineState<any>;
+    configuration: import('robot3').MachineState<any>;
+};

package/dist/src/components/Payroll/TransitionPayroll/useResolveTransitionPayroll.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Arguments describing the transition pay period to resolve.
+ *
+ * @internal
+ */
+export interface ResolveTransitionPayrollArgs {
+    companyId: string;
+    startDate: string;
+    endDate: string;
+    payScheduleUuid: string;
+}
+/**
+ * Looks up an existing unprocessed transition payroll for the given pay period.
+ *
+ * @remarks
+ * A transition payroll is an unprocessed off-cycle payroll whose `offCycleReason` is
+ * `"Transition from old pay schedule"` and whose pay period matches the supplied
+ * `startDate`, `endDate`, and `payScheduleUuid`. When the company changed its pay schedule
+ * the platform creates exactly one such payroll for the coverage gap; this hook finds it so
+ * the caller can resume it instead of creating a duplicate.
+ *
+ * Backed by a suspense query, so callers must render it under a suspense boundary.
+ *
+ * @param args - The pay period to match. See {@link ResolveTransitionPayrollArgs}.
+ * @returns The matching payroll's UUID, or `undefined` when none exists yet.
+ * @internal
+ */
+export declare function useResolveTransitionPayroll({ companyId, startDate, endDate, payScheduleUuid, }: ResolveTransitionPayrollArgs): string | undefined;

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

@@ -7,5 +7,5 @@ interface TransitionPayrollAlertProps {
     LoaderComponent?: LoaderComponentType;
 }
 /** @internal */
-export declare function TransitionPayrollAlert({ companyId, onEvent, LoaderComponent, }: TransitionPayrollAlertProps): import("react").JSX.Element;
+export declare function TransitionPayrollAlert({ companyId, onEvent, LoaderComponent, }: TransitionPayrollAlertProps): import('react').JSX.Element;
 export {};

package/dist/src/components/Payroll/TransitionPayrollAlert/TransitionPayrollAlertPresentation.d.ts

@@ -17,5 +17,5 @@ interface TransitionPayrollAlertPresentationProps {
     skippingPayPeriod: PayPeriod | null;
 }
 /** @internal */
-export declare function TransitionPayrollAlertPresentation({ groupedPayPeriods, onRunPayroll, onSkipPayroll, showSkipSuccessAlert, onDismissSkipSuccessAlert, skippingPayPeriod, }: TransitionPayrollAlertPresentationProps): import("react").JSX.Element | null;
+export declare function TransitionPayrollAlertPresentation({ groupedPayPeriods, onRunPayroll, onSkipPayroll, showSkipSuccessAlert, onDismissSkipSuccessAlert, skippingPayPeriod, }: TransitionPayrollAlertPresentationProps): import('react').JSX.Element | null;
 export {};

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

@@ -17,4 +17,4 @@ import { PayrollEditEmployeeProps } from '../PayrollEditEmployee/PayrollEditEmpl
  *
  * @internal
  */
-export declare function UNSTABLE_PayrollEditEmployee({ FallbackComponent, LoaderComponent, ...props }: PayrollEditEmployeeProps): import("react").JSX.Element;
+export declare function UNSTABLE_PayrollEditEmployee({ FallbackComponent, LoaderComponent, ...props }: PayrollEditEmployeeProps): import('react').JSX.Element;

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

@@ -40,3 +40,5 @@ export { TransitionFlow } from './Transition';
 export type { TransitionFlowProps } from './Transition';
 export { TransitionCreation } from './TransitionCreation';
 export type { TransitionCreationProps, TransitionCreationFormData } from './TransitionCreation';
+export { TransitionPayroll } from './TransitionPayroll';
+export type { TransitionPayrollProps } from './TransitionPayroll';

package/dist/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({ className, ...props }: AddEmployeesHolidayProps): import("react").JSX.Element;
+export declare function AddEmployeesHoliday({ className, ...props }: AddEmployeesHolidayProps): import('react').JSX.Element;

package/dist/src/components/TimeOff/AddEmployeesToPolicy/AddEmployeesToPolicy.d.ts

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

package/dist/src/components/TimeOff/HolidayPolicyDetail/HolidayPolicyDetail.d.ts

@@ -7,4 +7,4 @@ export interface HolidayPolicyDetailProps extends BaseComponentInterface<'Compan
     defaultTab?: 'holidays' | 'employees';
 }
 /** @internal */
-export declare function HolidayPolicyDetail(props: HolidayPolicyDetailProps): import("react").JSX.Element;
+export declare function HolidayPolicyDetail(props: HolidayPolicyDetailProps): import('react').JSX.Element;

package/dist/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, className, }: 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/src/components/TimeOff/HolidaySelectionForm/HolidaySelectionForm.d.ts

@@ -29,4 +29,4 @@ export interface HolidaySelectionFormProps extends BaseComponentInterface<'Compa
  * @returns The rendered holiday selection form.
  * @public
  */
-export declare function HolidaySelectionForm(props: HolidaySelectionFormProps): import("react").JSX.Element;
+export declare function HolidaySelectionForm(props: HolidaySelectionFormProps): import('react').JSX.Element;

package/dist/src/components/TimeOff/HolidaySelectionForm/HolidaySelectionFormPresentation.d.ts

@@ -1,3 +1,3 @@
 import { HolidaySelectionFormPresentationProps } from './HolidaySelectionFormTypes';
 /** @internal */
-export declare function HolidaySelectionFormPresentation(props: HolidaySelectionFormPresentationProps): import("react").JSX.Element;
+export declare function HolidaySelectionFormPresentation(props: HolidaySelectionFormPresentationProps): import('react').JSX.Element;