@gusto/embedded-react-sdk 0.57.2 → 0.58.0

package/docs/guides/endpoint-inventory.json

@@ -184,6 +184,11 @@
           "path": "/v1/companies/:companyId/pay_schedules",
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules"
         },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/payrolls",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-payrolls"
+        },
         {
           "method": "GET",
           "path": "/v1/companies/:companyUuid/payrolls/blockers",
@@ -417,6 +422,11 @@
           "path": "/v1/companies/:companyId/employees",
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-employees"
         },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_schedules",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules"
+        },
         {
           "method": "POST",
           "path": "/v1/companies/:companyId/payrolls",
@@ -497,7 +507,7 @@
         "payrollId"
       ]
     },
-    "Payroll.TransitionCreation": {
+    "Payroll.TransitionConfiguration": {
       "endpoints": [
         {
           "method": "GET",
@@ -505,31 +515,24 @@
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules"
         },
         {
-          "method": "POST",
-          "path": "/v1/companies/:companyId/payrolls",
-          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/post-v1-companies-company_id-payrolls"
+          "method": "GET",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-payrolls-payroll_id"
         },
         {
-          "method": "GET",
-          "path": "/v1/companies/:companyUuid/payment_configs",
-          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-company-payment-configs"
-        }
-      ],
-      "variables": [
-        "companyId",
-        "companyUuid"
-      ]
-    },
-    "Payroll.TransitionPayroll": {
-      "endpoints": [
+          "method": "PUT",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/put-v1-companies-company_id-payrolls"
+        },
         {
-          "method": "GET",
-          "path": "/v1/companies/:companyId/payrolls",
-          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-payrolls"
+          "method": "PUT",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId/prepare",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/put-v1-companies-company_id-payrolls-payroll_id-prepare"
         }
       ],
       "variables": [
-        "companyId"
+        "companyId",
+        "payrollId"
       ]
     },
     "TimeOff.PolicyList": {
@@ -875,11 +878,6 @@
     },
     "EmployeeOnboarding.Landing": {
       "endpoints": [
-        {
-          "method": "GET",
-          "path": "/v1/companies/:companyId",
-          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies"
-        },
         {
           "method": "GET",
           "path": "/v1/employees/:employeeId",
@@ -887,7 +885,6 @@
         }
       ],
       "variables": [
-        "companyId",
         "employeeId"
       ]
     },
@@ -1760,6 +1757,11 @@
     },
     "CompanyOnboarding.PaySchedule": {
       "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/employees",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-employees"
+        },
         {
           "method": "GET",
           "path": "/v1/companies/:companyId/pay_schedules",
@@ -1800,6 +1802,11 @@
           "path": "/v1/companies/:companyId/pay_schedules/preview",
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules-preview"
         },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyUuid/departments",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-companies-departments"
+        },
         {
           "method": "GET",
           "path": "/v1/companies/:companyUuid/payment_configs",
@@ -1986,6 +1993,11 @@
     },
     "CompanyManagement.PaySchedule": {
       "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/employees",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-employees"
+        },
         {
           "method": "GET",
           "path": "/v1/companies/:companyId/pay_schedules",
@@ -2015,15 +2027,26 @@
           "method": "GET",
           "path": "/v1/companies/:companyId/pay_schedules/assignments",
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules-assignments"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyUuid/departments",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-companies-departments"
         }
       ],
       "variables": [
         "companyId",
+        "companyUuid",
         "payScheduleId"
       ]
     },
     "CompanyManagement.PayScheduleAssignment": {
       "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/employees",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-employees"
+        },
         {
           "method": "GET",
           "path": "/v1/companies/:companyId/pay_schedules",
@@ -2043,10 +2066,16 @@
           "method": "GET",
           "path": "/v1/companies/:companyId/pay_schedules/assignments",
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules-assignments"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyUuid/departments",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-companies-departments"
         }
       ],
       "variables": [
-        "companyId"
+        "companyId",
+        "companyUuid"
       ]
     },
     "CompanyManagement.TaxPaymentsFlow": {
@@ -2081,11 +2110,6 @@
     },
     "ContractorOnboarding.Landing": {
       "endpoints": [
-        {
-          "method": "GET",
-          "path": "/v1/companies/:companyId",
-          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies"
-        },
         {
           "method": "GET",
           "path": "/v1/contractors/:contractorUuid",
@@ -2093,7 +2117,6 @@
         }
       ],
       "variables": [
-        "companyId",
         "contractorUuid"
       ]
     },
@@ -2793,13 +2816,7 @@
         "Payroll.PayrollLanding",
         "Payroll.PayrollOverview",
         "Payroll.PayrollReceipts",
-        "Payroll.TransitionFlow"
-      ]
-    },
-    "Payroll.TransitionFlow": {
-      "blocks": [
-        "Payroll.PayrollExecutionFlow",
-        "Payroll.TransitionPayroll"
+        "Payroll.TransitionConfiguration"
       ]
     },
     "TimeOff.TimeOffFlow": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusto/embedded-react-sdk",
-  "version": "0.57.2",
+  "version": "0.58.0",
   "homepage": "https://github.com/Gusto/embedded-react-sdk",
   "bugs": {
     "url": "https://github.com/Gusto/embedded-react-sdk/issues"
@@ -49,8 +49,8 @@
     "docs": "npm --prefix docs-site start",
     "docs:build": "npm --prefix docs-site run build",
     "docs:clear": "npm --prefix docs-site run clear",
-    "docs:install": "npm --prefix docs-site install",
-    "docs:api:generate": "npm --prefix docs-site run typedoc",
+    "docs:install": "npm --prefix docs-site install && npm --prefix typedoc install",
+    "docs:api:generate": "npm --prefix typedoc run typedoc",
     "docs:lint": "npx tsx ./build/lintDocsFrontmatter.ts",
     "docs:lint:markdown": "markdownlint-cli2",
     "docs:lint:spell": "cspell lint --no-progress --no-must-find-files",
@@ -99,13 +99,14 @@
     "@commitlint/cli": "^21.2.4",
     "@commitlint/config-conventional": "^21.2.2",
     "@eslint/js": "^9.39.5",
-    "@microsoft/api-extractor": "^7.59.4",
+    "@microsoft/api-extractor": "^7.60.0",
+    "@mswjs/interceptors": "^0.45.9",
     "@playwright/test": "^1.64.1",
     "@release-it/conventional-changelog": "^12.0.2",
-    "@storybook/addon-a11y": "^10.6.2",
-    "@storybook/addon-docs": "^10.6.2",
-    "@storybook/addon-onboarding": "^10.6.2",
-    "@storybook/react-vite": "^10.6.2",
+    "@storybook/addon-a11y": "^10.6.5",
+    "@storybook/addon-docs": "^10.6.4",
+    "@storybook/addon-onboarding": "^10.6.4",
+    "@storybook/react-vite": "^10.6.4",
     "@storybook/test-runner": "^0.26.0",
     "@testing-library/dom": "^10.4.2",
     "@testing-library/jest-dom": "^7.0.1",
@@ -118,24 +119,24 @@
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.3.0",
     "@typescript-eslint/parser": "^8.70.1",
-    "@typescript-eslint/rule-tester": "^8.71.2",
+    "@typescript-eslint/rule-tester": "^8.72.1",
     "@typescript-eslint/utils": "^8.70.1",
     "@vitejs/plugin-react-swc": "^4.3.3",
     "@vitest/coverage-v8": "^5.0.0",
     "ajv": "^8.20.0",
     "axe-core": "^4.14.0",
     "cspell": "^10.4.0",
-    "dotenv": "^18.0.3",
+    "dotenv": "^18.0.9",
     "eslint": "^9.39.5",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-refresh": "^0.4.24",
-    "eslint-plugin-storybook": "^10.6.2",
+    "eslint-plugin-storybook": "^10.6.3",
     "eslint-plugin-tsdoc": "^0.5.4",
     "fuse.js": "^7.5.0",
-    "globals": "^17.12.0",
+    "globals": "^17.13.0",
     "husky": "^9.1.7",
     "jest-axe": "^11.0.0",
     "jsdom": "^26.1.0",
@@ -145,7 +146,7 @@
     "markdownlint-cli2": "^0.24.0",
     "msw": "^3.0.3",
     "npm-run-all": "^4.1.5",
-    "pixelmatch": "^7.2.0",
+    "pixelmatch": "^8.0.0",
     "pngjs": "^7.0.0",
     "prettier": "^3.9.10",
     "prism-react-renderer": "^2.4.1",
@@ -153,13 +154,13 @@
     "react-dnd-html5-backend": "^16.0.1",
     "react-router-dom": "^7.18.4",
     "release-it": "^21.1.1",
-    "sass-embedded": "^1.105.2",
-    "storybook": "^10.5.5",
+    "sass-embedded": "^1.107.0",
+    "storybook": "^10.6.3",
     "stylelint-config-standard": "^40.0.0",
     "ts-morph": "^28.0.0",
     "tsx": "^4.23.15",
-    "typescript-eslint": "^8.71.2",
-    "vite": "^6.4.4",
+    "typescript-eslint": "^8.72.1",
+    "vite": "^6.4.5",
     "vite-plugin-checker": "^0.14.5",
     "vite-plugin-circular-dependency": "^0.6.0",
     "vite-plugin-dts": "^5.1.2",
@@ -188,20 +189,20 @@
     }
   },
   "dependencies": {
-    "@gusto/embedded-api": "npm:@gusto/embedded-api-v-2026-06-15@0.3.1",
+    "@gusto/embedded-api": "npm:@gusto/embedded-api-v-2026-06-15@0.3.2",
     "@hookform/error-message": "^2.0.1",
-    "@hookform/resolvers": "^5.9.1",
+    "@hookform/resolvers": "^6.0.0",
     "@internationalized/date": "^3.12.4",
     "@internationalized/number": "^3.6.9",
     "classnames": "^2.5.1",
     "deepmerge": "^4.3.1",
     "dompurify": "^3.4.17",
-    "i18next": "^26.5.2",
+    "i18next": "^26.5.11",
     "react-aria": "^3.47.0",
     "react-aria-components": "1.16.0",
     "react-error-boundary": "^6.1.6",
-    "react-hook-form": "^7.90.0",
-    "react-i18next": "^17.1.0",
+    "react-hook-form": "^7.91.0",
+    "react-i18next": "^17.1.9",
     "react-robot": "^1.2.1",
     "robot3": "^1.4.0",
     "zod": "^4.3.6"

package/dist/components/Payroll/PayrollFlow/TransitionFlowContextual.js

@@ -1,29 +0,0 @@
-import { jsx as m } from "react/jsx-runtime";
-import { TransitionFlow as s } from "../Transition/TransitionFlow.js";
-import { useFlow as u } from "../../Flow/useFlow.js";
-import { ensureRequired as t } from "../../../helpers/ensureRequired.js";
-function f() {
-  const {
-    companyId: n,
-    transitionStartDate: o,
-    transitionEndDate: e,
-    transitionPayScheduleUuid: r,
-    withReimbursements: i,
-    onEvent: a
-  } = u();
-  return /* @__PURE__ */ m(
-    s,
-    {
-      companyId: t(n),
-      startDate: t(o),
-      endDate: t(e),
-      payScheduleUuid: t(r),
-      withReimbursements: i,
-      onEvent: a
-    }
-  );
-}
-export {
-  f as TransitionFlowContextual
-};
-//# sourceMappingURL=TransitionFlowContextual.js.map

package/dist/components/Payroll/PayrollFlow/TransitionFlowContextual.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TransitionFlowContextual.js","sources":["../../../../src/components/Payroll/PayrollFlow/TransitionFlowContextual.tsx"],"sourcesContent":["import { TransitionFlow } from '../Transition/TransitionFlow'\nimport type { PayrollFlowContextInterface } from './PayrollFlowComponents'\nimport { useFlow } from '@/components/Flow/useFlow'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/**\n * Adapts the `PayrollFlow` machine context to {@link TransitionFlow}'s props. The resolve/resume\n * lookup that used to live here now lives inside `TransitionPayroll`, so this is a thin bridge.\n *\n * @internal\n */\nexport function TransitionFlowContextual() {\n  const {\n    companyId,\n    transitionStartDate,\n    transitionEndDate,\n    transitionPayScheduleUuid,\n    withReimbursements,\n    onEvent,\n  } = useFlow<PayrollFlowContextInterface>()\n\n  return (\n    <TransitionFlow\n      companyId={ensureRequired(companyId)}\n      startDate={ensureRequired(transitionStartDate)}\n      endDate={ensureRequired(transitionEndDate)}\n      payScheduleUuid={ensureRequired(transitionPayScheduleUuid)}\n      withReimbursements={withReimbursements}\n      onEvent={onEvent}\n    />\n  )\n}\n"],"names":["TransitionFlowContextual","companyId","transitionStartDate","transitionEndDate","transitionPayScheduleUuid","withReimbursements","onEvent","useFlow","jsx","TransitionFlow","ensureRequired"],"mappings":";;;;AAWO,SAASA,IAA2B;AACzC,QAAM;AAAA,IACJ,WAAAC;AAAA,IACA,qBAAAC;AAAA,IACA,mBAAAC;AAAA,IACA,2BAAAC;AAAA,IACA,oBAAAC;AAAA,IACA,SAAAC;AAAA,EAAA,IACEC,EAAA;AAEJ,SACE,gBAAAC;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAeT,CAAS;AAAA,MACnC,WAAWS,EAAeR,CAAmB;AAAA,MAC7C,SAASQ,EAAeP,CAAiB;AAAA,MACzC,iBAAiBO,EAAeN,CAAyB;AAAA,MACzD,oBAAAC;AAAA,MACA,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;"}

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

@@ -1,60 +0,0 @@
-import { jsx as n } from "react/jsx-runtime";
-import { useState as d } from "react";
-import { createMachine as y } from "robot3";
-import { useResolveTransitionPayroll as P } from "../TransitionPayroll/useResolveTransitionPayroll.js";
-import { transitionBreadcrumbsNodes as B, transitionMachine as h } from "./transitionStateMachine.js";
-import { TransitionPayrollContextual as x } from "./TransitionFlowComponents.js";
-import { Flow as T } from "../../Flow/Flow.js";
-import { BaseComponent as v } from "../../Base/Base.js";
-import { useBase as w } from "../../Base/useBase.js";
-import { buildBreadcrumbs as C, updateBreadcrumbs as F } from "../../../helpers/breadcrumbHelpers.js";
-function A(r) {
-  return /* @__PURE__ */ n(v, { ...r, children: /* @__PURE__ */ n(M, { ...r }) });
-}
-function M({
-  companyId: r,
-  startDate: o,
-  endDate: i,
-  payScheduleUuid: t,
-  payrollUuid: m,
-  withReimbursements: a = !0
-}) {
-  const { onEvent: l } = w(), s = P({
-    companyId: r,
-    startDate: o,
-    endDate: i,
-    payScheduleUuid: t
-  }), e = m ?? s, [c] = d(() => {
-    const u = e ? "configuration" : "createTransitionPayroll", f = C(B), p = F(
-      u,
-      { header: { type: "breadcrumbs", breadcrumbs: f } },
-      { startDate: o, endDate: i }
-    );
-    return y(
-      "transitionPayroll",
-      h,
-      (b) => ({
-        ...b,
-        ...p,
-        component: x,
-        companyId: r,
-        startDate: o,
-        endDate: i,
-        payScheduleUuid: t,
-        payrollUuid: e,
-        withReimbursements: a,
-        withOffcyclePayroll: !0,
-        // employeeEditTransition (shared with PayrollFlow via payrollExecutionMachine) reads
-        // ctx.payPeriod for the edit-employee breadcrumb's date range. Regular payrolls get this
-        // from PayrollExecutionFlowContextual's fetch; a transition payroll's pay period is these
-        // same gap dates, so seed it here rather than duplicating a fetch.
-        payPeriod: { startDate: o, endDate: i, payScheduleUuid: t }
-      })
-    );
-  });
-  return /* @__PURE__ */ n(T, { machine: c, onEvent: l });
-}
-export {
-  A as TransitionFlow
-};
-//# sourceMappingURL=TransitionFlow.js.map

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

@@ -1 +0,0 @@
-{"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        // employeeEditTransition (shared with PayrollFlow via payrollExecutionMachine) reads\n        // ctx.payPeriod for the edit-employee breadcrumb's date range. Regular payrolls get this\n        // from PayrollExecutionFlowContextual's fetch; a transition payroll's pay period is these\n        // same gap dates, so seed it here rather than duplicating a fetch.\n        payPeriod: { startDate, endDate, payScheduleUuid },\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;AAAA;AAAA;AAAA;AAAA,QAKrB,WAAW,EAAE,WAAAJ,GAAW,SAAAC,GAAS,iBAAAC,EAAA;AAAA,MAAgB;AAAA,IACnD;AAAA,EAEJ,CAAC;AAED,SAAO,gBAAAN,EAAC0B,GAAA,EAAK,SAAAZ,GAAkB,SAAAL,EAAA,CAAkB;AACnD;"}

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

@@ -1,31 +0,0 @@
-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: t(e),
-      startDate: t(o),
-      endDate: t(r),
-      payScheduleUuid: t(n),
-      payrollUuid: a,
-      withReimbursements: i,
-      onEvent: m
-    }
-  );
-}
-export {
-  f as TransitionPayrollContextual
-};
-//# sourceMappingURL=TransitionFlowComponents.js.map

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

@@ -1 +0,0 @@
-{"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,49 +0,0 @@
-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"
-    }
-  },
-  ...r,
-  configuration: {
-    ...T,
-    parent: "createTransitionPayroll"
-  }
-}, 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 = {
-  transitionPayroll: t(
-    b,
-    s,
-    c,
-    d,
-    m
-  ),
-  ...e
-};
-export {
-  D as transitionBreadcrumbsNodes,
-  B as transitionMachine
-};
-//# sourceMappingURL=transitionStateMachine.js.map

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

@@ -1 +0,0 @@
-{"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/TransitionCreation/TransitionCreation.js

@@ -1,100 +0,0 @@
-import { jsx as t } from "react/jsx-runtime";
-import { useState as P, useCallback as d, useMemo as T } from "react";
-import { useForm as N, FormProvider as B } from "react-hook-form";
-import { zodResolver as V } from "@hookform/resolvers/zod";
-import { useTranslation as q } from "react-i18next";
-import { usePayrollsCreateOffCycleMutation as U } from "@gusto/embedded-api/react-query/payrollsCreateOffCycle";
-import { WithholdingPayPeriod as j, OffCycleReason as z } from "@gusto/embedded-api/models/operations/postv1companiescompanyidpayrolls";
-import { RFCDate as D } from "@gusto/embedded-api/types/rfcdate";
-import { usePaySchedulesGetAllSuspense as G } from "@gusto/embedded-api/react-query/paySchedulesGetAll";
-import { useOffCyclePayPeriodDateValidation as H } from "../OffCyclePayPeriodDateForm/useOffCyclePayPeriodDateValidation.js";
-import { createTransitionCreationSchema as K } from "./TransitionCreationTypes.js";
-import { TransitionCreationPresentation as _ } from "./TransitionCreationPresentation.js";
-import { useCompanyPaymentSpeed as J } from "../../../hooks/useCompanyPaymentSpeed.js";
-import { BaseComponent as L } from "../../Base/Base.js";
-import { useBase as Q } from "../../Base/useBase.js";
-import { useComponentDictionary as X, useI18n as h } from "../../../i18n/I18n.js";
-import { componentEvents as Y } from "../../../shared/constants.js";
-import { SDKInternalError as Z } from "../../../types/sdkError.js";
-import { Form as $ } from "../../Common/Form/Form.js";
-import { toRFCDate as oo } from "../../../helpers/dateFormatting.js";
-function Ro(n) {
-  return /* @__PURE__ */ t(L, { ...n, children: /* @__PURE__ */ t(eo, { ...n }) });
-}
-function eo({
-  dictionary: n,
-  companyId: r,
-  startDate: u,
-  endDate: f,
-  payScheduleUuid: a,
-  className: S
-}) {
-  X("Payroll.TransitionCreation", n), h("Payroll.TransitionCreation"), h("Payroll.OffCycleDeductionsSetting"), h("Payroll.OffCycleTaxWithholding");
-  const { t: l } = q("Payroll.TransitionCreation"), { onEvent: R, baseSubmitHandler: x } = Q(), { paymentSpeedDays: s } = J(r), { minCheckDate: p } = H(s), { mutateAsync: W, isPending: w } = U(), { data: y } = G({ companyId: r }), [c, k] = P({
-    withholdingPayPeriod: j.EveryOtherWeek,
-    withholdingRate: "regular"
-  }), [O, m] = P(!1), E = d(() => {
-    m(!0);
-  }, []), M = d((o) => {
-    k(o), m(!1);
-  }, []), b = d(() => {
-    m(!1);
-  }, []), v = T(() => {
-    const e = (y.payScheduleShowResponse ?? []).find((i) => i.uuid === a);
-    return e?.customName ?? e?.name ?? null;
-  }, [y, a]), F = (o, e) => (
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    l(o, e)
-  ), A = T(
-    () => K(F, p, s),
-    [l, p, s]
-  ), C = N({
-    resolver: V(A),
-    defaultValues: {
-      checkDate: null,
-      skipRegularDeductions: !1
-    }
-  }), I = async (o) => {
-    const { checkDate: e } = o;
-    e && await x(o, async () => {
-      const i = await W({
-        request: {
-          companyId: r,
-          requestBody: {
-            offCycle: !0,
-            offCycleReason: z.TransitionFromOldPaySchedule,
-            startDate: new D(u),
-            endDate: new D(f),
-            checkDate: oo(e),
-            payScheduleUuid: a,
-            skipRegularDeductions: o.skipRegularDeductions,
-            withholdingPayPeriod: c.withholdingPayPeriod,
-            fixedWithholdingRate: c.withholdingRate === "supplemental"
-          }
-        }
-      }), g = i.payrollUnprocessed?.payrollUuid ?? i.payrollUnprocessed?.uuid;
-      if (!g)
-        throw new Z(l("errors.missingPayrollId"));
-      R(Y.TRANSITION_CREATED, { payrollUuid: g });
-    });
-  };
-  return /* @__PURE__ */ t(B, { ...C, children: /* @__PURE__ */ t($, { onSubmit: C.handleSubmit(I), children: /* @__PURE__ */ t(
-    _,
-    {
-      className: S,
-      startDate: u,
-      endDate: f,
-      payScheduleName: v,
-      isPending: w,
-      taxWithholdingConfig: c,
-      isTaxWithholdingModalOpen: O,
-      onTaxWithholdingEditClick: E,
-      onTaxWithholdingModalDone: M,
-      onTaxWithholdingModalCancel: b
-    }
-  ) }) });
-}
-export {
-  Ro as TransitionCreation
-};
-//# sourceMappingURL=TransitionCreation.js.map