@gusto/embedded-react-sdk 0.53.0 → 0.54.0

package/dist/components/Contractor/Payments/CreatePaymentFlow/createPaymentMachine.d.ts

@@ -0,0 +1,8 @@
+import { BreadcrumbNodes } from '../../../Common/FlowBreadcrumbs/FlowBreadcrumbsTypes';
+/** @internal */
+export declare const createPaymentBreadcrumbsNodes: BreadcrumbNodes;
+/** @internal */
+export declare const createPaymentMachine: {
+    createPayment: import('robot3').MachineState<any>;
+    paymentSummary: import('robot3').MachineState<any>;
+};

package/dist/components/Contractor/Payments/CreatePaymentFlow/createPaymentMachine.js

@@ -0,0 +1,63 @@
+import { state as a, transition as m, reduce as r } from "robot3";
+import { PaymentSummaryContextual as o } from "./CreatePaymentFlowComponents.js";
+import { payrollWireEvents as y, componentEvents as c } from "../../../../shared/constants.js";
+import { updateBreadcrumbs as n } from "../../../../helpers/breadcrumbHelpers.js";
+const s = {
+  createPayment: {
+    parent: null,
+    item: {
+      id: "createPayment",
+      label: "breadcrumbLabel",
+      namespace: "Contractor.Payments.CreatePayment",
+      onNavigate: ((e) => ({
+        ...n("createPayment", e)
+      }))
+    }
+  },
+  paymentSummary: {
+    parent: null,
+    item: {
+      id: "paymentSummary",
+      label: "breadcrumbLabel",
+      namespace: "Contractor.Payments.PaymentSummary"
+    }
+  }
+}, d = {
+  createPayment: a(
+    m(
+      c.CONTRACTOR_PAYMENT_CREATED,
+      "paymentSummary",
+      r(
+        (e, t) => ({
+          ...n("paymentSummary", e),
+          component: o,
+          createdPaymentGroupId: t.payload.uuid,
+          alerts: void 0
+        })
+      )
+    )
+  ),
+  paymentSummary: a(
+    m(
+      y.PAYROLL_WIRE_FORM_DONE,
+      "paymentSummary",
+      r(
+        (e, t) => ({
+          ...e,
+          alerts: [
+            {
+              type: "success",
+              title: "wireDetailsSubmitted",
+              content: t.payload.confirmationAlert.content
+            }
+          ]
+        })
+      )
+    )
+  )
+};
+export {
+  s as createPaymentBreadcrumbsNodes,
+  d as createPaymentMachine
+};
+//# sourceMappingURL=createPaymentMachine.js.map

package/dist/components/Contractor/Payments/CreatePaymentFlow/createPaymentMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPaymentMachine.js","sources":["../../../../../src/components/Contractor/Payments/CreatePaymentFlow/createPaymentMachine.ts"],"sourcesContent":["import { reduce, state, transition } from 'robot3'\nimport type { ContractorPaymentGroup } from '@gusto/embedded-api/models/components/contractorpaymentgroup'\nimport type { WireInRequest } from '@gusto/embedded-api/models/components/wireinrequest'\nimport {\n  PaymentSummaryContextual,\n  type CreatePaymentFlowContextInterface,\n} from './CreatePaymentFlowComponents'\nimport { payrollWireEvents, componentEvents } from '@/shared/constants'\nimport type { MachineEventType, MachineTransition } from '@/types/Helpers'\nimport { updateBreadcrumbs } from '@/helpers/breadcrumbHelpers'\nimport type { BreadcrumbNodes } from '@/components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\n\ntype EventPayloads = {\n  [componentEvents.CONTRACTOR_PAYMENT_CREATED]: ContractorPaymentGroup\n  [payrollWireEvents.PAYROLL_WIRE_FORM_DONE]: {\n    wireInRequest: WireInRequest\n    confirmationAlert: {\n      title: string\n      content?: string\n    }\n  }\n}\n\n/** @internal */\nexport const createPaymentBreadcrumbsNodes: BreadcrumbNodes = {\n  createPayment: {\n    parent: null,\n    item: {\n      id: 'createPayment',\n      label: 'breadcrumbLabel',\n      namespace: 'Contractor.Payments.CreatePayment',\n      onNavigate: ((ctx: CreatePaymentFlowContextInterface) => ({\n        ...updateBreadcrumbs('createPayment', ctx),\n      })) as (context: unknown) => unknown,\n    },\n  },\n  paymentSummary: {\n    parent: null,\n    item: {\n      id: 'paymentSummary',\n      label: 'breadcrumbLabel',\n      namespace: 'Contractor.Payments.PaymentSummary',\n    },\n  },\n}\n\n/** @internal */\nexport const createPaymentMachine = {\n  createPayment: state<MachineTransition>(\n    transition(\n      componentEvents.CONTRACTOR_PAYMENT_CREATED,\n      'paymentSummary',\n      reduce(\n        (\n          ctx: CreatePaymentFlowContextInterface,\n          ev: MachineEventType<EventPayloads, typeof componentEvents.CONTRACTOR_PAYMENT_CREATED>,\n        ): CreatePaymentFlowContextInterface => {\n          return {\n            ...updateBreadcrumbs('paymentSummary', ctx),\n            component: PaymentSummaryContextual,\n            createdPaymentGroupId: ev.payload.uuid,\n            alerts: undefined,\n          }\n        },\n      ),\n    ),\n  ),\n  paymentSummary: state<MachineTransition>(\n    transition(\n      payrollWireEvents.PAYROLL_WIRE_FORM_DONE,\n      'paymentSummary',\n      reduce(\n        (\n          ctx: CreatePaymentFlowContextInterface,\n          ev: MachineEventType<EventPayloads, typeof payrollWireEvents.PAYROLL_WIRE_FORM_DONE>,\n        ): CreatePaymentFlowContextInterface => {\n          return {\n            ...ctx,\n            alerts: [\n              {\n                type: 'success',\n                title: 'wireDetailsSubmitted',\n                content: ev.payload.confirmationAlert.content,\n              },\n            ],\n          }\n        },\n      ),\n    ),\n  ),\n}\n"],"names":["createPaymentBreadcrumbsNodes","ctx","updateBreadcrumbs","createPaymentMachine","state","transition","componentEvents","reduce","ev","PaymentSummaryContextual","payrollWireEvents"],"mappings":";;;;AAwBO,MAAMA,IAAiD;AAAA,EAC5D,eAAe;AAAA,IACb,QAAQ;AAAA,IACR,MAAM;AAAA,MACJ,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,WAAW;AAAA,MACX,aAAa,CAACC,OAA4C;AAAA,QACxD,GAAGC,EAAkB,iBAAiBD,CAAG;AAAA,MAAA;AAAA,IAC3C;AAAA,EACF;AAAA,EAEF,gBAAgB;AAAA,IACd,QAAQ;AAAA,IACR,MAAM;AAAA,MACJ,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,WAAW;AAAA,IAAA;AAAA,EACb;AAEJ,GAGaE,IAAuB;AAAA,EAClC,eAAeC;AAAA,IACbC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CACEN,GACAO,OAEO;AAAA,UACL,GAAGN,EAAkB,kBAAkBD,CAAG;AAAA,UAC1C,WAAWQ;AAAA,UACX,uBAAuBD,EAAG,QAAQ;AAAA,UAClC,QAAQ;AAAA,QAAA;AAAA,MAEZ;AAAA,IACF;AAAA,EACF;AAAA,EAEF,gBAAgBJ;AAAA,IACdC;AAAA,MACEK,EAAkB;AAAA,MAClB;AAAA,MACAH;AAAA,QACE,CACEN,GACAO,OAEO;AAAA,UACL,GAAGP;AAAA,UACH,QAAQ;AAAA,YACN;AAAA,cACE,MAAM;AAAA,cACN,OAAO;AAAA,cACP,SAASO,EAAG,QAAQ,kBAAkB;AAAA,YAAA;AAAA,UACxC;AAAA,QACF;AAAA,MAEJ;AAAA,IACF;AAAA,EACF;AAEJ;"}

package/dist/components/Contractor/Payments/CreatePaymentFlow/createPaymentMachine.test.d.ts

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

package/dist/components/Contractor/Payments/CreatePaymentFlow/index.d.ts

@@ -0,0 +1,2 @@
+export { CreatePaymentFlow } from './CreatePaymentFlow';
+export type { CreatePaymentFlowProps } from './CreatePaymentFlowComponents';

package/dist/components/Contractor/Payments/HistoricalPaymentAmounts/HistoricalPaymentAmounts.d.ts

@@ -0,0 +1,33 @@
+import { BaseComponentInterface } from '../../../Base';
+/**
+ * Props for {@link HistoricalPaymentAmounts}.
+ *
+ * @alpha
+ */
+export interface HistoricalPaymentAmountsProps extends BaseComponentInterface<'Contractor.Payments.HistoricalPaymentAmounts'> {
+    /** UUID of the company recording the historical payment. */
+    companyId: string;
+    /** UUIDs of the contractors selected on the previous step. */
+    contractorIds: string[];
+    /** The check date selected on the previous step, as a `YYYY-MM-DD` string. */
+    checkDate: string;
+}
+/**
+ * Second step of the historical contractor payment flow: enter hours, wages, bonuses, and
+ * reimbursements for the contractors selected on the previous step.
+ *
+ * @remarks
+ * Every contractor payment is fixed to the `Historical Payment` payment method — there is no
+ * funds movement, so no payment method choice or debit information is shown. Continue is
+ * disabled until at least one contractor has a payment total greater than zero.
+ *
+ * @events
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `contractor/historicalPayments/amountsSubmitted` | The user entered amounts and clicked Continue. | `{ checkDate: string, contractorPayments: ContractorPayments[] }` |
+ *
+ * @param props - See {@link HistoricalPaymentAmountsProps}.
+ * @returns The rendered payment-amounts entry screen.
+ * @alpha
+ */
+export declare function HistoricalPaymentAmounts(props: HistoricalPaymentAmountsProps): import("react").JSX.Element;

package/dist/components/Contractor/Payments/HistoricalPaymentAmounts/HistoricalPaymentAmounts.js

@@ -0,0 +1,62 @@
+import { jsx as t, jsxs as e } from "react/jsx-runtime";
+import { useContractorsListSuspense as M } from "@gusto/embedded-api/react-query/contractorsList";
+import { useTranslation as E } from "react-i18next";
+import { usePaymentAmountsEditor as _ } from "../shared/usePaymentAmountsEditor.js";
+import { useHistoricalPaymentAmountsDictionary as g } from "./useFormDictionary.js";
+import { Flex as i, FlexItem as O } from "../../../Common/Flex/Flex.js";
+import { BaseComponent as S } from "../../../Base/Base.js";
+import "../../../Base/useBase.js";
+import { useComponentContext as I } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { useI18n as L, useComponentDictionary as N } from "../../../../i18n/I18n.js";
+import { componentEvents as v } from "../../../../shared/constants.js";
+import { SetPaymentAmounts as B } from "../shared/SetPaymentAmounts/SetPaymentAmounts.js";
+const l = ["Historical Payment"];
+function K(o) {
+  return /* @__PURE__ */ t(S, { ...o, componentName: "Contractor.Payments.HistoricalPaymentAmounts", children: /* @__PURE__ */ t(R, { ...o }) });
+}
+function R({
+  companyId: o,
+  contractorIds: d,
+  checkDate: p,
+  dictionary: y,
+  onEvent: f
+}) {
+  L("Contractor.Payments.HistoricalPaymentAmounts"), N("Contractor.Payments.HistoricalPaymentAmounts", y);
+  const { t: n } = E("Contractor.Payments.HistoricalPaymentAmounts"), { Heading: P, Text: C, Button: h } = I(), A = g(), { data: T } = M({ companyUuid: o }), a = (T.contractors || []).filter(
+    (r) => d.includes(r.uuid)
+  ), { virtualContractorPayments: s, totals: m, editModal: x } = _({
+    contractors: a,
+    allowedPaymentMethods: l
+  }), c = m.total > 0, H = () => {
+    if (!c) return;
+    const r = s.filter((u) => u.isTouched).map(({ isTouched: u, ...D }) => D);
+    f(v.CONTRACTOR_HISTORICAL_PAYMENT_AMOUNTS_SUBMITTED, {
+      checkDate: p,
+      contractorPayments: r
+    });
+  };
+  return /* @__PURE__ */ e(i, { flexDirection: "column", gap: 32, children: [
+    /* @__PURE__ */ e(i, { justifyContent: "flex-end", gap: 16, children: [
+      /* @__PURE__ */ e(i, { flexDirection: "column", gap: 4, children: [
+        /* @__PURE__ */ t(P, { as: "h2", children: n("heading") }),
+        /* @__PURE__ */ t(C, { variant: "supporting", children: n("subtitle") })
+      ] }),
+      /* @__PURE__ */ t(O, { children: /* @__PURE__ */ t(h, { onClick: H, variant: "primary", isDisabled: !c, children: n("continueButton") }) })
+    ] }),
+    /* @__PURE__ */ t(
+      B,
+      {
+        contractors: a,
+        contractorPayments: s,
+        totals: m,
+        allowedPaymentMethods: l,
+        editModal: x,
+        dictionary: A
+      }
+    )
+  ] });
+}
+export {
+  K as HistoricalPaymentAmounts
+};
+//# sourceMappingURL=HistoricalPaymentAmounts.js.map

package/dist/components/Contractor/Payments/HistoricalPaymentAmounts/HistoricalPaymentAmounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoricalPaymentAmounts.js","sources":["../../../../../src/components/Contractor/Payments/HistoricalPaymentAmounts/HistoricalPaymentAmounts.tsx"],"sourcesContent":["import { useContractorsListSuspense } from '@gusto/embedded-api/react-query/contractorsList'\nimport { useTranslation } from 'react-i18next'\nimport type { PostV1CompaniesCompanyIdContractorPaymentGroupsPaymentMethod as ContractorPaymentMethod } from '@gusto/embedded-api/models/operations/postv1companiescompanyidcontractorpaymentgroups'\nimport { usePaymentAmountsEditor } from '../shared/usePaymentAmountsEditor'\nimport { SetPaymentAmounts } from '../shared/SetPaymentAmounts'\nimport { useHistoricalPaymentAmountsDictionary } from './useFormDictionary'\nimport { Flex, FlexItem } from '@/components/Common'\nimport { BaseComponent, type BaseComponentInterface } from '@/components/Base'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\n\nconst ALLOWED_PAYMENT_METHODS: ContractorPaymentMethod[] = ['Historical Payment']\n\n/**\n * Props for {@link HistoricalPaymentAmounts}.\n *\n * @alpha\n */\nexport interface HistoricalPaymentAmountsProps extends BaseComponentInterface<'Contractor.Payments.HistoricalPaymentAmounts'> {\n  /** UUID of the company recording the historical payment. */\n  companyId: string\n  /** UUIDs of the contractors selected on the previous step. */\n  contractorIds: string[]\n  /** The check date selected on the previous step, as a `YYYY-MM-DD` string. */\n  checkDate: string\n}\n\n/**\n * Second step of the historical contractor payment flow: enter hours, wages, bonuses, and\n * reimbursements for the contractors selected on the previous step.\n *\n * @remarks\n * Every contractor payment is fixed to the `Historical Payment` payment method — there is no\n * funds movement, so no payment method choice or debit information is shown. Continue is\n * disabled until at least one contractor has a payment total greater than zero.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/historicalPayments/amountsSubmitted` | The user entered amounts and clicked Continue. | `{ checkDate: string, contractorPayments: ContractorPayments[] }` |\n *\n * @param props - See {@link HistoricalPaymentAmountsProps}.\n * @returns The rendered payment-amounts entry screen.\n * @alpha\n */\nexport function HistoricalPaymentAmounts(props: HistoricalPaymentAmountsProps) {\n  return (\n    <BaseComponent {...props} componentName=\"Contractor.Payments.HistoricalPaymentAmounts\">\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({\n  companyId,\n  contractorIds,\n  checkDate,\n  dictionary,\n  onEvent,\n}: HistoricalPaymentAmountsProps) {\n  useI18n('Contractor.Payments.HistoricalPaymentAmounts')\n  useComponentDictionary('Contractor.Payments.HistoricalPaymentAmounts', dictionary)\n  const { t } = useTranslation('Contractor.Payments.HistoricalPaymentAmounts')\n  const { Heading, Text, Button } = useComponentContext()\n  const paymentAmountsDictionary = useHistoricalPaymentAmountsDictionary()\n\n  const { data: contractorList } = useContractorsListSuspense({ companyUuid: companyId })\n  const contractors = (contractorList.contractors || []).filter(contractor =>\n    contractorIds.includes(contractor.uuid),\n  )\n\n  const { virtualContractorPayments, totals, editModal } = usePaymentAmountsEditor({\n    contractors,\n    allowedPaymentMethods: ALLOWED_PAYMENT_METHODS,\n  })\n\n  const canContinue = totals.total > 0\n\n  const handleContinue = () => {\n    if (!canContinue) return\n\n    const contractorPayments = virtualContractorPayments\n      .filter(payment => payment.isTouched)\n      .map(({ isTouched: _isTouched, ...rest }) => rest)\n\n    onEvent(componentEvents.CONTRACTOR_HISTORICAL_PAYMENT_AMOUNTS_SUBMITTED, {\n      checkDate,\n      contractorPayments,\n    })\n  }\n\n  return (\n    <Flex flexDirection=\"column\" gap={32}>\n      <Flex justifyContent=\"flex-end\" gap={16}>\n        <Flex flexDirection=\"column\" gap={4}>\n          <Heading as=\"h2\">{t('heading')}</Heading>\n          <Text variant=\"supporting\">{t('subtitle')}</Text>\n        </Flex>\n        <FlexItem>\n          <Button onClick={handleContinue} variant=\"primary\" isDisabled={!canContinue}>\n            {t('continueButton')}\n          </Button>\n        </FlexItem>\n      </Flex>\n\n      <SetPaymentAmounts\n        contractors={contractors}\n        contractorPayments={virtualContractorPayments}\n        totals={totals}\n        allowedPaymentMethods={ALLOWED_PAYMENT_METHODS}\n        editModal={editModal}\n        dictionary={paymentAmountsDictionary}\n      />\n    </Flex>\n  )\n}\n"],"names":["ALLOWED_PAYMENT_METHODS","HistoricalPaymentAmounts","props","jsx","BaseComponent","Root","companyId","contractorIds","checkDate","dictionary","onEvent","useI18n","useComponentDictionary","t","useTranslation","Heading","Text","Button","useComponentContext","paymentAmountsDictionary","useHistoricalPaymentAmountsDictionary","contractorList","useContractorsListSuspense","contractors","contractor","virtualContractorPayments","totals","editModal","usePaymentAmountsEditor","canContinue","handleContinue","contractorPayments","payment","_isTouched","rest","componentEvents","jsxs","Flex","FlexItem","SetPaymentAmounts"],"mappings":";;;;;;;;;;;;AAYA,MAAMA,IAAqD,CAAC,oBAAoB;AAkCzE,SAASC,EAAyBC,GAAsC;AAC7E,SACE,gBAAAC,EAACC,GAAA,EAAe,GAAGF,GAAO,eAAc,gDACtC,UAAA,gBAAAC,EAACE,GAAA,EAAM,GAAGH,EAAA,CAAO,EAAA,CACnB;AAEJ;AAEA,SAASG,EAAK;AAAA,EACZ,WAAAC;AAAA,EACA,eAAAC;AAAA,EACA,WAAAC;AAAA,EACA,YAAAC;AAAA,EACA,SAAAC;AACF,GAAkC;AAChC,EAAAC,EAAQ,8CAA8C,GACtDC,EAAuB,gDAAgDH,CAAU;AACjF,QAAM,EAAE,GAAAI,EAAA,IAAMC,EAAe,8CAA8C,GACrE,EAAE,SAAAC,GAAS,MAAAC,GAAM,QAAAC,EAAA,IAAWC,EAAA,GAC5BC,IAA2BC,EAAA,GAE3B,EAAE,MAAMC,EAAA,IAAmBC,EAA2B,EAAE,aAAahB,GAAW,GAChFiB,KAAeF,EAAe,eAAe,CAAA,GAAI;AAAA,IAAO,CAAAG,MAC5DjB,EAAc,SAASiB,EAAW,IAAI;AAAA,EAAA,GAGlC,EAAE,2BAAAC,GAA2B,QAAAC,GAAQ,WAAAC,EAAA,IAAcC,EAAwB;AAAA,IAC/E,aAAAL;AAAA,IACA,uBAAuBvB;AAAA,EAAA,CACxB,GAEK6B,IAAcH,EAAO,QAAQ,GAE7BI,IAAiB,MAAM;AAC3B,QAAI,CAACD,EAAa;AAElB,UAAME,IAAqBN,EACxB,OAAO,CAAAO,MAAWA,EAAQ,SAAS,EACnC,IAAI,CAAC,EAAE,WAAWC,GAAY,GAAGC,EAAA,MAAWA,CAAI;AAEnD,IAAAxB,EAAQyB,EAAgB,iDAAiD;AAAA,MACvE,WAAA3B;AAAA,MACA,oBAAAuB;AAAA,IAAA,CACD;AAAA,EACH;AAEA,SACE,gBAAAK,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,IAChC,UAAA;AAAA,IAAA,gBAAAD,EAACC,GAAA,EAAK,gBAAe,YAAW,KAAK,IACnC,UAAA;AAAA,MAAA,gBAAAD,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,QAAA,gBAAAlC,EAACY,GAAA,EAAQ,IAAG,MAAM,UAAAF,EAAE,SAAS,GAAE;AAAA,0BAC9BG,GAAA,EAAK,SAAQ,cAAc,UAAAH,EAAE,UAAU,EAAA,CAAE;AAAA,MAAA,GAC5C;AAAA,MACA,gBAAAV,EAACmC,GAAA,EACC,UAAA,gBAAAnC,EAACc,GAAA,EAAO,SAASa,GAAgB,SAAQ,WAAU,YAAY,CAACD,GAC7D,UAAAhB,EAAE,gBAAgB,GACrB,EAAA,CACF;AAAA,IAAA,GACF;AAAA,IAEA,gBAAAV;AAAA,MAACoC;AAAA,MAAA;AAAA,QACC,aAAAhB;AAAA,QACA,oBAAoBE;AAAA,QACpB,QAAAC;AAAA,QACA,uBAAuB1B;AAAA,QACvB,WAAA2B;AAAA,QACA,YAAYR;AAAA,MAAA;AAAA,IAAA;AAAA,EACd,GACF;AAEJ;"}

package/dist/components/Contractor/Payments/HistoricalPaymentAmounts/index.d.ts

@@ -0,0 +1 @@
+export { HistoricalPaymentAmounts, type HistoricalPaymentAmountsProps, } from './HistoricalPaymentAmounts';

package/dist/components/Contractor/Payments/HistoricalPaymentAmounts/useFormDictionary.d.ts

@@ -0,0 +1,9 @@
+import { SetPaymentAmountsDictionary } from '../shared/SetPaymentAmounts';
+/**
+ * Resolves `SetPaymentAmounts`'s text against `HistoricalPaymentAmounts`'s own
+ * `Contractor.Payments.HistoricalPaymentAmounts` namespace, so partner
+ * overrides on that namespace flow into the shared grid and edit modal.
+ *
+ * @internal
+ */
+export declare function useHistoricalPaymentAmountsDictionary(): SetPaymentAmountsDictionary;

package/dist/components/Contractor/Payments/HistoricalPaymentAmounts/useFormDictionary.js

@@ -0,0 +1,53 @@
+import { useMemo as r } from "react";
+import { useTranslation as o } from "react-i18next";
+function s() {
+  const { t } = o("Contractor.Payments.HistoricalPaymentAmounts");
+  return r(
+    () => ({
+      hoursAndPaymentsLabel: t("hoursAndPaymentsLabel"),
+      contractorTableHeaders: {
+        contractor: t("contractorTableHeaders.contractor"),
+        wageType: t("contractorTableHeaders.wageType"),
+        paymentMethod: t("contractorTableHeaders.paymentMethod"),
+        hours: t("contractorTableHeaders.hours"),
+        wage: t("contractorTableHeaders.wage"),
+        bonus: t("contractorTableHeaders.bonus"),
+        reimbursement: t("contractorTableHeaders.reimbursement"),
+        total: t("contractorTableHeaders.total")
+      },
+      emptyTableTitle: t("emptyTableTitle"),
+      emptyTableDescription: t("emptyTableDescription"),
+      na: t("na"),
+      totalsLabel: t("totalsLabel"),
+      editContractor: t("editContractor"),
+      perHour: t("perHour"),
+      editContractorPayment: {
+        title: t("editContractorPayment.title"),
+        subtitle: t("editContractorPayment.subtitle"),
+        hoursLabel: t("editContractorPayment.hoursLabel"),
+        hoursAdornment: t("editContractorPayment.hoursAdornment"),
+        hoursPayDescription: (e, a) => t("editContractorPayment.hoursPayDescription", { rate: e, total: a }),
+        wageLabel: t("editContractorPayment.wageLabel"),
+        bonusLabel: t("editContractorPayment.bonusLabel"),
+        reimbursementLabel: t("editContractorPayment.reimbursementLabel"),
+        paymentMethodLabel: t("editContractorPayment.paymentMethodLabel"),
+        cancelCta: t("editContractorPayment.cancelCta"),
+        saveCta: t("editContractorPayment.saveCta"),
+        paymentMethods: {
+          check: t("editContractorPayment.paymentMethods.check"),
+          directDeposit: t("editContractorPayment.paymentMethods.directDeposit"),
+          historicalPayment: t("editContractorPayment.paymentMethods.historicalPayment")
+        },
+        errors: {
+          directDepositNotAvailable: t("editContractorPayment.errors.directDepositNotAvailable"),
+          unsupportedPaymentMethod: t("editContractorPayment.errors.unsupportedPaymentMethod")
+        }
+      }
+    }),
+    [t]
+  );
+}
+export {
+  s as useHistoricalPaymentAmountsDictionary
+};
+//# sourceMappingURL=useFormDictionary.js.map

package/dist/components/Contractor/Payments/HistoricalPaymentAmounts/useFormDictionary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormDictionary.js","sources":["../../../../../src/components/Contractor/Payments/HistoricalPaymentAmounts/useFormDictionary.ts"],"sourcesContent":["import { useMemo } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport type { SetPaymentAmountsDictionary } from '../shared/SetPaymentAmounts'\n\n/**\n * Resolves `SetPaymentAmounts`'s text against `HistoricalPaymentAmounts`'s own\n * `Contractor.Payments.HistoricalPaymentAmounts` namespace, so partner\n * overrides on that namespace flow into the shared grid and edit modal.\n *\n * @internal\n */\nexport function useHistoricalPaymentAmountsDictionary(): SetPaymentAmountsDictionary {\n  const { t } = useTranslation('Contractor.Payments.HistoricalPaymentAmounts')\n\n  return useMemo<SetPaymentAmountsDictionary>(\n    () => ({\n      hoursAndPaymentsLabel: t('hoursAndPaymentsLabel'),\n      contractorTableHeaders: {\n        contractor: t('contractorTableHeaders.contractor'),\n        wageType: t('contractorTableHeaders.wageType'),\n        paymentMethod: t('contractorTableHeaders.paymentMethod'),\n        hours: t('contractorTableHeaders.hours'),\n        wage: t('contractorTableHeaders.wage'),\n        bonus: t('contractorTableHeaders.bonus'),\n        reimbursement: t('contractorTableHeaders.reimbursement'),\n        total: t('contractorTableHeaders.total'),\n      },\n      emptyTableTitle: t('emptyTableTitle'),\n      emptyTableDescription: t('emptyTableDescription'),\n      na: t('na'),\n      totalsLabel: t('totalsLabel'),\n      editContractor: t('editContractor'),\n      perHour: t('perHour'),\n      editContractorPayment: {\n        title: t('editContractorPayment.title'),\n        subtitle: t('editContractorPayment.subtitle'),\n        hoursLabel: t('editContractorPayment.hoursLabel'),\n        hoursAdornment: t('editContractorPayment.hoursAdornment'),\n        hoursPayDescription: (rate, total) =>\n          t('editContractorPayment.hoursPayDescription', { rate, total }),\n        wageLabel: t('editContractorPayment.wageLabel'),\n        bonusLabel: t('editContractorPayment.bonusLabel'),\n        reimbursementLabel: t('editContractorPayment.reimbursementLabel'),\n        paymentMethodLabel: t('editContractorPayment.paymentMethodLabel'),\n        cancelCta: t('editContractorPayment.cancelCta'),\n        saveCta: t('editContractorPayment.saveCta'),\n        paymentMethods: {\n          check: t('editContractorPayment.paymentMethods.check'),\n          directDeposit: t('editContractorPayment.paymentMethods.directDeposit'),\n          historicalPayment: t('editContractorPayment.paymentMethods.historicalPayment'),\n        },\n        errors: {\n          directDepositNotAvailable: t('editContractorPayment.errors.directDepositNotAvailable'),\n          unsupportedPaymentMethod: t('editContractorPayment.errors.unsupportedPaymentMethod'),\n        },\n      },\n    }),\n    [t],\n  )\n}\n"],"names":["useHistoricalPaymentAmountsDictionary","useTranslation","useMemo","rate","total"],"mappings":";;AAWO,SAASA,IAAqE;AACnF,QAAM,EAAE,EAAA,IAAMC,EAAe,8CAA8C;AAE3E,SAAOC;AAAA,IACL,OAAO;AAAA,MACL,uBAAuB,EAAE,uBAAuB;AAAA,MAChD,wBAAwB;AAAA,QACtB,YAAY,EAAE,mCAAmC;AAAA,QACjD,UAAU,EAAE,iCAAiC;AAAA,QAC7C,eAAe,EAAE,sCAAsC;AAAA,QACvD,OAAO,EAAE,8BAA8B;AAAA,QACvC,MAAM,EAAE,6BAA6B;AAAA,QACrC,OAAO,EAAE,8BAA8B;AAAA,QACvC,eAAe,EAAE,sCAAsC;AAAA,QACvD,OAAO,EAAE,8BAA8B;AAAA,MAAA;AAAA,MAEzC,iBAAiB,EAAE,iBAAiB;AAAA,MACpC,uBAAuB,EAAE,uBAAuB;AAAA,MAChD,IAAI,EAAE,IAAI;AAAA,MACV,aAAa,EAAE,aAAa;AAAA,MAC5B,gBAAgB,EAAE,gBAAgB;AAAA,MAClC,SAAS,EAAE,SAAS;AAAA,MACpB,uBAAuB;AAAA,QACrB,OAAO,EAAE,6BAA6B;AAAA,QACtC,UAAU,EAAE,gCAAgC;AAAA,QAC5C,YAAY,EAAE,kCAAkC;AAAA,QAChD,gBAAgB,EAAE,sCAAsC;AAAA,QACxD,qBAAqB,CAACC,GAAMC,MAC1B,EAAE,6CAA6C,EAAE,MAAAD,GAAM,OAAAC,GAAO;AAAA,QAChE,WAAW,EAAE,iCAAiC;AAAA,QAC9C,YAAY,EAAE,kCAAkC;AAAA,QAChD,oBAAoB,EAAE,0CAA0C;AAAA,QAChE,oBAAoB,EAAE,0CAA0C;AAAA,QAChE,WAAW,EAAE,iCAAiC;AAAA,QAC9C,SAAS,EAAE,+BAA+B;AAAA,QAC1C,gBAAgB;AAAA,UACd,OAAO,EAAE,4CAA4C;AAAA,UACrD,eAAe,EAAE,oDAAoD;AAAA,UACrE,mBAAmB,EAAE,wDAAwD;AAAA,QAAA;AAAA,QAE/E,QAAQ;AAAA,UACN,2BAA2B,EAAE,wDAAwD;AAAA,UACrF,0BAA0B,EAAE,uDAAuD;AAAA,QAAA;AAAA,MACrF;AAAA,IACF;AAAA,IAEF,CAAC,CAAC;AAAA,EAAA;AAEN;"}

package/dist/components/Contractor/Payments/HistoricalPaymentContractors/HistoricalPaymentContractors.d.ts

@@ -0,0 +1,27 @@
+import { BaseComponentInterface } from '../../../Base';
+/**
+ * Props for {@link HistoricalPaymentContractors}.
+ *
+ * @alpha
+ */
+export interface HistoricalPaymentContractorsProps extends BaseComponentInterface<'Contractor.Payments.HistoricalPaymentContractors'> {
+    /** UUID of the company recording the historical payment. */
+    companyId: string;
+}
+/**
+ * First step of the historical contractor payment flow: pick a check date and the contractors being paid.
+ *
+ * @remarks
+ * The check date is bounded to the current tax year (plus the prior year during the Jan 1–8, 3PM MST
+ * grace window) and can never be in the future.
+ *
+ * @events
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `contractor/historicalPayments/contractorsSelected` | The user picked a check date and contractors, then clicked Continue. | `{ contractorIds: string[], checkDate: string }` |
+ *
+ * @param props - See {@link HistoricalPaymentContractorsProps}.
+ * @returns The rendered check-date and contractor-selection screen.
+ * @alpha
+ */
+export declare function HistoricalPaymentContractors(props: HistoricalPaymentContractorsProps): import("react").JSX.Element;

package/dist/components/Contractor/Payments/HistoricalPaymentContractors/HistoricalPaymentContractors.js

@@ -0,0 +1,56 @@
+import { jsx as e, jsxs as s } from "react/jsx-runtime";
+import { useState as m, useMemo as D } from "react";
+import { useTranslation as g } from "react-i18next";
+import { SelectContractors as P } from "../../shared/SelectContractors/SelectContractors.js";
+import { getHistoricalPaymentCheckDateBounds as T } from "../shared/historicalPaymentDateBounds.js";
+import { formatDateToStringDate as x } from "../../../../helpers/dateFormatting.js";
+import { Flex as u } from "../../../Common/Flex/Flex.js";
+import { ActionsLayout as E } from "../../../Common/ActionsLayout/ActionsLayout.js";
+import { BaseComponent as H } from "../../../Base/Base.js";
+import "../../../Base/useBase.js";
+import { useComponentContext as I } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { useI18n as S, useComponentDictionary as R } from "../../../../i18n/I18n.js";
+import { componentEvents as k } from "../../../../shared/constants.js";
+function z(r) {
+  return /* @__PURE__ */ e(H, { ...r, componentName: "Contractor.Payments.HistoricalPaymentContractors", children: /* @__PURE__ */ e(v, { ...r }) });
+}
+function v({ companyId: r, dictionary: C, onEvent: d }) {
+  S("Contractor.Payments.HistoricalPaymentContractors"), R("Contractor.Payments.HistoricalPaymentContractors", C);
+  const { t: o } = g("Contractor.Payments.HistoricalPaymentContractors"), a = I(), [l, p] = m([]), [t, f] = m(null), { minDate: i, maxDate: c } = D(() => T(), []);
+  let n = null;
+  t !== null && t > c ? n = o("dateInFutureError") : t !== null && t < i && (n = o("dateTooEarlyError", {
+    year: t.getFullYear(),
+    allowedYear: i.getFullYear()
+  }));
+  const h = l.length > 0 && t !== null && n === null, y = () => {
+    t === null || n !== null || d(k.CONTRACTOR_HISTORICAL_PAYMENT_CONTRACTORS_SELECTED, {
+      contractorIds: l,
+      checkDate: x(t)
+    });
+  };
+  return /* @__PURE__ */ s(u, { flexDirection: "column", gap: 32, children: [
+    /* @__PURE__ */ s(u, { flexDirection: "column", gap: 4, children: [
+      /* @__PURE__ */ e(a.Heading, { as: "h2", children: o("heading") }),
+      /* @__PURE__ */ e(a.Text, { variant: "supporting", children: o("subtitle") })
+    ] }),
+    /* @__PURE__ */ e(
+      a.DatePicker,
+      {
+        label: o("dateLabel"),
+        isRequired: !0,
+        value: t,
+        onChange: f,
+        minDate: i,
+        maxDate: c,
+        isInvalid: n !== null,
+        errorMessage: n ?? void 0
+      }
+    ),
+    /* @__PURE__ */ e(P, { companyId: r, onSelectionChange: p }),
+    /* @__PURE__ */ e(E, { children: /* @__PURE__ */ e(a.Button, { onClick: y, isDisabled: !h, children: o("continueButton") }) })
+  ] });
+}
+export {
+  z as HistoricalPaymentContractors
+};
+//# sourceMappingURL=HistoricalPaymentContractors.js.map

package/dist/components/Contractor/Payments/HistoricalPaymentContractors/HistoricalPaymentContractors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoricalPaymentContractors.js","sources":["../../../../../src/components/Contractor/Payments/HistoricalPaymentContractors/HistoricalPaymentContractors.tsx"],"sourcesContent":["import { useMemo, useState } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport { SelectContractors } from '@/components/Contractor/shared/SelectContractors/SelectContractors'\nimport { getHistoricalPaymentCheckDateBounds } from '@/components/Contractor/Payments/shared/historicalPaymentDateBounds'\nimport { formatDateToStringDate } from '@/helpers/dateFormatting'\nimport { ActionsLayout, Flex } from '@/components/Common'\nimport { BaseComponent, type BaseComponentInterface } from '@/components/Base'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\n\n/**\n * Props for {@link HistoricalPaymentContractors}.\n *\n * @alpha\n */\nexport interface HistoricalPaymentContractorsProps extends BaseComponentInterface<'Contractor.Payments.HistoricalPaymentContractors'> {\n  /** UUID of the company recording the historical payment. */\n  companyId: string\n}\n\n/**\n * First step of the historical contractor payment flow: pick a check date and the contractors being paid.\n *\n * @remarks\n * The check date is bounded to the current tax year (plus the prior year during the Jan 1–8, 3PM MST\n * grace window) and can never be in the future.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/historicalPayments/contractorsSelected` | The user picked a check date and contractors, then clicked Continue. | `{ contractorIds: string[], checkDate: string }` |\n *\n * @param props - See {@link HistoricalPaymentContractorsProps}.\n * @returns The rendered check-date and contractor-selection screen.\n * @alpha\n */\nexport function HistoricalPaymentContractors(props: HistoricalPaymentContractorsProps) {\n  return (\n    <BaseComponent {...props} componentName=\"Contractor.Payments.HistoricalPaymentContractors\">\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({ companyId, dictionary, onEvent }: HistoricalPaymentContractorsProps) {\n  useI18n('Contractor.Payments.HistoricalPaymentContractors')\n  useComponentDictionary('Contractor.Payments.HistoricalPaymentContractors', dictionary)\n  const { t } = useTranslation('Contractor.Payments.HistoricalPaymentContractors')\n  const Components = useComponentContext()\n\n  const [selectedIds, setSelectedIds] = useState<string[]>([])\n  const [checkDate, setCheckDate] = useState<Date | null>(null)\n\n  const { minDate, maxDate } = useMemo(() => getHistoricalPaymentCheckDateBounds(), [])\n\n  let dateError: string | null = null\n  if (checkDate !== null && checkDate > maxDate) {\n    dateError = t('dateInFutureError')\n  } else if (checkDate !== null && checkDate < minDate) {\n    dateError = t('dateTooEarlyError', {\n      year: checkDate.getFullYear(),\n      allowedYear: minDate.getFullYear(),\n    })\n  }\n\n  const canContinue = selectedIds.length > 0 && checkDate !== null && dateError === null\n\n  const handleContinue = () => {\n    if (checkDate === null || dateError !== null) return\n    onEvent(componentEvents.CONTRACTOR_HISTORICAL_PAYMENT_CONTRACTORS_SELECTED, {\n      contractorIds: selectedIds,\n      checkDate: formatDateToStringDate(checkDate),\n    })\n  }\n\n  return (\n    <Flex flexDirection=\"column\" gap={32}>\n      <Flex flexDirection=\"column\" gap={4}>\n        <Components.Heading as=\"h2\">{t('heading')}</Components.Heading>\n        <Components.Text variant=\"supporting\">{t('subtitle')}</Components.Text>\n      </Flex>\n\n      <Components.DatePicker\n        label={t('dateLabel')}\n        isRequired\n        value={checkDate}\n        onChange={setCheckDate}\n        minDate={minDate}\n        maxDate={maxDate}\n        isInvalid={dateError !== null}\n        errorMessage={dateError ?? undefined}\n      />\n\n      <SelectContractors companyId={companyId} onSelectionChange={setSelectedIds} />\n\n      <ActionsLayout>\n        <Components.Button onClick={handleContinue} isDisabled={!canContinue}>\n          {t('continueButton')}\n        </Components.Button>\n      </ActionsLayout>\n    </Flex>\n  )\n}\n"],"names":["HistoricalPaymentContractors","props","jsx","BaseComponent","Root","companyId","dictionary","onEvent","useI18n","useComponentDictionary","t","useTranslation","Components","useComponentContext","selectedIds","setSelectedIds","useState","checkDate","setCheckDate","minDate","maxDate","useMemo","getHistoricalPaymentCheckDateBounds","dateError","canContinue","handleContinue","componentEvents","formatDateToStringDate","jsxs","Flex","SelectContractors","ActionsLayout"],"mappings":";;;;;;;;;;;;;AAqCO,SAASA,EAA6BC,GAA0C;AACrF,SACE,gBAAAC,EAACC,GAAA,EAAe,GAAGF,GAAO,eAAc,oDACtC,UAAA,gBAAAC,EAACE,GAAA,EAAM,GAAGH,EAAA,CAAO,EAAA,CACnB;AAEJ;AAEA,SAASG,EAAK,EAAE,WAAAC,GAAW,YAAAC,GAAY,SAAAC,KAA8C;AACnF,EAAAC,EAAQ,kDAAkD,GAC1DC,EAAuB,oDAAoDH,CAAU;AACrF,QAAM,EAAE,GAAAI,EAAA,IAAMC,EAAe,kDAAkD,GACzEC,IAAaC,EAAA,GAEb,CAACC,GAAaC,CAAc,IAAIC,EAAmB,CAAA,CAAE,GACrD,CAACC,GAAWC,CAAY,IAAIF,EAAsB,IAAI,GAEtD,EAAE,SAAAG,GAAS,SAAAC,EAAA,IAAYC,EAAQ,MAAMC,EAAA,GAAuC,EAAE;AAEpF,MAAIC,IAA2B;AAC/B,EAAIN,MAAc,QAAQA,IAAYG,IACpCG,IAAYb,EAAE,mBAAmB,IACxBO,MAAc,QAAQA,IAAYE,MAC3CI,IAAYb,EAAE,qBAAqB;AAAA,IACjC,MAAMO,EAAU,YAAA;AAAA,IAChB,aAAaE,EAAQ,YAAA;AAAA,EAAY,CAClC;AAGH,QAAMK,IAAcV,EAAY,SAAS,KAAKG,MAAc,QAAQM,MAAc,MAE5EE,IAAiB,MAAM;AAC3B,IAAIR,MAAc,QAAQM,MAAc,QACxChB,EAAQmB,EAAgB,oDAAoD;AAAA,MAC1E,eAAeZ;AAAA,MACf,WAAWa,EAAuBV,CAAS;AAAA,IAAA,CAC5C;AAAA,EACH;AAEA,SACE,gBAAAW,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,IAChC,UAAA;AAAA,IAAA,gBAAAD,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,MAAA,gBAAA3B,EAACU,EAAW,SAAX,EAAmB,IAAG,MAAM,UAAAF,EAAE,SAAS,GAAE;AAAA,MAC1C,gBAAAR,EAACU,EAAW,MAAX,EAAgB,SAAQ,cAAc,UAAAF,EAAE,UAAU,EAAA,CAAE;AAAA,IAAA,GACvD;AAAA,IAEA,gBAAAR;AAAA,MAACU,EAAW;AAAA,MAAX;AAAA,QACC,OAAOF,EAAE,WAAW;AAAA,QACpB,YAAU;AAAA,QACV,OAAOO;AAAA,QACP,UAAUC;AAAA,QACV,SAAAC;AAAA,QACA,SAAAC;AAAA,QACA,WAAWG,MAAc;AAAA,QACzB,cAAcA,KAAa;AAAA,MAAA;AAAA,IAAA;AAAA,IAG7B,gBAAArB,EAAC4B,GAAA,EAAkB,WAAAzB,GAAsB,mBAAmBU,EAAA,CAAgB;AAAA,IAE5E,gBAAAb,EAAC6B,GAAA,EACC,UAAA,gBAAA7B,EAACU,EAAW,QAAX,EAAkB,SAASa,GAAgB,YAAY,CAACD,GACtD,UAAAd,EAAE,gBAAgB,GACrB,EAAA,CACF;AAAA,EAAA,GACF;AAEJ;"}

package/dist/components/Contractor/Payments/HistoricalPaymentContractors/index.d.ts

@@ -0,0 +1 @@
+export { HistoricalPaymentContractors, type HistoricalPaymentContractorsProps, } from './HistoricalPaymentContractors';

package/dist/components/Contractor/Payments/PaymentFlow/PaymentFlowComponents.d.ts

@@ -1,7 +1,6 @@
 import { InternalAlert } from '../types';
 import { FlowContextInterface } from '../../../Flow/useFlow';
 import { BaseComponentInterface } from '../../../Base';
-import { BreadcrumbTrail } from '../../../Common/FlowBreadcrumbs/FlowBreadcrumbsTypes';
 /**
  * Props for {@link PaymentFlow}.
  *
@@ -14,21 +13,14 @@ export interface PaymentFlowProps extends BaseComponentInterface<never> {
 /** @internal */
 export interface PaymentFlowContextInterface extends FlowContextInterface {
     companyId: string;
-    breadcrumbs?: BreadcrumbTrail;
     currentPaymentId?: string;
-    currentContractorUuid?: string;
-    createdPaymentGroupId?: string;
     alerts?: InternalAlert[];
 }
 /** @internal */
 export declare function PaymentListContextual(): import("react").JSX.Element;
 /** @internal */
-export declare function CreatePaymentContextual(): import("react").JSX.Element;
+export declare function CreatePaymentFlowContextual(): import("react").JSX.Element;
 /** @internal */
-export declare function PaymentHistoryContextual(): import("react").JSX.Element;
-/** @internal */
-export declare function PaymentStatementContextual(): import("react").JSX.Element;
-/** @internal */
-export declare function PaymentSummaryContextual(): import("react").JSX.Element;
+export declare function ViewPaymentFlowContextual(): import("react").JSX.Element;
 /** @internal */
 export declare function InformationRequestsContextual(): import("react").JSX.Element;

package/dist/components/Contractor/Payments/PaymentFlow/PaymentFlowComponents.js

@@ -1,64 +1,55 @@
-import { jsx as e } from "react/jsx-runtime";
-import { PaymentsListInternal as u } from "../PaymentsList/PaymentsList.js";
-import { CreatePayment as y } from "../CreatePayment/CreatePayment.js";
-import { PaymentHistory as c } from "../PaymentHistory/PaymentHistory.js";
-import { PaymentStatement as i } from "../PaymentStatement/PaymentStatement.js";
-import { PaymentSummaryInternal as p } from "../PaymentSummary/PaymentSummary.js";
-import { useFlow as r } from "../../../Flow/useFlow.js";
-import { ensureRequired as o } from "../../../../helpers/ensureRequired.js";
+import { jsx as r } from "react/jsx-runtime";
+import { PaymentsListInternal as i } from "../PaymentsList/PaymentsList.js";
+import { CreatePaymentInternalFlow as u } from "../CreatePaymentFlow/CreatePaymentFlow.js";
+import { ViewPaymentInternalFlow as c } from "../ViewPaymentFlow/ViewPaymentFlow.js";
+import { useFlow as o } from "../../../Flow/useFlow.js";
+import { ensureRequired as a } from "../../../../helpers/ensureRequired.js";
 import { InformationRequestsFlow as s } from "../../../InformationRequests/InformationRequests.js";
-function S() {
-  const { companyId: t, onEvent: n, alerts: m } = r();
-  return /* @__PURE__ */ e(u, { onEvent: n, companyId: o(t), alerts: m });
+function x() {
+  const { companyId: n, onEvent: t, alerts: e } = o();
+  return /* @__PURE__ */ r(i, { onEvent: t, companyId: a(n), alerts: e });
 }
-function q() {
-  const { companyId: t, onEvent: n } = r();
-  return /* @__PURE__ */ e(y, { onEvent: n, companyId: o(t) });
+function m() {
+  const { header: n } = o(), t = n?.type === "breadcrumbs" ? n.breadcrumbs?.landing?.[0] : void 0;
+  return t ? [t] : void 0;
 }
-function w() {
-  const { currentPaymentId: t, onEvent: n } = r();
-  return /* @__PURE__ */ e(c, { onEvent: n, paymentId: o(t) });
-}
-function G() {
-  const { currentPaymentId: t, currentContractorUuid: n, onEvent: m } = r();
-  return /* @__PURE__ */ e(
-    i,
+function b() {
+  const { companyId: n, onEvent: t } = o(), e = m();
+  return /* @__PURE__ */ r(
+    u,
     {
-      onEvent: m,
-      paymentGroupId: o(t),
-      contractorUuid: o(n)
+      companyId: a(n),
+      onEvent: t,
+      prefixBreadcrumbs: e
     }
   );
 }
-function R() {
-  const { createdPaymentGroupId: t, companyId: n, onEvent: m, alerts: a } = r();
-  return /* @__PURE__ */ e(
-    p,
+function P() {
+  const { currentPaymentId: n, onEvent: t } = o(), e = m();
+  return /* @__PURE__ */ r(
+    c,
     {
-      onEvent: m,
-      paymentGroupId: o(t),
-      companyId: o(n),
-      alerts: a
+      paymentId: a(n),
+      onEvent: t,
+      prefixBreadcrumbs: e
     }
   );
 }
-function F() {
-  const { companyId: t, onEvent: n } = r();
-  return /* @__PURE__ */ e(
+function v() {
+  const { companyId: n, onEvent: t } = o();
+  return /* @__PURE__ */ r(
     s,
     {
-      companyId: o(t),
+      companyId: a(n),
       withAlert: !1,
-      onEvent: n
+      onEvent: t
     }
   );
 }
 export {
-  q as CreatePaymentContextual,
-  F as InformationRequestsContextual,
-  w as PaymentHistoryContextual,
-  S as PaymentListContextual,
-  G as PaymentStatementContextual,
-  R as PaymentSummaryContextual
+  b as CreatePaymentFlowContextual,
+  v as InformationRequestsContextual,
+  x as PaymentListContextual,
+  P as ViewPaymentFlowContextual
 };
 //# sourceMappingURL=PaymentFlowComponents.js.map

package/dist/components/Contractor/Payments/PaymentFlow/PaymentFlowComponents.js.map

@@ -1 +1 @@
-{"version":3,"file":"PaymentFlowComponents.js","sources":["../../../../../src/components/Contractor/Payments/PaymentFlow/PaymentFlowComponents.tsx"],"sourcesContent":["import { PaymentsListInternal } from '../PaymentsList/PaymentsList'\nimport { CreatePayment } from '../CreatePayment/CreatePayment'\nimport { PaymentHistory } from '../PaymentHistory/PaymentHistory'\nimport { PaymentStatement } from '../PaymentStatement/PaymentStatement'\nimport { PaymentSummaryInternal } from '../PaymentSummary/PaymentSummary'\nimport type { InternalAlert } from '../types'\nimport { InformationRequestsFlow } from '@/components/InformationRequests'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { BaseComponentInterface } from '@/components/Base'\nimport type { BreadcrumbTrail } from '@/components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/**\n * Props for {@link PaymentFlow}.\n *\n * @public\n */\nexport interface PaymentFlowProps extends BaseComponentInterface<never> {\n  /** The associated company identifier. */\n  companyId: string\n}\n\n/** @internal */\nexport interface PaymentFlowContextInterface extends FlowContextInterface {\n  companyId: string\n  breadcrumbs?: BreadcrumbTrail\n  currentPaymentId?: string\n  currentContractorUuid?: string\n  createdPaymentGroupId?: string\n  alerts?: InternalAlert[]\n}\n\n/** @internal */\nexport function PaymentListContextual() {\n  const { companyId, onEvent, alerts } = useFlow<PaymentFlowContextInterface>()\n  return (\n    <PaymentsListInternal onEvent={onEvent} companyId={ensureRequired(companyId)} alerts={alerts} />\n  )\n}\n\n/** @internal */\nexport function CreatePaymentContextual() {\n  const { companyId, onEvent } = useFlow<PaymentFlowContextInterface>()\n  return <CreatePayment onEvent={onEvent} companyId={ensureRequired(companyId)} />\n}\n\n/** @internal */\nexport function PaymentHistoryContextual() {\n  const { currentPaymentId, onEvent } = useFlow<PaymentFlowContextInterface>()\n  return <PaymentHistory onEvent={onEvent} paymentId={ensureRequired(currentPaymentId)} />\n}\n\n/** @internal */\nexport function PaymentStatementContextual() {\n  const { currentPaymentId, currentContractorUuid, onEvent } =\n    useFlow<PaymentFlowContextInterface>()\n  return (\n    <PaymentStatement\n      onEvent={onEvent}\n      paymentGroupId={ensureRequired(currentPaymentId)}\n      contractorUuid={ensureRequired(currentContractorUuid)}\n    />\n  )\n}\n\n/** @internal */\nexport function PaymentSummaryContextual() {\n  const { createdPaymentGroupId, companyId, onEvent, alerts } =\n    useFlow<PaymentFlowContextInterface>()\n\n  return (\n    <PaymentSummaryInternal\n      onEvent={onEvent}\n      paymentGroupId={ensureRequired(createdPaymentGroupId)}\n      companyId={ensureRequired(companyId)}\n      alerts={alerts}\n    />\n  )\n}\n\n/** @internal */\nexport function InformationRequestsContextual() {\n  const { companyId, onEvent } = useFlow<PaymentFlowContextInterface>()\n  return (\n    <InformationRequestsFlow\n      companyId={ensureRequired(companyId)}\n      withAlert={false}\n      onEvent={onEvent}\n    />\n  )\n}\n"],"names":["PaymentListContextual","companyId","onEvent","alerts","useFlow","PaymentsListInternal","ensureRequired","CreatePaymentContextual","CreatePayment","PaymentHistoryContextual","currentPaymentId","PaymentHistory","PaymentStatementContextual","currentContractorUuid","jsx","PaymentStatement","PaymentSummaryContextual","createdPaymentGroupId","PaymentSummaryInternal","InformationRequestsContextual","InformationRequestsFlow"],"mappings":";;;;;;;;;AAiCO,SAASA,IAAwB;AACtC,QAAM,EAAE,WAAAC,GAAW,SAAAC,GAAS,QAAAC,EAAA,IAAWC,EAAA;AACvC,2BACGC,GAAA,EAAqB,SAAAH,GAAkB,WAAWI,EAAeL,CAAS,GAAG,QAAAE,GAAgB;AAElG;AAGO,SAASI,IAA0B;AACxC,QAAM,EAAE,WAAAN,GAAW,SAAAC,EAAA,IAAYE,EAAA;AAC/B,2BAAQI,GAAA,EAAc,SAAAN,GAAkB,WAAWI,EAAeL,CAAS,GAAG;AAChF;AAGO,SAASQ,IAA2B;AACzC,QAAM,EAAE,kBAAAC,GAAkB,SAAAR,EAAA,IAAYE,EAAA;AACtC,2BAAQO,GAAA,EAAe,SAAAT,GAAkB,WAAWI,EAAeI,CAAgB,GAAG;AACxF;AAGO,SAASE,IAA6B;AAC3C,QAAM,EAAE,kBAAAF,GAAkB,uBAAAG,GAAuB,SAAAX,EAAA,IAC/CE,EAAA;AACF,SACE,gBAAAU;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,SAAAb;AAAA,MACA,gBAAgBI,EAAeI,CAAgB;AAAA,MAC/C,gBAAgBJ,EAAeO,CAAqB;AAAA,IAAA;AAAA,EAAA;AAG1D;AAGO,SAASG,IAA2B;AACzC,QAAM,EAAE,uBAAAC,GAAuB,WAAAhB,GAAW,SAAAC,GAAS,QAAAC,EAAA,IACjDC,EAAA;AAEF,SACE,gBAAAU;AAAA,IAACI;AAAA,IAAA;AAAA,MACC,SAAAhB;AAAA,MACA,gBAAgBI,EAAeW,CAAqB;AAAA,MACpD,WAAWX,EAAeL,CAAS;AAAA,MACnC,QAAAE;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASgB,IAAgC;AAC9C,QAAM,EAAE,WAAAlB,GAAW,SAAAC,EAAA,IAAYE,EAAA;AAC/B,SACE,gBAAAU;AAAA,IAACM;AAAA,IAAA;AAAA,MACC,WAAWd,EAAeL,CAAS;AAAA,MACnC,WAAW;AAAA,MACX,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"PaymentFlowComponents.js","sources":["../../../../../src/components/Contractor/Payments/PaymentFlow/PaymentFlowComponents.tsx"],"sourcesContent":["import { PaymentsListInternal } from '../PaymentsList/PaymentsList'\nimport { CreatePaymentInternalFlow } from '../CreatePaymentFlow/CreatePaymentFlow'\nimport { ViewPaymentInternalFlow } from '../ViewPaymentFlow/ViewPaymentFlow'\nimport type { InternalAlert } from '../types'\nimport { InformationRequestsFlow } from '@/components/InformationRequests'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { BaseComponentInterface } from '@/components/Base'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/**\n * Props for {@link PaymentFlow}.\n *\n * @public\n */\nexport interface PaymentFlowProps extends BaseComponentInterface<never> {\n  /** The associated company identifier. */\n  companyId: string\n}\n\n/** @internal */\nexport interface PaymentFlowContextInterface extends FlowContextInterface {\n  companyId: string\n  currentPaymentId?: string\n  alerts?: InternalAlert[]\n}\n\n/** @internal */\nexport function PaymentListContextual() {\n  const { companyId, onEvent, alerts } = useFlow<PaymentFlowContextInterface>()\n  return (\n    <PaymentsListInternal onEvent={onEvent} companyId={ensureRequired(companyId)} alerts={alerts} />\n  )\n}\n\nfunction useLandingPrefixBreadcrumbs() {\n  const { header } = useFlow<PaymentFlowContextInterface>()\n  const landingBreadcrumb =\n    header?.type === 'breadcrumbs' ? header.breadcrumbs?.landing?.[0] : undefined\n  return landingBreadcrumb ? [landingBreadcrumb] : undefined\n}\n\n/** @internal */\nexport function CreatePaymentFlowContextual() {\n  const { companyId, onEvent } = useFlow<PaymentFlowContextInterface>()\n  const prefixBreadcrumbs = useLandingPrefixBreadcrumbs()\n\n  return (\n    <CreatePaymentInternalFlow\n      companyId={ensureRequired(companyId)}\n      onEvent={onEvent}\n      prefixBreadcrumbs={prefixBreadcrumbs}\n    />\n  )\n}\n\n/** @internal */\nexport function ViewPaymentFlowContextual() {\n  const { currentPaymentId, onEvent } = useFlow<PaymentFlowContextInterface>()\n  const prefixBreadcrumbs = useLandingPrefixBreadcrumbs()\n\n  return (\n    <ViewPaymentInternalFlow\n      paymentId={ensureRequired(currentPaymentId)}\n      onEvent={onEvent}\n      prefixBreadcrumbs={prefixBreadcrumbs}\n    />\n  )\n}\n\n/** @internal */\nexport function InformationRequestsContextual() {\n  const { companyId, onEvent } = useFlow<PaymentFlowContextInterface>()\n  return (\n    <InformationRequestsFlow\n      companyId={ensureRequired(companyId)}\n      withAlert={false}\n      onEvent={onEvent}\n    />\n  )\n}\n"],"names":["PaymentListContextual","companyId","onEvent","alerts","useFlow","PaymentsListInternal","ensureRequired","useLandingPrefixBreadcrumbs","header","landingBreadcrumb","CreatePaymentFlowContextual","prefixBreadcrumbs","jsx","CreatePaymentInternalFlow","ViewPaymentFlowContextual","currentPaymentId","ViewPaymentInternalFlow","InformationRequestsContextual","InformationRequestsFlow"],"mappings":";;;;;;;AA2BO,SAASA,IAAwB;AACtC,QAAM,EAAE,WAAAC,GAAW,SAAAC,GAAS,QAAAC,EAAA,IAAWC,EAAA;AACvC,2BACGC,GAAA,EAAqB,SAAAH,GAAkB,WAAWI,EAAeL,CAAS,GAAG,QAAAE,GAAgB;AAElG;AAEA,SAASI,IAA8B;AACrC,QAAM,EAAE,QAAAC,EAAA,IAAWJ,EAAA,GACbK,IACJD,GAAQ,SAAS,gBAAgBA,EAAO,aAAa,UAAU,CAAC,IAAI;AACtE,SAAOC,IAAoB,CAACA,CAAiB,IAAI;AACnD;AAGO,SAASC,IAA8B;AAC5C,QAAM,EAAE,WAAAT,GAAW,SAAAC,EAAA,IAAYE,EAAA,GACzBO,IAAoBJ,EAAA;AAE1B,SACE,gBAAAK;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,WAAWP,EAAeL,CAAS;AAAA,MACnC,SAAAC;AAAA,MACA,mBAAAS;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASG,IAA4B;AAC1C,QAAM,EAAE,kBAAAC,GAAkB,SAAAb,EAAA,IAAYE,EAAA,GAChCO,IAAoBJ,EAAA;AAE1B,SACE,gBAAAK;AAAA,IAACI;AAAA,IAAA;AAAA,MACC,WAAWV,EAAeS,CAAgB;AAAA,MAC1C,SAAAb;AAAA,MACA,mBAAAS;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASM,IAAgC;AAC9C,QAAM,EAAE,WAAAhB,GAAW,SAAAC,EAAA,IAAYE,EAAA;AAC/B,SACE,gBAAAQ;AAAA,IAACM;AAAA,IAAA;AAAA,MACC,WAAWZ,EAAeL,CAAS;AAAA,MACnC,WAAW;AAAA,MACX,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Contractor/Payments/PaymentFlow/paymentStateMachine.d.ts

@@ -1,12 +1,30 @@
 import { BreadcrumbNodes } from '../../../Common/FlowBreadcrumbs/FlowBreadcrumbsTypes';
-/** @internal */
+/**
+ * Hub-level breadcrumb nodes for {@link PaymentFlow}.
+ *
+ * @remarks
+ * Only `landing` is defined here — the `createPayment` and `history` spokes own and render their
+ * own breadcrumb trails (via `CreatePaymentFlow`/`ViewPaymentFlow`), prefixed with this `landing`
+ * item so the trail reads continuously across the hub/spoke boundary.
+ *
+ * @internal
+ */
 export declare const paymentFlowBreadcrumbsNodes: BreadcrumbNodes;
-/** @internal */
+/**
+ * Hub machine for {@link PaymentFlow}.
+ *
+ * @remarks
+ * `createPayment` and `history` each stay active for the full lifetime of their respective spoke
+ * (`CreatePaymentFlow`, `ViewPaymentFlow`) rather than tracking the spoke's internal screen. The
+ * spoke's own machine drives its internal steps and breadcrumb trail; events it can't handle
+ * locally (e.g. the `landing` breadcrumb, or a terminal exit/cancel event) bubble up here to
+ * transition the hub back to `landing`.
+ *
+ * @internal
+ */
 export declare const paymentMachine: {
     landing: import('robot3').MachineState<any>;
     createPayment: import('robot3').MachineState<any>;
-    paymentSummary: import('robot3').MachineState<any>;
     history: import('robot3').MachineState<any>;
-    statement: import('robot3').MachineState<any>;
     informationRequests: import('robot3').MachineState<any>;
 };