@gusto/embedded-react-sdk 0.56.0 → 0.56.1

package/dist/components/Payroll/Transition/TransitionFlow.js.map

@@ -1 +1 @@
-{"version":3,"file":"TransitionFlow.js","sources":["../../../../src/components/Payroll/Transition/TransitionFlow.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { createMachine } from 'robot3'\nimport { transitionMachine, transitionBreadcrumbsNodes } from './transitionStateMachine'\nimport {\n  TransitionCreationContextual,\n  TransitionExecutionContextual,\n  type TransitionFlowContextInterface,\n  type TransitionFlowProps,\n} from './TransitionFlowComponents'\nimport { Flow } from '@/components/Flow/Flow'\nimport { buildBreadcrumbs } from '@/helpers/breadcrumbHelpers'\n\n/**\n * Guided flow to run a transition payroll when employees move from one pay schedule to another.\n *\n * @remarks\n * When employees switch from an old pay schedule to a new one, the change can leave a gap between\n * the last pay period on the old schedule and the first on the new one. A transition payroll covers\n * the wages earned during that gap.\n *\n * Starts on the creation step (configure check date, deductions, and tax withholding for the\n * transition pay period). After the payroll is created, the flow hands off to the standard\n * payroll execution experience — configure compensation, review, submit, and view receipts.\n *\n * If a `payrollUuid` is supplied, the flow skips creation and resumes directly in execution.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `breadcrumb/navigate` | Fired when the user navigates back to the creation step via breadcrumbs | `{ key: string }` |\n * | `transition/created` | Fired when the transition payroll is created and the flow advances to execution | `{ payrollUuid: string }` |\n *\n * Once execution begins, all standard run-payroll events are emitted as well.\n *\n * @components\n * - {@link TransitionCreation}\n * - {@link PayrollExecutionFlow}\n *\n * @param props - See {@link TransitionFlowProps}.\n * @returns The transition payroll flow.\n * @public\n *\n * @example\n * ```tsx title=\"App.tsx\"\n * import { Payroll, type EventType } from '@gusto/embedded-react-sdk'\n *\n * function MyApp() {\n *   return (\n *     <Payroll.TransitionFlow\n *       companyId=\"a007e1ab-3595-43c2-ab4b-af7a5af2e365\"\n *       startDate=\"2025-01-16\"\n *       endDate=\"2025-01-31\"\n *       payScheduleUuid=\"c75c1ef6-2ec0-4cca-94a5-8b4cf7e5ea21\"\n *       onEvent={(eventType: EventType) => {\n *         if (eventType === 'runPayroll/submitted') {\n *           // Payroll submitted — navigate to your next screen\n *         }\n *       }}\n *     />\n *   )\n * }\n * ```\n */\nexport function TransitionFlow({\n  companyId,\n  startDate,\n  endDate,\n  payScheduleUuid,\n  payrollUuid,\n  onEvent,\n}: TransitionFlowProps) {\n  const hasExistingPayroll = Boolean(payrollUuid)\n  const initialState = hasExistingPayroll ? 'execution' : 'createTransitionPayroll'\n  const initialComponent = hasExistingPayroll\n    ? TransitionExecutionContextual\n    : TransitionCreationContextual\n\n  const transitionFlowMachine = useMemo(\n    () =>\n      createMachine(\n        initialState,\n        transitionMachine,\n        (initialContext: TransitionFlowContextInterface) => ({\n          ...initialContext,\n          component: initialComponent,\n          companyId,\n          startDate,\n          endDate,\n          payScheduleUuid,\n          payrollUuid,\n          header: {\n            type: 'breadcrumbs' as const,\n            breadcrumbs: buildBreadcrumbs(transitionBreadcrumbsNodes),\n            currentBreadcrumbId: hasExistingPayroll ? undefined : 'createTransitionPayroll',\n          },\n        }),\n      ),\n    [companyId, startDate, endDate, payScheduleUuid, payrollUuid],\n  )\n\n  return <Flow machine={transitionFlowMachine} onEvent={onEvent} />\n}\n"],"names":["TransitionFlow","companyId","startDate","endDate","payScheduleUuid","payrollUuid","onEvent","hasExistingPayroll","initialState","initialComponent","TransitionExecutionContextual","TransitionCreationContextual","transitionFlowMachine","useMemo","createMachine","transitionMachine","initialContext","buildBreadcrumbs","transitionBreadcrumbsNodes","jsx","Flow"],"mappings":";;;;;;;AA+DO,SAASA,EAAe;AAAA,EAC7B,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,SAAAC;AAAA,EACA,iBAAAC;AAAA,EACA,aAAAC;AAAA,EACA,SAAAC;AACF,GAAwB;AACtB,QAAMC,IAAqB,EAAQF,GAC7BG,IAAeD,IAAqB,cAAc,2BAClDE,IAAmBF,IACrBG,IACAC,GAEEC,IAAwBC;AAAA,IAC5B,MACEC;AAAA,MACEN;AAAA,MACAO;AAAA,MACA,CAACC,OAAoD;AAAA,QACnD,GAAGA;AAAA,QACH,WAAWP;AAAA,QACX,WAAAR;AAAA,QACA,WAAAC;AAAA,QACA,SAAAC;AAAA,QACA,iBAAAC;AAAA,QACA,aAAAC;AAAA,QACA,QAAQ;AAAA,UACN,MAAM;AAAA,UACN,aAAaY,EAAiBC,CAA0B;AAAA,UACxD,qBAAqBX,IAAqB,SAAY;AAAA,QAAA;AAAA,MACxD;AAAA,IACF;AAAA,IAEJ,CAACN,GAAWC,GAAWC,GAASC,GAAiBC,CAAW;AAAA,EAAA;AAG9D,SAAO,gBAAAc,EAACC,GAAA,EAAK,SAASR,GAAuB,SAAAN,EAAA,CAAkB;AACjE;"}
+{"version":3,"file":"TransitionFlow.js","sources":["../../../../src/components/Payroll/Transition/TransitionFlow.tsx"],"sourcesContent":["import { useState } from 'react'\nimport { createMachine } from 'robot3'\nimport { useResolveTransitionPayroll } from '../TransitionPayroll/useResolveTransitionPayroll'\nimport { transitionMachine, transitionBreadcrumbsNodes } from './transitionStateMachine'\nimport {\n  TransitionPayrollContextual,\n  type TransitionFlowContextInterface,\n  type TransitionFlowProps,\n} from './TransitionFlowComponents'\nimport { Flow } from '@/components/Flow/Flow'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { buildBreadcrumbs, updateBreadcrumbs } from '@/helpers/breadcrumbHelpers'\n\n/**\n * Macro flow that runs a transition payroll end to end: resolve or create the payroll, then\n * configure, review, submit, and view receipts.\n *\n * @remarks\n * Renders {@link TransitionPayroll} as its entry step, then routes the events its configuration\n * screen emits into the shared payroll-execution states (overview, edit-employee, receipts,\n * blockers). It owns the breadcrumb chrome and back-navigation, and re-runs the same cached resolve\n * lookup to seed its initial breadcrumb and payroll context.\n *\n * There is no terminal state (SDK-1169). Completion events bubble via `onEvent` for the parent to\n * handle (in `Payroll.PayrollFlow` the parent machine does).\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `transition/created` | Fired when the transition payroll is created and the flow advances to configuration | `{ payrollUuid: string }` |\n * | `breadcrumb/navigate` | Fired when the user navigates via the breadcrumb header | `{ key: string }` |\n *\n * All standard run-payroll events are emitted once configuration begins.\n *\n * @components\n * - {@link TransitionPayroll}\n * - {@link PayrollOverview}\n * - {@link PayrollEditEmployee}\n * - {@link PayrollReceipts}\n * - {@link PayrollBlockerList}\n *\n * @param props - See {@link TransitionFlowProps}.\n * @returns The transition payroll flow.\n * @public\n *\n * @example\n * ```tsx title=\"App.tsx\"\n * import { Payroll, type EventType } from '@gusto/embedded-react-sdk'\n *\n * function MyApp() {\n *   return (\n *     <Payroll.TransitionFlow\n *       companyId=\"a007e1ab-3595-43c2-ab4b-af7a5af2e365\"\n *       startDate=\"2025-01-16\"\n *       endDate=\"2025-01-31\"\n *       payScheduleUuid=\"c75c1ef6-2ec0-4cca-94a5-8b4cf7e5ea21\"\n *       onEvent={(eventType: EventType) => {\n *         if (eventType === 'runPayroll/submitted') {\n *           // Payroll submitted — navigate to your next screen\n *         }\n *       }}\n *     />\n *   )\n * }\n * ```\n */\nexport function TransitionFlow(props: TransitionFlowProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({\n  companyId,\n  startDate,\n  endDate,\n  payScheduleUuid,\n  payrollUuid,\n  withReimbursements = true,\n}: TransitionFlowProps) {\n  const { onEvent } = useBase()\n\n  const resolvedPayrollUuid = useResolveTransitionPayroll({\n    companyId,\n    startDate,\n    endDate,\n    payScheduleUuid,\n  })\n\n  // A caller-supplied payrollUuid wins over the lookup, so a parent that already knows the payroll\n  // can skip creation.\n  const initialPayrollUuid = payrollUuid ?? resolvedPayrollUuid\n\n  // Freeze the machine once. Creating a payroll refetches the resolve query, so recomputing this\n  // would re-seat the machine mid-flow. TransitionPayroll freezes the same decision independently.\n  const [machine] = useState(() => {\n    const initialBreadcrumbId = initialPayrollUuid ? 'configuration' : 'createTransitionPayroll'\n    const breadcrumbs = buildBreadcrumbs(transitionBreadcrumbsNodes)\n    const initialBreadcrumbContext = updateBreadcrumbs(\n      initialBreadcrumbId,\n      { header: { type: 'breadcrumbs' as const, breadcrumbs } },\n      { startDate, endDate },\n    )\n\n    return createMachine(\n      'transitionPayroll',\n      transitionMachine,\n      (initialContext: TransitionFlowContextInterface) => ({\n        ...initialContext,\n        ...initialBreadcrumbContext,\n        component: TransitionPayrollContextual,\n        companyId,\n        startDate,\n        endDate,\n        payScheduleUuid,\n        payrollUuid: initialPayrollUuid,\n        withReimbursements,\n        withOffcyclePayroll: true,\n      }),\n    )\n  })\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n"],"names":["TransitionFlow","props","jsx","BaseComponent","Root","companyId","startDate","endDate","payScheduleUuid","payrollUuid","withReimbursements","onEvent","useBase","resolvedPayrollUuid","useResolveTransitionPayroll","initialPayrollUuid","machine","useState","initialBreadcrumbId","breadcrumbs","buildBreadcrumbs","transitionBreadcrumbsNodes","initialBreadcrumbContext","updateBreadcrumbs","createMachine","transitionMachine","initialContext","TransitionPayrollContextual","Flow"],"mappings":";;;;;;;;;;AAmEO,SAASA,EAAeC,GAA4B;AACzD,SACE,gBAAAC,EAACC,KAAe,GAAGF,GACjB,4BAACG,GAAA,EAAM,GAAGH,GAAO,EAAA,CACnB;AAEJ;AAEA,SAASG,EAAK;AAAA,EACZ,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,SAAAC;AAAA,EACA,iBAAAC;AAAA,EACA,aAAAC;AAAA,EACA,oBAAAC,IAAqB;AACvB,GAAwB;AACtB,QAAM,EAAE,SAAAC,EAAA,IAAYC,EAAA,GAEdC,IAAsBC,EAA4B;AAAA,IACtD,WAAAT;AAAA,IACA,WAAAC;AAAA,IACA,SAAAC;AAAA,IACA,iBAAAC;AAAA,EAAA,CACD,GAIKO,IAAqBN,KAAeI,GAIpC,CAACG,CAAO,IAAIC,EAAS,MAAM;AAC/B,UAAMC,IAAsBH,IAAqB,kBAAkB,2BAC7DI,IAAcC,EAAiBC,CAA0B,GACzDC,IAA2BC;AAAA,MAC/BL;AAAA,MACA,EAAE,QAAQ,EAAE,MAAM,eAAwB,aAAAC,IAAY;AAAA,MACtD,EAAE,WAAAb,GAAW,SAAAC,EAAA;AAAA,IAAQ;AAGvB,WAAOiB;AAAA,MACL;AAAA,MACAC;AAAA,MACA,CAACC,OAAoD;AAAA,QACnD,GAAGA;AAAA,QACH,GAAGJ;AAAA,QACH,WAAWK;AAAA,QACX,WAAAtB;AAAA,QACA,WAAAC;AAAA,QACA,SAAAC;AAAA,QACA,iBAAAC;AAAA,QACA,aAAaO;AAAA,QACb,oBAAAL;AAAA,QACA,qBAAqB;AAAA,MAAA;AAAA,IACvB;AAAA,EAEJ,CAAC;AAED,SAAO,gBAAAR,EAAC0B,GAAA,EAAK,SAAAZ,GAAkB,SAAAL,EAAA,CAAkB;AACnD;"}

package/dist/components/Payroll/Transition/TransitionFlowComponents.js

@@ -1,54 +1,31 @@
-import { jsx as i } from "react/jsx-runtime";
-import { useMemo as c } from "react";
-import { usePayrollsGetSuspense as l } from "@gusto/embedded-api/react-query/payrollsGet";
-import { PayrollExecutionInternalFlow as p } from "../PayrollExecutionFlow/PayrollExecutionFlow.js";
-import { useFlow as s } from "../../Flow/useFlow.js";
-import { BaseComponent as y } from "../../Base/Base.js";
-import { ensureRequired as a } from "../../../helpers/ensureRequired.js";
-import { TransitionCreation as f } from "../TransitionCreation/TransitionCreation.js";
-function T() {
-  const { companyId: r, startDate: t, endDate: e, payScheduleUuid: n, onEvent: o } = s();
-  return /* @__PURE__ */ i(
-    f,
+import { jsx as u } from "react/jsx-runtime";
+import { useFlow as d } from "../../Flow/useFlow.js";
+import { ensureRequired as t } from "../../../helpers/ensureRequired.js";
+import { TransitionPayroll as l } from "../TransitionPayroll/TransitionPayroll.js";
+function f() {
+  const {
+    companyId: e,
+    startDate: o,
+    endDate: r,
+    payScheduleUuid: n,
+    payrollUuid: a,
+    withReimbursements: i,
+    onEvent: m
+  } = d();
+  return /* @__PURE__ */ u(
+    l,
     {
-      companyId: a(r),
-      startDate: a(t),
-      endDate: a(e),
-      payScheduleUuid: a(n),
-      onEvent: o
-    }
-  );
-}
-function S() {
-  const { companyId: r, payrollUuid: t, onEvent: e, header: n } = s(), o = n?.type === "breadcrumbs" ? n.breadcrumbs?.createTransitionPayroll?.[0] : void 0, u = c(() => o ? [o] : void 0, [o]), d = a(r), m = a(t);
-  return /* @__PURE__ */ i(y, { onEvent: e, children: /* @__PURE__ */ i(
-    x,
-    {
-      companyId: d,
-      payrollId: m,
-      onEvent: e,
-      prefixBreadcrumbs: u
-    }
-  ) });
-}
-function x({
-  companyId: r,
-  payrollId: t,
-  ...e
-}) {
-  const { data: n } = l({ companyId: r, payrollId: t }), o = n.payrollShow?.payPeriod;
-  return /* @__PURE__ */ i(
-    p,
-    {
-      companyId: r,
-      payrollId: t,
-      initialPayPeriod: o,
-      ...e
+      companyId: t(e),
+      startDate: t(o),
+      endDate: t(r),
+      payScheduleUuid: t(n),
+      payrollUuid: a,
+      withReimbursements: i,
+      onEvent: m
     }
   );
 }
 export {
-  T as TransitionCreationContextual,
-  S as TransitionExecutionContextual
+  f as TransitionPayrollContextual
 };
 //# sourceMappingURL=TransitionFlowComponents.js.map

package/dist/components/Payroll/Transition/TransitionFlowComponents.js.map

@@ -1 +1 @@
-{"version":3,"file":"TransitionFlowComponents.js","sources":["../../../../src/components/Payroll/Transition/TransitionFlowComponents.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { usePayrollsGetSuspense } from '@gusto/embedded-api/react-query/payrollsGet'\nimport {\n  PayrollExecutionInternalFlow,\n  type PayrollExecutionInternalFlowProps,\n} from '../PayrollExecutionFlow/PayrollExecutionFlow'\nimport { TransitionCreation } from '../TransitionCreation'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport { BaseComponent } from '@/components/Base/Base'\nimport type { OnEventType } from '@/components/Base/useBase'\nimport type { EventType } from '@/shared/constants'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/**\n * Flow context shape carried through the transition payroll state machine.\n *\n * @internal\n */\nexport interface TransitionFlowContextInterface extends FlowContextInterface {\n  /** Company the transition payroll belongs to. */\n  companyId: string\n  /** Start date of the transition pay period (YYYY-MM-DD). */\n  startDate: string\n  /** End date of the transition pay period (YYYY-MM-DD). */\n  endDate: string\n  /** UUID of the pay schedule the transition is associated with. */\n  payScheduleUuid: string\n  /** UUID of the created transition payroll, populated once creation completes. */\n  payrollUuid?: string\n}\n\n/**\n * Props for {@link TransitionFlow}.\n *\n * @public\n */\nexport interface TransitionFlowProps {\n  /** Company running the transition payroll. */\n  companyId: string\n  /** Start date of the transition pay period (YYYY-MM-DD). */\n  startDate: string\n  /** End date of the transition pay period (YYYY-MM-DD). */\n  endDate: string\n  /** UUID of the pay schedule the transition is associated with. */\n  payScheduleUuid: string\n  /** UUID of an existing transition payroll. When provided, the flow skips creation and resumes in execution. */\n  payrollUuid?: string\n  /** Callback invoked for each event emitted by the flow and its child steps. */\n  onEvent: OnEventType<EventType, unknown>\n}\n\n/** @internal */\nexport function TransitionCreationContextual() {\n  const { companyId, startDate, endDate, payScheduleUuid, onEvent } =\n    useFlow<TransitionFlowContextInterface>()\n  return (\n    <TransitionCreation\n      companyId={ensureRequired(companyId)}\n      startDate={ensureRequired(startDate)}\n      endDate={ensureRequired(endDate)}\n      payScheduleUuid={ensureRequired(payScheduleUuid)}\n      onEvent={onEvent}\n    />\n  )\n}\n\n/** @internal */\nexport function TransitionExecutionContextual() {\n  const { companyId, payrollUuid, onEvent, header } = useFlow<TransitionFlowContextInterface>()\n\n  const transitionCreationBreadcrumb =\n    header?.type === 'breadcrumbs'\n      ? header.breadcrumbs?.['createTransitionPayroll']?.[0]\n      : undefined\n  const prefixBreadcrumbs = useMemo(() => {\n    return transitionCreationBreadcrumb ? [transitionCreationBreadcrumb] : undefined\n  }, [transitionCreationBreadcrumb])\n\n  const resolvedCompanyId = ensureRequired(companyId)\n  const resolvedPayrollId = ensureRequired(payrollUuid)\n\n  return (\n    <BaseComponent onEvent={onEvent}>\n      <TransitionExecutionWithData\n        companyId={resolvedCompanyId}\n        payrollId={resolvedPayrollId}\n        onEvent={onEvent}\n        prefixBreadcrumbs={prefixBreadcrumbs}\n      />\n    </BaseComponent>\n  )\n}\n\ntype TransitionExecutionWithDataProps = Pick<\n  PayrollExecutionInternalFlowProps,\n  'companyId' | 'payrollId' | 'onEvent' | 'prefixBreadcrumbs'\n>\n\nfunction TransitionExecutionWithData({\n  companyId,\n  payrollId,\n  ...rest\n}: TransitionExecutionWithDataProps) {\n  const { data } = usePayrollsGetSuspense({ companyId, payrollId })\n  const initialPayPeriod = data.payrollShow?.payPeriod\n\n  return (\n    <PayrollExecutionInternalFlow\n      companyId={companyId}\n      payrollId={payrollId}\n      initialPayPeriod={initialPayPeriod}\n      {...rest}\n    />\n  )\n}\n"],"names":["TransitionCreationContextual","companyId","startDate","endDate","payScheduleUuid","onEvent","useFlow","jsx","TransitionCreation","ensureRequired","TransitionExecutionContextual","payrollUuid","header","transitionCreationBreadcrumb","prefixBreadcrumbs","useMemo","resolvedCompanyId","resolvedPayrollId","BaseComponent","TransitionExecutionWithData","payrollId","rest","data","usePayrollsGetSuspense","initialPayPeriod","PayrollExecutionInternalFlow"],"mappings":";;;;;;;;AAoDO,SAASA,IAA+B;AAC7C,QAAM,EAAE,WAAAC,GAAW,WAAAC,GAAW,SAAAC,GAAS,iBAAAC,GAAiB,SAAAC,EAAA,IACtDC,EAAA;AACF,SACE,gBAAAC;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAeR,CAAS;AAAA,MACnC,WAAWQ,EAAeP,CAAS;AAAA,MACnC,SAASO,EAAeN,CAAO;AAAA,MAC/B,iBAAiBM,EAAeL,CAAe;AAAA,MAC/C,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASK,IAAgC;AAC9C,QAAM,EAAE,WAAAT,GAAW,aAAAU,GAAa,SAAAN,GAAS,QAAAO,EAAA,IAAWN,EAAA,GAE9CO,IACJD,GAAQ,SAAS,gBACbA,EAAO,aAAc,0BAA6B,CAAC,IACnD,QACAE,IAAoBC,EAAQ,MACzBF,IAA+B,CAACA,CAA4B,IAAI,QACtE,CAACA,CAA4B,CAAC,GAE3BG,IAAoBP,EAAeR,CAAS,GAC5CgB,IAAoBR,EAAeE,CAAW;AAEpD,SACE,gBAAAJ,EAACW,KAAc,SAAAb,GACb,UAAA,gBAAAE;AAAA,IAACY;AAAA,IAAA;AAAA,MACC,WAAWH;AAAA,MACX,WAAWC;AAAA,MACX,SAAAZ;AAAA,MACA,mBAAAS;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;AAOA,SAASK,EAA4B;AAAA,EACnC,WAAAlB;AAAA,EACA,WAAAmB;AAAA,EACA,GAAGC;AACL,GAAqC;AACnC,QAAM,EAAE,MAAAC,EAAA,IAASC,EAAuB,EAAE,WAAAtB,GAAW,WAAAmB,GAAW,GAC1DI,IAAmBF,EAAK,aAAa;AAE3C,SACE,gBAAAf;AAAA,IAACkB;AAAA,IAAA;AAAA,MACC,WAAAxB;AAAA,MACA,WAAAmB;AAAA,MACA,kBAAAI;AAAA,MACC,GAAGH;AAAA,IAAA;AAAA,EAAA;AAGV;"}
+{"version":3,"file":"TransitionFlowComponents.js","sources":["../../../../src/components/Payroll/Transition/TransitionFlowComponents.tsx"],"sourcesContent":["import { TransitionPayroll } from '../TransitionPayroll'\nimport type { PayrollFlowContextInterface } from '../PayrollFlow/PayrollFlowComponents'\nimport { useFlow } from '@/components/Flow/useFlow'\nimport type { OnEventType } from '@/components/Base/useBase'\nimport type { EventType } from '@/shared/constants'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/**\n * Flow context shape carried through the transition payroll macro state machine.\n *\n * @remarks\n * Extends {@link PayrollFlowContextInterface} so the payroll-execution reducers reused by the\n * transition machine (overview, edit-employee, receipts, blockers) typecheck against a single\n * shared context shape.\n *\n * @internal\n */\nexport interface TransitionFlowContextInterface extends PayrollFlowContextInterface {\n  /** Start date of the transition pay period (YYYY-MM-DD). */\n  startDate: string\n  /** End date of the transition pay period (YYYY-MM-DD). */\n  endDate: string\n  /** UUID of the pay schedule the transition is associated with. */\n  payScheduleUuid: string\n}\n\n/**\n * Props for {@link TransitionFlow}.\n *\n * @public\n */\nexport interface TransitionFlowProps {\n  /** Company running the transition payroll. */\n  companyId: string\n  /** Start date of the transition pay period (YYYY-MM-DD). */\n  startDate: string\n  /** End date of the transition pay period (YYYY-MM-DD). */\n  endDate: string\n  /** UUID of the pay schedule the transition is associated with. */\n  payScheduleUuid: string\n  /**\n   * UUID of an existing transition payroll. When provided, the flow skips the lookup and starts on\n   * configuration for this payroll. When omitted, it resolves the payroll for the pay period.\n   */\n  payrollUuid?: string\n  /** Whether reimbursement fields are shown throughout the flow. Defaults to `true`. */\n  withReimbursements?: boolean\n  /** Callback invoked for each event emitted by the flow and its child steps. */\n  onEvent: OnEventType<EventType, unknown>\n}\n\n/**\n * Renders {@link TransitionPayroll} as the entry step of {@link TransitionFlow}, wiring its events\n * up to the flow's state machine.\n *\n * @internal\n */\nexport function TransitionPayrollContextual() {\n  const {\n    companyId,\n    startDate,\n    endDate,\n    payScheduleUuid,\n    payrollUuid,\n    withReimbursements,\n    onEvent,\n  } = useFlow<TransitionFlowContextInterface>()\n  return (\n    <TransitionPayroll\n      companyId={ensureRequired(companyId)}\n      startDate={ensureRequired(startDate)}\n      endDate={ensureRequired(endDate)}\n      payScheduleUuid={ensureRequired(payScheduleUuid)}\n      payrollUuid={payrollUuid}\n      withReimbursements={withReimbursements}\n      onEvent={onEvent}\n    />\n  )\n}\n"],"names":["TransitionPayrollContextual","companyId","startDate","endDate","payScheduleUuid","payrollUuid","withReimbursements","onEvent","useFlow","jsx","TransitionPayroll","ensureRequired"],"mappings":";;;;AAyDO,SAASA,IAA8B;AAC5C,QAAM;AAAA,IACJ,WAAAC;AAAA,IACA,WAAAC;AAAA,IACA,SAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,aAAAC;AAAA,IACA,oBAAAC;AAAA,IACA,SAAAC;AAAA,EAAA,IACEC,EAAA;AACJ,SACE,gBAAAC;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAeV,CAAS;AAAA,MACnC,WAAWU,EAAeT,CAAS;AAAA,MACnC,SAASS,EAAeR,CAAO;AAAA,MAC/B,iBAAiBQ,EAAeP,CAAe;AAAA,MAC/C,aAAAC;AAAA,MACA,oBAAAC;AAAA,MACA,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Payroll/Transition/transitionStateMachine.js

@@ -1,54 +1,49 @@
-import { state as t, transition as n, reduce as e, guard as l } from "robot3";
-import { TransitionExecutionContextual as d, TransitionCreationContextual as i } from "./TransitionFlowComponents.js";
-import { componentEvents as c } from "../../../shared/constants.js";
-import { patchBreadcrumbsHeader as a } from "../../../helpers/breadcrumbHelpers.js";
-const b = {
+import { state as t, transition as n, reduce as i } from "robot3";
+import { payrollExecutionMachine as e, getPayrollExecutionBreadcrumbsNodes as l, calculatedTransition as s, alreadyProcessedTransition as c, employeeEditTransition as d, blockersViewAllTransition as m } from "../PayrollExecutionFlow/payrollExecutionMachine.js";
+import { TransitionPayrollContextual as u } from "./TransitionFlowComponents.js";
+import { componentEvents as p } from "../../../shared/constants.js";
+import { updateBreadcrumbs as y } from "../../../helpers/breadcrumbHelpers.js";
+const r = l(), T = r.configuration, D = {
+  // Display-only creation crumb (no `onNavigate`, matching the non-navigable prefix the flow
+  // rendered before this refactor).
   createTransitionPayroll: {
     parent: null,
     item: {
       id: "createTransitionPayroll",
       label: "breadcrumbLabel",
-      namespace: "Payroll.Transition",
-      onNavigate: ((r) => ({
-        ...a(r, { currentBreadcrumbId: "createTransitionPayroll" }),
-        component: i,
-        payrollUuid: void 0
-      }))
+      namespace: "Payroll.Transition"
     }
+  },
+  ...r,
+  configuration: {
+    ...T,
+    parent: "createTransitionPayroll"
   }
-};
-function u(r) {
-  return {
-    ...a(r, { currentBreadcrumbId: "createTransitionPayroll" }),
-    component: i,
-    payrollUuid: void 0
-  };
-}
-const s = n(
-  c.BREADCRUMB_NAVIGATE,
-  "createTransitionPayroll",
-  l(
-    (r, o) => o.payload.key === "createTransitionPayroll"
-  ),
-  e(u)
+}, b = n(
+  p.TRANSITION_CREATED,
+  "transitionPayroll",
+  i(
+    (o, a) => ({
+      ...y("configuration", o, {
+        startDate: o.startDate,
+        endDate: o.endDate
+      }),
+      component: u,
+      payrollUuid: a.payload?.payrollUuid ?? o.payrollUuid
+    })
+  )
 ), B = {
-  createTransitionPayroll: t(
-    n(
-      c.TRANSITION_CREATED,
-      "execution",
-      e(
-        (r, o) => ({
-          ...a(r, { currentBreadcrumbId: void 0 }),
-          payrollUuid: o.payload?.payrollUuid,
-          component: d
-        })
-      )
-    )
+  transitionPayroll: t(
+    b,
+    s,
+    c,
+    d,
+    m
   ),
-  execution: t(s)
+  ...e
 };
 export {
-  b as transitionBreadcrumbsNodes,
+  D as transitionBreadcrumbsNodes,
   B as transitionMachine
 };
 //# sourceMappingURL=transitionStateMachine.js.map

package/dist/components/Payroll/Transition/transitionStateMachine.js.map

@@ -1 +1 @@
-{"version":3,"file":"transitionStateMachine.js","sources":["../../../../src/components/Payroll/Transition/transitionStateMachine.ts"],"sourcesContent":["import { state, transition, reduce, guard } from 'robot3'\nimport {\n  TransitionCreationContextual,\n  TransitionExecutionContextual,\n  type TransitionFlowContextInterface,\n} from './TransitionFlowComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineTransition } from '@/types/Helpers'\nimport type { BreadcrumbNodes } from '@/components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\nimport { patchBreadcrumbsHeader } from '@/helpers/breadcrumbHelpers'\n\n/** @internal */\nexport const transitionBreadcrumbsNodes: BreadcrumbNodes = {\n  createTransitionPayroll: {\n    parent: null,\n    item: {\n      id: 'createTransitionPayroll',\n      label: 'breadcrumbLabel',\n      namespace: 'Payroll.Transition',\n      onNavigate: ((ctx: TransitionFlowContextInterface) => ({\n        ...patchBreadcrumbsHeader(ctx, { currentBreadcrumbId: 'createTransitionPayroll' }),\n        component: TransitionCreationContextual,\n        payrollUuid: undefined,\n      })) as (context: unknown) => unknown,\n    },\n  },\n}\n\nfunction toCreationReducer(ctx: TransitionFlowContextInterface): TransitionFlowContextInterface {\n  return {\n    ...patchBreadcrumbsHeader(ctx, { currentBreadcrumbId: 'createTransitionPayroll' }),\n    component: TransitionCreationContextual,\n    payrollUuid: undefined,\n  }\n}\n\nconst creationBreadcrumbTransition = transition(\n  componentEvents.BREADCRUMB_NAVIGATE,\n  'createTransitionPayroll',\n  guard(\n    (_ctx: TransitionFlowContextInterface, ev: { payload: { key: string } }) =>\n      ev.payload.key === 'createTransitionPayroll',\n  ),\n  reduce(toCreationReducer),\n)\n\n/** @internal */\nexport const transitionMachine = {\n  createTransitionPayroll: state<MachineTransition>(\n    transition(\n      componentEvents.TRANSITION_CREATED,\n      'execution',\n      reduce(\n        (\n          ctx: TransitionFlowContextInterface,\n          ev: { payload?: { payrollUuid?: string } },\n        ): TransitionFlowContextInterface => ({\n          ...patchBreadcrumbsHeader(ctx, { currentBreadcrumbId: undefined }),\n          payrollUuid: ev.payload?.payrollUuid,\n          component: TransitionExecutionContextual,\n        }),\n      ),\n    ),\n  ),\n\n  execution: state<MachineTransition>(creationBreadcrumbTransition),\n}\n"],"names":["transitionBreadcrumbsNodes","ctx","patchBreadcrumbsHeader","TransitionCreationContextual","toCreationReducer","creationBreadcrumbTransition","transition","componentEvents","guard","_ctx","ev","reduce","transitionMachine","state","TransitionExecutionContextual"],"mappings":";;;;AAYO,MAAMA,IAA8C;AAAA,EACzD,yBAAyB;AAAA,IACvB,QAAQ;AAAA,IACR,MAAM;AAAA,MACJ,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,WAAW;AAAA,MACX,aAAa,CAACC,OAAyC;AAAA,QACrD,GAAGC,EAAuBD,GAAK,EAAE,qBAAqB,2BAA2B;AAAA,QACjF,WAAWE;AAAA,QACX,aAAa;AAAA,MAAA;AAAA,IACf;AAAA,EACF;AAEJ;AAEA,SAASC,EAAkBH,GAAqE;AAC9F,SAAO;AAAA,IACL,GAAGC,EAAuBD,GAAK,EAAE,qBAAqB,2BAA2B;AAAA,IACjF,WAAWE;AAAA,IACX,aAAa;AAAA,EAAA;AAEjB;AAEA,MAAME,IAA+BC;AAAA,EACnCC,EAAgB;AAAA,EAChB;AAAA,EACAC;AAAA,IACE,CAACC,GAAsCC,MACrCA,EAAG,QAAQ,QAAQ;AAAA,EAAA;AAAA,EAEvBC,EAAOP,CAAiB;AAC1B,GAGaQ,IAAoB;AAAA,EAC/B,yBAAyBC;AAAA,IACvBP;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAI;AAAA,QACE,CACEV,GACAS,OACoC;AAAA,UACpC,GAAGR,EAAuBD,GAAK,EAAE,qBAAqB,QAAW;AAAA,UACjE,aAAaS,EAAG,SAAS;AAAA,UACzB,WAAWI;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAGF,WAAWD,EAAyBR,CAA4B;AAClE;"}
+{"version":3,"file":"transitionStateMachine.js","sources":["../../../../src/components/Payroll/Transition/transitionStateMachine.ts"],"sourcesContent":["import { state, transition, reduce } from 'robot3'\nimport {\n  payrollExecutionMachine,\n  getPayrollExecutionBreadcrumbsNodes,\n  calculatedTransition,\n  alreadyProcessedTransition,\n  employeeEditTransition,\n  blockersViewAllTransition,\n} from '../PayrollExecutionFlow/payrollExecutionMachine'\nimport {\n  TransitionPayrollContextual,\n  type TransitionFlowContextInterface,\n} from './TransitionFlowComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineTransition } from '@/types/Helpers'\nimport type {\n  BreadcrumbNode,\n  BreadcrumbNodes,\n} from '@/components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\nimport { updateBreadcrumbs } from '@/helpers/breadcrumbHelpers'\n\nconst executionBreadcrumbsNodes = getPayrollExecutionBreadcrumbsNodes()\nconst sharedConfigurationNode = executionBreadcrumbsNodes.configuration!\n\n/**\n * Breadcrumb nodes for the transition payroll macro flow: the creation crumb merged with the\n * shared payroll-execution crumbs. `configuration` is nested under the creation crumb so the\n * \"Transition Payroll\" crumb persists in the trail once the flow advances past creation, matching\n * the display-only prefix the flow rendered before this refactor.\n *\n * @internal\n */\nexport const transitionBreadcrumbsNodes: BreadcrumbNodes = {\n  // Display-only creation crumb (no `onNavigate`, matching the non-navigable prefix the flow\n  // rendered before this refactor).\n  createTransitionPayroll: {\n    parent: null,\n    item: {\n      id: 'createTransitionPayroll',\n      label: 'breadcrumbLabel',\n      namespace: 'Payroll.Transition',\n    },\n  },\n  ...executionBreadcrumbsNodes,\n  configuration: {\n    ...sharedConfigurationNode,\n    parent: 'createTransitionPayroll',\n  },\n} satisfies Record<string, BreadcrumbNode>\n\n// Records the created payroll's UUID and moves the breadcrumb to configuration, keeping\n// TransitionPayroll mounted so it advances its own screen from creation to configuration.\nconst transitionCreatedTransition = transition(\n  componentEvents.TRANSITION_CREATED,\n  'transitionPayroll',\n  reduce(\n    (\n      ctx: TransitionFlowContextInterface,\n      ev: { payload?: { payrollUuid?: string } },\n    ): TransitionFlowContextInterface => ({\n      ...updateBreadcrumbs('configuration', ctx, {\n        startDate: ctx.startDate,\n        endDate: ctx.endDate,\n      }),\n      component: TransitionPayrollContextual,\n      payrollUuid: ev.payload?.payrollUuid ?? ctx.payrollUuid,\n    }),\n  ),\n)\n\n/**\n * Macro state machine for {@link TransitionFlow}.\n *\n * @remarks\n * The entry state renders {@link TransitionPayroll}; the rest of the states are the shared\n * {@link payrollExecutionMachine} states, reused via object spread. The entry state reuses that\n * machine's onward transitions so configuration events route into overview / edit-employee /\n * blockers.\n *\n * @internal\n */\nexport const transitionMachine = {\n  transitionPayroll: state<MachineTransition>(\n    transitionCreatedTransition,\n    calculatedTransition,\n    alreadyProcessedTransition,\n    employeeEditTransition,\n    blockersViewAllTransition,\n  ),\n  ...payrollExecutionMachine,\n}\n"],"names":["executionBreadcrumbsNodes","getPayrollExecutionBreadcrumbsNodes","sharedConfigurationNode","transitionBreadcrumbsNodes","transitionCreatedTransition","transition","componentEvents","reduce","ctx","ev","updateBreadcrumbs","TransitionPayrollContextual","transitionMachine","state","calculatedTransition","alreadyProcessedTransition","employeeEditTransition","blockersViewAllTransition","payrollExecutionMachine"],"mappings":";;;;;AAqBA,MAAMA,IAA4BC,EAAA,GAC5BC,IAA0BF,EAA0B,eAU7CG,IAA8C;AAAA;AAAA;AAAA,EAGzD,yBAAyB;AAAA,IACvB,QAAQ;AAAA,IACR,MAAM;AAAA,MACJ,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,WAAW;AAAA,IAAA;AAAA,EACb;AAAA,EAEF,GAAGH;AAAA,EACH,eAAe;AAAA,IACb,GAAGE;AAAA,IACH,QAAQ;AAAA,EAAA;AAEZ,GAIME,IAA8BC;AAAA,EAClCC,EAAgB;AAAA,EAChB;AAAA,EACAC;AAAA,IACE,CACEC,GACAC,OACoC;AAAA,MACpC,GAAGC,EAAkB,iBAAiBF,GAAK;AAAA,QACzC,WAAWA,EAAI;AAAA,QACf,SAASA,EAAI;AAAA,MAAA,CACd;AAAA,MACD,WAAWG;AAAA,MACX,aAAaF,EAAG,SAAS,eAAeD,EAAI;AAAA,IAAA;AAAA,EAC9C;AAEJ,GAaaI,IAAoB;AAAA,EAC/B,mBAAmBC;AAAA,IACjBT;AAAA,IACAU;AAAA,IACAC;AAAA,IACAC;AAAA,IACAC;AAAA,EAAA;AAAA,EAEF,GAAGC;AACL;"}

package/dist/components/Payroll/TransitionPayroll/TransitionPayroll.js

@@ -0,0 +1,48 @@
+import { jsx as r } from "react/jsx-runtime";
+import { useState as p } from "react";
+import { createMachine as P } from "robot3";
+import { transitionPayrollMachine as x } from "./transitionPayrollStateMachine.js";
+import { PayrollConfigurationContextual as y, TransitionCreationContextual as C } from "./TransitionPayrollComponents.js";
+import { useResolveTransitionPayroll as h } from "./useResolveTransitionPayroll.js";
+import { BaseComponent as g } from "../../Base/Base.js";
+import { useBase as v } from "../../Base/useBase.js";
+import { Flow as B } from "../../Flow/Flow.js";
+function k(o) {
+  return /* @__PURE__ */ r(g, { ...o, children: /* @__PURE__ */ r(T, { ...o }) });
+}
+function T({
+  companyId: o,
+  startDate: n,
+  endDate: t,
+  payScheduleUuid: i,
+  payrollUuid: l,
+  withReimbursements: m = !0
+}) {
+  const { onEvent: s } = v(), u = h({
+    companyId: o,
+    startDate: n,
+    endDate: t,
+    payScheduleUuid: i
+  }), e = l ?? u, [c] = p(() => {
+    const a = !!e;
+    return P(
+      a ? "configuration" : "creation",
+      x,
+      (f) => ({
+        ...f,
+        component: a ? y : C,
+        companyId: o,
+        startDate: n,
+        endDate: t,
+        payScheduleUuid: i,
+        payrollUuid: e,
+        withReimbursements: m
+      })
+    );
+  });
+  return /* @__PURE__ */ r(B, { machine: c, onEvent: s });
+}
+export {
+  k as TransitionPayroll
+};
+//# sourceMappingURL=TransitionPayroll.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransitionPayroll.js","sources":["../../../../src/components/Payroll/TransitionPayroll/TransitionPayroll.tsx"],"sourcesContent":["import { useState } from 'react'\nimport { createMachine } from 'robot3'\nimport { transitionPayrollMachine } from './transitionPayrollStateMachine'\nimport {\n  TransitionCreationContextual,\n  PayrollConfigurationContextual,\n  type TransitionPayrollContextInterface,\n} from './TransitionPayrollComponents'\nimport { useResolveTransitionPayroll } from './useResolveTransitionPayroll'\nimport type { TransitionPayrollProps } from './TransitionPayrollTypes'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { Flow } from '@/components/Flow/Flow'\n\n/**\n * Resolves and runs a transition payroll for a pay-schedule change, picking up an existing\n * unprocessed transition payroll when one exists and creating one otherwise.\n *\n * @remarks\n * A transition payroll covers the gap that opens when a company changes its pay schedule. This\n * component looks up whether one already exists for the pay period and picks the starting screen:\n *\n * - If it exists, it starts on {@link PayrollConfiguration} for that payroll.\n * - Otherwise it starts on {@link TransitionCreation}, then advances to {@link PayrollConfiguration}\n *   once the payroll is created.\n *\n * Configuration events (calculate, employee edit, blockers, etc.) are emitted through `onEvent` for\n * the host to route. Compose it inside {@link TransitionFlow} for the full run-payroll experience,\n * or handle the events yourself.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `transition/created` | The transition payroll has been created and the flow advances to configuration | `{ payrollUuid: string }` |\n *\n * Once configuration begins, all standard run-payroll events are emitted as well (e.g.\n * `runPayroll/calculated`, `runPayroll/employee/edit`, `runPayroll/blockers/viewAll`).\n *\n * @components\n * - {@link TransitionCreation}\n * - {@link PayrollConfiguration}\n *\n * @param props - See {@link TransitionPayrollProps}.\n * @returns The transition payroll component.\n * @public\n *\n * @example\n * ```tsx title=\"App.tsx\"\n * import { Payroll, type EventType } from '@gusto/embedded-react-sdk'\n *\n * function MyApp() {\n *   return (\n *     <Payroll.TransitionPayroll\n *       companyId=\"a007e1ab-3595-43c2-ab4b-af7a5af2e365\"\n *       startDate=\"2025-01-16\"\n *       endDate=\"2025-01-31\"\n *       payScheduleUuid=\"c75c1ef6-2ec0-4cca-94a5-8b4cf7e5ea21\"\n *       onEvent={(eventType: EventType) => {\n *         if (eventType === 'runPayroll/calculated') {\n *           // Payroll calculated — navigate to your review screen\n *         }\n *       }}\n *     />\n *   )\n * }\n * ```\n */\nexport function TransitionPayroll(props: TransitionPayrollProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({\n  companyId,\n  startDate,\n  endDate,\n  payScheduleUuid,\n  payrollUuid,\n  withReimbursements = true,\n}: TransitionPayrollProps) {\n  const { onEvent } = useBase()\n\n  const resolvedPayrollUuid = useResolveTransitionPayroll({\n    companyId,\n    startDate,\n    endDate,\n    payScheduleUuid,\n  })\n\n  // A caller-supplied payrollUuid wins over the lookup, so a parent that already knows the payroll\n  // can skip creation.\n  const initialPayrollUuid = payrollUuid ?? resolvedPayrollUuid\n\n  // Freeze the machine once. Creating a payroll refetches the resolve query, so recomputing this\n  // would re-seat the machine mid-flow.\n  const [machine] = useState(() => {\n    const hasExisting = Boolean(initialPayrollUuid)\n    return createMachine(\n      hasExisting ? 'configuration' : 'creation',\n      transitionPayrollMachine,\n      (initialContext: TransitionPayrollContextInterface) => ({\n        ...initialContext,\n        component: hasExisting ? PayrollConfigurationContextual : TransitionCreationContextual,\n        companyId,\n        startDate,\n        endDate,\n        payScheduleUuid,\n        payrollUuid: initialPayrollUuid,\n        withReimbursements,\n      }),\n    )\n  })\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n"],"names":["TransitionPayroll","props","jsx","BaseComponent","Root","companyId","startDate","endDate","payScheduleUuid","payrollUuid","withReimbursements","onEvent","useBase","resolvedPayrollUuid","useResolveTransitionPayroll","initialPayrollUuid","machine","useState","hasExisting","createMachine","transitionPayrollMachine","initialContext","PayrollConfigurationContextual","TransitionCreationContextual","Flow"],"mappings":";;;;;;;;;AAmEO,SAASA,EAAkBC,GAA+B;AAC/D,SACE,gBAAAC,EAACC,KAAe,GAAGF,GACjB,4BAACG,GAAA,EAAM,GAAGH,GAAO,EAAA,CACnB;AAEJ;AAEA,SAASG,EAAK;AAAA,EACZ,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,SAAAC;AAAA,EACA,iBAAAC;AAAA,EACA,aAAAC;AAAA,EACA,oBAAAC,IAAqB;AACvB,GAA2B;AACzB,QAAM,EAAE,SAAAC,EAAA,IAAYC,EAAA,GAEdC,IAAsBC,EAA4B;AAAA,IACtD,WAAAT;AAAA,IACA,WAAAC;AAAA,IACA,SAAAC;AAAA,IACA,iBAAAC;AAAA,EAAA,CACD,GAIKO,IAAqBN,KAAeI,GAIpC,CAACG,CAAO,IAAIC,EAAS,MAAM;AAC/B,UAAMC,IAAc,EAAQH;AAC5B,WAAOI;AAAA,MACLD,IAAc,kBAAkB;AAAA,MAChCE;AAAA,MACA,CAACC,OAAuD;AAAA,QACtD,GAAGA;AAAA,QACH,WAAWH,IAAcI,IAAiCC;AAAA,QAC1D,WAAAlB;AAAA,QACA,WAAAC;AAAA,QACA,SAAAC;AAAA,QACA,iBAAAC;AAAA,QACA,aAAaO;AAAA,QACb,oBAAAL;AAAA,MAAA;AAAA,IACF;AAAA,EAEJ,CAAC;AAED,SAAO,gBAAAR,EAACsB,GAAA,EAAK,SAAAR,GAAkB,SAAAL,EAAA,CAAkB;AACnD;"}

package/dist/components/Payroll/TransitionPayroll/TransitionPayrollComponents.js

@@ -0,0 +1,35 @@
+import { jsx as a } from "react/jsx-runtime";
+import { PayrollConfiguration as m } from "../PayrollConfiguration/PayrollConfiguration.js";
+import { useFlow as i } from "../../Flow/useFlow.js";
+import { ensureRequired as o } from "../../../helpers/ensureRequired.js";
+import { TransitionCreation as p } from "../TransitionCreation/TransitionCreation.js";
+function f() {
+  const { companyId: t, startDate: n, endDate: r, payScheduleUuid: e, onEvent: u } = i();
+  return /* @__PURE__ */ a(
+    p,
+    {
+      companyId: o(t),
+      startDate: o(n),
+      endDate: o(r),
+      payScheduleUuid: o(e),
+      onEvent: u
+    }
+  );
+}
+function C() {
+  const { companyId: t, payrollUuid: n, onEvent: r, withReimbursements: e } = i();
+  return /* @__PURE__ */ a(
+    m,
+    {
+      companyId: o(t),
+      payrollId: o(n),
+      onEvent: r,
+      withReimbursements: e
+    }
+  );
+}
+export {
+  C as PayrollConfigurationContextual,
+  f as TransitionCreationContextual
+};
+//# sourceMappingURL=TransitionPayrollComponents.js.map

package/dist/components/Payroll/TransitionPayroll/TransitionPayrollComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransitionPayrollComponents.js","sources":["../../../../src/components/Payroll/TransitionPayroll/TransitionPayrollComponents.tsx"],"sourcesContent":["import { TransitionCreation } from '../TransitionCreation'\nimport { PayrollConfiguration } from '../PayrollConfiguration/PayrollConfiguration'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/**\n * Flow context shape carried through the {@link TransitionPayroll} state machine.\n *\n * @internal\n */\nexport interface TransitionPayrollContextInterface extends FlowContextInterface {\n  /** Company the transition payroll belongs to. */\n  companyId: string\n  /** Start date of the transition pay period (YYYY-MM-DD). */\n  startDate: string\n  /** End date of the transition pay period (YYYY-MM-DD). */\n  endDate: string\n  /** UUID of the pay schedule the transition is associated with. */\n  payScheduleUuid: string\n  /** UUID of the transition payroll once it has been resolved or created. */\n  payrollUuid?: string\n  /** Whether reimbursement fields are shown on the configuration screen. Defaults to `true`. */\n  withReimbursements?: boolean\n}\n\n/** @internal */\nexport function TransitionCreationContextual() {\n  const { companyId, startDate, endDate, payScheduleUuid, onEvent } =\n    useFlow<TransitionPayrollContextInterface>()\n  return (\n    <TransitionCreation\n      companyId={ensureRequired(companyId)}\n      startDate={ensureRequired(startDate)}\n      endDate={ensureRequired(endDate)}\n      payScheduleUuid={ensureRequired(payScheduleUuid)}\n      onEvent={onEvent}\n    />\n  )\n}\n\n/** @internal */\nexport function PayrollConfigurationContextual() {\n  const { companyId, payrollUuid, onEvent, withReimbursements } =\n    useFlow<TransitionPayrollContextInterface>()\n  return (\n    <PayrollConfiguration\n      companyId={ensureRequired(companyId)}\n      payrollId={ensureRequired(payrollUuid)}\n      onEvent={onEvent}\n      withReimbursements={withReimbursements}\n    />\n  )\n}\n"],"names":["TransitionCreationContextual","companyId","startDate","endDate","payScheduleUuid","onEvent","useFlow","jsx","TransitionCreation","ensureRequired","PayrollConfigurationContextual","payrollUuid","withReimbursements","PayrollConfiguration"],"mappings":";;;;;AA0BO,SAASA,IAA+B;AAC7C,QAAM,EAAE,WAAAC,GAAW,WAAAC,GAAW,SAAAC,GAAS,iBAAAC,GAAiB,SAAAC,EAAA,IACtDC,EAAA;AACF,SACE,gBAAAC;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAeR,CAAS;AAAA,MACnC,WAAWQ,EAAeP,CAAS;AAAA,MACnC,SAASO,EAAeN,CAAO;AAAA,MAC/B,iBAAiBM,EAAeL,CAAe;AAAA,MAC/C,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASK,IAAiC;AAC/C,QAAM,EAAE,WAAAT,GAAW,aAAAU,GAAa,SAAAN,GAAS,oBAAAO,EAAA,IACvCN,EAAA;AACF,SACE,gBAAAC;AAAA,IAACM;AAAA,IAAA;AAAA,MACC,WAAWJ,EAAeR,CAAS;AAAA,MACnC,WAAWQ,EAAeE,CAAW;AAAA,MACrC,SAAAN;AAAA,MACA,oBAAAO;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Payroll/TransitionPayroll/transitionPayrollStateMachine.js

@@ -0,0 +1,23 @@
+import { state as o, transition as r, reduce as i } from "robot3";
+import { PayrollConfigurationContextual as a } from "./TransitionPayrollComponents.js";
+import { componentEvents as e } from "../../../shared/constants.js";
+const m = {
+  creation: o(
+    r(
+      e.TRANSITION_CREATED,
+      "configuration",
+      i(
+        (t, n) => ({
+          ...t,
+          payrollUuid: n.payload?.payrollUuid,
+          component: a
+        })
+      )
+    )
+  ),
+  configuration: o()
+};
+export {
+  m as transitionPayrollMachine
+};
+//# sourceMappingURL=transitionPayrollStateMachine.js.map

package/dist/components/Payroll/TransitionPayroll/transitionPayrollStateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionPayrollStateMachine.js","sources":["../../../../src/components/Payroll/TransitionPayroll/transitionPayrollStateMachine.ts"],"sourcesContent":["import { state, transition, reduce } from 'robot3'\nimport {\n  PayrollConfigurationContextual,\n  type TransitionPayrollContextInterface,\n} from './TransitionPayrollComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineTransition } from '@/types/Helpers'\n\n/**\n * State machine for {@link TransitionPayroll}.\n *\n * @remarks\n * `creation` shows {@link TransitionCreation}; `configuration` shows {@link PayrollConfiguration}.\n * The component freezes the initial state from the resolve lookup. `configuration` has no outgoing\n * transitions (a plain zero-transition state, not a robot3 final state per SDK-1169) so its events\n * bubble via `onEvent` and the screen keeps working if the host stays mounted past completion.\n *\n * @internal\n */\nexport const transitionPayrollMachine = {\n  creation: state<MachineTransition>(\n    transition(\n      componentEvents.TRANSITION_CREATED,\n      'configuration',\n      reduce(\n        (\n          ctx: TransitionPayrollContextInterface,\n          ev: { payload?: { payrollUuid?: string } },\n        ): TransitionPayrollContextInterface => ({\n          ...ctx,\n          payrollUuid: ev.payload?.payrollUuid,\n          component: PayrollConfigurationContextual,\n        }),\n      ),\n    ),\n  ),\n\n  configuration: state<MachineTransition>(),\n}\n"],"names":["transitionPayrollMachine","state","transition","componentEvents","reduce","ctx","ev","PayrollConfigurationContextual"],"mappings":";;;AAmBO,MAAMA,IAA2B;AAAA,EACtC,UAAUC;AAAA,IACRC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CACEC,GACAC,OACuC;AAAA,UACvC,GAAGD;AAAA,UACH,aAAaC,EAAG,SAAS;AAAA,UACzB,WAAWC;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAGF,eAAeN,EAAA;AACjB;"}

package/dist/components/Payroll/TransitionPayroll/useResolveTransitionPayroll.js

@@ -0,0 +1,32 @@
+import { usePayrollsListSuspense as i } from "@gusto/embedded-api/react-query/payrollsList";
+import { QueryParamPayrollTypes as s, ProcessingStatuses as u } from "@gusto/embedded-api/models/operations/getv1companiescompanyidpayrolls";
+const c = 28, p = "Transition from old pay schedule";
+function d() {
+  const e = /* @__PURE__ */ new Date();
+  return e.setDate(e.getDate() + c), e.toISOString().split("T")[0];
+}
+function S({
+  companyId: e,
+  startDate: o,
+  endDate: r,
+  payScheduleUuid: n
+}) {
+  const { data: l } = i({
+    companyId: e,
+    processingStatuses: [u.Unprocessed],
+    endDate: d(),
+    payrollTypes: [
+      s.Regular,
+      s.OffCycle,
+      s.External
+    ]
+  });
+  return l.payrollList?.find((a) => {
+    const t = a.payPeriod;
+    return a.offCycleReason === p && t?.startDate === o && t.endDate === r && t.payScheduleUuid === n;
+  })?.payrollUuid;
+}
+export {
+  S as useResolveTransitionPayroll
+};
+//# sourceMappingURL=useResolveTransitionPayroll.js.map

package/dist/components/Payroll/TransitionPayroll/useResolveTransitionPayroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolveTransitionPayroll.js","sources":["../../../../src/components/Payroll/TransitionPayroll/useResolveTransitionPayroll.ts"],"sourcesContent":["import { usePayrollsListSuspense } from '@gusto/embedded-api/react-query/payrollsList'\nimport {\n  ProcessingStatuses,\n  QueryParamPayrollTypes,\n} from '@gusto/embedded-api/models/operations/getv1companiescompanyidpayrolls'\n\nconst FUTURE_LOOKAHEAD_DAYS = 28\n\nconst TRANSITION_OFF_CYCLE_REASON = 'Transition from old pay schedule'\n\nfunction getFutureEndDate(): string {\n  const date = new Date()\n  date.setDate(date.getDate() + FUTURE_LOOKAHEAD_DAYS)\n  return date.toISOString().split('T')[0]!\n}\n\n/**\n * Arguments describing the transition pay period to resolve.\n *\n * @internal\n */\nexport interface ResolveTransitionPayrollArgs {\n  companyId: string\n  startDate: string\n  endDate: string\n  payScheduleUuid: string\n}\n\n/**\n * Looks up an existing unprocessed transition payroll for the given pay period.\n *\n * @remarks\n * A transition payroll is an unprocessed off-cycle payroll whose `offCycleReason` is\n * `\"Transition from old pay schedule\"` and whose pay period matches the supplied\n * `startDate`, `endDate`, and `payScheduleUuid`. When the company changed its pay schedule\n * the platform creates exactly one such payroll for the coverage gap; this hook finds it so\n * the caller can resume it instead of creating a duplicate.\n *\n * Backed by a suspense query, so callers must render it under a suspense boundary.\n *\n * @param args - The pay period to match. See {@link ResolveTransitionPayrollArgs}.\n * @returns The matching payroll's UUID, or `undefined` when none exists yet.\n * @internal\n */\nexport function useResolveTransitionPayroll({\n  companyId,\n  startDate,\n  endDate,\n  payScheduleUuid,\n}: ResolveTransitionPayrollArgs): string | undefined {\n  const { data: payrollsData } = usePayrollsListSuspense({\n    companyId,\n    processingStatuses: [ProcessingStatuses.Unprocessed],\n    endDate: getFutureEndDate(),\n    payrollTypes: [\n      QueryParamPayrollTypes.Regular,\n      QueryParamPayrollTypes.OffCycle,\n      QueryParamPayrollTypes.External,\n    ],\n  })\n\n  const match = payrollsData.payrollList?.find(payroll => {\n    const period = payroll.payPeriod\n    return (\n      payroll.offCycleReason === TRANSITION_OFF_CYCLE_REASON &&\n      period?.startDate === startDate &&\n      period.endDate === endDate &&\n      period.payScheduleUuid === payScheduleUuid\n    )\n  })\n\n  return match?.payrollUuid\n}\n"],"names":["FUTURE_LOOKAHEAD_DAYS","TRANSITION_OFF_CYCLE_REASON","getFutureEndDate","date","useResolveTransitionPayroll","companyId","startDate","endDate","payScheduleUuid","payrollsData","usePayrollsListSuspense","ProcessingStatuses","QueryParamPayrollTypes","payroll","period"],"mappings":";;AAMA,MAAMA,IAAwB,IAExBC,IAA8B;AAEpC,SAASC,IAA2B;AAClC,QAAMC,wBAAW,KAAA;AACjB,SAAAA,EAAK,QAAQA,EAAK,QAAA,IAAYH,CAAqB,GAC5CG,EAAK,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC;AACxC;AA8BO,SAASC,EAA4B;AAAA,EAC1C,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,SAAAC;AAAA,EACA,iBAAAC;AACF,GAAqD;AACnD,QAAM,EAAE,MAAMC,EAAA,IAAiBC,EAAwB;AAAA,IACrD,WAAAL;AAAA,IACA,oBAAoB,CAACM,EAAmB,WAAW;AAAA,IACnD,SAAST,EAAA;AAAA,IACT,cAAc;AAAA,MACZU,EAAuB;AAAA,MACvBA,EAAuB;AAAA,MACvBA,EAAuB;AAAA,IAAA;AAAA,EACzB,CACD;AAYD,SAVcH,EAAa,aAAa,KAAK,CAAAI,MAAW;AACtD,UAAMC,IAASD,EAAQ;AACvB,WACEA,EAAQ,mBAAmBZ,KAC3Ba,GAAQ,cAAcR,KACtBQ,EAAO,YAAYP,KACnBO,EAAO,oBAAoBN;AAAA,EAE/B,CAAC,GAEa;AAChB;"}

package/dist/components/Payroll/index.js

@@ -1,7 +1,7 @@
 import { PayrollConfiguration as e } from "./PayrollConfiguration/PayrollConfiguration.js";
 import { PayrollEditEmployee as l } from "./PayrollEditEmployee/PayrollEditEmployee.js";
 import { PayrollHistory as i } from "./PayrollHistory/PayrollHistory.js";
-import { PayrollLanding as p } from "./PayrollLanding/PayrollLanding.js";
+import { PayrollLanding as a } from "./PayrollLanding/PayrollLanding.js";
 import { PayrollList as x } from "./PayrollList/PayrollList.js";
 import { PayrollOverview as s } from "./PayrollOverview/PayrollOverview.js";
 import { PayrollFlow as P } from "./PayrollFlow/PayrollFlow.js";
@@ -12,19 +12,20 @@ import { PrintChecks as g } from "./PrintChecks/PrintChecks.js";
 import { DismissalFlow as v } from "./Dismissal/DismissalFlow.js";
 import { DismissalPayPeriodSelection as L } from "./Dismissal/DismissalPayPeriodSelection/DismissalPayPeriodSelection.js";
 import { OffCycleCreation as S } from "./OffCycleCreation/OffCycleCreation.js";
-import { OffCycleDeductionsSetting as T } from "./OffCycleDeductionsSetting/OffCycleDeductionsSetting.js";
+import { OffCycleDeductionsSetting as k } from "./OffCycleDeductionsSetting/OffCycleDeductionsSetting.js";
 import { OffCycleFlow as B } from "./OffCycle/OffCycleFlow.js";
 import { OffCycleReasonSelection as W } from "./OffCycleReasonSelection/OffCycleReasonSelection.js";
 import { PayrollBlockerList as j } from "./PayrollBlocker/components/PayrollBlockerList.js";
 import { PayrollExecutionFlow as z } from "./PayrollExecutionFlow/PayrollExecutionFlow.js";
 import { TransitionCreation as G } from "./TransitionCreation/TransitionCreation.js";
 import { TransitionFlow as J } from "./Transition/TransitionFlow.js";
+import { TransitionPayroll as M } from "./TransitionPayroll/TransitionPayroll.js";
 export {
   F as ConfirmWireDetails,
   v as DismissalFlow,
   L as DismissalPayPeriodSelection,
   S as OffCycleCreation,
-  T as OffCycleDeductionsSetting,
+  k as OffCycleDeductionsSetting,
   B as OffCycleFlow,
   W as OffCycleReasonSelection,
   j as PayrollBlockerList,
@@ -33,13 +34,14 @@ export {
   z as PayrollExecutionFlow,
   P as PayrollFlow,
   i as PayrollHistory,
-  p as PayrollLanding,
+  a as PayrollLanding,
   x as PayrollList,
   s as PayrollOverview,
   C as PayrollReceipts,
   g as PrintChecks,
   d as RecoveryCases,
   G as TransitionCreation,
-  J as TransitionFlow
+  J as TransitionFlow,
+  M as TransitionPayroll
 };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;"}

package/dist/i18n/I18n.js

@@ -232,23 +232,28 @@ const j = "common", i = /* @__PURE__ */ Object.assign({
   "./es_US/Payroll.PayrollList.json": () => import("./es_US/Payroll.PayrollList.json.js").then((e) => e.default),
   "./es_US/Payroll.PayrollOverview.json": () => import("./es_US/Payroll.PayrollOverview.json.js").then((e) => e.default),
   "./es_US/Payroll.PayrollReceipts.json": () => import("./es_US/Payroll.PayrollReceipts.json.js").then((e) => e.default),
+  "./es_US/Payroll.PrintChecksBanner.json": () => import("./es_US/Payroll.PrintChecksBanner.json.js").then((e) => e.default),
+  "./es_US/Payroll.PrintChecksFailure.json": () => import("./es_US/Payroll.PrintChecksFailure.json.js").then((e) => e.default),
+  "./es_US/Payroll.PrintChecksForm.json": () => import("./es_US/Payroll.PrintChecksForm.json.js").then((e) => e.default),
+  "./es_US/Payroll.PrintChecksSummary.json": () => import("./es_US/Payroll.PrintChecksSummary.json.js").then((e) => e.default),
   "./es_US/Payroll.RecoveryCasesList.json": () => import("./es_US/Payroll.RecoveryCasesList.json.js").then((e) => e.default),
   "./es_US/Payroll.RecoveryCasesResubmit.json": () => import("./es_US/Payroll.RecoveryCasesResubmit.json.js").then((e) => e.default),
   "./es_US/Payroll.Transition.json": () => import("./es_US/Payroll.Transition.json.js").then((e) => e.default),
   "./es_US/Payroll.TransitionCreation.json": () => import("./es_US/Payroll.TransitionCreation.json.js").then((e) => e.default),
   "./es_US/Payroll.TransitionPayrollAlert.json": () => import("./es_US/Payroll.TransitionPayrollAlert.json.js").then((e) => e.default),
+  "./es_US/Payroll.UNSTABLE_PayrollEditEmployee.json": () => import("./es_US/Payroll.UNSTABLE_PayrollEditEmployee.json.js").then((e) => e.default),
   "./es_US/Payroll.WireInstructions.json": () => import("./es_US/Payroll.WireInstructions.json.js").then((e) => e.default),
   "./es_US/common.json": () => import("./es_US/common.json.js").then((e) => e.default)
 });
-function d(e, t) {
+function u(e, t) {
   const o = `./${e ?? "en"}/${t}.json`;
   return i[o] ?? i[`./en/${t}.json`];
 }
-const s = new f(50), u = ({ lng: e = "en", ns: t }) => {
+const s = new f(50), d = ({ lng: e = "en", ns: t }) => {
   let n = !0, o = !1, a;
   const l = (async () => {
     try {
-      const m = d(e, t);
+      const m = u(e, t);
       if (!m) {
         o = !0, n = !1;
         return;
@@ -271,7 +276,7 @@ const s = new f(50), u = ({ lng: e = "en", ns: t }) => {
   const n = Array.isArray(e) ? e : [e];
   for (const o of n) {
     const a = `${t.language}:${o}`;
-    s.get(a) === null && s.put(a, u({ lng: t.language, ns: o }));
+    s.get(a) === null && s.put(a, d({ lng: t.language, ns: o }));
     const r = s.get(a);
     if (r) {
       const l = r();