@gusto/embedded-react-sdk 0.52.2 → 0.54.0

package/dist/components/Contractor/Address/management/AddressCard/AddressCard.js

@@ -0,0 +1,45 @@
+import { jsx as r, jsxs as a } from "react/jsx-runtime";
+import { useTranslation as l } from "react-i18next";
+import { Flex as p } from "../../../../Common/Flex/Flex.js";
+import { Loading as u } from "../../../../Common/Loading/Loading.js";
+import { BaseBoundaries as h, BaseLayout as C } from "../../../../Base/Base.js";
+import { useComponentContext as f } from "../../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { useI18n as x } from "../../../../../i18n/I18n.js";
+import { componentEvents as A } from "../../../../../shared/constants.js";
+import { useContractorAddressSummary as g } from "../../shared/useContractorAddressSummary/useContractorAddressSummary.js";
+function _({ LoaderComponent: o, ...s }) {
+  return /* @__PURE__ */ r(h, { componentName: "Contractor.Management.Address", LoaderComponent: o, children: /* @__PURE__ */ r(T, { LoaderComponent: o, ...s }) });
+}
+function T({ contractorId: o, onEvent: s, LoaderComponent: m }) {
+  x("Contractor.Management.Address");
+  const { t: i } = l("Contractor.Management.Address"), t = f(), n = g({ contractorId: o }), d = n.isLoading, e = n.isLoading ? void 0 : n.data.contractorAddress, c = () => {
+    s(A.CONTRACTOR_MANAGEMENT_ADDRESS_EDIT_REQUESTED, { contractorId: o });
+  };
+  return /* @__PURE__ */ r(C, { error: n.errorHandling.errors, LoaderComponent: m, children: /* @__PURE__ */ r(
+    t.Box,
+    {
+      header: /* @__PURE__ */ r(
+        t.BoxHeader,
+        {
+          title: i("title"),
+          action: /* @__PURE__ */ r(t.Button, { variant: "secondary", onClick: c, isDisabled: d, children: i("editCta") })
+        }
+      ),
+      children: d ? /* @__PURE__ */ r(u, {}) : e?.street1 ? /* @__PURE__ */ a(p, { flexDirection: "column", gap: 0, children: [
+        /* @__PURE__ */ r(t.Text, { weight: "medium", children: e.street1 }),
+        e.street2 && /* @__PURE__ */ r(t.Text, { children: e.street2 }),
+        /* @__PURE__ */ a(t.Text, { children: [
+          e.city,
+          ", ",
+          e.state,
+          " ",
+          e.zip
+        ] })
+      ] }) : /* @__PURE__ */ r(t.Text, { children: i("emptyPlaceholder") })
+    }
+  ) });
+}
+export {
+  _ as AddressCard
+};
+//# sourceMappingURL=AddressCard.js.map

package/dist/components/Contractor/Address/management/AddressCard/AddressCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressCard.js","sources":["../../../../../../src/components/Contractor/Address/management/AddressCard/AddressCard.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { useContractorAddressSummary } from '../../shared/useContractorAddressSummary'\nimport { Loading } from '@/components/Common'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { BaseBoundaries, BaseLayout } from '@/components/Base/Base'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n } from '@/i18n'\nimport { componentEvents, type EventType } from '@/shared/constants'\nimport type { OnEventType } from '@/components/Base/useBase'\nimport type { LoaderComponentType } from '@/components/Base'\n\n/**\n * Props for {@link AddressCard}.\n *\n * @public\n */\nexport interface AddressCardProps {\n  /** The associated contractor identifier. */\n  contractorId: string\n  /** Event handler fired when the user requests to edit the address. */\n  onEvent: OnEventType<EventType, unknown>\n  /** Custom loading indicator rendered while this component's async data is fetching. Overrides the indicator configured on `GustoProvider` for this instance only. */\n  LoaderComponent?: LoaderComponentType\n}\n\n/**\n * Read-only card showing a contractor's mailing address with an Edit action.\n *\n * @remarks\n * Standalone card that fetches its own data. Emits an event when the user\n * clicks Edit so the parent can switch to the edit form. The card does not\n * render success or error alerts itself — alert presentation is the\n * surrounding surface's responsibility.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/management/address/editRequested` | Fired when the user clicks the Edit button | `{ contractorId: string }` |\n *\n * @param props - See {@link AddressCardProps}.\n * @returns The contractor address card.\n * @public\n */\nexport function AddressCard({ LoaderComponent, ...props }: AddressCardProps) {\n  return (\n    <BaseBoundaries componentName=\"Contractor.Management.Address\" LoaderComponent={LoaderComponent}>\n      <AddressCardContent LoaderComponent={LoaderComponent} {...props} />\n    </BaseBoundaries>\n  )\n}\n\nfunction AddressCardContent({ contractorId, onEvent, LoaderComponent }: AddressCardProps) {\n  useI18n('Contractor.Management.Address')\n  const { t } = useTranslation('Contractor.Management.Address')\n  const Components = useComponentContext()\n\n  const summary = useContractorAddressSummary({ contractorId })\n\n  const isLoading = summary.isLoading\n  const contractorAddress = summary.isLoading ? undefined : summary.data.contractorAddress\n\n  const handleEdit = () => {\n    onEvent(componentEvents.CONTRACTOR_MANAGEMENT_ADDRESS_EDIT_REQUESTED, { contractorId })\n  }\n\n  return (\n    <BaseLayout error={summary.errorHandling.errors} LoaderComponent={LoaderComponent}>\n      <Components.Box\n        header={\n          <Components.BoxHeader\n            title={t('title')}\n            action={\n              <Components.Button variant=\"secondary\" onClick={handleEdit} isDisabled={isLoading}>\n                {t('editCta')}\n              </Components.Button>\n            }\n          />\n        }\n      >\n        {isLoading ? (\n          <Loading />\n        ) : contractorAddress?.street1 ? (\n          <Flex flexDirection=\"column\" gap={0}>\n            <Components.Text weight=\"medium\">{contractorAddress.street1}</Components.Text>\n            {contractorAddress.street2 && (\n              <Components.Text>{contractorAddress.street2}</Components.Text>\n            )}\n            <Components.Text>\n              {contractorAddress.city}, {contractorAddress.state} {contractorAddress.zip}\n            </Components.Text>\n          </Flex>\n        ) : (\n          <Components.Text>{t('emptyPlaceholder')}</Components.Text>\n        )}\n      </Components.Box>\n    </BaseLayout>\n  )\n}\n"],"names":["AddressCard","LoaderComponent","props","jsx","BaseBoundaries","AddressCardContent","contractorId","onEvent","useI18n","t","useTranslation","Components","useComponentContext","summary","useContractorAddressSummary","isLoading","contractorAddress","handleEdit","componentEvents","BaseLayout","Loading","jsxs","Flex"],"mappings":";;;;;;;;;AA2CO,SAASA,EAAY,EAAE,iBAAAC,GAAiB,GAAGC,KAA2B;AAC3E,SACE,gBAAAC,EAACC,GAAA,EAAe,eAAc,iCAAgC,iBAAAH,GAC5D,4BAACI,GAAA,EAAmB,iBAAAJ,GAAmC,GAAGC,EAAA,CAAO,EAAA,CACnE;AAEJ;AAEA,SAASG,EAAmB,EAAE,cAAAC,GAAc,SAAAC,GAAS,iBAAAN,KAAqC;AACxF,EAAAO,EAAQ,+BAA+B;AACvC,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,+BAA+B,GACtDC,IAAaC,EAAA,GAEbC,IAAUC,EAA4B,EAAE,cAAAR,GAAc,GAEtDS,IAAYF,EAAQ,WACpBG,IAAoBH,EAAQ,YAAY,SAAYA,EAAQ,KAAK,mBAEjEI,IAAa,MAAM;AACvB,IAAAV,EAAQW,EAAgB,8CAA8C,EAAE,cAAAZ,EAAA,CAAc;AAAA,EACxF;AAEA,2BACGa,GAAA,EAAW,OAAON,EAAQ,cAAc,QAAQ,iBAAAZ,GAC/C,UAAA,gBAAAE;AAAA,IAACQ,EAAW;AAAA,IAAX;AAAA,MACC,QACE,gBAAAR;AAAA,QAACQ,EAAW;AAAA,QAAX;AAAA,UACC,OAAOF,EAAE,OAAO;AAAA,UAChB,QACE,gBAAAN,EAACQ,EAAW,QAAX,EAAkB,SAAQ,aAAY,SAASM,GAAY,YAAYF,GACrE,UAAAN,EAAE,SAAS,EAAA,CACd;AAAA,QAAA;AAAA,MAAA;AAAA,MAKL,UAAAM,IACC,gBAAAZ,EAACiB,GAAA,CAAA,CAAQ,IACPJ,GAAmB,UACrB,gBAAAK,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,QAAA,gBAAAnB,EAACQ,EAAW,MAAX,EAAgB,QAAO,UAAU,YAAkB,SAAQ;AAAA,QAC3DK,EAAkB,WACjB,gBAAAb,EAACQ,EAAW,MAAX,EAAiB,YAAkB,SAAQ;AAAA,QAE9C,gBAAAU,EAACV,EAAW,MAAX,EACE,UAAA;AAAA,UAAAK,EAAkB;AAAA,UAAK;AAAA,UAAGA,EAAkB;AAAA,UAAM;AAAA,UAAEA,EAAkB;AAAA,QAAA,EAAA,CACzE;AAAA,MAAA,GACF,IAEA,gBAAAb,EAACQ,EAAW,MAAX,EAAiB,UAAAF,EAAE,kBAAkB,EAAA,CAAE;AAAA,IAAA;AAAA,EAAA,GAG9C;AAEJ;"}

package/dist/components/Contractor/Address/management/AddressCard/index.d.ts

@@ -0,0 +1 @@
+export { AddressCard, type AddressCardProps } from './AddressCard';

package/dist/components/Contractor/Address/management/AddressComponents.d.ts

@@ -0,0 +1,12 @@
+import { FlowContextInterface } from '../../../Flow/useFlow';
+type AddressSuccessAlertCode = 'addressUpdated';
+/** @internal */
+export interface AddressContextInterface extends FlowContextInterface {
+    contractorId?: string;
+    successAlert?: AddressSuccessAlertCode | null;
+}
+/** @internal */
+export declare function CardContextual(): import("react").JSX.Element;
+/** @internal */
+export declare function AddressEditFormContextual(): import("react").JSX.Element;
+export {};

package/dist/components/Contractor/Address/management/AddressComponents.js

@@ -0,0 +1,48 @@
+import { jsxs as i, jsx as n } from "react/jsx-runtime";
+import { useTranslation as a } from "react-i18next";
+import { AddressEditForm as l } from "./AddressEditForm.js";
+import { Flex as u } from "../../../Common/Flex/Flex.js";
+import { useFlow as e } from "../../../Flow/useFlow.js";
+import { useComponentContext as p } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { ensureRequired as s } from "../../../../helpers/ensureRequired.js";
+import { componentEvents as f } from "../../../../shared/constants.js";
+import { AddressCard as C } from "./AddressCard/AddressCard.js";
+function M() {
+  const { contractorId: r, onEvent: o, successAlert: t, LoaderComponent: m } = e(), { t: c } = a("Contractor.Management.Address"), d = p();
+  return /* @__PURE__ */ i(u, { flexDirection: "column", gap: 16, children: [
+    t ? /* @__PURE__ */ n(
+      d.Alert,
+      {
+        status: "success",
+        label: c(`alerts.${t}`),
+        onDismiss: () => {
+          o(f.CONTRACTOR_MANAGEMENT_ADDRESS_ALERT_DISMISSED, null);
+        }
+      }
+    ) : null,
+    /* @__PURE__ */ n(
+      C,
+      {
+        contractorId: s(r),
+        onEvent: o,
+        LoaderComponent: m
+      }
+    )
+  ] });
+}
+function _() {
+  const { contractorId: r, onEvent: o, LoaderComponent: t } = e();
+  return /* @__PURE__ */ n(
+    l,
+    {
+      contractorId: s(r),
+      onEvent: o,
+      LoaderComponent: t
+    }
+  );
+}
+export {
+  _ as AddressEditFormContextual,
+  M as CardContextual
+};
+//# sourceMappingURL=AddressComponents.js.map

package/dist/components/Contractor/Address/management/AddressComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressComponents.js","sources":["../../../../../src/components/Contractor/Address/management/AddressComponents.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { AddressEditForm } from './AddressEditForm'\nimport { AddressCard } from './AddressCard'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { ensureRequired } from '@/helpers/ensureRequired'\nimport { componentEvents } from '@/shared/constants'\n\ntype AddressSuccessAlertCode = 'addressUpdated'\n\n/** @internal */\nexport interface AddressContextInterface extends FlowContextInterface {\n  contractorId?: string\n  successAlert?: AddressSuccessAlertCode | null\n}\n\n/** @internal */\nexport function CardContextual() {\n  const { contractorId, onEvent, successAlert, LoaderComponent } =\n    useFlow<AddressContextInterface>()\n  const { t } = useTranslation('Contractor.Management.Address')\n  const Components = useComponentContext()\n  return (\n    <Flex flexDirection=\"column\" gap={16}>\n      {successAlert ? (\n        <Components.Alert\n          status=\"success\"\n          label={t(`alerts.${successAlert}`)}\n          onDismiss={() => {\n            onEvent(componentEvents.CONTRACTOR_MANAGEMENT_ADDRESS_ALERT_DISMISSED, null)\n          }}\n        />\n      ) : null}\n      <AddressCard\n        contractorId={ensureRequired(contractorId)}\n        onEvent={onEvent}\n        LoaderComponent={LoaderComponent}\n      />\n    </Flex>\n  )\n}\n\n/** @internal */\nexport function AddressEditFormContextual() {\n  const { contractorId, onEvent, LoaderComponent } = useFlow<AddressContextInterface>()\n  return (\n    <AddressEditForm\n      contractorId={ensureRequired(contractorId)}\n      onEvent={onEvent}\n      LoaderComponent={LoaderComponent}\n    />\n  )\n}\n"],"names":["CardContextual","contractorId","onEvent","successAlert","LoaderComponent","useFlow","t","useTranslation","Components","useComponentContext","jsxs","Flex","jsx","componentEvents","AddressCard","ensureRequired","AddressEditFormContextual","AddressEditForm"],"mappings":";;;;;;;;;AAkBO,SAASA,IAAiB;AAC/B,QAAM,EAAE,cAAAC,GAAc,SAAAC,GAAS,cAAAC,GAAc,iBAAAC,EAAA,IAC3CC,EAAA,GACI,EAAE,GAAAC,EAAA,IAAMC,EAAe,+BAA+B,GACtDC,IAAaC,EAAA;AACnB,SACE,gBAAAC,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,IAC/B,UAAA;AAAA,IAAAR,IACC,gBAAAS;AAAA,MAACJ,EAAW;AAAA,MAAX;AAAA,QACC,QAAO;AAAA,QACP,OAAOF,EAAE,UAAUH,CAAY,EAAE;AAAA,QACjC,WAAW,MAAM;AACf,UAAAD,EAAQW,EAAgB,+CAA+C,IAAI;AAAA,QAC7E;AAAA,MAAA;AAAA,IAAA,IAEA;AAAA,IACJ,gBAAAD;AAAA,MAACE;AAAA,MAAA;AAAA,QACC,cAAcC,EAAed,CAAY;AAAA,QACzC,SAAAC;AAAA,QACA,iBAAAE;AAAA,MAAA;AAAA,IAAA;AAAA,EACF,GACF;AAEJ;AAGO,SAASY,IAA4B;AAC1C,QAAM,EAAE,cAAAf,GAAc,SAAAC,GAAS,iBAAAE,EAAA,IAAoBC,EAAA;AACnD,SACE,gBAAAO;AAAA,IAACK;AAAA,IAAA;AAAA,MACC,cAAcF,EAAed,CAAY;AAAA,MACzC,SAAAC;AAAA,MACA,iBAAAE;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Contractor/Address/management/AddressEditForm.d.ts

@@ -0,0 +1,29 @@
+import { BaseComponentInterface } from '../../../Base';
+/**
+ * Props for {@link AddressEditForm}.
+ *
+ * @public
+ */
+export interface AddressEditFormProps extends BaseComponentInterface<'Contractor.Management.Address'> {
+    /** The associated contractor identifier. */
+    contractorId: string;
+}
+/**
+ * Standalone edit form for a contractor's mailing address.
+ *
+ * @remarks
+ * Renders fields for street address, city, state, and ZIP code — all
+ * required — and shows a success alert when the save completes. Save and
+ * Cancel both emit events so the parent can return to the read view.
+ *
+ * @events
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `contractor/management/address/updated` | Fired after the address is successfully saved | The updated `ContractorAddress` entity |
+ * | `contractor/management/address/editCancelled` | Fired when the user clicks Cancel | — |
+ *
+ * @param input - See {@link AddressEditFormProps}.
+ * @returns The contractor address edit form.
+ * @public
+ */
+export declare function AddressEditForm({ FallbackComponent, LoaderComponent, ...props }: AddressEditFormProps): import("react").JSX.Element;

package/dist/components/Contractor/Address/management/AddressEditForm.js

@@ -0,0 +1,126 @@
+import { jsx as o, jsxs as i } from "react/jsx-runtime";
+import { useState as v } from "react";
+import { useTranslation as E } from "react-i18next";
+import _ from "classnames";
+import { useContractorAddressForm as b } from "../shared/useContractorAddressForm/useContractorAddressForm.js";
+import y from "./AddressEditForm.module.scss.js";
+import { BaseBoundaries as I, BaseLayout as A } from "../../../Base/Base.js";
+import "../../../Base/useBase.js";
+import { Flex as M } from "../../../Common/Flex/Flex.js";
+import { Grid as F } from "../../../Common/Grid/Grid.js";
+import { ActionsLayout as L } from "../../../Common/ActionsLayout/ActionsLayout.js";
+import { Form as x } from "../../../Common/Form/Form.js";
+import { SDKFormProvider as B } from "../../../../partner-hook-utils/form/SDKFormProvider.js";
+import { useI18n as O, useComponentDictionary as U } from "../../../../i18n/I18n.js";
+import { firstLastName as P } from "../../../../helpers/formattedStrings.js";
+import { CONTRACTOR_TYPE as H, componentEvents as D } from "../../../../shared/constants.js";
+import { useComponentContext as Q } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
+const z = {
+  update: ["street1", "city", "state", "zip"]
+};
+function at({
+  FallbackComponent: m,
+  LoaderComponent: n,
+  ...l
+}) {
+  return /* @__PURE__ */ o(
+    I,
+    {
+      componentName: "Contractor.Management.Address",
+      FallbackComponent: m,
+      LoaderComponent: n,
+      children: /* @__PURE__ */ o(w, { LoaderComponent: n, ...l })
+    }
+  );
+}
+function w({
+  contractorId: m,
+  className: n,
+  dictionary: l,
+  onEvent: f,
+  LoaderComponent: u
+}) {
+  O("Contractor.Management.Address"), U("Contractor.Management.Address", l);
+  const { t } = E("Contractor.Management.Address"), { t: C } = E("common"), e = Q(), r = b({
+    contractorId: m,
+    optionalFieldsToRequire: z
+  }), [R, c] = v(!1);
+  if (r.isLoading)
+    return /* @__PURE__ */ o(
+      A,
+      {
+        isLoading: !0,
+        error: r.errorHandling.errors,
+        LoaderComponent: u
+      }
+    );
+  const { contractor: d, contractorType: S } = r.data, p = S === H.BUSINESS, g = p ? d.businessName ?? "" : P({ first_name: d.firstName, last_name: d.lastName }), { Fields: s } = r.form, h = async () => {
+    c(!1);
+    const a = await r.actions.onSubmit();
+    a && (f(D.CONTRACTOR_MANAGEMENT_ADDRESS_UPDATED, a.data), c(!0));
+  }, N = () => {
+    f(D.CONTRACTOR_MANAGEMENT_ADDRESS_EDIT_CANCELLED);
+  }, T = R ? /* @__PURE__ */ o(
+    e.Alert,
+    {
+      status: "success",
+      label: t("form.successAlert"),
+      onDismiss: () => {
+        c(!1);
+      }
+    }
+  ) : void 0;
+  return /* @__PURE__ */ o("section", { className: _(y.container, n), children: /* @__PURE__ */ o(A, { error: r.errorHandling.errors, LoaderComponent: u, children: /* @__PURE__ */ o(B, { formHookResult: r, children: /* @__PURE__ */ i(x, { onSubmit: h, children: [
+    T,
+    /* @__PURE__ */ i(M, { flexDirection: "column", gap: 4, children: [
+      /* @__PURE__ */ o(e.Heading, { as: "h2", children: t("form.title") }),
+      /* @__PURE__ */ o(e.Text, { variant: "supporting", children: t(p ? "form.businessDescription" : "form.homeDescription", {
+        name: g
+      }) })
+    ] }),
+    /* @__PURE__ */ i(F, { gridTemplateColumns: { base: "1fr", small: ["1fr", "1fr"] }, gap: 20, children: [
+      /* @__PURE__ */ o(
+        s.Street1,
+        {
+          label: t("form.street1"),
+          validationMessages: { REQUIRED: t("form.validations.street1") }
+        }
+      ),
+      /* @__PURE__ */ o(s.Street2, { label: t("form.street2") }),
+      /* @__PURE__ */ o(
+        s.City,
+        {
+          label: t("form.city"),
+          validationMessages: { REQUIRED: t("form.validations.city") }
+        }
+      ),
+      /* @__PURE__ */ o(
+        s.State,
+        {
+          label: t("form.state"),
+          placeholder: t("form.statePlaceholder"),
+          validationMessages: { REQUIRED: t("form.validations.state") },
+          getOptionLabel: (a) => C(`statesHash.${a}`, { defaultValue: a })
+        }
+      ),
+      /* @__PURE__ */ o(
+        s.Zip,
+        {
+          label: t("form.zip"),
+          validationMessages: {
+            REQUIRED: t("form.validations.zip"),
+            INVALID_ZIP: t("form.validations.zipInvalid")
+          }
+        }
+      )
+    ] }),
+    /* @__PURE__ */ i(L, { children: [
+      /* @__PURE__ */ o(e.Button, { variant: "secondary", onClick: N, type: "button", children: t("form.cancelCta") }),
+      /* @__PURE__ */ o(e.Button, { type: "submit", isLoading: r.status.isPending, children: t("form.saveCta") })
+    ] })
+  ] }) }) }) });
+}
+export {
+  at as AddressEditForm
+};
+//# sourceMappingURL=AddressEditForm.js.map

package/dist/components/Contractor/Address/management/AddressEditForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressEditForm.js","sources":["../../../../../src/components/Contractor/Address/management/AddressEditForm.tsx"],"sourcesContent":["import { useState } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport classNames from 'classnames'\nimport { useContractorAddressForm } from '../shared/useContractorAddressForm'\nimport type { ContractorAddressOptionalFieldsToRequire } from '../shared/useContractorAddressForm'\nimport styles from './AddressEditForm.module.scss'\nimport { BaseBoundaries, BaseLayout, type BaseComponentInterface } from '@/components/Base'\nimport { ActionsLayout } from '@/components/Common'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { Form } from '@/components/Common/Form'\nimport { Grid } from '@/components/Common/Grid/Grid'\nimport { SDKFormProvider } from '@/partner-hook-utils/form/SDKFormProvider'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { firstLastName } from '@/helpers/formattedStrings'\nimport { componentEvents, CONTRACTOR_TYPE } from '@/shared/constants'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\n// The hook defaults to the API contract, which treats every address field as\n// optional. The SDK's address form has always required a complete mailing\n// address, so it opts those fields back into being required here.\nconst SDK_REQUIRED_ADDRESS_FIELDS: ContractorAddressOptionalFieldsToRequire = {\n  update: ['street1', 'city', 'state', 'zip'],\n}\n\n/**\n * Props for {@link AddressEditForm}.\n *\n * @public\n */\nexport interface AddressEditFormProps extends BaseComponentInterface<'Contractor.Management.Address'> {\n  /** The associated contractor identifier. */\n  contractorId: string\n}\n\n/**\n * Standalone edit form for a contractor's mailing address.\n *\n * @remarks\n * Renders fields for street address, city, state, and ZIP code — all\n * required — and shows a success alert when the save completes. Save and\n * Cancel both emit events so the parent can return to the read view.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/management/address/updated` | Fired after the address is successfully saved | The updated `ContractorAddress` entity |\n * | `contractor/management/address/editCancelled` | Fired when the user clicks Cancel | — |\n *\n * @param input - See {@link AddressEditFormProps}.\n * @returns The contractor address edit form.\n * @public\n */\nexport function AddressEditForm({\n  FallbackComponent,\n  LoaderComponent,\n  ...props\n}: AddressEditFormProps) {\n  return (\n    <BaseBoundaries\n      componentName=\"Contractor.Management.Address\"\n      FallbackComponent={FallbackComponent}\n      LoaderComponent={LoaderComponent}\n    >\n      <AddressEditFormRoot LoaderComponent={LoaderComponent} {...props} />\n    </BaseBoundaries>\n  )\n}\n\nfunction AddressEditFormRoot({\n  contractorId,\n  className,\n  dictionary,\n  onEvent,\n  LoaderComponent,\n}: AddressEditFormProps) {\n  useI18n('Contractor.Management.Address')\n  useComponentDictionary('Contractor.Management.Address', dictionary)\n  const { t } = useTranslation('Contractor.Management.Address')\n  const { t: tCommon } = useTranslation('common')\n  const Components = useComponentContext()\n\n  const contractorAddress = useContractorAddressForm({\n    contractorId,\n    optionalFieldsToRequire: SDK_REQUIRED_ADDRESS_FIELDS,\n  })\n\n  const [showSuccess, setShowSuccess] = useState(false)\n\n  if (contractorAddress.isLoading) {\n    return (\n      <BaseLayout\n        isLoading\n        error={contractorAddress.errorHandling.errors}\n        LoaderComponent={LoaderComponent}\n      />\n    )\n  }\n\n  const { contractor, contractorType } = contractorAddress.data\n  const isBusiness = contractorType === CONTRACTOR_TYPE.BUSINESS\n  const legalName = isBusiness\n    ? (contractor.businessName ?? '')\n    : firstLastName({ first_name: contractor.firstName, last_name: contractor.lastName })\n  const { Fields } = contractorAddress.form\n\n  const handleSubmit = async () => {\n    setShowSuccess(false)\n    const result = await contractorAddress.actions.onSubmit()\n    if (!result) return\n    onEvent(componentEvents.CONTRACTOR_MANAGEMENT_ADDRESS_UPDATED, result.data)\n    setShowSuccess(true)\n  }\n\n  const handleCancel = () => {\n    onEvent(componentEvents.CONTRACTOR_MANAGEMENT_ADDRESS_EDIT_CANCELLED)\n  }\n\n  const alert = showSuccess ? (\n    <Components.Alert\n      status=\"success\"\n      label={t('form.successAlert')}\n      onDismiss={() => {\n        setShowSuccess(false)\n      }}\n    />\n  ) : undefined\n\n  return (\n    <section className={classNames(styles.container, className)}>\n      <BaseLayout error={contractorAddress.errorHandling.errors} LoaderComponent={LoaderComponent}>\n        <SDKFormProvider formHookResult={contractorAddress}>\n          <Form onSubmit={handleSubmit}>\n            {alert}\n            <Flex flexDirection=\"column\" gap={4}>\n              <Components.Heading as=\"h2\">{t('form.title')}</Components.Heading>\n              <Components.Text variant=\"supporting\">\n                {t(isBusiness ? 'form.businessDescription' : 'form.homeDescription', {\n                  name: legalName,\n                })}\n              </Components.Text>\n            </Flex>\n            <Grid gridTemplateColumns={{ base: '1fr', small: ['1fr', '1fr'] }} gap={20}>\n              <Fields.Street1\n                label={t('form.street1')}\n                validationMessages={{ REQUIRED: t('form.validations.street1') }}\n              />\n              <Fields.Street2 label={t('form.street2')} />\n              <Fields.City\n                label={t('form.city')}\n                validationMessages={{ REQUIRED: t('form.validations.city') }}\n              />\n              <Fields.State\n                label={t('form.state')}\n                placeholder={t('form.statePlaceholder')}\n                validationMessages={{ REQUIRED: t('form.validations.state') }}\n                getOptionLabel={(abbr: string) =>\n                  tCommon(`statesHash.${abbr}`, { defaultValue: abbr })\n                }\n              />\n              <Fields.Zip\n                label={t('form.zip')}\n                validationMessages={{\n                  REQUIRED: t('form.validations.zip'),\n                  INVALID_ZIP: t('form.validations.zipInvalid'),\n                }}\n              />\n            </Grid>\n            <ActionsLayout>\n              <Components.Button variant=\"secondary\" onClick={handleCancel} type=\"button\">\n                {t('form.cancelCta')}\n              </Components.Button>\n              <Components.Button type=\"submit\" isLoading={contractorAddress.status.isPending}>\n                {t('form.saveCta')}\n              </Components.Button>\n            </ActionsLayout>\n          </Form>\n        </SDKFormProvider>\n      </BaseLayout>\n    </section>\n  )\n}\n"],"names":["SDK_REQUIRED_ADDRESS_FIELDS","AddressEditForm","FallbackComponent","LoaderComponent","props","jsx","BaseBoundaries","AddressEditFormRoot","contractorId","className","dictionary","onEvent","useI18n","useComponentDictionary","useTranslation","tCommon","Components","useComponentContext","contractorAddress","useContractorAddressForm","showSuccess","setShowSuccess","useState","BaseLayout","contractor","contractorType","isBusiness","CONTRACTOR_TYPE","legalName","firstLastName","Fields","handleSubmit","result","componentEvents","handleCancel","alert","classNames","styles","SDKFormProvider","jsxs","Form","Flex","Grid","abbr","ActionsLayout"],"mappings":"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"}

package/dist/components/Contractor/Address/management/AddressEditForm.module.scss.js

@@ -0,0 +1,8 @@
+const n = "_container_18572_1", t = {
+  container: n
+};
+export {
+  n as container,
+  t as default
+};
+//# sourceMappingURL=AddressEditForm.module.scss.js.map

package/dist/components/Contractor/Address/management/AddressEditForm.module.scss.js.map

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

package/dist/components/Contractor/Address/management/addressStateMachine.d.ts

@@ -0,0 +1,5 @@
+/** @internal */
+export declare const addressStateMachine: {
+    card: import('robot3').MachineState<any>;
+    editAddress: import('robot3').MachineState<any>;
+};

package/dist/components/Contractor/Address/management/addressStateMachine.js

@@ -0,0 +1,37 @@
+import { state as s, transition as e, reduce as A } from "robot3";
+import { AddressEditFormContextual as n, CardContextual as E } from "./AddressComponents.js";
+import { componentEvents as r } from "../../../../shared/constants.js";
+const o = A((t) => ({
+  ...t,
+  component: E,
+  successAlert: null
+})), c = (t) => A((d) => ({
+  ...d,
+  component: E,
+  successAlert: t
+})), C = {
+  card: s(
+    e(
+      r.CONTRACTOR_MANAGEMENT_ADDRESS_EDIT_REQUESTED,
+      "editAddress",
+      A((t) => ({
+        ...t,
+        component: n,
+        successAlert: null
+      }))
+    ),
+    e(r.CONTRACTOR_MANAGEMENT_ADDRESS_ALERT_DISMISSED, "card", o)
+  ),
+  editAddress: s(
+    e(
+      r.CONTRACTOR_MANAGEMENT_ADDRESS_UPDATED,
+      "card",
+      c("addressUpdated")
+    ),
+    e(r.CONTRACTOR_MANAGEMENT_ADDRESS_EDIT_CANCELLED, "card", o)
+  )
+};
+export {
+  C as addressStateMachine
+};
+//# sourceMappingURL=addressStateMachine.js.map

package/dist/components/Contractor/Address/management/addressStateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressStateMachine.js","sources":["../../../../../src/components/Contractor/Address/management/addressStateMachine.ts"],"sourcesContent":["import { reduce, state, transition } from 'robot3'\nimport type { ComponentType } from 'react'\nimport type { AddressContextInterface } from './AddressComponents'\nimport { CardContextual, AddressEditFormContextual } from './AddressComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineTransition } from '@/types/Helpers'\n\nconst returnToCard = reduce((ctx: AddressContextInterface): AddressContextInterface => ({\n  ...ctx,\n  component: CardContextual as ComponentType,\n  successAlert: null,\n}))\n\nconst returnToCardWithAlert = (alert: AddressContextInterface['successAlert']) =>\n  reduce((ctx: AddressContextInterface): AddressContextInterface => ({\n    ...ctx,\n    component: CardContextual as ComponentType,\n    successAlert: alert,\n  }))\n\n/** @internal */\nexport const addressStateMachine = {\n  card: state<MachineTransition>(\n    transition(\n      componentEvents.CONTRACTOR_MANAGEMENT_ADDRESS_EDIT_REQUESTED,\n      'editAddress',\n      reduce((ctx: AddressContextInterface): AddressContextInterface => ({\n        ...ctx,\n        component: AddressEditFormContextual as ComponentType,\n        successAlert: null,\n      })),\n    ),\n    transition(componentEvents.CONTRACTOR_MANAGEMENT_ADDRESS_ALERT_DISMISSED, 'card', returnToCard),\n  ),\n  editAddress: state<MachineTransition>(\n    transition(\n      componentEvents.CONTRACTOR_MANAGEMENT_ADDRESS_UPDATED,\n      'card',\n      returnToCardWithAlert('addressUpdated'),\n    ),\n    transition(componentEvents.CONTRACTOR_MANAGEMENT_ADDRESS_EDIT_CANCELLED, 'card', returnToCard),\n  ),\n}\n"],"names":["returnToCard","reduce","ctx","CardContextual","returnToCardWithAlert","alert","addressStateMachine","state","transition","componentEvents","AddressEditFormContextual"],"mappings":";;;AAOA,MAAMA,IAAeC,EAAO,CAACC,OAA2D;AAAA,EACtF,GAAGA;AAAA,EACH,WAAWC;AAAA,EACX,cAAc;AAChB,EAAE,GAEIC,IAAwB,CAACC,MAC7BJ,EAAO,CAACC,OAA2D;AAAA,EACjE,GAAGA;AAAA,EACH,WAAWC;AAAA,EACX,cAAcE;AAChB,EAAE,GAGSC,IAAsB;AAAA,EACjC,MAAMC;AAAA,IACJC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAR,EAAO,CAACC,OAA2D;AAAA,QACjE,GAAGA;AAAA,QACH,WAAWQ;AAAA,QACX,cAAc;AAAA,MAAA,EACd;AAAA,IAAA;AAAA,IAEJF,EAAWC,EAAgB,+CAA+C,QAAQT,CAAY;AAAA,EAAA;AAAA,EAEhG,aAAaO;AAAA,IACXC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAL,EAAsB,gBAAgB;AAAA,IAAA;AAAA,IAExCI,EAAWC,EAAgB,8CAA8C,QAAQT,CAAY;AAAA,EAAA;AAEjG;"}

package/dist/components/Contractor/Address/management/index.d.ts

@@ -0,0 +1,3 @@
+export { Address, type AddressProps } from './Address';
+export { AddressCard, type AddressCardProps } from './AddressCard';
+export { AddressEditForm, type AddressEditFormProps } from './AddressEditForm';

package/dist/components/Contractor/Address/{Address.d.ts → onboarding/Address.d.ts}

@@ -1,9 +1,10 @@
 import { JSX } from 'react';
 import { FallbackProps } from 'react-error-boundary';
 import { AddressDefaultValues } from './types';
-import { ResourceDictionary } from '../../../types/Helpers';
-import { EventType } from '../../../shared/constants';
-import { OnEventType } from '../../Base/useBase';
+import { ResourceDictionary } from '../../../../types/Helpers';
+import { EventType } from '../../../../shared/constants';
+import { OnEventType } from '../../../Base/useBase';
+import { LoaderComponentType } from '../../../Base';
 /**
  * Props for {@link Address}.
  *
@@ -22,6 +23,8 @@ export interface AddressProps {
     className?: string;
     /** Custom React component rendered when an unhandled error is caught by the component-level error boundary. */
     FallbackComponent?: (props: FallbackProps) => JSX.Element;
+    /** Custom loading indicator rendered while this component's async data is fetching. Overrides the indicator configured on `GustoProvider` for this instance only. */
+    LoaderComponent?: LoaderComponentType;
 }
 /**
  * Form for collecting and updating a contractor's mailing address. Renders a business or home address title based on the contractor type.
@@ -50,4 +53,4 @@ export interface AddressProps {
  * }
  * ```
  */
-export declare function Address({ onEvent, FallbackComponent, ...rootProps }: AddressProps): JSX.Element;
+export declare function Address({ onEvent, FallbackComponent, LoaderComponent, ...rootProps }: AddressProps): JSX.Element;

package/dist/components/Contractor/Address/onboarding/Address.js

@@ -0,0 +1,119 @@
+import { jsx as t, jsxs as l } from "react/jsx-runtime";
+import { useTranslation as m } from "react-i18next";
+import C from "classnames";
+import { useContractorAddressForm as E } from "../shared/useContractorAddressForm/useContractorAddressForm.js";
+import S from "./Address.module.scss.js";
+import { BaseBoundaries as v, BaseLayout as f } from "../../../Base/Base.js";
+import "../../../Base/useBase.js";
+import { SDKFormProvider as T } from "../../../../partner-hook-utils/form/SDKFormProvider.js";
+import { Form as y } from "../../../Common/Form/Form.js";
+import { Flex as g } from "../../../Common/Flex/Flex.js";
+import { Grid as I } from "../../../Common/Grid/Grid.js";
+import { ActionsLayout as x } from "../../../Common/ActionsLayout/ActionsLayout.js";
+import { useComponentContext as D } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { useComponentDictionary as _, useI18n as F } from "../../../../i18n/I18n.js";
+import { contractorEvents as h } from "../../../../shared/constants.js";
+import { useContractorHasSignedW9 as N } from "../../shared/useContractorHasSignedW9.js";
+const B = {
+  update: ["street1", "city", "state", "zip"]
+};
+function J({
+  onEvent: o,
+  FallbackComponent: n,
+  LoaderComponent: s,
+  ...i
+}) {
+  return /* @__PURE__ */ t(
+    v,
+    {
+      componentName: "Contractor.Address",
+      FallbackComponent: n,
+      LoaderComponent: s,
+      children: /* @__PURE__ */ t(O, { onEvent: o, LoaderComponent: s, ...i })
+    }
+  );
+}
+function H({ contractorId: o }) {
+  const n = N(o), { t: s } = m("Contractor.Address"), i = D();
+  return n ? /* @__PURE__ */ t(i.Alert, { status: "warning", disableScrollIntoView: !0, label: s("w9EditWarning.label"), children: /* @__PURE__ */ t(i.Text, { children: s("w9EditWarning.body") }) }) : null;
+}
+function O({
+  contractorId: o,
+  defaultValues: n,
+  onEvent: s,
+  dictionary: i,
+  className: A,
+  LoaderComponent: u
+}) {
+  _("Contractor.Address", i), F("Contractor.Address");
+  const { t: r } = m("Contractor.Address"), { t: R } = m("common"), c = D(), e = E({
+    contractorId: o,
+    optionalFieldsToRequire: B,
+    defaultValues: n
+  });
+  if (e.isLoading)
+    return /* @__PURE__ */ t(
+      f,
+      {
+        isLoading: !0,
+        error: e.errorHandling.errors,
+        LoaderComponent: u
+      }
+    );
+  const { Fields: a } = e.form, p = e.data.contractorType === "Business", b = async () => {
+    const d = await e.actions.onSubmit();
+    d && (s(h.CONTRACTOR_ADDRESS_UPDATED, d.data), s(h.CONTRACTOR_ADDRESS_DONE));
+  };
+  return /* @__PURE__ */ t("section", { className: C(S.container, A), children: /* @__PURE__ */ t(f, { error: e.errorHandling.errors, LoaderComponent: u, children: /* @__PURE__ */ t(T, { formHookResult: e, children: /* @__PURE__ */ l(y, { onSubmit: () => {
+    b();
+  }, children: [
+    /* @__PURE__ */ t(H, { contractorId: o }),
+    /* @__PURE__ */ l(g, { flexDirection: "column", gap: 32, alignItems: "stretch", children: [
+      /* @__PURE__ */ t("header", { children: /* @__PURE__ */ l(g, { flexDirection: "column", gap: 4, children: [
+        /* @__PURE__ */ t(c.Heading, { as: "h2", children: r(p ? "businessAddressTitle" : "homeAddressTitle") }),
+        /* @__PURE__ */ t(c.Text, { variant: "supporting", children: r(p ? "businessAddressDescription" : "homeAddressDescription") })
+      ] }) }),
+      /* @__PURE__ */ l(I, { gridTemplateColumns: { base: "1fr", small: ["1fr", "1fr"] }, gap: 20, children: [
+        /* @__PURE__ */ t(
+          a.Street1,
+          {
+            label: r("street1"),
+            validationMessages: { REQUIRED: r("validations.street1") }
+          }
+        ),
+        /* @__PURE__ */ t(a.Street2, { label: r("street2") }),
+        /* @__PURE__ */ t(
+          a.City,
+          {
+            label: r("city"),
+            validationMessages: { REQUIRED: r("validations.city") }
+          }
+        ),
+        /* @__PURE__ */ t(
+          a.State,
+          {
+            label: r("state"),
+            placeholder: r("statePlaceholder"),
+            validationMessages: { REQUIRED: r("validations.state") },
+            getOptionLabel: (d) => R(`statesHash.${d}`, { defaultValue: d })
+          }
+        ),
+        /* @__PURE__ */ t(
+          a.Zip,
+          {
+            label: r("zip"),
+            validationMessages: {
+              REQUIRED: r("validations.zip"),
+              INVALID_ZIP: r("validations.zipInvalid")
+            }
+          }
+        )
+      ] }),
+      /* @__PURE__ */ t(x, { children: /* @__PURE__ */ t(c.Button, { type: "submit", isDisabled: e.status.isPending, children: e.status.isPending ? r("submitting") : r("submit") }) })
+    ] })
+  ] }) }) }) });
+}
+export {
+  J as Address
+};
+//# sourceMappingURL=Address.js.map

package/dist/components/Contractor/Address/onboarding/Address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Address.js","sources":["../../../../../src/components/Contractor/Address/onboarding/Address.tsx"],"sourcesContent":["import type { JSX } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport classNames from 'classnames'\nimport type { FallbackProps } from 'react-error-boundary'\nimport { useContractorAddressForm } from '../shared/useContractorAddressForm'\nimport type { ContractorAddressOptionalFieldsToRequire } from '../shared/useContractorAddressForm'\nimport styles from './Address.module.scss'\nimport type { AddressDefaultValues } from './types'\nimport { BaseBoundaries, BaseLayout } from '@/components/Base'\nimport { SDKFormProvider } from '@/partner-hook-utils/form/SDKFormProvider'\nimport { Form } from '@/components/Common/Form'\nimport { Flex, Grid, ActionsLayout } from '@/components/Common'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport type { ResourceDictionary } from '@/types/Helpers'\nimport { contractorEvents, type EventType } from '@/shared/constants'\nimport type { OnEventType } from '@/components/Base/useBase'\nimport type { LoaderComponentType } from '@/components/Base'\nimport { useContractorHasSignedW9 } from '@/components/Contractor/shared/useContractorHasSignedW9'\n\n// The hook defaults to the API contract, which treats every address field as\n// optional. The SDK's address form has always required a complete mailing\n// address, so it opts those fields back into being required here.\nconst SDK_REQUIRED_ADDRESS_FIELDS: ContractorAddressOptionalFieldsToRequire = {\n  update: ['street1', 'city', 'state', 'zip'],\n}\n\n/**\n * Props for {@link Address}.\n *\n * @public\n */\nexport interface AddressProps {\n  /** The associated contractor identifier. */\n  contractorId: string\n  /** Pre-fill values for address fields. Server data takes precedence when the contractor already has an address on file. */\n  defaultValues?: AddressDefaultValues\n  /** Callback invoked each time the component emits an event. */\n  onEvent: OnEventType<EventType, unknown>\n  /** Overrides for the component's i18n strings. */\n  dictionary?: ResourceDictionary<'Contractor.Address'>\n  /** Optional class applied to the wrapping `<section>`. */\n  className?: string\n  /** Custom React component rendered when an unhandled error is caught by the component-level error boundary. */\n  FallbackComponent?: (props: FallbackProps) => JSX.Element\n  /** Custom loading indicator rendered while this component's async data is fetching. Overrides the indicator configured on `GustoProvider` for this instance only. */\n  LoaderComponent?: LoaderComponentType\n}\n\n/**\n * Form for collecting and updating a contractor's mailing address. Renders a business or home address title based on the contractor type.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/address/updated` | Fired after the address is saved | The updated `ContractorAddress` entity |\n * | `contractor/address/done` | Fired after a successful save so the parent flow can advance | — |\n *\n * @param props - See {@link AddressProps}.\n * @returns The contractor address form.\n * @public\n *\n * @example\n * ```tsx\n * import { ContractorOnboarding } from '@gusto/embedded-react-sdk'\n *\n * function MyComponent() {\n *   return (\n *     <ContractorOnboarding.Address\n *       contractorId=\"contractor-uuid\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport function Address({\n  onEvent,\n  FallbackComponent,\n  LoaderComponent,\n  ...rootProps\n}: AddressProps) {\n  return (\n    <BaseBoundaries\n      componentName=\"Contractor.Address\"\n      FallbackComponent={FallbackComponent}\n      LoaderComponent={LoaderComponent}\n    >\n      <AddressRoot onEvent={onEvent} LoaderComponent={LoaderComponent} {...rootProps} />\n    </BaseBoundaries>\n  )\n}\n\nfunction ContractorAddressW9Warning({ contractorId }: { contractorId: string }) {\n  const hasSignedW9 = useContractorHasSignedW9(contractorId)\n  const { t } = useTranslation('Contractor.Address')\n  const Components = useComponentContext()\n  if (!hasSignedW9) return null\n  return (\n    <Components.Alert status=\"warning\" disableScrollIntoView label={t('w9EditWarning.label')}>\n      <Components.Text>{t('w9EditWarning.body')}</Components.Text>\n    </Components.Alert>\n  )\n}\n\nfunction AddressRoot({\n  contractorId,\n  defaultValues,\n  onEvent,\n  dictionary,\n  className,\n  LoaderComponent,\n}: Omit<AddressProps, 'FallbackComponent'>) {\n  useComponentDictionary('Contractor.Address', dictionary)\n  useI18n('Contractor.Address')\n  const { t } = useTranslation('Contractor.Address')\n  const { t: tCommon } = useTranslation('common')\n  const Components = useComponentContext()\n\n  const contractorAddress = useContractorAddressForm({\n    contractorId,\n    optionalFieldsToRequire: SDK_REQUIRED_ADDRESS_FIELDS,\n    defaultValues,\n  })\n\n  if (contractorAddress.isLoading) {\n    return (\n      <BaseLayout\n        isLoading\n        error={contractorAddress.errorHandling.errors}\n        LoaderComponent={LoaderComponent}\n      />\n    )\n  }\n\n  const { Fields } = contractorAddress.form\n  const isBusiness = contractorAddress.data.contractorType === 'Business'\n\n  const handleSubmit = async () => {\n    const result = await contractorAddress.actions.onSubmit()\n    if (result) {\n      onEvent(contractorEvents.CONTRACTOR_ADDRESS_UPDATED, result.data)\n      onEvent(contractorEvents.CONTRACTOR_ADDRESS_DONE)\n    }\n  }\n\n  return (\n    <section className={classNames(styles.container, className)}>\n      <BaseLayout error={contractorAddress.errorHandling.errors} LoaderComponent={LoaderComponent}>\n        <SDKFormProvider formHookResult={contractorAddress}>\n          <Form onSubmit={() => void handleSubmit()}>\n            <ContractorAddressW9Warning contractorId={contractorId} />\n\n            <Flex flexDirection=\"column\" gap={32} alignItems=\"stretch\">\n              <header>\n                <Flex flexDirection=\"column\" gap={4}>\n                  <Components.Heading as=\"h2\">\n                    {isBusiness ? t('businessAddressTitle') : t('homeAddressTitle')}\n                  </Components.Heading>\n                  <Components.Text variant=\"supporting\">\n                    {isBusiness ? t('businessAddressDescription') : t('homeAddressDescription')}\n                  </Components.Text>\n                </Flex>\n              </header>\n\n              <Grid gridTemplateColumns={{ base: '1fr', small: ['1fr', '1fr'] }} gap={20}>\n                <Fields.Street1\n                  label={t('street1')}\n                  validationMessages={{ REQUIRED: t('validations.street1') }}\n                />\n                <Fields.Street2 label={t('street2')} />\n                <Fields.City\n                  label={t('city')}\n                  validationMessages={{ REQUIRED: t('validations.city') }}\n                />\n                <Fields.State\n                  label={t('state')}\n                  placeholder={t('statePlaceholder')}\n                  validationMessages={{ REQUIRED: t('validations.state') }}\n                  getOptionLabel={(abbr: string) =>\n                    tCommon(`statesHash.${abbr}`, { defaultValue: abbr })\n                  }\n                />\n                <Fields.Zip\n                  label={t('zip')}\n                  validationMessages={{\n                    REQUIRED: t('validations.zip'),\n                    INVALID_ZIP: t('validations.zipInvalid'),\n                  }}\n                />\n              </Grid>\n\n              <ActionsLayout>\n                <Components.Button type=\"submit\" isDisabled={contractorAddress.status.isPending}>\n                  {contractorAddress.status.isPending ? t('submitting') : t('submit')}\n                </Components.Button>\n              </ActionsLayout>\n            </Flex>\n          </Form>\n        </SDKFormProvider>\n      </BaseLayout>\n    </section>\n  )\n}\n"],"names":["SDK_REQUIRED_ADDRESS_FIELDS","Address","onEvent","FallbackComponent","LoaderComponent","rootProps","jsx","BaseBoundaries","AddressRoot","ContractorAddressW9Warning","contractorId","hasSignedW9","useContractorHasSignedW9","t","useTranslation","Components","useComponentContext","defaultValues","dictionary","className","useComponentDictionary","useI18n","tCommon","contractorAddress","useContractorAddressForm","BaseLayout","Fields","isBusiness","handleSubmit","result","contractorEvents","classNames","styles","SDKFormProvider","jsxs","Form","Flex","Grid","abbr","ActionsLayout"],"mappings":"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"}

package/dist/components/Contractor/Address/{types.d.ts → onboarding/types.d.ts}

@@ -1,5 +1,5 @@
-import { ContractorAddressFormData } from './shared/useContractorAddressForm';
-import { RequireAtLeastOne } from '../../../types/Helpers';
+import { ContractorAddressFormData } from '../shared/useContractorAddressForm';
+import { RequireAtLeastOne } from '../../../../types/Helpers';
 /**
  * Pre-fill values accepted by {@link Address}. At least one of `street1`, `street2`, `city`, `state`, or `zip` must be provided.
  *

package/dist/components/Contractor/Address/shared/useContractorAddressSummary/index.d.ts

@@ -0,0 +1 @@
+export { useContractorAddressSummary, type UseContractorAddressSummaryParams, type UseContractorAddressSummaryResult, } from './useContractorAddressSummary';

package/dist/components/Contractor/Address/shared/useContractorAddressSummary/useContractorAddressSummary.d.ts

@@ -0,0 +1,19 @@
+import { ContractorType } from '@gusto/embedded-api/models/components/contractor';
+import { ContractorAddress } from '@gusto/embedded-api/models/components/contractoraddress';
+import { BaseHookReady, HookLoadingResult } from '../../../../../partner-hook-utils/types';
+/** @internal */
+export interface UseContractorAddressSummaryParams {
+    contractorId: string;
+}
+type UseContractorAddressSummaryReady = BaseHookReady<{
+    contractorAddress: ContractorAddress;
+    contractorType: ContractorType | undefined;
+}, {
+    isFetching: boolean;
+    isPending: boolean;
+}>;
+/** @internal */
+export type UseContractorAddressSummaryResult = HookLoadingResult | UseContractorAddressSummaryReady;
+/** @internal */
+export declare function useContractorAddressSummary({ contractorId, }: UseContractorAddressSummaryParams): UseContractorAddressSummaryResult;
+export {};

package/dist/components/Contractor/Address/shared/useContractorAddressSummary/useContractorAddressSummary.js

@@ -0,0 +1,27 @@
+import { useContractorsGet as i } from "@gusto/embedded-api/react-query/contractorsGet";
+import { useContractorsGetAddress as a } from "@gusto/embedded-api/react-query/contractorsGetAddress";
+import { composeErrorHandler as c } from "../../../../../partner-hook-utils/composeErrorHandler.js";
+function f({
+  contractorId: o
+}) {
+  const t = i(
+    { contractorUuid: o },
+    { staleTime: 1 / 0 }
+  ), r = a(
+    { contractorUuid: o },
+    { staleTime: 1 / 0 }
+  ), s = c([t, r]), n = r.data?.contractorAddress, e = t.data?.contractor?.type;
+  return t.isLoading || r.isLoading || !n ? { isLoading: !0, errorHandling: s } : {
+    isLoading: !1,
+    data: { contractorAddress: n, contractorType: e },
+    status: {
+      isFetching: t.isFetching || r.isFetching,
+      isPending: !1
+    },
+    errorHandling: s
+  };
+}
+export {
+  f as useContractorAddressSummary
+};
+//# sourceMappingURL=useContractorAddressSummary.js.map