@gusto/embedded-react-sdk 0.48.3 → 0.49.0

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

@@ -1,72 +1,91 @@
-import { jsx as t, jsxs as F, Fragment as R } from "react/jsx-runtime";
-import { useContractorsGetSuspense as g } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsGet";
-import { useContractorsGetAddressSuspense as U } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsGetAddress";
-import { useContractorsUpdateAddressMutation as z } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsUpdateAddress";
-import { useForm as E, FormProvider as P } from "react-hook-form";
-import { zodResolver as T } from "@hookform/resolvers/zod";
-import { AddressFormSchema as b, AddressProvider as x } from "./useAddress.js";
-import { Head as O } from "./Head.js";
-import { Form as _ } from "./Form.js";
-import { Actions as B } from "./Actions.js";
-import { Form as N } from "../../Common/Form/Form.js";
-import { useComponentDictionary as j, useI18n as w } from "../../../i18n/I18n.js";
-import { Flex as G } from "../../Common/Flex/Flex.js";
-import "react-i18next";
-import "../../../contexts/ComponentAdapter/useComponentContext.js";
+import { jsx as t, jsxs as l } from "react/jsx-runtime";
+import { useTranslation as c } from "react-i18next";
+import g from "classnames";
+import C from "./Address.module.scss.js";
+import { useContractorAddressForm as E } from "./shared/useContractorAddressForm/useContractorAddressForm.js";
+import { BaseBoundaries as S, BaseLayout as p } from "../../Base/Base.js";
+import "../../Base/useBase.js";
+import { SDKFormProvider as v } from "../../../partner-hook-utils/form/SDKFormProvider.js";
+import { Form as b } from "../../Common/Form/Form.js";
+import { Flex as u } from "../../Common/Flex/Flex.js";
+import { Grid as I } from "../../Common/Grid/Grid.js";
+import { ActionsLayout as T } from "../../Common/ActionsLayout/ActionsLayout.js";
+import { useComponentContext as y } from "../../../contexts/ComponentAdapter/useComponentContext.js";
 import "react";
-import { BaseComponent as H } from "../../Base/Base.js";
-import { useBase as M } from "../../Base/useBase.js";
-import { contractorEvents as d } from "../../../shared/constants.js";
-function ct(r) {
-  return /* @__PURE__ */ t(H, { ...r, children: /* @__PURE__ */ t(q, { ...r, children: r.children }) });
+import { useComponentDictionary as x, useI18n as L } from "../../../i18n/I18n.js";
+import { contractorEvents as f } from "../../../shared/constants.js";
+const _ = {
+  update: ["street1", "city", "state", "zip"]
+};
+function G({ onEvent: n, FallbackComponent: a, ...i }) {
+  return /* @__PURE__ */ t(S, { componentName: "Contractor.Address", FallbackComponent: a, children: /* @__PURE__ */ t(F, { onEvent: n, ...i }) });
 }
-function q({ contractorId: r, defaultValues: e, children: n, className: a, dictionary: p }) {
-  j("Contractor.Address", p), w("Contractor.Address");
-  const { onEvent: i, baseSubmitHandler: u } = M(), { data: c } = g({ contractorUuid: r }), { data: f } = U({ contractorUuid: r }), { mutateAsync: A, isPending: h } = z(), D = c.contractor, C = c.contractor?.type, o = f.contractorAddress, S = {
-    street1: o?.street1 || e?.street1 || "",
-    street2: o?.street2 || e?.street2 || "",
-    city: o?.city || e?.city || "",
-    state: o?.state || e?.state || "",
-    zip: o?.zip || e?.zip || ""
-  }, m = E({
-    resolver: T(b),
-    defaultValues: S
-  }), l = async (v) => {
-    await u(v, async (s) => {
-      const { contractorAddress: y } = await A({
-        request: {
-          contractorUuid: r,
-          contractorAddressUpdateBody: {
-            version: o?.version,
-            street1: s.street1,
-            street2: s.street2,
-            city: s.city,
-            state: s.state,
-            zip: s.zip
+function F({
+  contractorId: n,
+  defaultValues: a,
+  onEvent: i,
+  dictionary: D,
+  className: h
+}) {
+  x("Contractor.Address", D), L("Contractor.Address");
+  const { t: e } = c("Contractor.Address"), { t: A } = c("common"), d = y(), r = E({
+    contractorId: n,
+    optionalFieldsToRequire: _,
+    defaultValues: a
+  });
+  if (r.isLoading)
+    return /* @__PURE__ */ t(p, { isLoading: !0, error: r.errorHandling.errors });
+  const { Fields: o } = r.form, m = r.data.contractorType === "Business", R = async () => {
+    const s = await r.actions.onSubmit();
+    s && (i(f.CONTRACTOR_ADDRESS_UPDATED, s.data), i(f.CONTRACTOR_ADDRESS_DONE));
+  };
+  return /* @__PURE__ */ t("section", { className: g(C.container, h), children: /* @__PURE__ */ t(p, { error: r.errorHandling.errors, children: /* @__PURE__ */ t(v, { formHookResult: r, children: /* @__PURE__ */ t(b, { onSubmit: () => {
+    R();
+  }, children: /* @__PURE__ */ l(u, { flexDirection: "column", gap: 32, alignItems: "stretch", children: [
+    /* @__PURE__ */ t("header", { children: /* @__PURE__ */ l(u, { flexDirection: "column", gap: 4, children: [
+      /* @__PURE__ */ t(d.Heading, { as: "h2", children: e(m ? "businessAddressTitle" : "homeAddressTitle") }),
+      /* @__PURE__ */ t(d.Text, { variant: "supporting", children: e(m ? "businessAddressDescription" : "homeAddressDescription") })
+    ] }) }),
+    /* @__PURE__ */ l(I, { gridTemplateColumns: { base: "1fr", small: ["1fr", "1fr"] }, gap: 20, children: [
+      /* @__PURE__ */ t(
+        o.Street1,
+        {
+          label: e("street1"),
+          validationMessages: { REQUIRED: e("validations.street1") }
+        }
+      ),
+      /* @__PURE__ */ t(o.Street2, { label: e("street2") }),
+      /* @__PURE__ */ t(
+        o.City,
+        {
+          label: e("city"),
+          validationMessages: { REQUIRED: e("validations.city") }
+        }
+      ),
+      /* @__PURE__ */ t(
+        o.State,
+        {
+          label: e("state"),
+          placeholder: e("statePlaceholder"),
+          validationMessages: { REQUIRED: e("validations.state") },
+          getOptionLabel: (s) => A(`statesHash.${s}`, { defaultValue: s })
+        }
+      ),
+      /* @__PURE__ */ t(
+        o.Zip,
+        {
+          label: e("zip"),
+          validationMessages: {
+            REQUIRED: e("validations.zip"),
+            INVALID_ZIP: e("validations.zipInvalid")
           }
         }
-      });
-      i(d.CONTRACTOR_ADDRESS_UPDATED, y), i(d.CONTRACTOR_ADDRESS_DONE);
-    });
-  };
-  return /* @__PURE__ */ t("section", { className: a, children: /* @__PURE__ */ t(
-    x,
-    {
-      value: {
-        contractor: D,
-        contractorType: C,
-        address: o,
-        isPending: h
-      },
-      children: /* @__PURE__ */ t(P, { ...m, children: /* @__PURE__ */ t(N, { onSubmit: m.handleSubmit(l), children: /* @__PURE__ */ t(G, { flexDirection: "column", gap: 32, alignItems: "stretch", children: n || /* @__PURE__ */ F(R, { children: [
-        /* @__PURE__ */ t(O, {}),
-        /* @__PURE__ */ t(_, {}),
-        /* @__PURE__ */ t(B, {})
-      ] }) }) }) })
-    }
-  ) });
+      )
+    ] }),
+    /* @__PURE__ */ t(T, { children: /* @__PURE__ */ t(d.Button, { type: "submit", isLoading: r.status.isPending, children: e("submit") }) })
+  ] }) }) }) }) });
 }
 export {
-  ct as Address
+  G as Address
 };
 //# sourceMappingURL=Address.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Address.js","sources":["../../../../src/components/Contractor/Address/Address.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { useContractorsGetSuspense } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorsGet'\nimport { useContractorsGetAddressSuspense } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorsGetAddress'\nimport { useContractorsUpdateAddressMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorsUpdateAddress'\nimport { FormProvider, useForm } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport { AddressFormSchema, AddressProvider } from './useAddress'\nimport { Head } from './Head'\nimport { Form } from './Form'\nimport { Actions } from './Actions'\nimport type { AddressDefaultValues, AddressFormValues } from './useAddress'\nimport { Form as HtmlForm } from '@/components/Common/Form/Form'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { Flex } from '@/components/Common'\nimport type { BaseComponentInterface } from '@/components/Base/Base'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { contractorEvents } from '@/shared/constants'\n\n/**\n * Props for {@link Address}.\n *\n * @public\n */\nexport interface AddressProps extends BaseComponentInterface<'Contractor.Address'> {\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  /** Custom composition slot. When provided, replaces the default Head, Form, and Actions layout — use the bundled subcomponents alongside {@link useAddress} to read form context. */\n  children?: ReactNode\n  /** Optional class applied to the wrapping `<section>`. */\n  className?: string\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 * @remarks\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(props: AddressProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nfunction Root({ contractorId, defaultValues, children, className, dictionary }: AddressProps) {\n  useComponentDictionary('Contractor.Address', dictionary)\n  useI18n('Contractor.Address')\n\n  const { onEvent, baseSubmitHandler } = useBase()\n\n  const { data: contractorData } = useContractorsGetSuspense({ contractorUuid: contractorId })\n  const { data: addressData } = useContractorsGetAddressSuspense({ contractorUuid: contractorId })\n\n  const { mutateAsync: updateAddress, isPending: isUpdatingAddressPending } =\n    useContractorsUpdateAddressMutation()\n\n  const contractor = contractorData.contractor\n  const contractorType = contractorData.contractor?.type\n  const address = addressData.contractorAddress\n\n  const formDefaultValues = {\n    street1: address?.street1 || defaultValues?.street1 || '',\n    street2: address?.street2 || defaultValues?.street2 || '',\n    city: address?.city || defaultValues?.city || '',\n    state: address?.state || defaultValues?.state || '',\n    zip: address?.zip || defaultValues?.zip || '',\n  }\n\n  const formMethods = useForm<AddressFormValues>({\n    resolver: zodResolver(AddressFormSchema),\n    defaultValues: formDefaultValues,\n  })\n\n  const onSubmit = async (data: AddressFormValues) => {\n    await baseSubmitHandler(data, async payload => {\n      const { contractorAddress } = await updateAddress({\n        request: {\n          contractorUuid: contractorId,\n          contractorAddressUpdateBody: {\n            version: address?.version as string,\n            street1: payload.street1,\n            street2: payload.street2,\n            city: payload.city,\n            state: payload.state,\n            zip: payload.zip,\n          },\n        },\n      })\n\n      onEvent(contractorEvents.CONTRACTOR_ADDRESS_UPDATED, contractorAddress)\n      onEvent(contractorEvents.CONTRACTOR_ADDRESS_DONE)\n    })\n  }\n\n  return (\n    <section className={className}>\n      <AddressProvider\n        value={{\n          contractor,\n          contractorType,\n          address,\n          isPending: isUpdatingAddressPending,\n        }}\n      >\n        <FormProvider {...formMethods}>\n          <HtmlForm onSubmit={formMethods.handleSubmit(onSubmit)}>\n            <Flex flexDirection=\"column\" gap={32} alignItems=\"stretch\">\n              {children ? (\n                children\n              ) : (\n                <>\n                  <Head />\n                  <Form />\n                  <Actions />\n                </>\n              )}\n            </Flex>\n          </HtmlForm>\n        </FormProvider>\n      </AddressProvider>\n    </section>\n  )\n}\n"],"names":["Address","props","jsx","BaseComponent","Root","contractorId","defaultValues","children","className","dictionary","useComponentDictionary","useI18n","onEvent","baseSubmitHandler","useBase","contractorData","useContractorsGetSuspense","addressData","useContractorsGetAddressSuspense","updateAddress","isUpdatingAddressPending","useContractorsUpdateAddressMutation","contractor","contractorType","address","formDefaultValues","formMethods","useForm","zodResolver","AddressFormSchema","onSubmit","data","payload","contractorAddress","contractorEvents","AddressProvider","FormProvider","HtmlForm","Flex","jsxs","Fragment","Head","Form","Actions"],"mappings":";;;;;;;;;;;;;;;;;;;AA8DO,SAASA,GAAQC,GAAqB;AAC3C,SACE,gBAAAC,EAACC,GAAA,EAAe,GAAGF,GACjB,UAAA,gBAAAC,EAACE,KAAM,GAAGH,GAAQ,UAAAA,EAAM,SAAA,CAAS,EAAA,CACnC;AAEJ;AAEA,SAASG,EAAK,EAAE,cAAAC,GAAc,eAAAC,GAAe,UAAAC,GAAU,WAAAC,GAAW,YAAAC,KAA4B;AAC5F,EAAAC,EAAuB,sBAAsBD,CAAU,GACvDE,EAAQ,oBAAoB;AAE5B,QAAM,EAAE,SAAAC,GAAS,mBAAAC,EAAA,IAAsBC,EAAA,GAEjC,EAAE,MAAMC,EAAA,IAAmBC,EAA0B,EAAE,gBAAgBX,GAAc,GACrF,EAAE,MAAMY,EAAA,IAAgBC,EAAiC,EAAE,gBAAgBb,GAAc,GAEzF,EAAE,aAAac,GAAe,WAAWC,EAAA,IAC7CC,EAAA,GAEIC,IAAaP,EAAe,YAC5BQ,IAAiBR,EAAe,YAAY,MAC5CS,IAAUP,EAAY,mBAEtBQ,IAAoB;AAAA,IACxB,SAASD,GAAS,WAAWlB,GAAe,WAAW;AAAA,IACvD,SAASkB,GAAS,WAAWlB,GAAe,WAAW;AAAA,IACvD,MAAMkB,GAAS,QAAQlB,GAAe,QAAQ;AAAA,IAC9C,OAAOkB,GAAS,SAASlB,GAAe,SAAS;AAAA,IACjD,KAAKkB,GAAS,OAAOlB,GAAe,OAAO;AAAA,EAAA,GAGvCoB,IAAcC,EAA2B;AAAA,IAC7C,UAAUC,EAAYC,CAAiB;AAAA,IACvC,eAAeJ;AAAA,EAAA,CAChB,GAEKK,IAAW,OAAOC,MAA4B;AAClD,UAAMlB,EAAkBkB,GAAM,OAAMC,MAAW;AAC7C,YAAM,EAAE,mBAAAC,MAAsB,MAAMd,EAAc;AAAA,QAChD,SAAS;AAAA,UACP,gBAAgBd;AAAA,UAChB,6BAA6B;AAAA,YAC3B,SAASmB,GAAS;AAAA,YAClB,SAASQ,EAAQ;AAAA,YACjB,SAASA,EAAQ;AAAA,YACjB,MAAMA,EAAQ;AAAA,YACd,OAAOA,EAAQ;AAAA,YACf,KAAKA,EAAQ;AAAA,UAAA;AAAA,QACf;AAAA,MACF,CACD;AAED,MAAApB,EAAQsB,EAAiB,4BAA4BD,CAAiB,GACtErB,EAAQsB,EAAiB,uBAAuB;AAAA,IAClD,CAAC;AAAA,EACH;AAEA,SACE,gBAAAhC,EAAC,aAAQ,WAAAM,GACP,UAAA,gBAAAN;AAAA,IAACiC;AAAA,IAAA;AAAA,MACC,OAAO;AAAA,QACL,YAAAb;AAAA,QACA,gBAAAC;AAAA,QACA,SAAAC;AAAA,QACA,WAAWJ;AAAA,MAAA;AAAA,MAGb,UAAA,gBAAAlB,EAACkC,KAAc,GAAGV,GAChB,4BAACW,GAAA,EAAS,UAAUX,EAAY,aAAaI,CAAQ,GACnD,UAAA,gBAAA5B,EAACoC,GAAA,EAAK,eAAc,UAAS,KAAK,IAAI,YAAW,WAC9C,UAAA/B,KAGC,gBAAAgC,EAAAC,GAAA,EACE,UAAA;AAAA,QAAA,gBAAAtC,EAACuC,GAAA,EAAK;AAAA,0BACLC,GAAA,EAAK;AAAA,0BACLC,GAAA,CAAA,CAAQ;AAAA,MAAA,GACX,EAAA,CAEJ,GACF,EAAA,CACF;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;"}
+{"version":3,"file":"Address.js","sources":["../../../../src/components/Contractor/Address/Address.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport classNames from 'classnames'\nimport styles from './Address.module.scss'\nimport { useContractorAddressForm } from './shared/useContractorAddressForm'\nimport type { ContractorAddressOptionalFieldsToRequire } from './shared/useContractorAddressForm'\nimport type { AddressDefaultValues } from './types'\nimport { BaseBoundaries, BaseLayout } from '@/components/Base'\nimport type { BaseBoundariesProps } from '@/components/Base/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'\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?: BaseBoundariesProps['FallbackComponent']\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({ onEvent, FallbackComponent, ...rootProps }: AddressProps) {\n  return (\n    <BaseBoundaries componentName=\"Contractor.Address\" FallbackComponent={FallbackComponent}>\n      <AddressRoot onEvent={onEvent} {...rootProps} />\n    </BaseBoundaries>\n  )\n}\n\nfunction AddressRoot({\n  contractorId,\n  defaultValues,\n  onEvent,\n  dictionary,\n  className,\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 <BaseLayout isLoading error={contractorAddress.errorHandling.errors} />\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}>\n        <SDKFormProvider formHookResult={contractorAddress}>\n          <Form onSubmit={() => void handleSubmit()}>\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\" isLoading={contractorAddress.status.isPending}>\n                  {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","rootProps","jsx","BaseBoundaries","AddressRoot","contractorId","defaultValues","dictionary","className","useComponentDictionary","useI18n","t","useTranslation","tCommon","Components","useComponentContext","contractorAddress","useContractorAddressForm","BaseLayout","Fields","isBusiness","handleSubmit","result","contractorEvents","classNames","styles","SDKFormProvider","Form","jsxs","Flex","Grid","abbr","ActionsLayout"],"mappings":"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"}

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

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

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

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

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

@@ -1,2 +1,3 @@
 import "./types/i18next.d.ts"
 export { Address, type AddressProps } from './Address';
+export type { AddressDefaultValues } from './types';

package/dist/components/Contractor/Address/shared/useContractorAddressForm/contractorAddressSchema.d.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { OptionalFieldsToRequire } from '../../../../../partner-hook-utils/form/buildFormSchema';
+/**
+ * Validation error codes emitted by the contractor address form schema. Map
+ * these codes to localized copy in `validationMessages` when composing the
+ * hook.
+ *
+ * @public
+ */
+export declare const ContractorAddressErrorCodes: {
+    readonly REQUIRED: "REQUIRED";
+    readonly INVALID_ZIP: "INVALID_ZIP";
+};
+/**
+ * Union of validation error code strings emitted by the contractor address
+ * form schema.
+ *
+ * @public
+ */
+export type ContractorAddressErrorCode = (typeof ContractorAddressErrorCodes)[keyof typeof ContractorAddressErrorCodes];
+/**
+ * Field names accepted by the contractor address form.
+ *
+ * @public
+ */
+export type ContractorAddressField = "street1" | "street2" | "city" | "state" | "zip";
+/**
+ * Shape of the values managed by the contractor address form.
+ *
+ * @public
+ */
+export type ContractorAddressFormData = { street1: string; street2: string; city: string; state: string; zip: string; };
+/**
+ * Shape of the validated values produced by the contractor address form on
+ * submit.
+ *
+ * @public
+ */
+export type ContractorAddressFormOutputs = ContractorAddressFormData;
+/**
+ * Keys of optional contractor address fields that can be promoted to required
+ * via the hook's `optionalFieldsToRequire` option.
+ *
+ * @public
+ */
+export type ContractorAddressOptionalFieldsToRequire = { create?: ("street1" | "street2" | "city" | "state" | "zip")[] | undefined; update?: ("street1" | "street2" | "city" | "state" | "zip")[] | undefined; };
+/** @internal */
+interface ContractorAddressSchemaOptions {
+    optionalFieldsToRequire?: ContractorAddressOptionalFieldsToRequire;
+}
+/** @internal */
+export declare function createContractorAddressSchema(options?: ContractorAddressSchemaOptions): import('../../../../../partner-hook-utils/form/buildFormSchema').BuildFormSchemaResult<{
+    street1: z.ZodString;
+    street2: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zip: z.ZodString;
+}>;
+export {};

package/dist/components/Contractor/Address/shared/useContractorAddressForm/contractorAddressSchema.js

@@ -0,0 +1,32 @@
+import { z as e } from "zod";
+import { buildFormSchema as s } from "../../../../../partner-hook-utils/form/buildFormSchema.js";
+const r = {
+  REQUIRED: "REQUIRED",
+  INVALID_ZIP: "INVALID_ZIP"
+}, i = /(^\d{5}$)|(^\d{5}-\d{4}$)/, n = {
+  street1: e.string(),
+  street2: e.string(),
+  city: e.string(),
+  state: e.string(),
+  zip: e.string().regex(i, { message: r.INVALID_ZIP })
+}, d = {
+  street1: "never",
+  street2: "never",
+  city: "never",
+  state: "never",
+  zip: "never"
+};
+function a(t = {}) {
+  const { optionalFieldsToRequire: o } = t;
+  return s(n, {
+    requiredFieldsConfig: d,
+    requiredErrorCode: r.REQUIRED,
+    mode: "update",
+    optionalFieldsToRequire: o
+  });
+}
+export {
+  r as ContractorAddressErrorCodes,
+  a as createContractorAddressSchema
+};
+//# sourceMappingURL=contractorAddressSchema.js.map

package/dist/components/Contractor/Address/shared/useContractorAddressForm/contractorAddressSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractorAddressSchema.js","sources":["../../../../../../src/components/Contractor/Address/shared/useContractorAddressForm/contractorAddressSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type RequiredFieldConfig,\n  type OptionalFieldsToRequire,\n} from '@/partner-hook-utils/form/buildFormSchema'\n\n// ── Error codes ────────────────────────────────────────────────────────\n\n/**\n * Validation error codes emitted by the contractor address form schema. Map\n * these codes to localized copy in `validationMessages` when composing the\n * hook.\n *\n * @public\n */\nexport const ContractorAddressErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_ZIP: 'INVALID_ZIP',\n} as const\n\n/**\n * Union of validation error code strings emitted by the contractor address\n * form schema.\n *\n * @public\n */\nexport type ContractorAddressErrorCode =\n  (typeof ContractorAddressErrorCodes)[keyof typeof ContractorAddressErrorCodes]\n\n// ── Field validators ───────────────────────────────────────────────────\n\nconst ZIP_REGEX = /(^\\d{5}$)|(^\\d{5}-\\d{4}$)/\n\nconst fieldValidators = {\n  street1: z.string(),\n  street2: z.string(),\n  city: z.string(),\n  state: z.string(),\n  zip: z.string().regex(ZIP_REGEX, { message: ContractorAddressErrorCodes.INVALID_ZIP }),\n}\n\n/**\n * Field names accepted by the contractor address form.\n *\n * @public\n */\nexport type ContractorAddressField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the contractor address form.\n *\n * @public\n */\nexport type ContractorAddressFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/**\n * Shape of the validated values produced by the contractor address form on\n * submit.\n *\n * @public\n */\nexport type ContractorAddressFormOutputs = ContractorAddressFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\n// The contractor address API treats every address field as optional — only\n// `version` is required, and that is not a form field. The hook mirrors that\n// contract so partners get API-aligned defaults; consumers that need stricter\n// requiredness (e.g. the SDK's own Address component) opt in via\n// `optionalFieldsToRequire`.\nconst requiredFieldsConfig = {\n  street1: 'never',\n  street2: 'never',\n  city: 'never',\n  state: 'never',\n  zip: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\n/**\n * Keys of optional contractor address fields that can be promoted to required\n * via the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type ContractorAddressOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface ContractorAddressSchemaOptions {\n  optionalFieldsToRequire?: ContractorAddressOptionalFieldsToRequire\n}\n\n/** @internal */\nexport function createContractorAddressSchema(options: ContractorAddressSchemaOptions = {}) {\n  const { optionalFieldsToRequire } = options\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: ContractorAddressErrorCodes.REQUIRED,\n    mode: 'update',\n    optionalFieldsToRequire,\n  })\n}\n"],"names":["ContractorAddressErrorCodes","ZIP_REGEX","fieldValidators","z","requiredFieldsConfig","createContractorAddressSchema","options","optionalFieldsToRequire","buildFormSchema"],"mappings":";;AAgBO,MAAMA,IAA8B;AAAA,EACzC,UAAU;AAAA,EACV,aAAa;AACf,GAaMC,IAAY,6BAEZC,IAAkB;AAAA,EACtB,SAASC,EAAE,OAAA;AAAA,EACX,SAASA,EAAE,OAAA;AAAA,EACX,MAAMA,EAAE,OAAA;AAAA,EACR,OAAOA,EAAE,OAAA;AAAA,EACT,KAAKA,EAAE,SAAS,MAAMF,GAAW,EAAE,SAASD,EAA4B,YAAA,CAAa;AACvF,GAgCMI,IAAuB;AAAA,EAC3B,SAAS;AAAA,EACT,SAAS;AAAA,EACT,MAAM;AAAA,EACN,OAAO;AAAA,EACP,KAAK;AACP;AAoBO,SAASC,EAA8BC,IAA0C,IAAI;AAC1F,QAAM,EAAE,yBAAAC,MAA4BD;AAEpC,SAAOE,EAAgBN,GAAiB;AAAA,IACtC,sBAAAE;AAAA,IACA,mBAAmBJ,EAA4B;AAAA,IAC/C,MAAM;AAAA,IACN,yBAAAO;AAAA,EAAA,CACD;AACH;"}

package/dist/components/Contractor/Address/shared/useContractorAddressForm/fields.d.ts

@@ -0,0 +1,111 @@
+import { ContractorAddressErrorCodes } from './contractorAddressSchema';
+import { TextInputHookFieldProps } from '../../../../../partner-hook-utils/form/fields/TextInputHookField';
+import { SelectHookFieldProps } from '../../../../../partner-hook-utils/form/fields/SelectHookField';
+import { HookFieldProps } from '../../../../../partner-hook-utils/types';
+/**
+ * The required-field error code produced by {@link useContractorAddressForm} fields that only emit `REQUIRED`.
+ *
+ * @remarks
+ * Used as the `validationMessages` key for the street, city, and state fields.
+ * See {@link ContractorAddressErrorCodes}.
+ *
+ * @public
+ */
+export type RequiredValidation = typeof ContractorAddressErrorCodes.REQUIRED;
+/**
+ * Validation error codes emitted by the `zip` field of {@link useContractorAddressForm}.
+ *
+ * @remarks
+ * Use these as keys in `validationMessages` on `Fields.Zip`. See
+ * {@link ContractorAddressErrorCodes}.
+ *
+ * @public
+ */
+export type ZipValidation = (typeof ContractorAddressErrorCodes)['REQUIRED' | 'INVALID_ZIP'];
+/**
+ * Props accepted by {@link useContractorAddressForm}'s `Fields.Street1` component.
+ *
+ * @public
+ */
+export type Street1FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>;
+/**
+ * Text input bound to the `street1` field of {@link useContractorAddressForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.Street1`. Required.
+ *
+ * @param props - {@link Street1FieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered text input bound to `street1`.
+ * @public
+ */
+export declare function Street1Field(props: Street1FieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useContractorAddressForm}'s `Fields.Street2` component.
+ *
+ * @public
+ */
+export type Street2FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>;
+/**
+ * Text input bound to the `street2` field of {@link useContractorAddressForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.Street2`. Optional.
+ *
+ * @param props - {@link Street2FieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered text input bound to `street2`.
+ * @public
+ */
+export declare function Street2Field(props: Street2FieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useContractorAddressForm}'s `Fields.City` component.
+ *
+ * @public
+ */
+export type CityFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>;
+/**
+ * Text input bound to the `city` field of {@link useContractorAddressForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.City`. Required.
+ *
+ * @param props - {@link CityFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered text input bound to `city`.
+ * @public
+ */
+export declare function CityField(props: CityFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useContractorAddressForm}'s `Fields.State` component.
+ *
+ * @public
+ */
+export type StateFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, string>>;
+/**
+ * Select bound to the `state` field of {@link useContractorAddressForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.State`. Options are the
+ * standard two-letter US state abbreviations. Required.
+ *
+ * @param props - {@link StateFieldProps} — accepts the standard hook field props plus `getOptionLabel` to localize state names.
+ * @returns The rendered select bound to `state`.
+ * @public
+ */
+export declare function StateField(props: StateFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useContractorAddressForm}'s `Fields.Zip` component.
+ *
+ * @public
+ */
+export type ZipFieldProps = HookFieldProps<TextInputHookFieldProps<ZipValidation>>;
+/**
+ * Text input bound to the `zip` field of {@link useContractorAddressForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.Zip`. Required; also validates
+ * ZIP code format and emits `INVALID_ZIP` when the value does not match.
+ *
+ * @param props - {@link ZipFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered text input bound to `zip`.
+ * @public
+ */
+export declare function ZipField(props: ZipFieldProps): import("react").JSX.Element;

package/dist/components/Contractor/Address/shared/useContractorAddressForm/fields.js

@@ -0,0 +1,26 @@
+import { jsx as t } from "react/jsx-runtime";
+import { TextInputHookField as n } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
+import { SelectHookField as r } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
+function u(e) {
+  return /* @__PURE__ */ t(n, { ...e, name: "street1" });
+}
+function f(e) {
+  return /* @__PURE__ */ t(n, { ...e, name: "street2" });
+}
+function l(e) {
+  return /* @__PURE__ */ t(n, { ...e, name: "city" });
+}
+function a(e) {
+  return /* @__PURE__ */ t(r, { ...e, name: "state" });
+}
+function c(e) {
+  return /* @__PURE__ */ t(n, { ...e, name: "zip" });
+}
+export {
+  l as CityField,
+  a as StateField,
+  u as Street1Field,
+  f as Street2Field,
+  c as ZipField
+};
+//# sourceMappingURL=fields.js.map

package/dist/components/Contractor/Address/shared/useContractorAddressForm/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Contractor/Address/shared/useContractorAddressForm/fields.tsx"],"sourcesContent":["import type { ContractorAddressErrorCodes } from './contractorAddressSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport { TextInputHookField, SelectHookField } from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n/**\n * The required-field error code produced by {@link useContractorAddressForm} fields that only emit `REQUIRED`.\n *\n * @remarks\n * Used as the `validationMessages` key for the street, city, and state fields.\n * See {@link ContractorAddressErrorCodes}.\n *\n * @public\n */\nexport type RequiredValidation = typeof ContractorAddressErrorCodes.REQUIRED\n\n/**\n * Validation error codes emitted by the `zip` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Use these as keys in `validationMessages` on `Fields.Zip`. See\n * {@link ContractorAddressErrorCodes}.\n *\n * @public\n */\nexport type ZipValidation = (typeof ContractorAddressErrorCodes)['REQUIRED' | 'INVALID_ZIP']\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.Street1` component.\n *\n * @public\n */\nexport type Street1FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Text input bound to the `street1` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Street1`. Required.\n *\n * @param props - {@link Street1FieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `street1`.\n * @public\n */\nexport function Street1Field(props: Street1FieldProps) {\n  return <TextInputHookField {...props} name=\"street1\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.Street2` component.\n *\n * @public\n */\nexport type Street2FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Text input bound to the `street2` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Street2`. Optional.\n *\n * @param props - {@link Street2FieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `street2`.\n * @public\n */\nexport function Street2Field(props: Street2FieldProps) {\n  return <TextInputHookField {...props} name=\"street2\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.City` component.\n *\n * @public\n */\nexport type CityFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Text input bound to the `city` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.City`. Required.\n *\n * @param props - {@link CityFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `city`.\n * @public\n */\nexport function CityField(props: CityFieldProps) {\n  return <TextInputHookField {...props} name=\"city\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.State` component.\n *\n * @public\n */\nexport type StateFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, string>>\n\n/**\n * Select bound to the `state` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.State`. Options are the\n * standard two-letter US state abbreviations. Required.\n *\n * @param props - {@link StateFieldProps} — accepts the standard hook field props plus `getOptionLabel` to localize state names.\n * @returns The rendered select bound to `state`.\n * @public\n */\nexport function StateField(props: StateFieldProps) {\n  return <SelectHookField {...props} name=\"state\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.Zip` component.\n *\n * @public\n */\nexport type ZipFieldProps = HookFieldProps<TextInputHookFieldProps<ZipValidation>>\n\n/**\n * Text input bound to the `zip` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Zip`. Required; also validates\n * ZIP code format and emits `INVALID_ZIP` when the value does not match.\n *\n * @param props - {@link ZipFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `zip`.\n * @public\n */\nexport function ZipField(props: ZipFieldProps) {\n  return <TextInputHookField {...props} name=\"zip\" />\n}\n"],"names":["Street1Field","props","jsx","TextInputHookField","Street2Field","CityField","StateField","SelectHookField","ZipField"],"mappings":";;;AA6CO,SAASA,EAAaC,GAA0B;AACrD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,WAAU;AACvD;AAmBO,SAASG,EAAaH,GAA0B;AACrD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,WAAU;AACvD;AAmBO,SAASI,EAAUJ,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,QAAO;AACpD;AAoBO,SAASK,EAAWL,GAAwB;AACjD,SAAO,gBAAAC,EAACK,GAAA,EAAiB,GAAGN,GAAO,MAAK,SAAQ;AAClD;AAoBO,SAASO,EAASP,GAAsB;AAC7C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,OAAM;AACnD;"}

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

@@ -0,0 +1,6 @@
+import "./types/i18next.d.ts"
+export { useContractorAddressForm } from './useContractorAddressForm';
+export type { ContractorAddressSubmitOptions, ContractorAddressOptionalFieldsToRequire, UseContractorAddressFormProps, UseContractorAddressFormResult, UseContractorAddressFormReady, ContractorAddressFieldsMetadata, ContractorAddressFormFields, ContractorAddressFields, } from './useContractorAddressForm';
+export { createContractorAddressSchema, ContractorAddressErrorCodes, type ContractorAddressErrorCode, type ContractorAddressFormData, type ContractorAddressFormOutputs, type ContractorAddressField, } from './contractorAddressSchema';
+export { Street1Field, Street2Field, CityField, StateField, ZipField } from './fields';
+export type { RequiredValidation as ContractorAddressRequiredValidation, ZipValidation as ContractorAddressZipValidation, Street1FieldProps as ContractorAddressStreet1FieldProps, Street2FieldProps as ContractorAddressStreet2FieldProps, CityFieldProps as ContractorAddressCityFieldProps, StateFieldProps as ContractorAddressStateFieldProps, ZipFieldProps as ContractorAddressZipFieldProps, } from './fields';

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

@@ -0,0 +1,112 @@
+import { UseFormProps } from 'react-hook-form';
+import { Contractor, ContractorType } from '@gusto/embedded-api-v-2025-11-15/models/components/contractor';
+import { ContractorAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/contractoraddress';
+import { ContractorAddressOptionalFieldsToRequire, ContractorAddressFormData } from './contractorAddressSchema';
+import { Street1Field, Street2Field, CityField, StateField, ZipField } from './fields';
+import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+export type { ContractorAddressOptionalFieldsToRequire } from './contractorAddressSchema';
+/**
+ * Optional overrides passed to {@link UseContractorAddressFormReady.actions.onSubmit | onSubmit}.
+ *
+ * @public
+ */
+export interface ContractorAddressSubmitOptions {
+    /** Override the contractor identifier supplied to the hook. */
+    contractorId?: string;
+}
+/**
+ * Configuration options for {@link useContractorAddressForm}.
+ *
+ * @public
+ */
+export interface UseContractorAddressFormProps {
+    /** UUID of the contractor whose address is being edited. */
+    contractorId: string;
+    /** Override fields that are optional by default to be required. See `ContractorAddressOptionalFieldsToRequire`. */
+    optionalFieldsToRequire?: ContractorAddressOptionalFieldsToRequire;
+    /** Pre-fill form values. Server data takes precedence. */
+    defaultValues?: Partial<ContractorAddressFormData>;
+    /** Passed through to react-hook-form. Defaults to `'onSubmit'`. */
+    validationMode?: UseFormProps['mode'];
+    /** Auto-focus the first invalid field on submit. Set to `false` when using `composeSubmitHandler` so submit-time focus is coordinated across multiple forms. Defaults to `true`. */
+    shouldFocusError?: boolean;
+}
+/**
+ * Pre-bound field components exposed on `useContractorAddressForm().form.Fields`.
+ *
+ * @public
+ */
+export interface ContractorAddressFields {
+    /** Street address line 1 text input. Required. */
+    Street1: typeof Street1Field;
+    /** Street address line 2 text input. Optional. */
+    Street2: typeof Street2Field;
+    /** City text input. Required. */
+    City: typeof CityField;
+    /** State selector. Required. */
+    State: typeof StateField;
+    /** ZIP code text input. Required. */
+    Zip: typeof ZipField;
+}
+/**
+ * Ready-state shape returned by {@link useContractorAddressForm} once data has loaded.
+ *
+ * @remarks
+ * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with
+ * the contractor-address-specific `data`, `status`, `actions`, and `form.Fields` shape.
+ *
+ * @public
+ */
+export interface UseContractorAddressFormReady extends BaseFormHookReady<FieldsMetadata, ContractorAddressFormData, ContractorAddressFields> {
+    /** Static entity data resolved from the API. */
+    data: {
+        /** The contractor address row loaded for update. */
+        contractorAddress: ContractorAddress;
+        /** The full contractor entity loaded alongside the address. */
+        contractor: Contractor;
+        /** The contractor's type — drives whether the address is labelled "home" (Individual) or "business" (Business). */
+        contractorType: ContractorType | undefined;
+    };
+    /** Reactive status flags. */
+    status: {
+        isPending: boolean;
+        mode: 'update';
+    };
+    /** Available actions. */
+    actions: {
+        onSubmit: (options?: ContractorAddressSubmitOptions) => Promise<HookSubmitResult<ContractorAddress> | undefined>;
+    };
+}
+/**
+ * Form hook for editing a contractor's address.
+ *
+ * @remarks
+ * A contractor always has exactly one address (created with the contractor),
+ * so this hook operates only in update mode and issues a PUT on submit. The
+ * same address is labelled a "home" address for Individual contractors and a
+ * "business" address for Business contractors; the hook exposes `contractorType`
+ * so the consuming component can choose the appropriate copy.
+ *
+ * @param props - See {@link UseContractorAddressFormProps}.
+ * @returns A {@link HookLoadingResult} while loading, or a {@link UseContractorAddressFormReady} once ready.
+ * @public
+ */
+export declare function useContractorAddressForm({ contractorId, optionalFieldsToRequire, defaultValues: partnerDefaults, validationMode, shouldFocusError, }: UseContractorAddressFormProps): HookLoadingResult | UseContractorAddressFormReady;
+/**
+ * Discriminated union returned by {@link useContractorAddressForm}.
+ *
+ * @public
+ */
+export type UseContractorAddressFormResult = HookLoadingResult | UseContractorAddressFormReady;
+/**
+ * Type of `form.fieldsMetadata` returned by {@link useContractorAddressForm}.
+ *
+ * @public
+ */
+export type ContractorAddressFieldsMetadata = UseContractorAddressFormReady['form']['fieldsMetadata'];
+/**
+ * Type of `form.Fields` returned by {@link useContractorAddressForm}.
+ *
+ * @public
+ */
+export type ContractorAddressFormFields = UseContractorAddressFormReady['form']['Fields'];